Skip to content


Bluetooth Known Supported Hardware

Currently Bluetooth support is limited to AVR based chips. For Bluetooth 2.1, QMK has support for RN-42 modules. For more recent BLE protocols, currently only the Adafruit Bluefruit SPI Friend is directly supported. BLE is needed to connect to iOS devices. Note iOS does not support mouse input.

BoardBluetooth ProtocolConnection Typerules.mkBluetooth Chip
Roving Networks RN-42 (Sparkfun Bluesmirf)Bluetooth ClassicUARTBLUETOOTH_DRIVER = rn42RN-42
Bluefruit LE SPI FriendBluetooth Low EnergySPIBLUETOOTH_DRIVER = bluefruit_lenRF51822

Not Supported Yet but possible:

Adafruit BLE SPI Friend

Currently The only bluetooth chipset supported by QMK is the Adafruit Bluefruit SPI Friend. It's a Nordic nRF51822 based chip running Adafruit's custom firmware. Data is transmitted via Adafruit's SDEP over Hardware SPI. The Feather 32u4 Bluefruit LE is supported as it's an AVR mcu connected via SPI to the Nordic BLE chip with Adafruit firmware. If Building a custom board with the SPI friend it would be easiest to just use the pin selection that the 32u4 feather uses but you can change the pins in the config.h options with the following defines:

  • #define BLUEFRUIT_LE_CS_PIN B4

A Bluefruit UART friend can be converted to an SPI friend, however this requires some reflashing and soldering directly to the MDBT40 chip.

Bluetooth Options

The currently supported Bluetooth chipsets do not support N-Key Rollover (NKRO), so must contain NKRO_ENABLE = no.

Add the following to your

BLUETOOTH_DRIVER = bluefruit_le # or rn42

Bluetooth Keycodes

This is used when multiple keyboard outputs can be selected. Currently this only allows for switching between USB and Bluetooth on keyboards that support both.

QK_OUTPUT_AUTOOU_AUTOAutomatically switch between USB and Bluetooth