xilinx Debug UI Framework
Entry points
| Resource | Role |
|---|---|
| src/tool/debug/README.md | User guide, CLI, endpoints |
| doc/design/aiegdb_live_debug_framework.md | Original design doc |
| reference.md | Implementation notes moved from CLAUDE.md |
| dbg_llm_skills/ | Ten embedded-LLM plugin skills |
Quick launch
# TilingLinalg bundle (sim or hw)
python3 src/tool/debug/schedule_debug_server.py aout/worklocal --open
# Single-app sim-only (raw-XAie or tiling sim)
python3 src/tool/debug/schedule_debug_server.py --app aout/worklocal --sim-only --open
# Bare multi-app daemon
python3 src/tool/debug/schedule_debug_server.py --app-root .
Build with live UI: aiehlc.sh --prettydebug (sim: build-only; launch via Run or runsim.sh).
Core components
| File | Purpose |
|---|---|
schedule_view.py |
Static + live HTML/JS (host_schedule.html, daemon-served JS) |
schedule_debug_server.py |
http.server daemon: run orchestration, /grid, LLM tab, MCP bridge |
aiegdb.py |
Scoped CLI over aiedbg; COMMAND_SPEC is the grammar source |
aiemcp.py |
MCP server wrapping in-process AieGdb |
aiediag.py |
Flow-aware DMA diagnosis via provenance JSONs |
xaiehost2provenance.py |
Static provenance for raw-XAie host.cc (no tiling bundle) |
debug_ui_mcp.py |
MCP server for UI state / panes / source manifest |
Session states (read before quoting hardware)
Four states from session_state() / backend_status.json:
| State | Meaning |
|---|---|
none |
No Connect yet — do not treat board reads as current |
connected |
/ping passed |
attached |
Adopted an external run — prior board history unknown |
ran |
Started from this UI — only here may applog + live state be current |
Embedded LLM: read plugin skill session-provenance before any register or log claim.
Related skills
| Task | Skill |
|---|---|
| LLM context loss on retarget | debugui-llm-reset |
| Raw-XAie missing worklocal bundle | raw-xaie-sim-debug-bundle |
| Sim build must not launch sim | sim-build-run-separation |
| Live DMA stall triage | aiehwdmadebug (+ plugin dma-stall-triage) |
| HW performance counters | aiehwprofile |
Feature reference
Detailed per-feature notes (daemon endpoints, UI behaviour, pitfalls) live in reference.md. Read that file when editing a specific subsystem rather than searching CLAUDE.md.
Sections: tools (aiediag, xaiehost2provenance, aiegdb, aiemcp), daemon (session, app detection, run-state, sim-only, source grounding), browser UI (panes, device map, LLM tab, source viewer, scan controls).