rootiest/qmk_firmware
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(q5_max): layer control — lock keycodes, ESC RGB indicator, BASE fallback combo #3

Merged
rootiest merged 3 commits from feat/layer-control into chore/gitignore-update 2026-04-08 04:50:32 +00:00
Conversation 0 Commits 3 Files Changed 3
+99 -6
rootiest commented 2026-04-08 04:35:16 +00:00
Owner
Copy Link
Copy Source

Summary

  • Introduces layer-lock custom keycodes (LCK_FN1–LCK_FN4, LCK_CTL, LCK_BASE) for persistent layer activation
  • Adds an ESC key RGB indicator (LED 0) that reflects the currently active layer
  • Adds a COMM+DOT+SLSH (, . /) combo as a reliable emergency escape hatch back to BASE

Details

Layer Lock Keycodes

LCK_FN1–LCK_FN4, LCK_CTL, and LCK_BASE toggle a layer into a locked state, keeping it active after momentary keys are released. A second press on the same lock key — or pressing LCK_BASE — clears all locks and returns to BASE.

ESC Key RGB Indicator

rgb_matrix_indicators_advanced_user colours LED 0 (ESC key) based on the highest active layer:

Layer Colour
BASE Dark (off)
FN1 Blue
FN2 Green
FN3 Orange
FN4 Purple
KEEB_CTL Red

BASE Fallback Combo

A three-key combo (, . /) fires TO(BASE), providing an emergency exit when stuck on an unknown layer. COMBO_ONLY_FROM_LAYER is set to 0 in config.h so keycodes are always resolved from BASE, making the combo reliable on any layer.

Commits

  • feat(q5_max): add COMM+DOT+SLSH fallback combo to return to BASE
  • feat(q5_max): add ESC key RGB indicator for active layer
  • feat(q5_max): add layer-lock keycodes for persistent layer activation
## Summary - Introduces layer-lock custom keycodes (`LCK_FN1`–`LCK_FN4`, `LCK_CTL`, `LCK_BASE`) for persistent layer activation - Adds an ESC key RGB indicator (LED 0) that reflects the currently active layer - Adds a `COMM+DOT+SLSH` (`,` `.` `/`) combo as a reliable emergency escape hatch back to BASE ## Details ### Layer Lock Keycodes `LCK_FN1`–`LCK_FN4`, `LCK_CTL`, and `LCK_BASE` toggle a layer into a locked state, keeping it active after momentary keys are released. A second press on the same lock key — or pressing `LCK_BASE` — clears all locks and returns to BASE. ### ESC Key RGB Indicator `rgb_matrix_indicators_advanced_user` colours LED 0 (ESC key) based on the highest active layer: | Layer | Colour | |-------|--------| | BASE | Dark (off) | | FN1 | Blue | | FN2 | Green | | FN3 | Orange | | FN4 | Purple | | KEEB_CTL | Red | ### BASE Fallback Combo A three-key combo (`,` `.` `/`) fires `TO(BASE)`, providing an emergency exit when stuck on an unknown layer. `COMBO_ONLY_FROM_LAYER` is set to `0` in `config.h` so keycodes are always resolved from BASE, making the combo reliable on any layer. ### Commits - `feat(q5_max): add COMM+DOT+SLSH fallback combo to return to BASE` - `feat(q5_max): add ESC key RGB indicator for active layer` - `feat(q5_max): add layer-lock keycodes for persistent layer activation`
rootiest added 3 commits 2026-04-08 04:35:17 +00:00
feat(q5_max): add COMM+DOT+SLSH fallback combo to return to BASE f66210c1d1 
Adds a three-key combo (,  .  /) that fires TO(BASE), providing an
emergency escape hatch when stuck on an unknown layer. COMBO_ONLY_FROM_LAYER
is set to 0 in the keymap config.h so keycodes are always resolved from
BASE, making the combo reliable regardless of the active layer.
feat(q5_max): add ESC key RGB indicator for active layer 78c9e2c57d 
Implements rgb_matrix_indicators_advanced_user to colour the ESC key
(LED 0) based on the current layer: dark on BASE, blue on FN1, green
on FN2, orange on FN3, purple on FN4, and red on KEEB_CTL.
feat(q5_max): add layer-lock keycodes for persistent layer activation
PR Lint keyboards / lint (pull_request) Failing after 4s
Details
Pull Request Labeler / triage (pull_request) Successful in 4s
Details
5fb2847dcd 
Introduces LCK_FN1–LCK_FN4, LCK_CTL, and LCK_BASE custom keycodes that
toggle a layer into a locked state so it stays active after momentary keys
are released. A second press on the same lock key or pressing LCK_BASE
clears all locks and returns to BASE.
rootiest force-pushed feat/layer-control from 5fb2847dcd to 45276ac042 2026-04-08 04:48:15 +00:00 Compare
rootiest merged commit c3799b426d into chore/gitignore-update 2026-04-08 04:50:32 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
Clear labels
bug
Something is not working
 documentation
Scope affects only documentation
 duplicate
This issue or pull request already exists
 enhancement
New feature
 help wanted
Need some help
 invalid
Something is wrong
 question
More information is needed
 wontfix
This won't be fixed
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
rootiest (Rootiest)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: rootiest/qmk_firmware#3
Delete Branch "feat/layer-control"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?