Silicon Laboratories Z-Wave 700 Betriebsanleitung

Instruction

How to Use Certified Apps in Z-Wave 700

Document No.:

INS14278

Version:

Description:

Written By:

AMUNKHAUS;JFR;AYURTTAS;COLSEN

Date:

2019-03-22

Reviewed By:

JFR;NOBRIOT;COLSEN;KEWAHID

Restrictions:

Approved by:

This document is the property of Silicon Labs. The data contained herein, in whole or in

part, may not be duplicated, used or disclosed outside the recipient for any purpose. This

restriction does not limit the recipient's right to use information contained in the data if it

is obtained from another source without restriction.

INS14278-4 How to Use Certified Apps in Z-Wave 700 2019-03-22

silabs.com | Building a more connected world.

Page 2 of 45

REVISION RECORD

Doc. Rev

Date

Pages affected

Brief description of changes

20181205

AMUNKHAUS

ALL

Initial release of document.

20180212

AMUNKHAUS

ALL

Reviewed for release.

20180226

AMUNKHAUS

ALL

Fixed certification issues.

20190318

JFR

5.1.1

5.2.3

5.6.4

5.6.1

5.4.4

5.2.3

5.4.1

5.1.2

5.2.4

5.3.1

Clarified reset to factory default.

Removed Association Group having ID 2 from Door Lock Key Pad.

Removed Trigger association group 3: Multilevel Switch Set from Wall Controller.

Removed Basic CC as supported from Wall Controller.

Updated button actions for Sensor PIR.

Updated association group description wrt. door lock configuration/operation and

user code.

Removed Security CC (S0) as supported from Sensor PIR.

Added SmartStart description including QR code readout.

Updated buttons interface description and added BTN3. User default code added.

Removed Switch Multilevel CC from root NIF.

INS14278-4 How to Use Certified Apps in Z-Wave 700 2019-03-22

silabs.com | Building a more connected world.

Page 3 of 45

Table of Contents

1 ABBREVIATIONS............................................................................................................................6

2 INTRODUCTION ............................................................................................................................6

2.1 Purpose..............................................................................................................................................6

2.2 Audience and Prerequisites...............................................................................................................6

3 SOFTWARE AND HARDWARE ........................................................................................................7

3.1 Hardware Needed .............................................................................................................................7

3.1.1 Main Development Board .......................................................................................................8

3.1.2 Z-Wave Development Radio Boards........................................................................................8

3.1.3 Recommendation on SAW filters ............................................................................................9

3.1.4 EXP Board ................................................................................................................................9

3.2 Software Needed.............................................................................................................................11

4 SDK AND FRAMEWORK INTRODUCTION .....................................................................................12

4.1 SDK 7.11 Overview ..........................................................................................................................12

4.2 Z-Wave Plus v2 Specification...........................................................................................................12

4.3 Z-wave Plus v2 Framework..............................................................................................................13

4.4 Libraries ...........................................................................................................................................14

4.5 Association Groups and Endpoints..................................................................................................14

4.6 Security............................................................................................................................................15

5 Z-WAVE PLUS V2 APPLICATIONS .................................................................................................16

5.1 Overview of Z-Wave certified Applications .....................................................................................16

5.1.1 General User Interface ..........................................................................................................18

5.1.2 SmartStart .............................................................................................................................19

5.2 Door Lock.........................................................................................................................................20

5.2.1 Supported Command Classes................................................................................................21

5.2.2 Basic Command Class Mapping.............................................................................................22

5.2.3 Association Groups................................................................................................................22

5.2.4 Usage of Buttons and LED Status ..........................................................................................23

5.2.5 Firmware Update ..................................................................................................................23

5.2.6 Z-Wave Certification..............................................................................................................23

5.3 Power Strip ......................................................................................................................................24

5.3.1 Supported Command Classes................................................................................................25

5.3.1.1 Supported Command Classes: Endpoint 1 .......................................................................25

5.3.1.2 Supported Command Classes: Endpoint 2 .......................................................................27

5.3.2 Basic Command Class mapping .............................................................................................28

5.3.3 Association Groups................................................................................................................28

5.3.4 Usage of Buttons and LED Status ..........................................................................................30

5.3.5 Firmware Update ..................................................................................................................31

5.3.6 Z-Wave Certification..............................................................................................................31

INS14278-4 How to Use Certified Apps in Z-Wave 700 2019-03-22

silabs.com | Building a more connected world.

Page 4 of 45

5.4 Sensor PIR........................................................................................................................................32

5.4.1 Supported Command Classes................................................................................................33

5.4.2 Basic Command Class Mapping.............................................................................................33

5.4.3 Association Groups................................................................................................................34

5.4.4 Usage of Buttons and LED Status ..........................................................................................35

5.4.5 Firmware Update ..................................................................................................................35

5.4.6 Z-Wave Certification..............................................................................................................35

5.5 Switch On/Off..................................................................................................................................36

5.5.1 Supported Command Classes................................................................................................37

5.5.2 Basic Command Class mapping .............................................................................................38

5.5.3 Association Groups................................................................................................................38

5.5.4 Usage of Buttons and LED Status ..........................................................................................39

5.5.5 Firmware Update ..................................................................................................................39

5.5.6 Z-Wave Certification..............................................................................................................39

5.6 Wall Controller ................................................................................................................................40

5.6.1 Supported Command Classes................................................................................................41

5.6.2 Basic Command Class mapping .............................................................................................42

5.6.3 Association Groups................................................................................................................43

5.6.4 Usage of buttons and LED Status ..........................................................................................43

5.6.5 Firmware update...................................................................................................................44

5.6.6 Z-Wave Certification..............................................................................................................44

REFERENCES.......................................................................................................................................45

INS14278-4 How to Use Certified Apps in Z-Wave 700 2019-03-22

silabs.com | Building a more connected world.

Page 5 of 45

Table of Figures

Figure 1: Content of the Z-Wave Development Kit ..............................................................................7

Figure 2: Main Development Board .......................................................................................................8

Figure 3: Z-Wave Development Radio Boards (Left: BRD4200A, Right: 4201A) ...........................8

Figure 4: Button Extension Adapter .......................................................................................................9

Figure 5: Simplicity Studio―IDE for Developing Z-Wave Devices..................................................11

Figure 6: Z-Wave Plus v2 Application Framework.............................................................................13

Figure 7. QR Code image and value. ..................................................................................................19

Figure 8. Wall Controller (node 5) example of Central Scene. ........................................................42

Table of Tables

Table 1. Functionality Covered by the Z-Wave Plus v2 Applications..............................................17

Table 2: General User Interface ...........................................................................................................18

Table 3. Door Lock Supported Command Classes ...........................................................................21

Table 4: Basic Command Class mapping for Door Lock ..................................................................22

Table 5: Association Groups Available in Door Lock.........................................................................22

Table 6. Door Lock Buttons Interface ..................................................................................................23

Table 7. Door Lock LED Status Interface............................................................................................23

Table 8. Power Strip Supported Command Classes .........................................................................25

Table 9: Power Strip, Endpoint 1, Supported Command Classes...................................................26

Table 10: Power Strip, Endpoint 2, Supported Command Classes.................................................27

Table 11: Basic Command Class mapping for Power Strip..............................................................28

Table 12: Association Groups Available in Power Strip: Root Device ............................................28

Table 13: Association Groups Available in Power Strip: Endpoint 1...............................................29

Table 14: Association Groups Available in Power Strip: Endpoint 2...............................................29

Table 15. Power Strip Buttons Interface..............................................................................................30

Table 16. Power Strip LED Status Interface .......................................................................................30

Table 17. Sensor PIR Supported Command Classes .......................................................................33

Table 18: Association Groups Available in Sensor PIR ....................................................................34

Table 19. Sensor PIR Buttons Interface..............................................................................................35

Table 20. Switch On/Off Supported Command Classes...................................................................37

Table 21: Basic Command Class Mapping for Switch On / Off .......................................................38

Table 22: Association Groups Available in Switch On / Off..............................................................38

Table 23. Switch On / Off Buttons Interface........................................................................................39

Table 24. Switch On / Off LED Status Interface.................................................................................39

Table 25. Wall Controller Supported Command Classes .................................................................41

Table 26: Association Groups Available in Wall Controller ..............................................................43

Table 27. Wall Controller Buttons Interface ........................................................................................44

INS14278-4 How to Use Certified Apps in Z-Wave 700 2019-03-22

silabs.com | Building a more connected world.

Page 6 of 45

1 ABBREVIATIONS

Abbreviation

Explanation

AGI

Association Group Information

AOS

Always on slave

BEA

Button Extension Adapter

FLiRS

Frequently Listening Routing Slave

IDE

Integrated Development Environment

LSS

Listening Sleeping Slave

RSS

Reporting Sleeping Slave

Security 0 Command Class

Security 2 Command Class

SDK

Software Development Kit

ZAF

Z-Wave Plus v2 Application Framework

2 INTRODUCTION

2.1 Purpose

The purpose of this document is to describe how to use the Z-Wave certified applications which comes

as part of the Z-Wave SDK 7.11.

2.2 Audience and Prerequisites

The audience is Z-Wave Developers.

It is assumed developers already have the development environment up and running, as per the

instruction " INS14280 Z-Wave 700 Getting Started for End Devices" [10].

INS14278-4 How to Use Certified Apps in Z-Wave 700 2019-03-22

silabs.com | Building a more connected world.

Page 7 of 45

3 SOFTWARE AND HARDWARE

This section will present the hardware that comes as part of the development kit and the needed

software to start developing Z-Wave devices. For a guide in how to setup and connect the hardware,

refer to [10].

3.1 Hardware Needed

The Z-Wave development kit contains the following:

WSTK Main Development Board, 2 pcs.

BRD4200A Radio Board with ZGM130S intended end device development, 2 pcs.

BRD8029A EXP Board, 2 pcs.

UZB7 Controller USB Dongle

Zniffer USB Dongle

Figure 1: Content of the Z-Wave Development Kit

INS14278-4 How to Use Certified Apps in Z-Wave 700 2019-03-22

silabs.com | Building a more connected world.

Page 8 of 45

3.1.1 Main Development Board

The Main Development Board connects to the PC using USB. It features a coin cell holder, supports

Advanced Energy Monitor for battery measurements and energy profiling, as well as expansion headers

for easy expansion. It has an on-board SEGGER J-Link for debugging, a low-power 128x128 pixel LCD,

user LEDs / pushbuttons, and breakout pads for attaching the Z-Wave development board.

Figure 2: Main Development Board

3.1.2 Z-Wave Development Radio Boards

Two Z-Wave Development Radio Boards targeted for end device development are included in the kit.

Another radio board targeted for controller development can be purchased as an add-on to the kit.

Figure 3: Z-Wave Development Radio Boards (Left: BRD4200A, Right: 4201A)

The possible options are:

BRD4200A Radio Board with ZGM130S used for end device development [included]

BRD4201A Radio Board with EFR32ZG14 used for controller development [add-on]

BRD4202A Radio Board with ZGM130S with no SAW filters used for end device

development [add-on]

INS14278-4 How to Use Certified Apps in Z-Wave 700 2019-03-22

silabs.com | Building a more connected world.

Page 9 of 45

While BRD4200A and BRD4202A are intended for end devices, it can also be used for Controller

development. The difference is the BRD4200A / BRD4202A comes as a SiP module, provides IO, and as

such has a higher cost.

The boards include World Wide SAW filter configuration, so the same development boards can be used

to test all regions.

3.1.3 Recommendation on SAW filters

For Z-Wave gateways (outside EU freq.) with LTE embedded, it is recommended to analyze the specific

need for a SAW filter in depth. Optionally, a SAW filter bank can be added and controlled via the SAW0

and SAW1 output pins for operation in different regions. This means:

No SAW

End-devices and gateways without LTE modem embedded no SAW filter is recommend.

Gateways on EU frequency with LTE modem embedded no SAW filter is recommend.

SAW recommended

Gateways with LTE embedded on U and H related frequencies using a SAW filter is recommend.

3.1.4 EXP Board

The EXP Board is an adapter to be connected to the EXP-header of the WSTK main board. The EXP

Board enables the platform to run the provided Z-Wave certified application by expanding the available

buttons and LEDs. The EXP Board offers the following features:

4 push buttons

1 slide switch

4 LEDs

Figure 4: Button Extension Adapter

LED0 on the expansion board is wired in parallel with LED0 on the mainboard (both will turn on/off at

the same time).

INS14278-4 How to Use Certified Apps in Z-Wave 700 2019-03-22

silabs.com | Building a more connected world.

Page 10 of 45

BTN0 and BTN1 on the expansion board are wired in parallel with PB0 and PB1 on the mainboard.

Andere Handbücher für Z-Wave 700

Inhaltsverzeichnis

Andere Silicon Laboratories Mikrocontroller Handbücher

Silicon Laboratories

Silicon Laboratories C8051F38 Series Bedienungsanleitung

Silicon Laboratories

Silicon Laboratories EFM32 EFM32GG11 Giant Gecko Series Bedienungsanleitung

Silicon Laboratories

Silicon Laboratories C8051T630-GM Bedienungsanleitung

Silicon Laboratories

Silicon Laboratories C8051T620 Bedienungsanleitung

Silicon Laboratories

Silicon Laboratories CP2400-DK Bedienungsanleitung

Silicon Laboratories

Silicon Laboratories C8051F41 Series Bedienungsanleitung

Silicon Laboratories

Silicon Laboratories EFM8SB1-SLSTK2010A Bedienungsanleitung

Silicon Laboratories

Silicon Laboratories EFR32xG21 Wireless Gecko Bedienungsanleitung

Silicon Laboratories

Silicon Laboratories C8051F30 series Bedienungsanleitung

Silicon Laboratories

Silicon Laboratories EZRadioPRO Bedienungsanleitung

Silicon Laboratories

Silicon Laboratories C8051F34-DK Series Bedienungsanleitung

Silicon Laboratories

Silicon Laboratories C8051F30 series Bedienungsanleitung

Silicon Laboratories

Silicon Laboratories C8051F120 Bedienungsanleitung

Silicon Laboratories

Silicon Laboratories EM34 Series Bedienungsanleitung

Silicon Laboratories

Silicon Laboratories C8051F02x-DK Bedienungsanleitung

Silicon Laboratories

Silicon Laboratories C8051F930 Bedienungsanleitung

Silicon Laboratories

Silicon Laboratories C8051F530A Bedienungsanleitung

Silicon Laboratories

Silicon Laboratories EFM32 Bedienungsanleitung

Silicon Laboratories

Silicon Laboratories C8051F93 Series Bedienungsanleitung

Silicon Laboratories

Silicon Laboratories EFM8 Series Bedienungsanleitung

Silicon Laboratories

Silicon Laboratories C8051F336 Bedienungsanleitung

Silicon Laboratories

Silicon Laboratories EFM8SB2 Bedienungsanleitung

Silicon Laboratories

Silicon Laboratories C8051F32 Series Bedienungsanleitung

Silicon Laboratories

Silicon Laboratories C8051F310DK-T Bedienungsanleitung

Beliebte Mikrocontroller Handbücher anderer Marken

AMS

AMS AS7261 Demo Kit Bedienungsanleitung

Novatek

Novatek NT6861 Bedienungsanleitung

Espressif Systems

Espressif Systems ESP8266 SDK Einrichtungshandbuch

Nuvoton

Nuvoton ISD61S00 ChipCorder Leitfaden

STMicrolectronics

STMicrolectronics ST7 Assembler Linker Bedienungsanleitung

Texas Instruments

Texas Instruments Chipcon CC2420DK Bedienungsanleitung

Lantronix

Lantronix Intrinsyc Open-Q 865XR SOM Bedienungsanleitung

NEC

NEC 78GK0S/K 1+ Series Montage- und Bedienungsanleitung

Mikroe

Mikroe SEMITECH N-PLC Click Montage- und Bedienungsanleitung

Intel

Intel Agilex Bedienungsanleitung

Cypress

Cypress CY4607 HX2VL Bedienungsanleitung

DIGITAL-LOGIC

DIGITAL-LOGIC MICROSPACE Bedienungsanleitung

Texas Instruments

Texas Instruments TMS320F2837 D Series Bedienungsanleitung

CYPRES

CYPRES CY14NVSRAMKIT-001 Bedienungsanleitung

Texas Instruments

Texas Instruments INA-DUAL-2AMP-EVM Bedienungsanleitung

Espressif Systems

Espressif Systems ESP8266EX Betriebsanleitung

Abov

Abov AC33M8128L Bedienungsanleitung

Laird

Laird BL654PA Bedienungsanleitung