Skip to content

board_header() and header_map(): the wiring profile on the pod's header as text - #107

Merged
wardviaene merged 2 commits into
mainfrom
board-view
Nov 18, 2026
Merged

wardviaene merged 2 commits into
mainfrom
board-view

Conversation

@wardviaene

Copy link
Copy Markdown
Member

The web and desktop apps get a Visualize button that draws a wiring profile on the pod's real I/O header (benchpod-ui#35). MCP clients (Claude Code, Claude Desktop, Codex) can't reliably show a picture from a tool, so the MCP gets the same thing as text instead of an image.

  • BenchPod.board_header(): "j1" (2x11 pin headers, one-piece boards up to v3-r2) or "front" (2x13 front connector, digital v3r3 and later), None when the pod can't tell. Asked once per connection: the read-only module command (answers on module-link boards, refuses with "no module link" elsewhere, works over the cloud), else the status.
  • header_map(wiring, header) (new embeddedci.benchpod.header, exported): each header pin in its physical place, then what to connect to it (pull resistors noted). None writes both headers.
  • MCP wiring returns board_header and header_map.
  • README (SDK + MCP), CHANGELOG 3.0.2 for both packages, API surface snapshot.

Tests: tests/test_header.py (layout, connections, detection incl. caching and old firmware), MCP test_wiring_draws_the_profile_on_the_pods_header. Full SDK suite 988 passed; MCP 208 passed. Not HW-tested.

🤖 Generated with Claude Code

…er as text

BenchPod.board_header() asks the pod once per connection which I/O header it has (the read-only
module command: front connector on digital v3r3 and later, J1 pin headers on the one-piece boards;
else the status). header_map(wiring, header) writes the profile on it: each pin in its physical
place, then what to connect to it. The MCP wiring tool returns board_header and header_map, so an
agent without a picture can still show the user how to wire the board. Docs and changelogs (3.0.2).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ay null)

The MCP's minimum SDK is 3.0.1, which has no header_map: import it optionally.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@wardviaene
wardviaene merged commit 50e61ad into main Nov 18, 2026
20 checks passed
@wardviaene wardviaene mentioned this pull request Nov 18, 2026
@wardviaene
wardviaene deleted the board-view branch November 20, 2026 02:47
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