General troubleshooting

All keyboards in the Halcyon Series use a cold-swappable controller. That's very convenient: when something doesn't work, it's usually one of the controllers or one of the keyboard halves that needs adjustment. On this page you'll find some common issues, and what to do about it.

One half doesn't work, but the other half does

If you have a split keyboard, it's possible that one half doesn't work. You've connected one half to your computer with a USB C cable, and you've connected the other half to that one using a USB C to C cable.

Remember to use the USB ports on the sides to connect the halves together. It won't work when using one or both ports on the top. The USB ports you'll want to use will be facing one another, when you have the keyboard laying in front of you.

Try to disconnect any modules you might use, one half at a time. Test the keyboard after removing each module. If the problem is resolved, you'll likely need a replacement for the module you've just removed.

Try to reseat your controller. They "click" in to the keyboard PCB, and they might've become loose during transport.

If the issue persists, try to swap the controllers between the halves. If the problem moves to the other half, the controller will need to be replaced. If the problem stays with the troublesome half, then the keyboard PCB will need to be replaced.

Keyboard doesn't power on

Remember to use either USB port facing up top, away from you to connect to your computer. It won't work when using a port on the side of the keyboard.

Try to disconnect any modules you might use, one half at a time. Test the keyboard after removing each module. If the problem is resolved, you'll likely need a replacement for the module you've just removed.

Try to reseat your controller. They "click" in to the keyboard PCB, and they might've become loose during transport.

If the issue persists, try to swap the controllers between the halves. If the problem moves to the other half, the controller will need to be replaced. If the problem stays with the troublesome half, then the keyboard PCB will need to be replaced.

Module doesn't work

Check whether you've flashed the correct firmware to both halves. Each combination of keyboard and module has its own unique fimware file you can flash.

If you're using Vial along with a compatible module, you'll want to enable the module in Vial. You can do so with the Encoder module and any other module that allows for keypresses or similar inputs.

Try to reseat your controller. They "click" in to the keyboard PCB, and they might've become loose during transport.

Try to install the module on the other half. To do so, remove the module first and then install it on the other half. You won't need to follow all the steps, just connecting the cable will be good enough for testing purposes.

If the issue persists, it's likely your module is defective and will need to be replaced.