About Split Keyboards - Wireless

Firmware

Where to find and how to install the firmware.

Keycaps

Almost there - let's add the keycaps!

Next steps

You've successfully assembled the keyboard. What's next?

Where to find firmware

The dongle and each keyboard half will have it's own firmware depending on what module you have installed.

You can find your firmware files using our Firmware Finder which can be found at https://splitkb.com/fw.

Go to the Firmware Finder

Flashing firmware

Warning: Both halves and the dongle, if present, will need to be flashed individually.

Info: Now it's a good time to also grab your Halcyon dongle.

When you have downloaded the correct firmware for each half of the keyboard and the dongle you can start flashing the firmware.

First, insert the dongle in to the computer. On your computer you will see a new device pop up called HALCYON.

Drag and drop or copy and paste the firmware file in to the HALCYON device.

If it is flashed successfully the device will get disconnected and after a couple of seconds. The flashing process may take a couple of seconds depending on which firmware you're installing. The process is similar on Windows, Linux and Mac.

Flashing the keyboard on Linux (KDE Plasma).

You can now plug in the left half in to the computer and repeat the steps above. Finally, repeat this for the right half as well.

Warning: On the wireless controller you will need to press the reset button once after flashing the firmware due to a bug.

Plugged in keyboard half.

You have now successfully installed the firmware on to the keyboard!

Info: The halves themselves will not output anything to the computer, even when connected with a USB-cable. You must connect the dongle to the computer.

Troubleshooting

If you encounter any issues flashing your wireless keyboard, please refer to the ZMK documentation page.

Go to the ZMK flashing issues page

Keycaps

Almost there - let's add the keycaps!

Next steps

You've successfully assembled the keyboard. What's next?

Questions? Help us improve!

Do you have questions after reading the documentation? Do you have feedback about this page, or about the documentation in general? Please send us an email. You can use the buttons below which will open your mail client or app with a template, or send your mail to support@splitkb.com.

I have a question I'd like to share feedback