Multilevel Sensor#

Shows the ability to advertise numerical sensor readings, such as temperature, and humidity. Multiple parameters can be set for the minimum and maximum values.

The Multilevel Sensor application is based on:



Role Type	Reporting Sleeping End Device (RSS)
Supporting Device Type	Data reporting
Device Type	Notification sensor
Generic Type	Sensor Notification
Specific Type	Notification Sensor
Requested security keys	S2_UNAUTHENTICATED and S2_AUTHENTICATED

Multilevel Sensor transmits the following events:

Environment monitoring
- Temperature, and humidity measure

Supported Command Classes#

Multilevel Sensor 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
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 2	1	None
Supervision	1	None
Transport Service	2	None
Version	3	Highest granted Security Class
Wake Up	2	Highest granted Security Class
Z-Wave Plus Info	2	None
Configuration	4	Highest granted Security Class
Multilevel-Sensor	11	Highest granted Security Class

Basic Command Class Mapping#

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

Association Groups#

The following table shows the available association groups.


ID	Name	Node Count	Description
1	Lifeline	5	Supports the following command classes: Device Reset Locally: triggered upon reset. Indicator Report: Triggered when LED0 changes state. Configuring parameters: Minimum and maximum temperature levels can be set, errors can be detected if measured temperature is out of range Environmental measurements: Temperature and humidity values can be read, triggered from other Z-Wave devices

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	Sends Battery Report, temperature, and humidity data
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
LED0	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 MultilevelSensor application from one SDK to a newer version.

CLI Support#

In case CLI support is needed, please install zw_cli_common component to the project. Please note that the zw_cli_common component will significantly increase the power consumption of this application, as it must always be in an active state in order to receive CLI commands. The CLI cannot function during EM4 sleep mode. After a reset, the application stays awake for 10 seconds. During this timeframe, the sleeping disable CLI command can be issued to keep the application awake.

Available CLI commands#


Command	Arguments	Description
help	-	Printing all supported CLI commands and their 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
send_reports	-	Sending battery and sensor reports
sleeping	[string] "enable" or "disable"	Enable or disable sleeping. After pushing the reset button (or resetting with commander) the device will be awake for a given amount of time if the CLI component is added to the project. During this time the user can prevent the sleeping. For more information check the `zw_cli_sleeping` component.