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

15 KiB
Raw Permalink Blame History

layout title
documentation MP21ZP - ZWave

{% include base.html %}

MP21ZP Mini Plug with Power Meter

This describes the Z-Wave device MP21ZP, manufactured by NIE Technology with the thing type UID of nietech_mp21zp_00_000.

The device is in the category of Power Outlet, defining Small devices to be plugged into a power socket in a wall which stick there.

MP21ZP product image

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

Z-Wave Plus Outlet Mini Plug with Power Meter(MP21ZP)

Indoor use in dry location

Power: 120V 60Hz

Loading: 10 Amp Max Resistive

Frequency: 908.42MHz

Temperature Range: 0°C~ 40°C / (32°F~104°F)

Features:

  1. Manual and Remote (Z-Wave) on/off control.
  2. Z-Wave controlled AC outlet for standard incandescent lighting, CFL/LEDs, fans or small appliances(1250W Resistive Max).
  3. Grounded 3-wire power connection for safety.
  4. Remembers and restores on/off status after power failure.
  5. Built-in Z-Wave Plus signal repeater to extend network range.
  6. S2 security and 700 Z-Wave chip for reliable wireless communication.
  7. Work with all certificated Z-Wave controllers

Locally Button Press function:

  1. press 1x: turn output ON or OFF
  2. quickly press 3x: inclusion or exclusion
  3. quickly press 5x: change Parameter 1
  4. quickly press 8x: change Parameter 4
  5. quickly press 10x: Reset KWH
  6. Factory reset: click Z-Wave button 2 twice quickly, then hold for at least 10 seconds.

Inclusion Information

Adding Device To Z-Wave Network:

Once the controller is ready to add your device, press the Manual/Program button on the smart plug 3 times quickly. The blue LED will blink quickly.

Auto-add mode: LED will blink within 30 seconds after first plugged in.

Exclusion Information

Removing Device To Z-Wave Network:

Once the controller is ready to remove your device, press the Manual/Program button on the smart plug 3 times quickly. The blue LED will blink quickly.

Auto-add mode: LED will blink within 30 seconds after first plugged in.

General Usage Information

Locally Button Press function:

  1. press 1x: turn output ON or OFF
  2. quickly press 3x: inclusion or exclusion
  3. quickly press 5x: change Parameter 1
  4. quickly press 8x: change Parameter 4
  5. quickly press 10x: Reset KWH
  6. Factory resetclick Z-Wave button 2 twice quickly, then hold for at least 10 seconds.

Channels

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

Channel Name Channel ID Channel Type Category Item Type
Switch switch_binary switch_binary Switch Switch
Electric meter (volts) meter_voltage meter_voltage Energy Number
Electric meter (amps) meter_current meter_current Energy Number
Electric meter (watts) meter_watts meter_watts Energy Number
Electric meter (kWh) meter_kwh meter_kwh Energy Number
Alarm (power) alarm_power alarm_power Energy Switch

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.

Electric meter (volts)

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.

Electric meter (amps)

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.

Electric meter (watts)

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.

Electric meter (kWh)

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.

Alarm (power)

Indicates if a power alarm is triggered.

The alarm_power channel is of type alarm_power and supports the Switch item and is in the Energy 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

Device Configuration

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

Param Name Description
1 LED Indicator LED Indicator Setup
2 Auto Turn-Off Timer Auto Turn-Off Timer Setup
3 Auto Turn-On Timer Auto Turn-On Timer Setup
4 Restores state after power failure Restores state after power failure Setup
5 Power Wattage(W) Report Power Wattage(W) Report Setup
6 Time Report Time Report Setup
7 Current(A) Report Current(A) Report Setup
8 Energy(KWH) Report Energy(KWH) Report Setup
9 Count Down Configuration Endpoint1 Count Down Configuration (Turn off the output by time
10 Auto Turn-ON Timer Endpoint1 Enable Auto Turn-ON Timer
11 Count Down Configuration Endpoint1 Count Down Configuration(Turn on the output by time
12 E2 Auto Turn-OFF Timer Endpoint2 Enable Auto Turn-OFF Timer
13 E2 Count Down Configuration Endpoint2 Count Down Configuration(Turn off the output by time
14 E2 Auto Turn-ON Timer Endpoint2 Enable Auto Turn-ON Timer
15 E2 Count Down Configuration Endpoint2 Count Down Configuration(Turn on the output by time
16 Manual Control Enable/Disable Manual Control
17 Status LED Configuration Status LED Configuration

Parameter 1: LED Indicator

LED Indicator Setup This parameter can access you to choose the led indicator to be on when the plug(light) is on/off, or LED indicator remains on/off all times The following option values may be configured, in addition to values in the range 0 to 3 -:

Value Description
0 LED is On when the switch is ON and LED is Off when the switch is OFF
1 LED is Off when switch is On and LED is ON when the switch is OFF
2 LED is always Off
3 LED is always On

The manufacturer defined default value is 0 (LED is On when the switch is ON and LED is Off when the switch is OFF).

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

Parameter 2: Auto Turn-Off Timer

Auto Turn-Off Timer Setup This parameter can access you to set a timer to make the switch turn off automatically after the switch turned on The following option values may be configured -:

Value Description
0 Disable

The manufacturer defined default value is 0 (Disable).

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

Parameter 3: Auto Turn-On Timer

Auto Turn-On Timer Setup This parameter can access you to set a timer to make the switch turn on automatically after the switch turned off. The following option values may be configured -:

Value Description
0 Disable

The manufacturer defined default value is 0 (Disable).

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

Parameter 4: Restores state after power failure

Restores state after power failure Setup This parameter can access you to set the switch to be on/off after power failure. The following option values may be configured, in addition to values in the range 0 to 2 -:

Value Description
0 State before power failure
1 The switch is off regardless of the state prior to power failure
2 The switch is on regardless of the state prior to power failure

The manufacturer defined default value is 0 (State before power failure).

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

Parameter 5: Power Wattage(W) Report

Power Wattage(W) Report Setup This parameter determines the minimum change in power wattage(W) that will result in sending new power report to the main controller. Values in the range 1 to 5 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 6: Time Report

Time Report Setup Electricity (A) Report Frequency (Timer) Values in the range 1 to 65535 may be set.

The manufacturer defined default value is 1.

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

Parameter 7: Current(A) Report

Current(A) Report Setup This parameter determines the minimum change in Current(A) that will result in sending new power report to the main controller Values in the range 1 to 10 may be set.

The manufacturer defined default value is 1.

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

Parameter 8: Energy(KWH) Report

Energy(KWH) Report Setup This parameter determines the minimum change in consumed energy that will result in sending new energy report to the main controller Values in the range 1 to 10 may be set.

The manufacturer defined default value is 1.

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

Parameter 9: Count Down Configuration

Endpoint1 Count Down Configuration (Turn off the output by time Endpoint1 Count Down Configuration (Turn off the output by time Values in the range 1 to 65535 may be set.

The manufacturer defined default value is 60.

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

Parameter 10: Auto Turn-ON Timer

Endpoint1 Enable Auto Turn-ON Timer Endpoint1 Enable Auto Turn-ON Timer Values in the range 0 to 1 may be set.

The manufacturer defined default value is 0.

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

Parameter 11: Count Down Configuration

Endpoint1 Count Down Configuration(Turn on the output by time Endpoint1 Count Down Configuration(Turn on the output by time Values in the range 1 to 65535 may be set.

The manufacturer defined default value is 60.

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

Parameter 12: E2 Auto Turn-OFF Timer

Endpoint2 Enable Auto Turn-OFF Timer Endpoint2 Enable Auto Turn-OFF Timer Values in the range 0 to 1 may be set.

The manufacturer defined default value is 0.

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

Parameter 13: E2 Count Down Configuration

Endpoint2 Count Down Configuration(Turn off the output by time Endpoint2 Count Down Configuration(Turn off the output by time Values in the range 1 to 65535 may be set.

The manufacturer defined default value is 60.

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

Parameter 14: E2 Auto Turn-ON Timer

Endpoint2 Enable Auto Turn-ON Timer Endpoint2 Enable Auto Turn-ON Timer 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: E2 Count Down Configuration

Endpoint2 Count Down Configuration(Turn on the output by time Endpoint2 Count Down Configuration(Turn on the output by time Values in the range 1 to 65535 may be set.

The manufacturer defined default value is 60.

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

Parameter 16: Manual Control

Enable/Disable Manual Control Enable/Disable Manual Control Values in the range 0 to 1 may be set.

The manufacturer defined default value is 1.

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

Parameter 17: Status LED Configuration

Status LED Configuration Status LED Configuration Values in the range 0 to 3 may be set.

The manufacturer defined default value is 1.

This parameter has the configuration ID config_17_1 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 MP21ZP 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 Association group_1 is default to associate with the primary controller (Gateway/Hub/Controller) for MP21ZP Status change report,

  1. MP21ZP will trigger AUTO report function if the Switch status had been changed.

Association group 1 supports 1 node.

Group 2: Basic set From Endpoint1

Send Basic Set ON / Off When the output of the MP21ZP Enpoint1 socket is changed, On (0xFF) or Off (0x00)or Overload, The MP21ZP will automatically send out a related basic set command. On (0xFF) or Off (0x00) to its associated group.

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
COMMAND_CLASS_METER_V3
COMMAND_CLASS_TRANSPORT_SERVICE_V1
COMMAND_CLASS_ASSOCIATION_GRP_INFO_V1
COMMAND_CLASS_DEVICE_RESET_LOCALLY_V1
COMMAND_CLASS_ZWAVEPLUS_INFO_V1
COMMAND_CLASS_SUPERVISION_V1
COMMAND_CLASS_CONFIGURATION_V1
COMMAND_CLASS_ALARM_V8
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_INDICATOR_V3
COMMAND_CLASS_MULTI_CHANNEL_ASSOCIATION_V3
COMMAND_CLASS_SECURITY_2_V1

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