跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
开发与测试

vivado-debug

Use this skill when the user needs help with Vivado in-system debugging, hardware programming, or debug core configuration. This includes ILA (Integrated Logic Analyzer) configuration and trigger strategies, VIO (Virtual I/O) usage for signal monitoring and control, JTAG-to-AXI Master for AXI transaction generation, mark_debug attribute and debug probing flows (Netlist Insertion, HDL Instantiation), Set Up Debug Wizard, ILA cross-trigger architecture, debug core timing impact and mitigation, Vivado Hardware Manager operation, FPGA/SoC device programming, Versal debugging architecture (AXI4 Debug Hub, CIPS integration), SVF file programming, debug clock requirements, and common debug error troubleshooting. This skill provides debugging strategy and decision-making knowledge — for TCL command execution use vivado-tcl, for implementation strategies use vivado-impl, for timing analysis use vivado-analysis.

adeleempurpled290 · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add adeleempurpled290/FPGA-Agent-skills --skill vivado-debug

技能说明


name: vivado-debug description: Use this skill when the user needs help with Vivado in-system debugging, hardware programming, or debug core configuration. This includes ILA (Integrated Logic Analyzer) configuration and trigger strategies, VIO (Virtual I/O) usage for signal monitoring and control, JTAG-to-AXI Master for AXI transaction generation, mark_debug attribute and debug probing flows (Netlist Insertion, HDL Instantiation), Set Up Debug Wizard, ILA cross-trigger architecture, debug core timing impact and mitigation, Vivado Hardware Manager operation, FPGA/SoC device programming, Versal debugging architecture (AXI4 Debug Hub, CIPS integration), SVF file programming, debug clock requirements, and common debug error troubleshooting. This skill provides debugging strategy and decision-making knowledge — for TCL command execution use vivado-tcl, for implementation strategies use vivado-impl, for timing analysis use vivado-analysis.

Vivado Programming & Debugging Guide

Based on UG908 (v2025.2). This skill helps choose debug strategies, configure debug cores, and troubleshoot hardware debugging. For complete command syntax, see REFERENCE.md. For TCL execution, use vivado-tcl.

Debug Core Selection

Choose debug cores based on what you need to observe or control:

Debug CoreVersionPurposeKey Capability
ILA (Integrated Logic Analyzer)v6.2Trigger on events and capture data at system speedsWaveform capture, advanced triggers, storage qualification
VIO (Virtual Input/Output)v3.0Monitor or control signals at JTAG scan ratesReal-time signal read/write, no waveform capture
JTAG-to-AXI Masterv1.2Generate AXI transactions to interact with AXI slave coresRead/write AXI Full and AXI Lite interfaces
ILA Cross-Trigger(ILA feature)Synchronize triggers between ILA cores or between ILA and processorCross-clock-domain trigger coordination

Decision guide:

Need to capture signal waveforms at full speed?
  YES --> ILA
  NO  --> Need to read/write signals in real-time?
            YES --> VIO (low bandwidth, JTAG rate)
            NO  --> Need to read/write AXI slave registers?
                      YES --> JTAG-to-AXI Master
                      NO  --> Need to coordinate triggers across clock domains?
                                YES --> ILA with Cross-Trigger enabled

Debug Probing Flow Selection

Four approaches to add debug cores, each with different trade-offs:

ScenarioFlowHow It WorksBest For
Tag signals in HDL, use wizard latermark_debug + Netlist InsertionAdd mark_debug attribute in VHDL/Verilog. After synthesis, use Set Up Debug wizard to insert ILA cores.Flexibility to enable/disable debug without HDL changes
Mark signals in synthesized netlist GUIGUI Mark DebugRight-click nets in Netlist/Schematic views and select Mark Debug. Use Set Up Debug wizard.Quick signal selection without modifying source code
Automated scripted flowTCL AutomationUse set_property to set mark_debug, then create_debug_core / connect_debug_port TCL commands.Repeatable, version-controlled debug insertion
Full control in HDL sourceHDL InstantiationManually instantiate ILA/VIO/JTAG-to-AXI Master IP in HDL and connect to signals.Per-probe comparator control, cross-trigger ports, VIO cores

mark_debug Attribute

Vivado Synthesis Syntax

Verilog:

(* mark_debug = "true" *) wire [7:0] char_fifo_dout;

VHDL:

attribute mark_debug : string;
attribute mark_debug of char_fifo_dout: signal is "true";

Valid values: "TRUE" or "FALSE" (the "SOFT" value is not supported by Vivado synthesis).

config_flows -mark_debug Modes

Control MARK_DEBUG behavior post-synthesis without modifying source files:

ModeSynthesis BehaviorImplementation BehaviorUse When
enable (default)Do not optimize MARK_DEBUG netsDo not optimize MARK_DEBUG netsActive debugging, need nets preserved
disableFreely optimizeFreely optimizeProduction build, remove all debug overhead
synthesis_onlyDo not optimize (nets available at start of impl)Freely optimize during implWant debug net availability but allow impl optimization

Debug Net Icons in Vivado IDE

Hollow green icon  = MARK_DEBUG set, NOT connected to any ILA core
Full green icon    = MARK_DEBUG set, connected to an ILA core
Yellow icon        = No MARK_DEBUG on net, but connected to an ILA core

ILA Configuration Decisions

Data Depth Selection

The C_DATA_DEPTH property controls how many samples the ILA stores. Larger depth consumes more Block RAM:

C_DATA_DEPTHSamplesBRAM ImpactRecommended Use
1024 (default)1KLowInitial debug, quick trigger verification
20482KLow-MediumShort protocol sequences
40964KMediumTypical protocol debug
81928KMedium-HighLonger event sequences
1638416KHighMulti-phase protocol analysis
3276832KHighRare event capture with large pre/post-trigger window
6553664KVery HighExtended capture, ensure BRAM budget allows
131072128KVery HighMaximum capture depth, significant resource cost

Rule of thumb: Start with 1024. Increase only when you need more pre/post-trigger context. Each doubling roughly doubles BRAM usage per probe bit.

Key ILA Properties Decision Table

PropertyDefaultSet to TRUE WhenImpact
C_ADV_TRIGGERfalseNeed state-machine-based triggers, counter triggers, or range triggersAdds trigger logic resources
C_EN_STRG_QUALfalseNeed basic capture control (filter which samples are stored)Uses 1 comparator for capture control
C_INPUT_PIPE_STAGES0Timing violations on ILA probe inputs; increase to 1-6Adds FF pipeline stages, improves timing at cos
阅读完整来源 ↗