Differences

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

--- dictionary:unitcontrol:simpreset [2016/03/14 15:40] – external edit 127.0.0.1
+++ dictionary:unitcontrol:simpreset [2023/02/13 14:52] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
 ====Sim Preset====
-Set the internal preset level for the light without actually sending any X-10 command. This is useful for "Simulated Smart" units the next ON received for the unit will cause it to dim or brighten to this new level. You can change the preset level or saved color data of a unit that is on or off without affecting it’s current value.
+Sets the internal preset level for the device as well as any color or color temperature data that you specify without changing the current settings of the device. If the unit is set to the “Simulated” dimmable type then this information will be used in the next On command or dim/bright command in the case of the color and color temperature data.
+Any Simulated device that is turned On will actually be sent a dim or brighten command with the last saved preset level and color data.
 ===Usage:===
-**sim preset** (text, name of the unit)\\
+**sim preset** (text) Name of the unit.
- **to** (integer, new preset value [0-100])
+ **to** (number) New preset value
 ===Color Support===
-Many color capable bulbs are now available for ZWave and ZigBee via the [[supported_hardware:hue|Phillips Hue]] hub. XTension can also create an “RGB Pseudo” that groups any 3 other units as the red, green and blue channels of a single fixture. Even if your device is not directly supported as an individual color lamp the channels are usually available separately. This is normally the case with ZWave 3 channel controllers. There are several optional parameters to this command for setting color. Some are specific to the hue bulbs, others will work for any color capable device.
+  * **rgb color** (standard HTML color string) 6 characters with the hex RGB values for the levels of the red green and blue. “RRGGBB” This is the preferred way to set a device color. “FF0000” would be full red, “00FF00” full green and “0000FF” full blue. After setting this via the sim preset command the next ON or dim/brighten you send to the device will include this color and color mode.
+  * **color temperature** (number) Mired color temperature. The available range of this will differ for different types of devices but will be in the range of 2000 to 50000. 2700 is a “warm” white, 3500 is a “bright” or halogen white, 5000 to 6000 is a “daylight” white. Once setting this with the sim preset command the next on or dim/brighten that XTension sends to the device will include this information.
-**rgb color** (text, a standard HTML color string with each 2 characters being 00 to FF a hex representation of the level of that color in the mix. All color devices support the rgb color command. This is the normal way to set the color of a bulb. “FF0000” would be full red, “0000FF” would be full blue.)\\
+  * **hue/saturation** an alternate way of specifying the color of a device.
-**hue/saturation** (integer, if using a Phillips Hue bulb you can set the color by passing the hue and saturation. If using this you must pass both the hue and saturation values.)\\
+  * **xvalue/yvalue** another alternate way of specifying the color.
-**xvalue/yvalue** (number, another method of sending color to a Phillips Hue bulb. If using this you must pass both the x and y coordinate values.)\\
+  * **color preset** (number [1-8]) sets the internal preset value to the settings of the indexed preset in the Unit.
-**color temperature** (integer, currently supported only for Phillips Hue bulbs this number corresponds to the color temperature. For the hue bulbs this is not the actual color temperature in kelvin, but a number from 153 to 500 with larger numbers being warmer. As other bulbs become more commonly available that support changes in color temperature support will be added for those.)\\
-**color preset** (number, 1-8, all color capable devices can have 8 colors or color temperatures set as presets. You can recall one by passing the color preset number to this parameter.)
-===Color Handling===
-If you are using a color capable device keep in mind that the level that the lamp displays the color at is separate from the brightness of the color that you are passing. For example, dimming a lamp to 10% with an rgb color of “FF0000” would result in a color at the lamp that is really “190000” So if you wish a dimmer red, you can just pass the full on along with a lower dim level. Color presets are handled in the same way. This can be a little confusing when just reading about it, but it does seem to make the most sense when actually using the lamp. You have your lamp at a specific color and you wish to change it to another color, you don’t wish the level to change dramatically along with that color preset change. This is how the Phillips Hue bulbs handle color changes natively and how XTension handles the RGB pseudo internally.
-Since the phillips hue bulbs are always treated as simulated including a color setting in the ON command will return the bulb to the last level with that level altering the color that you are passing to be the proper brightness.
-RGB colors on the computer screen do not correspond perfectly to the color displayed by the bulb. A lot of work was done to support the specific transforms necessary for the Phillips hue bulbs and as long as you are choosing a color that the bulb can actually generate the color display is pretty close. For RGB Pseudo devices there could be considerable differences between what is displayed on your screen and what is shown at the lamp. Many less expensive devices seem to have an underpowered red channel and so you may have to boost the red above what you need to see the proper color on the screen in order to see the proper color on the lamp itself.
 ===Notes:===
   * see manual section on [[:manual:simulatedpresetdim|Simulated Preset Dim]]