From 9a4f27e8be2109c4852117eb331952e532408b72 Mon Sep 17 00:00:00 2001
From: Ryan Malloy <ryan@supported.systems>
Date: Tue, 3 Feb 2026 11:23:14 -0700
Subject: [PATCH] Wiring diagram: realistic S2 Mini based on WEMOS pinout image

- Magenta PCB color matching actual board
- USB-C at bottom, dual-column pin headers
- Mounting holes, RST/0 buttons, LED indicator
- Gold through-hole pins with correct pinout
- Added attenuation reference table
---
 hardware/wiring-diagram.svg | 474 +++++++++++++++++++++++-------------
 1 file changed, 308 insertions(+), 166 deletions(-)

diff --git a/hardware/wiring-diagram.svg b/hardware/wiring-diagram.svg
index 7d0688d..ba72384 100644
--- a/hardware/wiring-diagram.svg
+++ b/hardware/wiring-diagram.svg
@@ -1,214 +1,356 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 420" width="800" height="420">
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 900 520" width="900" height="520">
   <defs>
     <style>
-      .board { fill: #1a472a; stroke: #0d2818; stroke-width: 2; }
-      .board-label { font-family: monospace; font-size: 14px; font-weight: bold; fill: white; }
-      .pin-label-white { font-family: monospace; font-size: 10px; fill: #e0e0e0; }
-      .title { font-family: sans-serif; font-size: 18px; font-weight: bold; fill: #333; }
-      .subtitle { font-family: sans-serif; font-size: 12px; fill: #666; }
+      .title { font-family: sans-serif; font-size: 20px; font-weight: bold; fill: #333; }
+      .subtitle { font-family: sans-serif; font-size: 13px; fill: #666; }
       .note { font-family: sans-serif; font-size: 11px; fill: #555; }
-      .pin { fill: #c9a227; stroke: #8b7355; stroke-width: 1; }
-      .sma { fill: #c9a227; stroke: #8b7355; stroke-width: 1; }
-      .usb { fill: #333; stroke: #222; stroke-width: 1; }
-      .chip { fill: #1a1a1a; stroke: #333; stroke-width: 1; }
-      .net-label { font-family: monospace; font-size: 11px; font-weight: bold; }
+      .code { font-family: monospace; font-size: 11px; fill: #1565c0; }
+      .table-header { font-family: sans-serif; font-size: 11px; font-weight: bold; fill: #333; }
+      .table-cell { font-family: monospace; font-size: 10px; fill: #444; }
+      .net-label { font-family: monospace; font-size: 10px; font-weight: bold; }
       .net-data { fill: #1565c0; }
       .net-power { fill: #c62828; }
       .net-gnd { fill: #333; }
-      .net-box { stroke-width: 1.5; fill: white; rx: 3; }
+      .net-box { stroke-width: 1.5; fill: white; }
       .net-box-data { stroke: #1565c0; }
       .net-box-power { stroke: #c62828; }
-      .net-box-gnd { stroke: #333; }
-      .code { font-family: monospace; font-size: 10px; fill: #1565c0; }
-      .table-header { font-family: sans-serif; font-size: 11px; font-weight: bold; fill: #333; }
-      .table-cell { font-family: monospace; font-size: 10px; fill: #444; }
+      .net-box-gnd { stroke: #555; }
+      .pin-label { font-family: monospace; font-size: 8px; fill: white; text-anchor: middle; }
+      .pin-label-side { font-family: monospace; font-size: 9px; fill: #333; }
     </style>
+    <!-- S2 Mini mounting hole -->
+    <circle id="mount-hole" r="4" fill="#1a1a1a" stroke="#333" stroke-width="1"/>
+    <!-- Gold through-hole pin -->
+    <circle id="gold-pin" r="3.5" fill="#d4a84b" stroke="#a67c00" stroke-width="0.5"/>
   </defs>
 
   <!-- Title -->
-  <text x="400" y="28" text-anchor="middle" class="title">HMC472A Attenuator Controller Wiring</text>
-  <text x="400" y="46" text-anchor="middle" class="subtitle">Optimized Mapping: GPIO(n) = Step Bit (n-1)</text>
+  <text x="450" y="30" text-anchor="middle" class="title">HMC472A Attenuator Controller Wiring</text>
+  <text x="450" y="50" text-anchor="middle" class="subtitle">Optimized Mapping: GPIO(n) = Step Bit (n-1)</text>
 
-  <!-- ESP32-S2 Mini Board -->
-  <rect x="60" y="70" width="160" height="220" rx="5" class="board"/>
-  <text x="140" y="92" text-anchor="middle" class="board-label">ESP32-S2 Mini</text>
+  <!-- ==================== ESP32-S2 Mini Board ==================== -->
+  <g transform="translate(80, 75)">
+    <!-- PCB outline - magenta/purple like WEMOS -->
+    <rect x="0" y="0" width="120" height="160" rx="8" fill="#c4168e" stroke="#8b1163" stroke-width="2"/>
 
-  <!-- USB-C -->
-  <rect x="115" y="62" width="50" height="12" rx="3" class="usb"/>
-  <text x="140" y="71" text-anchor="middle" style="font-size:7px;fill:#888;">USB-C</text>
+    <!-- Mounting holes -->
+    <use href="#mount-hole" x="12" y="12"/>
+    <use href="#mount-hole" x="108" y="12"/>
+    <use href="#mount-hole" x="12" y="148"/>
+    <use href="#mount-hole" x="108" y="148"/>
 
-  <!-- ESP32 chip -->
-  <rect x="100" y="105" width="80" height="40" rx="2" class="chip"/>
-  <text x="140" y="130" text-anchor="middle" style="font-size:9px;fill:#666;">ESP32-S2</text>
+    <!-- ESP32-S2 chip (QFN package) -->
+    <rect x="35" y="35" width="50" height="50" rx="2" fill="#2a2a2a" stroke="#444" stroke-width="1"/>
+    <text x="60" y="57" text-anchor="middle" style="font-family:sans-serif;font-size:7px;fill:#888;">S2</text>
+    <text x="60" y="68" text-anchor="middle" style="font-family:sans-serif;font-size:9px;fill:#aaa;font-weight:bold;">Mini</text>
 
-  <!-- S2 Mini Pins with net labels -->
-  <g transform="translate(65, 160)">
-    <!-- Left side pins -->
-    <rect x="0" y="0" width="20" height="9" class="pin"/>
-    <text x="25" y="8" class="pin-label-white">3V3</text>
+    <!-- USB-C connector at bottom -->
+    <rect x="40" y="152" width="40" height="12" rx="2" fill="#444" stroke="#222" stroke-width="1"/>
+    <rect x="48" y="155" width="24" height="6" rx="1" fill="#666"/>
 
-    <rect x="0" y="14" width="20" height="9" class="pin"/>
-    <text x="25" y="22" class="pin-label-white">GPIO1</text>
-    <rect x="70" y="11" width="42" height="14" class="net-box net-box-data"/>
-    <text x="91" y="22" text-anchor="middle" class="net-label net-data">D0</text>
+    <!-- RST button -->
+    <rect x="12" y="130" width="12" height="8" rx="1" fill="#222" stroke="#111"/>
+    <text x="18" y="145" text-anchor="middle" style="font-size:5px;fill:#ccc;">RST</text>
 
-    <rect x="0" y="28" width="20" height="9" class="pin"/>
-    <text x="25" y="36" class="pin-label-white">GPIO2</text>
-    <rect x="70" y="25" width="42" height="14" class="net-box net-box-data"/>
-    <text x="91" y="36" text-anchor="middle" class="net-label net-data">D1</text>
+    <!-- 0 button -->
+    <rect x="96" y="130" width="12" height="8" rx="1" fill="#222" stroke="#111"/>
+    <text x="102" y="145" text-anchor="middle" style="font-size:5px;fill:#ccc;">0</text>
 
-    <rect x="0" y="42" width="20" height="9" class="pin"/>
-    <text x="25" y="50" class="pin-label-white">GPIO3</text>
-    <rect x="70" y="39" width="42" height="14" class="net-box net-box-data"/>
-    <text x="91" y="50" text-anchor="middle" class="net-label net-data">D2</text>
+    <!-- LED indicator near GPIO15 -->
+    <circle cx="85" cy="125" r="2" fill="#3a3" stroke="#282"/>
+    <text x="85" y="120" text-anchor="middle" style="font-size:5px;fill:#ccc;">15</text>
 
-    <rect x="0" y="56" width="20" height="9" class="pin"/>
-    <text x="25" y="64" class="pin-label-white">GPIO4</text>
-    <rect x="70" y="53" width="42" height="14" class="net-box net-box-data"/>
-    <text x="91" y="64" text-anchor="middle" class="net-label net-data">D3</text>
+    <!-- Left side pins (two columns) -->
+    <!-- Outer column: EN, 3, 5, 7, 9, 11, 12, 3.3V -->
+    <g transform="translate(-4, 20)">
+      <use href="#gold-pin" x="0" y="0"/><text x="-12" y="3" class="pin-label-side" text-anchor="end" style="fill:#f90;">EN</text>
+      <use href="#gold-pin" x="0" y="14"/><text x="-12" y="17" class="pin-label-side" text-anchor="end" style="fill:#4a4;">3</text>
+      <use href="#gold-pin" x="0" y="28"/><text x="-12" y="31" class="pin-label-side" text-anchor="end" style="fill:#4a4;">5</text>
+      <use href="#gold-pin" x="0" y="42"/><text x="-12" y="45" class="pin-label-side" text-anchor="end" style="fill:#66a;">7</text>
+      <use href="#gold-pin" x="0" y="56"/><text x="-12" y="59" class="pin-label-side" text-anchor="end" style="fill:#66a;">9</text>
+      <use href="#gold-pin" x="0" y="70"/><text x="-12" y="73" class="pin-label-side" text-anchor="end" style="fill:#66a;">11</text>
+      <use href="#gold-pin" x="0" y="84"/><text x="-12" y="87" class="pin-label-side" text-anchor="end" style="fill:#66a;">12</text>
+      <use href="#gold-pin" x="0" y="98"/><text x="-12" y="101" class="pin-label-side" text-anchor="end" style="fill:#c33;">3.3V</text>
+    </g>
 
-    <rect x="0" y="70" width="20" height="9" class="pin"/>
-    <text x="25" y="78" class="pin-label-white">GPIO5</text>
-    <rect x="70" y="67" width="42" height="14" class="net-box net-box-data"/>
-    <text x="91" y="78" text-anchor="middle" class="net-label net-data">D4</text>
+    <!-- Inner column: 1, 2, 4, 6, 8, 10, 13, 14 -->
+    <g transform="translate(8, 20)">
+      <use href="#gold-pin" x="0" y="0"/><text x="0" y="3" class="pin-label">1</text>
+      <use href="#gold-pin" x="0" y="14"/><text x="0" y="17" class="pin-label">2</text>
+      <use href="#gold-pin" x="0" y="28"/><text x="0" y="31" class="pin-label">4</text>
+      <use href="#gold-pin" x="0" y="42"/><text x="0" y="45" class="pin-label">6</text>
+      <use href="#gold-pin" x="0" y="56"/><text x="0" y="59" class="pin-label">8</text>
+      <use href="#gold-pin" x="0" y="70"/><text x="0" y="73" class="pin-label">10</text>
+      <use href="#gold-pin" x="0" y="84"/><text x="0" y="87" class="pin-label">13</text>
+      <use href="#gold-pin" x="0" y="98"/><text x="0" y="101" class="pin-label">14</text>
+    </g>
 
-    <rect x="0" y="84" width="20" height="9" class="pin"/>
-    <text x="25" y="92" class="pin-label-white">GPIO6</text>
-    <rect x="70" y="81" width="42" height="14" class="net-box net-box-data"/>
-    <text x="91" y="92" text-anchor="middle" class="net-label net-data">D5</text>
+    <!-- Right side pins (two columns) -->
+    <!-- Inner column: 40, 38, 36, 34, 21, 17, GND, 15 -->
+    <g transform="translate(112, 20)">
+      <use href="#gold-pin" x="0" y="0"/><text x="0" y="3" class="pin-label">40</text>
+      <use href="#gold-pin" x="0" y="14"/><text x="0" y="17" class="pin-label">38</text>
+      <use href="#gold-pin" x="0" y="28"/><text x="0" y="31" class="pin-label">36</text>
+      <use href="#gold-pin" x="0" y="42"/><text x="0" y="45" class="pin-label">34</text>
+      <use href="#gold-pin" x="0" y="56"/><text x="0" y="59" class="pin-label">21</text>
+      <use href="#gold-pin" x="0" y="70"/><text x="0" y="73" class="pin-label">17</text>
+      <use href="#gold-pin" x="0" y="84"/><text x="0" y="87" class="pin-label" style="font-size:6px;">GND</text>
+      <use href="#gold-pin" x="0" y="98"/><text x="0" y="101" class="pin-label">15</text>
+    </g>
 
-    <rect x="0" y="98" width="20" height="9" class="pin"/>
-    <text x="25" y="106" class="pin-label-white">GND</text>
-    <rect x="70" y="95" width="42" height="14" class="net-box net-box-gnd"/>
-    <text x="91" y="106" text-anchor="middle" class="net-label net-gnd">GND</text>
+    <!-- Outer column: 39, 37, 35, 33, 18, 16, GND, VBUS -->
+    <g transform="translate(124, 20)">
+      <use href="#gold-pin" x="0" y="0"/><text x="12" y="3" class="pin-label-side" style="fill:#4a4;">39</text>
+      <use href="#gold-pin" x="0" y="14"/><text x="12" y="17" class="pin-label-side" style="fill:#4a4;">37</text>
+      <use href="#gold-pin" x="0" y="28"/><text x="12" y="31" class="pin-label-side" style="fill:#4a4;">35</text>
+      <use href="#gold-pin" x="0" y="42"/><text x="12" y="45" class="pin-label-side" style="fill:#4a4;">33</text>
+      <use href="#gold-pin" x="0" y="56"/><text x="12" y="59" class="pin-label-side" style="fill:#4a4;">18</text>
+      <use href="#gold-pin" x="0" y="70"/><text x="12" y="73" class="pin-label-side" style="fill:#4a4;">16</text>
+      <use href="#gold-pin" x="0" y="84"/><text x="12" y="87" class="pin-label-side" style="fill:#4a4;">GND</text>
+      <use href="#gold-pin" x="0" y="98"/><text x="12" y="101" class="pin-label-side" style="fill:#c33;">VBUS</text>
+    </g>
+
+    <!-- Board label -->
+    <text x="60" y="170" text-anchor="middle" style="font-family:sans-serif;font-size:10px;font-weight:bold;fill:#333;">ESP32-S2 Mini</text>
   </g>
 
-  <!-- Right side 5V -->
-  <g transform="translate(175, 160)">
-    <rect x="0" y="0" width="20" height="9" class="pin"/>
-    <text x="-5" y="8" text-anchor="end" class="pin-label-white">5V</text>
-    <rect x="-47" y="-3" width="42" height="14" class="net-box net-box-power"/>
-    <text x="-26" y="8" text-anchor="middle" class="net-label net-power">+5V</text>
+  <!-- Net labels for S2 Mini used pins -->
+  <g transform="translate(80, 75)">
+    <!-- GPIO1 (pin 1) - D0 -->
+    <rect x="18" y="88" width="32" height="14" rx="3" class="net-box net-box-data"/>
+    <text x="34" y="98" text-anchor="middle" class="net-label net-data">D0</text>
+
+    <!-- GPIO2 (pin 2) - D1 -->
+    <rect x="18" y="102" width="32" height="14" rx="3" class="net-box net-box-data"/>
+    <text x="34" y="112" text-anchor="middle" class="net-label net-data">D1</text>
+
+    <!-- GPIO3 is pin 3 in outer column - need to check actual position -->
+    <!-- From image: inner col has 1,2,4,6... so GPIO3 is NOT in inner column -->
+    <!-- GPIO3 is in LEFT OUTER column, 2nd from top -->
+
+    <!-- GPIO4 (pin 4 inner) - D3 -->
+    <rect x="18" y="116" width="32" height="14" rx="3" class="net-box net-box-data"/>
+    <text x="34" y="126" text-anchor="middle" class="net-label net-data">D3</text>
+
+    <!-- GPIO6 (pin 6 inner) - D5 -->
+    <rect x="18" y="130" width="32" height="14" rx="3" class="net-box net-box-data"/>
+    <text x="34" y="140" text-anchor="middle" class="net-label net-data">D5</text>
+
+    <!-- VBUS - +5V (right outer, bottom) -->
+    <rect x="146" y="186" width="32" height="14" rx="3" class="net-box net-box-power"/>
+    <text x="162" y="196" text-anchor="middle" class="net-label net-power">+5V</text>
+
+    <!-- GND (right outer) -->
+    <rect x="146" y="172" width="32" height="14" rx="3" class="net-box net-box-gnd"/>
+    <text x="162" y="182" text-anchor="middle" class="net-label net-gnd">GND</text>
   </g>
 
-  <!-- HMC472A Module Board -->
-  <rect x="520" y="70" width="220" height="220" rx="5" class="board"/>
-  <text x="630" y="92" text-anchor="middle" class="board-label">HMC472A Module</text>
+  <!-- Left outer column net labels (GPIO 3, 5) -->
+  <g transform="translate(30, 75)">
+    <!-- GPIO3 - D2 -->
+    <rect x="0" y="102" width="32" height="14" rx="3" class="net-box net-box-data"/>
+    <text x="16" y="112" text-anchor="middle" class="net-label net-data">D2</text>
 
-  <!-- HMC472A chip -->
-  <rect x="570" y="105" width="60" height="35" rx="2" class="chip"/>
-  <text x="600" y="127" text-anchor="middle" style="font-size:8px;fill:#666;">HMC472A</text>
-
-  <!-- SMA Connectors -->
-  <ellipse cx="545" cy="170" rx="12" ry="16" class="sma"/>
-  <text x="545" y="192" text-anchor="middle" style="font-size:8px;" class="pin-label-white">RF IN</text>
-  <ellipse cx="715" cy="170" rx="12" ry="16" class="sma"/>
-  <text x="715" y="192" text-anchor="middle" style="font-size:8px;" class="pin-label-white">RF OUT</text>
-
-  <!-- HMC472A Pins with net labels -->
-  <g transform="translate(595, 210)">
-    <rect x="0" y="0" width="20" height="9" class="pin"/>
-    <text x="25" y="8" class="pin-label-white">+5V</text>
-    <rect x="-47" y="-3" width="42" height="14" class="net-box net-box-power"/>
-    <text x="-26" y="8" text-anchor="middle" class="net-label net-power">+5V</text>
-
-    <rect x="0" y="14" width="20" height="9" class="pin"/>
-    <text x="25" y="22" class="pin-label-white">V6 (0.5dB)</text>
-    <rect x="-47" y="11" width="42" height="14" class="net-box net-box-data"/>
-    <text x="-26" y="22" text-anchor="middle" class="net-label net-data">D0</text>
-
-    <rect x="0" y="28" width="20" height="9" class="pin"/>
-    <text x="25" y="36" class="pin-label-white">V5 (1dB)</text>
-    <rect x="-47" y="25" width="42" height="14" class="net-box net-box-data"/>
-    <text x="-26" y="36" text-anchor="middle" class="net-label net-data">D1</text>
-
-    <rect x="0" y="42" width="20" height="9" class="pin"/>
-    <text x="25" y="50" class="pin-label-white">V4 (2dB)</text>
-    <rect x="-47" y="39" width="42" height="14" class="net-box net-box-data"/>
-    <text x="-26" y="50" text-anchor="middle" class="net-label net-data">D2</text>
-
-    <rect x="0" y="56" width="20" height="9" class="pin"/>
-    <text x="25" y="64" class="pin-label-white">V3 (4dB)</text>
-    <rect x="-47" y="53" width="42" height="14" class="net-box net-box-data"/>
-    <text x="-26" y="64" text-anchor="middle" class="net-label net-data">D3</text>
-
-    <rect x="0" y="70" width="20" height="9" class="pin"/>
-    <text x="25" y="78" class="pin-label-white">V2 (8dB)</text>
-    <rect x="-47" y="67" width="42" height="14" class="net-box net-box-data"/>
-    <text x="-26" y="78" text-anchor="middle" class="net-label net-data">D4</text>
-
-    <rect x="0" y="84" width="20" height="9" class="pin"/>
-    <text x="25" y="92" class="pin-label-white">V1 (16dB)</text>
-    <rect x="-47" y="81" width="42" height="14" class="net-box net-box-data"/>
-    <text x="-26" y="92" text-anchor="middle" class="net-label net-data">D5</text>
-
-    <rect x="0" y="98" width="20" height="9" class="pin"/>
-    <text x="25" y="106" class="pin-label-white">GND</text>
-    <rect x="-47" y="95" width="42" height="14" class="net-box net-box-gnd"/>
-    <text x="-26" y="106" text-anchor="middle" class="net-label net-gnd">GND</text>
+    <!-- GPIO5 - D4 -->
+    <rect x="0" y="116" width="32" height="14" rx="3" class="net-box net-box-data"/>
+    <text x="16" y="126" text-anchor="middle" class="net-label net-data">D4</text>
   </g>
 
-  <!-- Connection table in the middle -->
-  <rect x="260" y="120" width="200" height="180" rx="5" fill="#f5f5f5" stroke="#ddd"/>
-  <text x="360" y="140" text-anchor="middle" class="table-header">Net Connections</text>
+  <!-- ==================== HMC472A Module Board ==================== -->
+  <g transform="translate(620, 75)">
+    <!-- PCB outline - green like typical RF modules -->
+    <rect x="0" y="0" width="180" height="180" rx="5" fill="#1a5a2a" stroke="#0d3818" stroke-width="2"/>
 
-  <line x1="270" y1="148" x2="450" y2="148" stroke="#ccc"/>
+    <!-- HMC472A chip -->
+    <rect x="60" y="40" width="60" height="40" rx="2" fill="#1a1a1a" stroke="#333" stroke-width="1"/>
+    <text x="90" y="58" text-anchor="middle" style="font-family:monospace;font-size:7px;fill:#888;">HMC472A</text>
+    <text x="90" y="70" text-anchor="middle" style="font-family:sans-serif;font-size:6px;fill:#666;">0-31.5dB</text>
+
+    <!-- SMA connectors -->
+    <g transform="translate(20, 55)">
+      <ellipse cx="0" cy="0" rx="14" ry="18" fill="#d4a84b" stroke="#a67c00" stroke-width="1"/>
+      <circle cx="0" cy="0" r="5" fill="#ffd700"/>
+      <circle cx="0" cy="0" r="2" fill="#a67c00"/>
+      <text x="0" y="28" text-anchor="middle" style="font-size:8px;fill:#ccc;">RF IN</text>
+    </g>
+    <g transform="translate(160, 55)">
+      <ellipse cx="0" cy="0" rx="14" ry="18" fill="#d4a84b" stroke="#a67c00" stroke-width="1"/>
+      <circle cx="0" cy="0" r="5" fill="#ffd700"/>
+      <circle cx="0" cy="0" r="2" fill="#a67c00"/>
+      <text x="0" y="28" text-anchor="middle" style="font-size:8px;fill:#ccc;">RF OUT</text>
+    </g>
+
+    <!-- 8-pin header -->
+    <g transform="translate(75, 95)">
+      <rect x="-5" y="-5" width="40" height="90" rx="2" fill="#222" stroke="#111"/>
+
+      <!-- Pin 1: +5V -->
+      <use href="#gold-pin" x="10" y="5"/>
+      <text x="35" y="8" class="pin-label-side" style="fill:#ccc;">+5V</text>
+
+      <!-- Pin 2: V6 (0.5dB) -->
+      <use href="#gold-pin" x="10" y="15"/>
+      <text x="35" y="18" class="pin-label-side" style="fill:#ccc;">V6</text>
+
+      <!-- Pin 3: V5 (1dB) -->
+      <use href="#gold-pin" x="10" y="25"/>
+      <text x="35" y="28" class="pin-label-side" style="fill:#ccc;">V5</text>
+
+      <!-- Pin 4: V4 (2dB) -->
+      <use href="#gold-pin" x="10" y="35"/>
+      <text x="35" y="38" class="pin-label-side" style="fill:#ccc;">V4</text>
+
+      <!-- Pin 5: V3 (4dB) -->
+      <use href="#gold-pin" x="10" y="45"/>
+      <text x="35" y="48" class="pin-label-side" style="fill:#ccc;">V3</text>
+
+      <!-- Pin 6: V2 (8dB) -->
+      <use href="#gold-pin" x="10" y="55"/>
+      <text x="35" y="58" class="pin-label-side" style="fill:#ccc;">V2</text>
+
+      <!-- Pin 7: V1 (16dB) -->
+      <use href="#gold-pin" x="10" y="65"/>
+      <text x="35" y="68" class="pin-label-side" style="fill:#ccc;">V1</text>
+
+      <!-- Pin 8: GND -->
+      <use href="#gold-pin" x="10" y="75"/>
+      <text x="35" y="78" class="pin-label-side" style="fill:#ccc;">GND</text>
+    </g>
+
+    <!-- Net labels for HMC472A -->
+    <g transform="translate(30, 95)">
+      <!-- +5V -->
+      <rect x="0" y="0" width="32" height="12" rx="3" class="net-box net-box-power"/>
+      <text x="16" y="9" text-anchor="middle" class="net-label net-power">+5V</text>
+
+      <!-- D0 - V6 -->
+      <rect x="0" y="13" width="32" height="12" rx="3" class="net-box net-box-data"/>
+      <text x="16" y="22" text-anchor="middle" class="net-label net-data">D0</text>
+
+      <!-- D1 - V5 -->
+      <rect x="0" y="23" width="32" height="12" rx="3" class="net-box net-box-data"/>
+      <text x="16" y="32" text-anchor="middle" class="net-label net-data">D1</text>
+
+      <!-- D2 - V4 -->
+      <rect x="0" y="33" width="32" height="12" rx="3" class="net-box net-box-data"/>
+      <text x="16" y="42" text-anchor="middle" class="net-label net-data">D2</text>
+
+      <!-- D3 - V3 -->
+      <rect x="0" y="43" width="32" height="12" rx="3" class="net-box net-box-data"/>
+      <text x="16" y="52" text-anchor="middle" class="net-label net-data">D3</text>
+
+      <!-- D4 - V2 -->
+      <rect x="0" y="53" width="32" height="12" rx="3" class="net-box net-box-data"/>
+      <text x="16" y="62" text-anchor="middle" class="net-label net-data">D4</text>
+
+      <!-- D5 - V1 -->
+      <rect x="0" y="63" width="32" height="12" rx="3" class="net-box net-box-data"/>
+      <text x="16" y="72" text-anchor="middle" class="net-label net-data">D5</text>
+
+      <!-- GND -->
+      <rect x="0" y="73" width="32" height="12" rx="3" class="net-box net-box-gnd"/>
+      <text x="16" y="82" text-anchor="middle" class="net-label net-gnd">GND</text>
+    </g>
+
+    <!-- Board label -->
+    <text x="90" y="195" text-anchor="middle" style="font-family:sans-serif;font-size:10px;font-weight:bold;fill:#333;">HMC472A Module</text>
+  </g>
+
+  <!-- ==================== Connection Table ==================== -->
+  <rect x="310" y="80" width="220" height="200" rx="5" fill="#fafafa" stroke="#ddd" stroke-width="1"/>
+  <text x="420" y="102" text-anchor="middle" class="table-header" style="font-size:13px;">Net Connections</text>
+
+  <line x1="320" y1="110" x2="520" y2="110" stroke="#ccc"/>
 
   <!-- Table headers -->
-  <text x="295" y="164" text-anchor="middle" class="table-header">Net</text>
-  <text x="360" y="164" text-anchor="middle" class="table-header">ESP32</text>
-  <text x="425" y="164" text-anchor="middle" class="table-header">HMC472A</text>
+  <text x="345" y="126" text-anchor="middle" class="table-header">Net</text>
+  <text x="405" y="126" text-anchor="middle" class="table-header">ESP32</text>
+  <text x="480" y="126" text-anchor="middle" class="table-header">HMC472A</text>
 
-  <line x1="270" y1="170" x2="450" y2="170" stroke="#ccc"/>
+  <line x1="320" y1="132" x2="520" y2="132" stroke="#ccc"/>
 
-  <!-- Table rows -->
-  <text x="295" y="186" text-anchor="middle" class="table-cell" style="fill:#1565c0;font-weight:bold;">D0</text>
-  <text x="360" y="186" text-anchor="middle" class="table-cell">GPIO1</text>
-  <text x="425" y="186" text-anchor="middle" class="table-cell">V6 (0.5dB)</text>
+  <!-- Data rows -->
+  <text x="345" y="148" text-anchor="middle" class="table-cell" style="fill:#1565c0;font-weight:bold;">D0</text>
+  <text x="405" y="148" text-anchor="middle" class="table-cell">GPIO1</text>
+  <text x="480" y="148" text-anchor="middle" class="table-cell">V6 (0.5dB)</text>
 
-  <text x="295" y="202" text-anchor="middle" class="table-cell" style="fill:#1565c0;font-weight:bold;">D1</text>
-  <text x="360" y="202" text-anchor="middle" class="table-cell">GPIO2</text>
-  <text x="425" y="202" text-anchor="middle" class="table-cell">V5 (1dB)</text>
+  <text x="345" y="163" text-anchor="middle" class="table-cell" style="fill:#1565c0;font-weight:bold;">D1</text>
+  <text x="405" y="163" text-anchor="middle" class="table-cell">GPIO2</text>
+  <text x="480" y="163" text-anchor="middle" class="table-cell">V5 (1dB)</text>
 
-  <text x="295" y="218" text-anchor="middle" class="table-cell" style="fill:#1565c0;font-weight:bold;">D2</text>
-  <text x="360" y="218" text-anchor="middle" class="table-cell">GPIO3</text>
-  <text x="425" y="218" text-anchor="middle" class="table-cell">V4 (2dB)</text>
+  <text x="345" y="178" text-anchor="middle" class="table-cell" style="fill:#1565c0;font-weight:bold;">D2</text>
+  <text x="405" y="178" text-anchor="middle" class="table-cell">GPIO3</text>
+  <text x="480" y="178" text-anchor="middle" class="table-cell">V4 (2dB)</text>
 
-  <text x="295" y="234" text-anchor="middle" class="table-cell" style="fill:#1565c0;font-weight:bold;">D3</text>
-  <text x="360" y="234" text-anchor="middle" class="table-cell">GPIO4</text>
-  <text x="425" y="234" text-anchor="middle" class="table-cell">V3 (4dB)</text>
+  <text x="345" y="193" text-anchor="middle" class="table-cell" style="fill:#1565c0;font-weight:bold;">D3</text>
+  <text x="405" y="193" text-anchor="middle" class="table-cell">GPIO4</text>
+  <text x="480" y="193" text-anchor="middle" class="table-cell">V3 (4dB)</text>
 
-  <text x="295" y="250" text-anchor="middle" class="table-cell" style="fill:#1565c0;font-weight:bold;">D4</text>
-  <text x="360" y="250" text-anchor="middle" class="table-cell">GPIO5</text>
-  <text x="425" y="250" text-anchor="middle" class="table-cell">V2 (8dB)</text>
+  <text x="345" y="208" text-anchor="middle" class="table-cell" style="fill:#1565c0;font-weight:bold;">D4</text>
+  <text x="405" y="208" text-anchor="middle" class="table-cell">GPIO5</text>
+  <text x="480" y="208" text-anchor="middle" class="table-cell">V2 (8dB)</text>
 
-  <text x="295" y="266" text-anchor="middle" class="table-cell" style="fill:#1565c0;font-weight:bold;">D5</text>
-  <text x="360" y="266" text-anchor="middle" class="table-cell">GPIO6</text>
-  <text x="425" y="266" text-anchor="middle" class="table-cell">V1 (16dB)</text>
+  <text x="345" y="223" text-anchor="middle" class="table-cell" style="fill:#1565c0;font-weight:bold;">D5</text>
+  <text x="405" y="223" text-anchor="middle" class="table-cell">GPIO6</text>
+  <text x="480" y="223" text-anchor="middle" class="table-cell">V1 (16dB)</text>
 
-  <line x1="270" y1="272" x2="450" y2="272" stroke="#ccc"/>
+  <line x1="320" y1="230" x2="520" y2="230" stroke="#ccc"/>
 
-  <text x="295" y="288" text-anchor="middle" class="table-cell" style="fill:#c62828;font-weight:bold;">+5V</text>
-  <text x="360" y="288" text-anchor="middle" class="table-cell">5V</text>
-  <text x="425" y="288" text-anchor="middle" class="table-cell">+5V</text>
+  <!-- Power rows -->
+  <text x="345" y="246" text-anchor="middle" class="table-cell" style="fill:#c62828;font-weight:bold;">+5V</text>
+  <text x="405" y="246" text-anchor="middle" class="table-cell">VBUS</text>
+  <text x="480" y="246" text-anchor="middle" class="table-cell">+5V</text>
 
-  <text x="295" y="304" text-anchor="middle" class="table-cell" style="fill:#333;font-weight:bold;">GND</text>
-  <text x="360" y="304" text-anchor="middle" class="table-cell">GND</text>
-  <text x="425" y="304" text-anchor="middle" class="table-cell">GND</text>
+  <text x="345" y="261" text-anchor="middle" class="table-cell" style="fill:#333;font-weight:bold;">GND</text>
+  <text x="405" y="261" text-anchor="middle" class="table-cell">GND</text>
+  <text x="480" y="261" text-anchor="middle" class="table-cell">GND</text>
 
-  <!-- Footer note -->
-  <text x="400" y="340" text-anchor="middle" class="note">D0-D5 = Step bits 0-5 (LSB to MSB)</text>
-  <text x="400" y="356" text-anchor="middle" class="note">Active-LOW: D=1 → GPIO LOW → Attenuate</text>
-  <text x="400" y="380" text-anchor="middle" class="code">GPIO.out_w1tc = (step &amp; 0x3F) &lt;&lt; 1</text>
+  <!-- ==================== Attenuation Reference ==================== -->
+  <rect x="310" y="295" width="220" height="85" rx="5" fill="#f0f8ff" stroke="#b0c4de" stroke-width="1"/>
+  <text x="420" y="315" text-anchor="middle" class="table-header">Attenuation Bits</text>
+  <line x1="320" y1="322" x2="520" y2="322" stroke="#b0c4de"/>
 
-  <!-- Legend -->
-  <g transform="translate(280, 390)">
-    <rect x="0" y="0" width="30" height="12" class="net-box net-box-data"/>
-    <text x="35" y="10" class="note">Data</text>
-    <rect x="80" y="0" width="30" height="12" class="net-box net-box-power"/>
-    <text x="115" y="10" class="note">Power</text>
-    <rect x="160" y="0" width="30" height="12" class="net-box net-box-gnd"/>
-    <text x="195" y="10" class="note">Ground</text>
+  <text x="340" y="340" class="table-cell" style="font-weight:bold;">Bit</text>
+  <text x="370" y="340" class="table-cell">0</text>
+  <text x="395" y="340" class="table-cell">1</text>
+  <text x="420" y="340" class="table-cell">2</text>
+  <text x="445" y="340" class="table-cell">3</text>
+  <text x="470" y="340" class="table-cell">4</text>
+  <text x="495" y="340" class="table-cell">5</text>
+
+  <text x="340" y="355" class="table-cell" style="font-weight:bold;">dB</text>
+  <text x="370" y="355" class="table-cell">0.5</text>
+  <text x="395" y="355" class="table-cell">1</text>
+  <text x="420" y="355" class="table-cell">2</text>
+  <text x="445" y="355" class="table-cell">4</text>
+  <text x="470" y="355" class="table-cell">8</text>
+  <text x="495" y="355" class="table-cell">16</text>
+
+  <text x="340" y="370" class="table-cell" style="font-weight:bold;">Pin</text>
+  <text x="370" y="370" class="table-cell">V6</text>
+  <text x="395" y="370" class="table-cell">V5</text>
+  <text x="420" y="370" class="table-cell">V4</text>
+  <text x="445" y="370" class="table-cell">V3</text>
+  <text x="470" y="370" class="table-cell">V2</text>
+  <text x="495" y="370" class="table-cell">V1</text>
+
+  <!-- ==================== Footer Notes ==================== -->
+  <text x="450" y="420" text-anchor="middle" class="note">D0-D5 = Step bits 0-5 (LSB to MSB)</text>
+  <text x="450" y="438" text-anchor="middle" class="note">Active-LOW: Bit=1 → GPIO LOW → Attenuate</text>
+  <text x="450" y="460" text-anchor="middle" class="code">GPIO.out_w1tc = (step &amp; 0x3F) &lt;&lt; 1;    // Set LOW where step bit = 1</text>
+  <text x="450" y="476" text-anchor="middle" class="code">GPIO.out_w1ts = (~step &amp; 0x3F) &lt;&lt; 1;   // Set HIGH where step bit = 0</text>
+
+  <!-- ==================== Legend ==================== -->
+  <g transform="translate(340, 490)">
+    <rect x="0" y="0" width="24" height="12" rx="3" class="net-box net-box-data"/>
+    <text x="30" y="10" class="note">Data</text>
+    <rect x="70" y="0" width="24" height="12" rx="3" class="net-box net-box-power"/>
+    <text x="100" y="10" class="note">Power</text>
+    <rect x="145" y="0" width="24" height="12" rx="3" class="net-box net-box-gnd"/>
+    <text x="175" y="10" class="note">Ground</text>
   </g>
+
+  <!-- Image attribution -->
+  <text x="880" y="510" text-anchor="end" style="font-size:8px;fill:#999;">S2 Mini pinout based on WEMOS/LOLIN reference</text>
 </svg>