circuitpython/ports/nrf
Glenn Ruben Bakke d889def06b nrf/led: Adjust how board LEDs are defined.
Change static LED functions to lowercase names, and trim down source code
lines for variants of MICROPY_HW_LED_COUNT.  Also rename configuration for
MICROPY_HW_LEDx_LEVEL to MICROPY_HW_LEDx_PULLUP to align with global PULLUP
configuration.
2019-06-25 16:02:31 +10:00
..
boards nrf/led: Adjust how board LEDs are defined. 2019-06-25 16:02:31 +10:00
device nrf: Replace custom-HAL with nrfx-HAL 2018-07-18 17:12:26 +10:00
drivers nrf/bluetooth: Deprecate use of SoftDevice s140 v6.0.0. 2019-03-15 20:50:15 +01:00
examples nrf: Move pyb module to boards module 2018-07-18 17:12:26 +10:00
freeze nrf: Add new port to Nordic nRF5x MCUs. 2018-07-18 17:12:25 +10:00
modules nrf/led: Adjust how board LEDs are defined. 2019-06-25 16:02:31 +10:00
.gitignore nrf: Add new port to Nordic nRF5x MCUs. 2018-07-18 17:12:25 +10:00
Makefile nrf/boards: Add support for BLYST Nano module based boards. 2019-05-02 22:33:44 +02:00
README.md nrf/boards: Add support for BLYST Nano module based boards. 2019-05-02 22:33:44 +02:00
bluetooth_conf.h nrf/bluetooth: Add support for s132/s140 v6, remove s132 v2/3/5 2018-07-18 17:12:26 +10:00
fatfs_port.c nrf: Add new port to Nordic nRF5x MCUs. 2018-07-18 17:12:25 +10:00
gccollect.c nrf/gccollect: Use the SP register instead of MSP. 2018-07-18 17:12:26 +10:00
gccollect.h nrf: Add new port to Nordic nRF5x MCUs. 2018-07-18 17:12:25 +10:00
help.c nrf: Move pyb module to boards module 2018-07-18 17:12:26 +10:00
main.c ports: Convert to use pyexec_file_if_exists() to execute boot/main.py. 2019-04-26 15:22:14 +10:00
mpconfigport.h nrf/mpconfigport.h: Enable MICROPY_KBD_EXCEPTION by default. 2019-05-22 12:47:48 +10:00
mphalport.c nrf/mphalport: Use wfi to save power while waiting at the UART REPL. 2019-05-22 12:47:48 +10:00
mphalport.h nrf: Add support for reading output pin state 2018-07-18 17:12:26 +10:00
nrf51_af.csv nrf: Remove port member from Pin object 2018-07-18 17:12:26 +10:00
nrf52_af.csv nrf: Remove port member from Pin object 2018-07-18 17:12:26 +10:00
nrfx_config.h nrf/nrfx_config: Move back nrf52832 to use non-EasyDMA SPI 2018-07-18 17:12:26 +10:00
nrfx_glue.h nrf/nrfx_glue: Adapt to nrfx v.1.7.1. 2019-05-21 23:16:20 +02:00
nrfx_log.h nrf: Replace custom-HAL with nrfx-HAL 2018-07-18 17:12:26 +10:00
pin_defs_nrf5.h nrf: Replace custom-HAL with nrfx-HAL 2018-07-18 17:12:26 +10:00
pin_named_pins.c nrf: Add new port to Nordic nRF5x MCUs. 2018-07-18 17:12:25 +10:00
qstrdefsport.h nrf: Add new port to Nordic nRF5x MCUs. 2018-07-18 17:12:25 +10:00

README.md

MicroPython Port To The Nordic Semiconductor nRF Series

This is a port of MicroPython to the Nordic Semiconductor nRF series of chips.

Supported Features

  • UART
  • SPI
  • LEDs
  • Pins
  • ADC
  • I2C
  • PWM (nRF52 only)
  • Temperature
  • RTC (Real Time Counter. Low-Power counter)
  • BLE support including:
    • Peripheral role on nrf51 targets
    • Central role and Peripheral role on nrf52 targets
    • REPL over Bluetooth LE (optionally using WebBluetooth)
    • ubluepy: Bluetooth LE module for MicroPython
    • 1 non-connectable advertiser while in connection

Tested Hardware

Compile and Flash

Prerequisite steps for building the nrf port:

git clone <URL>.git micropython
cd micropython
git submodule update --init
make -C mpy-cross

By default, the PCA10040 (nrf52832) is used as compile target. To build and flash issue the following command inside the ports/nrf/ folder:

make
make flash

Alternatively the target board could be defined:

 make BOARD=pca10040
 make BOARD=pca10040 flash

Compile without LTO enabled

As a space optimization, LTO (Link Time Optimization) has been enabled on all targets in the nrf-port. The -flto linker flag can be toggled easily by using the argument LTO when building. The example below shows how to disable LTO for the compilation:

make BOARD=pca10040 LTO=0

Note: There have been several issues with use of LTO in conjunction with GNU ARM Embedded Toolchain 7.2.1/4Q17. It's recommended to use a toolchain after this release, for example 7.3.1/2Q18 or 8.2.1/4Q18. The alternative would be to build the target using the LTO=0 as described above.

Compile and Flash with Bluetooth Stack

First prepare the bluetooth folder by downloading Bluetooth LE stacks and headers:

 ./drivers/bluetooth/download_ble_stack.sh

If the Bluetooth stacks has been downloaded, compile the target with the following command:

make BOARD=pca10040 SD=s132

The make sd will trigger a flash of the bluetooth stack before that application is flashed. Note that make sd will perform a full erase of the chip, which could cause 3rd party bootloaders to also be wiped.

make BOARD=pca10040 SD=s132 sd

Note: further tuning of features to include in bluetooth or even setting up the device to use REPL over Bluetooth can be configured in the bluetooth_conf.h.

Compile with frozen modules

Frozen modules are Python modules compiled to bytecode and added to the firmware image, as part of MicroPython. They can be imported as usual, using the import statement. The advantage is that frozen modules use a lot less RAM as the bytecode is stored in flash, not in RAM like when importing from a filesystem. Also, frozen modules are available even when no filesystem is present to import from.

To use frozen modules, put them in a directory (e.g. freeze/) and supply make with the given directory. For example:

 make BOARD=pca10040 FROZEN_MPY_DIR=freeze

Enable MICROPY_FATFS

As the oofatfs module is not having header guards that can exclude the implementation compile time, this port provides a flag to enable it explicitly. The MICROPY_FATFS is by default set to 0 and has to be set to 1 if oofatfs files should be compiled. This will be in addition of setting MICROPY_VFS and MICROPY_VFS_FAT in mpconfigport.h.

For example:

 make BOARD=pca10040 MICROPY_FATFS=1

Target Boards and Make Flags

Target Board (BOARD) Bluetooth Stack (SD) Bluetooth Support Flash Util
microbit s110 Peripheral PyOCD
pca10000 s110 Peripheral Segger
pca10001 s110 Peripheral Segger
pca10028 s110 Peripheral Segger
pca10031 s110 Peripheral Segger
wt51822_s4at s110 Peripheral Manual, see datasheet for pinout
pca10040 s132 Peripheral and Central Segger
feather52 s132 Peripheral and Central Manual, SWDIO and SWCLK solder points on the bottom side of the board
arduino_primo s132 Peripheral and Central PyOCD
ibk_blyst_nano s132 Peripheral and Central IDAP
idk_blyst_nano s132 Peripheral and Central IDAP
blueio_tag_evim s132 Peripheral and Central IDAP
pca10056 s140 Peripheral and Central Segger

Install the necessary tools to flash and debug using IDAP-M/IDAP-Link CMSIS-DAP Debug JTAG:

IDAPnRFProg for Linux IDAPnRFProg for OSX IDAPnRFProg for Windows

Segger Targets

Install the necessary tools to flash and debug using Segger:

JLink Download

nrfjprog Download

note: On Linux it might be required to link SEGGER's libjlinkarm.so inside nrfjprog's folder.

PyOCD/OpenOCD Targets

Install the necessary tools to flash and debug using OpenOCD:

sudo apt-get install openocd
sudo pip install pyOCD

Bluetooth LE REPL

The port also implements a BLE REPL driver. This feature is disabled by default, as it will deactivate the UART REPL when activated. As some of the nRF devices only have one UART, using the BLE REPL free's the UART instance such that it can be used as a general UART peripheral not bound to REPL.

The configuration can be enabled by editing the bluetooth_conf.h and set MICROPY_PY_BLE_NUS to 1.

When enabled you have different options to test it:

Other:

  • nRF UART application for IPhone/Android

WebBluetooth mode can also be configured by editing bluetooth_conf.h and set BLUETOOTH_WEBBLUETOOTH_REPL to 1. This will alternate advertisement between Eddystone URL and regular connectable advertisement. The Eddystone URL will point the phone or PC to download WebBluetooth REPL (experimental), which subsequently can be used to connect to the Bluetooth REPL from the PC or Phone browser.