| layout | title |
|---|---|
documentation |
ZTM230 - ZWave |
{% include base.html %}
This describes the Z-Wave device ZTM230, manufactured by ACT - Advanced Control Technologies with the thing type UID of act_ztm230_00_000.
The device is in the category of Wall Switch, defining Any device attached to the wall that controls a binary status of something, for ex. a light switch.
The ZTM230 supports routing. This allows the device to communicate using other routing enabled devices as intermediate routers. This device is also able to participate in the routing of data between other devices in the mesh network.
The ZTM230 Wall Mounted Transmitter is a component of the HomePro lighting control system. Wire the Transmitter anywhere power is available according to the diagram above and program from the Wireless Controller to operate loads. Inclusion of the ZTM230 Wall Mounted Transmitter on the ZTH200 Wireless Controller menu allows remote ON/OFF control and dimming of lights controlled by associated modules, as it does not control any electrical load directly.
This Wall Mounted Transmitter is designed to work with other Z-Wave enabled devices. Z-Wave nodes of other types can be Included in the network and will also act as repeaters to increase the range of the network.
Including to the Network (Must be installed in its permanent location, not on test bench)
- Setup the controller you are using to include the device into the network.
- Tap the top or bottom of the left switch once
- Setup the controller you are using to exclude a device from the network.
- Tap the top or the bottom of the left switch once.
The following table summarises the channels available for the ZTM230 -:
| Channel Name | Channel ID | Channel Type | Category | Item Type |
|---|---|---|---|---|
| Switch [Deprecated] | switch_binary | switch_binary | Switch | Switch |
| Dimmer | switch_dimmer | switch_dimmer | DimmableLight | Dimmer |
Switch the power on and off.
The switch_binary channel is of type switch_binary and supports the Switch item and is in the Switch category.
Note: This channel is marked as deprecated so should not be used.
The brightness channel allows to control the brightness of a light. It is also possible to switch the light on and off.
The switch_dimmer channel is of type switch_dimmer and supports the Dimmer item and is in the DimmableLight category.
The following table provides a summary of the 19 configuration parameters available in the ZTM230. Detailed information on each parameter can be found in the sections below.
| Param | Name | Description |
|---|---|---|
| 1 | Ignore Transmitting Start Level Bit | Set Ignore Start Level Bit When Transmitting Dim Commands |
| 2 | Suspend Group 4 | Disable transmitting commands to group 4 devices. |
| 3 | Night Light | LED behaviour of the ZTM230. |
| 4 | Invert Switch | Switch paddle behaviour |
| 5 | Ignore Receiving Start Level Bit | Ignore Start Level When Receiving Dim Commands |
| 7 | On/Off Command dim step | Dim step parameter |
| 8 | On/Off Command dim timer | Dim timer parameter |
| 9 | Local Control dim rate | Dim step Parameter |
| 10 | Dim timer Parameter | Dim timer Parameter |
| 11 | ALL ON/ALL OFF dim step | ALL ON/ALL OFF dim step |
| 12 | ALL ON/ALL OFF dim rate | Dim timer Parameter |
| 13 | Disable group 4 during dim command | Disable group 4 during dim command |
| 14 | Enable shade control group 2 | Enable shade control group 2 |
| 15 | Enable shade control group 3 | Enable shade control group 3 |
| 16 | Enable shade control group 1 | Enable shade control group 1 |
| 19 | Transmission LED | Transmission LED behaviour |
| 20 | Poll group 1 interval | Group 1 poll interval |
| 21 | Poll group 1 | Poll group 1 |
| 22 | Poll Group 2 | Poll Group 2 interval (minutes). |
| Switch All Mode | Set the mode for the switch when receiving SWITCH ALL commands |
Set Ignore Start Level Bit When Transmitting Dim Commands The ZTM230 can send Dim commands to Z-Wave enabled dimmers. The Dim command has a start level embedded in it. A dimmer receiving this command will start dimming from that start level. However, the command can be sent so that the dimmer ignores the start level and instead start dimming from its current level. By default, the ZTM230 sends the command so that the dimmer will start dimming from its current dim level rather then the start level embedded in the command. To change this, simply set the configuration parameter above to 0. The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Do not ignore start level |
| 1 | Ignore start level |
The manufacturer defined default value is 1 (Ignore start level).
This parameter has the configuration ID config_1_1 and is of type INTEGER.
Disable transmitting commands to group 4 devices.
You may wish to disable transmitting commands to Z-Wave devices that are in Group 4 without “disassociating” those devices from the group.
Setting parameter 2 to the value of 1 will stop the ZTM230 from transmitting to devices that are “associated” into Group 4
Values in the range 0 to 1 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_2_1 and is of type INTEGER.
LED behaviour of the ZTM230. The LED on the ZTM230, will by default, turn ON when the status of the devices in Group 1 is ON. To make the LED turn ON when the status of Group 1 is OFF set this parameter to a value of 1. Values in the range 0 to 1 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_3_1 and is of type INTEGER.
Switch paddle behaviour To change the top of the transmitter to OFF and the bottom of the transmitter to ON, set parameter 4 to 1. To change back to original settings, set this parameter to the value of 0. Values in the range 0 to 1 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_4_1 and is of type INTEGER.
Ignore Start Level When Receiving Dim Commands The ZTM230 can send Dim commands to Z-Wave enabled dimmers. The Dim command has a start level embedded in it. A dimmer receiving this command will start dimming from that start level. However, the command can be sent so that the dimmer ignores the start level and instead start dimming from its current level. By default, the ZTM230 sends the command so that the dimmer will start dimming from its current dim level rather then the start level embedded in the command. To change this, simply set the configuration parameter above to 0
Note that this only affects a level that is reported or possibly sent by the ZTM230 since the ZTM230 does not control a load. Values in the range 0 to 1 may be set.
The manufacturer defined default value is 1.
This parameter has the configuration ID config_5_1 and is of type INTEGER.
Dim step parameter Dim step (dim rate) parameter. It can be set to a value of 1 to 99. This value indicates how many levels the dimmer will change when the timer (discussed below) expires. Values in the range 1 to 99 may be set.
The manufacturer defined default value is 3.
This parameter has the configuration ID config_7_1 and is of type INTEGER.
Dim timer parameter Dim timer parameter (how fast the dim rate) parameter. It can be set to a value of 1 to 255. This value indicates in 10 millisecond resolution, how often the dim level will change. For example, if you set this parameter to 1, then the dim level will change every 10mS. If you set it to 255, then the dim level will change every 2.55 seconds. Values in the range 1 to 255 may be set.
The manufacturer defined default value is 10.
This parameter has the configuration ID config_8_1 and is of type INTEGER.
Dim step Parameter Local Control dim rate. Values in the range 1 to 99 may be set.
The manufacturer defined default value is 3.
This parameter has the configuration ID config_9_1 and is of type INTEGER.
Dim timer Parameter Dim timer Parameter. Values in the range 1 to 255 may be set.
The manufacturer defined default value is 10.
This parameter has the configuration ID config_10_1 and is of type INTEGER.
ALL ON/ALL OFF dim step ALL ON/ALL OFF dim rate step parameter. Values in the range 1 to 99 may be set.
The manufacturer defined default value is 3.
This parameter has the configuration ID config_11_1 and is of type INTEGER.
Dim timer Parameter ALL ON/ALL OFF dim rate timer Parameter. Values in the range 1 to 255 may be set.
The manufacturer defined default value is 10.
This parameter has the configuration ID config_12_1 and is of type INTEGER.
Disable group 4 during dim command Note that this only affects a level that is reported or possibly sent by the ZTM230 since the ZTM230 does not control a load.
After the ZTM230 is commanded to stop dimming when it has been dimming because of the DIM START command, it will then command the Z-Wave devices that are in Group 4 to its new level. To prevent the ZTM230 from commanding the Z-Wave devices in Group 4 during this particular occurrence, set Parameter 13 to the value of 1. Values in the range 0 to 1 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_13_1 and is of type INTEGER.
Enable shade control group 2 The ZTM230 can control shade control devices via its group 2 if this configuration parameter is set to 1. Values in the range 0 to 1 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_14_1 and is of type INTEGER.
Enable shade control group 3 The ZTM230 can control shade control devices via its group 3 if this configuration parameter is set to 1. Values in the range 0 to 1 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_15_1 and is of type INTEGER.
Enable shade control group 1 The ZTM230 can control shade control devices via its group 1 if this configuration parameter is set to 1. Values in the range 0 to 1 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_16_1 and is of type INTEGER.
Transmission LED behaviour The ZTM230 will flicker its LED when it is transmitting to any of its 4 groups. This flickering can be set to not flicker at all (set to 0), to flicker the entire time it is transmitting (set to 1), or to flicker for only 1 second when it begins transmitting (set to 2). By default, the ZTM230 is set to flicker for only 1 second. Values in the range 0 to 2 may be set.
The manufacturer defined default value is 2.
This parameter has the configuration ID config_19_1 and is of type INTEGER.
Group 1 poll interval How often it will poll Group 1 is configured using this parameter 20. The default poll rate is 2. Note that the poll interval starts timing again upon successful transmission of the poll request. Also note that the polling interval is not “exact” and that you may see some slight drift occur. Also the poll interval is reset upon switch being pressed. In addition, on power up, the ZTM230 will randomly poll based upon it’s node ID within 2 minutes of power being applied. Values in the range 1 to 255 may be set.
The manufacturer defined default value is 2.
This parameter has the configuration ID config_20_1 and is of type INTEGER.
Poll group 1 The ZTM230 will poll the first node in Group 1 in order to keep itself synchronized with the group if this configuration parameter is set to 1. How often it will poll is configured using parameter 20. Values in the range 0 to 1 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_21_1 and is of type INTEGER.
Poll Group 2 interval (minutes). The ZTM230 will poll the first node in Group 2 in order to keep itself synchronized with the group if this configuration parameter is set to 1. How often it will poll is configured using parameter 20. Values in the range 0 to 1 may be set.
The manufacturer defined default value is 1.
This parameter has the configuration ID config_22_1 and is of type INTEGER.
Set the mode for the switch when receiving SWITCH ALL commands.
The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Exclude from All On and All Off groups |
| 1 | Include in All On group |
| 2 | Include in All Off group |
| 255 | Include in All On and All Off groups |
This parameter has the configuration ID switchall_mode and is of type INTEGER.
Association groups allow the device to send unsolicited reports to the controller, or other devices in the network. Using association groups can allow you to eliminate polling, providing instant feedback of a device state change without unnecessary network traffic.
The ZTM230 supports 4 association groups.
Group 1 left paddle
Nodes in this group are turned ON and OFF by tapping the top or bottom of the left switch.
Nodes associated into this group are dimmed by pressing and holding the bottom of the left switch until the desired dim level is reached.
Association group 1 supports 5 nodes.
Group 2 right paddle
Nodes in this group are turned ON and OFF by tapping the right switch.
Nodes associated into this group are dimmed by pressing and holding the bottom of the right switch until the desired dim level is reached. The LED on the right switch will indicate the status of group 2. Group 2 will be polled at a specific interval and the status of group 2 will be indicated via the LED. The polling interval can be configured.
Association group 2 supports 5 nodes.
Group 3 double tap right paddle Nodes in this group are turned ON and OFF by tapping the right switch twice. Nodes associated into this group are dimmed by tapping the bottom of the switch once and then pressing and holding the bottom of the switch until the desired dim level is reached.
note that associating nodes into group 3 will cause a very slight delay before the command is transmitted to group 2.
Association group 3 supports 5 nodes.
Group 4
Nodes in this group are turned ON or OFF or set to a specific dim level when the ZTM230 is controlled remotely. You can place up to 5 nodes in each group.
If controlling dimmers, for best results, associate the dimmers into the group first.
Association group 4 supports 5 nodes.
| Command Class | Comment |
|---|---|
| COMMAND_CLASS_NO_OPERATION_V1 | |
| COMMAND_CLASS_BASIC_V1 | |
| COMMAND_CLASS_SWITCH_BINARY_V1 | |
| COMMAND_CLASS_SWITCH_MULTILEVEL_V1 | Linked to BASIC |
| COMMAND_CLASS_SWITCH_ALL_V1 | |
| COMMAND_CLASS_CONFIGURATION_V1 | |
| COMMAND_CLASS_MANUFACTURER_SPECIFIC_V1 | |
| COMMAND_CLASS_ASSOCIATION_V1 | |
| COMMAND_CLASS_VERSION_V1 | |
| COMMAND_CLASS_INDICATOR_V1 |
Did you spot an error in the above definition or want to improve the content? You can contribute to the database here.