diff options
| author | Kevin Townsend <contact@microbuilder.eu> | 2018-01-15 18:32:08 +0100 |
|---|---|---|
| committer | Scott Shawcroft <scott@tannewt.org> | 2018-01-18 11:32:47 -0800 |
| commit | d5af898999831d15ca3829b0cca6a0df8d65c4b1 (patch) | |
| tree | b99873e99e2c7543d935807e18d91bde09dcc8c1 | |
| parent | 5e6f113779a638590cf34c57936f4512c365fa0a (diff) | |
Added note on REPL over NUS
| -rw-r--r-- | ports/nrf/boards/feather52/README.md | 29 |
1 files changed, 25 insertions, 4 deletions
diff --git a/ports/nrf/boards/feather52/README.md b/ports/nrf/boards/feather52/README.md index d5e002622..c98f54614 100644 --- a/ports/nrf/boards/feather52/README.md +++ b/ports/nrf/boards/feather52/README.md @@ -55,6 +55,26 @@ To build a CircuitPython binary with default settings for the $ make BOARD=feather52 V=1 ``` +#### REPL over BLE UART (AKA 'NUS') + +To build a CircuitPython binary that uses the Nordic UART Service (AKA 'NUS' or +'BLEUART'), modify `/ports/nrf/bluetooth_conf.h` to have the following macro +set to `1` in the `#elif (BLUETOOTH_SD == 132)` section: + +``` +#define MICROPY_PY_BLE_NUS (1) +``` + +... then build as normal, via: + +``` +$ make BOARD=feather52 V=1 +``` + +You can then connect over BLE UART using an application like Bluefruit LE +Connect, available for Android, iOS and OS X, or any other application that +supports the NUS service and allows you to send the corrent EOL sequence. + ## Flashing binaries with `nrfutil` ### 1. **Update bootloader** to single-bank version @@ -91,7 +111,7 @@ $ make BOARD=feather52 SERIAL=/dev/tty.SLAB_USBtoUART SOFTDEV_VERSION=5.0.0 boot The following command will package and flash the CircuitPython binary using the appropriate bootloader mentionned above. -This command assumes you have already build a valid circuitpython +This command assumes you have already built a valid circuitpython image, as described earlier in this readme. > The name of the serial port target will vary, depending on your OS. @@ -100,11 +120,12 @@ image, as described earlier in this readme. $ make BOARD=feather52 SERIAL=/dev/tty.SLAB_USBtoUART dfu-gen dfu-flash ``` -If you built your CircuitPython binary with **BLE** support you will need to -add the `SD=s132` flag as shown below: +By default, CircuitPython will build with **BLE** support enabled using +`SD=s132` and the `SOFTDEV_VERSION=2.0.1`. If you wish to specify a different +SD family or version you can enter the optional fields as shown below: ``` -$ make BOARD=feather52 SERIAL=/dev/tty.SLAB_USBtoUART SD=s132 dfu-gen dfu-flash +$ make BOARD=feather52 SERIAL=/dev/tty.SLAB_USBtoUART SD=s132 SOFTDEV_VERSION=5.0.0 dfu-gen dfu-flash ``` ## Working with CircuitPython |