qmk/qmk_firmware

[Bug] Documentation on layers doesn't match code

Open

#25,386 建立於 2025年6月18日

在 GitHub 查看
 (4 留言) (0 反應) (0 負責人)C (43,867 fork)batch import
bughelp wanted

倉庫指標

Star
 (20,368 star)
PR 合併指標
 (平均合併 20天 9小時) (30 天內合併 27 個 PR)

描述

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

貢獻者指南