24 KiB
QMK Breaking Changes - 2024 May 26 Changelog
Notable Features :id=notable-features
0.25.0 is mainly a maintenance release of QMK Firmware -- as per last few breaking changes cycles, there have been a lot of behind-the-scenes changes, mainly:
- continued migration of configuration into
.jsonfiles - addressing technical debt
Changes Requiring User Action :id=changes-requiring-user-action
Updated Keyboard Codebases :id=updated-keyboard-codebases
One note with updated keyboard names -- historical keyboard names are still considered valid when using External Userspace for builds. If you're already using External Userspace, you do not need to move your keymap inside your repository.
| Old Keyboard Name | New Keyboard Name |
|---|---|
| adkb96 | adkb96/rev1 |
| canary/canary60rgb | canary/canary60rgb/v1 |
| handwired/meck_tkl | handwired/meck_tkl/blackpill_f401 |
| handwired/qc60 | handwired/qc60/proto |
| handwired/stef9998/split_5x7 | handwired/stef9998/split_5x7/rev1 |
| junco | junco/rev1 |
| keaboard | keaboard/rev1 |
| kprepublic/jj40 | kprepublic/jj40/rev1 |
| kprepublic/jj50 | kprepublic/jj50/rev1 |
| melgeek/mj65 | melgeek/mj65/rev3 |
| melgeek/mojo68 | melgeek/mojo68/rev1 |
| melgeek/mojo75 | melgeek/mojo75/rev1 |
| melgeek/tegic | melgeek/tegic/rev1 |
| melgeek/z70ultra | melgeek/z70ultra/rev1 |
| miiiw/blackio83 | miiiw/blackio83/rev_0100 |
| murcielago | murcielago/rev1 |
| polilla | polilla/rev1 |
| qwertyydox | qwertyydox/rev1 |
| spaceholdings/nebula68b | spaceholdings/nebula68b/solder |
| splitty | splitty/rev1 |
| xiudi/xd004 | xiudi/xd004/v1 |
Notable core changes :id=notable-core
Introduction of keyboard.json (22891) :id=keyboard-json
One longer term goal of QMK is increased maintainability.
As part of the continued push towards Data Driven Configuration, the build system has been updated to simplify the existing codebase, and power future workflows.
The keyboard.json configuration file allows the support of a single data file for keyboard level config.
Additionally,
info.jsonnow represents potential fragments of config that can be shared across keyboard revisions.rules.mkis now optional - Completely blank files are no longer required.- Currently supported keyboards have been migrated to reflect this change.
Backwards compatibility of the old system has been maintained, but will be removed in a future breaking changes cycle.
Full changelist :id=full-changelist
Core:
- Refactor vusb to protocol use pre/post task (#14944)
- Refactor ChibiOS USB endpoints to be fully async (#21656)
- Infer eeconfig identifiers (#22135)
- [Audio] Add support for audio shutdown pin (#22731)
- Enable 'keyboard.json' as a build target (#22891)
- Remove unuseful layer_on() call (#23055)
- Add init function to RGBLight driver struct (#23076)
- Add utility functions for Pointing Device Auto Mouse feature (#23144)
- Remove midi_ep_task from ChibiOS (#23162)
- LED drivers: add support for IS31FL3236 (#23264)
- Un-
externRGBLightled[]array (#23322) - Update I2C API usage in keyboard code (#23360)
- Update GPIO expander API naming (#23375)
- Remove deprecated quantum keycodes (#23407)
- Add MacOS Czech ISO and ANSI keymaps #23346 (#23412)
- Rename
process_{led,rgb}_matrix()(#23422) - Separate keycode handling for LED Matrix and Backlight (#23426)
- Add new set of keycodes for LED Matrix (#23432)
- Oneshot locked mods split transaction (#23434)
- Bodge consolidation. (#23448)
- LED Matrix: replace backlight keycodes with newly added ones (#23455)
- Add new set of keycodes for RGB Matrix (#23463)
- Refactoring successive press() release() calls into tap_key() calls (#23573)
- Rename
RGBWdefine toWS2812_RGBW(#23585) - Normalise RGBLight (underglow) keycodes (#23656)
- split_util: rename
usbIsActivetousb_bus_detected(#23657) - Insert delay between shifted chars in send_string_with_delay for AVR (#23673)
- Remove useless
LED/RGB_MATRIX_ENABLEifdefs (#23726)
CLI:
- Some metadata on QGF/QFF files (#20101)
qmk new-keyboard- detach community layout when selecting "none of the above" (#20405)- Initial
qmk test-cfunctionality (#23038) - Reject duplicate matrix locations in LAYOUT macros (#23273)
- Align 'qmk lint' argument handling (#23297)
- Produce warning if keyboard is not configured via
keyboard.json(#23321)
Submodule updates:
- Update ChibiOS submodules. (#23405)
Keyboards:
- Move
SPLIT_KEYBOARDto data driven (#21410) - Change to
development_board(#21695) - Add solid_reactive effects for MIIIW BlackIO83 (#22251)
- Migrate content where only parent info.json exists (#22895)
- Remove redundant disabling of features (#22926)
- Update ScottoAlp handwired keyboard to 12 column layout (#22962)
- Overhaul ploopyco devices (#22967)
- Add rp2040_ce option to lotus58 (#23185)
- Migrate features from rules.mk to data driven - 0-9 (#23202)
- Change default RGB effect for momokai keypads to solid white (#23217)
- Migrate annepro2 away from custom matrix (#23221)
- Update BAMFK-1 (#23236)
- Migrate features from rules.mk to data driven - ABCD (#23247)
- Migrate features from rules.mk to data driven - EFGH (#23248)
- Remove 60_ansi_arrow_split_bs_7u_spc Community Layout (#23259)
- Migrate features from rules.mk to data driven - IJK (#23276)
- Migrate features from rules.mk to data driven - LMN (#23277)
- Migrate features from rules.mk to data driven - OPQR (#23285)
- Migrate features from rules.mk to data driven - ST (#23286)
- Migrate features from rules.mk to data driven - UVWXYZ (#23287)
- Swift65 Hotswap Layout Name Standardization (#23288)
- Swift65 Solder Layout Name Standardization (#23289)
- Migrate build target markers to keyboard.json (#23293)
- KPRepublic JJ50 rev1 Refactor (#23294)
- KPRepublic JJ40 rev1 Refactor (#23299)
- Migrate features and LTO from rules.mk to data driven (#23302)
- Add RGB lighting for the PetruziaMini (#23305)
- Migrate features and LTO from rules.mk to data driven (#23307)
- MechKeys ACR60 Layout Updates (#23309)
- Remove RGBLight
led[]references (#23311) - Reduce firmware size of helix/rev3 (#23324)
- P3D Spacey Layout Updates (#23329)
- Data-Driven Keyboard Conversions: 0-9 (#23357)
- Update GPIO API usage in keyboard code (#23361)
- Remove "w": 1 from keyboards/ (#23367)
- Remove
quantum.hincludes from keyboard custommatrix.cs (#23371) - refactor: mechwild/bbs (#23373)
- Remove 'NO_USB_STARTUP_CHECK = no' from keyboards (#23376)
- Remove completely redundant DEFAULT_FOLDER from keyboards (#23377)
- Miscellaneous keyboard.json migrations (#23378)
- Data-Driven Keyboard Conversions: A (#23379)
- refactor: flehrad/bigswitch (#23384)
- add second encoder to matrix info of arrowmechanics/wings (#23390)
- Change the VID and PID of the file kb38 info.json (#23393)
- Remove
quantum.hincludes from keyboard code (#23394) - [ UPDATE 15PAD & 6PAD ] (#23397)
- Remove more unnecessary
quantum.hincludes (#23402) - KB name change to Part.1-75-HS (#23403)
- Tidy up keyboards/zvecr (#23418)
- "features.split" is not a valid key (#23419)
- Migrate build target markers to keyboard.json - YZ (#23421)
- refactor: mechwild/waka60 (#23423)
- Convert some AVR GPIO operations to macros (#23424)
- Data-Driven Keyboard Conversions: B (#23425)
- Tidy up default layer handling in keymaps (#23436)
- Added Chapter1 (#23452)
- Data-driven Keyboard Conversions: C (#23453)
- Migrate build target markers to keyboard.json - X (#23460)
- Data-Driven Keyboard Conversions: D (#23461)
- Miscellaneous keyboard.json migrations (#23486)
- Migrate build target markers to keyboard.json - 0AB (#23488)
- Migrate build target markers to keyboard.json - W (#23511)
- Data-Driven Keyboard Conversions: E (#23512)
- Migrate build target markers to keyboard.json - TUV (#23514)
- Migrate build target markers to keyboard.json - DE (#23515)
- Data-Driven Keyboard Conversions: F (#23516)
- Data-Driven Keyboard Conversions: G (#23522)
- Data-Driven Keyboard Conversions: H, Part 1 (#23524)
- Data-Driven Keyboard Conversions: H, Part 2 (#23525)
- Migrate build target markers to keyboard.json - C (#23529)
- Data-Driven Keyboard Conversions: H, Part 3 (#23530)
- Migrate build target markers to keyboard.json - S (#23532)
- Data-Driven Keyboard Conversions: I (#23533)
- Migrate build target markers to keyboard.json - FG (#23534)
- Migrate build target markers to keyboard.json - HI (#23540)
- Remove *_SUPPORTED = yes (#23541)
- Migrate build target markers to keyboard.json - R (#23542)
- Data-Driven Keyboard Conversions: J (#23547)
- Data-Driven Keyboard Conversions: K, Part 1 (#23556)
- Tidy use of raw hid within keyboards (#23557)
- Data-Driven Keyboard Conversions: K, Part 2 (#23562)
- Migrate build target markers to keyboard.json - OQ (#23564)
- Migrate build target markers to keyboard.json - P (#23565)
- Data-Driven Keyboard Conversions: K, Part 3 (#23566)
- Data-Driven Keyboard Conversions: K, Part 4 (#23567)
- Data-Driven Keyboard Conversions: K, Part 5 (#23569)
- Data-Driven Keyboard Conversions: L (#23576)
- Migrate build target markers to keyboard.json - JK (#23588)
- Migrate build target markers to keyboard.json - N (#23589)
- Data-Driven Keyboard Conversions: M, Part 1 (#23590)
- Add haptic driver to keyboard.json schema (#23591)
- Migrate build target markers to keyboard.json - Keychron (#23593)
- Remove RGBLIGHT_SPLIT in rules.mk (#23599)
- Data-Driven Keyboard Conversions: M, Part 2 (#23601)
- Align NO_SUSPEND_POWER_DOWN keyboard config (#23606)
- Migrate build target markers to keyboard.json - L (#23607)
- Migrate build target markers to keyboard.json - Misc (#23609)
- Migrate build target markers to keyboard.json - Misc (#23612)
- Data-Driven Keyboard Conversions: M, Part 3 (#23614)
- Add audio driver to keyboard.json schema (#23616)
- Data-Driven Keyboard Conversions: BastardKB (#23622)
- Data-Driven Keyboard Conversions: Mechlovin (#23624)
- Migrate build target markers to keyboard.json - BM (#23627)
- gh80_3000 - Enable indicator LED functionality (#23633)
- Iris keymap update (#23635)
- Migrate build target markers to keyboard.json - Misc (#23653)
- Add via support for craftwalk (#23658)
- Align RGBKB keyboards to current standards (#23663)
- Remove 'split.transport.protocol=serial_usart' (#23668)
- Remove redundant keymap templates (#23685)
- Change all RGB mode keycodes to short aliases (#23691)
- Adjust keycode alignment around
QK_BOOT(#23697) - Remove RGB keycodes from boards with no RGB config (#23709)
- Miscellaneous Data-Driven Keyboard Conversions (#23712)
- Delete trivial keymap readmes (#23714)
- Migrate
LOCKING_*_ENABLEto Data-Driven: 0-9 (#23716) - Add media key support to Riot Pad (#23719)
- Migrate
LOCKING_*_ENABLEto Data-Driven: A-C, Part 1 (#23745) - Migrate
LOCKING_*_ENABLEto Data-Driven: A-C, Part 2 (#23746) - Migrate
LOCKING_*_ENABLEto Data-Driven: A-C, Part 3 (#23747) - Migrate
LOCKING_*_ENABLEto Data-Driven: D, Part 1 (#23749) - Migrate
LOCKING_*_ENABLEto Data-Driven: D, Part 2 (#23750) - Migrate
LOCKING_*_ENABLEto Data-Driven: E (#23751) - Move VIA config to keymap level (#23754)
- Migrate
LOCKING_*_ENABLEto Data-Driven: F (#23757) - Migrate
LOCKING_*_ENABLEto Data-Driven: G (#23758) - Migrate
LOCKING_*_ENABLEto Data-Driven: H, Part 1 (#23759) - Remove includes of config.h (#23760)
- Migrate
LOCKING_*_ENABLEto Data-Driven: H, Part 2 (#23762) - Migrate
LOCKING_*_ENABLEto Data-Driven: H, Part 3 (#23763) - Migrate
LOCKING_*_ENABLEto Data-Driven: H, Part 4 (#23764) - Migrate
LOCKING_*_ENABLEto Data-Driven: I-J (#23767) - Migrate
LOCKING_*_ENABLEto Data-Driven: K, Part 1 (#23768) - Migrate
LOCKING_*_ENABLEto Data-Driven: K, Part 2 (#23769) - Migrate
LOCKING_*_ENABLEto Data-Driven: K, Part 3 (#23770) - Migrate
LOCKING_*_ENABLEto Data-Driven: L (#23771) - Migrate
LOCKING_*_ENABLEto Data-Driven: M, Part 1 (#23772) - Migrate
LOCKING_*_ENABLEto Data-Driven: M, Part 2 (#23773) - Migrate
LOCKING_*_ENABLEto Data-Driven: N (#23774) - Migrate
LOCKING_*_ENABLEto Data-Driven: O (#23778) - Migrate
LOCKING_*_ENABLEto Data-Driven: P, Part 1 (#23779) - Migrate
LOCKING_*_ENABLEto Data-Driven: P, Part 2 (#23780) - Migrate
LOCKING_*_ENABLEto Data-Driven: Q-R (#23781) - Migrate
LOCKING_*_ENABLEto Data-Driven: S, Part 1 (#23783) - Migrate
LOCKING_*_ENABLEto Data-Driven: S, Part 2 (#23784) - Migrate
LOCKING_*_ENABLEto Data-Driven: T (#23785) - Migrate
LOCKING_*_ENABLEto Data-Driven: U-V (#23786) - Remove some useless code from keymaps (#23787)
- Migrate
LOCKING_*_ENABLEto Data-Driven: W, Part 1 (#23788) - Migrate
LOCKING_*_ENABLEto Data-Driven: W, Part 2 (#23789) - Migrate
LOCKING_*_ENABLEto Data-Driven: X-Z (#23790) - Update GPIO macros in keymaps (#23792)
Keyboard fixes:
- Fix mapping of GUI/ALT for Win/Mac layers (#22662)
- Adding standard keymap for wave keyboard to fix #22695 (#22741)
- Fixup qk100 (firmware size) (#23169)
- Fixup mechlovin/octagon (#23179)
- Fix up scanning for Djinn, post-asyncUSB. (#23188)
- Fixup annepro2 (#23206)
- Fixed keychron q1v1 led config for iso layout (#23222)
- Fixes for idobao vendor keymaps (#23246)
- Fixup work_board (#23266)
- Linworks FAve 87H Keymap Refactor/Bugfix (#23292)
- Align encoder layout validation with encoder.h logic (#23330)
- 0xcb/splaytoraid: remove
CONVERT_TOat keyboard level (#23395) - 40percentclub/gherkin: remove
CONVERT_TOat keyboard level (#23396) - Fix spaceholdings/nebula68b (#23399)
- Fix failing keyboards on develop (#23406)
- Corrections to split keyboard migrations (#23462)
- Fix iris via keymap (#23652)
- xiudi/xd75 - Fix backlight compilation issues (#23655)
Bugs: