Troubleshooting

[JohnAZoidberg]

Common Mistakes

If something is wrong, please check here to see if something went wrong during usage of the modules.

When updating firmware

• Don't put multiple modules in bootloader at the same time. The RPI-RP2 drives are indistinguishable, it's very easy to flash the firmware on the wrong device
• Only copy a single UF2 file onto the RPI-RP2.

Features

I want to remap some keys

Go to https://via.app

I want to change the backlight

Three options:

• Use the hotkey to change brightness: FN+Space
• Use the qmk_gui application
• Use https://via.app

Problems

VIA App doesn't show the keyboard

Make sure to ...TODO

Keys are not working

Please check all keys. Use a website, like https://keyboard-test.space to see what they keys do.

The keys don't type what they are supposed to

They module probably has or has had the wrong firmware. Make sure to flash the right type of firmware for the module.

ANSI firmware for an ANSI keyboard. The Enter key is rectangular and has backslash (\) above it. ISO firmware for an ISO keyboard. The Enter key is not rectangular. JIS firmware for a JIS (japanese) keyboard. Numpad firmware for a numpad. It has numbers. Macropad firmware for a macropad. It's the same size as a numpad but has more keys and no labels on them.

After flashing the right version, reset the settings (EEPROM). Use the qmk_gui application to do that.

On the keyboard, keys do nothing, but some type numbers

The keyboard probably has or has had numpad firmware. See above "The keys don't type what they are supposed to"

[github-actions[bot]]

This issue has been automatically marked as stale because it has not had activity in the last 90 days. It will be closed in the next 30 days unless it is tagged properly or other activity occurs. For maintainers: Please label with bug, in progress, on hold, discussion or to do to prevent the issue from being re-flagged.

[github-actions[bot]]

This issue has been automatically closed because it has not had activity in the last 30 days. If this issue is still valid, re-open the issue and let us know. // [stale-action-closed]