skullydazed / Adafruit_nRF52_Arduino

Arduino Core for Seeed nRF52 Boards

Arduino Core for Seeed nRF52 Boards

This repository contains the Arduino BSP for Seeed nRF52 series:

• Seeed Studio XIAO nRF52840
• Seeed Studio XIAO nRF52840 Sense
• Seeed Studio Wio Tracker 1110

BSP Installation

There are two methods that you can use to install this BSP. We highly recommend the first option unless you wish to participate in active development of this codebase via GitHub.

Recommended: Seeed nRF52 BSP via the Arduino Board Manager

1. Download and install the Arduino IDE (At least v1.6.12)
2. Start the Arduino IDE
3. Go into Preferences
4. Add https://files.seeedstudio.com/arduino/package_seeeduino_boards_index.json as an 'Additional Board Manager URL'
5. Restart the Arduino IDE
6. Open the Boards Manager from the Tools -> Board menu and install 'Seeed nRF52 Boards'
7. Once the BSP is installed, select 'Seeed XIAO nRF52840' from the Tools -> Board menu, which will update your system config to use the right compiler and settings for the nRF52.

Optional (Core Development): Seeed nRF52 BSP via git

1. Install BSP via Board Manager as above to install compiler & tools.
2. Delete the core folder nrf52 installed by Board Manager in Adruino15, depending on your OS. It could be

• macOS : ~/Library/Arduino15/packages/Seeeduino/hardware/nrf52
• Linux : ~/.arduino15/packages/Seeeduino/hardware/nrf52
• Windows: %APPDATA%\Local\Arduino15\packages\Seeeduino\hardware\nrf52

3. cd <SKETCHBOOK>, where <SKETCHBOOK> is your Arduino Sketch folder:

• macOS : ~/Documents/Arduino
• Linux : ~/Arduino
• Windows: ~/Documents/Arduino

4. Create a folder named hardware/Seeeduino, if it does not exist, and change directories to it
5. Clone this repo & its submodules:

git clone https://github.com/Seeed-Studio/Adafruit_nRF52_Arduino.git
cd Adafruit_nRF52_Arduino
git submodule update --init

6. Restart the Arduino IDE
7. Once the BSP is installed, select 'Seeed XIAO nRF52840' from the Tools -> Board menu, which will update your system config to use the right compiler and settings for the nRF52.

Optional (Core Development): Create Seeed nRF52 BSP file

$ git clone --depth 1 --recurse-submodules https://github.com/Seeed-Studio/Adafruit_nRF52_Arduino Seeed_nRF52_Boards
$ cd Seeed_nRF52_Boards
$ ./extras/pack_release.sh

Adafruit's nrfutil tools

adafruit-nrfutil (derived from Nordic pc-nrfutil) is needed to upload sketch via serial port.

• For Windows and macOS, pre-built executable binaries are included in the BSP at tools/adafruit-nrfutil/. It should work out of the box.
• Linux user need to run follow command to install it from PyPi

$ pip3 install adafruit-nrfutil --user

Credits

This core is based on Adafruit_nRF52_Arduino by Adafruit, which in turn is based on Arduino-nRF5 by Sandeep Mistry, which in turn is based on the Arduino SAMD Core.

The following libraries are used:

• FreeRTOS as operating system
• LittleFS for internal file system
• nrfx for peripherals driver
• TinyUSB as usb stack