Differences

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

@@ 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