Skip to content

Commit 21a8ebd

Browse files
committed
doc: zigbee: add known issue KRKNWK-19894
Add mention of possible ZCL Reporting configuration data incompatibility issue after performing DFU. Signed-off-by: Adam Zelik <adam.zelik@nordicsemi.no>
1 parent 4dfdc18 commit 21a8ebd

File tree

1 file changed

+17
-0
lines changed

1 file changed

+17
-0
lines changed

doc/nrf/releases_and_maturity/known_issues.rst

+17
Original file line numberDiff line numberDiff line change
@@ -1421,6 +1421,23 @@ NCSIDB-1336: Zigbee Router device cannot rejoin after missing Network Key update
14211421
If the returned message status is not ``ZB_ZDP_STATUS_SUCCESS``, initiate the rejoin procedure by calling the :c:func:`zb_bdb_initiate_tc_rejoin` function.
14221422
The device will switch the key and successfully rejoin network, whether the network is open or closed.
14231423

1424+
.. rst-class:: v2-9-0-nRF54H20-1-rc2 v2-9-0 v2-8-0 v2-7-0 v2-6-3 v2-6-2 v2-6-1 v2-6-0
1425+
1426+
KRKNWK-19894: The Device Firmware Upgrade (DFU) from the |NCS| v2.5.X or older to a newer version may cause fatal error or abnormal behavior
1427+
The issue occurs when the device initially uses firmware built with the |NCS| v2.5.X or earlier, and has the ZCL Reporting feature configured (which means it reports selected attributes).
1428+
Subsequently, the DFU is performed where the new firmware is built based on the |NCS| v2.6.0 or later.
1429+
1430+
During the upgrade, the NVRAM content is preserved.
1431+
However, part of this content has a structure that is incompatible with the new firmware, leading to abnormal behavior.
1432+
1433+
The attribute reporting stops working correctly.
1434+
The device frequently sends the Report Attributes command, but the messages are corrupted (empty).
1435+
This condition of the device likely prevents remote reconfiguration.
1436+
In some cases of cluster configuration, the firmware may encounter a fatal error every time it starts.
1437+
1438+
**Workaround:** After upgrading the device, perform an NVRAM erase (complete or specifically targeting the part with the ``ZB_NVRAM_ZCL_REPORTING_DATA`` ID).
1439+
This method prevents abnormal behavior, but it leads to the loss of configuration data, requiring you to reconfigure the device.
1440+
14241441
.. rst-class:: v2-7-0
14251442

14261443
KRKNWK-19263: FOTA DFU on the nRF5340 DK fails due to an invalid update image

0 commit comments

Comments
 (0)