A comprehensive collection of Arduino/ESP-based IoT device implementations using the IotCloud library ecosystem. This repository contains ready-to-use firmware examples for various sensor and actuator projects that integrate seamlessly with the IotCloud platform.

• Overview
• Repository Structure
• Device Projects
  • Environmental Sensors
  • Smart Switches & Relays
  • LED Controllers
  • Thermostats
  • Specialty Devices
• Getting Started
• Architecture
• Dependencies
• Common Patterns
• Configuration

This repository provides production-ready firmware implementations for various IoT devices that connect to the IotCloud MQTT broker. Each device project follows a consistent architecture pattern:

1. Device Declaration - Creates a Device instance with version and type information
2. Sensor Registration - Adds one or more sensors inheriting from base sensor classes
3. IotCloud Integration - Uses iotcloud_setup() and iotcloud_loop() for connectivity

IotCloud-devices/ ├── IotCloud_7seg_clock/ # 7-segment LED clock display ├── IotCloud_ds18b20/ # DS18B20 temperature sensor ├── IotCloud_hexaled/ # Hexagonal LED panel controller ├── IotCloud_ld2410/ # LD2410 radar presence sensor ├── IotCloud_ld2410_TH10/ # LD2410 for Sonoff TH10 ├── IotCloud_ld2410_esp32/ # LD2410 for ESP32 ├── IotCloud_ld2410_light/ # LD2410 with light control ├── IotCloud_letters_lamp/ # RGB letter lamp controller ├── IotCloud_MHZ19/ # MH-Z19 CO2 sensor ├── IotCloud_si7021/ # SI7021 temperature/humidity sensor ├── IotCloud_si7021_MHZ19/ # Combined SI7021 + MH-Z19 ├── IotCloud_si7021_oled/ # SI7021 with OLED display ├── IotCloud_sonoff_dual_r3/ # Sonoff Dual R3 (blinds control) ├── IotCloud_sonoff_dual_r3_madrid/ # Sonoff Dual R3 variant ├── IotCloud_sonoff_mini/ # Sonoff Mini smart switch ├── IotCloud_sonoff_plug/ # Sonoff S26 smart plug ├── IotCloud_sonoff_rf/ # Sonoff RF controller ├── IotCloud_thermostat/ # DS18B20-based thermostat ├── IotCloud_thermostat_subsensor/ # Thermostat subsensor ├── IotCloud_washing_machine/ # Washing machine monitor ├── IotCloud_rotary/ # Rotary encoder device ├── IotCloud-despacho/ # Multi-sensor office device ├── iotcloud_t_subsensor_V2.js # Espruino subsensor implementation └── README.md 

Temperature and humidity monitoring using the SI7021 sensor.

Device my_device = Device("v1.2", "SI7021"); my_device.add_sensor(new IotCloud_T_H("001_T", "Temperature", metadata, &sensor.temperature)); my_device.add_sensor(new IotCloud_T_H("001_H", "Humidity", metadata, &sensor.humidity));

Features:

• SI7021 high-precision temperature/humidity sensor
• WiFi signal strength reporting
• Configurable polling interval (5 seconds default)
• Value filtering for noise reduction

CO2 concentration monitoring using the MH-Z19 infrared sensor.

Device my_device = Device("v1.3", "CO2"); my_device.add_sensor(new IotCloud_CO2("001_CO2", "CO2", metadata, MH_Z19_RX, MH_Z19_TX));

Features:

• UART communication with MH-Z19 sensor
• Calibration action via MQTT command
• PPM readings with configurable format

Waterproof temperature sensor for outdoor/harsh environments.

Device my_device = Device("v1.0", "DS18B20"); my_device.add_sensor(new IOTCLOUD_DS18B20("001_T", "Temperature", ONE_WIRE_BUS));

Features:

• OneWire protocol support
• 12-bit resolution
• Suitable for pipe/tank monitoring

Combined air quality monitoring station.

Features:

• Temperature, humidity, and CO2 monitoring
• Configurable offset settings for calibration
• All-in-one indoor air quality solution

Temperature/humidity sensor with OLED information display.

Features:

• 128x32 OLED display support
• Scrolling message display from external server
• Real-time sensor value visualization

Compact smart switch for in-wall installation.

Device my_device = Device("v1.2.5", "SONOFF_MINI"); my_device.add_sensor(new GENERIC_TOOGLE("SonoffMini", "Switch", RELAY_PIN, SWITCH_PIN));

Features:

• Toggle mode operation
• Physical switch debouncing (50ms)
• MQTT state synchronization
• GPIO 12 relay, GPIO 4 switch input

Dual-relay controller for motorized blinds/shades.

Device my_device = Device("v1.0.4", "SONOFF_DUAL_R3"); my_device.add_sensor(new GENERIC_TOOGLE("SonoffDualR3", "Persiana", RELAY_1, RELAY_2, SWITCH_1, SWITCH_2));

Features:

• Bidirectional motor control (UP/DOWN)
• Configurable action duration (1-30 seconds)
• Dual switch input support
• Auto-stop on opposite switch activation
• MQTT settings for movement duration

Radar-based presence detection for automatic light control.

Device my_device = Device("v1.0.1", "ESP8266_LD2410"); my_device.add_sensor(new GENERIC_TOOGLE("BathroomLight", "Switch", RELAY_PIN, SWITCH_PIN));

Features:

• LD2410 mmWave radar integration
• Human presence detection
• Automatic relay control
• 5-second startup delay to avoid false triggers

Hexagonal RGBW LED panel controller with rainbow effects.

Device my_device = Device("v1.0", "HEXALED"); my_device.add_sensor(new HexaLed("001", "Hexaled"));

Features:

• WS2812/SK6812 RGBW support via FastLED
• 8 hexagon configuration (160 LEDs)
• Rainbow gradient effect
• Brightness control via MQTT

RGB letter sign with animated rainbow effect.

Device my_device = Device("v1.7", "RGB_RAINBOW"); my_device.add_sensor(new RgbLamp("001", "Yeah!", NUM_LEDS));

Features:

• Up to 255 addressable LEDs
• Dynamic beatsin-based rainbow animation
• Smooth color blending
• On/off state persistence

LED-based seven-segment clock display.

Device my_device = Device("v1.4", "7SEG_CLOCK"); my_device.add_sensor(new Seven_Seg_Clock("001", "Clock"));

Features:

• 4-digit time display (HH:MM)
• NTP time synchronization
• Rainbow color palette
• Configurable initial brightness
• 60 LEDs (15 per segment)

Smart thermostat with DS18B20 temperature sensor and relay control.

Device my_device = Device("v1.1", "ESP32_DS18B20_THERMOSTAT"); my_device.add_sensor(new IOTCLOUD_THERMOSTAT_DS18B20("Thermostat", "Thermostat", ONE_WIRE_BUS, RELAY_PIN));

Features:

• DS18B20 temperature sensing
• Hysteresis-based heating control
• Setpoint adjustment via MQTT
• Relay state indication
• ESP32-based for reliable operation

Smart washing machine completion detector and remote start button.

Device my_device = Device("v1.0", "WASHING_MACHINE"); my_device.add_sensor(new SERVO_BUTTON("001_W", "Washing Machine", ...)); my_device.add_sensor(notifier);

Features:

• LDR-based LED blinking detection
• Servo-actuated start button
• Push notifications on cycle completion
• Blink pattern analysis for state detection
• Configurable thresholds

Multi-sensor office environment monitor.

Sensors included:

• HexaLed lighting
• Presence detection
• CO2 monitoring
• Temperature and humidity

Features:

• Complete office automation bundle
• Coordinated sensor operation
• Single device, multiple capabilities

1. Arduino IDE or PlatformIO
2. IotCloud Library - Core MQTT and sensor framework
3. IotCloud Sensors Library - Sensor base classes
4. Platform-specific libraries (ESP8266WiFi, ESP32 Arduino, etc.)

1. Clone this repository:

   git clone https://github.com/your-org/IotCloud-devices.git

2. Install the IotCloud libraries:

   # In Arduino libraries folder git clone https://github.com/your-org/IotCloud-arduino-lib.git git clone https://github.com/your-org/IotCloud-sensors.git

3. Open the desired project folder in Arduino IDE or PlatformIO

4. Configure WiFi and MQTT credentials in the device's configuration

5. Upload to your device

#include <Arduino.h> #include <iotcloud.h> #include "my_sensor.h" Device my_device = Device("v1.0", "MY_DEVICE"); void setup() { Serial.begin(115200); my_device.add_sensor(new MySensor("001", "SensorName")); iotcloud_setup(&my_device); } void loop() { iotcloud_loop(); }

┌─────────────────────────────────────────────────────────┐ │ Arduino Sketch │ │ ┌─────────────────────────────────────────────────┐ │ │ │ Device Instance │ │ │ │ ┌─────────────┬─────────────┬─────────────┐ │ │ │ │ │ Sensor 1 │ Sensor 2 │ Sensor N │ │ │ │ │ └─────────────┴─────────────┴─────────────┘ │ │ │ └─────────────────────────────────────────────────┘ │ │ │ │ │ ┌───────────────────────┴───────────────────────────┐ │ │ │ IotCloud Library │ │ │ │ ┌──────────────┐ ┌──────────────┐ │ │ │ │ │ WiFi Manager │ │ MQTT Client │ │ │ │ │ └──────────────┘ └──────────────┘ │ │ │ └───────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────┘ │ ▼ ┌───────────────────────┐ │ IotCloud Platform │ │ (MQTT Broker) │ └───────────────────────┘ 

Sensor (Base) ├── AnalogSensor - Numeric values (temperature, humidity, CO2) ├── SwitchSensor - Binary on/off states ├── Toogle - Motorized control (up/down/stop) ├── Thermostat - Temperature control with setpoint ├── LedSensor - LED strip control with brightness └── Notifier - Push notification sender 

#pragma once #include <sensors/analog.h> class MySensor : public AnalogSensor { private: void get_value() override; // Called periodically by framework public: MySensor(const char* id, const char* name, const char* metadata); };

#include "my_sensor.h" MySensor::MySensor(const char* id, const char* name, const char* metadata) : AnalogSensor(id, name, 30000, 1, true, "analog", metadata, 0.01) { // 30000ms interval, CoV=1, retained, 1% filtering } void MySensor::get_value() { float value = readHardware(); if (!isnan(value)) { set_value(value); // Publishes to MQTT if changed } }

Sensor metadata defines display properties and settings:

{ "engUnits": "°C", "stringFormat": "#0.0", "settings": [ { "name": "Offset", "description": "Calibration offset", "endpoint": "offset", "actionType": "floatpar", "value": 0.0, "limits": {"hi": 10.0, "lo": -10.0} } ] }

void loop() { bool current_state = digitalRead(SWITCH_PIN); if (current_state != _last_state) { _debounce_pending = true; _debounce_time = millis(); } if ((millis() - _debounce_time) > 50) { // 50ms debounce if (_debounce_pending) { _debounce_pending = false; process_state_change(current_state); } } _last_state = current_state; }

This project is part of the IotCloud ecosystem. See individual project files for specific licensing information.

1. Follow the existing sensor class patterns
2. Include proper debouncing for physical inputs
3. Use meaningful sensor IDs and metadata
4. Test on target hardware before submitting
5. Document pin mappings and dependencies