Skip to content

Commit a1f9a9d

Browse files
committed
doc: add known issue about simmultaneous commissioning impact on ZC
Add KRKNWK-12115 known issue. Signed-off-by: Eduardo Montoya <eduardo.montoya@nordicsemi.no>
1 parent 09fe811 commit a1f9a9d

1 file changed

Lines changed: 31 additions & 0 deletions

File tree

docs/known_issues.rst

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -139,3 +139,34 @@ NCSIDB-1336: Zigbee Router device cannot rejoin after missing Network Key update
139139
}
140140
break;
141141
}
142+
143+
.. rst-class:: v1-3-0 v1-2-1 v1-2-0 v1-1-0 v1-0-0
144+
145+
KRKNWK-12115: Simultaneous commissioning of many devices can cause the Coordinator device to assert
146+
The Zigbee Coordinator can assert when multiple devices are being commissioned at the same time.
147+
In some cases, the device can end up in a low memory state.
148+
149+
The :ref:`Zigbee network coordinator <zigbee_network_coordinator_sample>` sample includes :file:`zb_mem_config_max.h` by default, which already selects the coordinator-oriented configurable-memory profile, but the derived scheduler queue and buffer pool sizes can still be too small for very bursty join traffic.
150+
151+
**Workaround:** Where possible, reduce parallel commissioning.
152+
If you still hit asserts or allocation failures, increase the coordinator's scheduler queue and buffer pool:
153+
154+
#. Add a custom memory configuration header to your coordinator application (for layout, follow the :ref:`Light switch <zigbee_light_switch_sample>` sample and its :file:`samples/light_switch/include/zb_mem_config_custom.h` file).
155+
#. Populate that header starting from the contents of :file:`zb_mem_config_max.h`, then override the limits as needed (see :file:`zb_mem_config_common.h` for how the base profile maps to numeric sizes).
156+
#. In the custom header, after the block that includes :file:`zb_mem_config_common.h`, add overrides such as:
157+
158+
.. code-block:: c
159+
160+
/* Increase scheduler queue depth (allowed range 48U–256U). */
161+
#undef ZB_CONFIG_SCHEDULER_Q_SIZE
162+
#define ZB_CONFIG_SCHEDULER_Q_SIZE 96U
163+
/* Increase IOBUF pool (allowed range 48U–127U). */
164+
#undef ZB_CONFIG_IOBUF_POOL_SIZE
165+
#define ZB_CONFIG_IOBUF_POOL_SIZE 64U
166+
167+
#. In the custom header, after the block that includes :file:`zb_mem_config_common.h`, add overrides such as:
168+
#. In the coordinator :file:`main.c`, replace ``#include <zb_mem_config_max.h>`` with ``#include "zb_mem_config_custom.h"`` (or your header name).
169+
170+
Rebuild and re-check static RAM usage (see :ref:`zigbee_memory`).
171+
Higher pools increase footprint.
172+

0 commit comments

Comments
 (0)