doc: Added documentation about DFU compression for Matter template

* Added information about internal configuration to Matter
template readme
* Added section about image compression to the bootloader
documentation
* Modified sample.yml to build the variant for release with
internal configuration
* Created new partition layout description
* Updated missing section about external flash partitions
layout for nrf54l15

Signed-off-by: Kamil Kasperczyk <[email protected]>

Author: kkasperczyk-no

doc/nrf/protocols/matter/end_product/bootloader.rst

@@ -131,3 +131,24 @@ Downgrade protection
 The :ref:`downgrade protection <ug_fw_update_image_versions_mcuboot_downgrade>` mechanism makes it impossible for an attacker to trick a user to install a firmware image older than the currently installed one.
 The attacker might want to do this to reintroduce old security vulnerabilities that have already been fixed in newer firmware revisions.
 You should enable the downgrade protection mechanism if you choose to enable MCUboot's ``SB_CONFIG_MCUBOOT_MODE_OVERWRITE_ONLY`` Kconfig option, which disables the fallback recovery in case of a faulty upgrade.
+
+.. _ug_matter_device_bootloader_image_compression:
+
+Image compression
+*****************
+
+The :ref:`MCUboot image compression <mcuboot_image_compression>` feature allows you to reduce the size of the firmware image that is being installed.
+This is done by compressing the image before it is written to the secondary slot.
+
+Thanks to the compression, the secondary slot can be smaller than the primary one.
+This is especially useful when you do not want to use external flash for the secondary slot, and you need to place the new image in the internal memory.
+
+You can enable this feature by setting the following Kconfig options in your application's sysbuild configuration file:
+
+* :kconfig:option:`SB_CONFIG_MCUBOOT_MODE_OVERWRITE_ONLY` to ``y``
+* :kconfig:option:`SB_CONFIG_MCUBOOT_COMPRESSED_IMAGE_SUPPORT` to ``y``
+
+If your application has used external flash for the secondary slot and you want to stop using it, disable the following Kconfig options in your application's sysbuild configuration file:
+
+* :kconfig:option:`SB_CONFIG_PM_OVERRIDE_EXTERNAL_DRIVER_CHECK` to ``n``
+* :kconfig:option:`SB_CONFIG_PM_EXTERNAL_FLASH_MCUBOOT_SECONDARY` to ``n``

doc/nrf/protocols/matter/getting_started/hw_requirements.rst

@@ -668,6 +668,50 @@ For more information about configuration of memory layouts in Matter, see :ref:`
         | Static RAM (sram_primary)                     | 0kB (0x0)           | 256kB (0x40000)   |-                    |-                |-                |
         +-----------------------------------------------+---------------------+-------------------+---------------------+-----------------+-----------------+
 
+      External flash (size: 0x800000 = 8192kB)
+        +-----------------------------------------+------------------+-------------------+---------------------+-----------------+-----------------+
+        | Partition                               | Offset           | Size              | Partition elements  | Element offset  | Element size    |
+        +=========================================+==================+===================+=====================+=================+=================+
+        | Application DFU (mcuboot_secondary)     | 0kB (0x0)        | 1428kB (0x165000) |-                    |-                |-                |
+        +-----------------------------------------+------------------+-------------------+---------------------+-----------------+-----------------+
+        | Free space (external_flash)             | 1428kB (0x165000)| 6764kB (0x69B000) |-                    |-                |-                |
+        +-----------------------------------------+------------------+-------------------+---------------------+-----------------+-----------------+
+
+   .. tab:: nRF54L15 DK with internal memory only
+
+      The following memory map is valid for Matter applications running on the :ref:`nRF54L15 DK <programming_board_names>` (:ref:`nrf54l15dk/nrf54l15/cpuapp <zephyr:nrf54l15dk_nrf54l15>`).
+      You can use this DK with any application.
+      However, it is currently integrated only by the :ref:`Matter Template sample <matter_template_sample>`.
+
+      Application core flash (size: 0x17D000 = 1524kB)
+
+        +-----------------------------------------+---------------------+-------------------+-----------------------+-----------------+-------------------+
+        | Partition                               | Offset              | Size              | Partition elements    | Element offset  | Element size      |
+        +=========================================+=====================+===================+=======================+=================+===================+
+        | Bootloader (mcuboot)                    | 0kB (0x0)           | 52kB (0xD000)     |-                      |-                |-                  |
+        +-----------------------------------------+---------------------+-------------------+-----------------------+-----------------+-------------------+
+        | Application (mcuboot_primary/app)       | 52kB (0xD000)       | 864kB (0xD8000)   | mcuboot_pad           | 52kB (0xD000)   | 2048B (0x800)     |
+        |                                         |                     |                   +-----------------------+-----------------+-------------------+
+        |                                         |                     |                   | mcuboot_primary_app   | 54kB (0xD800)   | 862kB (0xD7800)   |
+        +-----------------------------------------+---------------------+-------------------+-----------------------+-----------------+-------------------+
+        | Application DFU (mcuboot_secondary)     | 916kB (0xE5000)     | 564kB (0x8D000)   | mcuboot_secondary_pad | 916kB (0xE5000) | 2048B (0x800)     |
+        |                                         |                     |                   +-----------------------+-----------------+-------------------+
+        |                                         |                     |                   | mcuboot_secondary_app | 918kB (0xE5800) | 562kB (0x8C800)   |
+        +-----------------------------------------+---------------------+-------------------+-----------------------+-----------------+-------------------+
+        | Factory data (factory_data)             | 1480kB (0xE5000)    | 4kB (0x1000)      |-                      |-                |-                  |
+        +-----------------------------------------+---------------------+-------------------+-----------------------+-----------------+-------------------+
+        | Non-volatile storage (settings_storage) | 1484kB (0x173000)   | 40kB (0xA000)     |-                      |-                |-                  |
+        +-----------------------------------------+---------------------+-------------------+-----------------------+-----------------+-------------------+
+
+      Application core SRAM primary (size: 0x40000 = 256kB)
+        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)           | 256kB (0x40000)   |-                    |-                |-                |
+        +-----------------------------------------------+---------------------+-------------------+---------------------+-----------------+-----------------+
+
    .. tab:: nRF54L15 DK with TF-M
 
       The following table lists memory requirements for samples running on the :ref:`nRF54L15 DK with CMSE enabled <app_boards_spe_nspe_cpuapp_ns>` (:ref:`nrf54l15dk/nrf54l15/cpuapp/ns <zephyr:nrf54l15dk_nrf54l15>`).

samples/matter/template/README.rst

@@ -130,6 +130,32 @@ For example:
 
 .. include:: /includes/advanced_conf_matter.txt
 
+Matter template using only internal memory
+==========================================
+
+For the nRF54L15 DK, you can configure the sample to use only the internal RRAM for storage.
+It applies to the DFU as well, which means that both the currently running firmware and the new firmware to be updated will be stored within the device's internal RRAM memory.
+See the Device Firmware Upgrade support section above for information about the DFU process.
+
+The DFU image can fit in the internal flash memory thanks to the usage of :ref:`MCUboot image compression<ug_matter_device_bootloader_image_compression>`.
+
+This configuration is disabled by default for the Matter template sample.
+To enable it, set the ``FILE_SUFFIX`` CMake option to ``internal``.
+
+The following is an example command to build the sample for the nRF54L15 DK with support for Matter OTA DFU and DFU over Bluetooth SMP, and using internal RRAM only:
+
+.. code-block:: console
+
+    west build -p -b nrf54l15dk/nrf54l15/cpuapp -- -DCONFIG_CHIP_DFU_OVER_BT_SMP=y -DFILE_SUFFIX=internal
+
+To build the sample for the same purpose, but in the ``release`` configuration, use the following command:
+
+.. code-block:: console
+
+    west build -p -b nrf54l15dk/nrf54l15/cpuapp -- -DCONFIG_CHIP_DFU_OVER_BT_SMP=y -DFILE_SUFFIX=internal -Dtemplate_EXTRA_CONF_FILE=prj_release.conf
+
+In this case, the size of the MCUboot secondary partition used for storing the new application image is approximately 30%-40% smaller than it would be when using a configuration with external flash memory support.
+
 User interface
 **************
 

samples/matter/template/sample.yaml

@@ -70,13 +70,27 @@ tests:
     tags:
       - sysbuild
       - ci_samples_matter
+  sample.matter.template.release.internal:
+    sysbuild: true
+    build_only: true
+    extra_args:
+      - FILE_SUFFIX=internal
+      - CONFIG_NCS_SAMPLE_MATTER_OPERATIONAL_KEYS_MIGRATION_TO_ITS=y
+      - template_EXTRA_CONF_FILE=prj_release.conf
+    integration_platforms:
+      - nrf54l15dk/nrf54l15/cpuapp
+    platform_allow: nrf54l15dk/nrf54l15/cpuapp
+    tags:
+      - sysbuild
+      - ci_samples_matter
   sample.matter.template.release.internal.smp_dfu:
     sysbuild: true
     build_only: true
     extra_args:
       - FILE_SUFFIX=internal
       - CONFIG_CHIP_DFU_OVER_BT_SMP=y
       - CONFIG_NCS_SAMPLE_MATTER_OPERATIONAL_KEYS_MIGRATION_TO_ITS=y
+      - template_EXTRA_CONF_FILE=prj_release.conf
     integration_platforms:
       - nrf54l15dk/nrf54l15/cpuapp
     platform_allow: nrf54l15dk/nrf54l15/cpuapp