Migration guide for R22 to R23 add-on

This page describes the changes required to successfully migrate a Zigbee application based on the latest Zigbee R22 add-on (v1.0.1) release to Zigbee R23 add-on v1.3.0.

Note

Updating Zigbee R22 add-on-based firmware to Zigbee R23 add-on-based firmware through OTA is possible. For testing purposes, use the Zigbee: Light switch with the FOTA extension.

Complete the following steps:

  1. Read the ZBOSS Zigbee 2023 (R23) features page about new R23 features.

  2. Read the section about changes in PAN ID conflict resolution PANID conflict resolution API.

  3. If the application manually adjusts configurable memory settings, note the new ZB_CONFIG_NWK_DISC_TABLE_SIZE setting.

  4. If the application manually adjusts configurable memory settings, note the new ZB_CONFIG_ZDO_KEY_NEGOTIATIONS_NUM setting.

  5. If the application operates directly with ZBOSS neighbor table entries (the unusual case), note the changed format of zb_neighbor_tbl_ent_t() and the introduction of the zb_nwk_disc_tbl_ent_t() function.

Warning

The NVRAM version has been changed. Data stored in NVRAM on the device is automatically migrated to the new version on the first ZBOSS startup. For details on NVRAM dataset types and version definitions, see the ZBOSS NVRAM API documentation.

When migrating, note that support for new R23 features increases the required memory. Refer to the Memory requirements page for examples of memory requirements for different samples.