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:

  • Device Reset Locally: triggered upon reset.

  • Binary Switch Report: Triggered when the switch changes state.

  • Notification: triggered by the endpoints

  • Indicator Report: Triggered when LED0 changes state.

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:

  • Binary Switch Report: Triggered when the switch changes state.

  • Notification: triggered by the endpoints

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:

  • Multilevel Switch Report: Triggered when the switch changes state.

  • Notification: triggered by the endpoints

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#

We are differentiating four different types of button presses. The following types are the same for the BTN0 and BTN1 on the WSTK board. The duration values can be configured under the config directory in app_button_press_config.h file in each generated application/project.

Please note external wakeup is not supported on button 1 in case of brd2603a and brd2603b.

Press Type

Duration

Short Press

0 - 400 ms

Medium Press

401 - 1500 ms

Long Press

1501 - 5000 ms

Very Long Press

Every press longer than Long Press

Button

Action

Description

RST

Press

Resets the firmware of an application (like losing power). All volatile memory will be cleared.

BTN0

Short Press

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:

  1. Notification from endpoint 1: Overload detected

  2. Notification from endpoint 1: No event

  3. Notification from endpoint 2: Overload detected

  4. Notification from endpoint 2: No event

One notification will be transmitted every 30 seconds.

Medium Press

Toggles the binary switch

BTN1

Short Press

Enter "learn mode" (sending node info frame) to add/remove the device.
Removing the device from a network will reset it.

Very Long Press

Perform a reset to factory default operation of the device, and a Device Reset Locally Notification Command is sent via Lifeline.

LED

Description for boards with RGB LED

Description for boards without RGB LED1

LED0

Blinks with 1 Hz when learn mode is active. Used for Indicator Command Class.

LED1

Endpoint 1 (switch on/off)

Endpoint 2 (dimmer, average of the three colors)

RGB

Endpoint 2 (dimmer)

-

1: Some boards do not have an RGB LED. On such boards, the command line interface can be used to monitor the binary switch endpoint and all the levels of the multilevel switch endpoint.

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.

get_led_state

-

Get the state of the LED1. Can be "on" or "off".
Only available on hardware with an RGB LED (otherwise, LED1 is assigned to the multilevel switch and its state can be queried with get_rgb_values).

get_rgb_values

-

Shows the current Red Green and Blue values. The range is 0-65535 for each component. In case the target does not have RGB LED it shows the LED intensity on a scale 0- 255.