doc: matter: Update documentation about nRF54L10

LuDuda · nordicjm · commit 2ebe06d84fe3 · 2024-12-06T08:06:23.000Z
This commit updates Matter documentation to include nRF54L10.

Signed-off-by: Łukasz Duda &lt;lukasz.duda@nordicsemi.no&gt;
diff --git a/doc/nrf/protocols/matter/end_product/security.rst b/doc/nrf/protocols/matter/end_product/security.rst
@@ -81,9 +81,9 @@ An important setting, that depends on the hardware platform in use, is the way o
 The recommended and the most secure option is to use :ref:`lib_hw_unique_key` (HUK) library.
 HUK support is automatically enabled with the :kconfig:option:`CONFIG_TRUSTED_STORAGE_BACKEND_AEAD_KEY_DERIVE_FROM_HUK` Kconfig option for compatible configurations.
 
-The HUK library is supported for the nRF52840, nRF5340, and nRF54L15 platforms, but for :ref:`matter_samples` in the |NCS|, it is only enabled for the nRF5340 and NRF54L15 platforms:
+The HUK library is supported for the nRF52840, nRF5340, and nRF54L platforms, but for :ref:`matter_samples` in the |NCS|, it is only enabled for the nRF5340 and nRF54L platforms:
 
-* For the nRF5340 and nRF54L15 platforms, the HUK is generated at first boot and stored in the Key Management Unit (KMU).
+* For the nRF5340, nRF54L platforms, the HUK is generated at first boot and stored in the Key Management Unit (KMU).
   No changes to the existing partition layout are needed for products in the field.
 * For the nRF54L15 NS platform, the HUK generation and management is handled by the Trusted Firmware-M (TF-M) library.
 * For the nRF52840 platform, AEAD keys are derived with a SHA-256 hash (:kconfig:option:`CONFIG_TRUSTED_STORAGE_BACKEND_AEAD_KEY_HASH_UID`).
@@ -143,6 +143,13 @@ This is a reference configuration that can be modified in the production firmwar
      - CRACEN
      - Yes
      - Trusted Firmware-M (TF-M) + Key Management Unit (KMU)
+   * - nRF54L10 SoC
+     - Thread
+     - PSA Crypto API
+     - CRACEN [2]_
+     - Yes
+     - Trusted Storage library + Hardware Unique Key (HUK) + Key Management Unit (KMU)
+
 
 .. [1] The CryptoCell backend is used in parallel with the Oberon backend.
        By default, the CryptoCell backend is used only for Random Number Generation (RNG) and the AEAD key derivation driver.
@@ -193,6 +200,11 @@ See the following table to learn about the default secure storage backends for t
      - Key Management Unit (KMU)
      - | Key Management Unit (KMU),
        | Trusted Firmware-M Storage (TF-M)
+   * - nRF54L10 SoC
+     - Key Management Unit (KMU)
+     - | Key Management Unit (KMU),
+       | Trusted Storage library + Hardware Unique Key (Zephyr Settings),
+       | Trusted Storage library + SHA-256 hash (Zephyr Settings)
 
 If you migrate the DAC private key to storage based on Zephyr Settings storage, you cannot use the :kconfig:option:`CONFIG_CHIP_FACTORY_RESET_ERASE_SETTINGS` Kconfig option.
 This is because the factory reset feature will erase the secure storage, including the DAC private key, which has been removed from the factory data.
diff --git a/doc/nrf/protocols/matter/getting_started/hw_requirements.rst b/doc/nrf/protocols/matter/getting_started/hw_requirements.rst
@@ -20,6 +20,7 @@ Currently the following SoCs from Nordic Semiconductor are supported for use wit
 * :ref:`nRF5340 + nRF7002 <programming_board_names>` (Matter over Thread and Matter over Wi-Fi)
 * :ref:`nRF52840 <programming_board_names>` (Matter over Thread)
 * :ref:`nRF54L15 <programming_board_names>` (Matter over Thread)
+* :ref:`nRF54L10 <programming_board_names>` (Matter over Thread)
 
 Front-End Modules
 =================
@@ -32,9 +33,13 @@ For more information about the FEM support in the |NCS|, see :ref:`ug_radio_fem`
 External flash
 **************
 
-For the currently supported SoCs, you must use an external memory with at least 1 MB of flash for nRF52840 and 1.5MB for nRF5340.
+For the currently supported SoCs, you must use an external memory with at least 1 MB of flash for nRF52840 and nRF54L10, and 1.5 MB for nRF5340 and nRF54L15.
 This is required to perform the DFU operation.
 
+.. note::
+   The nRF54L15 supports DFU with image compression, which may eliminate the need for external flash.
+   For more details, see :ref:`mcuboot_image_compression`.
+
 The development kits for the supported SoCs from Nordic Semiconductor are supplied with the MX25R64 type of external flash that meets these memory requirements.
 However, it is possible to configure the SoCs with different QSPI or SPI memory if it is supported by Zephyr.
 For this purpose, check the reference design for Nordic DKs for information about how to connect the external memory with SoC, specifically whether the pins are designed for the QSPI or the high-speed SPIM operations.
@@ -214,6 +219,7 @@ Values are provided in kilobytes (KB).
    .. tab:: nRF54L15 DK
 
       The following table lists memory requirements for samples running on the :ref:`nRF54L15 DK <programming_board_names>` (:ref:`nrf54l15dk/nrf54l15/cpuapp <zephyr:nrf54l15dk_nrf54l15>`).
+      You can use the table as a reference for the :ref:`nRF54L15 DK (emulating nRF54L10) <programming_board_names>` (:ref:`nrf54l15dk/nrf54l10/cpuapp <zephyr:nrf54l15dk_nrf54l15>`).
 
       +----------------------------------------------------------------------+---------------+-------------------+----------------+------------+-------------+---------------------------------+
       | Sample                                                               |   MCUboot ROM |   Application ROM |   Factory data |   Settings |   Total ROM |   Total RAM (incl. static HEAP) |
@@ -645,15 +651,15 @@ For more information about configuration of memory layouts in Matter, see :ref:`
         +-----------------------------------------+---------------------+-------------------+---------------------+-----------------+-------------------+
         | Partition                               | Offset              | Size              | Partition elements  | Element offset  | Element size      |
         +=========================================+=====================+===================+=====================+=================+===================+
-        | Bootloader (mcuboot)                    | 0kB (0x0)           | 48kB (0xC000)     |-                    |-                |-                  |
+        | Bootloader (mcuboot)                    | 0kB (0x0)           | 52kB (0xD000)     |-                    |-                |-                  |
         +-----------------------------------------+---------------------+-------------------+---------------------+-----------------+-------------------+
-        | Application (mcuboot_primary/app)       | 28kB (0x7000)       | 960kB (0xf0000)   | mcuboot_pad         | 48kB (0xC000)   | 2048B (0x800)     |
+        | Application (mcuboot_primary/app)       | 52kB (0xD000)       | 1428kB (0x165000) | mcuboot_pad         | 52kB (0xD000)   | 2048B (0x800)     |
         |                                         |                     |                   +---------------------+-----------------+-------------------+
-        |                                         |                     |                   | mcuboot_primary_app | 50kB (0xc800)   | 1438kB (0xefe00)  |
+        |                                         |                     |                   | mcuboot_primary_app | 54kB (0xD800)   | 1426kB (0x164800) |
         +-----------------------------------------+---------------------+-------------------+---------------------+-----------------+-------------------+
-        | Factory data (factory_data)             | 1488kB (0x174000)   | 4kB (0x1000)      |-                    |-                |-                  |
+        | Factory data (factory_data)             | 1480kB (0x172000)   | 4kB (0x1000)      |-                    |-                |-                  |
         +-----------------------------------------+---------------------+-------------------+---------------------+-----------------+-------------------+
-        | Non-volatile storage (settings_storage) | 1492kB (0x175000)   | 32kB (0x8000)     |-                    |-                |-                  |
+        | Non-volatile storage (settings_storage) | 1484kB (0x173000)   | 40kB (0xA000)     |-                    |-                |-                  |
         +-----------------------------------------+---------------------+-------------------+---------------------+-----------------+-------------------+
 
       Application core SRAM primary (size: 0x40000 = 256kB)
@@ -674,17 +680,17 @@ For more information about configuration of memory layouts in Matter, see :ref:`
         +-----------------------------------------+---------------------+-------------------+---------------------+-----------------+-------------------+
         | Partition                               | Offset              | Size              | Partition elements  | Element offset  | Element size      |
         +=========================================+=====================+===================+=====================+=================+===================+
-        | Bootloader (mcuboot)                    | 0kB (0x0)           | 48kB (0xC000)     |-                    |-                |-                  |
+        | Bootloader (mcuboot)                    | 0kB (0x0)           | 52kB (0xD000)     |-                    |-                |-                  |
         +-----------------------------------------+---------------------+-------------------+---------------------+-----------------+-------------------+
-        | Secure part (tfm_secure)                | 48kB (0xc000)       | 128kB (0x20000)   | mcuboot_pad         | 48kB (0xc000)   | 2k (0x800)        |
+        | Secure part (tfm_secure)                | 52kB (0xD000)       | 128kB (0x20000)   | mcuboot_pad         | 52kB (0xD000)   | 2k (0x800)        |
         |                                         |                     |                   +---------------------+-----------------+-------------------+
-        |                                         |                     |                   | tfm                 | 50kB (0xc800)   | 126kB (0x1f800)   |
+        |                                         |                     |                   | tfm                 | 54kB (0xD800)   | 126kB (0x1F800)   |
         +-----------------------------------------+---------------------+-------------------+---------------------+-----------------+-------------------+
-        | Non-Secure part (tfm_nonsecure)         | 176kB (0x2C000)     | 1272kB (0x13E000) | app                 | 176kB (0x2C000) | 1272kB (0x13E000) |
+        | Non-Secure part (tfm_nonsecure)         | 180kB (0x2D000)     | 1268kB (0x13D000) | app                 |180kB (0x2D000)  | 1268kB (0x13D000) |
         +-----------------------------------------+---------------------+-------------------+---------------------+-----------------+-------------------+
         | Factory data (factory_data)             | 1448kB (0x16A000)   | 4kB (0x1000)      |-                    |-                |-                  |
         +-----------------------------------------+---------------------+-------------------+---------------------+-----------------+-------------------+
-        | Non-volatile storage (settings_storage) | 1452kB (0x16B000)   | 40kB (0xa000)     |-                    |-                |-                  |
+        | Non-volatile storage (settings_storage) | 1452kB (0x16B000)   | 40kB (0xA000)     |-                    |-                |-                  |
         +-----------------------------------------+---------------------+-------------------+---------------------+-----------------+-------------------+
         | TFM storage (tfm_storage)               | 1492kB (0x175000)   | 32kB (0x8000)     | tfm_its             | 8kB (0x175000)  | 8kB (0x2000)      |
         |                                         |                     |                   +---------------------+-----------------+-------------------+
@@ -704,6 +710,35 @@ For more information about configuration of memory layouts in Matter, see :ref:`
         | Non-Secure Static RAM (sram_nonsecure)        | 256kB (0xF000)      | 196kB (0x31000)   |-                    |-                |-                |
         +-----------------------------------------------+---------------------+-------------------+---------------------+-----------------+-----------------+
 
+   .. tab:: nRF54L10 emulation on nRF54L15 DK
+
+      The following memory map is valid for Matter applications running on the :ref:`nRF54L15 DK (emulating nRF54L10) <programming_board_names>` (:ref:`nrf54l15dk/nrf54l10/cpuapp <zephyr:nrf54l15dk_nrf54l15>`).
+
+      Application core flash (size: 0xFF800 = 1022kB)
+
+        +-----------------------------------------+---------------------+-------------------+---------------------+-----------------+-------------------+
+        | Partition                               | Offset              | Size              | Partition elements  | Element offset  | Element size      |
+        +=========================================+=====================+===================+=====================+=================+===================+
+        | Bootloader (mcuboot)                    | 0kB (0x0)           | 52kB (0xD000)     |-                    |-                |-                  |
+        +-----------------------------------------+---------------------+-------------------+---------------------+-----------------+-------------------+
+        | Application (mcuboot_primary/app)       | 52kB (0xD000)       | 926kB (0xE7800)   | mcuboot_pad         | 52kB (0xD000)   | 2048B (0x800)     |
+        |                                         |                     |                   +---------------------+-----------------+-------------------+
+        |                                         |                     |                   | mcuboot_primary_app | 54kB (0xD800)   | 924kB (0xE7000)   |
+        +-----------------------------------------+---------------------+-------------------+---------------------+-----------------+-------------------+
+        | Factory data (factory_data)             | 978kB (0xF4800)     | 4kB (0x1000)      |-                    |-                |-                  |
+        +-----------------------------------------+---------------------+-------------------+---------------------+-----------------+-------------------+
+        | Non-volatile storage (settings_storage) | 982kB (0xF5800)     | 40kB (0xA000)     |-                    |-                |-                  |
+        +-----------------------------------------+---------------------+-------------------+---------------------+-----------------+-------------------+
+
+      Application core SRAM primary (size: 0x30000 = 192kB)
+        SRAM is located at the address ``0x20000000`` in the memory address space of the application.
+
+        +-----------------------------------------------+---------------------+-------------------+---------------------+-----------------+-----------------+
+        | Partition                                     | Offset              | Size              | Partition elements  | Element offset  | Element size    |
+        +===============================================+=====================+===================+=====================+=================+=================+
+        | Static RAM (sram_primary)                     | 0kB (0x0)           | 192kB (0x30000)   |-                    |-                |-                |
+        +-----------------------------------------------+---------------------+-------------------+---------------------+-----------------+-----------------+
+
 ..
 
 You can generate :ref:`Partition Manager's ASCII representation <pm_partition_reports>` of these tables by running the following command for your respective *board_target*:
diff --git a/doc/nrf/protocols/matter/getting_started/transmission_power.rst b/doc/nrf/protocols/matter/getting_started/transmission_power.rst
@@ -93,6 +93,7 @@ The maximum value of 20 dBm is only recommended for devices that are using :ref:
 | nrf21540dk               | -40 to +20 (:ref:`more information <ug_matter_gs_transmission_power_fem>`)  |
 +--------------------------+-----------------------------------------------------------------------------+
 | nrf54l15dk_nrf54l15      | -8 to +8                                                                    |
+| nrf54l15dk_nrf54l10      |                                                                             |
 +--------------------------+-----------------------------------------------------------------------------+
 
 You can provide the desired value also as a CMake argument when building the sample.
diff --git a/samples/matter/template/README.rst b/samples/matter/template/README.rst
@@ -32,7 +32,7 @@ IPv6 network support
 
 The development kits for this sample offer the following IPv6 network support for Matter:
 
-* Matter over Thread is supported for ``nrf52840dk/nrf52840``, ``nrf5340dk/nrf5340/cpuapp``, ``nrf21540dk/nrf52840``, ``nrf54l15dk/nrf54l15/cpuapp``, and ``nrf54h20dk/nrf54h20/cpuapp``.
+* Matter over Thread is supported for ``nrf52840dk/nrf52840``, ``nrf5340dk/nrf5340/cpuapp``, ``nrf21540dk/nrf52840``, ``nrf54l15dk/nrf54l15/cpuapp``, ``nrf54l15dk/nrf54l10/cpuapp``, and ``nrf54h20dk/nrf54h20/cpuapp``.
 * Matter over Wi-Fi is supported for ``nrf5340dk/nrf5340/cpuapp`` or ``nrf54h20dk/nrf54h20/cpuapp`` with the ``nrf7002ek`` shield attached, or for ``nrf7002dk/nrf5340/cpuapp``.
 
 Overview
