PaulPetring / ESP8266HueEmulator

Emulate a Philips Hue bridge running on an ESP8266 using the Arduino IDE.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

ESP8266HueEmulator Build Status

This sketch emulates a Philips Hue bridge running on an ESP8266 using the Arduino IDE. Right now this is a proof-of-concept; contributions are highly welcome. Hue client apps can discover the emulated bridge and begin talking to it using the Hue protocol.

phihue_e27_starterset_430x300 jpg

Optionally, vou can use a strip of individually addressable WS2812b NeoPixels and attach it to GPIO2. The sketch talks to a strip of NeoPixels connected to GPIO2 of the ESP8266 with no additional circuitry. Right now the sketch uses the NeoPixels to tell that it is powered on, connected to the WLAN etc., and can switch on the first 3 NeoPixels using a Hue client (e.g., the iOS app).

To make this work, the sketch advertises its service with the so-called "Simple Service Discovery Protocol" (SSDP) that is also used as discovery protocol of Universal Plug and Play (UPnP). This sketch uses the ESP8266SSDP library from https://github.com/me-no-dev/Arduino

Please note that currently only the bare minimum to advertise the emulated Hue bridge is implemented, but it is enough so that the http://chromaforhue.com OS X app can discover and communicate with the emulated bridge.

Usage

  • Build esp8266/Arduino from git - the Boards Manager version is not recent enough as of July 2015
  • Edit the sketch to contain your WLAN credentials
  • Load the sketch onto your ESP-01 or other ESP8266 device
  • Optionally connect the DATA line of your WS2812b NeoPixels to pin GPIO2 (you do not really need this in order to test communication between the sketch and Hue client apps)
  • Watch the output of the sketch in a serial console
  • Connect to the emulated bridge by using a Hue client app
  • Switch on one of the lights
  • Continue watching the output of the sketch in a serial console
  • Implement more of the protocol
  • Contribute pull requests ;-)

Credits

  • Philips for providing open Hue APIs that are not restricted for use on Philips-branded hardware (as far as I can see by looking at their liberal Terms and Conditions of Use)
  • igrr for bringing the ESP8266 platform to the Arduino IDE
  • me-no-dev for porting the uSSDP library to the ESP8266 platform and helping me make this work
  • Makuna for the NeoPixelBus library supporting WS2812b NeoPixels on the ESP8266
  • interactive-matter for the aJson library

About

Emulate a Philips Hue bridge running on an ESP8266 using the Arduino IDE.


Languages

Language:Arduino 98.8%Language:C 1.2%