doc: nrf54l: update FLPR documentation

* Add missing FLPR targets for L15
* Introduce FLPR documentation for LM20

Signed-off-by: Marcin Szymczyk <[email protected]>

Author: masz-nordic

doc/nrf/app_dev/device_guides/coprocessors/index.rst

@@ -9,7 +9,7 @@ Developing with coprocessors
 
 You can use the VPR coprocessor (Fast Lightweight Peripheral Processor - FLPR) as follows:
 
-* As an additional core in a multicore system using Zephyr in multithreaded mode (see the :ref:`nRF54L15<vpr_flpr_nrf54l>` and :ref:`nRF54H20 devices<ug_nrf54h20_flpr>` pages).
+* As an additional core in a multicore system using Zephyr in multithreaded mode (see the :ref:`nRF54L<vpr_flpr_nrf54l>` and :ref:`nRF54H20 devices<ug_nrf54h20_flpr>` pages).
 * As a peripheral emulator, using one of the following methods depending on the use case:
 
   * :ref:`High-Performance Framework (HPF)<hpf_index>`
@@ -60,7 +60,7 @@ For detailed comparison see the :ref:`ug_hpf_softperipherals_comparison` page.
      - Handles simple data pre-processing or post-processing based on specific protocol needs.
      - Not supported.
    * - Maturity level
-     - Experimental (nRF54L15 and nRF54H20)
+     - Experimental (nRF54L15, nRF54LM20, and nRF54H20)
      - Experimental (nRF54L15)
      - Supported (see :ref:`nrfxlib:soft_peripherals` documentation for the list of supported devices)
    * - Example use case

doc/nrf/app_dev/device_guides/nrf54l/building_nrf54l.rst

@@ -1,17 +1,16 @@
 .. _building_nrf54l:
 
-Building and programming with nRF54L15 DK
-#########################################
+Building and programming with nRF54L SoC series
+###############################################
 
 .. contents::
    :local:
    :depth: 2
 
 .. note::
-   The FLPR core support in the |NCS| is currently :ref:`experimental<software_maturity>`.
-   Additionally, it is not yet available for the nRF54L05 and nRF54L10 SoCs.
+   Refer to the :ref:`VPR support table<vpr_flpr_nrf54l_support_status>` for availability and maturity of FLPR targets.
 
-This guide provides instructions on how to build and program the nRF54L15 development kit.
+This guide provides instructions on how to build and program the nRF54L Series development kits.
 Whether you are working with single or multi-image builds, the following sections will guide you through the necessary steps.
 
 Depending on the sample, you must program only the application core or both the Fast Lightweight Peripheral Processor (FLPR) and the application core.
@@ -36,10 +35,12 @@ Using the FLPR core also requires additional configuration to enable it.
 This section outlines how to build and program for both the application and FLPR core, covering separate builds and sysbuild configurations.
 The FLPR core supports two variants:
 
-* ``nrf54l15dk/nrf54l15/cpuflpr``, where FLPR runs from SRAM, which is the recommended method.
+* ``<board target>/cpuflpr``, where *board target* depends on the device you are using.
+  In this variant, FLPR runs from SRAM, which is the recommended method.
   To build FLPR image with this variant, the application core image must include the ``nordic-flpr`` :ref:`snippet <app_build_snippets>`.
 
-* ``nrf54l15dk/nrf54l15/cpuflpr/xip``, where FLPR runs from RRAM.
+* ``<board target>/cpuflpr/xip``, where *board target* depends on the device you are using.
+  In this variant, FLPR runs from RRAM.
   To build FLPR image with this variant, the application core image must include the ``nordic-flpr-xip`` snippet.
 
 Standard build
@@ -57,13 +58,13 @@ Complete the following steps:
 
    .. group-tab:: Using minimal sample for VPR bootstrapping
 
-      This option automatically programs the FLPR core with :ref:`dedicated bootstrapping firmware <vpr_flpr_nrf54l15_initiating>`.
+      This option automatically programs the FLPR core with :ref:`dedicated bootstrapping firmware <vpr_flpr_nrf54l_initiating>`.
 
       To build and flash both images, run the following command that performs a :ref:`pristine build <zephyr:west-building>`:
 
-      .. code-block:: console
+      .. parsed-literal::
 
-         west build -p -b nrf54l15dk/nrf54l15/cpuflpr
+         west build -p -b *board target*
          west flash
 
    .. group-tab:: Using application that supports multi-image builds
@@ -74,16 +75,16 @@ Complete the following steps:
 
       To build and flash both images, run the following command that performs a :ref:`pristine build <zephyr:west-building>`:
 
-      .. code-block:: console
+      .. parsed-literal::
 
-         west build -p -b nrf54l15dk/nrf54l15/cpuflpr -- -DSB_CONFIG_VPR_LAUNCHER=n
+         west build -p -b *board target* -- -DSB_CONFIG_VPR_LAUNCHER=n
          west flash
 
 Separate images
 ---------------
 
 You can build and program application sample and the FLPR sample as separate images using |nRFVSC| or command line.
-To use nRF Util, see `Programming application firmware on the nRF54L15 SoC`_.
+To use nRF Util, see `Programming application firmware on the nRF54L SoCs`_.
 Depending on the selected method, complete the following steps:
 
 .. tabs::
@@ -99,15 +100,15 @@ Depending on the selected method, complete the following steps:
 
       3. Build the application image by setting the following options:
 
-         * Board target to ``nrf54l15dk/nrf54l15/cpuapp``.
+         * Appropriate board target, depending on the device you are using.
          * Choose either ``nordic-flpr`` or ``nordic-flpr-xip`` snippet depending on the FLPR image target.
          * System build to :guilabel:`No sysbuild`.
 
          For more information, see :ref:`cmake_options`.
 
       #. Build the FLPR image by setting the following options:
 
-         * Board target to ``nrf54l15dk/nrf54l15/cpuflpr`` (recommended) or ``nrf54l15dk/nrf54l15/cpuflpr/xip``.
+         * Board target to ``board target/cpuflpr`` (recommended) or ``board target/cpuflpr/xip``.
          * System build to :guilabel:`No sysbuild`.
 
          For more information, see :ref:`cmake_options`.
@@ -117,9 +118,9 @@ Depending on the selected method, complete the following steps:
       1. |open_terminal_window_with_environment|
       #. Build the application core image, and based on your build target include the appropriate snippet:
 
-         .. code-block:: console
+         .. parsed-literal::
 
-            west build -p -b nrf54l15dk/nrf54l15/cpuapp -S nordic-flpr --no-sysbuild
+            west build -p -b *board target* -S nordic-flpr --no-sysbuild
 
       #. Program the application core image by running the `west flash` command :ref:`without --erase <programming_params_no_erase>`.
 
@@ -129,9 +130,9 @@ Depending on the selected method, complete the following steps:
 
       #. Build the FLPR core image:
 
-         .. code-block:: console
+         .. parsed-literal::
 
-            west build -p -b nrf54l15dk/nrf54l15/cpuflpr --no-sysbuild
+            west build -p -b *board target* --no-sysbuild
 
          You can also customize the command for additional options, by adding :ref:`build parameters <optional_build_parameters>`.
 

doc/nrf/app_dev/device_guides/nrf54l/index.rst

@@ -20,7 +20,9 @@ Zephyr and the |NCS| provide support and contain board definitions for developin
      - Product pages
    * - :zephyr:board:`nrf54l15dk`
      - PCA10156
-     - ``nrf54l15dk/nrf54l15/cpuapp``
+     - | ``nrf54l15dk/nrf54l15/cpuapp``
+       | ``nrf54l15dk/nrf54l15/cpuflpr``
+       | ``nrf54l15dk/nrf54l15/cpuflpr/xip``
      - | `Datasheet <nRF54L15 Datasheet_>`_
        | `Quick Start app`_
        | `User Guide <nRF54L15 DK User Guide_>`_
@@ -36,6 +38,13 @@ Zephyr and the |NCS| provide support and contain board definitions for developin
      - ``nrf54l15dk/nrf54l05/cpuapp``
      - | `Datasheet <nRF54L15 Datasheet_>`_
      - | `nRF54L05 System-on-Chip (SoC) <nRF54L05_>`_
+   * - :zephyr:board:`nrf54lm20dk`
+     - PCA10184
+     - | ``nrf54lm20dk/nrf54lm20/cpuapp``
+       | ``nrf54lm20dk/nrf54lm20/cpuflpr``
+       | ``nrf54lm20dk/nrf54lm20/cpuflpr/xip``
+     - --
+     - --
 
 .. note::
 
@@ -70,7 +79,7 @@ Make sure to check the revision of your nRF54L15 development kit to see if it is
 
 .. note::
 
-  The supported nRF54L15 DK revisions are functionally equal and use the same board target (``nrf54l15dk/nrf54l15/cpuapp``).
+  The supported nRF54L15 DK revisions are functionally equal and use the same board target (``nrf54l15dk/nrf54l15/cpuapp`` or ``nrf54l15dk/nrf54l15/cpuflpr``).
 
 Refer to the compatibility matrices for the nRF54L Series devices to check the compatibility of various SoC revisions with different versions of the |NCS|:
 

doc/nrf/app_dev/device_guides/nrf54l/nrf54l_signing_with_payload.rst

@@ -118,7 +118,7 @@ See an example of memory partition configuration:
    .. note::
 
       When using the Partition Manager, ensure this partition is reserved for FLPR.
-      The Partition Manager will ignore this setting while allocating space for the application running on CPUAPP, but the :ref:`FLPR minimal sample <vpr_flpr_nrf54l15_initiating>` will still utilize it.
+      The Partition Manager ignores this setting while allocating space for the application running on CPUAPP, but the :ref:`FLPR minimal sample <vpr_flpr_nrf54l_initiating>` will still use it.
 
    * ``cpuflpr_sram_code_data`` - This configuration defines the RAM space reserved only for the FLPR.
      It is not available for the application core and should be excluded from its memory allocation.

doc/nrf/app_dev/device_guides/nrf54l/vpr_flpr.rst

@@ -7,21 +7,62 @@ Working with the FLPR core
    :local:
    :depth: 2
 
-.. note::
-   The FLPR core support in the |NCS| is currently :ref:`experimental<software_maturity>`.
-   Additionally, it is not yet available for the nRF54L05 and nRF54L10 SoCs.
-
-The nRF54L15 SoC has a dedicated VPR CPU (RISC-V architecture), named *fast lightweight peripheral processor* (FLPR).
-The following peripherals are available for use with the FLPR core, and can be accessed through the appropriate Zephyr Device Driver API:
-
-* GPIO
-* GPIOTE
-* GRTC
-* TWIM
-* UARTE
-* VPR
-
-.. _vpr_flpr_nrf54l15_initiating:
+The nRF54L series SoCs have a dedicated VPR CPU (RISC-V architecture), named *fast lightweight peripheral processor* (FLPR).
+
+.. _vpr_flpr_nrf54l_support_status:
+
+FLPR support
+************
+
+The following section provides a support overview for various FLPR targets:
+
+.. list-table::
+   :header-rows: 1
+
+   * - Target
+     - Zephyr build target
+     - Kernel support
+     - Supported drivers
+   * - nRF54L15 FLPR running from SRAM
+     - ``nrf54l15dk/nrf54l15/cpuflpr``
+     - Experimental
+     - * GPIO
+       * GPIOTE
+       * GRTC
+       * TWIM
+       * UARTE
+       * VPR
+   * - nRF54L15 FLPR running from RRAM
+     - ``nrf54l15dk/nrf54l15/cpuflpr/xip``
+     - Experimental
+     - --
+   * - nRF54L05 FLPR running from SRAM
+     - Not available
+     - -
+     - -
+   * - nRF54L05 FLPR running from RRAM
+     - Not available
+     - -
+     - -
+   * - nRF54L10 FLPR running from SRAM
+     - Not available
+     - -
+     - -
+   * - nRF54L10 FLPR running from RRAM
+     - Not available
+     - -
+     - -
+   * - nRF54LM20 FLPR running from SRAM
+     - ``nrf54lm20dk/nrf54lm20/cpuflpr``
+     - Experimental
+     - --
+   * - nRF54LM20 FLPR running from RRAM
+     - ``nrf54lm20dk/nrf54lm20/cpuflpr/xip``
+     - Experimental
+     - --
+
+
+.. _vpr_flpr_nrf54l_initiating:
 
 Using FLPR with Zephyr multithreaded mode
 *****************************************
@@ -36,7 +77,7 @@ Bootstrapping the FLPR core
 The |NCS| provides an FLPR snippet that adds an overlay required for bootstrapping the FLPR core.
 Snippet's primary function is to enable the code that transfers the FLPR code to the designated region (if necessary) and to initiate the FLPR core.
 
-When building for the ``nrf54l15dk/nrf54l15/cpuflpr`` target, a minimal sample is automatically loaded onto the application core.
+When building for the ``<board target>/cpuflpr`` or ``<board target>/cpuflpr/xip``, where *board target* depends on the device you are using, a minimal sample is automatically loaded onto the application core.
 See more information on :ref:`building_nrf54l_app_flpr_core`.
 
 Peripherals emulation on FLPR

doc/nrf/includes/sample_board_rows.txt

@@ -254,6 +254,11 @@
 
 | :ref:`nRF54L15 DK <ug_nrf54l>` | PCA10156 | :zephyr:board:`nrf54l15dk <nrf54l15dk>` | ``nrf54l15dk/nrf54l15/cpuflpr`` |
 
+.. nrf54l15dk_nrf54l15_cpuflpr_xip
+
+| :ref:`nRF54L15 DK <ug_nrf54l>` | PCA10156 | :zephyr:board:`nrf54l15dk <nrf54l15dk>` |
+``nrf54l15dk/nrf54l15/cpuflpr/xip`` |
+
 .. nrf54lv10dk_nrf54lv10a_cpuapp
 
 | nRF54LV10 DK |   | nrf54lv10dk | ``nrf54lv10dk/nrf54lv10a/cpuapp`` |
@@ -265,3 +270,11 @@
 .. nrf54lm20dk_nrf54lm20a_cpuapp
 
 | nRF54LM20 DK |   | nrf54lm20dk | ``nrf54lm20dk/nrf54lm20a/cpuapp`` |
+
+.. nrf54lm20dk_nrf54lm20a_cpuflpr
+
+| nRF54LM20 DK |   | nrf54lm20dk | ``nrf54lm20dk/nrf54lm20a/cpuflpr`` |
+
+.. nrf54lm20dk_nrf54lm20a_cpuflpr_xip
+
+| nRF54LM20 DK |   | nrf54lm20dk | ``nrf54lm20dk/nrf54lm20a/cpuflpr/xip`` |

doc/nrf/links.txt

@@ -956,7 +956,7 @@
 .. _`Device command overview`: https://docs.nordicsemi.com/bundle/nrfutil/page/nrfutil-device/guides/programming.html
 .. _`Programming application firmware using MCUboot serial recovery`: https://docs.nordicsemi.com/bundle/nrfutil/page/nrfutil-device/guides/programming_firmware_thingy91.html
 .. _`Programming modem firmware using MCUboot serial recovery`: https://docs.nordicsemi.com/bundle/nrfutil/page/nrfutil-device/guides/programming_firmware_thingy91.html
-.. _`Programming application firmware on the nRF54L15 SoC`: https://docs.nordicsemi.com/bundle/nrfutil/page/nrfutil-device/guides/programming_nrf54L15.html
+.. _`Programming application firmware on the nRF54L SoCs`: https://docs.nordicsemi.com/bundle/nrfutil/page/nrfutil-device/guides/programming_nrf54L15.html
 .. _`Upgrading modem firmware using J-Link`: https://docs.nordicsemi.com/bundle/nrfutil/page/nrfutil-device/guides/programming_modem_9160.html
 .. _`Provisioning keys for hardware KMU`: https://docs.nordicsemi.com/bundle/nrfutil/page/nrfutil-device/guides/provisioning_keys.html