WanderVerse
WanderSwitch · decisions

Why this way.

Every meaningful decision in this product, the rationale, and the alternatives we rejected. If you disagree, we want to hear about it.

← Back to product page

WanderSwitch Family — Decision Log

Running log of every keep/swap/drop decision across WanderSwitch Standard (1-gang) + WanderSwitch Pro (3-gang). Citations per entry. In-wall electrical product — UL 20 + UL 1472 + FCC + Matter cert + reliability + survivor-advisory rigor > all else.

This document is the refinement of /tmp/draft-wanderswitch-DECISIONS.md (local-LLM draft validated 98/100) into the full SOP v2.4 decision-log artifact. All 8 platform rules are referenced with explicit [rule: ] tags per decision.

---

Stage 0 — Feature-parity sweep (2026-04-25)

---

Stage 1 — Intake + freeze (2026-04-25)

---

D-SW-001 — No-neutral required: line-scavenging topology with STMicro L9961 + T1235H TRIAC

---

D-SW-002 — Matter-over-Thread only (NO Wi-Fi)

---

D-SW-003 — MCU choice: Nordic nRF52840 across the family (Thread + BLE 5.3)

---

D-SW-004 — TRIAC dimming with adaptive LED-load profiling

---

D-SW-005 — STMicro T1235H + L9961 line-scavenging IC NEW for parts library

---

D-SW-006 — Saffron LED level/status indicator via Cree CLM3C-AKA strip

---

D-SW-007 — NXP SE051 secure element + role token + audit-log encryption + Matter DAC

1. Matter device-attestation cert (DAC) private key — provisioned at Ambassador assembly via secure provisioning fixture; never extractable 2. Survivor-pattern eligibility flag — set at Ambassador assembly time per WWP-side review at order; read-only after assembly; gates covert duress-tap functionality (per D-SW-008) 3. Audit-log encryption key — device-unique key for AES-256-GCM encryption of 90-day rolling audit log in NOR flash 4. UL-cert-mode register — factory-programmed, read-only after assembly. Records UL 20 + UL 1472 listing reference + cert-mode flag. Firmware reads on every boot + verifies UL-required dim parameters (e.g., minimum off-state dim cutoff, max conduction angle on adaptive profiling) not been tampered. If register tampered or invalid, device boots into safe-mode (Level 3 fault indicator + companion-app warning to send back to Ambassador for cert re-verification)

---

D-SW-008 — Identity-aware covert duress-tap pattern (3 paddle taps within 2s = silent panic mesh broadcast) — CONTROVERSIAL; advisory-panel gated

1. Switch performs the requested on/off/dim state change normally (visible to anyone in the room as a normal switch press) 2. Audit log records the duress event with timestamp + switch serial + (encrypted) duress flag 3. Silent mesh broadcast: Level 2 mesh alert via Thread → companion phones (silent vibrate) + WanderNode Hub admin web UI flag + WanderAlert Base Station (when present) → cross-bridge to LoRa → WanderAlert Pager (silent vibrate); no neighbor-cabin propagation by default 4. NO local audible. NO local visual alert. NO change in saffron LED indicator state (continues to show level/on-off as normal)

1. Firmware: covert duress-tap pattern detection + Level 2 mesh broadcast is a software feature; firmware enforces eligibility based on SE051 role-token flag. 2. Secure element (NXP SE051): role token includes survivor-pattern-eligible flag (read-only after Ambassador program); SE051 enforces "if flag not set, duress-tap pattern is not detected and no mesh broadcast can originate." Even if firmware is compromised, SE051 enforces the eligibility gate. [rule: identity-aware]

---

D-SW-009 — Saffron paddle-edge accent + NO exterior wordmark

---

D-SW-010 — Local 90-day audit log + zero light-pattern telemetry leaving device

---

Stage 2 — Component selection summary (2026-04-25)

Per BOM-platform.csv + BOM-modules.csv. Highlights:

FunctionPartReuse status (parts.db)
MCU module (2-tier shared)Nordic nRF52840Reused from bridge_full + router_pro_v2 + router_standard
MCU alternate (Pro Thread router)TI CC2652R7Dual-source per parts.db `radio-thread`
TRIAC (dimmer phase control)STMicro T1235H**NEW for parts library**
Line-scavenging ICSTMicro L9961**NEW for parts library**
Zero-cross detectorSTMicro VIPER22A + opto MOC3023**NEW for parts library** (MOC3023)
Saffron LED indicator stripCree CLM3C-AKAReused from bridge_full + router_pro_v2 + router_standard + WanderCO
LED driverTI TPS92518Reused from security_trio + WanderAlert + WanderCO
Secure elementNXP SE051Reused from medical_tricorder_family + security_trio + WanderCO
PMIC / powerTI TPS65086100Reused from bridge_full + bridge_mini + medical_tricorder_family + router_*_+ WanderAlert + WanderCO
Flash NORMacronix MX25R 8 MB / 16 MBReused
Test buttonAlps SKRH + custom recessed capReused from WanderAlert + WanderCO
Tamper switchOmron D2F-01FReused from WanderAlert + WanderCO
Bezel + paddle (matte cream anodized aluminum)CustomNEW
Saffron pinstripe (1.5 mm leading edge)Custom anodized aluminumNEW
Wall plate (Decora-compatible)Standard Decora cutout; matte cream anodized aluminumNEW
Back box clip + retentionCustom; standard NEMA WD 6 mountingNEW

See BOM-platform.csv, BOM-modules.csv, BOM-normalized.csv, SOURCING.csv for full part list + sourcing.

---

Stage 2b — Configurator axes (2026-04-25)

7 axes per tier. See CONFIGURATOR.md for full matrix. Summary:

---

Stage 3 — Compatibility (2026-04-25)

Resolved:

Deferred to Stage 5 (PCB layout):

---

Stage 4 — Sourcing (2026-04-25, framework only)

See SOURCING.csv. Live RFQs deferred until UL 20 + UL 1472 cert lab engaged + engineering hire onboarded.

Critical dual-source flags:

---

Stage 5 — DFM/DFA/DFT (2026-04-25)

See DFM-DFA-DFT.md. Critical:

---

Stage 6 — Thermal/EMC (2026-04-25)

See THERMAL-EMC.md. Operating range -10 to +60 °C (UL 20 + EN 60669 envelope; in-wall electrical product worst case). TRIAC + L9961 + Thread + BLE coexistence handled per industry-standard ferrite + snubber + careful PCB layout. TRIAC EMI is the critical FCC Part 15 Class B failure mode — board respin budget reserved if pre-scan fails.

---

Stage 7 — Compliance (2026-04-25)

See COMPLIANCE.md.

Cert sequencing (target):

Total cert v1: ~$80-130k.

---

Stage 8 — Canonical BOM + GUIDE + STLs (2026-04-25)

Files produced. STL-OPEN-FILES/README.md documents CC BY-SA 4.0 release for every 3D-printable part:

---

Stage 9 — HW/FW (2026-04-25)

WanderOS-SW on Zephyr (line-scavenging duty-cycle awareness required — aggressive system-off scheduling between paddle press / Matter-fabric event / TRIAC zero-cross controller activity). Single firmware codebase for both tiers (Pro adds Thread border-router compile-time flag + extra paddle handlers). UL 1472 dim-curve compliance + Matter 1.3 + Thread 1.3 stacks. OTA discipline: Matter OTA cluster + signed images + A/B partitions.

---

Stage 10 — Gate (2026-04-25)

See GATE.md. Stage-10 blockers: 1. UL 20 cert granted (HARD GATE — any sale) 2. UL 1472 cert granted (HARD GATE — dimmer SKU) 3. FCC Part 15 B + C cert granted (HARD GATE; TRIAC EMI is the critical failure mode) 4. Matter cert granted (HARD GATE — "Matter-certified" claim) 5. Thread cert (bundled) 6. CSA C22.2 No. 42 + EN 60669-1 + EN 60669-2-1 (Canada + EU markets) 7. Advisory review complete (DV advocate + LGBTQ+ DV survivor + UL human-factors expert panels — covert duress-tap framing) 8. No-neutral LED-load compatibility validation across 8 LED brands (HARD GATE — empirical DVT validation matrix) 9. Bluetooth SIG qualification 10. Identity-aware covert duress-tap firmware + SE051 role-token enforcement + audit-log encryption — independent security audit 11. WanderNode Hub admin web UI + companion app audit-log review functionality

---

Grant-funding plausibility (decision context, not a commitment)

Recorded here so future grant submissions reference the same framing:

ProgramWhy it fitsRangeApplication timing
**HUD CDBG (Community Development Block Grant)**Household electrical retrofit; LIHTC + LIHEAP-compatiblevarieslocal partner pass-through
**VAWA housing transition pools**DV-safehouse covert duress-tap capabilityvariesrolling — through HAVEN partnership
**HUD HOPWA**LGBTQ-housing emergency-comms upgradesvariesannual
**State weatherization assistance pools** (NY, IL, CA, MA all have lighting-controls-eligible budgets)Lighting controls reduce energy use; LIHTC properties eligible$1k-25k per propertyrolling — state-by-state ops work
**Native youth + Tribal-enrolled rural housing programs**Identity-aware lighting controlsvariesthrough Tribal nonprofit partnerships

WanderSwitch is NOT a grant-funded product in the sense that we depend on grants to ship — the LLC pays for v1 cert from forecast hardware revenue. Grants are an accelerator for HAVEN-safehouse + LGBTQ-housing + Title-I-rural-housing donor-sponsored deployment.

---

Critical open items (revalidated)

ItemSeverityAction ownerDeadline
Engineering team hire (EE + FW + Matter cert specialist; shared with WanderAlert + WanderCO + Security Trio pool)redMichaelNOW — 2026-Q3 start
UL 20 + UL 1472 cert lab engagement (Intertek / TUV SUD / UL direct — bundled lab visit)redcert team + Michael2026-Q4
FCC Part 15 B + C cert lab engagementredcert team2026-Q4
Matter cert (CSA / Matter Alliance) engagementredengineering + cert2026-Q4
Advisory panel formation (DV advocate + LGBTQ+ DV survivor + UL human-factors expert)redMichael + WanderSafe team + trauma-informed counsel2026-Q4 (pre-EVT)
**No-neutral LED-load compatibility validation across 8 brands** (HARD GATE)redengineering2027-Q1 (DVT)
**TRIAC EMI Class B pre-scan** + board respin budget reservedredengineering2027-Q1
STMicro T1235H + L9961 + opto-isolator MOC3023 dual-source qualificationyellowengineering hire2027-Q1
Nordic nRF52840 + TI CC2652R7 dual-source qualificationyellowengineering hire2027-Q1
EU bundle (EN 60669-1 + EN 60669-2-1) cert lab bookingyellowcert team2027-Q2
HAVEN safehouse + LGBTQ-housing donor program legal structuringyellowcounsel + Michael2027-Q1
Identity-aware covert duress-tap firmware + SE051 role-token enforcement (independent security audit pre-PVT)redfirmware + security review2027-Q1
Multi-Matter-fabric interop verification (Apple Home + Google Home + Amazon Alexa + Home Assistant + SmartThings + WanderNode Hub)yellowengineering + QA2027-Q2

---

Non-goals (explicitly NOT shipping in v1)