Skip to main content

Troubleshooting

USB & bootloader​

Cannot enter flashing mode​

  • Try a stable data cable and reconnect.
  • Retry using the bootloader steps for your specific model (see Wired Flashing).

Flash failed​

  • Verify that firmware matches your model, revision, and layout.
  • Re-download the firmware file and flash again.

Some keys are wrong after flashing​

  • Roll back to the recommended firmware for your model first.
  • Check whether the selected keymap matches your board and layout.

Wireless (BLE / 2.4G / pairing slots)​

A wireless device cannot be found​

  • Follow the matching backend in Unbox and connect. Legacy BLE has no five independent slots; do not apply DuoChord / TriChord channel instructions to it.
  • TriChord / Command65 PE: select a channel, then hold both Shift keys and press X twice within 1 second (or press a mapped PAR once). DuoChord X is a single press.
  • For 2.4G, see receiver reset and pairing. CLR clears keyboard-side pairings, not receiver settings; use it only after other checks.

Stuck keys on Bluefruit​

  • Verify the matrix in wired mode first.
  • Bluefruit uses an AT text protocol; very fast typing may drop characters. See Legacy BLE firmware.

Wireless does not work after migrating to DuoChord​

  • Follow the fixed first migration sequence: flash AVR DuoChord firmware → hold both Shift keys and press F twice within 1 second for DfuTarg → OTA → re-pair.

VIA / Vial not detected​

  • TriChord models: press Left Shift + Right Shift + U to switch to USB mode first.
  • Follow VIA DESIGN and JSON steps, load the matching definition and authorize the device again.
  • Try another cable and confirm the model/revision.

Lighting, encoder, magnetic switches​

  • Lighting/encoder issues: confirm you flashed the firmware for the correct model and rev (Skog rev A/B are not interchangeable).
  • F60 revM magnetic behavior: confirm you flashed F60 revM firmware; magnetic details follow the actual hardware.

Known issues by model​

  • The "Troubleshooting" section of each model page lists model-specific symptoms; models without unique symptoms follow the common items on this page.