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.

MH-S312 Two Way Switch

This describes the Z-Wave device MH-S312, manufactured by McoHome Technology Co., Ltd with the thing type UID of mcohome_mhs312_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.

MH-S312 product image

The MH-S312 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

Touch Panel Switch is a wall switch with built-in Z-Wave module. It supports basic command class,multi channel command class and multi channel association command class, which can control all associated devices synchronously. This product can be included and operated in any Z-Wave network with other Z-Wave certified devices from any other manufacturers.

Inclusion Information

Press and hold any key on the panel for 8 seconds. If inclusion is successful, all INDICATION LEDs on the panel will turn green, and all switches will turn on.

Exclusion Information

Press and hold any key on the panel for 8 seconds. If the exclusion is successful, all INDICATION LEDs on the panel will turn orange, and all switches will turn off. The exclusion will delete all association data

Channels

The following table summarises the channels available for the MH-S312 -:

Channel Channel Id Category Item Type
Switch switch_binary Switch Switch
Switch 1 switch_binary1 Switch Switch
Switch 2 switch_binary2 Switch Switch

Switch

Switch the power on and off.

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

Switch 1

Switch the power on and off.

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

Switch 2

Switch the power on and off.

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

Device Configuration

The following table provides a summary of the 6 configuration parameters available in the MH-S312. Detailed information on each parameter can be found in the sections below.

Param Name Description
2 Switch state saved or not when power failure 0=Saved 1=not saved
3 ALL ON/ALL OFF 0,1,2,255
4 LED Backlit brightness level 0=LED disabled 1-10=Min level-Max level
5 Key Mode 0-4
6 Key On duration 0=infinite 1~65535=unit “sec”
255 Factory setting 85=restore factory setting
  Switch All Mode Set the mode for the switch when receiving SWITCH ALL commands

Parameter 2: Switch state saved or not when power failure

0=Saved 1=not saved 0= not saved,switch will be off when powered again

1= saved,switch will keep the same state when powered again Values in the range 0 to 1 may be set.

The manufacturer defined default value is 1.

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

Parameter 3: ALL ON/ALL OFF

0,1,2,255 0=forbid ALL ON, forbid ALL OFF

1=forbid ALL ON, allow ALL OFF

2=allow ALL ON, forbid ALL OFF

255=allow ALL ON, allow ALL OFF Values in the range 0 to 255 may be set.

The manufacturer defined default value is 255.

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

Parameter 4: LED Backlit brightness level

0=LED disabled 1-10=Min level-Max level

Values in the range 0 to 10 may be set.

The manufacturer defined default value is 10.

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

Parameter 5: Key Mode

0-4 0=single click to switch on/off status

1=Key default as off state. When it is turned on, then it will be turned off automatically after a time period , which can be set in item 5

2=Key default as on state. When it is turned off, then it will be turned on automatically after a time period , which can be set in item 5

3=hold >3s then key is on, and off once released

4=single click to switch on/off status + hold >3s then key is on, and off once released Values in the range 0 to 4 may be set.

The manufacturer defined default value is 0.

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

Parameter 6: Key On duration

0=infinite 1~65535=unit “sec”

Values in the range 0 to 65535 may be set.

The manufacturer defined default value is 0.

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

Parameter 255: Factory setting

85=restore factory setting

Values in the range 0 to 0 may be set.

The manufacturer defined default value is 0.

This parameter has the configuration ID config_255_1_wo and is of type INTEGER. This is a write only parameter.

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 MH-S312 supports 3 association groups.

Group 1: Switch Button Group 1

This group supports 5 nodes.

Group 2: Switch Button Group 2

This group supports 5 nodes.

Group 3: All Status Reports

This group supports 1 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_SWITCH_ALL_V1| | | COMMAND_CLASS_MULTI_CHANNEL_V2| | | COMMAND_CLASS_CONFIGURATION_V0| | | COMMAND_CLASS_MANUFACTURER_SPECIFIC_V1| | | COMMAND_CLASS_ASSOCIATION_V1| | | COMMAND_CLASS_VERSION_V1| | | COMMAND_CLASS_MULTI_CHANNEL_ASSOCIATION_V1| |

Endpoint 1

| Command Class | Comment | |—————|———| | COMMAND_CLASS_BASIC_V0| | | COMMAND_CLASS_SWITCH_BINARY_V1| Linked to BASIC|

Endpoint 2

Command Class Comment
COMMAND_CLASS_BASIC_V0  
COMMAND_CLASS_SWITCH_BINARY_V1 Linked to BASIC

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