feat(console): Analog In panel — live 10 Hz readout, strip chart, AO→AI loopback sweep (S1) — Studio v0.74

[mbreiser]

Studio half S1 of docs/development/analog-input-plan.md § 4 (plan PR #189; decisions 2026-09-07). Pairs with firmware F1 (reiserlab/LED-Display_G6_Firmware_Arena#46) but works against today's io_ext firmware too — the F1 flags byte is optional on the wire.

What changed (Studio v0.74)

New Console tool: "Analog In" (left-rail button + panel)

• Live readout of both "Analog In (±10V)" BNCs: value, ±10 V bar with a centre mark, min/max since reset, and a 30 s strip chart (green = AI1, blue = AI2). Rate 10 / 5 / 2 Hz, Live/Paused toggle, Reset.
• The poller never floods the log. It reads GET_ANALOG_IN via session.send directly (not the logging send()), is single-flight (a tick is skipped while a read is on the wire), and pauses itself with a visible reason whenever the gate says no: panel closed, not connected, no io_ext firmware, user pause, a run in progress, or a sweep in flight. Only state transitions are logged; it parks after 5 consecutive read errors with a resume hint.
• AO → AI loopback self-test: cable "Analog Out (0-5V)" to an input, pick the input and step size, Run sweep → steps 0→5000 mV, three reads (median) per step, least-squares slope/offset, per-step error table, verdict ok (slope within 5 %, max error ≤ 150 mV) / check / fail, Copy CSV, and the previous AO level is restored. A flat reading near +10 V at every step is called out as the LAB-209 un-reworked-board signature. The sweep is also written to the bridge run log (analog_loopback_sweep).
• The panel's status line shows what the controller reports about its reads (12-bit / calibration state from the F1 flags byte; "10-bit (pre-F1 fw)" otherwise).

Elsewhere

• js/arena-wire-g6.js decodeAnalogIn returns {flags, cal1, cal2, bits12} (null/false on 4-byte replies).
• Arena Trial gain tooltip states the G3-faithful scale: ×10, so 10 = unity = 100 frames/s per volt; 2–5 = 20–50 fps/V; negative reverses.
• The I/O panel's one-shot Read appends the flags text.
• HELP-map entries for the rail button and panel; release notes v0.74; CLAUDE.md Console convention (periodic reads bypass send(), reuse StudioAnalogIn.createPoller).

Code

• js/studio-analog-in.js (new, classic dual-export, DOM-free): createMonitor, createPoller, sweepPlan, fitLinear, summarizeSweep, sweepCsv, describeFlags, median, barFraction, formatMv, drawStripChart.
• arena_studio.html: rail button, panel section, CSS, poller/sweep wiring before the handler table, four data-cmd handlers (caipoll, caireset, caisweep, caisweepcsv).

Tests

• tests/test-studio-analog-in.js (new, in pixi run test): 105 checks — monitor (window trim, min/max persistence, rate, cap), poller (single-flight skip, gate pause reported once, error streak → park → resume, gate reopen forgives errors, injected timers start/restart/stop), sweep math (exact fit, NaN rows, saturation → fail, 10 % slope → check, channel 2, CSV), wire flags decode, and HTML wiring (script order, rail, every panel id, every handler, quiet read, run gate, io_ext gate, HELP entries, gain tooltip, footer, AO restore).
• tests/test-arena-wire-g6.js: flags decode cases (183 → 186).
• Full pixi run test passes; touched JS Prettier-clean; all inline Studio script blocks parse.
• Browser-verified offline (no controller): no console errors, module loads, the rail button opens the panel, the poller status goes "panel closed" → "connect to read" and issues no reads while disconnected.
• Not bench-tested (no hardware for a few days): live values, rate, the sweep against a real board — plan § 5.4 / T6.

🤖 Generated with Claude Code