User Tools

Site Tools


philips:hue-en

Differences

This shows you the differences between two versions of the page.


philips:hue-en [2023/02/25 10:08] (current) – created - external edit 127.0.0.1
Line 1: Line 1:
 +====== Philips HUE ======
 +[[:english#command_stations|{{  :interface.png}}]][[:english|{{  :rocrail-logo-35.png}}]]
 +[[:english|Content]] -> **[[:english#command_stations|Command Stations]]** -> **Philips**  
 +   * **[[:philips:hue-en|HUE Setup]]** | [[:philips:hue-conf-en|HUE Configuration]] | [[:philips:hue-sensors-en|HUE Accessory]]
 +
 +{{https://developers.meethue.com/wp-content/themes/hue_developer_theme/img/site_logo.png}}
 + \\
 +=====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.\\
 +
 +**Note:** //Only Philips HUE products are supported by this library.//\\
 +
 + \\
 + \\
 +
 +=====Basic functionality=====
 +With output commands the following functions can be controlled:
 +  * Turn lamps on  and off
 +  * Set brightness
 +  * Set colour
 +See __**[[:weather-en|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. |\\
 +{{:philips:hue-setup-en.png}}\\
 +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 and Port====
 +The default port number is 80, and will also be used if the port number is set/left to zero.\\
 +__**[[#find_the_bridge|The IP address of the bridge.]]**__\\
 +====UserID====
 +**Note:** //This will be the ClientKey after programming the UserID.//\\
 +The UserID to use for command send to the bridge.\\
 +If the UserID does not yet exist it must be __**[[#programming_the_clientkey|Programmed]]**__.\\
 +====Sensors====
 +===Poll===
 +Poll for HUE sensor states.\\
 +===Interval===
 +Time in ms between the poll queries.\\
 +===Temperature===
 +Sensor address for be used as model temperature.\\
 +Only needed in case of multiple temperature sensors.\\
 +===Light Level===
 +Sensor address for be used as model light level.\\
 +Only needed in case of multiple light level sensors.\\
 +\\
 +====Options====
 +===Saturation===
 +Some lamp types will show a short flash if the saturation value is also send.\\
 +Default: Deactivated.
 +\\
 +===Monitoring===
 +If deactivated, no Trace messages will be send.\\
 +====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:
 +<code>
 +[{"id":"001788fffe1215cd","internalipaddress":"192.168.100.175"}]
 +</code>
 +The ** internalipaddress** can be used as Hostname in the setup dialog.\\
 + \\
 +
 +=====Programming the ClientKey=====
 +{{:philips:hue-pt-en.png}}\\
 +Just push the __**[[:pt-en#pt|PT Button]]**__ on the Programming Tab to generate a new __**[[#userid|ClientKey]]**__ 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.\\
 +The generated ClientKey will replace automatically user ID in the HUE Setup.\\ 
 +**Notes:**
 +  * Do not forget to use the right IID, Interface ID, in case more Command Stations are defined in Rocrail.
 +  * Restart Rocview to see the new ClientKey in the HUE Setup.
 +
 + \\
 +
 +=====Output=====
 +{{:philips:hue-output-en.png}}\\
 +====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====
 +===Light/LED===
 +The control in HUE is type independent but recommended is to use type "Light" for advanced rendering in Rocview.\\
 +{{:philips:output-iris.png}}\\
 +The "Iris" size depends on the brightness of the lamp if output type is set to light or backlight.\\
 +Make sure the __**[[:rocgui-gen-en#render_smooth| Render Smooth]]**__ option is active.\\
 +===Output===
 +Controlling simple types like Smart Plugs.\\
 +
 +
 +
 + \\
 +
 +=====Links=====
 +Rocrail is listed here under Software:
 +  * http://www.developers.meethue.com/tools-and-sdks
 +
 +Other links of interest:
 +  * https://www.philips-hue.com
 +  * http://www.developers.meethue.com/tools-and-sdks