Bond Reset Instructions (nvsclear)

The dongle (central) will bond with the keyboard halves (peripherals) upon discovering them for the first time (see split dongle page for terminology). This is necessary to prevent unknown dongles from receiving data from your keyboard halves or unknown keyboard halves from sending data to your dongle. The same applies in a dongleless setup where the left central half will bond with the right peripheral half.

In certain cases, the bond may be messed up or need to be reset. You will need to undergo the non-volatile storage (NVS) clearing process if:

  • You are switching from one dongle to another.
  • You received a replacement keyboard PCB.
  • You are switching from a dongleless setup to a dongle setup (follow "Reset Instructions with Dongle").
  • You are switching from a dongle setup to a dongleless setup (follow "Reset Instructions without Dongle").

In the event that one or both halves is not work for any apparent reason, this process is also recommended.

Download

Blue and Green refer to two different microprocessors that we use for our keyboard PCBs and dongles. The bootloader INFO_UF2.TXT file for each half should designate whether you it's "blue" or "green". Please be sure to check for both keyboard halves; they may be different.

Notes

  • Older Raytac MDBT50Q-RX (if it does not say green) is blue, newer Raytac MDBT50Q-RX explicitly say green.
  • Nordic nRF52840 Dongle is blue.
  • On older keyboard PCBs, it may list a version without blue/green. If that is the case, please check the peripheral firmware page for the color in parenthesis.

Reset Instructions with Dongle

  1. Start by clearing the dongle.
    1. Put dongle into bootloader mode. LED should pulse slowly.
    2. Copy nvsclear.uf2 to dongle. LED will flash very quickly while it's flashing. When it's done, it will automatically reenter bootloader mode and LED will pulse slowly.
    3. Unplug dongle.
  2. Continue by clearing the left half.
    1. Plug in left half and put it into bootloader mode (by pressing reset twice in 500ms). LED should pulse slowly.
    2. Copy nvsclear.uf2 to left half. LED will flash very quickly while it's flashing. When it's done, it will automatically reenter bootloader mode and LED will pulse slowly.
    3. Copy peripheral-left.uf2 to left half. LED will flash very quickly while it's flashing. When it's done, LED will turn off.
    4. Unplug left half.
    5. Press reset once to reboot (LED should blink twice).
  3. Continue by clearing the right half (repeat previous section accordingly).
  4. Finish by reestablishing the bonds.
    1. Plug in dongle. It should automatically be in bootloader mode.
    2. Make sure it's been at least 15 seconds since you pressed reset on the right half.
    3. Copy zmk-dongle.uf2 to dongle from keymap configurator (be sure to select the appropriate dongle). When it's done, LED will turn off.
    4. Unplug and plug dongle.
    5. Press a few keys on both halves. Give it around 10 seconds for dongle to discover them and connect.

Reset Instructions without Dongle

  1. Start by clearing the left half.
    1. Plug in left half and put it into bootloader mode (by pressing reset twice in 500ms). LED should pulse slowly.
    2. Copy nvsclear.uf2 to left half. LED will flash very quickly while it's flashing. When it's done, it will automatically reenter bootloader mode and LED will pulse slowly.
    3. Unplug left half.
  2. Continue by clearing the right half.
    1. Plug in right half and put it into bootloader mode (by pressing reset twice in 500ms). LED should pulse slowly.
    2. Copy nvsclear.uf2 to right half. LED will flash very quickly while it's flashing. When it's done, it will automatically reenter bootloader mode and LED will pulse slowly.
    3. Copy peripheral-right.uf2 to right half. LED will flash very quickly while it's flashing. When it's done, LED will turn off.
    4. Press reset once on right half to reboot (LED should blink twice).
    5. Unplug right half.
  3. Continue by flashing the left half.
    1. Plug in left half. It should automatically be in bootloader mode.
    2. Make sure it's been at least 15 seconds since you pressed reset on the right half.
    3. Copy zmk-left.uf2 to left half from keymap configurator (be sure to select the appropriate PCB version). When it's done, LED will turn off.
    4. Press reset once on left half to reboot (LED should blink twice).
    5. Press a few keys on left half. Keys should output via USB.
    6. Press a few keys on right half. Give it around 10 seconds for left half to discover the right half and connect. Keys should output via USB.
  4. Finish by configuring Bluetooth profiles to use the keyboard wirelessly.