Differences

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

--- supported_hardware:wiz [2021/02/14 13:49]
James Sentman created
+++ supported_hardware:wiz [2021/02/14 17:49] (current)
James Sentman
@@ Line 6: / Line 6: @@
 The Wiz Connected plugin for XTension supports the WiFi versions of bulbs and switches from Phillips. This plugin does not support the Zigbee “Hue” lights or the Blue Tooth versions of their bulbs. For connecting XTension to a Hue Zigbee hub please use the separate [[supported_hardware:hue|Phillips Hue Plugin]].
+----
 ====XTension Setup:====
+{{:supported_hardware:wiz_setup.png?500 |}}
 The Wiz bulbs use a local network broadcast system to find each other and for control and so can only control devices on the same local network as XTension. Only a single instance of the plugin running is necessary to support any number of devices on the same network. No setup for the plugin is required beyond creating a new interface in XTension and selecting “Wiz Connected” from the device/plugin popup.
 Once you save and enable the plugin it will begin by doing a discovery on the local network. Any devices that are found will have a Unit in XTension created automatically for them if it doesn’t already exist. The Unit will reflect the capabilities of the device as far as dimmable or not and what color or color temperature capabilities are available.
-As of this first beta if you wish to rediscover new devices you must disable and re-enable the interface to do another discovery. Eventually a discovery will be done periodically and an interface button to discover now will be added.
+Discovered devices will initially be named with the interface name you used above and the unique MAC address of the unit. There does not appear to be a good way to get the name of the device that you configured into the Wiz system at this time. Once the Unit is created you can edit it and give it a more descriptive name. The current status and color or color temperature values will be reflected immediately in the new Unit.
-{{ :supported_hardware:wiz_list.png?400 |}}
+You can run a discovery of new devices at any time by clicking the **Discover New Devices Now** button or using the script command “discoverDevices()” as documented below.
-Discovered devices will initially be named with the interface name you used above and the unique MAC address of the unit. There does not appear to be a good way to get the name of the device that you configured into the Wiz system at this time. Once the Unit is created you can edit it and give it a more descriptive name. The current status and color or color temperature values will be reflected immediately in the new Unit.
+----
 ====Unit Settings:====
@@ Line 25: / Line 28: @@
 Once configured you can control the Wiz device’s color or color temperature and level just like any other such device in XTension via the various options to the [[dictionary:unitcontrol:turnon|Turn On]] and [[dictionary:unitcontrol:dim|dim/bright]] verbs.
+----
 ====Dealing With Scenes:====
@@ Line 34: / Line 39: @@
 When using the user interface the current brightness is used as the brightness for the scene. Changing the brightness of the unit may cancel the scene at least in this beta version. In the future you’ll be able to change the brightness of a scene without having to re-select it.
-There remain some oddness in XTension’s handling of scenes in this beta version. As I get more experience of just how it works I will continue to flesh out the support for them.
+There remains some oddness in XTension’s handling of scenes in this beta version. As I get more experience of just how it works I will continue to flesh out the support for them.
-If it is possible to create custom scenes in the device those are not yet supported.
+{{ :supported_hardware:wiz_fireplace_scene.png?400|}}
+A device running a scene will display the name of the scene and then the brightness in the Value fields throughout XTension. Here is an example of a device running the “Fireplace” scene at a brightness of 11%:
+While this is the default behavior you can override it by changing the On Label or Off Label in the Edit Unit dialogs [[xtension_manual:editunitdisplay|Display tab]]. For example: if you wish to always display just the value in the field adding the [[xtension_manual:advancedlabel|Advanced Label Syntax]] of just “<value>” to the On Label field would make it always display the brightness without any of the other labels.
+----
 ====Setting Scenes From a Script:====
@@ Line 48: / Line 58: @@
 </code>
-would set the bulb to run the “Party” scene at a speed of 200 and full brightness.
+would set the bulb to run the “Party” scene at a speed of 200 and full brightness. Note that the scene name is not case sensitive “party” would work as well.
+There is some oddness about how the bulbs respond to these commands that I haven’t figured out yet. When trying to just change the speed of the Party scene without changing the brightness the command is often ignored. If however you also change the brightness as well it seems to accept it. There also appear to be limits to what speeds are available at lower dimming ranges. Some experimentation may be necessary to get these bulbs to do what you desire.
+===Valid Scene Names:===
+The following are the currently valid scene names you can use as the name in the script command. The names are not case sensitive when sent through the script.
+  * Bedtime
+  * Candlelight
+  * Christmas
+  * Club
+  * Cool White (not recommended: just use the regular color temperature settings)
+  * Cozy
+  * Deepdive
+  * Fall
+  * Fireplace
+  * Focus
+  * Forest
+  * Golden White
+  * Halloween
+  * Jungle
+  * Mojito
+  * Night Light
+  * Ocean
+  * Party
+  * Pastel Colors
+  * Plantgrowth
+  * Pulse
+  * Relax
+  * Rhythm (I think this is used as part of a remote control type display and might not do anything otherwise)
+  * Romance
+  * Spring
+  * Steampunk
+  * Summer
+  * Sunset
+  * True Colors
+  * TV Time
+  * Wake up
+  * Warm White (not recommended: just use the regular color temperature settings)
+----
+====Other Supported Functions:====
+  * The bulb will respond to the [[dictionary:unitinformation:queryof|Query verb]] to force a poll via a script. Note that no value is returned from the query command, but if the value or settings of the bulb are different when the data is returned it will be updated. The Query verb is run async and operates in the background. The query command will update the data for the Unit in XTension regardless of the polling settings for the device. Even if the device is set for no polling at all you can do so manually via the query command.
+<code applescript>
+query “wiz device in bedroom”
+</code>
+  * To run a discover of new devices from a script use the discoverDevices command.
+<code>
+tell xInterface “name of your wiz interface” to discoverDevices()
+</code>
+  * Reboot a device. A device can be rebooted from the script command reboot()
+<code>
+tell xUnit “name of your wiz device unit” to reboot()
+</code>
+----
 ====Known Issues and Yet To Do:====
-Scenes are still a work in progress.
+  * Values often pop down one from what you set them after the next poll. For example you set the light to 100 and it resets to 99 after the next poll. This is a problem with conversion between the internal 0-255 value and XTensions 0-100 percent that is not completely sorted everywhere. This will be fixed before the release.
+  * If you are running a scene and issue a regular turnon or turn off it will reset the bulb to a non-scene regular setting but the value in XTension will not remove the name of the last scene until the next poll. This will be fixed before the non-beta release.
+  * Setting the scene to “None” does not stop the scene yet. Use a turn off or turn on to a specific color or color temperature to cancel a scene for the moment.
+  * If the bulb goes offline you’ll get errors in the log about it not being available for polling rather than an error in the Unit display as is the norm. This will be fleshed out in the next version.
-If the bulb goes offline you’ll get errors in the log about it not being available for polling rather than an error in the Unit display as is the norm. This will be fleshed out in the next version.
+  * If the bulb changes it’s IP address it will not yet be re-discovered until you disable and re-enable the interface. This will also be fixed in the next version. For most routers/DHCP servers this is not terribly likely to happen as it will ask for it’s same IP address with each update to it’s lease but not all devices support that so your milage may vary.
-If the bulb changes it’s IP address it will not yet be re-discovered until you disable and re-enable the interface. This will also be fixed in the next version. For most routers/DHCP servers this is not terribly likely to happen as it will ask for it’s same IP address with each update to it’s lease but not all devices support that so your milage may vary.
+----
 ====History:====
   * The Wiz plugin was first included in XTension version 9.4.37 as a beta.

Mac Home Automation

User Tools

Site Tools

Differences

Page Tools