Homie for ESP8266

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

Note for v1.x users

The old configurator is not available online anymore. You can download it here.

Download

The Git repository contains the development version of Homie for ESP8266. Stable releases are available on the releases page.

Features

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);
  Homie.getLogger() << "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();
}

Requirements, installation and usage

The project is documented on http://marvinroger.github.io/homie-esp8266/ with a Getting started guide and every piece of information you will need.

Donate

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. 😉

Recommend Projects