1.. _nrf52dk_nrf52832:
2
3nRF52 DK
4########
5
6Overview
7********
8
9The nRF52 Development Kit (PCA10040) hardware provides
10support for the Nordic Semiconductor nRF52832 ARM Cortex-M4F CPU and
11the following devices:
12
13* :abbr:`ADC (Analog to Digital Converter)`
14* CLOCK
15* FLASH
16* :abbr:`GPIO (General Purpose Input Output)`
17* :abbr:`I2C (Inter-Integrated Circuit)`
18* :abbr:`MPU (Memory Protection Unit)`
19* :abbr:`NVIC (Nested Vectored Interrupt Controller)`
20* :abbr:`PWM (Pulse Width Modulation)`
21* RADIO (Bluetooth Low Energy)
22* :abbr:`RTC (nRF RTC System Clock)`
23* Segger RTT (RTT Console)
24* :abbr:`SPI (Serial Peripheral Interface)`
25* :abbr:`UART (Universal asynchronous receiver-transmitter)`
26* :abbr:`WDT (Watchdog Timer)`
27
28.. figure:: img/nrf52dk_nrf52832.jpg
29     :align: center
30     :alt: nRF52 DK
31
32     nRF52 DK (Credit: Nordic Semiconductor)
33
34More information about the board can be found at the
35`nRF52 DK website`_. `nRF52832 Product Specification`_
36contains the processor's information and the datasheet.
37
38
39Hardware
40********
41
42nRF52 DK has two external oscillators. The frequency of
43the slow clock is 32.768 kHz. The frequency of the main clock
44is 32 MHz.
45
46Supported Features
47==================
48
49The ``nrf52dk/nrf52832`` board configuration supports the following
50hardware features:
51
52+-----------+------------+----------------------+
53| Interface | Controller | Driver/Component     |
54+===========+============+======================+
55| ADC       | on-chip    | adc                  |
56+-----------+------------+----------------------+
57| CLOCK     | on-chip    | clock_control        |
58+-----------+------------+----------------------+
59| FLASH     | on-chip    | flash                |
60+-----------+------------+----------------------+
61| GPIO      | on-chip    | gpio                 |
62+-----------+------------+----------------------+
63| I2C(M)    | on-chip    | i2c                  |
64+-----------+------------+----------------------+
65| MPU       | on-chip    | arch/arm             |
66+-----------+------------+----------------------+
67| NVIC      | on-chip    | arch/arm             |
68+-----------+------------+----------------------+
69| PWM       | on-chip    | pwm                  |
70+-----------+------------+----------------------+
71| RADIO     | on-chip    | Bluetooth            |
72+-----------+------------+----------------------+
73| RTC       | on-chip    | system clock         |
74+-----------+------------+----------------------+
75| RTT       | Segger     | console              |
76+-----------+------------+----------------------+
77| SPI(M/S)  | on-chip    | spi                  |
78+-----------+------------+----------------------+
79| UART      | on-chip    | serial               |
80+-----------+------------+----------------------+
81| WDT       | on-chip    | watchdog             |
82+-----------+------------+----------------------+
83
84Other hardware features have not been enabled yet for this board.
85See `nRF52 DK website`_ and `nRF52832 Product Specification`_
86for a complete list of nRF52 Development Kit board hardware features.
87
88Connections and IOs
89===================
90
91LED
92---
93
94* LED1 (green) = P0.17
95* LED2 (green) = P0.18
96* LED3 (green) = P0.19
97* LED4 (green) = P0.20
98* LD5 (red/green) = OB LED 1/2
99
100Push buttons
101------------
102
103* BUTTON1 = SW1 = P0.13
104* BUTTON2 = SW2 = P0.14
105* BUTTON3 = SW3 = P0.15
106* BUTTON4 = SW4 = P0.16
107* BOOT = SW5 = boot/reset
108
109External Connectors
110-------------------
111
112J-Link Prog Connector
113
114+-------+--------------+
115| PIN # | Signal Name  |
116+=======+==============+
117| 1     | VDD          |
118+-------+--------------+
119| 2     | IMCU_TMSS    |
120+-------+--------------+
121| 3     | GND          |
122+-------+--------------+
123| 4     | IMCU_TCKS    |
124+-------+--------------+
125| 5     | V5V          |
126+-------+--------------+
127| 6     | IMCU_TDOS    |
128+-------+--------------+
129| 7     | Cut off      |
130+-------+--------------+
131| 8     | IMCU_TDIS    |
132+-------+--------------+
133| 9     | Cut off      |
134+-------+--------------+
135| 10    | IMCU_RESET   |
136+-------+--------------+
137
138Debug IN
139
140+-------+--------------+-------------------------+
141| PIN # | Signal Name  | NRF52832 Functions      |
142+=======+==============+=========================+
143| 1     | VDD          | N/A                     |
144+-------+--------------+-------------------------+
145| 2     | SWDIO        | SWDIO                   |
146+-------+--------------+-------------------------+
147| 3     | GND          | N/A                     |
148+-------+--------------+-------------------------+
149| 4     | SWDCLK       | SWDCLK                  |
150+-------+--------------+-------------------------+
151| 5     | GND          | N/A                     |
152+-------+--------------+-------------------------+
153| 6     | P0.18        | P0.18 / TRACEDATA[0] /  |
154|       |              | SWO                     |
155+-------+--------------+-------------------------+
156| 7     | Cut off      | N/A                     |
157+-------+--------------+-------------------------+
158| 8     | Cut off      | N/A                     |
159+-------+--------------+-------------------------+
160| 9     | GND          | N/A                     |
161+-------+--------------+-------------------------+
162| 10    | P0.21        | P0.21 / RESET           |
163+-------+--------------+-------------------------+
164
165Debug OUT
166
167+-------+----------------+
168| PIN # | Signal Name    |
169+=======+================+
170| 1     | EXT_VTG        |
171+-------+----------------+
172| 2     | EXT_SWDIO      |
173+-------+----------------+
174| 3     | GND            |
175+-------+----------------+
176| 4     | EXT_SWDCLK     |
177+-------+----------------+
178| 5     | GND            |
179+-------+----------------+
180| 6     | EXT_SWO        |
181|       |                |
182+-------+----------------+
183| 7     | Cut off        |
184+-------+----------------+
185| 8     | Cut off        |
186+-------+----------------+
187| 9     | EXT_GND_DETECT |
188+-------+----------------+
189| 10    | EXT_RESET      |
190+-------+----------------+
191
192Shield Debug and Current measurement
193
194+-------+----------------+
195| PIN # | Signal Name    |
196+=======+================+
197| 1     | VDD_nRF        |
198+-------+----------------+
199| 2     | VDD            |
200+-------+----------------+
201| 3     | SH_VTG         |
202+-------+----------------+
203| 4     | SH_SWDIO       |
204+-------+----------------+
205| 5     | SH_SWDCLK      |
206+-------+----------------+
207| 6     | SH_SWO         |
208+-------+----------------+
209| 7     | SH_RESET       |
210+-------+----------------+
211| 8     | SH_GND_DETECT  |
212+-------+----------------+
213
214Auxiliary
215
216+-------+--------------+-------------------------+
217| PIN # | Signal Name  | NRF52832 Functions      |
218+=======+==============+=========================+
219| 1     | P0.00        | P0.00 / XL1             |
220+-------+--------------+-------------------------+
221| 2     | P0.01        | P0.01 / XL2             |
222+-------+--------------+-------------------------+
223| 3     | P0.21        | P0.21 / RESET           |
224+-------+--------------+-------------------------+
225| 4     | P0.05_C      | P0.05 / AIN3            |
226+-------+--------------+-------------------------+
227| 5     | P0.06_C      | P0.06                   |
228+-------+--------------+-------------------------+
229| 6     | P0.07_C      | P0.07                   |
230+-------+--------------+-------------------------+
231| 7     | P0.08_C      | P0.08                   |
232+-------+--------------+-------------------------+
233| 8     | P0.09        | P0.09 / NFC1            |
234+-------+--------------+-------------------------+
235| 9     | P0.10        | P0.10 / NFC2            |
236+-------+--------------+-------------------------+
237
238Arduino Headers
239---------------
240
241P1/P7 Power
242
243+-------+--------------+-------------------------+
244| PIN # | Signal Name  | NRF52832 Functions      |
245+=======+==============+=========================+
246| 1     | VDD          | N/A                     |
247+-------+--------------+-------------------------+
248| 2     | VDD          | N/A                     |
249+-------+--------------+-------------------------+
250| 3     | RESET        | P0.21 / RESET           |
251+-------+--------------+-------------------------+
252| 4     | VDD          | N/A                     |
253+-------+--------------+-------------------------+
254| 5     | V5V          | N/A                     |
255+-------+--------------+-------------------------+
256| 6     | GND          | N/A                     |
257+-------+--------------+-------------------------+
258| 7     | GND          | N/A                     |
259+-------+--------------+-------------------------+
260| 8     | VIN          | N/A                     |
261+-------+--------------+-------------------------+
262
263P2/P8 Analog in
264
265+-------+--------------+-------------------------+
266| PIN # | Signal Name  | NRF52832 Functions      |
267+=======+==============+=========================+
268| 1     | A0           | P0.03 / AIN1            |
269+-------+--------------+-------------------------+
270| 2     | A1           | P0.04 / AIN2            |
271+-------+--------------+-------------------------+
272| 3     | A2           | P0.28 / AIN4            |
273+-------+--------------+-------------------------+
274| 4     | A3           | P0.29 / AIN5            |
275+-------+--------------+-------------------------+
276| 5     | A4           | P0.30 / AIN6            |
277+-------+--------------+-------------------------+
278| 6     | A5           | P0.31 / AIN7            |
279+-------+--------------+-------------------------+
280
281P3/P9 Digital I/O
282
283+-------+--------------+-------------------------+
284| PIN # | Signal Name  | NRF52832 Functions      |
285+=======+==============+=========================+
286| 1     | D0 (RX)      | P0.11                   |
287+-------+--------------+-------------------------+
288| 2     | D1 (TX)      | P0.12                   |
289+-------+--------------+-------------------------+
290| 3     | D2           | P0.13                   |
291+-------+--------------+-------------------------+
292| 4     | D3           | P0.14 / TRACEDATA[3]    |
293+-------+--------------+-------------------------+
294| 5     | D4           | P0.15 / TRACEDATA[2]    |
295+-------+--------------+-------------------------+
296| 6     | D5           | P0.16 / TRACEDATA[1]    |
297+-------+--------------+-------------------------+
298| 7     | D6           | P0.17                   |
299+-------+--------------+-------------------------+
300| 8     | D7           | P0.18 / TRACEDATA[3]  / |
301|       |              | SWO                     |
302+-------+--------------+-------------------------+
303
304P4/P10 Digital I/O
305
306+-------+--------------+-------------------------+
307| PIN # | Signal Name  | NRF52832 Functions      |
308+=======+==============+=========================+
309| 1     | D8           | P0.19                   |
310+-------+--------------+-------------------------+
311| 2     | D9           | P0.20 / TRACECLK        |
312+-------+--------------+-------------------------+
313| 3     | D10 (SS)     | P0.22                   |
314+-------+--------------+-------------------------+
315| 4     | D11 (MOSI)   | P0.23                   |
316+-------+--------------+-------------------------+
317| 5     | D12 (MISO)   | P0.24                   |
318+-------+--------------+-------------------------+
319| 6     | D13 (SCK)    | P0.25                   |
320+-------+--------------+-------------------------+
321| 7     | GND          | N/A                     |
322+-------+--------------+-------------------------+
323| 8     | AREF         | P0.02 / AIN0            |
324+-------+--------------+-------------------------+
325| 9     | SDA          | P0.26                   |
326+-------+--------------+-------------------------+
327| 10    | SCL          | P0.27                   |
328+-------+--------------+-------------------------+
329
330P5/P11
331
332+-------+--------------+-------------------------+
333| PIN # | Signal Name  | NRF52832 Functions      |
334+=======+==============+=========================+
335| 1     | D12 (MISO)   | P0.24                   |
336+-------+--------------+-------------------------+
337| 2     | V5V          | N/A                     |
338+-------+--------------+-------------------------+
339| 3     | D13 (SCK)    | P0.25                   |
340+-------+--------------+-------------------------+
341| 4     | D11 (MOSI)   | P0.23                   |
342+-------+--------------+-------------------------+
343| 5     | RESET        | N/A                     |
344+-------+--------------+-------------------------+
345| 6     | N/A          | N/A                     |
346+-------+--------------+-------------------------+
347
348Programming and Debugging
349*************************
350
351Flashing
352========
353
354Follow the instructions in the :ref:`nordic_segger` page to install
355and configure all the necessary software. Further information can be
356found in :ref:`nordic_segger_flashing`. Then build and flash
357applications as usual (see :ref:`build_an_application` and
358:ref:`application_run` for more details).
359
360Here is an example for the :zephyr:code-sample:`hello_world` application.
361
362First, run your favorite terminal program to listen for output.
363
364.. code-block:: console
365
366   $ minicom -D <tty_device> -b 115200
367
368Replace :code:`<tty_device>` with the port where the board nRF52 DK
369can be found. For example, under Linux, :code:`/dev/ttyACM0`.
370
371Then build and flash the application in the usual way.
372
373.. zephyr-app-commands::
374   :zephyr-app: samples/hello_world
375   :board: nrf52dk/nrf52832
376   :goals: build flash
377
378Debugging
379=========
380
381Refer to the :ref:`nordic_segger` page to learn about debugging Nordic boards with a
382Segger IC.
383
384
385Testing the LEDs and buttons in the nRF52 DK
386********************************************
387
388There are 2 samples that allow you to test that the buttons (switches) and LEDs on
389the board are working properly with Zephyr:
390
391.. code-block:: console
392
393   samples/basic/blinky
394   samples/basic/button
395
396You can build and flash the examples to make sure Zephyr is running correctly on
397your board. The button and LED definitions can be found in
398:zephyr_file:`boards/nordic/nrf52dk/nrf52dk_nrf52832.dts`.
399
400References
401**********
402
403.. target-notes::
404
405.. _nRF52 DK website: https://www.nordicsemi.com/Software-and-Tools/Development-Kits/nRF52-DK
406.. _nRF52832 Product Specification: https://docs.nordicsemi.com/bundle/ps_nrf52832/page/nrf52832_ps.html
407
408.. _nrf52dk_nrf52805:
409
410nRF52805 emulation on nRF52 DK
411##############################
412
413Overview
414********
415
416The ``nrf52dk/nrf52805`` board is a modified version of the :ref:`nrf52dk_nrf52832`
417that enforces the limitations imposed by the nRF52805 IC, which is a
418cost-reduced variant of the original nRF52832. Since Nordic does not offer a
419development kit for the nRF52805, you can use this board to develop for this
420IC while using the nRF52 Development Kit (PCA10040).
421
422See :ref:`nrf52dk_nrf52832` for more information about the development board and
423`nRF52805 website`_ for the official reference on the IC itself.
424
425References
426**********
427
428.. target-notes::
429
430.. _nRF52805 website: https://www.nordicsemi.com/Products/Low-power-short-range-wireless/nRF52805
431
432.. _nrf52dk_nrf52810:
433
434nRF52810 emulation on nRF52 DK
435##############################
436
437Overview
438********
439
440The ``nrf52dk/nrf52810`` board is a modified version of the :ref:`nrf52dk_nrf52832`
441that enforces the limitations imposed by the nRF52810 IC, which is a
442cost-reduced variant of the original nRF52832. Since Nordic does not offer a
443development kit for the nRF52810 you can use this board to develop for this
444IC while using the nRF52 Development Kit (PCA10040).
445
446See :ref:`nrf52dk_nrf52832` for more information about the development board and
447`nRF52810 website`_ for the official reference on the IC itself.
448
449
450References
451**********
452
453.. target-notes::
454
455.. _nRF52810 website: https://www.nordicsemi.com/Products/Low-power-short-range-wireless/nRF52810
456