From 4745272d6c51392f7a02c5fc454cbbeedc8755c6 Mon Sep 17 00:00:00 2001
From: Kevin Townsend <contact@microbuilder.eu>
Date: Tue, 13 Feb 2018 09:34:09 +0100
Subject: [PATCH] Added feather52840 readme

---
 ports/nrf/boards/feather52840/README.md | 44 +++++++++++++++++++++++++
 1 file changed, 44 insertions(+)
 create mode 100644 ports/nrf/boards/feather52840/README.md

diff --git a/ports/nrf/boards/feather52840/README.md b/ports/nrf/boards/feather52840/README.md
new file mode 100644
index 0000000000..2bfea9320c
--- /dev/null
+++ b/ports/nrf/boards/feather52840/README.md
@@ -0,0 +1,44 @@
+# Setup
+
+## Installing CircuitPython submodules
+
+Before you can build, you will need to run the following commands once, which
+will install the submodules that are part of the CircuitPython ecosystem, and
+build the `mpy-cross` tool:
+
+```
+$ cd circuitpython
+$ git submodule update --init
+$ make -C mpy-cross
+```
+
+You then need to download the SD and Nordic SDK files via:
+
+> This script relies on `wget`, which must be available from the command line.
+
+```
+$ cd ports/nrf
+$ ./drivers/bluetooth/download_ble_stack.sh
+```
+
+## Serial Bootloader
+
+The Adafruit nRF52840 Feather uses a serial bootloader that allows you to
+update the core CircuitPython firmware and internal file system contents
+using only a serial connection.
+
+On empty devices, the serial bootloader will need to be flashed once using a
+HW debugger such as a Segger J-Link before the serial updater (`nrfutil`) can
+be used.
+
+### Install the Bootloader with `nrfjprog`
+
+```
+make SD=s140 BOARD=feather52840 boot-flash
+```
+
+## Building and Flashing CircuitPython
+
+```
+make SD=s140 SERIAL=/dev/ttyACM0 BOARD=feather52840 dfu-gen dfu-flash
+```