An Arduino for ESP8266 implementation of Homie, an MQTT convention for the IoT.
The new documentation and Web configurator are only for the v2.
- The docs for the v1.5 is available at https://github.com/marvinroger/homie-esp8266/blob/528a4f77c6371366847ebf4def6aba942dfd0c4c/docs/index.md
- The Web configurator for v1.5 is available at http://marvinroger.github.io/homie-esp8266/
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(const HomieRange& range, const String& value) {
if (value != "true" && value != "false") return false;
bool on = (value == "true");
digitalWrite(PIN_RELAY, on ? HIGH : LOW);
lightNode.setProperty("on").send(value);
Serial << "Light is " << (on ? "on" : "off") << endl;
return true;
}
void setup() {
Serial.begin(115200);
Serial << endl << endl;
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.
I am a student and maintaining Homie for ESP8266 takes time. I am not in need and I will continue to maintain this project as much as I can even without donations. Consider this as a way to tip the project if you like it. ๐