Skip to content

Commit d5af898

Browse files
Kevin Townsendtannewt
Kevin Townsend
authored andcommitted
Added note on REPL over NUS
1 parent 5e6f113 commit d5af898

File tree

1 file changed

+25
-4
lines changed

1 file changed

+25
-4
lines changed

ports/nrf/boards/feather52/README.md

Lines changed: 25 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -55,6 +55,26 @@ To build a CircuitPython binary with default settings for the
5555
$ make BOARD=feather52 V=1
5656
```
5757

58+
#### REPL over BLE UART (AKA 'NUS')
59+
60+
To build a CircuitPython binary that uses the Nordic UART Service (AKA 'NUS' or
61+
'BLEUART'), modify `/ports/nrf/bluetooth_conf.h` to have the following macro
62+
set to `1` in the `#elif (BLUETOOTH_SD == 132)` section:
63+
64+
```
65+
#define MICROPY_PY_BLE_NUS (1)
66+
```
67+
68+
... then build as normal, via:
69+
70+
```
71+
$ make BOARD=feather52 V=1
72+
```
73+
74+
You can then connect over BLE UART using an application like Bluefruit LE
75+
Connect, available for Android, iOS and OS X, or any other application that
76+
supports the NUS service and allows you to send the corrent EOL sequence.
77+
5878
## Flashing binaries with `nrfutil`
5979

6080
### 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
91111
The following command will package and flash the CircuitPython binary using the
92112
appropriate bootloader mentionned above.
93113

94-
This command assumes you have already build a valid circuitpython
114+
This command assumes you have already built a valid circuitpython
95115
image, as described earlier in this readme.
96116

97117
> The name of the serial port target will vary, depending on your OS.
@@ -100,11 +120,12 @@ image, as described earlier in this readme.
100120
$ make BOARD=feather52 SERIAL=/dev/tty.SLAB_USBtoUART dfu-gen dfu-flash
101121
```
102122

103-
If you built your CircuitPython binary with **BLE** support you will need to
104-
add the `SD=s132` flag as shown below:
123+
By default, CircuitPython will build with **BLE** support enabled using
124+
`SD=s132` and the `SOFTDEV_VERSION=2.0.1`. If you wish to specify a different
125+
SD family or version you can enter the optional fields as shown below:
105126

106127
```
107-
$ make BOARD=feather52 SERIAL=/dev/tty.SLAB_USBtoUART SD=s132 dfu-gen dfu-flash
128+
$ make BOARD=feather52 SERIAL=/dev/tty.SLAB_USBtoUART SD=s132 SOFTDEV_VERSION=5.0.0 dfu-gen dfu-flash
108129
```
109130

110131
## Working with CircuitPython

0 commit comments

Comments
 (0)