Particle Mesh common

Common support for the Particle Mesh boards family (Xenon, Argon, Boron) More...

Detailed Description

Common support for the Particle Mesh boards family (Xenon, Argon, Boron)

General information

Particle Mesh are mesh-ready development kits. Depending on the board type (Xenon, Argon, Boron), it provides access to multiple communication protocols: BLE, 802.15.4, WiFi, LTE.

Flash the board

Using the Particle Mesh debugger, the board can be flashed with PyOCD programmer via a DAPLink.

PyOCD can be installed using Python package manager:

pip install pyocd --user -U

To flash the board, use BOARD=<board name> (with board name in {particle-argon, particle-boron, particle-xenon}) with the make command.
Example with hello-world application:

make BOARD=particle-xenon -C examples/hello-world flash

In this case, OpenOCD can also be used. For the moment, the latest stable version of OpenOCD (0.10) doesn't contain any support for nrf52 but versions built against the actual development version can be used.

To flash the board with OpenOCD, use the PROGRAMMER variable:

PROGRAMMER=openocd make BOARD=<board name> -C examples/hello-world flash

Reset the board

The on-board reset button doesn't work, so to trigger a reset of the board, use the reset target with make:

make BOARD=<board name> -C examples/hello-world reset

Accessing STDIO via UART

The STDIO is not accessible via the USB port.

To access the STDIO of RIOT, a FTDI to USB converter needs to be plugged to the RX/TX pins on the board.

nRF antenna selection

The Particle Mesh boards all have two antenna choices for their nRF (Bluetooth / 802.15.4) radios, a on-board antenna and a U.FL connector for an external antenna.

By default, the on-board antenna is selected at startup. That choice can be overridden by setting BOARD_NRFANTENNA_DEFAULT = EXTERNAL (as opposed to the default BUILTIN) in a project's Makefile, or at runtime using board_nrfantenna_select function.

The external antenna connection should only be enabled if a suitable antenna is connected.

Files

file  board.h
 Common board specific configuration for the Particle Mesh.
 
file  gpio_params.h
 Configuration of SAUL mapped GPIO pins.
 
file  periph_conf_common.h
 Common peripheral configuration for the Particle Mesh.