Debian Codegraph @

ports/nrf/boards/NRF52840_MDK_USB_DONGLE/README.md

raw
1 nRF52840 MDK USB Dongle
2 =======================
3
4 The *[nRF52840 MDK USB
5 Dongle](https://wiki.makerdiary.com/nrf52840-mdk-usb-dongle)* is a small,
6 low-cost development board in a USB dongle form-factor powered by an nRF52840
7 with 1MB flash and 256KB RAM.
8
9 This device is pre-installed with [Open
10 Bootloader](https://wiki.makerdiary.com/nrf52840-mdk-usb-dongle/programming/),
11 allowing DFU upgrades over USB using Nordic [nRF
12 Connect](https://www.nordicsemi.com/Software-and-tools/Development-Tools/nRF-Connect-for-desktop)
13 or [nrfutil](https://github.com/NordicSemiconductor/pc-nrfutil/). To support
14 Open Bootloader, the flash and memory layout must be adjusted slightly (details
15 [here](https://devzone.nordicsemi.com/nordic/short-range-guides/b/getting-started/posts/nrf52840-dongle-programming-tutorial))
16 from the typical nRF build; this board definition ensure the appropriate build
17 configuration is used for MicroPython.
18
19
20 Pinout
21 ------
22
23 The [pinout
24 diagram](https://wiki.makerdiary.com/nrf52840-mdk-usb-dongle/#pinout-diagram)
25 provides an overview of the available pins and their capabilities. All pins are
26 available in MicroPython, using the pin numbers labelled in the diagram
27 (excluding the leading port number, *P0*).
28
29 The three LEDs are available either through the usual `Pin` mechanism - pins
30 22-24 - or by `board.LED(n)` where n can be 1, 2 or 3.
31
32
33 Build instructions
34 ------------------
35
36 Follow the standard [nRF Port build instructions](../../README.md); but use
37 `nrf52840-mdk-usb-dongle` as the value for `BOARD`:
38
39 make BOARD=nrf52840-mdk-usb-dongle
40
41 The build artifacts will be created in `build-nrf52840-mdk-usb-dongle`. Once
42 built, the target can be deployed to the device as described in
43 [nRFUtil targets](../../README.md#nrfutil-targets).
44
45 An alternative way to deploy to the device, is to open `firmware.hex` using
46 *nRF Connect* and select *Write*. Detailed instructions can be found on the
47 [developer
48 wiki](https://wiki.makerdiary.com/nrf52840-mdk-usb-dongle/programming/).