v0.2.1

Update Instructions

1. Remove/unplug keyboard
2. Press left and right ALT keys - while pressing insert/plug-in the module
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.1)
• 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.1

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

Changes:

• Disable unused SW pins on RGB LED controller. Eliminates the noise on 100% white backlight
  • Applies to RGB ANSI (SW1-SW9) and RGB macropad (SW1-SW4)
• Scale RGB brightness down to limit max current draw to 500mA
• Update to latest upstream QMK code from master branch (ac75242..fa0b451 on July 14)

Compatibility:

• Compatible with all hardware revisions until at least July 2023

v0.2.0

Update Instructions

1. Remove/unplug keyboard
2. Press left and right ALT keys - while pressing insert/plug-in the module
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.0)
• 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.0

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

Changes:

• Sync virtual numlock with host (otherwise might be stuck in arrow key mode)
• Restore RGB brightness step level after reboot of keyboard
• Increase white-backlight PWM frequency from 2kHz to 24kHz to avoid audible noise

Compatibility:

• Compatible with all hardware revisions until at least July 2023

v0.1.9

Update Instructions

1. Remove/unplug keyboard
2. Press left and right ALT keys - while pressing insert/plug-in the module
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.1.9)
• 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 macropad and you want to use the new default layout

v0.1.9

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

Changes:

• Add backlight keycodes to VIA design files
• Update marketing names in VIA design files
• Fix slow USB enumeration and slow VIA commands
• Implement FN+Space on RGB keyboards to work as brightness step function
• Numpad
  • Numpad should have backspace, not delete key
  • Implement virtual numlock layer (does not notify OS)
  • Add brightness control to numlock layer
• Macropad
  • Add useful default mapping
  • Rename gridpad to macropad

Compatibility:

• Compatible with all hardware revisions until at least July 2023

v0.1.8

Update Instructions

1. Remove/unplug keyboard
2. Press left and right ALT keys - while pressing insert/plug-in the module
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.1.8)
• MUST run qmk_hid via --eeprom-reset after update, if upgrading from 0.1.5 or older!

v0.1.8

The latest corresponding tool for this firmware release is qmk_hid v0.1.5.
No changes since then, hence no version 0.1.8.

Changes:

• Allow laptop to go to sleep (previously a periodic debug message would prevent that)
• White backlight keyboard only
  • FN+Space switches through three levels now, instead of on/off. Same as Framework 13
  • Add new hotkey: FN+C to toggle backlight breathing
• Have keyboard go to sleep (including turning off LEDs) when SLEEP# is low
• Reduce power consumption by adding WFI to idle thread
• Update marketing names

Compatibility:

• Compatible with all hardware revisions until at least June 2023

v0.1.7 DVT

Update Instructions

1. Remove/unplug keyboard
2. Press left and right ALT keys - while pressing insert/plug-in the module
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.1.7)
• MUST run qmk_hid via --eeprom-reset after update, if upgrading from 0.1.5 or older!

v0.1.7

The latest corresponding tool for this firmware release is qmk_hid v0.1.5.
No changes since then, hence no version 0.1.7.

Changes:

• Fix equals (=) and zero (0) key on ISO layout
  • Equals key (=) wouldn't do anything
  • Zero (0) key would register as equals (=)

The changes only apply to ISO layouts. Other layouts are unchanged from v0.1.6..

v0.1.6 DVT

Notes

• Different layouts (ISO, JIS ANSI) require different firmware AND different design file for VIA.
• MUST run qmk_hid via --eeprom-reset after update to apply the FN lock fixes (when upgrading from previous version)

v0.1.6

The latest corresponding tool for this firmware release is qmk_hid v0.1.5.
No changes since then, hence no version 0.1.6.

Changes:

• Persist FN lock through powercycle
• Fix display switch button - would sometimes not work, only open
  windows menu

The changes only apply to ANSI/ISO/JIS layouts.

v0.1.5 EVT/DVT

Notes

Different layouts (ISO, JIS ANSI) require different firmware AND different design file for VIA.

v0.1.5

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

Changes:

• Pull changes from latest upstream qmk master branch (ac75242)
• Update all branding from lotus to "Framework Laptop 16"
• Keyboards would take many seconds to start up on Linux
  This is a known upstream bug and resolved by disabling NKRO HID.
  Until this is fixed we have only 6KRO.
• Change ADC threshold from 3.0V to 2.9V. Some keyboards would dip slightly
  below 3.0V without a keypress.