nRF Desktop: Board configuration

The nRF Desktop application is modular. Depending on requested functions, it can provide mouse, keyboard, or dongle functionality. The selection of modules depends on the chosen role and also on the selected reference design. For more information about modules available for each configuration, see Application overview.

For a board to be supported by the application, you must provide a set of configuration files at applications/nrf_desktop/configuration/your_board_name. The application configuration files define both a set of options with which the nRF Desktop application will be created for your board and the selected nRF Desktop build types. Include the following files in this directory:

Mandatory configuration files

  • Application configuration file for the debug build type (prj.conf).

  • Configuration files for the selected modules.

Optional configuration files

  • Application configuration files for other build types.

  • Configuration file for the bootloader.

  • Memory layout configuration.

  • DTS overlay file.

See Adding a new board for information about how to add these files.

nRF Desktop board configuration files

The nRF Desktop application comes with configuration files for the following reference designs:

nRF52840 Gaming Mouse (nrf52840gmouse_nrf52840)

  • The reference design is defined in nrf/boards/arm/nrf52840gmouse_nrf52840 for the project-specific hardware.

  • To achieve gaming-grade performance:

    • The application is configured to act as a gaming mouse, with both Bluetooth LE and USB transports enabled.

    • Bluetooth is configured to use Nordic’s SoftDevice link layer.

  • The configuration with the B0 bootloader is set as default.

  • The board supports debug (prj_fast_pair.conf) and release (prj_release_fast_pair.conf) Fast Pair configurations. Both configurations use the MCUboot bootloader built in the direct-xip mode (MCUBOOT+XIP), and they support the firmware updates using the Device Firmware Upgrade module and the Device Firmware Upgrade MCUmgr module.

nRF52832 Desktop Mouse (nrf52dmouse_nrf52832) and nRF52810 Desktop Mouse (nrf52810dmouse_nrf52810)

  • Both reference designs are meant for the project-specific hardware and are defined in nrf/boards/arm/nrf52dmouse_nrf52832 and nrf/boards/arm/nrf52810dmouse_nrf52810, respectively.

  • The application is configured to act as a mouse.

  • Only the Bluetooth LE transport is enabled. Bluetooth uses either Zephyr’s software link layer (nrf52810dmouse_nrf52810) or Nordic’s SoftDevice link layer (nrf52dmouse_nrf52832).

  • The preconfigured build types for both nrf52dmouse_nrf52832 and nrf52810dmouse_nrf52810 boards are without the bootloader due to memory size limits on the nrf52810dmouse_nrf52810 board.

Sample mouse, keyboard or dongle (nrf52840dk_nrf52840)

  • The configuration uses the nRF52840 Development Kit.

  • The build types allow to build the application as mouse, keyboard or dongle.

  • Inputs are simulated based on the hardware button presses.

  • The configuration with the B0 bootloader is set as default.

  • The board supports debug Fast Pair configuration that acts as a mouse (prj_fast_pair.conf). The configuration uses the MCUboot bootloader built in the direct-xip mode (MCUBOOT+XIP), and supports firmware updates using the Device Firmware Upgrade module and the Device Firmware Upgrade MCUmgr module.

Sample dongle (nrf52833dk_nrf52833)

  • The configuration uses the nRF52833 Development Kit.

  • The application is configured to act as a dongle that forwards data from both mouse and keyboard.

  • Bluetooth uses Nordic Semiconductor’s SoftDevice link layer and is configured to act as a central. Input data comes from Bluetooth and is retransmitted to USB.

  • The configuration with the MCUboot bootloader is set as default.

Sample dongle (nrf52833dk_nrf52820)

  • The configuration uses the nRF52820 emulation on the nRF52833 Development Kit.

  • The application is configured to act as a dongle that forwards data from both mouse and keyboard.

  • Bluetooth uses Zephyr’s software link layer and is configured to act as a central. Input data comes from Bluetooth and is retransmitted to USB.

  • The preconfigured build types configure the device without the bootloader in debug mode and with MCUboot bootloader in release mode due to memory size limits.

nRF52832 Desktop Keyboard (nrf52kbd_nrf52832)

  • The reference design used is defined in nrf/boards/arm/nrf52kbd_nrf52832 for the project-specific hardware.

  • The application is configured to act as a keyboard, with the Bluetooth LE transport enabled.

  • Bluetooth is configured to use Nordic Semiconductor’s SoftDevice link layer.

  • The preconfigured build types configure the device without the bootloader in debug mode and with B0 bootloader in release mode due to memory size limits.

  • The board supports release Fast Pair configuration (prj_release_fast_pair.conf). The configuration uses the MCUboot bootloader built in the direct-xip mode (MCUBOOT+XIP), and supports firmware updates using the Device Firmware Upgrade module and the Device Firmware Upgrade MCUmgr module.

nRF52840 USB Dongle (nrf52840dongle_nrf52840) and nRF52833 USB Dongle (nrf52833dongle_nrf52833)

  • Since the nRF52840 Dongle is generic and defined in Zephyr, project-specific changes are applied in the DTS overlay file.

  • The application is configured to act as a dongle that forwards data from both mouse and keyboard.

  • Bluetooth uses Nordic Semiconductor’s SoftDevice link layer and is configured to act as a central. Input data comes from Bluetooth and is retransmitted to USB.

  • The configuration with the B0 bootloader is set as default for the nrf52840dongle_nrf52840 board and with the MCUboot bootloader is set as default for the nrf52833dongle_nrf52833 board.

nRF52820 USB Dongle (nrf52820dongle_nrf52820)

  • The application is configured to act as a dongle that forwards data from both mouse and keyboard.

  • Bluetooth uses Zephyr’s software link layer and is configured to act as a central. Input data comes from Bluetooth and is retransmitted to USB.

  • The preconfigured build types configure the device without the bootloader in debug mode and with MCUboot bootloader in release mode due to memory size limits.

Sample dongle (nrf5340dk_nrf5340)

  • The application is configured to act as a dongle that forwards data from both mouse and keyboard.

  • Bluetooth uses Nordic Semiconductor’s SoftDevice link layer without LLPM and is configured to act as a central. Input data comes from Bluetooth and is retransmitted to USB.

  • The configuration with the B0 bootloader is set as default.

Sample mouse or keyboard (nrf54l15pdk_nrf54l15_cpuapp)

  • The configuration uses the nRF54L15 Preview Development Kit (PDK).

  • The build types allow to build the application as a mouse or a keyboard.

  • Inputs are simulated based on the hardware button presses. On the PDK PCA10156, revision v0.2.1 AB0-ES5, GPIOs assigned to Button 3 and Button 4 do not support interrupts. Because of this, the application cannot use those buttons.

  • Only Bluetooth LE transport is enabled. Bluetooth LE is configured to use Nordic Semiconductor’s SoftDevice Link Layer and Low Latency Packet Mode (LLPM).

  • In debug configurations, logs are provided through the UART. For detailed information on working with the nRF54L15 PDK, see the Getting started with the nRF54L15 PDK documentation.

  • The configurations use the MCUboot bootloader built in the direct-xip mode (MCUBOOT+XIP) and support firmware updates using the Device Firmware Upgrade module.