Skip to content

feat(M4-P0E3B1): canonical full three-MU board snapshot and read-only Studio inspection - #348

Merged
masarray merged 3 commits into
mainfrom
feat/m4-p0e3b1-atomic-board-inspection
Oct 28, 2026
Merged

masarray merged 3 commits into
mainfrom
feat/m4-p0e3b1-atomic-board-inspection

Conversation

@masarray

Copy link
Copy Markdown
Owner

Meaningful M4 milestone: firmware-authoritative independent three-MU inspection

  • ESP32-P4 firmware SVSTREAM <slot> SHOW emits a single atomic bank snapshot per MU using SNAP BEGIN/8 ROW/END with per-slot generation and canonical sv_scenario_hash. Includes all 8 wire channel counts, phase, quality/enabled, fundamental frequency, per-MU CT shaping and TX enable. No dynamic allocation and no work in the 250µs publisher loop.
  • Production M4ThreeMuBoardReadback verifies 3 sequential snapshots: exact slot, 8 unique channel rows, full typed bounds, generation, CT shaping, canonical hash, firmware-reported END and verified boot; rejects missing/replayed/mixed/tampered rows. Accepts pristine generation=0 bank.
  • Wire parser into existing one DeviceController / DeviceIoWorker, with worker-write-confirmed readback admission, bounded 6-second timeout, session/boot/disconnect/STOP/deploy/apply invalidation, and strict no-interleaving. Supervisor requestInspectMultiSvBoard available while group is already autonomously RUNNING, no START/STOP or implicit profile mutation.
  • Studio Inspect board displays MU1/2/3 read-only frequency/generation/TX status, hover details of all eight channels and quality/CT; does not overwrite the editor draft.
  • Existing arstack_m4_upload_harness extended with production parser success and negative cases (duplicate/missing row, altered quality hash, boot epoch), without new CI jobs or workflow matrix changes.
  • Engineer guide: docs/M4_P0E3B1_FULL_BOARD_READBACK.md.

Scope honesty: This is an explicit read-only full-state inspection and preparation for reconnect adoption, not automatic reconnect detection, proof of selected SCD roster, verified group START, or physical 12kfps/one-PTP capture. Those remain P0E3B2/P0E3C/P0F. M3.H.3 Official Stable unaffected.

CI efficiency: one consolidated commit 800af9d5c81135fc2181d288ee5c7b270276a2bf, only existing exact-head pipelines; no speculative repeated pushes. Tracks #333.

…udio inspection

Firmware UART SHOW now emits BEGIN/8 ROW/END with generation and canonical full-waveform hash including CT shaping, channel quality and enabled. Production Qt reader validates 3 banks sequentially with exact hash, slot/row count/generation and boot session, no auto START or draft overwrite. Integrate through existing sole DeviceIoWorker with bounded timeout and cancellation on errors/port changes; expose Inspect board with per-MU details. Extend existing native M4 harness, no extra CI jobs.
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 28, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-28T12:48:23.494351Z 800af9d PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 800af9d5c8

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread apps/arstack_studio/qml/Main.qml Outdated
Comment thread apps/arstack_studio/src/DeviceController.cpp
Own M4 readback parser via lifetime-scoped unique_ptr behind forward declaration in DeviceController.hpp; include canonical live_signal_transaction before Qt macro definitions in the two concrete translation units. Avoid the Qt slots keyword collision in portable SvFixedPointSineEngine. No extra task/worker, no firmware timing change.
…erve PTP STOP authority

Show Inspect board without loaded 3-MU SCD; keep draft Open disabled without qualified SCD. Hold deferred SHOW/PTP SHOW while inspector owns responses and release via m4BoardChanged; preempt inspection for priority PTP STOP/STOP so STOP readback is not starved. Add regression in existing deterministic session harness. Addresses two Codex P2 review findings without additional workflow jobs.
@masarray
masarray merged commit b7fdf40 into main Oct 28, 2026
20 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant