Skip to main content
Flashing MinimalPad firmware is straightforward — double-click reset, drag the UF2 file onto the bootloader drive, done. A few things can get in the way, though. Find your situation in the sections below.
  • Check your USB-C cable. Charge-only cables will not work. Use a data-capable USB-C cable — one you know carries data, such as a cable that came with a phone or a labeled USB 2.0/3.x cable.
  • Try a different USB port. Avoid hubs — connect directly to your computer. Try a different port on the machine itself.
  • Vary the double-click speed. The bootloader entry requires two presses of the reset button in quick succession, but not too fast. Try a slightly slower or faster double-click rhythm.
  • Check whether the device appears as a serial port instead. If MinimalPad shows up as a normal serial device but not as a storage drive, you are running firmware rather than the bootloader. Double-click reset while the cable is connected and the device is powered on.
  • Try triple-clicking or holding the reset button. Some NRF52840 clones have slightly different bootloader entry behaviour. If double-clicking consistently fails, try three quick clicks or holding the button for two seconds.
This is expected behaviour and means the flash was successful. When you copy a UF2 file onto the bootloader drive, the controller validates and writes the firmware, then automatically restarts and unmounts the drive. Wait a few seconds — the MinimalPad will reboot into the new firmware on its own. No further action is needed.
  • Confirm you flashed minimalpad_with_studio. Other firmware, such as an older build without ZMK Studio, doesn’t work with either configurator.
  • Download the firmware again as described in Update the firmware, enter the bootloader by double-clicking reset, and copy the file onto the drive.
  • Flashing keeps the key changes you saved. If a key does something unexpected, check it in your configurator.
Turn them on once. On the default keymap, hold the bottom-right key to open the Connections & LEDs layer, then press the encoder.
Flashing keeps the pad’s Bluetooth pairings, but some computers don’t reconnect cleanly after a firmware update. If that happens, follow Bluetooth problems to pair the pad again.
The name of the bootloader drive depends on which controller your MinimalPad uses:
  • Nice!Nano V2 — the drive appears as NICENANO.
  • Generic NRF52840 clone — the drive name may differ. After double-clicking reset, look for a new removable storage device that appears in your file manager or Finder. The UF2 copy procedure is identical regardless of the drive name.
If the device appears frozen, the drive did not appear, or something else went wrong mid-flash:
  1. Unplug the MinimalPad from USB.
  2. Wait at least 10 seconds.
  3. Plug it back in.
  4. Double-click the reset button to enter the bootloader.
  5. Copy the UF2 file onto the drive again.
Repeating this process is safe. The bootloader is stored in protected memory and cannot be overwritten by a UF2 flash.
For the full walkthrough, see Update the firmware. If your device is completely unresponsive and the bootloader cannot be entered, see Recovery.