Troubleshooting

Flashing the bundled firmware fails

There are a number of reasons flashing the bundled firmware can fail. The two most common ones are insufficient permissions, and forgetting to put the keyboard into programmable mode.

To flash a new firmware, most keyboards require you to put them into a programmable mode. For example, on the Keyboardio Model01, this means holding the Prog key when flashing - but the firmware update page will tell you what to do in most cases.

The other common cause is insufficient permissions. The user running Chrysalis needs to have access to the keyboard device. When connecting to the keyboard with Chrysalis, it will list the device filename under the keyboard name on the keyboard selection screen. The user running Chrysalis needs to have write access to this file. On Linux and OSX, you can look at the permissions by running ls -l <FILENAME>, and looking at the permissions and the owner. In most cases, adding your user to the group that owns the device, and logging in again is sufficient. You can do this with adduser $(whoami) <group> on Linux, and with usermod on OSX.