Skip to content

Model the volatile reprogram ladder as a hardware plan - #131

Merged
timkpaine merged 2 commits into
mainfrom
tkp/sram-program-plan
Jul 23, 2026
Merged

Model the volatile reprogram ladder as a hardware plan#131
timkpaine merged 2 commits into
mainfrom
tkp/sram-program-plan

Conversation

@timkpaine

Copy link
Copy Markdown
Member

Increment 1 of dau-docs-private/ROADMAP_DAU_BUILD_FIXES.md: SramProgramPlan encodes the bench-proven volatile (SRAM) reprogram safe order as ordered ToolSteps — device-scoped PM hold (tolerant), deadman arm, sysfs remove, volatile program, secondary-bus reset on the endpoint's upstream bridge (new explicit HostAccess.reset_bridge_bdf fact, threaded through for_platform/the task/yaml), global rescan + settle, endpoint verify, optional injected device verify, deadman disarm.

The disarm step is deliberately not named *release: the executor stops on the first failure and runs only *release cleanup after, so a wedge leaves the deadman armed and the box self-recovers to the SPI-resident design — pinned by test. Codex round 1 caught swallowed setpci/rescan failures behind trailing sleeps (now &&-chained so they fail the step) and the unquoted bridge BDF (now shlex.quoted).

SramProgramPlan encodes the bench-proven SRAM safe order as ordered
ToolSteps: device-scoped PM hold (tolerant), deadman arm, sysfs remove,
volatile program, secondary-bus reset on the endpoint's upstream bridge
(a new explicit host_access fact, reset_bridge_bdf), global rescan +
settle, endpoint verify, an optional injected device verify, deadman
disarm. The disarm step is deliberately not named *release: the plan
executor stops on the first failure and runs only *release cleanup after,
so a wedge leaves the deadman armed and the box self-recovers to the
SPI-resident design — pinned by test.

Signed-off-by: Tim Paine <3105306+timkpaine@users.noreply.github.com>
Signed-off-by: Tim Paine <3105306+timkpaine@users.noreply.github.com>
@timkpaine
timkpaine merged commit 8f6472d into main Jul 23, 2026
@timkpaine
timkpaine deleted the tkp/sram-program-plan branch July 23, 2026 22:10
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