feat(console): analog-input calibration UI (two-point, deadband) + wire 0xA5/0xA6/0xA7 + ai_cal (S2) — Studio v0.75

[mbreiser]

Studio half S2 of docs/development/analog-input-plan.md § 4. Stacks on S1 (#190) — retarget to main as #190 merges. Pairs with firmware F2 (reiserlab/LED-Display_G6_Firmware_Arena branch feat/ai-calibration); without that firmware the panel says "needs ai_cal firmware" and the calibration controls do nothing.

What changed (Studio v0.75)

Analog In panel → calibrate row

• Channel select · Read (GET_ANALOG_CAL 0xA7 + GET_ANALOG_IN_RAW 0xA5) → a table per channel: state (calibrated (both points) / +10 V point ✓ · 0 V point — / no points), the two raw points, mV per count and offset, deadband, and the live raw count evaluated on the calibrated and the nominal scale so the effect of the calibration is visible.
• 1 · Sample +10 V (open) and 2 · Sample 0 V (ground cap) — the guided two steps (SET_ANALOG_CAL actions 1 and 0); the controller averages 256 reads and stores the point. A +10 V point reading low is called out (BNC not open, or an un-reworked LAB-209 board).
• Deadband (default 20 mV) Set · Clear with confirmation.
• Writes are advanced-mode only (added to SAFE_BLOCKED_CMDS; Read stays available), gated on the ai_cal capability, logged to the Console and to the bridge run log (event: 'analog_cal' with the returned record), and they refresh the panel's flags text.

Wire (js/arena-wire-g6.js): GET_ANALOG_IN_RAW 0xA5 / SET_ANALOG_CAL 0xA6 / GET_ANALOG_CAL 0xA7, ANALOG_CAL_ACTIONS, encodeSetAnalogCal(ch, action, mv) with range checks, decodeAnalogCal (18-byte record → channels with the implied line a/b), decodeAnalogInRaw, capability bit 6 ai_cal.

Module (js/studio-analog-in.js): nominalMv, calLine, calMv, calStepsText, describeCalSource, calTableRows.

Tests

• tests/test-arena-wire-g6.js 186 → 204: encoders (names and codes, deadband bytes), rejections (ch 3, unknown action, deadband range/type), record decode (header, valid channel line a/b, invalid channel, short payload), raw decode, capability name.
• tests/test-studio-analog-in.js 105 → 148: nominal/calibrated math, step text, source text, table rows with and without live raws; HTML wiring — element ids, all five handlers, the safe-mode set blocks the four writes and not the read, the ai_cal gate, the analog_cal log event, the clear confirmation, footer v0.75.
• Full pixi run test passes; touched JS Prettier-clean; inline Studio scripts parse.
• Not bench-tested (no hardware): the real two-point flow needs a board with the F2 firmware and a BNC ground cap — plan § 5.2 C1–C3.

🤖 Generated with Claude Code