RMK

RMK is a feature-rich and easy-to-use keyboard firmware.

uf2 support

If you’re using the Adafruit_nRF52_Bootloader (pre-installed on the nice!nano), you’re in luck! This bootloader supports the .uf2 firmware format, which eliminates the need for a debugging probe to flash your firmware. RMK uses the cargo-make tool to generate .uf2 firmware, with the generation process defined in the Makefile.toml.

Follow these steps to generate and flash the .uf2 firmware with RMK:

1. Get cargo-make tool:

   cargo install --force cargo-make
   

2. Compile RMK and generates .uf2 firmware:

   cargo make uf2 --release
   

3. Flash

   • Put your board into bootloader mode. A USB drive will appear on your computer.
   • Drag and drop the generated .uf2 firmware file onto the USB drive. The RMK firmware will be automatically flashed onto your microcontroller.

   For additional details on entering bootloader mode and flashing firmware, refer to the nice!nano documentation

Tips for nRF52840

Most nice!nano compatible boards have bootloader with SoftDevice pre-flashed. Since v0.7.x, RMK will remove old SoftDevice Bluetooth stack and replace it with its own. So if you want to rollback to v0.6.x, or switch to firmwares that use SoftDevice stack(for example, zmk), you will need to re-flash the bootloader.

Additional notes

RMK defaults to USB-priority mode if a USB cable is connected. After flashing, remember to disconnect the USB cable, or switch to BLE-priority mode by pressing User11(Switch Output) key.