AydinAdn/homie-esp8266

ESP8266 framework for Homie, a lightweight MQTT convention for the IoT

Homie for ESP8266

An Arduino for ESP8266 implementation of Homie, an MQTT convention for the IoT.

Features

• Automatic connection/reconnection to Wi-Fi/MQTT
• Cute JSON configuration file to configure the credentials of the device
• Cute API / Web UI / App to get information about the device and to remotely send the configuration to the device
• OTA support
• Available in the PlatformIO registry
• Pretty straightforward sketches, a simple light for example:

#include <Homie.h>

const int PIN_RELAY = D1;

HomieNode light("light", "light");

bool lightOnHandler(String message) {
  if (message == "true") {
    digitalWrite(PIN_RELAY, HIGH);
    Homie.setNodeProperty(light, "on", "true"); // Update the state of the light
    Serial.println("Light is on");
  } else if (message == "false") {
    digitalWrite(PIN_RELAY, LOW);
    Homie.setNodeProperty(light, "on", "false");
    Serial.println("Light is off");
  } else {
    return false;
  }

  return true;
}

void setup() {
  pinMode(PIN_RELAY, OUTPUT);
  digitalWrite(PIN_RELAY, LOW);
  Homie.setFirmware("awesome-relay" ,"1.0.0");
  light.subscribe("on", lightOnHandler);
  Homie.registerNode(light);
  Homie.setup();
}

void loop() {
  Homie.loop();
}

Requirements, installation and usage

The project is documented on the Wiki, with a Getting started guide and every piece of informations you will need.