7. Troubleshooting (Version 2021-09-11)
Last updated
Last updated
7.1 Opening the base plate
Take out the screws with a 3mm Allen Key then very slowly lift the plate. The plate is different from the open source design and has a holder for the USB adapter. Lifting with too much force could damage the USB adapter and the microcontroller.
Next, slide the USB adapter off the side of the holder before fully lifting the base plate. Figure 7.1 shows how the USB holder is attached on the base plate. Leave the USB adapter attached to the microcontroller, as the micro-USB port on the ProMicro can be fragile and easily dislodged.
7.2 Closing the base plate
When you close the base plate, the USB holder may push on some of the wiring. You shouldn't need to use force to close the base plate. If the base plate doesn't close with gentle pressure, carefully push away some of the wiring to make room for the USB holder.
Tighten the screws with an Allen key.
Always wash your hands after handling the insides of the keyboard.
7.2 Keyswitch is not working
Remove the keyswitch from the socket with a keyswitch puller. Check if the metal pins on the bottom of the keyswitch are straight. If any of them are bent, gently bend it straight with pliers. If you don’t have pliers, you can use the pads of your fingers to gently pinch it straight.
If the keyswitch pins are straight, open up the base plate and check if any wires have come off of the microcontroller.
7.3 Keymapping is flipped
Check whether the USB cord is connecting the left piece of the keyboard to the computer. The USB socket on the right keyboard should only be used to flash keymapping. Conceptually, your computer assumes that left side is the piece directly connected to it. It assumes the right side is other piece.
If you had not disconnected the RJ9 cord from each piece of the keyboard while flashing a new keymapping, you will need to re-flash each piece of the keyboard.
7.4 Thumb cluster not working after flashing right side of the keyboard
If the right side of the keyboard is directly connected to the computer, some keys on the thumb cluster will not register. This is normal. Simply make sure USB cable is connected to the left side of the keyboard and the RJ9 cable is connected to the right side of the keyboard. The keyboard should start working as normal.