From 44cf627316d555f61f2ee0b5d8a956bebaf58163 Mon Sep 17 00:00:00 2001
From: rootiest <chris@rootiest.com>
Date: Mon, 13 Apr 2026 14:39:23 -0400
Subject: [PATCH] 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
---
 Home.md                 |  2 +-
 LED-Indicators.md       |  4 +++-
 Wireless-and-Control.md | 43 ++++++++++++++++++++++++++++++++++-------
 3 files changed, 40 insertions(+), 9 deletions(-)

diff --git a/Home.md b/Home.md
index 17ab172..c2f19d8 100644
--- a/Home.md
+++ b/Home.md
@@ -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 |
 
diff --git a/LED-Indicators.md b/LED-Indicators.md
index 8bbaec4..67c51a2 100644
--- a/LED-Indicators.md
+++ b/LED-Indicators.md
@@ -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.
diff --git a/Wireless-and-Control.md b/Wireless-and-Control.md
index 7240689..22d6b1a 100644
--- a/Wireless-and-Control.md
+++ b/Wireless-and-Control.md
@@ -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.