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

docs: document both DIP switches with physical orientation 

- SW1 (rightmost from back): three-position wireless mode switch
  (2.4G / Wired / Bluetooth)
- SW2 (next to SW1): two-position Win/Mac backlight preset switch
- Add ASCII diagram of switch positions on back of keyboard
- Cross-link LED-Indicators and Wireless-and-Control pages
- Update Home.md hardware table to mention both switches
Rootiest
2026-04-13 14:39:23 -04:00
parent c33f806bf2
commit 44cf627316
3 changed files with 40 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Home.md
+1 -1
@@ -28,7 +28,7 @@ The firmware is based on Keychron's `wireless_playground` QMK fork with extensiv
|---------|--------|
| Keyboard | Keychron Q5 Max, ANSI layout, 101 keys |
| Encoder | Rotary knob — top-right corner |
| DIP switch | Side switch selects **Mac** (left) or **Win** (right) backlight mode |
| DIP switches | Two switches on the back next to USB-C: **SW1** selects 2.4G / Wired / Bluetooth; **SW2** selects Win (white LEDs) / Mac (normal RGB) |
| Wireless | Bluetooth 5.1 (3 hosts) + 2.4 GHz USB dongle + wired USB-C |
| MCU | STM32F401 |
LED-Indicators.md
+3 -1
@@ -43,7 +43,9 @@ The key physically labelled CapsLock (which is mapped to [CAPS_MOD](Custom-Keys#
## Win/Mac DIP Switch — Full-Keyboard White Overlay
The side DIP switch selects between **Mac mode** (switch toward the keyboard) and **Win mode** (switch away from the keyboard).
This is **SW2**, the switch closest to the centre of the keyboard when viewed from the back (see [Wireless & Control — DIP Switches](Wireless-and-Control#dip-switches) for the physical layout of both switches).
It selects between **Mac mode** (right position, viewed from back) and **Win mode** (left position, viewed from back).
When **Win mode** is active:
- **All LEDs** are overridden to **solid white**, regardless of which RGB effect or colour scheme is configured.
Wireless-and-Control.md
+36 -7
@@ -94,13 +94,42 @@ See [RGB Controls](RGB-Controls) for a full breakdown of the RGB keys.
---
## DIP Switch
## DIP Switches
The physical DIP switch on the side of the keyboard selects the **backlight preset**:
Both DIP switches are located on the **back of the keyboard**, next to the USB-C connector. When viewing them from the back, the switches read left-to-right as described below. Note that "left from the back" is the right side in normal keyboard orientation.
| Position | Effect |
|----------|--------|
| Mac side (toward keyboard) | Normal RGB effect as configured |
| Win side (away from keyboard) | All LEDs white (see [LED Indicators](LED-Indicators#winmac-dip-switch--full-keyboard-white-overlay)) |
```
Back of keyboard — USB-C connector side
> The DIP switch does **not** change the OS layout, key behaviour, or wireless mode on the Q5 Max — it is purely a visual indicator preset.
┌──────────────────────────────────────┐
│ ··· │ ← USB-C
│ [SW2] [SW1] │
└──────────────────────────────────────┘
(viewed from the back)
SW1 = rightmost from back = left side of keyboard in normal use
SW2 = next to SW1 = slightly right of SW1 from the back
```
### SW1 — Wireless Mode Switch (rightmost from back)
Selects the active connection mode. This is a three-position switch.
| Position (left→right, viewed from back) | Mode | Notes |
|------------------------------------------|------|-------|
| Left | **2.4 GHz** | Connects via the USB wireless dongle |
| Centre | **Wired** | USB-C cable connection |
| Right | **Bluetooth** | Connects to one of the three saved BT hosts |
> When set to Bluetooth, use the `BT_HST1`/`BT_HST2`/`BT_HST3` keys on the KEEB_CTL layer to choose which paired device to connect to.
### SW2 — Win/Mac Backlight Switch (next to SW1)
Selects the RGB backlight preset. This is a two-position switch.
| Position (left→right, viewed from back) | Mode | Effect |
|------------------------------------------|------|--------|
| Left | **Win** | All LEDs overridden to solid white |
| Right | **Mac** | Normal RGB effect as configured in Launcher |
> The Win/Mac switch does **not** change the OS key layout or key behaviour — it is purely a backlight visual preset. See [LED Indicators — Win/Mac DIP Switch](LED-Indicators#winmac-dip-switch--full-keyboard-white-overlay) for full details on how the white overlay works.