🔍 Troubleshooting

You can find common troubleshooting tips for your keyboard here. If you can't find a solution to your problem, please reach out to us on Discord!

This guide provides steps for identifying and resolving common issues with various displays (OLED, Low Power Display, nice\!view, etc.) on custom keyboards running QMK or ZMK firmware. These displays typically communicate via either I2C or SPI protocols.

📄️ Entering the Bootloader

Learn how to enter the bootloader on your controller.

📄️ Key Press Stuck

A "key press stuck until the next key is pressed" on a QMK keyboard is a frustrating issue that often points to a problem with how the key release is being registered, either in the hardware or the firmware. Here's a breakdown of common causes:

📄️ Row(s) or Column(s) Not Working

Fix row(s) or column(s) not working on your keyboard.

📄️ Single Key Not Working

Fix a single key not working on your keyboard.

📄️ Update Pro Micro Bootloader to DFU Bootloader

Swap bootloader from Caterina to DFU