6. Troubleshooting (Version 2021-06-24)
6.1 Opening the base plate
Take out the screws, then very slowly lift the plate. The plate is different from the open source design and has a holder for the USB adapter. Slide the USB adapter off the side of the holder before fully lifting the base plate. Figure 1 shows how the USB holder is attached on 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. Figure 2 shows the space occupied by the USB holder when the base plate is closed.
When closing the base plate, tighten the screws with your fingers. Using an Allen Key will loosen the brass screw inserts.
Always wash your hands after handling the insides of the keyboard.
6.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. If you have a hotswappable keyboard, check to see if any hotswap sockets are loose by pushing on them.
6.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.
Last updated
