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.

Configuration


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 Group configuration

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	BTN0	Y	Switch Multilevel CC
4	BTN2	Y	Basic Set Command
5	BTN2	Y	Switch Multilevel CC
6	BTN3	Y	Basic Set Command
7	BTN3	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 on Linux platform - zwave_soc_wall_controller

Application uses single character commands read from standard input.

Character	Description
1	KEY01 press
2	KEY01 hold
3	KEY01 release
4	KEY02 press
5	KEY02 hold
6	KEY02 release
7	KEY03 press
8	KEY03 hold
9	KEY03 release

User Interface on the DKNCZ20 board

Buttons

Button	Action	Description
BTN0	Press	Resets the chip.
BTN1	Press	Toggles learn mode.
BTN1	Hold (5sec)	Resets the application to factory settings.
BTN2	Press	Send button 1 pressed event notification for scene 1 group
	Hold (5sec)	Send button 1 hold event notification for scene 1 group
	Release (after 300 ms)	Send button 1 release event notification for scene 1 group

LEDs

LED	Behavior	Description
Green	Flashing	Learn mode is active.
Green	Off	Learn mode is inactive.

Trident IoT Z-Wave SDK