openhab-docs/_addons_bindings/zwave/doc/nietech/ms12z_0_0.md

6.0 KiB

layout title
documentation MS12Z - ZWave

{% include base.html %}

MS12Z Wall Switch

This describes the Z-Wave device MS12Z, manufactured by NIE Technology with the thing type UID of nietech_ms12z_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.

MS12Z product image

The MS12Z 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.

Overview

Minoston MS12Z - a simple on/off switch with timer capabilities

Inclusion Information

Press the up or down button three times quickly to ADD and REMOVE

Exclusion Information

Press the up or down button three times quickly to ADD and REMOVE

General Usage Information

  • Press the up or down button three times quickly to ADD and REMOVE
  • Press the up or down button six times quickly to change Status LED Configuration
  • Press click Z-Wave button3 times quickly,and hold the third time for at least 10 seconds. to restore the device to the factory.
  • (Node:Please use this procedure only when the network primary controller is missing or otherwise inoperable.)

Channels

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

Channel Name Channel ID Channel Type Category Item Type
Switch switch_binary switch_binary Switch Switch
Scene Number scene_number scene_number Number

Switch

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.

Scene Number

Triggers when a scene button is pressed.

The scene_number channel is of type scene_number and supports the Number item. This channel provides the scene, and the event as a decimal value in the form <scene>.<event>. The scene number is set by the device, and the event is as follows -:

Event ID Event Description
0 Single key press
1 Key released
2 Key held down
3 Double keypress
4 Tripple keypress
5 4 x keypress
6 5 x keypress

Device Configuration

The following table provides a summary of the 4 configuration parameters available in the MS12Z. Detailed information on each parameter can be found in the sections below.

Param Name Description
1 Button Function
2 Status LED Configuration
3 Enable Auto Turn-Off Timer
4 Timer

Parameter 1: Button Function

The following option values may be configured -:

Value Description
0 Up Button ON,Down Button OFF.
1 Up Button OFF,Down Button ON
2 Up Button ON/OFF,Down Button ON/OFF

The manufacturer defined default value is 0 (Up Button ON,Down Button OFF.).

This parameter has the configuration ID config_1_1 and is of type INTEGER.

Parameter 2: Status LED Configuration

The following option values may be configured -:

Value Description
0 Output and the LED are in the different state.
1 Output and the LED are in the same state
2 LED Always OFF
3 LED Always ON

The manufacturer defined default value is 0 (Output and the LED are in the different state.).

This parameter has the configuration ID config_2_1 and is of type INTEGER.

Parameter 3: Enable Auto Turn-Off Timer

The following option values may be configured -:

Value Description
0 Timer Disabled
1 Timer Enabled

The manufacturer defined default value is 0 (Timer Disabled).

This parameter has the configuration ID config_3_1 and is of type INTEGER.

Parameter 4: Timer

Values in the range 1 to 65535 may be set.

The manufacturer defined default value is 65535.

This parameter has the configuration ID config_4_4 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 MS12Z supports 2 association groups.

Group 1: Lifeline

The Lifeline association group reports device status to a hub and is not designed to control other devices directly. When using the Lineline group with a hub, in most cases, only the lifeline group will need to be configured and normally the hub will perform this automatically during the device initialisation.

Association group 1 supports 1 node.

Group 2: Basic Set Command

Association group 2 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 Linked to BASIC
COMMAND_CLASS_ASSOCIATION_GRP_INFO_V1
COMMAND_CLASS_DEVICE_RESET_LOCALLY_V1
COMMAND_CLASS_CENTRAL_SCENE_V3
COMMAND_CLASS_ZWAVEPLUS_INFO_V1
COMMAND_CLASS_CONFIGURATION_V1
COMMAND_CLASS_MANUFACTURER_SPECIFIC_V1
COMMAND_CLASS_POWERLEVEL_V1
COMMAND_CLASS_FIRMWARE_UPDATE_MD_V1
COMMAND_CLASS_ASSOCIATION_V2
COMMAND_CLASS_VERSION_V2
COMMAND_CLASS_MULTI_CHANNEL_ASSOCIATION_V3

Did you spot an error in the above definition or want to improve the content? You can contribute to the database here.