Wall Controller#

The Z-Wave certified Wall Controller application shows a push-button switch panel implementation to control devices in the Z-Wave network from push buttons (physical or virtual) on a device that is meant to be mounted on a wall. Examples include scene and zone controller and wall-mounted AV controllers.

The Wall controller application implements a wall-mounted switch that has three individually configurable buttons. Each button has support for on/off and dimming.

The Wall Controller application is based on:

Role Type

Always On End device (AOS)

Supporting Device Type

Actuator

Device Type

Central Scene

Generic Type

Wall Controller

Specific Type

Not Used

Requested security keys

S0, S2_UNAUTHENTICATED, and S2_AUTHENTICATED
The Wall Controller features do not depend on the security level.

Supported Command Classes#

Command Class

Version

Required Security Class

Association

2

Highest granted Security Class

Association Group Info

3

Highest granted Security Class

Central Scene

3

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 Association

3

Highest granted Security Class

Powerlevel

1

Highest granted Security Class

Security 0

1

None

Security 2

1

None

Supervision

1

None

Transport Service

2

None

Version

3

Highest granted Security Class

Z-Wave Plus Info

2

None

Use case:

The wall controller's three buttons are configurable to control nodes. Each button action is sent over the Lifeline as scene actions.

Basic Command Class mapping#

Basic Command Class is not mapped to any of the supported command classes.

Association Groups#

The following association groups are available for Z-Wave and Z-Wave Long Range respectively.

ID

Name

Node Count

Description

1

Lifeline

X

Supports the following command classes:

  • Device Reset Locally: triggered upon reset.

  • Central Scene: triggered by button press.

  • Indicator Report: Triggered when LED1 changes state.

2

BTN0

Y

Basic Set Command

3

Y

Switch Multilevel CC

4

BTN2

Y

Basic Set Command

5

Y

Switch Multilevel CC

6

BTN3

Y

Basic Set Command

7

Y

Switch Multilevel CC

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.

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

RST

Press

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

BTN0

Press

  • Lifeline with Central Scene Key Attribute "Key Pressed 1 Time"

  • Trigger association group 2: Basic Set

Hold start

  • Lifeline with Central Scene Key Attribute "Key Held Down"

  • Trigger association group 3: Multilevel Switch Start Level Change

Hold release

  • Lifeline with Central Scene Key Attribute "Key Released"

  • Trigger association group 3: Multilevel Switch Stop Level Change

BTN1

Press

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

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

Press

  • Lifeline with Central Scene Key Attribute "Key Pressed 1 Time"

  • Trigger association group 4: Basic Set

Hold start

  • Lifeline with Central Scene Key Attribute "Key Held Down"

  • Trigger association group 5: Multilevel Switch Start Level Change

Hold release

  • Lifeline with Central Scene Key Attribute "Key Released"

  • Trigger association group 5: Multilevel Switch Stop Level Change

BTN3

Press

  • Lifeline with Central Scene Key Attribute "Key Pressed 1 Time"

  • Trigger association group 6: Basic Set

Hold start

  • Lifeline with Central Scene Key Attribute "Key Held Down"

  • Trigger association group 7: Multilevel Switch Start Level Change

Hold release

  • Lifeline with Central Scene Key Attribute "Key Released"

  • Trigger association group 7: Multilevel Switch Stop Level Change

LED

Description

LED1

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

Firmware Update#

This section will describe backward compatibility when upgrading the Wall Controller application from one SDK to a newer version.

SDK 7.1x is the first SDK running on Z-Wave 700.