Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

doc: Added nRF54L05 and nRF54L10 snippets #18090

Merged
merged 1 commit into from
Oct 23, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions doc/nrf/app_dev/device_guides/nrf54l/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -35,3 +35,4 @@ Zephyr and the |NCS| provide support and contain board definitions for developin
features
cryptography
testing_dfu
snippets
92 changes: 92 additions & 0 deletions doc/nrf/app_dev/device_guides/nrf54l/snippets.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,92 @@
.. _nRF54l_snippets:

Snippets for nRF54L05 and nRF54L10
##################################

.. contents::
:local:
:depth: 2

You can emulate the nRF54L05 and nRF54L10 targets on an nRF54L15 device using the following snippets:

.. list-table::
:header-rows: 1

* - Functionality
- Snippet name
- Compatible board targets
* - :ref:`emulated-nrf54l05`
- ``emulated-nrf54l05``
- ``nrf54l15dk/nrf54l15/cpuapp``, ``nrf54l15dk/nrf54l15/cpuapp/ns``
* - :ref:`emulated-nrf54l10`
- ``emulated-nrf54l10``
- ``nrf54l15dk/nrf54l15/cpuapp``, ``nrf54l15dk/nrf54l15/cpuapp/ns``

.. important::
You cannot use these snippets with the FLPR core because all memory, including RAM and RRAM, is allocated to the application core.

Currently, using the snippets is supported only on the :ref:`zephyr:nrf54l15dk_nrf54l15` board.

.. _emulated-nrf54l05:

nRF54L05 snippet
****************

The ``emulated-nrf54l05`` snippet emulates the nRF54L05 target on an nRF54L15 device.

You have the following options to add the ``emulated-nrf54l05`` snippet to the :term:`build configuration`:

.. tabs::

.. group-tab:: west

When building with west, use the following command pattern, where *board_target* corresponds to your board target and `<image_name>` to your application image name:

.. parsed-literal::
:class: highlight

west build --board *board_target* -- -D<image_name>_SNIPPET="emulated-nrf54l05"

.. group-tab:: CMake

When building with CMake, add the following command to the CMake arguments:

.. code-block:: console

-D<image_name>_SNIPPET="emulated-nrf54l05" [...]

To build with the |nRFVSC|, specify ``-D<image_name>_SNIPPET="emulated-nrf54l05" [...]`` in the **Extra CMake arguments** field.

See :ref:`cmake_options` for more details.

.. _emulated-nrf54l10:

nRF54L10 snippet
****************

The ``emulated-nrf54l10`` snippet emulates the nRF54L10 target on an nRF54L15 device.

You have the following options to add the ``emulated-nrf54l10`` snippet to the :term:`build configuration`:

.. tabs::

.. group-tab:: west

When building with west, use the following command pattern, where *board_target* corresponds to your board target and `<image_name>` to your application image name:

.. parsed-literal::
:class: highlight

west build --board *board_target* -- -D<image_name>_SNIPPET="emulated-nrf54l10"

.. group-tab:: CMake

When building with CMake, add the following command to the CMake arguments:

.. code-block:: console

-D<image_name>_SNIPPET="emulated-nrf54l10" [...]

To build with the |nRFVSC|, specify ``-D<image_name>_SNIPPET="emulated-nrf54l10" [...]`` in the **Extra CMake arguments** field.

See :ref:`cmake_options` for more details.
Original file line number Diff line number Diff line change
Expand Up @@ -114,7 +114,12 @@ Working with nRF54H Series
Developing with nRF54L Series
=============================

* Added the :ref:`ug_nrf54l_cryptography` page, providing more information about the cryptographic peripherals of the nRF54L Series devices, the programming model for referencing keys, and the configuration.
* Added:

* :ref:`nRF54l_snippets` to emulate these targets on an nRF54L15 DK.
divipillai marked this conversation as resolved.
Show resolved Hide resolved
These are used only for development purposes.
* The :ref:`ug_nrf54l_cryptography` page that provides more information about the cryptographic peripherals of the nRF54L Series devices, programming model for referencing keys, and configuration.

* Updated the name and the structure of the section, with :ref:`ug_nrf54l` as the landing page.
* Removed the Getting started with the nRF54L15 PDK page, and instead included the information about the `Quick Start`_ app support.

Expand Down
Loading