You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
3.```cd <SKETCHBOOK>```, where ```<SKETCHBOOK>``` is your Arduino Sketch folder:
25
-
*OS X : ```~/Documents/Arduino```
26
-
* Linux : ```~/Arduino```
27
-
* Windows: ```~/Documents/Arduino```
28
-
4. Create a folder named ```hardware/Adafruit```, if it does not exist, and change directories to it
29
-
5. Clone this repo: `git clone git@github.com:adafruit/Adafruit_nRF52_Arduino.git`
30
+
3.`cd <SKETCHBOOK>`, where `<SKETCHBOOK>` is your Arduino Sketch folder:
31
+
*macOS : `~/Documents/Arduino`
32
+
* Linux : `~/Arduino`
33
+
* Windows: `~/Documents/Arduino`
34
+
4. Create a folder named `hardware/Adafruit`, if it does not exist, and change directories to it
35
+
5. Clone this repo: `git clone https://github.com/adafruit/Adafruit_nRF52_Arduino.git`
30
36
6. Restart the Arduino IDE
31
37
7. Once the BSP is installed, select 'Adafruit Bluefruit nRF52 Feather' from the Tools -> Board menu, which will update your system config to use the right compiler and settings for the nRF52.
32
38
33
-
### Third Party Tools
39
+
### Adafruit's nrfutil tools
34
40
35
-
#### nrfutil
41
+
[adafruit-nrfutil](https://github.com/adafruit/Adafruit_nRF52_nrfutil) (derived from Nordic pc-nrfutil) is needed to upload sketch via serial port.
36
42
37
-
The Adafruit nRF52 BSP includes a [python wrapper](https://github.com/NordicSemiconductor/pc-nrfutil)
38
-
for Nordic's `nrfutil`, which is used to flash boards. Go into the BSP folder
39
-
(`hardware/Adafruit/Adafruit_nRF52_Arduino/tools/nrfutil-0.5.2`), and run the following to make
40
-
this available to the Arduino IDE:
43
+
- For Windows and macOS, pre-built executable binaries are included in the BSP at `tools/adafruit-nrfutil/`. It should work out of the box.
44
+
- Linux user need to run follow command to install it from PyPi
41
45
42
-
```
43
-
$ cd tools/nrfutil-0.5.2
44
-
$ sudo pip install -r requirements.txt
45
-
$ sudo python setup.py install
46
-
```
46
+
```
47
+
$ pip3 install adafruit-nrfutil --user
48
+
```
49
+
50
+
### Drivers
47
51
48
-
**Notes** : Don't install nrfutil from the pip package (ex. `sudo pip install nrfutil`). The
49
-
latest nrfutil does not support DFU via Serial, and you should install the local copy of 0.5.2
50
-
included with the BSP via the `python setup.py install` command above.
52
+
- [SiLabs CP2104 driver](http://www.silabs.com/products/mcu/pages/usbtouartbridgevcpdrivers.aspx) is required for USB to Serial when using with Feather nRF52832
51
53
52
54
## Arduino BLE Application Support
53
55
@@ -63,52 +65,57 @@ examples sketched for the selected board.
63
65
64
66
## Bootloader Support
65
67
66
-
### Third Party Tools
68
+
### Upgrade existing Bootloader
69
+
70
+
Bluefruit's Bootloader is self-upgradable, you could upgrade to the latest Bootloader + Softdevice using the serial port within Arduino IDE.
Note: close the Serial Monitor before you click "Burn Bootloader". Afterwards, you shouldn't close the Arduino IDE, unplug the Feather, launch Serial Monitor etc ... to abort the process. There is a high chance it will brick your device! Do this with care and caution.
78
+
79
+
### Burning new Bootloader
67
80
68
81
To burn the bootloader from within the Arduino IDE, you will need the following tools installed
69
82
on your system and available in the system path:
70
83
71
-
#### Jlink Driver and Tools
84
+
- Segger [JLink Software and Documentation Pack](https://www.segger.com/downloads/jlink)
85
+
- Nordic [nRF5x Command Line Tools](http://infocenter.nordicsemi.com/index.jsp?topic=%2Fcom.nordic.infocenter.tools%2Fdita%2Ftools%2Fnrf5x_command_line_tools%2Fnrf5x_installation.html)
86
+
87
+
Check to make sure you can run `nrfjprog` from your terminal/command prompt
72
88
73
-
Download and install the [JLink Software and Documentation Pack](https://www.segger.com/downloads/jlink)
74
-
from Segger, which will also install a set of command line tools.
89
+
**macOS Note** At present, you will need to create a symlink in `/usr/local/bin` to the
90
+
`nrfjprog` tool wherever you have added it. You can run the following command, for example:
- Select `Tools > Programmer > J-Link for Feather52`
82
100
- Select `Tools > Burn Bootloader` with the board and J-Link connected
83
101
84
-
#### Manually Burning the Bootloader via nrfjprog
85
-
86
-
You can also manually burn the bootloader from the command line, you will need `nrfjprog` from Nordic:
87
-
88
-
- Download [nRF5x-Command-Line-Tools](https://www.nordicsemi.com/eng/Products/Bluetooth-low-energy/nRF52832#Downloads) for OSX/Linux/Win32
89
-
- Extract the downloaded file and add the extracted path to your environment `PATH` variable
90
-
- Check to make sure you can run `nrfjprog` from your terminal/command prompt
102
+
If you wish to modify bootloader to your own need, check out its repo here [Adafruit_nRF52_Bootloader](https://github.com/adafruit/Adafruit_nRF52_Bootloader)
91
103
92
-
**OS X Note** At present, you will need to create a symlink in `/usr/local/bin` to the
93
-
`nrfjprog` tool wherever you have added it. You can run the following command, for example:
0 commit comments