doc: miscellaneous fixes

edmont · edmont · commit dcc174f00c71 · 2026-01-16T14:07:18.000+01:00
Add missing nRF5340 related info and other minor fixes.

Signed-off-by: Eduardo Montoya &lt;eduardo.montoya@nordicsemi.no&gt;
diff --git a/docs/architectures.rst b/docs/architectures.rst
@@ -45,6 +45,11 @@ This is the design most commonly used for End Devices and Routers.
 
    Zigbee-only architecture on nRF54L Series and nRF52840 devices
 
+.. figure:: images/zigbee_platform_design_nRF53.svg
+   :alt: Zigbee-only architecture (nRF53 Series devices)
+
+   Zigbee-only architecture on nRF53 Series devices
+
 This platform design is suitable for the following development kits:
 
 .. include:: /includes/device_table_single_multi.txt
@@ -67,9 +72,14 @@ It also has the following disadvantages:
 
    Multiprotocol Zigbee and Bluetooth LE architecture on nRF54L Series and nRF52840 devices
 
+.. figure:: images/zigbee_platform_design_nRF5340_multi.svg
+   :alt: Multiprotocol Zigbee and Bluetooth LE architecture (nRF53 Series devices)
+
+   Multiprotocol Zigbee and Bluetooth LE architecture on nRF53 Series devices
+
 For more information, see `Multiprotocol support`_ in the |NCS| documentation and :ref:`zigbee_light_switch_sample_nus`.
 
-This platform design is suitable for the following development kit:
+This platform design is suitable for the following development kits:
 
 .. include:: /includes/device_table_single_multi.txt
 
@@ -91,7 +101,7 @@ Network Co-Processor (NCP)
 
 In this design, the host processor runs the Zigbee application layer (ZCL) and the Zigbee commissioning logic.
 The connectivity device (nRF SoC) runs the :ref:`NCP application <zigbee_ncp_sample>` that contains lower parts of the Zigbee stack (802.15.4 PHY/MAC and the Zigbee PRO network layer), as well as provides commands to execute BDB commissioning primitives.
-The host processor communicates with the NCP through a serial interface (UART).
+The host processor communicates with the NCP through a serial interface (USB or UART).
 
 The NCP design has the following advantages:
 
diff --git a/docs/lib/zigbee_fota.rst b/docs/lib/zigbee_fota.rst
@@ -95,6 +95,20 @@ The Zigbee FOTA library has the following limitations:
 * The Zigbee FOTA upgrades are currently supported on the nRF52840 DK (PCA10056), nRF5340 DK (PCA10095) and nRF54L15 DK (PCA10156).
 * The Zigbee FOTA library does not currently support bootloader upgrades.
 
+Additionally, the following limitations apply on the nRF5340 SoCs:
+
+* It is required to use external flash to enable the Zigbee FOTA library.
+* By default, only the full upgrades (to both application and network core) are allowed.
+  Disable the ``CONFIG_NRF53_ENFORCE_IMAGE_VERSION_EQUALITY`` Kconfig option to build update images without inter-dependencies so that they can be applied independently.
+* It is not possible to modify the value of the ``SB_CONFIG_MCUBOOT_MODE_SWAP_WITHOUT_SCRATCH`` Kconfig option.
+  As a result, the fallback recovery is not available and any valid upgrade will overwrite the previous image.
+  The call to the :c:func:`boot_write_img_confirmed` will have no effect.
+* The current DFU limitations and dependencies are enforced by the ``CONFIG_NRF53_MULTI_IMAGE_UPDATE`` Kconfig option.
+* The version of the network core image is always set to the same value as the application core image.
+  Its value can be configured using the ``CONFIG_MCUBOOT_IMGTOOL_SIGN_VERSION`` Kconfig option.
+* The MCUboot header is not stored inside the network core flash memory.
+  As a result, it is not possible to read the version of the currently running network core image.
+
 API documentation
 *****************
 
diff --git a/docs/links.txt b/docs/links.txt
@@ -77,10 +77,10 @@
 .. _`Pulse Width Modulation (PWM)`: https://docs.nordicsemi.com/bundle/ncs-2.9.2/page/zephyr/hardware/peripherals/pwm.html
 .. _`UART API`: https://docs.nordicsemi.com/bundle/ncs-2.9.2/page/zephyr/hardware/peripherals/uart.html
 .. _`Shields`: https://docs.nordicsemi.com/bundle/ncs-2.9.2/page/zephyr/hardware/porting/shields.html
-.. _`Board support`: https://docs.nordicsemi.com/bundle/ncs-latest/page/nrf/app_dev/board_names.html#programming-board-names
+.. _`Board support`: https://docs.nordicsemi.com/bundle/ncs-2.9.2//page/nrf/app_dev/board_names.html#programming-board-names
 
 .. _`nrf52840dk`: https://docs.nordicsemi.com/bundle/ncs-2.9.2/page/zephyr/boards/nordic/nrf52840dk/doc/index.html
-.. _`nrf52840dongle`: https://docs.nordicsemi.com/bundle/ncs-latest/page/zephyr/boards/nordic/nrf52840dongle/doc/index.html#nrf52840dongle-nrf52840
+.. _`nrf52840dongle`: https://docs.nordicsemi.com/bundle/ncs-2.9.2//page/zephyr/boards/nordic/nrf52840dongle/doc/index.html#nrf52840dongle-nrf52840
 .. _`nrf52833dk`: https://docs.nordicsemi.com/bundle/ncs-2.9.2/page/zephyr/boards/nordic/nrf52833dk/doc/index.html
 .. _`nrf5340dk`: https://docs.nordicsemi.com/bundle/ncs-2.9.2/page/zephyr/boards/nordic/nrf5340dk/doc/index.html
 .. _`nrf54l15dk`: https://docs.nordicsemi.com/bundle/ncs-2.9.2/page/zephyr/boards/nordic/nrf54l15dk/doc/index.html
diff --git a/docs/migration.rst b/docs/migration.rst
@@ -1,6 +1,6 @@
 .. _migration:
 
-Migration guide for R22 to R23 Add-on
+Migration guide for R22 to R23 add-on
 #####################################
 
 .. contents::
diff --git a/docs/shortcuts.txt b/docs/shortcuts.txt
@@ -40,7 +40,7 @@
    See :ref:`ug_zigbee_configuring` for more information.
 .. |zigbee_library| replace:: This is a Zigbee library.
    See :ref:`ug_zigbee_configuring_libraries` for information about how to configure it for you Zigbee application.
-.. |zigbee_ncp_package| replace:: It contains the full development-ready source code for host and evaluation-ready firmware for the nRF54L15 DK, nRF52840 DK, nRF52833 DK, and the nRF52840 Dongle.
+.. |zigbee_ncp_package| replace:: It contains the full development-ready source code for host and evaluation-ready firmware.
    The package comes with prebuilt libraries compatible with 64-bit Ubuntu |ubuntu_version| Linux.
 .. |zigbee_ncp_package_more_info| replace:: For information about how to recompile the package libraries for a different host architecture or operating system, see the `NCP Host documentation`_.
    For information about how to use NCP Host with the |addon| for the |NCS| or build the firmware using the NCP sample, see the :ref:`NCP sample <zigbee_ncp_sample>`.
