Z-Wave Software Structure: Learn about Command Classes and

Reference Code
2020
Introduction

The Z-Wave protocol is an § Interoperable

interoperable, wireless, RF-based § Mesh Network
communications technology designed § International Standard
specifically for control, monitoring and § ITU-9959
status reading applications in residential
and light commercial environments. § Low Power
§ Frequently Listening Slave (FLiRS)
§ Sub 1 GHz
§ Fully Backward Compatible
§ Standardized Specifications
§ Command Classes

2
The Language of Z-Wave

§ Command Class Types § Types of Commands

§ Application § Set
§ Management § Get
§ Encapsulation § Report
§ Network
Report
Get
Set

*https://www.silabs.com/wireless/z-wave/specification

3
Examples of the different command classes

§ Application
§ Binary Switch Set
§ Door Lock
§ Thermostat Setpoint
§ Encapsulation
§ Supervision
§ Security S2
§ Management
§ Version
§ Battery
§ Network
§ Remove
§ Node Provisioning
*https://www.silabs.com/wireless/z-wave/specification

4
End Device Design and the Application Framework
Command Class Module
Application Framework
Product
Sample - Binary Switch
Specific
Application - Multilevel Switch
Code
- Central Scene
Command - Door Lock
Class - User Code
Utility Modules - Notification
Toolbox -…
Transport
Layer
Utility Toolbox
- OTA Handler Transport Layer
- GPIO & Key Driver - Transmission Handler
Z-Wave Protocol
- Event and Job Scheduler - Security Handler
- Battery Module - Supervision CC
- Application Timer Module - Multichannel CC
Z-Wave Module/SoC -… -…

5
The Sample Applications

Always On FLiRS Sleepy

Switch On/OFF Door Lock PIR Sensor

Power Strip D/W Sensor

Wall Switch

6
End Device Design from Sample Applicaitons

Product PIR Sensor

Sample
Specific
Application
Code

Application
Framework

Z-Wave Protocol

Z-Wave Module/SoC

7
Application Configuration

Configuration needed in 3 files

§ config_app.h
§ config_rf.h
§ main source file

8
Config_app.h

§ Device Role
§ Device Type

Device Class Window Covering Dimmer Switch

Generic Multilevel Device Multilevel Device
Specific Motor Control Specific Not Used

9
Config_app.h continued

§ Manufacturer Information
§ Association Information

10
Config_rf.h

§ Config_rf.h
§ RF Power

11
Main Source File

§ RF Frequency
§ Command Class List

12
Configuration Checklist

§ Role Type
§ Device Type
§ Manufacturer Information Application
§ Association Groups Framework
§ TX Power
Workflow
§ Command class list
§ RF region

13
Important Functions and Framework Flow

Important Main File Functions

§ ApplicationInit
§ Initialize the application.
Application
Initialization
§ ApplicationTask
§ Setup of events and IO.

§ AppStateManager Application Task

§ Core state machine of framework Transport Application
Command Handler
§ Transport_ApplicationCommandHandlerEx
§ Incoming RF frames
Application State
§ CommandClass functions, e.g. CC_Basic_Set_handler Manager
§ Application logic for various command classes
Command Class
Handler

14
Application State Manager- On/Off Switch

§ STATE_APP_STARTUP Reset
§ Init state

§ STATE_APP_IDLE
§ The ‘looping’ state, if no other states Init
§ STATE_APP_LEARN_MODE
§ Inclusion, SmartStart, etc. Hold S1
for 10s Press S1
§ STATE_APP_TRANSMIT_DATA Factory Idle Learn Mode
§ Usually used for sending data (e.g.
Reset
notifications) Press S0
§ STATE_APP_RESET
§ “DeviceResetLocally” Transmit Data
Hold S1
for 10s

15
Events: Learn Mode State

16
Events: Idle State

17
Switching States: Idle State

18
Power Manager and Energy Modes

Power Manager EM0 Active Radio available

§ Z-Wave Protocol controls the energy mode
EM1 Sleep MCU sleeping. Radio available
§ Will always go to sleep mode if possible
EM2 Deep Sleep RAM Retention

Power Locks EM3 Stop RAM Retention

§ lock the chip from entering sleep mode EM4 Shutoff MCU shut down. No RAM retention.
Wake up by Reset or Interrupt.

Power Lock Type

§ PM_TYPE_RADIO
don’t enter EM2/EM3/EM4
§ PM_TYPE_PERIPHERAL
don’t enter EM3/EM4

19
Z-Wave 700 Components
W I R E L E S S S TA R T E R K I T ZGM130S – SiP MODULE EFR32ZG14 – MODEM SoC

One kit for both end device and End-devices & gateways Gateways only
gateway development LGA64 9x9 mm SiP QFN32 5x5 mm SoC
Development Kit

The hardware in the kit

§ WSTK Main Development Board, 2 pcs

§ BRD4200A (BRD4202A) Radio Board with ZGM130S
§ BRD8029A EXP Board, 2 pcs
§ UZB7 Controller USB Dongle
§ Zniffer USB Dongle

21
Documentation Online

§ Z-Wave Support Website:

§ https://www.silabs.com/wireless/z-wave
§ Certification
§ Specifications
§ Learning Center

§ Simplicity Studio:
§ https://www.silabs.com/products/developme
nt-tools/software/simplicity-studio

§ ITU 9959:
§ file:///C:/Users/cahernan/Downloads/T-REC-
G.9959-201202-S!!PDF-E.pdf

22 Silicon Labs Confidential

Documentation in IDE

§ Demos
§ Preconfigured Sample Apps

§ Sample Applications
§ SDK Documentation

23 Silicon Labs Confidential

Thank you!
silabs.com