Philips Hue

What is Philips Hue

Philips Hue is a light system build using RGB- and white light bulbs and LED strips, which are under control by a Hue bridge. While the Hue bridge can be accessed over WiFi, all the connected devices use a Zigbee mesh network to communicate. By sending a webservice request to the controller, it communicates over Zigbee to the connected lights to activate, deactivate or dim it.

Compatible products

The Philips living colors and Philips living whites are also compatible with Philips Hue and can be controlled remotely. Poducts of other brands compatible with Zigbee Light Link can work with the Philips Hue eco system. These are in theory:

Confirmed compatible with Hue controlled by DomotiGa

Osram Lighify

The Osram Plug (http://www.osram.nl/osram_bx/nl/producten/verlichtingscomponenten/lightify-controlunits/lightify-home/lightify-plug/index.jsp)
The plug is confirmed to work with DomotiGa, but require an adjusted Gambas class to prevent DomotiGa crashing. See https://www.domotiga.nl/issues/605.
Notes:
  1. The v2 of the Hue app is required if you want to control the plug from the Hue app. The v1 version is only capable of switching on the plug
  2. The Logitech Harmony Companion can only switch off the Osram plug...

Philips LivingWhites plug

The Philips LivingWhites plug (http://www.philips.nl/c-p/6916531PH/livingwhites-stekker) is known to work with Hue, but appears hard to find in shops today. They are put up for sale by people on www.Ḿarktplaats.nl (or similar), who switched to LED lamps and don't use them any more. The LW plug requires a special set-up procedure to get it working. It involves the use of the Lampfinder program supplied by the Philips Hue development team, because support for the find procedure (Touchlink) is removed from the Hue apps. There are two versions of Lampfinder available and requires Java on your computer:

Place the plug close to the Hue bridge (<30 cm) and power it. Start the Lampfinder program on your computer and follow the steps shown by the program to connect it to the Hue bridge and then have the Hue bridge start scanning for a new LW plug. After a successful find the plug is now visible in the Hue app (the section lamps will have a +). Handle it as it was a lamp.

Remark: dimming is working as well if the switch on the bottom of the LW plug is in the correct position.

Innr GU10 (RS122)

Inner GU10 RS122 spots are easily found by the Philips Hue App version 2. Just power the new lamp and follow the apps' designated procedure for adding new lamps. After starting the find procedure, switch the lamp off and back on. It should now be found and added to your system.

A few remarks on the performance of the Innr RS122 spot:
  • it is instant on, not 'slow on' as the Philips Hue whites
  • dimming is a bit jerky; it is not as smooth as the Hue lamps

Controlling the Inner GU10 spot using DomotiGa is the same as any Hue lamp and no special set-up is required. No experience jet controlling the spots from Logitech Harmony.

Requirements

Philips Hue has the following requirements:
  • DomotiGa 1.0.017 or higher
  • Gambas 3.6.0 or higher
  • DomotiGa Device Discovery plug-in enabled
  • Access to the Philips Hue Bridge

DomotiGa Setup

  1. Enable the DomotiGa Device Discovery plugin
  2. Enable the DomotiGa Philips Hue plugin
  3. Open the logfile of DomotiGa and wait until a Philips Hue Bridge is discovered, than press the button on the Philips Hue Bridge

Note: DomotiGa can control the devices connected to the Philips Hue bridge and will update its database accordingly. Status reports send by the Hue bridge to DomotiGa will not be updated in the DomotiGa databse.

Tips, Tricks and Troubleshooting

Using the Philips Hue without DomotiGa Philips Hue plugin

First of all, credits go to degerrit

Maybe as a note to newbies, just because there is not (yet) a Hue module, this doesn't mean integration is not possible.

As an example, you can have your lights flash a short alert (and return to their previous state) with a very simple Domotiga Action.

Create an executable bash script with the IP address of your Hue Bridge and the hue user you set up (1); for example /home/domotiga/scripts/hue_alert.sh:

#!/bin/bash
# perform an alert cycle - i.e. "flash" on lights 1 2 and 3
# http://developers.meethue.com/1_lightsapi.html#16_set_light_state

HUEIPADDRESS=192.168.1.200
HUEUSER=31182071111111111111111e30f912

for a in 1 2 3; do curl -X PUT -d '{"alert":"select"}' http://${HUEIPADDRESS}/api/${HUEUSER}/lights/$a/state ; done
The new Domotiga action is then:
  • Action Type=Execute Command
  • Command=/home/domotiga/scripts/hue_alert.sh

Then use your action in some event. All done!

(1) For creating new users see http://developers.meethue.com/gettingstarted.html - just get the user name after creating a new app/devices using <i>{"devicetype":"DomotiGa"}</i>

Creating an username for DomotiGa Philips Hue plugin

If automated username generation of the plugin doesn`t work (fixed in DomotiGa 1.0.019) you can generate an username with the hue API debug tool following the guide:

http://www.developers.meethue.com/documentation/getting-started

1. login to your bridge via webbrowser:

 http://<bridge ip address>/debug/clip.html

2. type in the following commands:

Address:

 http://<bridge ip address>/api

Body:

 {"devicetype":"DomotiGa"}

Method:

POST

3. Push the button on your bridge for validation.

4. Push button POST on the webinterface

5. Fill in the generated username into the hue plugin.

Related Resources


    Updated by: OWK, Updated about 1 year ago
    Access count: 68616 since 2013-03-12

    Attached Files

    hue.jpg (21.5 KB) rdnzl, 03/12/2013 11:53 AM

    Also available in: PDF HTML TXT