Philips HUE

Introduction

hue is a wireless, app-controlled lighting solution with the so-called bridge as a central element. The bridge is connected to the router and communicates wirelessly with up to 50 LED light sources, which can be dimmed, switched on and off and - depending on the model - be changed in light colour.



Basic functionality

With output commands the following functions can be controlled:

  • Turn lamps on and off
  • Set brightness
  • Set colour

See Weather for more possibilities.

Setup

It is recommended to use the Philips App, Android/IOS, to check the installed HUE system and to discover new lamps.


Only the Hostname/IP-Address and the User ID are used.

Interface ID

The ID to reference this library for Output objects and Programming the UserID.

Hostname

UserID

The UserID to use for command send to the bridge.
If the UserID does not yet exist it must be Programmed.

Version

To get a generated Username from API 1.14 or higher this field must be set to 114 or higher.

Alternativ: creating an UserID in the Hue Bridge

Take a look at this link, if you want create the UserID directly on the Hue Bridge:
https://developers.meethue.com/documentation/getting-started

Find the Bridge

With the following http link the Bridge can be found:
https://www.meethue.com/api/nupnp
The browser should show you something like this:

[{"id":"001788fffe1215cd","internalipaddress":"192.168.100.175"}]

The internalipaddress can be used as Hostname in the setup dialog.

Programming the User ID

See also: HUE Configuration

Just push the PT Button on the Programming Tab to add the new User ID in the Bridge.
If the Link button was not pressed on the Bridge an error message will show up in the Server window; Just push the Link button on the Bridge and try again.
Do not forget to use the right IID, Interface ID, incase more Command Stations are defined in Rocrail.

:!: Too short user ID's are rejected by the bridge.

API 1.14+

The Version field must be set to 114 or higher to get a generated username.


Output


Interface ID

The Interface ID of the HUE library.

Address

The light number.

Parameter

The parameter is used to set the Hue of the light if set greater then zero.
Not all light types, like LUX, do support this option and will report a parameter error.

Value

The wanted brightness.

Blink

Activates the alert effect “lselect”; The light is performing breathe cycles for 30 seconds.

Type

The control in HUE is type independent but recommended is to use type “light” for advanced rendering in Rocview.

The “Iris” size depends on the brightness of the lamp if output type is set to light or backlight.
Make sure the Render Smooth option is active.


Links


Personal Tools