etckeeper/openzwave/ge/28167-plugin-dimmer.xml

<Product Revision="3" xmlns="https://github.com/OpenZWave/open-zwave">
  <MetaData>
    <MetaDataItem name="OzwInfoPage">http://www.openzwave.com/device-database/0063:3038:5044</MetaDataItem>
    <MetaDataItem name="ProductPic">images/ge/28167-plugin-dimmer.png</MetaDataItem>
    <MetaDataItem id="3038" name="ZWProductPage" type="5044">https://products.z-wavealliance.org/products/2100/</MetaDataItem>
    <MetaDataItem id="3038" name="FrequencyName" type="5044">U.S. / Canada / Mexico</MetaDataItem>
    <MetaDataItem name="Name">Plug-in Smart Dimmer, Single Plug</MetaDataItem>
    <MetaDataItem name="InclusionDescription">1. Follow the instructions for your Z-Wave certified controller to add
the smart dimmer to the Z-Wave network.
2. Once the controller is ready to add your smart dimmer, single
press and release the manual/program button on the smart
dimmer to add it in the network.
Please reference the controller/gateway’s manual for instructions.</MetaDataItem>
    <MetaDataItem id="3038" name="Identifier" type="5044">28167/ZW3104</MetaDataItem>
    <MetaDataItem name="ProductManual">https://Products.Z-WaveAlliance.org/ProductManual/File?folder=&amp;filename=Manuals/2100/Binder1.pdf</MetaDataItem>
    <MetaDataItem name="ResetDescription">To return your dimmer to factory defaults:
1. If plugged in, unplug the dimmer from the receptacle.
2. Press and hold the top button for at least 3 seconds while you
plug the dimmer into a receptacle.
Note: This should only be used in the event your networks’ primary
controller is missing or otherwise inoperable.</MetaDataItem>
    <MetaDataItem name="Description">Transform any home into a smart home with the GE Z-Wave Plug-In Smart Dimmer. The Smart Dimmer enables wireless control of on/off and dim functions for standard incandescent table and floor lamps, as well as dimmable fluorescent, LED and CFL fixtures and more! Use the dimmer control to customize the lighting output and create the perfect ambiance for any room. The space-saving horizontal module plugs into a standard wall receptacle without blocking the second outlet or obstructing placement of furniture. The Dimmer provides one Z-Wave enabled outlet for the lamp you would like to control. Take control of your home lighting with GE Z-Wave Smart Lighting Controls! </MetaDataItem>
    <MetaDataItem name="ExclusionDescription">1. Follow the instructions for your Z-Wave certified controller to
remove a device from the Z-Wave network.
2. Once the controller is ready to remove your device, press and
release the manual/program button on the smart dimmer to
remove it from the network.</MetaDataItem>
    <ChangeLog>
      <Entry author="Justin Hammond - Justin@dynam.ac" date="08 May 2019" revision="2">Initial Metadata Import from Z-Wave Alliance Database - https://products.z-wavealliance.org/products/1433/xml</Entry>
      <Entry author="Justin Hammond - Justin@dynam.ac" date="02 Jun 2019" revision="3">Updated Metadata Import from Z-Wave Alliance Database - https://products.z-wavealliance.org/products/2100/xml</Entry>
    </ChangeLog>
  </MetaData>
  <!--

There are multiple sources of information for this product:

[ZWave Alliance]: https://products.z-wavealliance.org/products/1433

[EzZWave]: https://www.ezzwave.com/sites/jasco/uploads/documents/PDFs/part2/28167_Product_Page.pdf

The sources above contradict each other on multiple points.
  -->
  <CommandClass id="112">
    <Value genre="config" index="3" label="LED Light" max="2" min="0" size="1" type="list" value="1">
      <Help>Sets when the LED on the switch is lit.</Help>
      <Item label="LED on when light off" value="0"/>
      <Item label="LED on when light on" value="1"/>
      <Item label="LED always off" value="2"/>
    </Value>
    <!--

In [EzZWave], the configuration parameters from index 7 to 12 have a size of 1
for the odd parameters and 2 for the even ones. (This translates to `byte` and
`short` types.)

[ZWave Alliance] shows a size of 1 for these parameters (i.e. all `byte`).

[EzZWave] is correct. When I (@lddubeau) tested changing parameters with all
types set to `byte`, I could not set the even-numbered parameters. After
changing the even-numbered parameters to type `short`, I could set them.

Neither source of documentation does a good job at describing the role of the
dim step/rate parameters. I (@lddubeau) took a look at the other GE devices
defined in this database and adopted the descriptions and explanations that fit
best with the observed behavior.

    -->
    <Value genre="config" index="7" label="Z-Wave Command Dim Step" max="99" min="1" type="byte" units="" value="1">
      <Help>Indicates how many levels the dimmer will change for each dimming step.</Help>
    </Value>
    <Value genre="config" index="8" label="Z-Wave Command Dim Rate" max="255" min="1" type="short" units="x 10 milliseconds" value="3">
      <Help>This value indicates in 10 millisecond resolution, how often the dim level will change. For example, if you set this parameter to 1, then every 10ms the dim level will change. If you set it to 255, then every 2.55 seconds the dim level will change.</Help>
    </Value>
    <Value genre="config" index="9" label="Local Control Dim Step" max="99" min="1" type="byte" units="" value="1">
      <Help>Indicates how many levels the dimmer will change for each dimming step.</Help>
    </Value>
    <Value genre="config" index="10" label="Local Control Dim Rate" max="255" min="1" type="short" units="x 10 milliseconds" value="3">
      <Help>This value indicates in 10 millisecond resolution, how often the dim level will change. For example, if you set this parameter to 1, then every 10ms the dim level will change. If you set it to 255, then every 2.55 seconds the dim level will change.</Help>
    </Value>
    <Value genre="config" index="11" label="ALL ON/ALL OFF Dim Step" max="99" min="1" type="byte" units="" value="1">
      <Help>Indicates how many levels the dimmer will change for each dimming step.</Help>
    </Value>
    <Value genre="config" index="12" label="ALL ON/ALL OFF Dim Rate" max="255" min="1" type="short" units="x 10 milliseconds" value="3">
      <Help>This value indicates in 10 millisecond resolution, how often the dim level will change. For example, if you set this parameter to 1, then every 10ms the dim level will change. If you set it to 255, then every 2.55 seconds the dim level will change.</Help>
    </Value>
  </CommandClass>
  <CommandClass id="133">
    <Associations num_groups="1">
      <Group index="1" label="Lifeline" max_associations="1"/>
    </Associations>
  </CommandClass>
</Product>