Firmware

The firmware is developped on top of the QMK project and a reference implementation is included in the official project.

Our repository contains a version with additional features and can be compiled in combination with the QMK tree.

The latest binary firmware is available here as HEX file.

How to (re)flash the firmware?

The firmware, in the form of HEX binaries, can be easily flashed over USB.

Windows and macOS

First put the keyboard in RESET mode (see section below), then use the QMK Toolbox.

Linux

  1. Install dfu-programmer, it is available as a package in most distributions, or you can get the latest version from their repository.
# Debian/Ubuntu
sudo apt install dfu-programmer
# Arch
sudo pacman -S dfu-programmer
  1. Put the keyboard in RESET mode (see section below)

  2. Check that the keyboard is seen in reset mode

sudo dfu-programmer atmega32u4 get

Proceed with steps below only if Bootloader Version: 0x00 (0) (or similar) is shown, if not, go back to step 2.

  1. Erase and flash the new firmware
sudo dfu-programmer atmega32u4 erase --force
sudo dfu-programmer atmega32u4 flash adm42.hex
sudo dfu-programmer atmega32u4 reset

For further details on utilizing dfu-programmer and configuring the appropriate permissions to avoid the need for sudo, please refer to the QMK FAQ.

RESET Mode

RESET Mode (also known as Bootloader Mode) can be activated in three ways:

  • Keycode in layout
    • Activate by pressing the RESET key located at the top left on the System Layer
    • Upon entering RESET mode, the LED effects will freeze
  • Bootmagic reset
    • Hold down the top left key (left Super) and plug in the keyboard
    • This action also resets all settings to their default values by erasing the EEPROM
  • Physical reset button
    • While the keyboard is plugged in, remove the bottom lid and briefly press the button located on the back of the PCB

If you decide not to proceed (and only before starting the flashing process), simply disconnect and then reconnect the keyboard.

Changelog

  • 2023-09-11: First stable version
  • 2023-10-02: Dvorak layout added
  • 2023-11-20: Colemak layout added, ADM42 RGB effect added
  • 2024-01-15: Dvorak layout fix
  • 2024-02-05: Additional configuration options on System layer
    • Pending MODs (OS detection disabled)
    • Opposite MOD as TAP
    • Change compose key
  • 2024-02-14: Extend compose key options

Only major changes are listed.