pccx-lab Handbook¶
pccx-lab is the desktop profiler + verification IDE for the pccx v002
NPU. It ingests .pccx binary traces emitted by the xsim testbench
suite on the companion pccx-FPGA-NPU-LLM-kv260 RTL repo and surfaces
the timeline, roofline, bottleneck windows, waveform, Vivado synth
reports, and AI-driven UVM strategies in a single Tauri v2 window.
This section documents the tool’s internal surface — the TraceAnalyzer
registry, the Copilot automation facade, the command-line binaries,
and the research lineage that grounds each analyzer in a published paper.
For the user-facing desktop app itself, see the separate pccx-lab site.
Repo layout, layer contract, data flow, extension hooks.
pccx_analyze modes (pretty / JSON / Markdown / synth /
--compare / --research-list / --explain), plus
pccx_cli and from_xsim_log.
The TraceAnalyzer trait, the 16-entry built-in registry, and
how to land a new analysis in one file.
The Copilot struct — investigate(), explain(id),
rank_by_severity(), suggest_fix(intent) — and the intent
keyword routing table.
Auto-generated table of every arxiv paper each analyzer / UVM
strategy implements. Updated via pccx_analyze --research-list.