@@ -55,6 +55,26 @@ To build a CircuitPython binary with default settings for the
55
55
$ make BOARD=feather52 V=1
56
56
```
57
57
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
+
58
78
## Flashing binaries with ` nrfutil `
59
79
60
80
### 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
91
111
The following command will package and flash the CircuitPython binary using the
92
112
appropriate bootloader mentionned above.
93
113
94
- This command assumes you have already build a valid circuitpython
114
+ This command assumes you have already built a valid circuitpython
95
115
image, as described earlier in this readme.
96
116
97
117
> The name of the serial port target will vary, depending on your OS.
@@ -100,11 +120,12 @@ image, as described earlier in this readme.
100
120
$ make BOARD=feather52 SERIAL=/dev/tty.SLAB_USBtoUART dfu-gen dfu-flash
101
121
```
102
122
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:
105
126
106
127
```
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
108
129
```
109
130
110
131
## Working with CircuitPython
0 commit comments