NRF52 Platform

This component contains platform-specific options for the NRF52 platform.

ℹ️ Note

Support for all aspects of ESPHome on the NRF52 is still in development.

# Example configuration entry
nrf52:
  board: adafruit_feather_nrf52840

Configuration variables

• board (Required, string): The board type. Valid options are adafruit_feather_nrf52840, adafruit_itsybitsy_nrf52840, xiao_ble. Other boards should work with those configuration as well.
• bootloader (Optional, string): Bootloader type. Valid options are mcuboot, adafruit, adafruit_nrf52_sd132, adafruit_nrf52_sd140_v6, adafruit_nrf52_sd140_v7. Default value depends on board type.

Getting Started

The nRF52840 requires a bootloader, with two supported options: MCUboot and Adafruit nRF52 Bootloader. It is recommended to use MCUboot as it supports OTA (Over-The-Air) updates. Your board most likely comes with a manufacturer-provided bootloader. ESPHome determines the bootloader type based on the board name.

Examples of low power nRF52840 boards.

Flashing with Adafruit nRF52 Bootloader

For Adafruit, ProMicro nRF52840, Seeed Studio XIAO BLE boards via a flash drive.

1. Connect the board to the PC via USB.
2. Quickly short the reset pin to ground twice.
3. Copy the UF2 package to the flash drive.

This bootloader supports updates over USB CDC.

1. Connect the board to the PC via USB.
2. Quickly short the reset pin to ground twice.
3. Run esphome upload yourfile.yaml.

# Example configuration entry
nrf52:
  board: adafruit_itsybitsy_nrf52840

Flashing with MCUboot

Flashing this bootloader requires an SWD connection, for which a programmer is necessary. A cheap ST-Link V2 can be utilized.

1. Connect the board to the PC via SWD.
2. Run esphome upload yourfile.yaml --device PYOCD.

# Example configuration entry
nrf52:
  board: adafruit_feather_nrf52840

GPIO Pin Numbering

There are two ways to reference GPIO pins:

1. By pin name, e.g., P0.15 or P1.11.
2. By pin number, e.g., 15 or 43.

DFU (Device Firmware Update)

The dfu component enables automatic entry into DFU (Device Firmware Update) mode by monitoring the USB CDC serial connection. When a host opens the port at 1200 baud, the component triggers a reset via a GPIO pin to put the device into DFU mode.

ESPHome uses this component internally when uploading firmware via:

esphome upload d.yaml

Example Configuration

nrf52:
  dfu:
    reset_pin:
      number: 14
      inverted: true

Configuration variables

• reset_pin (Required, Pin): The pin to use for trigger a hardware reset. This pin should be connected to the MCU’s reset line or to a circuit that causes the bootloader to enter DFU mode after reset.

See Also

• ESPHome Core Configuration

• Guidelines for Adafruit Bootloader Memory Map