An Arduino for ESP8266 implementation of Homie, an MQTT convention for the IoT.
The Git repository contains the development version of Homie for ESP8266. Stable releases are available on the releases page.
- Automatic connection/reconnection to Wi-Fi/MQTT
- JSON configuration file to configure the device
- Cute HTTP API / Web UI / App to remotely send the configuration to the device and get information about it
- Custom settings
- OTA over MQTT
- Magic bytes
- Available in the PlatformIO registry
- Pretty straightforward sketches, a simple light for example:
#include <Homie.h>
const int PIN_RELAY = 5;
HomieNode lightNode("light", "switch");
bool lightOnHandler(HomieRange range, String value) {
if (value == "true") {
digitalWrite(PIN_RELAY, HIGH);
Homie.setNodeProperty(lightNode, "on", "true"); // Update the state of the light
Serial.println("Light is on");
} else if (value == "false") {
digitalWrite(PIN_RELAY, LOW);
Homie.setNodeProperty(lightNode, "on", "false");
Serial.println("Light is off");
} else {
return false;
}
return true;
}
void setup() {
Serial.begin(115200);
Serial.println();
Serial.println();
pinMode(PIN_RELAY, OUTPUT);
digitalWrite(PIN_RELAY, LOW);
Homie_setFirmware("awesome-relay", "1.0.0");
lightNode.advertise("on").settable(lightOnHandler);
Homie.setup();
}
void loop() {
Homie.loop();
}
The project is documented on https://homie-esp8266.readme.io with a Getting started guide and every piece of information you will need.