circuitpython/ports/nrf/boards/feather_nrf52832
hathach 2f0e0bdcaf migrate serial from uart to uarte 2018-09-25 16:14:44 +07:00
..
examples rename nrf boards to feather_nrf52832 and feather_nrf52840_express 2018-08-21 18:45:37 -04:00
README.md Merge remote-tracking branch 'adafruit/master' into nrf_board_rename 2018-08-22 10:24:10 -04:00
board.c use open-drain capabilities on GPIO; clean up board init; set correct GPIO voltage 2018-09-09 15:01:28 -04:00
custom_nrf52832_dfu_app_2.0.1.ld rename nrf boards to feather_nrf52832 and feather_nrf52840_express 2018-08-21 18:45:37 -04:00
custom_nrf52832_dfu_app_5.0.0.ld rename nrf boards to feather_nrf52832 and feather_nrf52840_express 2018-08-21 18:45:37 -04:00
mpconfigboard.h migrate serial from uart to uarte 2018-09-25 16:14:44 +07:00
mpconfigboard.mk pin files rework; implement pin claiming; add more boards 2018-08-31 18:05:55 -04:00
pins.c Add VOLTAGE_MONITOR alias to pin D31/A7 2018-09-13 23:46:47 +02:00

README.md

Setup

Installing CircuitPython submodules

Before you can build, you will need to run the following commands once, which will install the submodules that are part of the CircuitPython ecosystem, and build the mpy-cross tool:

$ cd circuitpython
$ git submodule update --init
$ make -C mpy-cross

You then need to download the SD and Nordic SDK files via:

This script relies on wget, which must be available from the command line.

$ cd ports/nrf
$ ./drivers/bluetooth/download_ble_stack.sh

Installing adafruit-nrfutil

The Adafruit Bluefruit nRF52 Feather ships with a serial and OTA BLE bootloader that can be used to flash firmware images over a simple serial connection, using the on-board USB serial converter.

run following command to install adafruit-nrfutil from PyPi

$ pip3 install --user adafruit-nrfutil

Building and flashing firmware images

Building CircuitPython binaries

REPL over UART (default settings)

To build a CircuitPython binary with default settings for the feather_nrf52832 target enter:

NOTE: BOARD=feather_nrf52832 is the default option and isn't stricly required.

$ make BOARD=feather_nrf52832 V=1

REPL over BLE UART (AKA 'NUS')

To build a CircuitPython binary that uses the Nordic UART Service (AKA 'NUS' or 'BLEUART'), modify /ports/nrf/bluetooth_conf.h to have the following macro set to 1 in the #elif (BLUETOOTH_SD == 132) section:

#define MICROPY_PY_BLE_NUS              (1)

... then build as normal, via:

$ make BOARD=feather52832 V=1

You can then connect over BLE UART using an application like Bluefruit LE Connect, available for Android, iOS and OS X, or any other application that supports the NUS service and allows you to send the corrent EOL sequence.

Flashing binaries with adafruit-nrfutil

1. Update bootloader to single-bank version

The Adafruit nRF52 Feather ships, by default, with a dual-bank bootloader that cuts the available flash memory in half in exchange for safer OTA updates.

Due to the size of CircuitPython, we must migrate this bootloader to a single-bank version, doubling the amount of flash memory available to us.

These commands only need to be run once and will update the SoftDevice and bootloader from the dual-bank version that ships on Arduino-based Adafruit Feather52 boards to a single-bank CircuitPython compatible version:

Firstly clone the Adafruit_nRF52_Bootloader and enter its directory

$ git clone https://github.com/adafruit/Adafruit_nRF52_Bootloader.git
$ cd Adafruit_nRF52_Bootloader

To flash bootloader with s132 v2.0.1

$ make BOARD=feather_nrf52832 VERSION=2.0.1 SERIAL=/dev/tty.SLAB_USBtoUART dfu-flash

S132 v5.0.0 (BLE5, experimental):

To flash bootloader with s132 v5.0.0

$ make BOARD=feather52832 VERSION=5.0.0 SERIAL=/dev/tty.SLAB_USBtoUART dfu-flash

2. Generate and flash a CircuitPython DFU .zip package over serial

The following command will package and flash the CircuitPython binary using the appropriate bootloader mentionned above.

This command assumes you have already built a valid circuitpython image, as described earlier in this readme.

The name of the serial port target will vary, depending on your OS.

$ make BOARD=feather_nrf52832 SERIAL=/dev/tty.SLAB_USBtoUART dfu-gen dfu-flash

By default, CircuitPython will build with BLE support enabled using SD=s132 and the SOFTDEV_VERSION=2.0.1. If you wish to specify a different SD family or version you can enter the optional fields as shown below:

$ make BOARD=feather_nrf52832 SERIAL=/dev/tty.SLAB_USBtoUART SD=s132 SOFTDEV_VERSION=5.0.0 dfu-gen dfu-flash

Working with CircuitPython

Running local files with ampy

ampy is a command-line tool that can be used with the nRF52 Feather to transfer local python files to the nRF52 for execution, rather than having to enter the REPL manually, enter paste mode, and paste the code yourself.

IMPORTANT: You must have ampy version 1.0.3 or higher to use ampy with the nRF52. The bootloader on the nRF52 requires a delay between the HW reset, and the moment when the command sequance is sent to enter raw mode. This required -d/--delay flag was added in release 1.0.3.

Save the following file as test.py:

import board
import digitalio
import time

led = digitalio.DigitalInOut(board.LED2)
led.direction = digitalio.Direction.OUTPUT

while True:
    led.value = True
    time.sleep(0.5)
    led.value = False
    time.sleep(0.5)

Then run the saved file via ampy, updating the serial port as required:

$ ampy -p /dev/tty.SLAB_USBtoUART -d 1.5 run test.py

This should give you blinky at 1 Hz on LED2 (the blue LED on the nRF52 Feather).

Uploading files and libraries with ampy

To upload Python files or pre-compiled CircuitPython libraries to the lib folder, run the following commands:

In this example i2c_device.py is used, which is part of Adafruit_CircuitPython_BusDevice

$ ampy -p /dev/tty.SLAB_USBtoUART -d 1.5 put i2c_device.py lib/i2c_device.py

To verify that the file was uploaded correctly, you can check the contents of the lib folder with:

$ ampy -p /dev/tty.SLAB_USBtoUART -d 1.5 ls /lib
i2c_device.py

Suggested libraries

The following libraries should be installed as a minimum on most new boards: