v0.2.9

Changes:

• Turn capslock LED off when SLEEP# is low
• Use https://keyboard.frame.work/ for customizing key mapping and RGB backlight.

How to update:

On Windows

Use the .exe matching your keyboard.

Note:

• ANSI looks like this: https://frame.work/tw/en/products/keyboard-module?v=FRAKDW00AA
• ISO looks like this: https://frame.work/tw/en/products/keyboard-module?v=FRAKDW00AB

On any OS (UF2)

0. Download the .uf2 file matching your keyboard.
1. Slide touchpad down, until the input deck powers off (you can see the backlights turning off)
2. Hold left and right ALT keys pressed, while sliding the touchpad back up again
3. The keyboard is now in bootloader mode, use the touchpad to drag the .uf2 file onto the RPI-2 drive
4. The keyboard will automatically update itself, restart and be functional again after a few seconds

For numpad/macropad hold down keys 1 and 6. Please refer to the layout here: Numpad, Macropad
DO NOT update keyboard and macropad/numpad at the same time. If they are both in bootloader mode, it's impossible to distinguish them. Do not flash the wrong firmware.

Completely erase firmware and all settings

The modules keep persistent settings. Firmware updates do not erase them.
If you want to factory reset your module please use the UF2 method descrcibed above, first with erase_flash.uf2 and then with the matching .uf2 file for your keyboard.

It will take a while because it erases the entire flash, without any optimizations.
Do not do this unnecessarily to avoid wearing out the flash.

v0.2.8

Changes

• Allow next/prev effect keys to turn RGB back on
• Disable SelectiveSuspend
  • Remove keepalive HID reports for 25 seconds after last keypress
  • Remove Microsoft OS 2.0 Descriptor
• Enable NKRO only when in OS (needs EC firmware fix to work without hotplug in windows)
• Detect OS vs UEFI to force FN keys instead of media keys in UEFI environment

v0.2.7

Changes in 0.2.7

• Send keepalive HID reports for 25 seconds after last keypress (to avoid the Windows driver from suspending the keyboard too often)

Changes in 0.2.6

• Make sure RGB backlight keeps animating in USB suspend

Changes in 0.2.5

• Selective Suspend (D2)
  • Add Microsoft OS Descriptor to set "SelectiveSuspendEnabled" in registry
  • Make sure keypress that wakes from D2 is sent to OS, not swallowed
  • Don't use USB suspend for backlight control, rely on SLEEP#

Changes in 0.2.4

• Increase PWM frequency on RGB keyboards: 29kHz -> 32.25kHz
• Allow configuration of 10 layers in VIA
• Dynamic keypress voltage threshold (avoid ghost keys, especially with new HW rev)
• Change default macropad layout same as numpad layout
• Default to mediakeys instead of F1-F12

v0.2.6

Changes

• Make sure RGB backlight keeps animating in USB suspend

v0.2.5

Changes

• Selective Suspend (D2)
  • Add Microsoft OS Descriptor to set "SelectiveSuspendEnabled" in registry
  • Make sure keypress that wakes from D2 is sent to OS, not swallowed
  • Don't use USB suspend for backlight control, rely on SLEEP#

ATTENTION: Creates registry entries to force the Windows driver to suspend the device. These are persistent and CANNOT be cleared from firmware.
If you want to downgrade to a previous version of the firmware, you must MANUALLY delete registry entries under:

• Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Enum\USB\VID32AC&PID0012 (ANSI)
• Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Enum\USB\VID32AC&PID0018 (ISO)
• Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Enum\USB\VID32AC&PID0019 (ISO)
• Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Enum\USB\VID32AC&PID0013 (Macropad)
• Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Enum\USB\VID32AC&PID0014 (Numpad)

v0.2.4

Changes

• Increase PWM frequency on RGB keyboards: 29kHz -> 32.25kHz
• Allow configuration of 10 layers in VIA
• Dynamic keypress voltage threshold (avoid ghost keys, especially with new HW rev)
• Change default macropad layout same as numpad layout
• Default to mediakeys instead of F1-F12

v0.2.3-hotkey-indicator

Same as v0.2.3 but RGB backlight color changes based on BIOS hotkey mode.
Keyboard starts up with RGB color based on previous setting, unrelated to BIOS hotkey mode. Recommended to configure to something that's NOT red or white.

Turns RED when command to enable hotkey mode is received.
Turns WHITE when command to enable hotkey mode is received.
If you're unsure if it updated or not, pressing a key will update the backlight to the correct color.

v0.2.3

Update Instructions

1. Slide out touchpad (turns off power to all modules)
2. Press left and right ALT keys - while keeping them pressed, slide the touchpad back in
3. A folder will pop up (like USB thumb drive) - open it
4. Copy the single .uf2 file corresponding to the keyboard type into this folder
5. Keyboard will reset and automatically flash

Notes

• Different layouts (ISO, JIS ANSI) require different firmware AND different design file for VIA.
• If you change firmware to a different layout (e.g. ANSI to ISO) you MUST run qmk_hid via --eeprom-reset!!! Otherwise it will keep settings from previous layout. (Applies to all versions, not just 0.2.3)
• MUST run qmk_hid via --eeprom-reset after update, if upgrading from 0.1.5 or older!
• MUST run qmk_hid via --eeprom-reset after update, if using numpad or macropad and you want to use the new default layout

v0.2.3

The latest corresponding tool for this firmware release is qmk_hid v0.1.11.

Changes:

• ANSI RGB Keyboard only
  • Fix LED to key mapping. Now in RGB patterns that react to keypress, like ripple or heatmap the LEDs will light up under the artwork. There they are more visible
• Update debug messages to show measured voltage (Helps with debugging hardware defects)
• Extend UEFI hotkey mode to all F keys (F1-F12)

Compatibility:

• Compatible with all hardware revisions until at least August 2023

v0.2.2 - Hotkey Indicator

Same as v0.2.2, except the UEFI/BIOS Hotkey mode commands will turn the backlight red (on) or white (off).
Useful for debugging the hotkey mode.
Only makes sense on RGB backlight keyboards, such as ANSI keyboard and macropad.

v0.2.2

Update Instructions

1. Slide out touchpad (turns off power to all modules)
2. Press left and right ALT keys - while keeping them pressed, slide the touchpad back in
3. A folder will pop up (like USB thumb drive) - open it
4. Copy the .uf2 file corresponding to the keyboard type into this folder
5. Keyboard will reset and automatically flash

Notes

• Different layouts (ISO, JIS ANSI) require different firmware AND different design file for VIA.
• If you change firmware to a different layout (e.g. ANSI to ISO) you MUST run qmk_hid via --eeprom-reset!!! Otherwise it will keep settings from previous layout. (Applies to all versions, not just 0.2.2)
• MUST run qmk_hid via --eeprom-reset after update, if upgrading from 0.1.5 or older!
• MUST run qmk_hid via --eeprom-reset after update, if using numpad or macropad and you want to use the new default layout

v0.2.2

The latest corresponding tool for this firmware release is qmk_hid v0.1.9.

Changes:

• Update to latest upstream QMK code from develop branch (ac75242..0056984 on July 20)
  • Fixes waking up the host from keyboard presses: qmk/qmk_firmware#19780
• When SLEEP# low, don't suspend, just turn backlights off. USB suspend will take care of power savings
• Enable NKRO HID reports. Previously only 6KRO possible. Known to be incompatible with some BIOS implementations. Ours seems ok
• Add command to enable/disable UEFI hotkey mode
• Add command to enable/disable macropad factory mode (Use qmk_hid factory --factory true)

Compatibility:

• Compatible with all hardware revisions until at least July 2023