1.. _nrf54h20dk_nrf54h20:
2
3nRF54H20 DK
4###########
5
6Overview
7********
8
9.. note::
10
11   All software for the nRF54H20 SoC is experimental and hardware availability
12   is restricted to the participants in the limited sampling program.
13
14The nRF54H20 DK is a single-board development kit for evaluation and development
15on the Nordic nRF54H20 System-on-Chip (SoC).
16
17The nRF54H20 is a multicore SoC with:
18
19* an Arm Cortex-M33 core with DSP instructions, FPU, and Armv8-M Security
20  Extensions, running at up to 320 MHz, referred to as the **application core**
21* an Arm Cortex-M33 core with DSP instructions, FPU, and Armv8-M Security
22  Extensions, running at up to 256 MHz, referred to as the **radio core**.
23* a Nordic VPR RISC-V core, referred to as the **ppr core** (Peripheral
24  Processor).
25
26The ``nrf54h20dk/nrf54h20/cpuapp`` build target provides support for
27the application core on the nRF54H20 SoC.
28The ``nrf54h20dk/nrf54h20/cpurad`` build target provides support for
29the radio core on the nRF54H20 SoC.
30The ``nrf54h20dk/nrf54h20/cpuppr`` build target provides support for
31the PPR core on the nRF54H20 SoC executing from RAM.
32The ``nrf54h20dk/nrf54h20/cpuppr/xip`` build target provides support for
33the PPR core on the nRF54H20 SoC executing from MRAM.
34
35nRF54H20 SoC provides support for the following devices:
36
37* :abbr:`ADC (Analog to Digital Converter)`
38* CLOCK
39* :abbr:`GPIO (General Purpose Input Output)`
40* :abbr:`GRTC (Global real-time counter)`
41* :abbr:`I2C (Inter-Integrated Circuit)`
42* MEMCONF
43* MRAM
44* :abbr:`PWM (Pulse Width Modulation)`
45* RADIO (Bluetooth Low Energy and 802.15.4)
46* :abbr:`SPI (Serial Peripheral Interface)`
47* :abbr:`UART (Universal asynchronous receiver-transmitter)`
48* :abbr:`USB (Universal Serial Bus)`
49* :abbr:`WDT (Watchdog Timer)`
50
51Hardware
52********
53
54nRF54H20 DK has two crystal oscillators:
55
56* High-frequency 32 MHz crystal oscillator (HFXO)
57* Low-frequency 32.768 kHz crystal oscillator (LFXO)
58
59Supported Features
60==================
61
62The ``nrf54h20dk/nrf54h20/cpuapp`` board configuration supports the following
63hardware features:
64
65+-----------+------------+----------------------+
66| Interface | Controller | Driver/Component     |
67+===========+============+======================+
68| GPIO      | on-chip    | gpio                 |
69+-----------+------------+----------------------+
70| GRTC      | on-chip    | system clock         |
71+-----------+------------+----------------------+
72| I2C(M)    | on-chip    | i2c                  |
73+-----------+------------+----------------------+
74| MEMCONF   | on-chip    | retained_mem         |
75+-----------+------------+----------------------+
76| SPI(M/S)  | on-chip    | spi                  |
77+-----------+------------+----------------------+
78| UART      | on-chip    | serial               |
79+-----------+------------+----------------------+
80| WDT       | on-chip    | watchdog             |
81+-----------+------------+----------------------+
82
83The ``nrf54h20dk/nrf54h20/cpurad`` board configuration supports the following
84hardware features:
85
86+-----------+------------+----------------------+
87| Interface | Controller | Driver/Component     |
88+===========+============+======================+
89| GPIO      | on-chip    | gpio                 |
90+-----------+------------+----------------------+
91| GRTC      | on-chip    | system clock         |
92+-----------+------------+----------------------+
93| I2C(M)    | on-chip    | i2c                  |
94+-----------+------------+----------------------+
95| MEMCONF   | on-chip    | retained_mem         |
96+-----------+------------+----------------------+
97| SPI(M/S)  | on-chip    | spi                  |
98+-----------+------------+----------------------+
99| UART      | on-chip    | serial               |
100+-----------+------------+----------------------+
101| WDT       | on-chip    | watchdog             |
102+-----------+------------+----------------------+
103
104Other hardware features have not been enabled yet for this board.
105
106Connections and IOs
107===================
108
109LEDs
110----
111
112* LED1 (green) = P9.0
113* LED2 (green) = P9.1
114* LED3 (green) = P9.2
115* LED4 (green) = P9.3
116
117Push buttons
118------------
119
120* BUTTON1 = P0.8
121* BUTTON2 = P0.9
122* BUTTON3 = P0.10
123* BUTTON4 = P0.11
124* RESET (SW1)
125
126Programming and Debugging
127*************************
128
129Applications for all targets can be built and flashed the usual way.
130See :ref:`build_an_application` and :ref:`application_run` for more details on
131building and running. Debugging is for now limited to the application and radio
132cores only, using :ref:`nordic_segger`.
133
134Flashing
135========
136
137As an example, this section shows how to build and flash the :zephyr:code-sample:`hello_world`
138application.
139
140To build and program the sample to the nRF54H20 DK, complete the following steps:
141
1421. Connect the nRF54H20 DK to your computer using the IMCU USB port on the DK.
1432. Install `nRF Util`_
144#. Build the sample by running the following command:
145
146   .. zephyr-app-commands::
147      :zephyr-app: samples/hello_world
148      :board: nrf54h20dk/nrf54h20/cpuapp
149      :goals: build flash
150
151Testing the LEDs and buttons in the nRF54H20 DK
152***********************************************
153
154There are 2 samples that allow you to test that the buttons (switches) and LEDs
155on the board are working properly with Zephyr:
156
157* :zephyr:code-sample:`blinky`
158* :zephyr:code-sample:`button`
159
160You can build and flash the examples to make sure Zephyr is running correctly on
161your board. The button and LED definitions can be found in
162:zephyr_file:`boards/nordic/nrf54h20dk/nrf54h20dk_nrf54h20_cpuapp.dts`.
163
164.. _nRF Util:
165   https://www.nordicsemi.com/Products/Development-tools/nrf-util
166