Skip to content

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

License

Notifications You must be signed in to change notification settings

benzino77/homie-esp8266

 
 

Repository files navigation

homie-esp8266 banner

Homie for ESP8266

Build Status Latest Release Gitter

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

Note for v1.x users

The new documentation and Web configurator are only for the v2.

Download

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

Features

#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 https://homie-esp8266.readme.io 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. 😉

Donate button

About

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

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C++ 98.8%
  • Other 1.2%