Emulate a Philips Hue bridge running on an ESP8266 using the Arduino IDE.
C++ Other
Switch branches/tags
Nothing to show
Clone or download
Quanghoster and probonopd First iteration of SPIFFS support (#93)
* Added secrets

* Delete secrets.h

* Fixed Alexa discovery issue

Added AddSingleLightJson method which corrects a json structure issue when the amazon echo tries to discover what lights are present.
Adjusted case of "urn:schemas-upnp-org:device:basic:1" references as to what has been observed on the network

* Initial smarthome skill

* Revert "Initial smarthome skill"

This reverts commit 417508f.

* Revert "Revert "Initial smarthome skill""

This reverts commit 4b5d8a7.

* resynched with upstream

* Fix for json respose for /lights/n

* Delete index.js

* Delete index.zip

* Added SPIFFS Support

* Added data folder

Added data folder with readme file to wipe the filesystem using the Sketch Data Load plugin

* Updated to pull esp8266 support from github

* Updated shell script for build

* Revised script

* Updated reference in script to arduino 1.8.5

* updated script reference

* using rawgit

* uodate to gist url

* script update

* Corrected esp8266 path

* Updated

* comments out Adafruit tests mv

* Selected Generic board in script

* Added bin tools

* fixed

* change board name

* adjusting bash script

* mod to bash script

* commented out esp board install

* testing

* commented sed commands to test build

* testing build script

* testing

* commented out ln

* ?

* Update .travis.yml

* Updated script

* Updated Gist file

* Updated gist file

* Updated gist

* Gist update

* Update

* Updated

* Updated

* Updated

* Corrected header file

* Returned to original

* mo

* Changed variable name from light to root to resolve conflict

* Delete IOTServer.h

* Delete IOTServer.cpp

* Revert "Changed variable name from light to root to resolve conflict"

This reverts commit ea88fd3.

* re-applying change

* Update .travis.yml

* Cache file management and addSingleLightJson fix

Removed dupicate of addSingleLight()
Added feature to delete Group and Scene cache files from index page on web server.
Latest commit ffe02d2 Nov 25, 2017


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 (= pin D4 on the WEMOS D1 mini) 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.


  • I used Arduino-1.6.11.hourly201608161225.esp497d19d-x86_64.AppImage which conveniently comes with both the Arduino IDE and esp8266/Arduino ready-to-use; otherwise use a recent version of the Arduino IDE and esp8266/Arduino
  • In the Arduino IDE, Open the Library Manager and search for "NeoPixelBus by Makuna" and install
  • Download https://github.com/interactive-matter/aJson/archive/master.zip and install the library via the Arduino IDE
  • Important: Change #define PRINT_BUFFER_LEN 256 to #define PRINT_BUFFER_LEN 4096 in aJson/aJSON.h
  • 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 ;-)


Everything in one go:

mkdir -p $HOME/Arduino/libraries/
cd $HOME/Arduino/libraries/
git clone --branch 2.1.4 https://github.com/Makuna/NeoPixelBus.git
git clone https://github.com/interactive-matter/aJson.git
git clone https://github.com/PaulStoffregen/Time.git
git clone https://github.com/gmag11/NtpClient.git
sed -i -e 's|#define PRINT_BUFFER_LEN 256|#define PRINT_BUFFER_LEN 4096|g'  aJson/aJSON.h
cd -
git clone https://github.com/probonopd/ESP8266HueEmulator.git
sed -i -e 's|#include "/secrets.h"|//#include "/secrets.h"|g' ESP8266HueEmulator/ESP8266HueEmulator/ESP8266HueEmulator.ino
sed -i -e 's|//const char|const char|g' ESP8266HueEmulator/ESP8266HueEmulator/ESP8266HueEmulator.ino


  • 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