Power Strip#
The Z-Wave certified Power Strip application shows an extension block implementation used to turn on several devices that are connected to power. Examples include lights, appliances, etc.
The Power Strip Z-Wave certified application implements several endpoints, which can be controlled individually.
The Power Strip application is based on:
Role Type | Always On End device (AOS) |
Supporting Device Type | Actuator |
Device Type | Binary Switch |
Generic Type | Switch Binary |
Specific Type | Not Used |
Requested security keys | S0, S2_UNAUTHENTICATED, and S2_AUTHENTICATED |
Endpoint 1 Device Type | Binary Switch |
Endpoint 1 Generic Type | Switch Binary |
Endpoint 1 Specific Type | Not Used |
Endpoint 2 Device Type | Multilevel Switch |
Endpoint 2 Generic Type | Switch Multilevel |
Endpoint 2 Specific Type | Not Used |
Power Strip supports the "push mode" only of Notification CC and transmits the following notification types/events:
Power Management
Overload detected (both endpoint 1 and 2)
Supported Command Classes#
The Power Strip application implements mandatory and some optional command classes. The table below lists the supported command classes, their version, and their required Security class, if any.
Command Class | Version | Required Security Class |
|---|---|---|
Association | 2 | Highest Granted Security Class |
Association Group Info | 3 | Highest Granted Security Class |
Basic | 2 | Highest Granted Security Class |
Device Reset Locally | 1 | Highest Granted Security Class |
Firmware Update Meta Data | 5 | Highest Granted Security Class |
Indicator | 3 | Highest Granted Security Class |
Manufacturer Specific | 2 | Highest Granted Security Class |
Multi-Channel | 4 | Highest Granted Security Class |
Multi-Channel Association | 3 | Highest Granted Security Class |
Notification | 8 | Highest Granted Security Class |
Powerlevel | 1 | Highest Granted Security Class |
Security 0 | 1 | None |
Security 2 | 1 | None |
Supervision | 1 | None |
Switch Binary | 2 | Highest Granted Security Class |
Transport Service | 2 | None |
Version | 3 | Highest Granted Security Class |
Z-Wave Plus Info | 2 | None |
Supported Command Classes: Endpoint 1#
Endpoint 1 implements the following command classes.
Command Class | Version | Required Security Class |
|---|---|---|
Association | 2 | Highest Granted Security Class |
Association Group Info | 3 | Highest Granted Security Class |
Basic | 2 | Highest Granted Security Class |
Multi-Channel Association | 3 | Highest Granted Security Class |
Notification | 8 | Highest Granted Security Class |
Security 0 | 1 | None |
Security 2 | 1 | None |
Supervision | 1 | None |
Switch Binary | 2 | Highest Granted Security Class |
Z-Wave Plus Info | 2 | None |
Supported Command Classes: Endpoint 2#
Endpoint 2 implements the following command classes.
Command Class | Version | Required Security Class |
|---|---|---|
Association | 2 | Highest Granted Security Class |
Association Group Info | 3 | Highest Granted Security Class |
Basic | 2 | Highest Granted Security Class |
Multi-Channel Association | 3 | Highest Granted Security Class |
Notification | 8 | Highest Granted Security Class |
Security 0 | 1 | None |
Security 2 | 1 | None |
Supervision | 1 | None |
Multilevel Switch | 4 | Highest Granted Security Class |
Z-Wave Plus Info | 2 | None |
Basic Command Class mapping#
The Basic Command Class is mapped according to the next table.
Endpoin | Basic Command | Mapped Command |
|---|---|---|
1 | Basic Set (Value) | Binary Switch Set (Value) |
1 | Basic Report (Current Value, Duration) | Binary Switch Report (Value, Duration) |
2 | Basic Set (Value) | Multilevel Switch Set (Value) |
2 | Basic Report (Current Value, Duration) | Multilevel Switch Report (Value, Duration) |
Association Groups#
The following three tables show the available association groups for Z-Wave and Z-Wave Long Range respectively. Backward compatibility for non-Multi Channel devices forces the root device AGI table to contain all the association groups mentioned in each of the endpoints AGI tables except from group 1, the Lifeline group.
Association groups for Root Device:#
ID | Name | Node Count | Description |
|---|---|---|---|
1 | Lifeline | X | Supports the following command classes:
|
2 | alarm EP 1 | Y | Mirror of endpoint 1, group 2 |
3 | alarm EP 2 | Y | Mirror of endpoint 2, group 2 |
X: For Z-Wave node count is equal to 5 and for Z-Wave Long Range it is 1.
Y: For Z-Wave node count is equal to 5 and for Z-Wave Long Range it is 0.
Association groups for Endpoint 1:#
ID | Name | Node Count | Description |
|---|---|---|---|
1 | Lifeline | 0 | Supports the following command classes:
|
2 | alarm EP 1 | Y | Notification report on overload. |
Y: For Z-Wave node count is equal to 5 and for Z-Wave Long Range it is 0.
Association groups for Endpoint 2:#
ID | Name | Node Count | Description |
|---|---|---|---|
1 | Lifeline | 0 | Supports the following command classes:
|
2 | alarm EP 2 | Y | Notification report on overload. |
Y: For Z-Wave node count is equal to 5 and for Z-Wave Long Range it is 0.
Usage of Buttons and LED Status
To use the sample app, the BRD8029A Button and LEDs Expansion Board must be used. BTN0-BTN3 and LED0-LED3 refer to the buttons and LEDs on the Expansion Board.
The following LEDs and buttons shown in the next table below are used.
Button | Action | Description | |
|---|---|---|---|
Radio Board 1 | Thunderboard 1 | ||
RST | Press | Resets the firmware of an application (like losing power). All volatile memory will be cleared. | |
BTN0 | Keypress | Switch on/off endpoint 1 | |
BTN1 | Press | Enter "learn mode" (sending node info frame) to add/remove the device. | |
Hold for at least 5 seconds and release | Perform a reset to factory default operation of the device, and a Device Reset Locally Notification Command is sent via Lifeline. | ||
BTN2 | Keypress | Dimming or switch on/off endpoint 2. Pressing push-button turns light on/off and holding push-button performs dimming of light (toggle up/down) | |
BTN3 | Keypress | Toggles the transmission of an "Overload detected" notification. The first transmission, when enabled, will always be the first in the following list. The notifications will be transmitted in the following pattern:
One notification will be transmitted every 30 seconds. |
LED | Description | |
|---|---|---|
Radio Board 1 | Thunderboard 1 | |
LED0 | Endpoint 1 (switch on/off) | |
LED1 | Blinks with 1 Hz when learn mode is active. Used for Indicator Command Class. | Endpoint 2 (dimmer) |
RGB | Endpoint 2 (dimmer) |
1: A Radio Board is plug-in board for the Wireless Pro Kit Mainboard. A Thunderboard is a stand-alone kit with a direct USB Type-C connection.
Firmware Update#
This section will describe backward compatibility when upgrading the Power Strip application from one SDK to a newer version.
CLI Support#
Please note the zw_cli_common component will modify the power consumption in case of sleeping applications. Like door lock keypad, sensor pir or multilevel sensor. CLI cannot work with sleep mode, after a reset the application stays awake until the user issues the enable_sleeping command. From that point CLI won't work and sleep mode will be reached until the next reset.
Command | Arguments | Description |
|---|---|---|
set_learn_mode | Toggling the learn mode functionality. In case the learn mode started, but inclusion does not happen,learn mode will automatically stop after about 30 seconds | |
factory_reset | - | Executing factory reset |
get_dsk | - | Printing out the generated DSK of the device |
get_region | - | Printing out the set region of the application |
toggle_endpoint | Number of your endpoint you want to toggle. Can be 1 or 2 | Toggling endpoint 1 or endpoint 2 |
dim_endpoint | New dimming level, it can be minimum 0 and maximum 99 | Setting the dimmin for endpoint 2 |
toggle_notification_sending | - | Toggles the transmission of an "Overload detected" notification. The first transmission, when enabled, will always be the first in the following list. |