The openHAB Documentation Has Moved

The documentation has moved to openhab.org/docs and openhab.org/addons.

Please use the link below to be redirected to the new version of this article, and update your bookmarks.

ZTM230 Dual paddle wall mounted transmitter

This describes the Z-Wave device ZTM230, manufactured by ACT - Advanced Control Technologies with the thing type UID of act_ztm230_00_000.

ZTM230 product image

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 from other devices.

Overview

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.

Inclusion Information

Including to the Network (Must be installed in its permanent location, not on test bench)
1. Setup the controller you are using to include the device into the network.
2. Tap the top or bottom of the left switch once

Exclusion Information

1. Setup the controller you are using to exclude a device from the network.
2. Tap the top or the bottom of the left switch once.

Channels

The following table summarises the channels available for the ZTM230 -:

Channel Channel Id Category Item Type
Switch switch_binary Switch Switch
Dimmer switch_dimmer DimmableLight Dimmer

Switch

Switch the power on and off.

The switch_binary channel supports the Switch item and is in the Switch category.

Dimmer

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 supports the Dimmer item and is in the DimmableLight category.

Device Configuration

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

Parameter 1: Ignore Start Level Bit

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.

Parameter 2: Suspend Group 4

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.

Parameter 3: Night Light

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.

Parameter 4: Invert Switch

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.

Parameter 5: Ignore Start Level Bit

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.

Parameter 7: On/Off Command dim step

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.

Parameter 8: On/Off Command dim timer

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.

Parameter 9: Local Control dim rate

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.

Parameter 10: Dim timer Parameter

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.

Parameter 11: ALL ON/ALL OFF dim step

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.

Parameter 12: ALL ON/ALL OFF dim rate

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.

Parameter 13: Disable group 4 during dim command

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.

Parameter 14: Enable shade control group 2

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.

Parameter 15: Enable shade control group 3

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.

Parameter 16: Enable shade control group 1

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.

Parameter 19: Transmission LED

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.

Parameter 20: Poll group 1 interval

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.

Parameter 21: Poll group 1

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.

Parameter 22: Poll Group 2

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.

Switch All Mode

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

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: Group 1

Group 1 left paddle This group supports 5 nodes.

Group 2: Group 2

Group 2 right paddle This group supports 5 nodes.

Group 3: Group 3

Group 3 double tap right paddle This group supports 5 nodes.

Group 4: Group 4

Group 4 This group supports 5 nodes.

Technical Information

Endpoints

Endpoint 0

Command Class Comment
COMMAND_CLASS_NO_OPERATION_V1  
COMMAND_CLASS_BASIC_V1  
COMMAND_CLASS_SWITCH_BINARY_V1  
COMMAND_CLASS_SWITCH_MULTILEVEL_V1  
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.