qmk/qmk_firmware

[Bug] Documentation on layers doesn't match code

Open

#25 386 ouverte le 18 juin 2025

Voir sur GitHub
 (4 commentaires) (0 réactions) (0 assignés)C (43 867 forks)batch import
bughelp wanted

Métriques du dépôt

Stars
 (20 368 stars)
Métriques de merge PR
 (Merge moyen 20j 9h) (27 PRs mergées en 30 j)

Description

Describe the Bug

I've been debugging why the led map module is not working, and it seems that the document is a bit wrong.

Here is some values taken after boot:

Layer0 is default (some 0s removed)

                     default_layer_state: 0b0001
                                  layer_state:  0b0000

Layer1 is default (some 0s removed)

                     default_layer_state: 0b0010
                                  layer_state:  0b0000

which doesn't match the documentation:

Initial state of Keymap          Change base layout
-----------------------          ------------------

  31                               31
  30                               30
  29                               29
   :                                :
   :                                :   ____________
   2   ____________                 2  /           /
   1  /           /              ,->1 /___________/
,->0 /___________/               |  0
|                                |
`--- default_layer = 0           `--- default_layer = 1
     layer_state   = 0x00000001       layer_state   = 0x00000002

I'm not sure why layers_state is at 0 after boot, when according to the documentation it should be always > 0 (when there's a default layer)

Keyboard Used

No response

Link to product page (if applicable)

No response

Operating System

No response

qmk doctor Output

Is AutoHotKey / Karabiner installed

  • AutoHotKey (Windows)
  • Karabiner (macOS)

Other keyboard-related software installed

No response

Additional Context

No response

Guide contributeur