simmel-bootloader/README.md

2.9 KiB

Adafruit Bluefruit nRF52 Bootloader

This repository contains the bootloader for Adafruit nRF52 series board

Features

nRF52832

  • DFU over Serial and OTA ( Application, Bootloader+SD )
  • DFU auto start to work with Arduino DTR auto-reset

nRF52840

  • DFU over USB CDC and OTA ( Application, Bootloader+SD )
  • DFU using USB Flashing Format a.k.a UF2 (Applicatoin only)

Compile

This repository depend on following submodule

Get the code with following command:

git clone <URL>.git Adafruit_nRF52_Bootloader
cd Adafruit_nRF52_Bootloader
git submodule update --init

Option 1: Build with makefile

Prerequisite

To build

$ make BOARD=feather52840 all

To flash bootloader

$ make BOARD=feather52840 flash

To flash SoftDevice (with full chip erase)

$ make BOARD=feather52840 sd

To full erase chip

$ make BOARD=feather52840 erase

For the list of supported boards, try to type make without BOARD=

$ make
You must provide a BOARD parameter with 'BOARD='
Supported boards are: feather52832 feather52840 pca10056
Makefile:90: *** BOARD not defined.  Stop

Common makefile problems

1. arm-none-eabi-gcc: No such file or directory

If you get the following error ...

$ make BOARD=feather52840 all
Compiling file: main.c
/bin/sh: /usr/bin/arm-none-eabi-gcc: No such file or directory
make: *** [_build/main.o] Error 127

... you may need to edit the Makefile and update the GNU_INSTALL_ROOT to point to the root path of your GCC ARM toolchain.

2. mergehex: No such file or directory

Make sure that mergehex is available from the command-line. This binary is part of of Nordic's nRF5x Command Line Tools

3. make: nrfjprog: No such file or directory

Make sure that nrfjprog is available from the command-line. This binary is part of of Nordic's nRF5x Command Line Tools.

On POSIX-type systems you can temporarily add the path to nrfjprog via a variation on the following command:

$ export PATH=$PATH:/Users/Kevin/Downloads/nRF5x-Command-Line-Tools_9_7_2_OSX/nrfjprog

Option 2: Build using Segger Embeded Studio

For better debugging you can also use SES. The project file is located at src/segger/Adafruit_nRF52_Bootloader.emProject.

Note: SES only flashes the bootloader when you click download, you need to flash Softdevice beforehand if you haven't done so ( use make BOARD=feather52840 sd mentioned above )