a113d: headless-GUI bench driver + A113D GUI install/restore (full cycle passes on hardware) #53

Merged
noah merged 4 commits from feat/a113d-headless-bench into main 2026-11-16 22:50:53 -07:00
Owner

Summary

A headless-GUI bench driver that drives the toolkit's real operation layer through the A113D network-only install <-> flag-restore cycle, plus the A113D install/restore support the GUI was missing. Validated end-to-end on the bench A113D: full cycle PASSES (install -> verify alkane -> in-band flag-restore -> verify stock).

Changes

  • stock_ops: add a113d to SUPPORTED_BOARDS (the GUI offered Zynq only); add start_restore_flag() - the A113D restore is the in-band ALAN flag flip (install overwrites no stock partition), which the GUI had no clean path for.
  • bench_sequence (new) + main.rs ALKANE_BENCH_SEQUENCE: a no-window driver that runs start_install(AfwSource::Local) -> verify -> start_restore_flag, classifying stock vs alkane by SSH/HTTP.
  • MAC rediscovery: the A113D can take a different (or no) DHCP lease under alkane, so the driver resolves the board's MAC up front and re-finds it after each reboot instead of assuming a fixed IP.
  • Restore credential: the flag-restore reaches the running alkane board as root (baked alkane), a different credential from the stock login; the driver now uses the alkane root cred for restore and the stock cred for install.

Hardware validation (bench A113D, 2026-11-16)

Full cycle PASS: install OK -> verify alkane (dropbear_2026.93, found at its lease via MAC rediscovery) -> restore OK -> verify stock (dropbear_2018.76). Three image gaps were also found and fixed (SMSC LAN8710 PRG_ETH0 PHY RX, misc partition in the alkane DTB, restore credential) - the first two are alkane-sdk a113d image fixes (detail in alkane-sdk-construction); this PR carries the toolkit-side pieces.

Stacks on feat/readable-stock-install-a113d (the A113D flash support it builds on).

Generated with Claude Code

https://claude.ai/code/session_01B1W6qKwKxq3oUPDKWicM6i

## Summary A headless-GUI bench driver that drives the toolkit's **real** operation layer through the A113D network-only install <-> flag-restore cycle, plus the A113D install/restore support the GUI was missing. **Validated end-to-end on the bench A113D: full cycle PASSES** (install -> verify alkane -> in-band flag-restore -> verify stock). ## Changes - **`stock_ops`**: add `a113d` to `SUPPORTED_BOARDS` (the GUI offered Zynq only); add `start_restore_flag()` - the A113D restore is the in-band `ALAN` flag flip (install overwrites no stock partition), which the GUI had no clean path for. - **`bench_sequence` (new)** + `main.rs` `ALKANE_BENCH_SEQUENCE`: a no-window driver that runs `start_install(AfwSource::Local)` -> verify -> `start_restore_flag`, classifying stock vs alkane by SSH/HTTP. - **MAC rediscovery**: the A113D can take a different (or no) DHCP lease under alkane, so the driver resolves the board's MAC up front and re-finds it after each reboot instead of assuming a fixed IP. - **Restore credential**: the flag-restore reaches the running alkane board as `root` (baked `alkane`), a different credential from the stock login; the driver now uses the alkane root cred for restore and the stock cred for install. ## Hardware validation (bench A113D, 2026-11-16) Full cycle **PASS**: `install OK -> verify alkane (dropbear_2026.93, found at its lease via MAC rediscovery) -> restore OK -> verify stock (dropbear_2018.76)`. Three *image* gaps were also found and fixed (SMSC LAN8710 `PRG_ETH0` PHY RX, `misc` partition in the alkane DTB, restore credential) - the first two are alkane-sdk a113d image fixes (detail in alkane-sdk-construction); this PR carries the toolkit-side pieces. Stacks on `feat/readable-stock-install-a113d` (the A113D flash support it builds on). Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01B1W6qKwKxq3oUPDKWicM6i
noah changed target branch from feat/readable-stock-install-a113d to main 2026-11-16 21:40:28 -07:00
noah added 4 commits 2026-11-16 21:46:45 -07:00
- stock_ops: add "a113d" to SUPPORTED_BOARDS so the GUI offers A113D install
  (it was zynq-7010 only); add start_restore_flag() - the A113D restore is the
  in-band ALAN flag flip (install overwrites no stock partition), which the GUI
  lacked a clean path for (start_restore needs a firmware file, which the A113D
  ignores).
- bench_sequence (new) + main.rs ALKANE_BENCH_SEQUENCE: a headless driver that
  drives the real GUI operation layer (start_install(AfwSource::Local) -> verify
  -> start_restore_flag) through the A113D network-only install<->restore cycle,
  no wx window. Classifies stock vs alkane by SSH dropbear version / HTTP.

Hardware status (bench A113D, 2026-11-16): the install leg is PROVEN on real
hardware via the GUI operation layer. The verify/restore legs are NOT yet
validated end-to-end because the 0.1.0 a113d alkane image does not fully boot on
the bench board (kernel+eth up, no DHCP/SSH) - an alkane-os image bringup issue,
tracked separately. Known limitation: the driver assumes the board keeps its IP
across reboots; it should re-discover the board (A113D can change/lose its lease
under alkane). Not released pending a working image + the discovery fix.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01B1W6qKwKxq3oUPDKWicM6i
The A113D can take a different DHCP lease (or lose its v4 lease) across the
install/restore reboots, so assuming the board keeps its initial IP broke the
verify/restore steps. Resolve the board's MAC up front (on stock) and, after
each reboot, re-locate it in the neighbour table (sweeping the /24 when it is
not cached) so verify and the flag-restore target the board's CURRENT address.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01B1W6qKwKxq3oUPDKWicM6i
The flag-restore reaches the running alkane board over SSH as root, which is a
different credential from the stock login used for install. Alkane bench images
bake root/alkane; pass that (overridable via ALKANE_ROOT_PASSWORD) to the
restore, and keep the saved board SSH credential for the install. The previous
single-credential handoff sent the stock login to the alkane root restore and
hit "Permission denied".

Hardware note (2026-11-16): the PHY-fixed afw installs and comes up REACHABLE on
alkane (both the image PHY fix and the driver's MAC rediscovery proven); the
in-band flag-restore still needs the alkane DTB to expose the `misc` MTD (it
currently exposes only nvdata), tracked separately.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01B1W6qKwKxq3oUPDKWicM6i
style: rustfmt the A113D GUI install + headless bench driver
source / check (pull_request) Skipped
verify / verify (pull_request) Successful in 13m48s
verify / verify-windows (pull_request) Successful in 10m44s
12a11edfd7
cargo fmt -p alkane-gui; no logic change. This branch's CI never ran before
(its verify was skipped), so the formatting was never enforced.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01B1W6qKwKxq3oUPDKWicM6i
noah force-pushed feat/a113d-headless-bench from 795f80a44c to 12a11edfd7 2026-11-16 21:46:45 -07:00 Compare
noah merged commit 0873d2c79d into main 2026-11-16 22:50:53 -07:00
Sign in to join this conversation.