| layout | title |
|---|---|
documentation |
MH-S521 - ZWave |
{% include base.html %}
This describes the Z-Wave device MH-S521, manufactured by McoHome Technology Co., Ltd with the thing type UID of mcohome_mhs521_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 MH-S521 does not permanently listen for messages sent from the controller - it will periodically wake up automatically to check if the controller has messages to send, but will sleep most of the time to conserve battery life. Refer to the Wakeup Information section below for further information.
Touch Panel Switch is a wall panel built-in with Z-Wave Plus module. With its stylish design and stable performance, the panel can be used to control house-hold electrical appliances like lamp, motor, coffee machine, TV set etc.
Press and hold any key on the panel for 8 seconds or 3 clicks in quick succession.
Press and hold any key on the panel for 8 seconds or 3 clicks in quick succession.
The MH-S521 does not permanently listen for messages sent from the controller - it will periodically wake up automatically to check if the controller has messages to send, but will sleep most of the time to conserve battery life. The wakeup period can be configured in the user interface - it is advisable not to make this too short as it will impact battery life - a reasonable compromise is 1 hour.
The wakeup period does not impact the devices ability to report events or sensor data. The device can be manually woken with a button press on the device as described below - note that triggering a device to send an event is not the same as a wakeup notification, and this will not allow the controller to communicate with the device.
The device can be manually woken with a button press on the device
The following table summarises the channels available for the MH-S521 -:
| Channel Name | Channel ID | Channel Type | Category | Item Type |
|---|---|---|---|---|
| Dimmer | switch_dimmer | switch_dimmer | DimmableLight | Dimmer |
| Scene Number | scene_number | scene_number | Number | |
| Electric meter (watts) | meter_watts | meter_watts | Energy | Number |
| Electric meter (kWh) | meter_kwh | meter_kwh | Energy | Number |
| Electric meter (volts) | meter_voltage | meter_voltage | Energy | Number |
| Electric meter (amps) | meter_current | meter_current | Energy | Number |
| Alarm | alarm_general | alarm_general | Alarm | Switch |
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.
Triggers when a scene button is pressed.
The scene_number channel is of type scene_number and supports the Number item.
Indicates the instantaneous power consumption.
The meter_watts channel is of type meter_watts and supports the Number item and is in the Energy category. This is a read only channel so will only be updated following state changes from the device.
Indicates the energy consumption (kWh).
The meter_kwh channel is of type meter_kwh and supports the Number item and is in the Energy category. This is a read only channel so will only be updated following state changes from the device.
Indicates the instantaneous voltage.
The meter_voltage channel is of type meter_voltage and supports the Number item and is in the Energy category. This is a read only channel so will only be updated following state changes from the device.
Indicates the instantaneous current consumption.
The meter_current channel is of type meter_current and supports the Number item and is in the Energy category. This is a read only channel so will only be updated following state changes from the device.
Indicates if an alarm is triggered.
The alarm_general channel is of type alarm_general and supports the Switch item and is in the Alarm category. This is a read only channel so will only be updated following state changes from the device.
The following state translation is provided for this channel to the Switch item type -:
| Value | Label |
|---|---|
| OFF | OK |
| ON | Alarm |
The following table provides a summary of the 22 configuration parameters available in the MH-S521. Detailed information on each parameter can be found in the sections below.
| Param | Name | Description |
|---|---|---|
| 2 | Power Failure State | switch will be off when powered again |
| 3 | ALL ON/ALL OFF | ALL ON/ALL OFF |
| 4 | LED Backlit brightness level | LED Backlit brightness level |
| 5 | Key Mode | Key Mode |
| 6 | Key On duration | Key On duration |
| 8 | Basic CC integration setting | Basic CC integration setting |
| 16 | Scene respond | Scene respond |
| 17 | Key1 Scene Activate Mode Setting | Key1 Scene Activate Mode Setting |
| 18 | Key1 Activate Scene ID | Key1 Activate Scene ID |
| 19 | Key1 Activate Scene Duration | Key1 Activate Scene Duration |
| 20 | Key2 Scene Activate Mode Setting | Key2 Scene Activate Mode Setting |
| 21 | Key2 Activate Scene ID | Key2 Activate Scene ID |
| 22 | Key2 Activate Scene Duration | Key2 Activate Scene Duration |
| 23 | Key3 Scene Activate Mode Setting | Key3 Scene Activate Mode Setting |
| 24 | Key3 Activate Scene ID | Key3 Activate Scene ID |
| 25 | Key3 Activate Scene Duration | Key3 Activate Scene Duration |
| 32 | Scene respond ID 1-50 | Scene respond ID 1-50 |
| 33 | Scene respond ID 51-100 | Scene respond ID 51-100 |
| 34 | Scene respond ID 101-150 | Scene respond ID 101-150 |
| 35 | Scene respond ID 151-200 | Scene respond ID 151-200 |
| 36 | Scene respond ID 201-250 | Scene respond ID 201-250 |
| 255 | Factory Reset | Factory Reset |
switch will be off when powered again
The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | not saved |
| 1 | saved |
The manufacturer defined default value is 1 (saved).
This parameter has the configuration ID config_2_1 and is of type INTEGER.
ALL ON/ALL OFF
The following option values may be configured -:
| Value | Description |
|---|---|
| 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 |
The manufacturer defined default value is 255 ( allow ALL ON, allow ALL OFF).
This parameter has the configuration ID config_3_1 and is of type INTEGER.
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.
Key Mode This function works for corridor or stairwell situation. The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | single click to switch on/off status |
| 1 | Key default as off state |
| 2 | Key default as on state |
| 3 | hold >3s then key is on, and off once released |
| 4 | single click + hold >3s then key is on |
The manufacturer defined default value is 0 (single click to switch on/off status).
This parameter has the configuration ID config_5_1 and is of type INTEGER.
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.
Basic CC integration setting **This parameter works for integration with different gateways/systems. If you do not know how to use, keep as default. **
- 0x00 "Basic Set" received，key 1 responds; "Basic Get" received，key 1 sends "Basic Report"; key 1 will not send unsolicited "Basic Report"（No Endpoint）to LifeLine Association
- 0x01 "Basic Set" received，key 1 responds; "Basic Get" received，key 1 sends "Basic Report"; key 1 will send unsolicited "Basic Report"（No Endpoint）to LifeLine Association
- 0x02 "Basic Set" received，all keys respond; "Basic Get" received，not reply "Basic Report"; All keys will not send unsolicited "Basic Report"（No Endpoint） to LifeLine Association
- 0x03 "Basic Set" received，all keys respond; "Basic Get" received，key 1 sends "Basic Report"; All keys will not send unsolicited "Basic Report"（No Endpoint）to LifeLine AssociationThis is an advanced parameter and will therefore not show in the user interface without entering advanced mode. Values in the range 0 to 3 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_8_1 and is of type INTEGER.
Scene respond
- 0x00: Scene respond disabled
- Bit0: =1 Key1 respond scene
- =0 Key1 not respond scene
- Bit1: =1 Key2 respond scene
- =0 Key2 not respond scene
- Bit2: =1 Key3 respond scene
- =0 Key3 not respond scene
- Bit7:4 Rev This is an advanced parameter and will therefore not show in the user interface without entering advanced mode. Values in the range 0 to 0 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_16_1 and is of type INTEGER.
Key1 Scene Activate Mode Setting
The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Scene activate function disabled |
| 1 | One click key1 always activate scene ID1 |
| 2 | only activate scene ID1 when key1's relay open |
| 3 | only activate scene ID1 when key1's relay closed |
The manufacturer defined default value is 0 (Scene activate function disabled).
This parameter has the configuration ID config_17_1 and is of type INTEGER.
Key1 Activate Scene ID
- 0x00 Scene ID is invalid and will not send scene activate command.
- 1~255 Scene ID Values in the range 0 to 255 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_18_1 and is of type INTEGER.
Key1 Activate Scene Duration
- 0x00 Instantly
- 0x01~0x7F: Dimming durations from 1 second (0x01) to 127 seconds (0x7F) in 1-second resolution
- 0x80~0xFE: Specify dimming durations from 1 minute (0x80) to 127 minutes (0xFE) in 1-minute resolution. Values in the range 0 to 255 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_19_1 and is of type INTEGER.
Key2 Scene Activate Mode Setting
The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Scene activate function disabled |
| 1 | always activate scene ID1 |
| 2 | ,only activate scene ID1 when key2's relay open |
| 3 | nly activate scene ID1 when key2's relay closed |
The manufacturer defined default value is 0 ( Scene activate function disabled).
This parameter has the configuration ID config_20_1 and is of type INTEGER.
Key2 Activate Scene ID
- 0x00 Scene ID is invalid and will not send scene activate command.
- 1~255 Scene ID Values in the range 0 to 255 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_21_1 and is of type INTEGER.
Key2 Activate Scene Duration
- 0x00 Instantly
- 0x01~0x7F: Dimming durations from 1 second (0x01) to 127 seconds (0x7F) in 1-second resolution
- 0x80~0xFE: Specify dimming durations from 1 minute (0x80) to 127 minutes (0xFE) in 1-minute resolution Values in the range 0 to 255 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_22_1 and is of type INTEGER.
Key3 Scene Activate Mode Setting
The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Scene activate function disabled |
| 1 | always activate scene ID1 |
| 2 | only activate scene ID1 when key3's relay open |
| 3 | only activate scene ID1 when key3's relay closed |
The manufacturer defined default value is 0 (Scene activate function disabled).
This parameter has the configuration ID config_23_1 and is of type INTEGER.
Key3 Activate Scene ID
- 0x00 Scene ID is invalid and will not send scene activate command.
- 1~255 Scene ID Values in the range 0 to 255 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_24_1 and is of type INTEGER.
Key3 Activate Scene Duration
- 0x00 Instantly
- 0x01~0x7F: Dimming durations from 1 second (0x01) to 127 seconds (0x7F) in 1-second resolution
- 0x80~0xFE: Specify dimming durations from 1 minute (0x80) to 127 minutes (0xFE) in 1-minute resolution. Values in the range 0 to 255 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_25_1 and is of type INTEGER.
Scene respond ID 1-50
- 0x00: Scene respond disabled
- Bit0:
- =1 Key1 respond scene
- =0 Key1 not respond scene
- Bit1:
- =1 Key2 respond scene
- =0 Key2 not respond scene
- Bit2:
- =1 Key3 respond scene
- =0 Key3 not respond scene
- Bit7:4 Rev
Valid only when the default is 0X00 for parameter 0X10This is an advanced parameter and will therefore not show in the user interface without entering advanced mode. Values in the range 0 to 255 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_32_1 and is of type INTEGER.
Scene respond ID 51-100
- 0x00: Scene respond disabled
- Bit0:
- =1 Key1 respond scene
- =0 Key1 not respond scene
- Bit1:
- =1 Key2 respond scene
- =0 Key2 not respond scene
- Bit2:
- =1 Key3 respond scene
- =0 Key3 not respond scene
- Bit7:4 Rev
Valid only when the default is 0X00 for parameter 0X10This is an advanced parameter and will therefore not show in the user interface without entering advanced mode. Values in the range 0 to 255 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_33_1 and is of type INTEGER.
Scene respond ID 101-150
- 0x00: Scene respond disabled
- Bit0:
- =1 Key1 respond scene
- =0 Key1 not respond scene
- Bit1:
- =1 Key2 respond scene
- =0 Key2 not respond scene
- Bit2:
- =1 Key3 respond scene
- =0 Key3 not respond scene
- Bit7:4 Rev
Valid only when the default is 0X00 for parameter 0X10This is an advanced parameter and will therefore not show in the user interface without entering advanced mode. Values in the range 0 to 255 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_34_1 and is of type INTEGER.
Scene respond ID 151-200
- 0x00: Scene respond disabled
- Bit0:
- =1 Key1 respond scene
- =0 Key1 not respond scene
- Bit1:
- =1 Key2 respond scene
- =0 Key2 not respond scene
- Bit2:
- =1 Key3 respond scene
- =0 Key3 not respond scene
- Bit7:4 Rev
Valid only when the default is 0X00 for parameter 0X10This is an advanced parameter and will therefore not show in the user interface without entering advanced mode. Values in the range 0 to 255 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_35_1 and is of type INTEGER.
Scene respond ID 201-250
- 0x00: Scene respond disabled
- Bit0:
- =1 Key1 respond scene
- =0 Key1 not respond scene
- Bit1:
- =1 Key2 respond scene
- =0 Key2 not respond scene
- Bit2:
- =1 Key3 respond scene
- =0 Key3 not respond scene
- Bit7:4 Rev
Valid only when the default is 0X00 for parameter 0X10This is an advanced parameter and will therefore not show in the user interface without entering advanced mode. Values in the range 0 to 255 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_36_1 and is of type INTEGER.
Factory Reset
The following option values may be configured, in addition to values in the range 0 to 255 -:
| Value | Description |
|---|---|
| 85 | restore factory setting |
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.
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-S521 supports 1 association group.
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 5 nodes.
| Command Class | Comment |
|---|---|
| COMMAND_CLASS_BASIC_V1 | |
| COMMAND_CLASS_SWITCH_BINARY_V1 | |
| COMMAND_CLASS_SWITCH_MULTILEVEL_V1 | |
| COMMAND_CLASS_SCENE_ACTIVATION_V1 | |
| COMMAND_CLASS_SCENE_ACTUATOR_CONF_V1 | |
| COMMAND_CLASS_METER_V3 | |
| COMMAND_CLASS_ASSOCIATION_GRP_INFO_V1 | |
| COMMAND_CLASS_DEVICE_RESET_LOCALLY_V1 | |
| COMMAND_CLASS_ZWAVEPLUS_INFO_V1 | |
| COMMAND_CLASS_CONFIGURATION_V1 | |
| COMMAND_CLASS_ALARM_V1 | |
| COMMAND_CLASS_MANUFACTURER_SPECIFIC_V1 | |
| COMMAND_CLASS_POWERLEVEL_V1 | |
| COMMAND_CLASS_FIRMWARE_UPDATE_MD_V1 | |
| COMMAND_CLASS_ASSOCIATION_V2 | |
| COMMAND_CLASS_VERSION_V2 |
Did you spot an error in the above definition or want to improve the content? You can contribute to the database here.