Skip to content

Commit bc55dfd

Browse files
author
lee
committed
Add STEMMA QT wiring alternative to hardware runbook
Document the 4-wire STEMMA QT path (QT-equipped backpack revisions) as an alternative to soldering the 5-pin breakout header, with standard QT wire colors mapped to Pi pins.
1 parent 940a20f commit bc55dfd

1 file changed

Lines changed: 21 additions & 2 deletions

File tree

‎HARDWARE_RUNBOOK.md‎

Lines changed: 21 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,8 @@ A 3D-printable housing (STLs + Fusion source, with its own license) lives in
1919
- The Pi (Zero W or Zero 2 W). If it's a plain **Zero W** / **Zero 2 W** the GPIO header holes
2020
are **bare** — you'll also solder on a 2x20 header (or wires). The **WH** variants (Zero WH,
2121
Zero 2 WH) already have the header.
22-
- 5 jumper wires (female–female if both ends have male header pins)
22+
- 5 jumper wires (female–female if both ends have male header pins) — or, if your backpack
23+
has STEMMA QT sockets, a STEMMA QT–to–female-jumper cable instead (see Step 3)
2324
- Optional but nice: a multimeter, helping-hands/clamp
2425

2526
## Step 1 — Solder the display to the backpack
@@ -29,7 +30,7 @@ A 3D-printable housing (STLs + Fusion source, with its own license) lives in
2930
shape to the white outline silk-screened on the backpack.
3031
2. Flip it over and solder every pin on the back. The HT16K33 chip ends up on the back.
3132
3. Solder the supplied header pins (or wires) into the row of breakout pads on the edge of the
32-
backpack.
33+
backpack. (Skip this if you'll wire via the STEMMA QT socket — see Step 3.)
3334

3435
(If the Pi needs a header, solder that on now too.)
3536

@@ -78,6 +79,24 @@ six pins** of the Pi's header. Pin 1 is the corner with the **square** solder pa
7879
Double-check `Vin`→5V and `Vio`→3V3 are **not swapped** before powering on. To see the header
7980
laid out for your exact board, run `pinout` on the Pi.
8081

82+
### Alternative: STEMMA QT cable (4 wires, no breakout header)
83+
84+
Recent backpack revisions (mid-2023 and later) add two **STEMMA QT** sockets (JST SH 4-pin)
85+
on the back. If yours has them, plug in a STEMMA QT–to–female-jumper cable
86+
(e.g. Adafruit #4397) instead of soldering the 5-pin breakout header:
87+
88+
| QT wire (standard colors) | → | Pi physical pin |
89+
|---|---|---|
90+
| Yellow (`SCL`) | → | **5** (SCL / GPIO3) |
91+
| Blue (`SDA`) | → | **3** (SDA / GPIO2) |
92+
| Black (`GND`) | → | **6** (GND) |
93+
| Red (`V+`) | → | **1** (3V3) |
94+
95+
Only four wires: the red 3.3V line sets the I2C logic level *and* feeds an onboard regulator
96+
that generates the 5V LED rail, so nothing connects to the Pi's 5V pins and the digits still
97+
run at full brightness. (Optional: to keep LED current off the Pi's 3.3V regulator, also wire
98+
the `Vin` pad → pin 2 (5V); the board switches to the external supply automatically.)
99+
81100
## Step 4 — Power on and verify
82101

83102
```bash

0 commit comments

Comments
 (0)