SILICON LABS Z-Wave and Z-Wave Long Range 800 SDK 7.22.1 GA Instruction Manual

Z-Wave and Z-Wave Long Range 800 SDK 7.22.1 GA

“`html

Specifications:

• Product Name: Z-Wave and Z-Wave Long Range 800

• SDK Version: 7.22.1 GA

• Simplicity SDK Suite Version: 2024.6.1

• Release Date: July 24, 2024

• Interoperability: 100% with all Z-Wave ecosystem products

• Security: Z-Wave Security 2 (S2) framework for end-to-end
  encryption

• SmartStart Easy Installation: Simplifies setup with QR code
  scans

• Backwards Compatibility: Supports older Z-Wave devices

Product Usage Instructions:

Installation:

1. Ensure you have a compatible compiler like GCC version
   12.2.1.

2. Download and install the Simplicity Studio software if not
   already installed.

3. Follow the specific installation instructions provided in the
   user manual.

Setting Up Z-Wave Devices:

1. Scan the QR code on the device for SmartStart
   installation.

2. Follow the on-screen instructions for adding the device to your
   smart home network.

Troubleshooting:

1. If you encounter issues, refer to the troubleshooting section
   in the user manual.

2. Contact customer support for further assistance if problems
   persist.

FAQ:

Q: How do I ensure my Z-Wave devices are secure?

A: Z-Wave Security 2 (S2) framework provides end-to-end
encryption for secure communication.

Q: Can I use older Z-Wave devices with Z-Wave Long Range

800?

A: Yes, Z-Wave certification mandates backward-compatibility,
allowing older devices to work with newer technologies.

Q: What compilers are compatible with Z-Wave SDK?

A: GCC version 12.2.1 is compatible and provided with Simplicity
Studio.

“`

Z-Wave and Z-Wave Long Range 800 SDK 7.22.1 GA
Simplicity SDK Suite 2024.6.1 July 24, 2024

Z-Wave and Z-Wave Long Range 800 is designed to meet the demands of the future smart home, where increasing needs for more sensors and battery-operated devices require both long range and low power. Context-aware environments are the next evolution in the smart home market, and they require technologies that have been optimized specifically for these applications.
100% Interoperable: Every product in the Z-Wave ecosystem works with every other product, regardless of type, brand, manufacturer or version. No other smart home/IoT protocol can make this claim.
Best-In-Class Security: Z-Wave’s Security 2 (S2) framework provides end-to-end encryption and the most advanced security for smart home devices and controllers. Homes with S2 Z-Wave devices are virtually un-hackable.
SmartStart Easy Installation: SmartStart radically simplifies the installation of smart devices by using QR code scans for uniform, trouble-free setup. Devices and systems can be pre-configured dramatically easing deployments.
Backwards-Compatible: Z-Wave certification mandates backward-compatibility. The first Z-Wave devices on the market, more than ten years old, still perform as intended in networks with the latest Z-Wave technologies.
For more information about the certification status of Z-Wave and Z-Wave Long Range 800 SDK v7.22.1.0 GA, see section 10 Product Life Cycle and Certification.
These release notes cover SDK version(s):
7.22.1 GA released July 24, 2024 7.22.0 GA released June 5, 2024

KEY FEATURES
· 7.22.x and future updates support the 800 Series platform
· 700 Series platform will continue to be supported through the upcoming 7.21.x releases
· Adding additional information on the reset reason in the FUNC_ID_SERIAL_API_STARTED payload

Compatibility and Use Notices
For more information about security updates and notices, see the Security chapter of the Platform Release notes installed with this SDK or on the Silicon Labs Release Notes page. Silicon Labs also strongly recommends that you subscribe to Security Advisories for up-to-date information. For instructions, or if you are new to the Z-Wave 800 SDK, see section 9 Using This Release.
Compatible Compilers:
GCC (The GNU Compiler Collection) version 12.2.1, provided with Simplicity Studio.

silabs.com | Building a more connected world.

Copyright © 2024 by Silicon Laboratories

Z-Wave 7.22.1

Contents
Contents
1 Supported Radio Boards ……………………………………………………………………………………………………………………………………………….. 5 2 SDK Changes………………………………………………………………………………………………………………………………………………………………. 6 3 Z-Wave Protocol…………………………………………………………………………………………………………………………………………………………… 7
3.1 New Items…………………………………………………………………………………………………………………………………………………………….. 7 3.2 Improvements……………………………………………………………………………………………………………………………………………………….. 7 3.3 Fixed Issues …………………………………………………………………………………………………………………………………………………………. 7 3.4 Known Issues in the Current Release ………………………………………………………………………………………………………………………. 8 3.5 Deprecated Items ………………………………………………………………………………………………………………………………………………….. 8 3.6 Removed Items …………………………………………………………………………………………………………………………………………………….. 8 4 Z-Wave Plus V2 Application Framework ………………………………………………………………………………………………………………………….. 9 4.1 New Items…………………………………………………………………………………………………………………………………………………………….. 9 4.2 Improvements……………………………………………………………………………………………………………………………………………………….. 9 4.3 Fixed Issues …………………………………………………………………………………………………………………………………………………………. 9 4.4 Known Issues in the Current Release ………………………………………………………………………………………………………………………. 9 4.5 Deprecated Items ………………………………………………………………………………………………………………………………………………….. 9 4.6 Removed Items …………………………………………………………………………………………………………………………………………………… 10 5 Sample Applications ……………………………………………………………………………………………………………………………………………………. 11 5.1 Door Lock Key Pad………………………………………………………………………………………………………………………………………………. 11
5.1.1 New Items……………………………………………………………………………………………………………………………………………………. 11 5.1.2 Improvements………………………………………………………………………………………………………………………………………………. 11 5.1.3 Fixed Issues ………………………………………………………………………………………………………………………………………………… 11 5.1.4 Known Issues in the Current Release ……………………………………………………………………………………………………………… 11 5.1.5 Deprecated Items …………………………………………………………………………………………………………………………………………. 11 5.1.6 Removed Items ……………………………………………………………………………………………………………………………………………. 11 5.2 Door Lock Key Pad with U3C Beta…………………………………………………………………………………………………………………………. 12 5.2.1 New Items……………………………………………………………………………………………………………………………………………………. 12 5.2.2 Improvements………………………………………………………………………………………………………………………………………………. 12 5.2.3 Fixed Issues ………………………………………………………………………………………………………………………………………………… 12 5.2.4 Known Issues in the Current Release ……………………………………………………………………………………………………………… 12 5.2.5 Deprecated Items …………………………………………………………………………………………………………………………………………. 12 5.2.6 Removed Items ……………………………………………………………………………………………………………………………………………. 12 5.3 Power Strip …………………………………………………………………………………………………………………………………………………………. 12 5.3.1 New Items……………………………………………………………………………………………………………………………………………………. 12 5.3.2 Improvements………………………………………………………………………………………………………………………………………………. 12 5.3.3 Fixed Issues ………………………………………………………………………………………………………………………………………………… 13 5.3.4 Known Issues in the Current Release ……………………………………………………………………………………………………………… 13

silabs.com | Building a more connected world.

Z-Wave 7.22.1 | 2

Contents
5.3.5 Deprecated Items …………………………………………………………………………………………………………………………………………. 13 5.3.6 Removed Items ……………………………………………………………………………………………………………………………………………. 13 5.4 Sensor PIR …………………………………………………………………………………………………………………………………………………………. 13 5.4.1 New Items……………………………………………………………………………………………………………………………………………………. 13 5.4.2 Improvements………………………………………………………………………………………………………………………………………………. 13 5.4.3 Fixed Issues ………………………………………………………………………………………………………………………………………………… 13 5.4.4 Known Issues in the Current Release ……………………………………………………………………………………………………………… 13 5.4.5 Deprecated Items …………………………………………………………………………………………………………………………………………. 14 5.4.6 Removed Items ……………………………………………………………………………………………………………………………………………. 14 5.5 Switch On/Off ……………………………………………………………………………………………………………………………………………………… 14 5.5.1 New Items……………………………………………………………………………………………………………………………………………………. 14 5.5.2 Improvements………………………………………………………………………………………………………………………………………………. 14 5.5.3 Fixed Issues ………………………………………………………………………………………………………………………………………………… 14 5.5.4 Known Issues in the Current Release ……………………………………………………………………………………………………………… 14 5.5.5 Deprecated Items …………………………………………………………………………………………………………………………………………. 15 5.5.6 Removed Items ……………………………………………………………………………………………………………………………………………. 15 5.6 Wall Controller …………………………………………………………………………………………………………………………………………………….. 15 5.6.1 New Items……………………………………………………………………………………………………………………………………………………. 15 5.6.2 Improvements………………………………………………………………………………………………………………………………………………. 15 5.6.3 Fixed Issues ………………………………………………………………………………………………………………………………………………… 15 5.6.4 Known Issues in the Current Release ……………………………………………………………………………………………………………… 15 5.6.5 Deprecated Items …………………………………………………………………………………………………………………………………………. 15 5.6.6 Removed Items ……………………………………………………………………………………………………………………………………………. 15 5.7 Multilevel Sensor …………………………………………………………………………………………………………………………………………………. 15 5.7.1 New Items……………………………………………………………………………………………………………………………………………………. 15 5.7.2 Improvements………………………………………………………………………………………………………………………………………………. 15 5.7.3 Fixed Issues ………………………………………………………………………………………………………………………………………………… 15 5.7.4 Known Issues in the Current Release ……………………………………………………………………………………………………………… 15 5.7.5 Deprecated Items …………………………………………………………………………………………………………………………………………. 16 5.7.6 Removed Items ……………………………………………………………………………………………………………………………………………. 16 5.8 LED Bulb ……………………………………………………………………………………………………………………………………………………………. 16 5.8.1 New Items……………………………………………………………………………………………………………………………………………………. 16 5.8.2 Improvements………………………………………………………………………………………………………………………………………………. 16 5.8.3 Fixed Issues ………………………………………………………………………………………………………………………………………………… 16 5.8.4 Known Issues in the Current Release ……………………………………………………………………………………………………………… 16 5.8.5 Deprecated Items …………………………………………………………………………………………………………………………………………. 16 5.8.6 Removed Items ……………………………………………………………………………………………………………………………………………. 16

silabs.com | Building a more connected world.

Z-Wave 7.22.1 | 3

Contents 6 Serial API Applications ………………………………………………………………………………………………………………………………………………… 17
6.1 Serial API Controller …………………………………………………………………………………………………………………………………………….. 17 6.1.1 New Items……………………………………………………………………………………………………………………………………………………. 17 6.1.2 Improvements………………………………………………………………………………………………………………………………………………. 17 6.1.3 Fixed Issues ………………………………………………………………………………………………………………………………………………… 17 6.1.4 Known Issues in the Current Release ……………………………………………………………………………………………………………… 17 6.1.5 Deprecated Items …………………………………………………………………………………………………………………………………………. 17 6.1.6 Removed Items ……………………………………………………………………………………………………………………………………………. 17
7 Important Changes ……………………………………………………………………………………………………………………………………………………… 18 8 Open Source Software ………………………………………………………………………………………………………………………………………………… 19 9 Using This Release …………………………………………………………………………………………………………………………………………………….. 20
9.1 Installation and Use ……………………………………………………………………………………………………………………………………………… 20 9.2 Security Information……………………………………………………………………………………………………………………………………………… 20 9.3 Support ………………………………………………………………………………………………………………………………………………………………. 21 10 Product Life Cycle and Certification……………………………………………………………………………………………………………………………. 22

silabs.com | Building a more connected world.

Z-Wave 7.22.1 | 4

Supported Radio Boards
1 Supported Radio Boards
This section describes the radio boards supported by the certified and pre- certified applications for the 800 Series, respectively. Table 1-1. Supported Radio Boards

Series 800 800 800 800 800 800 800 800 800 800 800 800 800

Radio Board
BRD2603A

Description ZGM230SB: SiP

BRD2705A EFR32ZG28B: SoC

BRD4204A EFR32ZG23A: SoC

BRD4204B EFR32ZG23A: SoC

BRD4204C EFR32ZG23B: SoC

BRD4204D EFR32ZG23B: SoC

BRD4205A ZGM230SA: SiP

BRD4205B ZGM230SB: SiP

BRD4210A EFR32ZG23B: SoC

BRD4400B EFR32ZG28B: SoC

BRD4400C EFR32ZG28B: SoC

BRD4401B EFR32ZG28B: SoC

BRD4401C EFR32ZG28B: SoC

Z-Wave Long Range yes yes yes yes yes yes yes yes yes yes yes yes yes

Tx Power 14 dBm 14 dBm 14 dBm 14 dBm 14 dBm 14 dBm 14 dBm 14 dBm 20 dBm 14 dBm 14 dBm 20 dBm 20 dBm

Secure Vault High High Mid Mid High High Mid High High High High High High

The applications in the above table need a radio board in combination with BRD4002A ­ Wireless Starter Kit Mainboard (WSTK) and BRD8029A ­ Buttons and LEDs Expansion Board. Notice that BRD4002A is compatible with the old BRD4001A mainboard that is going to be deprecated. The Serial APIs in the above table only need a radio board and a BRD4002A ­ Wireless Starter Kit Mainboard (WSTK). Refer to INS14278: How to Use Certified Apps and INS14816: How to Use Pre-Certified Apps, for details.

ZW-LR indicates that the radio board supports both Z-Wave and Z-Wave Long Range. 14/20 dBm indicates the transmit power of the radio board. Secure Vault is an industry-leading suite of state-of-the-art security features that address escalating Internet of Things (IoT) threats.

Table 1-2. Radio Boards versus OPNs.

Series 800 800 800 800 800 800 800 800 800 800 800 800 800

Radio Board BRD2603A BRD2705A BRD4204A BRD4204B BRD4204C BRD4204D BRD4205A BRD4205B BRD4210A BRD2603A BRD4400C BRD4401B BRD4401C

OPN Description ZGM230SB27HGN3 EFR32ZG28B312F1024IM48-A EFR32ZG23A010F512GM48 EFR32ZG23A010F512GM48 EFR32ZG23B010F512IM48 EFR32ZG23B010F512IM48 ZGM230SA27HNN0 ZGM230SB27HGN2 EFR32ZG23B020F512IM48 ZGM230SB27HGN3 EFR32ZG28B312F1024IM68-A EFR32ZG28B322F1024IM68-A EFR32ZG28B322F1024IM68-A

The table above shows the Radio Boards and OPN relation. This table can be used to clarify the compatibility of the prebuilt binaries offered in the Simplicity SDK. The prebuilt binaries are built targeting boards and not OPNs. More OPNs are available than the ones listed above. For those OPNs the prebuilt binaries will not work. The desired application must be built targeting the specific OPN instead.

silabs.com | Building a more connected world.

Z-Wave 7.22.1 | 5

SDK Changes
2 SDK Changes
Simplicity SDK is an embedded software development platform for building IoT products based on our Series 2 and Series 3 wireless and MCU devices. It integrates wireless protocol stacks, middleware, peripheral drivers, a bootloader, and application examples ­ a solid framework for building power- optimized and secure IoT devices.
The Simplicity SDK offers powerful features such as ultra-low power consumption, strong network reliability, support for a large number of nodes, and abstraction of complex requirements like multiprotocol and pre- certification. Additionally, Silicon Labs provides over-the-air (OTA) software and security updates to remotely update devices, minimize maintenance costs, and enhance the enduser product experience.
Simplicity SDK is a follow-on from our popular Gecko SDK, which will continue to be available providing long-term support for our Series 0 and Series 1 devices. For additional information on the Series 0 and Series 1 devices please reference: Series 0 and Series 1 EFM32/EZR32/EFR32 device (silabs.com).

silabs.com | Building a more connected world.

Z-Wave 7.22.1 | 6

Z-Wave Protocol
3 Z-Wave Protocol
Be aware that 800 products based on SDK v7.17.x do not support upgrade of Secure Element firmware over the air (OTA). However, a migration path exists to upgrade both main bootloader and Secure Element firmware to enable support of this feature. See INS14895: Instruction for How to Use Tiny App regarding the upgrade path. The 800-based SDK v7.18.x supports upgrade of Secure Element firmware over the air (OTA).
The 8 kB reduction of the Z-Wave protocol NVM3 file system has an impact when making OTA firmware update on 800-based applications deployed on version 7.17.2 and earlier. To make an OTA firmware update from 7.17.2 to 7.18.1/2 requires that 7.18.1/2 is modified to keep the same NVM3 protocol size as 7.17.2. This can be configured by the define NVM3_DEFAULT_NVM_SIZE when building 7.18.1/2.
Note that due to the introduction of Secure Key Storage on the 800 series, having externally supplied key pairs is no longer supported. To ensure that security is not compromised, keys are generated internally on first boot and the private key kept only in secure storage. The public key and the QR code can be read out in production.

3.1 New Items
Added in release 7.22.1 GA · Adding additional information on the reset reason in the FUNC_ID_SERIAL_API_STARTED payload.

3.2 Improvements

Improved in release 7.22.0 GA

ID # 1246332 1271456 1242395
1196450

Description
There is now a single ZPAL library per device family.
Merged radio board RF configuration files (cf. zw_config_rf.h).
ZAF_BUILD_NO, SDKVERSION[MAJOR|MINOR|PATCH], ZAFVERSION[MAJOR|MINOR|PATCH] are no longer available in Applications. They have been replaced by several accessor functions defined in “ZAF_version.h”.
zpal_reset_reason_t replaces EResetReason_t enum.

3.3 Fixed Issues

Fixed in release 7.22.1 GA

ID # 1321606
1325749 1325746 1302749
1313883

Description Fixed an issue causing a controller to be locked in a constant beaming pattern. The behavior was caused by an incorrect configuration entered in the controller NVM. Fix prevents a self-lock between the ZAF application queue and the transport queue under heavy traffic load.
Fixed a condition where an end device would soft-reset when surrounded by a crowded RF environment.
Fixed an issue where the controller configured in Z-Wave Long-Range mode can enter a state where the CRCs associated with TX packets are erroneous. The issue is triggered in noisy environments, including FLiRS devices. Fixed an issue where the controller was not reporting EU_LR as a Long-Range region.

Fixed in release 7.22.0 GA

ID # 1062482 1266899 1271456
1273430 1289422 1238611

Description An issue was fixed that affected the OTA, where it would get stuck when a Timer interrupt was triggered. Fixed a controller migration issue impacting the migration process from 7.17 to newer NCP Serial API Controller. The BRD4401C radio board (EFR32ZG28 + 20 dBm output power) was misconfigured resulting in a low TX output power. This issue has been addressed. Fixed high priority packet management impacting Network Wide Inclusion and Exclusion. Fixed an issue causing a reset when polling the end device with a high frequency. TX queue refactoring addressing race conditions impacting the controller stability.

silabs.com | Building a more connected world.

Z-Wave 7.22.1 | 7

1285197

Z-Wave Protocol
Rarely, the controller hit a state that led to an unmanaged state (RAIL_EVENT_RX_FIFO_OVERFLOW). The controller now triggers a soft-reset.

3.4 Known Issues in the Current Release
Issues in bold were added since the previous release. If you have missed a release, recent release notes are available on Silicon Labs Release Notes page.

ID # 1227385 1247775
1300414 1295158 753756

Description
While the controller stability has been greatly improved in Z-Wave Classic, the workaround implementation is still recommended on the host side.
The RTOS tick can stop when the application requires frequent interruptions. The RTOS tick is then not incremented and stops the ZWave stack and other tasks.

Workaround This low occurrence issue can be mitigated by the host. When the controller is locked replying with the status, TRANSMIT_COMPLETE_FAIL, the host should reset the controller.
In the sli_schedule_wakeup_timer_expire_handler() function, replace
/ Increment the RTOS tick. / while ((current_tick_count – last_update_lftick) > lfticks_per_os_ticks) {
sched |= xTaskIncrementTick(); last_update_lftick+= lfticks_per_os_ticks; }

By

/ Increment the RTOS tick. / while ((current_tick_count – last_update_lftick) >= lfticks_per_os_ticks) {
sched |= xTaskIncrementTick(); last_update_lftick+= lfticks_per_os_ticks; }

End-Device acknowledges packet after exclusion.
The emulated end-device inclusion fails when used with the CTT agent.
Network Wide Inclusion (NWI) of 500-based apps doesn’t work through 700/800 repeaters.

No workaround.
It is recommended testers use another version of the emulated end-device. NWI works at second attempt.

3.5 Deprecated Items
As of the 7.22.0 stack release, the 700 platform is not supported by the Simplicity SDK. The 700 platform will be maintained through the 7.21.x release stream.

3.6 Removed Items
Removed in release 7.22.0 GA None.

silabs.com | Building a more connected world.

Z-Wave 7.22.1 | 8

4 Z-Wave Plus V2 Application Framework

Z-Wave Plus V2 Application Framework

4.1 New Items
Added User Credential Command Class beta implementation. Please note that more updates are expected in this command class specification in the upcoming 2024A Z-Wave specification, and this early implementation does not implement all of these changes. The command class will be adjusted to the 2024A specs in the future patch releases.
New variant of the Door Lock Key Pad sample application is added: “Door Lock Key Pad with U3C Beta”, which supports the User Credential Command Class.
CLI support is added for the sample apps. In case of FL and NL applications, the CLI is disabled by default because it prevents the apps from entering sleep mode. The instructions to enable the CLI for these sleeping apps can be found in the apps’ readme files.

4.2 Improvements
For a detailed description of application development using the Z-Wave Plus V2 Framework, refer to INS14259: Z-Wave Plus V2 Application Framework GSDK.
A porting guide is also available for customers who want to migrate to the 800 platform. The guide contains a detailed example of how to port a non- component/700-based Switch On/Off App (7.16.3) to a component/800-based Switch On/Off App (7.17.0). See APL14836: Application Note for Porting Z-Wave Appl. SW from 700 to 800 hardware.

4.3 Fixed Issues
Fixed in release 7.22.1 GA

ID # 1301405
1304174

Description
Z-Wave Version Config SLC component’s input fields were set to 1.0.0 by default, but 0 is outside of the allowed range. The version was not set properly in zw_version_config.h in the case of 0 input fields.
Quality level of Z-Wave bootloader demos was missing in Simplicity Studio.

Fixed in release 7.22.0 GA

ID # 1243767

Description ZG28 OTA and OTW demo bootloaders are missing in Simplicity Studio.

4.4 Known Issues in the Current Release
Issues in bold were added since the previous release. If you have missed a release, recent release notes are available on the Silicon Labs Release Notes page

ID # 369430
1172849 1257690

Description
All S2 multicast frames are sent using verified delivery S2_TXOPTION_VERIFY_DELIVERY whether or not a response is expected.
On series 800, sleep will no longer take advantage of EM1P current savings.
sl_storage_config.h does not handle custom OTA slot size.

Workaround Change source code depending on the frame sent.
Currently not available.
Currently not available.

4.5 Deprecated Items
The known issue with the 1080416 ID has been deprecated by the removal of the Assert component.

silabs.com | Building a more connected world.

Z-Wave 7.22.1 | 9

4.6 Removed Items
Removed in release 7.22.0. GA None.

Z-Wave Plus V2 Application Framework

silabs.com | Building a more connected world.

Z-Wave 7.22.1 | 10

Sample Applications
5 Sample Applications
The Door Lock Key Pad, Power Strip, Sensor PIR and Wall Controller applications on 7.22.0 SDK version have been officially certified based on the approved 2023B Z-Wave Specification test suite. The 7.22.0 Sensor PIR sample application contains a CTT issue; the workaround is described for the 1322043 issue.
The sample apps based on 7.22.1 SDK version have been self-certified by Silicon Labs based on the approved 2023B Z-Wave Specification test suite without any issues.
In 7.21.1 SDK the Serial API End Device demo firmware is added for BRD2603A and BRD2705A boards.

5.1 Door Lock Key Pad

5.1.1 New Items None.

5.1.2 Improvements None.

5.1.3 Fixed Issues

Fixed in release 7.22.1 GA

ID # 1303548 1303546

Description Fixed an issue where the set_new_user_code CLI command took only the first 4 digits of the pin code. Fixed an issue where the enter_user_code CLI command did not open the door.

5.1.4 Known Issues in the Current Release

ID # 1245554 1327637

Description DoorLock app does not work with UserID over 163. Doorlock app compile error with CLI component

Workaround
Currently not available.
In the file app_cli.c the user_code_buffer array’s size is defined as char wrongly. It must be changed to uint8_to eliminate the build error. From static char user_code_buffer[USERCODE_MAX_LEN]; to static uint8_t user_code_buffer[USERCODE_MAX_LEN];

5.1.5 Deprecated Items None.
5.1.6 Removed Items None.

silabs.com | Building a more connected world.

Z-Wave 7.22.1 | 11

Sample Applications
5.2 Door Lock Key Pad with U3C Beta
This is a new variant of the Door Lock Key Pad sample application which supports the User Credential Command Class, and is a Beta version. Because it has not been self-certified yet, the application contains known issues and will be adjusted according to changes expected in the 2024A Z-Wave specification.

5.2.1 New Items None.

5.2.2 Improvements None.

5.2.3 Fixed Issues

Fixed in release 7.22.1 GA

ID # 1297891 1297667 1297614 1297611 1297370 1297352 1297175 1296879 1296863 1296859 1296854

Description User Credential Association Reports only arrived in case of a successful Credential Association. Credential Set Error contained wrong data. User Credentials not deleted after user deletion. Next Credential value did not keep ascending order. Multiple Credential delete was not working. Pin code should only store numbers instead of any character. Credential max length was wrong in Credential Capabilities Report. User deletion did not guarantee deletion of all associated Credentials. Unsupported User Types could be added. USER_NOTIFICATION_REPORT commands were missing. USER_SET_ERROR_REPORT commands were missing.

5.2.4 Known Issues in the Current Release

ID # 1297831

Description Credential Learn not working with BTN2.

Workaround Currently not available.

5.2.5 Deprecated Items None.
5.2.6 Removed Items None.

5.3 Power Strip

5.3.1 New Items None.
5.3.2 Improvements None.

silabs.com | Building a more connected world.

Z-Wave 7.22.1 | 12

5.3.3 Fixed Issues

Fixed in release 7.22.1 GA

ID # 1303550

Description dim_endpoint 100 CLI command did not work.

Sample Applications

5.3.4 Known Issues in the Current Release None.
5.3.5 Deprecated Items None.
5.3.6 Removed Items None.

5.4 Sensor PIR

5.4.1 New Items None.

5.4.2 Improvements None.

5.4.3 Fixed Issues

Fixed in release 7.22.1 GA

ID # 1274235
1231755 1087508

Description
Sensor PIR enabling User Task ended up in Hard Fault. This Enabled the User Task in Sensor PIR sample app (by setting the CREATE_USER_TASK macro from 0 to 1 in app.c), leading to Hard Fault.
Sensor PIR On to Off movement alarm notification was missing.
Notification CC status value changed by injected SET command before S2 bootstrapping.

5.4.4 Known Issues in the Current Release

ID # 1256505

Description
Sensor PIR does not wake up on BTN0 and BTN1 button pressing on an expansion board using BRD4400C and BRD4401C radio boards due to these GPIOs not supporting wakeup from EM4.

Workaround
Remap the buttons to GPIOs that support wakeup from EM4.

5.4.4.1 Known Issues in release 7.22.0 GA

ID # 1322043

Description
First Lifeline report is missing in SensorPIR, causing failure in CTT Test case CCM_AssociationCmdClass_Rev01 CTT.

Workaround
Find the fix for the issue beneath this table.

silabs.com | Building a more connected world.

Z-Wave 7.22.1 | 13

Sample Applications Fix for the 1322043 known issue: In the file app.c in function zaf_event_distributor_app_event_manager CC_Basic_Set_tx and CC_Notification_TriggerAndTransmit functions are called in the wrong order. Also, CC_Notification_TriggerAndTransmit is called with wrong parameters in app.c. This can cause a missing notification in case of PIR event simulation. It can be fixed in three steps. Step 1. Change the CC_Notification_TriggerAndTransmit function input parameters to the following in zaf_event_distributor_app_event_manager function: (void) CC_Notification_TriggerAndTransmit(0, NOTIFICATION_EVENT_HOME_SECURITY_MOTION_DETECTION_UNKNOWN_LOCATION,
&supportedEvents, 0, NULL, false); Step 2. Reverse the order of calling CC_Notification_TriggerAndTransmit and CC_Basic_Set_tx functions in CC_Notification_TriggerAndTransmit Step 3. In the function ZCB_EventJobsTimer change the input parameters of the CC_Notification_TriggerAndTransmit function as follows (void) CC_Notification_TriggerAndTransmit(0, NOTIFICATION_EVENT_HOME_SECURITY_NO_EVENT, &supportedEvents, 0, NULL, false);
5.4.5 Deprecated Items None.
5.4.6 Removed Items None.
5.5 Switch On/Off
5.5.1 New Items None.
5.5.2 Improvements None.
5.5.3 Fixed Issues None.
5.5.4 Known Issues in the Current Release None.

silabs.com | Building a more connected world.

Z-Wave 7.22.1 | 14

5.5.5 Deprecated Items None.
5.5.6 Removed Items None.
5.6 Wall Controller
5.6.1 New Items None.
5.6.2 Improvements None.
5.6.3 Fixed Issues None.
5.6.4 Known Issues in the Current Release None.
5.6.5 Deprecated Items None.
5.6.6 Removed Items None.
5.7 Multilevel Sensor
This application is not certifiable due to missing features for passing the certification tests.
5.7.1 New Items None.
5.7.2 Improvements None.
5.7.3 Fixed Issues None.
5.7.4 Known Issues in the Current Release None.
silabs.com | Building a more connected world.

Sample Applications
Z-Wave 7.22.1 | 15

5.7.5 Deprecated Items None.
5.7.6 Removed Items None.
5.8 LED Bulb
5.8.1 New Items None.
5.8.2 Improvements None.
5.8.3 Fixed Issues None.
5.8.4 Known Issues in the Current Release None.
5.8.5 Deprecated Items None.
5.8.6 Removed Items None.

Sample Applications

silabs.com | Building a more connected world.

Z-Wave 7.22.1 | 16

Serial API Applications
6 Serial API Applications
Beginning with version 7.16, when backing up and restoring a Serial API end node via the FUNC_ID_NVM_BACKUP_RESTORE, the Serial API end node will automatically upgrade the protocol non-volatile memory (NVM) to the latest version. Any backup made of a 7.16 or later Serial API end node can be restored to its original version or to a later version of the Serial API end node without any manual upgrade of the protocol NVM being necessary. The serial interface is unchanged in version 8. As of SDK version 7.18.x, Serial API end node is available as source code as well as binary. This opens the possibility for building customized versions of Serial API end node with different pin configuration or additional hardware utilization. A use case might be to use SPI instead of UART for serial communication. No application using Serial API End Device is available in the Simplicity SDK.
6.1 Serial API Controller
6.1.1 New Items None.
6.1.2 Improvements None.
6.1.3 Fixed Issues None.
6.1.4 Known Issues in the Current Release None.
6.1.5 Deprecated Items None.
6.1.6 Removed Items None.

silabs.com | Building a more connected world.

Z-Wave 7.22.1 | 17

Important Changes
7 Important Changes
Starting in version 7.19, API-breaking changes have been documented in “Important_changes.md” available in the Simplicity SDK. Check it for a detailed description of changes introduced in the latest release.
HTML documentation has been added to the Simplicity SDK and can be found on https://docs.silabs.com/z-wave/7.22.1/zwave-api/ and in Simplicity Studio, Documentation section, under “Z-Wave zipped doxygen documentation”. Location of this document is /protocol/z-wave/docs_public/z-wave-html-docs.zip.

silabs.com | Building a more connected world.

Z-Wave 7.22.1 | 18

8 Open Source Software
Z-Wave is using FreeRTOS as the underlying OS, and it is based on FreeRTOS Kernel V10.4.3.

Open Source Software

silabs.com | Building a more connected world.

Z-Wave 7.22.1 | 19

Using This Release
9 Using This Release
This release contains the following: · Z-Wave Plus V2 Application Framework · Z-Wave Certified Applications for a broad range of smart home applications · Z-Wave Protocol and Serial API Applications If you are a first-time user, Z-Wave documentation is installed with the SDK. See INS14280: Z-Wave Getting Started for End Devices, INS14278: How to Use Certified Apps in Z-Wave, and INS14281: Z-Wave Getting Started for Controller Devices for instructions.
This SDK depends on a Simplicity SDK Platform. The Simplicity SDK Platform code provides functionality that supports protocol plugins and APIs in the form of drivers and other lower layer features that interact directly with Silicon Labs chips and modules. Gecko Platform components include EMLIB, EMDRV, RAIL Library, NVM3, PSA, and mbedTLS. Gecko Platform release notes are available through Simplicity Studio’s Launcher Perspective.
9.1 Installation and Use
Order a Z-Wave Wireless Starter kit. The kit offers the easiest and fastest way to start evaluation and development of your own ZWave mesh application. It provides a single world-wide development kit for both end devices and gateways with multiple radio boards, with which developers can create a mesh network and evaluate the Z-Wave module.
The Z-Wave and Z-Wave Long Range 800 SDK is provided as part of the Simplicity SDK, the suite of Silicon Labs SDKs. To quickly get started with the Simplicity SDK, install Simplicity Studio 5, which will set up your development environment and walk you through Simplicity SDK installation. Simplicity Studio 5 includes everything needed for IoT product development with Silicon Labs devices, including a resource and project launcher, software configuration tools, full IDE with GNU toolchain, and analysis tools. Installation instructions are provided in the online Simplicity Studio 5 User’s Guide.
Alternatively, Simplicity SDK may be installed manually by downloading or cloning the latest from GitHub. See https://github.com/SiliconLabs/simplicity_sdk for more information.
Simplicity Studio installs the SDK by default in: · (Windows): C:UsersSimplicityStudioSDKssimplicity_sdk · (MacOS): /Users//SimplicityStudio/SDKs/simplicity_sdk
To implement a specific application, Silicon Labs recommends starting with one of the existing self-certified apps with the desired Role Type.
9.2 Security Information
Secure Vault Integration
This version of the stack is using secure vault interface for key management of asymmetric keys (ECC Curve 25519) and Symmetric keys (AES).
Security Advisories
To subscribe to Security Advisories, log in to the Silicon Labs customer portal, then select Account Home. Click HOME to go to the portal home page and then click the Manage Notifications tile. Make sure that `Software/Security Advisory Notices & Product

silabs.com | Building a more connected world.

Z-Wave 7.22.1 | 20

Using This Release Change Notices (PCNs)’ is checked, and that you are subscribed at minimum for your platform and protocol. Click Save to save any changes.
9.3 Support
Development Kit customers are eligible for training and technical support. See support resources and contact Silicon Laboratories support at https://www.silabs.com/support.

silabs.com | Building a more connected world.

Z-Wave 7.22.1 | 21

Product Life Cycle and Certification
10 Product Life Cycle and Certification
Silicon Labs will add new features based on market requirements and continuously improve the Z-Wave Protocol to position the ZWave Ecosystem. The Z-Wave Protocol Life Cycle is a process to provide rapid innovation, new features and robust matured protocol release to Z-Wave Partners. The Z-Wave Protocol Life Cycle defines the maturation process of Z-Wave Protocol generations and consist of three phases divided in five Life Cycle stages. A change in the Z-Wave SDK utilized for a specific device does require recertification; however, the type of certification required, the amount of testing needed, and the associated fees depend on the scope of the change. Refer to Z-Wave Alliance home page https://z-wavealliance.org/ for details.
Table 10-1. Z-Wave SDK Release History

Series 800
700/800 700/800 700/800 700/800 700/800 700/800 700/800 700/800 700/800 700/800 700/800 700/800 700/800 700/800 700/800 700/800 700/800 700/800
700 700 700 700 700 700 700 700 700 700 700 700 700 700

SDK Version 7.22.0 GA 7.21.0 GA 7.20.2 GA 7.20.1 GA 7.20.0 Pre-Certified GA 7.19.3 GA 7.19.2 GA 7.19.1 GA 7.19.0 Pre-Certified GA 7.18.8 GA 7.18.6 GA 7.18.4 GA 7.18.3 GA 7.18.2 GA 7.18.1 GA 7.18.0 Pre-Certified GA 7.17.2 GA 7.17.1 Pre-Certified GA 7.17.0 Pre-Certified GA 7.16.3 GA 7.16.2 GA 7.16.1 GA 7.16.0 Pre-Certified GA 7.15.4 GA 7.15.2 Pre-Certified GA 7.15.1 Pre-Certified GA 7.14.3 GA 7.14.2 GA 7.14.1 GA 7.14.0 Beta 7.13.12 GA 7.13.11 GA 7.13.10 GA

Release Date [DD-MMM-YYYY] 6-JUN-2024 15-DEC-2023 9-OCT-2023 26-JUL-2023 07-JUN-2023 03-MAY-2023 08-MAR-2023 01-FEB-2023 14-DEC-2022 13-SEP-2023 28-JUN-2023 18-JAN-2023 19-OCT-2022 28-SEP-2022 17-AUG-2022 08-JUN-2022 09-MAR-2022 28-JAN-2022 08-DEC-2021 13-OCT-2021 08-SEP-2021 21-JUL-2021 16-JUN-2021 07-APR-2021 27-JAN-2021 09-DEC-2020 14-OCT-2020 09-SEP2020 29-JUL-2020 24-JUN-2020 21-SEP-2023 02-NOV-2022 18-AUG-2021

silabs.com | Building a more connected world.

Z-Wave 7.22.1 | 22

Series 700 700 700

SDK Version 7.13.9 GA 7.12.2 GA 7.12.1 GA

Product Life Cycle and Certification
Release Date [DD-MMM-YYYY] 03-MAR-2021 26-NOV-2019 20-SEP-2019

silabs.com | Building a more connected world.

Z-Wave 7.22.1 | 23

Simplicity Studio
One-click access to MCU and wireless tools, documentation, software, source code libraries & more. Available for Windows, Mac and Linux!

IoT Portfolio
www.silabs.com/IoT

SW/HW
www.silabs.com/simplicity

Quality
www.silabs.com/quality

Support & Community
www.silabs.com/community

Disclaimer Silicon Labs intends to provide customers with the latest, accurate, and in-depth documentation of all peripherals and modules available for system and software implementers using or intending to use the Silicon Labs products. Characterization data, available modules and peripherals, memory sizes and memory addresses refer to each specific device, and “Typical” parameters provided can and do vary in different applications. Application examples described herein are for illustrative purposes only. Silicon Labs reserves the right to make changes without further notice to the product information, specifications, and descriptions herein, and does not give warranties as to the accuracy or completeness of the included information. Without prior notification, Silicon Labs may update product firmware during the manufacturing process for security or reliability reasons. Such changes will not alter the specifications or the performance of the product. Silicon Labs shall have no liability for the consequences of use of the information supplied in this document. This document does not imply or expressly grant any license to design or fabricate any integrated circuits. The products are not designed or authorized to be used within any FDA Class III devices, applications for which FDA premarket approval is required or Life Support Systems without the specific written consent of Silicon Labs. A “Life Support System” is any product or system intended to support or sustain life and/or health, which, if it fails, can be reasonably expected to result in significant personal injury or death. Silicon Labs products are not designed or authorized for military applications. Silicon Labs products shall under no circumstances be used in weapons of mass destruction including (but not limited to) nuclear, biological or chemical weapons, or missiles capable of delivering such weapons. Silicon Labs disclaims all express and implied warranties and shall not be responsible or liable for any injuries or damages related to use of a Silicon Labs product in such unauthorized applications. Note: This content may contain offensive terminology that is now obsolete. Silicon Labs is replacing these terms with inclusive language wherever possible. For more information, visit www.silabs.com/about-us/inclusive- lexicon-project
Trademark Information Silicon Laboratories Inc.®, Silicon Laboratories®, Silicon Labs®, SiLabs® and the Silicon Labs logo®, Bluegiga®, Bluegiga Logo®, EFM®, EFM32®, EFR, Ember®, Energy Micro, Energy Micro logo and combinations thereof, “the world’s most energy friendly microcontrollers”, Redpine Signals®, WiSeConnect , n-Link, EZLink®, EZRadio®, EZRadioPRO®, Gecko®, Gecko OS, Gecko OS Studio, Precision32®, Simplicity Studio®, Telegesis, the Telegesis Logo®, USBXpress® , Zentri, the Zentri logo and Zentri DMS, Z-Wave®, and others are trademarks or registered trademarks of Silicon Labs. ARM, CORTEX, Cortex-M3 and THUMB are trademarks or registered trademarks of ARM Holdings. Keil is a registered trademark of ARM Limited. Wi-Fi is a registered trademark of the Wi-Fi Alliance. All other products or brand names mentioned herein are trademarks of their respective holders.
Silicon Laboratories Inc. 400 West Cesar Chavez Austin, TX 78701 USA
www.silabs.com

References

• Silicon Labs
• Silicon Labs
• About Us - Silicon Labs
• Silicon Labs Community
• IoT – Internet of Things - Silicon Labs
• Simplicity Studio - Silicon Labs
• Sil- · GitHub
• Technical Support - Silicon Labs
• The Internet of Things is Powered by Z-Wave - Z-Wave Alliance

Read User Manual Online (PDF format)

Download This Manual (PDF format)

Download this manual  >>