Describe the Bug
When using the 2025q3 branch (as per recommendation) and running qmk compile -kb keychron/q6_he/ansi_encoder -km keychron it does produce a file that works. However, I have to switch the toggle from USB (which I want to keep using) to Wi-Fi/2.4gHz in order to use the keyboard in USB mode.
I've checked and part of the reason seems to be this specific line.
https://github.com/Keychron/qmk_firmware/blob/2025q3/keyboards/keychron/common/wireless/keychron_wireless_common.c#L299
There's a match on 0x02 and if I change that to 0x00 then the keyboard works with the connectivity switch on USB (that's the middle) while connected via USB only. Otherwise, the effect is that it seems the keyboard is in either Bluetooth or Wi-Fi/2.4gHz mode, as any key pressed will flash the 1 key.
Now I may have been decoyed into something, but this does seem to work for my case. I'm not sure if this would break Bluetooth or Wi-Fi/2.4gHz though, as I don't use those, so please be extra careful there.
‼️ Important note: the change mentioned by qmk doctor are two things
- I copied the
q6_he directory just to have an easy comparison as I didn't set up a fork
- I changed the line mentioned from
0x01 to 0x00
- But note that even before I went into making these changes, I noticed this behavior and that caused me to investigate
Keyboard Used
Keychron Q6 HE
Link to product page (if applicable)
https://www.keychron.com/products/keychron-q6-he-qmk-wireless-custom-keyboard
Operating System
Windows 11
qmk doctor Output
Ψ QMK Doctor is checking your environment.
Ψ CLI version: 1.2.0
Ψ QMK home: C:/Users/svand/qmk_firmware
Ψ Detected Windows 11 (10.0.26100).
Ψ QMK MSYS version: 1.12.0
Ψ Userspace enabled: False
Ψ Git branch: 2025q3
Ψ Repo version: 0.14.29
⚠ Git has unstashed/uncommitted changes.
Ψ - Latest 2025q3: 2025-12-18 09:01:54 +0800 (a665a2669c) -- Fix incorrect SNLED27351_PHASE_CHANNEL of V6 Max
Ψ - Latest upstream/master: 2026-01-07 10:24:16 +0000 (1e683923e1) -- Handle broken symlinks in `qmk doctor` udev checks (#25934)
Ψ - Latest upstream/develop: None
Ψ - Common ancestor with upstream/master: 2025-09-10 03:52:25 -0500 (b4bdf3f1d5) -- Update data_driven_config.md (#25612)
Ψ - Common ancestor with upstream/develop: None
Ψ All dependencies are installed.
Ψ Found arm-none-eabi-gcc version 15.2.0
Ψ Successfully compiled using arm-none-eabi-gcc
Ψ Successfully tested arm-none-eabi-binutils using arm-none-eabi-size
Ψ Found avr-gcc version 15.2.0
Ψ Successfully compiled using avr-gcc
Ψ Successfully tested avr-binutils using avr-size
Ψ Found avrdude version t
Ψ Found dfu-programmer version 1.1.0
Ψ Found dfu-util version 0.11-dev
Ψ Submodules are up to date.
Ψ Submodule status:
Ψ - lib/chibios: 2025-10-14 11:51:26 +0800 -- (41e112ce20)
Ψ - lib/chibios-contrib: 2025-09-28 10:35:52 +0800 -- (6e7400ea)
Ψ - lib/googletest: 2021-06-11 06:37:43 -0700 -- (e2239ee6)
Ψ - lib/lufa: 2022-08-26 12:09:55 +1000 -- (549b97320)
Ψ - lib/vusb: 2022-06-13 09:18:17 +1000 -- (819dbc1)
Ψ - lib/printf: 2022-06-29 23:59:58 +0300 -- (c2e3b4e)
Ψ - lib/pico-sdk: 2025-04-20 21:24:29 +1000 -- (d0c5cac)
Ψ - lib/lvgl: 2022-04-11 04:44:53 -0600 -- (e19410f8)
Ψ QMK is ready to go, but minor problems were found
Is AutoHotKey / Karabiner installed
Other keyboard-related software installed
No response
Additional Context
No response
Describe the Bug
When using the 2025q3 branch (as per recommendation) and running
qmk compile -kb keychron/q6_he/ansi_encoder -km keychronit does produce a file that works. However, I have to switch the toggle from USB (which I want to keep using) to Wi-Fi/2.4gHz in order to use the keyboard in USB mode.I've checked and part of the reason seems to be this specific line.
https://github.com/Keychron/qmk_firmware/blob/2025q3/keyboards/keychron/common/wireless/keychron_wireless_common.c#L299
There's a match on
0x02and if I change that to0x00then the keyboard works with the connectivity switch on USB (that's the middle) while connected via USB only. Otherwise, the effect is that it seems the keyboard is in either Bluetooth or Wi-Fi/2.4gHz mode, as any key pressed will flash the1key.Now I may have been decoyed into something, but this does seem to work for my case. I'm not sure if this would break Bluetooth or Wi-Fi/2.4gHz though, as I don't use those, so please be extra careful there.
qmk doctorare two thingsq6_hedirectory just to have an easy comparison as I didn't set up a fork0x01to0x00Keyboard Used
Keychron Q6 HE
Link to product page (if applicable)
https://www.keychron.com/products/keychron-q6-he-qmk-wireless-custom-keyboard
Operating System
Windows 11
qmk doctor Output
Is AutoHotKey / Karabiner installed
Other keyboard-related software installed
No response
Additional Context
No response