1.. _nrf54l15dk_nrf54l15:
2
3nRF54L15 DK
4############
5
6Overview
7********
8
9.. note::
10   You can find more information about the nRF54L15 SoC on the `nRF54L15 website`_.
11   For the nRF54L15 technical documentation and other resources (such as
12   SoC Datasheet), see the `nRF54L15 documentation`_ page.
13
14The nRF54L15 Development Kit hardware provides support for the Nordic Semiconductor
15nRF54L15 Arm Cortex-M33 CPU and the following devices:
16
17* :abbr:`SAADC (Successive Approximation Analog to Digital Converter)`
18* CLOCK
19* RRAM
20* :abbr:`GPIO (General Purpose Input Output)`
21* :abbr:`TWIM (I2C-compatible two-wire interface master with EasyDMA)`
22* MEMCONF
23* :abbr:`MPU (Memory Protection Unit)`
24* :abbr:`NVIC (Nested Vectored Interrupt Controller)`
25* :abbr:`PWM (Pulse Width Modulation)`
26* :abbr:`GRTC (Global real-time counter)`
27* Segger RTT (RTT Console)
28* :abbr:`SPI (Serial Peripheral Interface)`
29* :abbr:`UARTE (Universal asynchronous receiver-transmitter)`
30* :abbr:`WDT (Watchdog Timer)`
31
32.. figure:: img/nrf54l15dk_nrf54l15.webp
33     :align: center
34     :alt: nRF54L15 DK
35
36     nRF54L15 DK (Credit: Nordic Semiconductor)
37
38Hardware
39********
40
41nRF54L15 DK has two crystal oscillators:
42
43* High-frequency 32 MHz crystal oscillator (HFXO)
44* Low-frequency 32.768 kHz crystal oscillator (LFXO)
45
46The crystal oscillators can be configured to use either
47internal or external capacitors.
48
49Supported Features
50==================
51
52The ``nrf54l15dk/nrf54l15/cpuapp`` board target configuration supports the following
53hardware features:
54
55+-----------+------------+----------------------+
56| Interface | Controller | Driver/Component     |
57+===========+============+======================+
58| CLOCK     | on-chip    | clock_control        |
59+-----------+------------+----------------------+
60| GPIO      | on-chip    | gpio                 |
61+-----------+------------+----------------------+
62| GRTC      | on-chip    | counter              |
63+-----------+------------+----------------------+
64| MEMCONF   | on-chip    | retained_mem         |
65+-----------+------------+----------------------+
66| MPU       | on-chip    | arch/arm             |
67+-----------+------------+----------------------+
68| NVIC      | on-chip    | arch/arm             |
69+-----------+------------+----------------------+
70| PWM       | on-chip    | pwm                  |
71+-----------+------------+----------------------+
72| RRAM      | on-chip    | flash                |
73+-----------+------------+----------------------+
74| RTT       | Segger     | console              |
75+-----------+------------+----------------------+
76| SAADC     | on-chip    | adc                  |
77+-----------+------------+----------------------+
78| SPI(M/S)  | on-chip    | spi                  |
79+-----------+------------+----------------------+
80| SPU       | on-chip    | system protection    |
81+-----------+------------+----------------------+
82| TWIM      | on-chip    | i2c                  |
83+-----------+------------+----------------------+
84| UARTE     | on-chip    | serial               |
85+-----------+------------+----------------------+
86| WDT       | on-chip    | watchdog             |
87+-----------+------------+----------------------+
88
89Other hardware features have not been enabled yet for this board.
90
91Programming and Debugging
92*************************
93
94Applications for the ``nrf54l15dk/nrf54l15/cpuapp`` board target can be
95built, flashed, and debugged in the usual way. See
96:ref:`build_an_application` and :ref:`application_run` for more details on
97building and running.
98
99Applications for the ``nrf54l15dk/nrf54l15/cpuflpr`` board target need
100to be built as multicore configuration with code snippet called ``vpr_launcher``
101for the application core.
102
103Enter the following command to compile ``hello_world`` for the FLPR core::
104 west build -p -b nrf54l15dk/nrf54l15/cpuflpr --sysbuild -- -DSB_VPR_LAUNCHER=y
105
106Flashing
107========
108
109As an example, this section shows how to build and flash the :zephyr:code-sample:`hello_world`
110application.
111
112.. warning::
113
114   When programming the device, you might get an error similar to the following message::
115
116    ERROR: The operation attempted is unavailable due to readback protection in
117    ERROR: your device. Please use --recover to unlock the device.
118
119   This error occurs when readback protection is enabled.
120   To disable the readback protection, you must *recover* your device.
121
122   Enter the following command to recover the core::
123
124    west flash --recover
125
126   The ``--recover`` command erases the flash memory and then writes a small binary into
127   the recovered flash memory.
128   This binary prevents the readback protection from enabling itself again after a pin
129   reset or power cycle.
130
131Follow the instructions in the :ref:`nordic_segger` page to install
132and configure all the necessary software. Further information can be
133found in :ref:`nordic_segger_flashing`.
134
135To build and program the sample to the nRF54L15 DK, complete the following steps:
136
137First, connect the nRF54L15 DK to you computer using the IMCU USB port on the DK.
138Next, build the sample by running the following command:
139
140.. zephyr-app-commands::
141   :zephyr-app: samples/hello_world
142   :board: nrf54l15dk/nrf54l15/cpuapp
143   :goals: build flash
144
145Testing the LEDs and buttons in the nRF54L15 DK
146************************************************
147
148Test the nRF54L15 DK with a :zephyr:code-sample:`blinky` sample.
149
150
151.. _nRF54L15 website: https://www.nordicsemi.com/Products/nRF54L15
152.. _nRF54L15 documentation: https://docs.nordicsemi.com/bundle/ncs-latest/page/nrf/app_dev/device_guides/nrf54l/index.html
153
154.. _nrf54l15dk_nrf54l05:
155
156nRF54L05 emulation on nRF54L15 DK
157#################################
158
159Overview
160********
161
162The ``nrf54l15dk/nrf54l05`` board is a modified version of the :ref:`nrf54l15dk_nrf54l15`
163that enforces the limitations imposed by the nRF54L05 IC, which is a
164cost-reduced variant of the original nRF54L15. Since Nordic does not offer a
165development kit for the nRF54L05, you can use this board to develop for this
166IC while using the nRF54L15 Development Kit (PCA10156).
167
168See :ref:`nrf54l15dk_nrf54l15` for more information about the development board and
169`nRF54L05 website`_ for the official reference on the IC itself.
170
171.. _nRF54L05 website: https://www.nordicsemi.com/Products/nRF54L05
172
173.. _nrf54l15dk_nrf54l10:
174
175nRF54L10 emulation on nRF54L15 DK
176#################################
177
178Overview
179********
180
181The ``nrf54l15dk/nrf54l10`` board is a modified version of the :ref:`nrf54l15dk_nrf54l15`
182that enforces the limitations imposed by the nRF54L10 IC, which is a
183cost-reduced variant of the original nRF54L15. Since Nordic does not offer a
184development kit for the nRF54L10 you can use this board to develop for this
185IC while using the nRF54L15 Development Kit (PCA10156).
186
187See :ref:`nrf54l15dk_nrf54l15` for more information about the development board and
188`nRF54L10 website`_ for the official reference on the IC itself.
189
190.. _nRF54L10 website: https://www.nordicsemi.com/Products/nRF54L10
191