Firmware

This page will eventually contain Vial/ZMK (and possibly KMK) firmware images for all our kits. It might unfortunately take a while due to our limited resources.

The Vial firmware allows for keymap modification on the fly, without modifying/recompiling/reflashing the firmware, using the Vial software or the Vial web app.

The ZMK firmware for some kits now supports the ZMK Studio, which is a feature similar to Vial that allows the keymap to be modified using the ZMK Studio software or the ZMK Studio web app.

Erase Flash

If you want to completely erase the flash of the controller (which will also wipe any configuration stored in the emulated EEPROM), use these special firmware files:

• Frood: frood-erase-flash.uf2

Frood Testing

To test all the digital pins on the Frood controller, please follow this guide.

Please note this should be done with the controller removed from the keyboard to avoid false readings due to the board circuitry.

1. Flash the following testing firmware to the Frood: 42keebs_frood_tester_manual_vial.uf2
2. Open the Vial software, switch to the “Matrix tester” tab and click the “Unlock” button at the bottom right
3. Using a short piece of wire, short the pin “D0” to any of the GND pins (marked “GND”, “G|D10” and “G|D11”) and keep it shorted until the controller is unlocked
4. Short each of the “D” pins to ground to test them (as in the previous step). If the pin works correctly, it will be highlighted in white

If you can’t/don’t want to use the Vial software, you can also just flash the testing firmware, short each digital pin to ground and observe if the correct keypress is generated. All the digital pins generate numpad number keypresses (0-9), so you need to have the Num Lock turned on:

• Pins D0-D9 on the left hand side generate numbers 0-9
• Pins D12-D16 along the bottom edge generate numbers 2-6
• Pins D2x on the right hand side generate number x (i.e. pin D23 generates number 3)

Other Boards

If you can’t find the firmware you are looking for here, please let us know. It might also be available:

• In the official QMK Firmware repository or QMK Configurator for unmodified kits, or
• In the 42. Keebs QMK Firmware GitHub fork for kits significantly modified by us,

Apologies if some of the firmwares are not up to date – please let us know and we’ll try to fix that for you ASAP.

Sources

Source code for all firmwares can be found in the following repositories (but not necessarily with all the configuration):

• 42. Keebs QMK Fork
• 42. Keebs Vial Fork
• 42. Keebs ZMK fork