Release 1.2.0 (#21)

examples/advanced-availability/advanced-availability.ino

@@ -0,0 +1,64 @@
+#include <Ethernet.h>
+#include <ArduinoHA.h>
+
+#define INPUT_PIN       9
+#define BROKER_ADDR     IPAddress(192,168,0,17)
+
+byte mac[] = {0x00, 0x10, 0xFA, 0x6E, 0x38, 0x4A};
+unsigned long lastReadAt = millis();
+unsigned long lastAvailabilityToggleAt = millis();
+bool lastInputState = false;
+
+EthernetClient client;
+HADevice device(mac, sizeof(mac));
+HAMqtt mqtt(client, device);
+
+// "input" may be anything you want to be displayed in HA panel
+// "door" is device class (based on the class HA displays different icons in the panel)
+// "true" is initial state of the sensor. In this example it's "true" as we use pullup resistor
+HABinarySensor sensor("input", "door", true);
+
+void setup() {
+    pinMode(INPUT_PIN, INPUT_PULLUP);
+    lastInputState = digitalRead(INPUT_PIN);
+
+    // you don't need to verify return status
+    Ethernet.begin(mac);
+
+    lastReadAt = millis();
+    lastAvailabilityToggleAt = millis();
+
+    // set device's details (optional)
+    device.setName("Arduino");
+    device.setSoftwareVersion("1.0.0");
+
+    // This method enables availability for all device types registered on the device.
+    // For example, if you have 5 sensors on the same device, you can enable
+    // shared availability and change availability state of all sensors using
+    // single method call "device.setAvailability(false|true)"
+    device.enableSharedAvailability();
+
+    // Optionally, you can enable MQTT LWT feature. If device will lose connection
+    // to the broker, all device types related to it will be marked as offline in
+    // the Home Assistant Panel.
+    device.enableLastWill();
+
+    mqtt.begin(BROKER_ADDR);
+}
+
+void loop() {
+    Ethernet.maintain();
+    mqtt.loop();
+
+    if ((millis() - lastReadAt) > 30) { // read in 30ms interval
+        // library produces MQTT message if a new state is different than the previous one
+        sensor.setState(digitalRead(INPUT_PIN));
+        lastInputState = sensor.getState();
+        lastReadAt = millis();
+    }
+
+    if ((millis() - lastAvailabilityToggleAt) > 5000) {
+        device.setAvailability(!device.isOnline());
+        lastAvailabilityToggleAt = millis();
+    }
+}

examples/availability/README.md

@@ -5,6 +5,8 @@ It's supported only by following device types:
 * Binary sensor
 * Sensor
 * Switch
+* HVACs
+* Fans
 
 ## Initialization and usage
 

examples/availability/availability.ino

@@ -16,7 +16,7 @@ HAMqtt mqtt(client, device);
 // "input" may be anything you want to be displayed in HA panel
 // "door" is device class (based on the class HA displays different icons in the panel)
 // "true" is initial state of the sensor. In this example it's "true" as we use pullup resistor
-HABinarySensor sensor("input", "door", true, mqtt);
+HABinarySensor sensor("input", "door", true);
 
 void setup() {
     pinMode(INPUT_PIN, INPUT_PULLUP);
@@ -26,6 +26,7 @@ void setup() {
     Ethernet.begin(mac);
 
     // turn on "availability" feature
+    // this method also sets initial availability so you can use "true" or "false"
     sensor.setAvailability(false);
 
     lastReadAt = millis();

examples/binary-sensor/binary-sensor.ino

@@ -15,7 +15,7 @@ HAMqtt mqtt(client, device);
 // "input" may be anything you want to be displayed in HA panel
 // "door" is device class (based on the class HA displays different icons in the panel)
 // "true" is initial state of the sensor. In this example it's "true" as we use pullup resistor
-HABinarySensor sensor("input", "door", true, mqtt);
+HABinarySensor sensor("input", "door", true);
 
 void setup() {
     pinMode(INPUT_PIN, INPUT_PULLUP);

examples/fan/fan.ino

@@ -0,0 +1,58 @@
+#include <Ethernet.h>
+#include <ArduinoHA.h>
+
+#define BROKER_ADDR     IPAddress(192,168,0,17)
+
+byte mac[] = {0x00, 0x10, 0xFA, 0x6E, 0x38, 0x4A};
+
+EthernetClient client;
+HADevice device(mac, sizeof(mac));
+HAMqtt mqtt(client, device);
+
+// HAFan::SpeedsFeature enables support for setting different speeds of fan.
+// You can skip this argument if you don't need speed management.
+HAFan fan("ventilation", HAFan::SpeedsFeature);
+
+void onStateChanged(bool state) {
+    Serial.print("State: ");
+    Serial.println(state);
+}
+
+void onSpeedChanged(HAFan::Speed speed) {
+    Serial.print("Speed: ");
+    if (speed == HAFan::OffSpeed) {
+        Serial.print("off");
+    } else if (speed == HAFan::LowSpeed) {
+        Serial.print("low");
+    } else if (speed == HAFan::MediumSpeed) {
+        Serial.print("medium");
+    } else if (speed == HAFan::HighSpeed) {
+        Serial.print("high");
+    }
+}
+
+void setup() {
+    // you don't need to verify return status
+    Ethernet.begin(mac);
+
+    // set device's details (optional)
+    device.setName("Arduino");
+    device.setSoftwareVersion("1.0.0");
+
+    // configure fan (optional)
+    // default speeds are: Off | Low | Medium | High
+    fan.setSpeeds(HAFan::OffSpeed | HAFan::LowSpeed | HAFan::HighSpeed);
+    fan.setName("Bathroom");
+    fan.setRetain(true);
+
+    // handle fan states
+    fan.onStateChanged(onStateChanged);
+    fan.onSpeedChanged(onSpeedChanged);
+
+    mqtt.begin(BROKER_ADDR);
+}
+
+void loop() {
+    Ethernet.maintain();
+    mqtt.loop();
+}

examples/hvac/hvac.ino

@@ -0,0 +1,102 @@
+#include <ESP8266WiFi.h>
+#include <ArduinoHA.h>
+
+#define BROKER_ADDR     IPAddress(192,168,0,17)
+#define WIFI_SSID       "MyNetwork"
+#define WIFI_PASSWORD   "MyPassword"
+
+WiFiClient client;
+HADevice device;
+HAMqtt mqtt(client, device);
+
+// see src/device-types/HAHVAC.h header for more details
+HAHVAC hvac("my_name", HAHVAC::AuxHeatingFeature | HAHVAC::AwayModeFeature | HAHVAC::HoldFeature);
+
+unsigned long lastTempPublishAt = 0;
+double lastTemp = 0;
+
+void onAuxHeatingStateChanged(bool state) {
+    Serial.print("Aux heating: ");
+    Serial.println(state);
+}
+
+void onAwayStateChanged(bool state) {
+    Serial.print("Away state: ");
+    Serial.println(state);
+}
+
+void onHoldStateChanged(bool state) {
+    Serial.print("Hold state: ");
+    Serial.println(state);
+}
+
+void onTargetTemperatureChanged(double temp) {
+    Serial.print("Target temperature: ");
+    Serial.println(temp);
+}
+
+void onModeChanged(HAHVAC::Mode mode) {
+    Serial.print("Mode: ");
+    if (mode == HAHVAC::OffMode) {
+        Serial.println("off");
+    } else if (mode == HAHVAC::AutoMode) {
+        Serial.println("auto");
+    } else if (mode == HAHVAC::CoolMode) {
+        Serial.println("cool");
+    } else if (mode == HAHVAC::HeatMode) {
+        Serial.println("heat");
+    } else if (mode == HAHVAC::DryMode) {
+        Serial.println("dry");
+    } else if (mode == HAHVAC::FanOnlyMode) {
+        Serial.println("fan only");
+    }
+}
+
+void setup() {
+    Serial.begin(9600);
+    Serial.println("Starting...");
+
+    // Unique ID must be set!
+    byte mac[WL_MAC_ADDR_LENGTH];
+    WiFi.macAddress(mac);
+    device.setUniqueId(mac, sizeof(mac));
+
+    // connect to wifi
+    WiFi.begin(WIFI_SSID, WIFI_PASSWORD);
+    while (WiFi.status() != WL_CONNECTED) {
+        Serial.print(".");
+        delay(500); // waiting for the connection
+    }
+    Serial.println();
+    Serial.println("Connected to the network");
+
+    // set device's details (optional)
+    device.setName("NodeMCU");
+    device.setSoftwareVersion("1.0.0");
+
+    // assign callbacks (optional)
+    hvac.onAuxHeatingStateChanged(onAuxHeatingStateChanged);
+    hvac.onAwayStateChanged(onAwayStateChanged);
+    hvac.onHoldStateChanged(onHoldStateChanged);
+    hvac.onTargetTemperatureChanged(onTargetTemperatureChanged);
+    hvac.onModeChanged(onModeChanged);
+
+    // configure HVAC (optional)
+    hvac.setName("My HVAC");
+    hvac.setMinTemp(10);
+    hvac.setMaxTemp(30);
+    hvac.setTempStep(0.5);
+    hvac.setRetain(true);
+
+    mqtt.begin(BROKER_ADDR);
+}
+
+void loop() {
+    mqtt.loop();
+
+    if ((millis() - lastTempPublishAt) > 3000) {
+        hvac.setCurrentTemperature(lastTemp);
+        lastTempPublishAt = millis();
+        lastTemp += 0.5;
+    }
+}

examples/led-switch/led-switch.ino

@@ -9,7 +9,7 @@ byte mac[] = {0x00, 0x10, 0xFA, 0x6E, 0x38, 0x4A};
 EthernetClient client;
 HADevice device(mac, sizeof(mac));
 HAMqtt mqtt(client, device);
-HASwitch led("led", false, mqtt); // you can use custom name in place of "led"
+HASwitch led("led", false); // you can use custom name in place of "led"
 
 void onSwitchStateChanged(bool state, HASwitch* s)
 {
@@ -27,6 +27,9 @@ void setup() {
     device.setName("Arduino");
     device.setSoftwareVersion("1.0.0");
 
+    // set icon (optional)
+    led.setIcon("mdi:lightbulb");
+
     // handle switch state
     led.onStateChanged(onSwitchStateChanged);
 

examples/mqtt-events/mqtt-events.ino

@@ -0,0 +1,32 @@
+#include <Ethernet.h>
+#include <ArduinoHA.h>
+
+#define BROKER_ADDR         IPAddress(192,168,0,17)
+
+byte mac[] = {0x00, 0x10, 0xFA, 0x6E, 0x38, 0x4A};
+
+EthernetClient client;
+HADevice device(mac, sizeof(mac));
+HAMqtt mqtt(client, device);
+
+void onMqttConnected() {
+    Serial.println("Connected to the broker!");
+}
+
+void onMqttConnectionFailed() {
+    Serial.println("Failed to connect to the broker!");
+}
+
+void setup() {
+    Serial.begin(9600);
+    Ethernet.begin(mac);
+
+    mqtt.onConnected(onMqttConnected);
+    mqtt.onConnectionFailed(onMqttConnectionFailed);
+    mqtt.begin(BROKER_ADDR);
+}
+
+void loop() {
+    Ethernet.maintain();
+    mqtt.loop();
+}

examples/mqtt-with-credentials/mqtt-with-credentials.ino

@@ -11,7 +11,7 @@ byte mac[] = {0x00, 0x10, 0xFA, 0x6E, 0x38, 0x4A};
 EthernetClient client;
 HADevice device(mac, sizeof(mac));
 HAMqtt mqtt(client, device);
-HASwitch led("led", false, mqtt); // you can use custom name in place of "led"
+HASwitch led("led", false); // you can use custom name in place of "led"
 
 void onSwitchStateChanged(bool state, HASwitch* s)
 {

examples/multi-state-button/multi-state-button.ino

@@ -14,7 +14,7 @@ byte mac[] = {0x00, 0x10, 0xFA, 0x6E, 0x38, 0x4A};
 EthernetClient client;
 HADevice device(mac, sizeof(mac));
 HAMqtt mqtt(client, device);
-HATriggers triggers(mqtt);
+HATriggers triggers;
 Button btn(BUTTON_PIN);
 bool holdingBtn = false;
 

examples/nano33iot/nano33iot.ino

@@ -9,7 +9,7 @@
 WiFiClient client;
 HADevice device;
 HAMqtt mqtt(client, device);
-HASwitch led("led", false, mqtt); // you can use custom name in place of "led"
+HASwitch led("led", false); // you can use custom name in place of "led"
 
 void onSwitchStateChanged(bool state, HASwitch* s)
 {

examples/nodemcu/nodemcu.ino

@@ -9,7 +9,7 @@
 WiFiClient client;
 HADevice device;
 HAMqtt mqtt(client, device);
-HASwitch led("led", false, mqtt); // you can use custom name in place of "led"
+HASwitch led("led", false); // you can use custom name in place of "led"
 
 void onSwitchStateChanged(bool state, HASwitch* s)
 {

examples/sensor/sensor.ino

@@ -10,21 +10,7 @@ double lastValue = 0;
 EthernetClient client;
 HADevice device(mac, sizeof(mac));
 HAMqtt mqtt(client, device);
-
-/**
- * Supported data types:
- * - uint8_t
- * - uint16_t
- * - uint32_t
- * - int8_t
- * - int16_t
- * - int32_t
- * - double
- * - float
- */
-// you can use custom name in place of "temp"
-// "0" is initial value of the sensor
-HASensor<double> temp("temp", 0, mqtt);
+HASensor temp("temp");
 
 void setup() {
     // you don't need to verify return status
@@ -34,8 +20,10 @@ void setup() {
     device.setName("Arduino");
     device.setSoftwareVersion("1.0.0");
 
-    // you can set custom units for the sensor (optional)
+    // configure sensor (optional)
     temp.setUnitOfMeasurement("°C");
+    temp.setDeviceClass("temperature");
+    temp.setIcon("mdi:home");
 
     mqtt.begin(BROKER_ADDR);
 }
@@ -48,5 +36,12 @@ void loop() {
         lastSentAt = millis();
         lastValue = lastValue + 0.5;
         temp.setValue(lastValue);
+
+        // Supported data types:
+        // uint32_t (uint16_t, uint8_t)
+        // int32_t (int16_t, int8_t)
+        // double
+        // float
+        // const char*
     }
 }