BL654 USB (451-00004)
Overview
The BL654 USB adapter hardware (Ezurio part 451-00004) provides support for the Ezurio BL654 module powered by a Nordic Semiconductor nRF52840 ARM Cortex-M4F CPU.
The BL654 USB adapter has the following features:
CLOCK
FLASH
GPIO
MPU
NVIC
PWM
RADIO (Bluetooth Low Energy and 802.15.4)
RTC
USB
WDT
BL654 USB Adapter PCB
More information about the BL654 USB adapter can be found in the BL654 USB Dongle Quick Start Guide [1]. There is more information on the BL654 range on the BL654 website [2].
Hardware
The bl654_usb has two external oscillators. The frequency of
the slow clock is 32.768 kHz. The frequency of the main clock
is 32 MHz.
Supported Features
The bl654_usb board supports the hardware features listed below.
- on-chip / on-board
- Feature integrated in the SoC / present on the board.
- 2 / 2
-
Number of instances that are enabled / disabled.
Click on the label to see the first instance of this feature in the board/SoC DTS files. -
vnd,foo -
Compatible string for the Devicetree binding matching the feature.
Click on the link to view the binding documentation.
bl654_usb/nrf52840 target
Type |
Location |
Description |
Compatible |
|---|---|---|---|
CPU |
on-chip |
ARM Cortex-M4F CPU1 |
|
ADC |
on-chip |
Nordic Semiconductor nRF family SAADC node1 |
|
ARM architecture |
on-chip |
Nordic UICR (User Information Configuration Registers)1 |
|
on-chip |
Nordic EGU (Event Generator Unit)6 |
||
on-chip |
Nordic nRF family ACL (Access Control List)1 |
||
on-chip |
Nordic nRF family MWU (Memory Watch Unit)1 |
||
Audio |
on-chip |
Nordic PDM (Pulse Density Modulation interface)1 |
|
Clock control |
on-chip |
Nordic nRF clock control node1 |
|
on-chip |
Nordic nRF high-frequency crystal oscillator (nRF52 series)1 |
||
Comparator |
on-chip |
Nordic nRF COMP (analog COMParator)1 |
|
Counter |
on-chip |
Nordic nRF timer node5 |
|
Cryptographic accelerator |
on-chip |
Nordic ECB (AES electronic codebook mode encryption)1 |
|
on-chip |
Nordic nRF family CCM (AES CCM mode encryption)1 |
||
on-chip |
ARM TrustZone CryptoCell 3101 |
||
Debug |
on-chip |
ARMv7 instrumentation trace macrocell1 |
|
Flash controller |
on-chip |
Nordic NVMC (Non-Volatile Memory Controller)1 |
|
on-chip |
Properties defining the interface for the Nordic QSPI peripheral1 |
||
GPIO & Headers |
on-chip |
NRF5 GPIOTE1 |
|
on-chip |
NRF5 GPIO2 |
||
I2C |
on-chip |
Nordic nRF family TWIM (TWI master with EasyDMA)2 |
|
I2S |
on-chip |
Nordic I2S (Inter-IC sound interface)1 |
|
IEEE 802.15.4 |
on-chip |
Nordic nRF IEEE 802.15.4 node1 |
|
Interrupt controller |
on-chip |
ARMv7-M NVIC (Nested Vectored Interrupt Controller)1 |
|
LED |
on-board |
Group of GPIO-controlled LEDs1 |
|
on-board |
Group of PWM-controlled LEDs1 |
||
Miscellaneous |
on-chip |
Nordic FICR (Factory Information Configuration Registers)1 |
|
on-chip |
Nordic nRF family PPI (Programmable Peripheral Interconnect)1 |
||
MTD |
on-chip |
Flash node1 |
|
on-board |
Fixed partitions of a flash (or other non-volatile storage) memory1 |
||
Networking |
on-chip |
Nordic nRF family RADIO peripheral1 |
|
on-chip |
Nordic nRF family NFCT (Near Field Communication Tag)1 |
||
Pin control |
on-chip |
Nordic nRF family Pin Controller1 |
|
Power management |
on-chip |
Nordic nRF power control node1 |
|
PWM |
on-chip |
||
on-chip |
nRFx S/W PWM1 |
||
Regulator |
on-chip |
Nordic nRF5X regulator (fixed stage of the core supply)1 |
|
on-chip |
Nordic nRF52X regulator (high voltage stage of the main supply)1 |
||
Retained memory |
on-chip |
Nordic GPREGRET (General Purpose Register Retention) device2 |
|
RNG |
on-chip |
Nordic nRF family RNG (Random Number Generator)1 |
|
RTC |
on-chip |
Nordic nRF RTC (Real-Time Counter)3 |
|
Sensors |
on-chip |
Nordic nRF family TEMP node1 |
|
on-chip |
Nordic nRF quadrature decoder (QDEC) node1 |
||
Serial controller |
on-chip |
Nordic nRF family UARTE (UART with EasyDMA)2 |
|
SPI |
on-chip |
Nordic nRF family SPIM (SPI master with EasyDMA)4 |
|
SRAM |
on-chip |
Generic on-chip SRAM1 |
|
Timer |
on-chip |
ARMv7-M System Tick1 |
|
USB |
on-chip |
Nordic nRF52 USB device controller1 |
|
Watchdog |
on-chip |
Nordic nRF family WDT (Watchdog Timer)1 |
bl654_usb/nrf52840/bare target
Type |
Location |
Description |
Compatible |
|---|---|---|---|
CPU |
on-chip |
ARM Cortex-M4F CPU1 |
|
ADC |
on-chip |
Nordic Semiconductor nRF family SAADC node1 |
|
ARM architecture |
on-chip |
Nordic UICR (User Information Configuration Registers)1 |
|
on-chip |
Nordic EGU (Event Generator Unit)6 |
||
on-chip |
Nordic nRF family ACL (Access Control List)1 |
||
on-chip |
Nordic nRF family MWU (Memory Watch Unit)1 |
||
Audio |
on-chip |
Nordic PDM (Pulse Density Modulation interface)1 |
|
Clock control |
on-chip |
Nordic nRF clock control node1 |
|
on-chip |
Nordic nRF high-frequency crystal oscillator (nRF52 series)1 |
||
Comparator |
on-chip |
Nordic nRF COMP (analog COMParator)1 |
|
Counter |
on-chip |
Nordic nRF timer node5 |
|
Cryptographic accelerator |
on-chip |
Nordic ECB (AES electronic codebook mode encryption)1 |
|
on-chip |
Nordic nRF family CCM (AES CCM mode encryption)1 |
||
on-chip |
ARM TrustZone CryptoCell 3101 |
||
Debug |
on-chip |
ARMv7 instrumentation trace macrocell1 |
|
Flash controller |
on-chip |
Nordic NVMC (Non-Volatile Memory Controller)1 |
|
on-chip |
Properties defining the interface for the Nordic QSPI peripheral1 |
||
GPIO & Headers |
on-chip |
NRF5 GPIOTE1 |
|
on-chip |
NRF5 GPIO2 |
||
I2C |
on-chip |
Nordic nRF family TWIM (TWI master with EasyDMA)2 |
|
I2S |
on-chip |
Nordic I2S (Inter-IC sound interface)1 |
|
IEEE 802.15.4 |
on-chip |
Nordic nRF IEEE 802.15.4 node1 |
|
Interrupt controller |
on-chip |
ARMv7-M NVIC (Nested Vectored Interrupt Controller)1 |
|
LED |
on-board |
Group of GPIO-controlled LEDs1 |
|
on-board |
Group of PWM-controlled LEDs1 |
||
Miscellaneous |
on-chip |
Nordic FICR (Factory Information Configuration Registers)1 |
|
on-chip |
Nordic nRF family PPI (Programmable Peripheral Interconnect)1 |
||
MTD |
on-chip |
Flash node1 |
|
on-board |
Fixed partitions of a flash (or other non-volatile storage) memory1 |
||
Networking |
on-chip |
Nordic nRF family RADIO peripheral1 |
|
on-chip |
Nordic nRF family NFCT (Near Field Communication Tag)1 |
||
Pin control |
on-chip |
Nordic nRF family Pin Controller1 |
|
Power management |
on-chip |
Nordic nRF power control node1 |
|
PWM |
on-chip |
||
on-chip |
nRFx S/W PWM1 |
||
Regulator |
on-chip |
Nordic nRF5X regulator (fixed stage of the core supply)1 |
|
on-chip |
Nordic nRF52X regulator (high voltage stage of the main supply)1 |
||
Retained memory |
on-chip |
Nordic GPREGRET (General Purpose Register Retention) device2 |
|
RNG |
on-chip |
Nordic nRF family RNG (Random Number Generator)1 |
|
RTC |
on-chip |
Nordic nRF RTC (Real-Time Counter)3 |
|
Sensors |
on-chip |
Nordic nRF family TEMP node1 |
|
on-chip |
Nordic nRF quadrature decoder (QDEC) node1 |
||
Serial controller |
on-chip |
Nordic nRF family UARTE (UART with EasyDMA)2 |
|
SPI |
on-chip |
Nordic nRF family SPIM (SPI master with EasyDMA)4 |
|
SRAM |
on-chip |
Generic on-chip SRAM1 |
|
Timer |
on-chip |
ARMv7-M System Tick1 |
|
USB |
on-chip |
Nordic nRF52 USB device controller1 |
|
Watchdog |
on-chip |
Nordic nRF family WDT (Watchdog Timer)1 |
See the BL654 website [2] for a complete list of BL654 USB adapter hardware features.
Connections and IOs
LED
LED1 (blue) = P0.13
Serial Port
Zephyr console output is available as follows:
using the USB connector, which may be used to make the console available on PC as USB CDC class.
Programming and Debugging
The bl654_usb board supports the runners and associated west commands listed below.
| flash | debug | debugserver | rtt | attach | |
|---|---|---|---|---|---|
| jlink | ✅ | ✅ (default) | ✅ | ✅ | ✅ |
| nrfjprog | ✅ | ||||
| nrfutil | ✅ (default) | ||||
| pyocd | ✅ | ✅ | ✅ | ✅ | ✅ |
Applications for the bl654_usb board configuration can be
built in the usual way (see Building an Application for more details). The
bl654_usb board can be used for debugging, but the compatible BL654 DVK
board may be preferable for convenience. Documentation can be found at the BL654 DVK
site and boards/ezurio/bl654_dvk/doc/bl654_dvk.rst
Flashing
The board supports the following programming options:
Using the built-in bootloader only
Using an external debug probe
These instructions use the west tool and assume you are in the root directory of your west installation.
Option 1: Using the Built-In Bootloader Only
The board is factory-programmed with Nordic’s bootloader from Nordic’s nRF5 SDK. With this option, you’ll use Nordic’s nrfutil [4] program to create firmware packages supported by this bootloader and flash them to the device. Before proceeding make sure:
nrfutilis installed.The
nrf5sdk-toolscommand is installed withinnrfutil.
With the adapter plugged in, reset the board into the bootloader by pressing the RESET button.
The push button is in a pin-hole on the logo side of the USB adapter.
The blue LED should start a fade pattern, signalling the bootloader is running.
Compile a Zephyr application; we’ll use Blinky.
west build -b bl654_usb zephyr/samples/basic/blinky
Package the application for the bootloader using
nrfutil:nrfutil nrf5sdk-tools pkg generate \ --hw-version 52 \ --sd-req=0x00 \ --application build/zephyr/zephyr.hex \ --application-version 1 \ blinky.zip
Flash it onto the board. Note
/dev/ttyACM0is for Linux; it will be something likeCOMxon Windows, and something else on macOS.nrfutil nrf5sdk-tools dfu usb-serial -pkg blinky.zip -p /dev/ttyACM0When this command exits, observe the blue LED on the board blinking, instead of the fade pattern used by the bootloader.
For more information, see Nordic Semiconductor USB DFU [3].
Option 2: Using an External Debug Probe
If you have one, you can also use an external debug probe to flash and debug Zephyr applications, but you need to solder an SWD header to the board. Connection points can be found in the board schematics [5].
For Segger J-Link debug probes, follow the instructions in the Nordic nRF5x Segger J-Link page to install and configure all the necessary software. Further information can be found in Flashing.
Use the bl654_usb/bare board variant to build your application.
This variant uses a modified partition table, which does not reserve space for
the onboard USB bootloader.
Then build and flash applications as usual (see Building an Application and Run an Application for more details).
Here is an example for the Blinky application.
# From the root of the zephyr repository
west build -b bl654_usb/nrf52840/bare samples/basic/blinky
west flash
Observe the LED on the board blinking.
Debugging
The bl654_usb board does not have an on-board J-Link debug IC
as some Ezurio development boards, however, instructions from the
Nordic nRF5x Segger J-Link page also apply to this board, with the additional step
of connecting an external debugger.
Testing the LED on the BL654 USB
There is a sample that allows you to test that the LED on the board is working properly with Zephyr:
You can build and flash the example to make sure Zephyr is running correctly on your board. The LED definitions can be found in boards/ezurio/bl654_usb/bl654_usb.dts.
Testing Bluetooth on the BL654 USB
Many of the Bluetooth examples will work on the BL654 USB. Try them out: