[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M71Y2Q2BMB59CVA5K3AKGG13":3,"skill-same:01M71Y2Q2BMB59CVA5K3AKGG13":72},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":39,"linkOnly":40,"markdownContent":41,"markdownBody":42,"frontMatter":43,"refName":44,"commitSha":45,"skillDirectory":5,"forksCount":46,"repositoryHtmlUrl":47,"repositoryHomepageUrl":6,"ownerHtmlUrl":48,"ownerBlogUrl":49,"ownerDescription":50,"updatedAt":51,"install":52,"resources":65},"01M71Y2Q2BMB59CVA5K3AKGG13","vivado-constraints",null,"当用户需要为 Vivado FPGA 设计编写 XDC\u002FSDC 时序或物理约束时使用此技能。这包括时钟定义（create_clock、create_generated_clock、虚拟时钟）、I\u002FO 延迟约束（set_input_delay、set_output_delay、DDR 时序）、时序异常（set_false_path、set_multicycle_path、set_max_delay、set_min_delay）、时钟域交叉（CDC）约束（set_clock_groups、set_bus_skew）、时钟不确定性\u002F抖动\u002F延迟、物理约束（IOSTANDARD、PACKAGE_PIN、LOC、Pblock、布局、布线）、XDC 优先级规则、约束作用域（SCOPED_TO_REF）、约束排序优化或约束调试（check_timing、report_exceptions、report_clock_interaction）。当用户提及 XDC、SDC、时序约束、时钟约束、IO 延迟、false path、multicycle path、clock groups 或物理引脚分配时触发。如需时序报告解释和分析使用 vivado-analysis。","ra9fael\u002Fxilinx-skills","ra9fael","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F42881610?v=4","01M71XZ3B4BV0N7JVGFJEC9CY0","飞","01M71XZ3BRK8TJRT44W0YDR0ZG",3,"GPL-2.0","https:\u002F\u002Fgithub.com\u002Fra9fael\u002Fxilinx-skills\u002Fblob\u002Fmain\u002Fvivado-constraints\u002FSKILL.md",[],[19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38],"vivado constraints","constraints","io","scoped","loc","output","clock","timing","FPGA","interaction","规则","design","false","generated","check","pin","analysis","SET","package","create","2026-11-10 13:45:54",false,"---\nname: vivado-constraints\ndescription: 当用户需要为 Vivado FPGA 设计编写 XDC\u002FSDC 时序或物理约束时使用此技能。这包括时钟定义（create_clock、create_generated_clock、虚拟时钟）、I\u002FO 延迟约束（set_input_delay、set_output_delay、DDR 时序）、时序异常（set_false_path、set_multicycle_path、set_max_delay、set_min_delay）、时钟域交叉（CDC）约束（set_clock_groups、set_bus_skew）、时钟不确定性\u002F抖动\u002F延迟、物理约束（IOSTANDARD、PACKAGE_PIN、LOC、Pblock、布局、布线）、XDC 优先级规则、约束作用域（SCOPED_TO_REF）、约束排序优化或约束调试（check_timing、report_exceptions、report_clock_interaction）。当用户提及 XDC、SDC、时序约束、时钟约束、IO 延迟、false path、multicycle path、clock groups 或物理引脚分配时触发。如需时序报告解释和分析使用 vivado-analysis。\n---\n\n# Vivado XDC 约束决策指南\n\n基于 UG903（v2025.2）。完整语法示例请参阅 REFERENCE.md。\n\n## XDC 文件管理\n\n### 综合 vs 实现约束\n```tcl\n# 工程模式：设置在 XDC 文件对象上\nset_property USED_IN_SYNTHESIS TRUE [get_files timing.xdc]\nset_property USED_IN_IMPLEMENTATION TRUE [get_files timing.xdc]\nset_property USED_IN_SYNTHESIS FALSE [get_files physical.xdc]  ;# 仅实现\n\n# 非工程模式：按适当顺序读取\nread_xdc timing.xdc        ;# 综合和实现都用\nread_xdc physical.xdc      ;# 仅综合后读取\n```\n\n### 约束作用域（用于 IP \u002F 子模块）\n```tcl\n# 工程模式\nset_property SCOPED_TO_REF uart_tx_ctl [get_files uart_tx_ctl.xdc]\nset_property SCOPED_TO_CELLS uart_tx_i0\u002Fuart_tx_ctl_i0 [get_files uart_tx_ctl.xdc]\n\n# 非工程模式\nread_xdc -ref uart_tx_ctl uart_tx_ctl.xdc\nread_xdc -cells uart_tx_i0\u002Fuart_tx_ctl_i0 uart_tx_ctl.xdc\n```\n\n### 对象命名规则\n- 单比特寄存器 `myReg` → 实例名称：`myReg_reg`\n- 多比特寄存器 `myBus[2:0]` → `myBus_reg[0]`、`myBus_reg[1]`、`myBus_reg[2]`\n- 查询多比特：`get_cells myBus_reg[*]`（不是 `myBus_reg[2:0]`）\n- 层次名称：使用明确的 `\u002F` 分隔符，而非带 `-hierarchical` 的通配符\n- **推荐：** 使用 `get_cells inst_A\u002Finst_B\u002F*_reg` 不带 `-hierarchical`\n\n---\n\n## 时钟定义指南\n\n### 主时钟\n```tcl\n# 板级时钟在输入端口（推荐）\ncreate_clock -period 10 [get_ports sysclk]\n\n# 带自定义波形的命名时钟（25% 占空比，90° 相移）\ncreate_clock -name devclk -period 10 -waveform {2.5 5} [get_ports ClkIn]\n\n# 差分时钟 — 仅在正引脚上定义\ncreate_clock -name sysclk -period 3.33 [get_ports SYS_CLK_clk_p]\n\n# GT 恢复时钟\ncreate_clock -name rxclk -period 3.33 [get_pins gt0\u002FRXOUTCLK]\n\n# 虚拟时钟（无网表对象 — 用于 I\u002FO 延迟参考）\ncreate_clock -name clk_virt -period 10\n```\n\n**规则：**\n- 在输入端口上定义主时钟，而非 BUFG 输出\n- 必须首先定义主时钟——其他约束引用它们\n- 虚拟时钟必须在使用它们的 set_input_delay\u002Fset_output_delay 之前定义\n\n### 生成时钟\n```tcl\n# MMCM\u002FPLL 输出 → 自动派生，无需手动约束\n# 用户逻辑分频器 → 必须手动定义：\ncreate_generated_clock -name clkdiv2 -source [get_ports clkin] -divide_by 2 [get_pins REGA\u002FQ]\n\n# 使用 -edges（主时钟的边沿索引）\ncreate_generated_clock -name clkdiv2 -source [get_pins REGA\u002FC] -edges {1 3 5} [get_pins REGA\u002FQ]\n\n# 占空比变化 + 相移通过 -edges 和 -edge_shift\ncreate_generated_clock -name clkshift -source [get_pins mmcm0\u002FCLKIN] \\\n    -edges {1 2 3} -edge_shift {2.5 0 2.5} [get_pins mmcm0\u002FCLKOUT]\n\n# 乘以 + 除以（用于 MMCM 手动定义）\ncreate_generated_clock -name clk43 -source [get_pins mmcm0\u002FCLKIN] \\\n    -multiply_by 4 -divide_by 3 [get_pins mmcm0\u002FCLKOUT]\n\n# 仅组合路径（MUX 输出）\ncreate_generated_clock -name clkout -source [get_pins mmcm0\u002FCLKIN] \\\n    -combinational [get_pins MUX\u002FO]\n\n# 重命名自动派生时钟（仅名称 + source_object）\ncreate_generated_clock -name clk_rx [get_pins clk_gen_i0\u002Fclk_core_i0\u002Finst\u002Fmmcm_adv_inst\u002FCLKOUT0]\n```\n\n**规则：**\n- `-source` 仅接受引脚\u002F端口，不接受时钟对象\n- MMCM\u002FPLL 输出自动派生——仅在需要自定义设置时才手动定义\n- 自动派生时钟仅可在 CMB 输出引脚上重命名\n- 使用 `get_clocks -of_objects [get_pins \u003Cpin>]` 查询自动派生时钟名称\n\n### 时钟组\n```tcl\n# 异步时钟（最常见 — 独立振荡器）\nset_clock_groups -name async_clk0_clk1 -asynchronous \\\n    -group {clk0 usrclk itfclk} -group {clk1 gtclkrx gtclktx}\n\n# 带 -include_generated_clocks（自动包含派生时钟）\nset_clock_groups -name async_grp -asynchronous \\\n    -group [get_clocks -include_generated_clocks clk0] \\\n    -group [get_clocks -include_generated_clocks clk1]\n\n# 互斥时钟（BUFGMUX — 一次仅一个活跃）\nset_clock_groups -name exclusive_clk0_clk1 -physically_exclusive \\\n    -group clk0 -group clk1\n```\n\n**规则：**\n- `set_clock_groups` 在时序异常中具有**最高优先级**\n- 无法被 `-reset_path` 覆盖\n- 对于异步 CDC，优先使用 `set_clock_groups` 而非两个 `set_false_path`\n- `-logically_exclusive` 和 `-physically_exclusive` 对 AMD FPGA 等效\n\n---\n\n## 时钟延迟、抖动、不确定性\n\n```tcl\n# 源延迟（板级延迟，FPGA 外部）\nset_clock_latency -source -early 0.2 [get_clocks sysClk]\nset_clock_latency -source -late 0.5 [get_clocks sysClk]\n\n# 输入抖动（仅主时钟，每个时钟）\nset_input_jitter [get_clocks -of_objects [get_ports clkin]] 0.1\n\n# 系统抖动（全局，所有时钟）\nset_system_jitter 0.05\n\n# 额外时钟不确定性（额外时序裕量）\nset_clock_uncertainty 0.5 [get_clocks clk1]\n\n# 跨时钟不确定性（必须定义两个方向）\nset_clock_uncertainty 2.0 -from [get_clocks clk1] -to [get_clocks clk2]\nset_clock_uncertainty 2.0 -from [get_clocks clk2] -to [get_clocks clk1]\n```\n\n---\n\n## I\u002FO 延迟模板\n\n### SDR 输入\n```tcl\n# 基本（min 和 max）\nset_input_delay -clock sysClk 2 [get_ports DIN]\n\n# 分开 min\u002Fmax\nset_input_delay -clock sysClk -max 4 [get_ports DIN]\nset_input_delay -clock sysClk -min 1 [get_ports DIN]\n\n# 相对于虚拟时钟\ncreate_clock -name clk_port_virt -period 10\nset_input_delay -clock clk_port_virt 2 [get_ports DIN]\n```\n\n### DDR 输入\n```tcl\ncreate_clock -name clk_ddr -period 6 [get_ports DDR_CLK_IN]\nset_input_delay -clock clk_ddr -max 2.1 [get_ports DDR_IN]\nset_input_delay -clock clk_ddr -max 1.9 [get_ports DDR_IN] -clock_fall -add_delay\nset_input_delay -clock clk_ddr -min 0.9 [get_ports DDR_IN]\nset_input_delay -clock clk_ddr -min 1.1 [get_ports DDR_IN] -clock_fall -add_delay\n```\n\n### SDR 输出\n```tcl\nset_output_delay -clock sysClk 6 [get_ports DOUT]\n\n# 分开 min\u002Fmax\nset_output_delay -clock sysClk -max 6 [get_ports DOUT]\nset_output_delay -clock sysClk -min 1 [get_ports DOUT]\n```\n\n### DDR 输出\n```tcl\ncreate_clock -name clk_ddr -period 6 [get_ports DDR_CLK_IN]\nset_output_delay -clock clk_ddr -max 2.1 [get_ports DDR_OUT]\nset_output_delay -clock clk_ddr -max 1.9 [get_ports DDR_OUT] -clock_fall -add_delay\nset_output_delay -clock clk_ddr -min 0.9 [get_ports DDR_OUT]\nset_output_delay -clock clk_ddr -min 1.1 [get_ports DDR_OUT] -clock_fall -add_delay\n```\n\n### 组合路径（输入到输出）\n```tcl\ncreate_clock -name sysClk -period 10\nset_input_delay -clock sysClk 4 [get_ports DIN]\nset_output_delay -clock sysClk 1 [get_ports DOUT]\n# 有效预算：10 - 4 - 1 = 5 ns\n```\n\n**关键规则：**\n- `-clock` 在 Vivado 中是必需的（在 SDC 标准中可选）\n- `-clock_fall` 指的是时钟边沿，而非数据边沿\n- 第二个约束在同一端口上需要 `-add_delay`（DDR）\n- 使用虚拟时钟来模拟不同的抖动\u002F源延迟场景\n\n---\n\n## 时序异常\n\n### 多周期路径 — 决策表\n\n| 场景 | 约束 |\n|------|------|\n| 相同频率同相位 | `set_multicycle_path N -setup -from CLK1 -to CLK2` |\n| | `set_multicycle_path N-1 -hold -from CLK1 -to CLK2` |\n| SLOW → FAST | `set_multicycle_path N -setup -from CLK1 -to CLK2` |\n| | `set_multicycle_path N-1 -hold -end -from CLK1 -to CLK2` |\n| FAST → SLOW | `set_multicycle_path N -setup -start -from CLK1 -to CLK2` |\n| | `set_multicycle_path N-1 -hold -from CLK1 -to CLK2` |\n\n**关键规则：**\n- `-setup` 默认：移动目标（capture）时钟边沿 → 使用 `-start` 移动源端\n- `-hold` 默认：移动源端（launch）时钟边沿 → 使用 `-end` 移动目标端\n- `-start` 和 `-end` 在相同时钟域内无效\n- **始终配对 setup + hold** 多周期约束\n\n### False Path\n```tcl\n# 异步时钟域之间（优先使用 set_clock_groups）\nset_false_path -from [get_clocks CLKA] -to [get_clocks CLKB]\nset_false_path -from [get_clocks CLKB] -to [get_clocks CLKA]\n\n# 复位信号\nset_false_path -from [get_ports reset] -to [all_registers]\n\n# 通过特定路径（-through 顺序很重要！）\nset_false_path -through [get_pins MUX1\u002Fa0] -through [get_pins MUX2\u002Fa1]\n\n# 仅 setup 或仅 hold\nset_false_path -setup -from [get_clocks CLKA] -to [get_clocks CLKB]\n```\n\n**注意：** `-through` 无 `-from` 或 `-to` 会移除通过该引脚\u002F网络的所有路径。\n\n### 最大\u002F最小延迟\n```tcl\n# 覆盖 setup 要求\nset_max_delay 5 -from [get_pins FD1\u002FC] -to [get_pins FD2\u002FD]\n\n# 覆盖 hold 要求\nset_min_delay 1 -from [get_pins FD1\u002FC] -to [get_pins FD2\u002FD]\n\n# CDC 路径带 -datapath_only（无时钟 skew，hold 自动 false-pathed）\nset_max_delay -datapath_only -from [get_cells src_reg*] -to [get_cells dst_reg*] 10.0\n```\n\n**-datapath_only 差异：**\n\n| | set_max_delay | set_max_delay -datapath_only |\n|---|---|---|\n| 时钟 skew | 包含 | 从不包含 |\n| hold 要求 | 不变 | 自动 false-pathed |\n| -from | 可选 | 必需 |\n\n### Case 分析\n```tcl\nset_case_analysis \u003Cvalue> \u003Cpins_or_ports>\n# 值：0, 1, zero, one, rise, rising, fall, falling\n# rise\u002Frising\u002Ffall\u002Ffalling → 仅分析指定转换\n\n# 示例：通过 BUFGMUX 选择 clk_2\nset_case_analysis 1 [get_pins clock_sel\u002FS]\n```\n\n### 禁用时序\n```tcl\n# 禁用单元时序弧\nset_disable_timing -from WCLK -to O [get_cells inst_fifo_gen\u002Fgdm.dm\u002Fgprl.dout_i_reg[*]]\n\n# 检查所有禁用的弧\nreport_disable_timing -file disabled_arcs.rpt\n```\n\n---\n\n## XDC 优先级规则\n\n### 异常优先级（高 → 低）\n1. **set_clock_groups** — 无法覆盖\n2. **set_false_path**\n3. **set_max_delay \u002F set_min_delay**\n4. **set_multicycle_path**\n\n### 对象特异性（高 → 低）\n1. 端口、引脚、单元（单元解析为引脚）\n2. 时钟\n\n### 过滤特异性（高 → 低）\n1. `-from -through -to`\n2. `-from -to`\n3. `-from -through`\n4. `-from`\n5. `-through -to`\n6. `-to`\n7. `-through`\n\n**`-reset_path`** 可以覆盖 false_path\u002Fmax_delay\u002Fmulticycle 优先级，但**不能**覆盖 clock_groups。\n\n**相同约束**（相同类型、相同特异性）以**最后约束获胜**。\n\n---\n\n## CDC 约束\n\n### 异步 CDC\n```tcl\n# 选项 1：set_clock_groups（推荐 — 覆盖两个方向）\nset_clock_groups -asynchronous -group [get_clocks clkA] -group [get_clocks clkB]\n\n# 选项 2：set_false_path（需要两个方向）\nset_false_path -from [get_clocks clkA] -to [get_clocks clkB]\nset_false_path -from [get_clocks clkB] -to [get_clocks clkA]\n```\n\n### 带 max delay 约束的 CDC\n```tcl\n# 限制 CDC 路径延迟（使用同步器 + set_false_path 时）\nset_max_delay -datapath_only -from [get_cells src_reg*] -to [get_cells dst_sync_reg*] 10.0\n```\n\n### 多位 CDC 带总线 skew\n```tcl\n# CE 控制的 CDC（握手）：skew = N_sync_stages * dst_period\nset_bus_skew -from [get_cells src_hsdata_ff_reg*] -to [get_cells dest_hsdata_ff_reg*] 10.000\n\n# Gray 编码 FIFO：skew = dst_period\nset_bus_skew -from [get_cells src_gray_ff_reg*] -to [get_cells {dest_graysync_ff_reg[0]*}] 2.500\n\n# set_bus_skew 需要：-from 和 -to，至少 2 个起点 + 2 个终点\n# 值应 > 0.5 * min(src_period, dst_period)\n```\n\n---\n\n## 性能约束排序\n\n按此顺序编写 XDC 部分以最小化运行时间影响：\n\n| 顺序 | 命令 | 原因 |\n|------|------|------|\n| 1 | `set_disable_timing`、`set_case_analysis` | 首先剪枝时序图 |\n| 2 | `create_clock`、`create_generated_clock`、`set_clock_sense` | 引用前定义时钟 |\n| 3 | `set_clock_latency`、`set_propagated_clock`、`set_clock_uncertainty`、`set_input_jitter`、`set_system_jitter` | 时钟属性 |\n| 4 | `set_input_delay`、`set_output_delay` | I\u002FO 时序 |\n| 5 | `set_clock_groups`、`set_false_path`、`set_min_delay`、`set_max_delay`、`set_multicycle_path`、`set_bus_skew` | 时序异常 |\n| 6 | `set_max_time_borrow`、`set_external_delay` | 很少使用 |\n\n**性能提示：**\n- 对于大型查询使用 `get_cells` 而非 `get_pins`\n- 将重复查询缓存在 Tcl 变量中\n- 避免 `all_fanin`\u002F`all_fanout` 与 `set_disable_timing` 结合使用\n- 在可能的地方用 `get_clocks clk1` 替换 `all_registers -clock clk1`\n\n---\n\n## 约束验证命令\n\n```tcl\n# 检查未约束路径\ncheck_timing -file check_timing.rpt\n\n# 审查时序异常覆盖、冲突、被忽略的约束\nreport_exceptions -coverage -file exceptions_coverage.rpt\nreport_exceptions -ignored -file exceptions_ignored.rpt\nreport_exceptions -scope_override -file exceptions_scope.rpt\nreport_exceptions -ignored_objects -file exceptions_ignored_obj.rpt\n\n# 时钟域交互矩阵\nreport_clock_interaction -file clock_interaction.rpt\n\n# 方法学检查（大型约束集合的 XDCV-1、XDCV-2）\nreport_methodology -file methodology.rpt\n```","# Vivado XDC 约束决策指南\n\n基于 UG903（v2025.2）。完整语法示例请参阅 REFERENCE.md。\n\n## XDC 文件管理\n\n### 综合 vs 实现约束\n```tcl\n# 工程模式：设置在 XDC 文件对象上\nset_property USED_IN_SYNTHESIS TRUE [get_files timing.xdc]\nset_property USED_IN_IMPLEMENTATION TRUE [get_files timing.xdc]\nset_property USED_IN_SYNTHESIS FALSE [get_files physical.xdc]  ;# 仅实现\n\n# 非工程模式：按适当顺序读取\nread_xdc timing.xdc        ;# 综合和实现都用\nread_xdc physical.xdc      ;# 仅综合后读取\n```\n\n### 约束作用域（用于 IP \u002F 子模块）\n```tcl\n# 工程模式\nset_property SCOPED_TO_REF uart_tx_ctl [get_files uart_tx_ctl.xdc]\nset_property SCOPED_TO_CELLS uart_tx_i0\u002Fuart_tx_ctl_i0 [get_files uart_tx_ctl.xdc]\n\n# 非工程模式\nread_xdc -ref uart_tx_ctl uart_tx_ctl.xdc\nread_xdc -cells uart_tx_i0\u002Fuart_tx_ctl_i0 uart_tx_ctl.xdc\n```\n\n### 对象命名规则\n- 单比特寄存器 `myReg` → 实例名称：`myReg_reg`\n- 多比特寄存器 `myBus[2:0]` → `myBus_reg[0]`、`myBus_reg[1]`、`myBus_reg[2]`\n- 查询多比特：`get_cells myBus_reg[*]`（不是 `myBus_reg[2:0]`）\n- 层次名称：使用明确的 `\u002F` 分隔符，而非带 `-hierarchical` 的通配符\n- **推荐：** 使用 `get_cells inst_A\u002Finst_B\u002F*_reg` 不带 `-hierarchical`\n\n---\n\n## 时钟定义指南\n\n### 主时钟\n```tcl\n# 板级时钟在输入端口（推荐）\ncreate_clock -period 10 [get_ports sysclk]\n\n# 带自定义波形的命名时钟（25% 占空比，90° 相移）\ncreate_clock -name devclk -period 10 -waveform {2.5 5} [get_ports ClkIn]\n\n# 差分时钟 — 仅在正引脚上定义\ncreate_clock -name sysclk -period 3.33 [get_ports SYS_CLK_clk_p]\n\n# GT 恢复时钟\ncreate_clock -name rxclk -period 3.33 [get_pins gt0\u002FRXOUTCLK]\n\n# 虚拟时钟（无网表对象 — 用于 I\u002FO 延迟参考）\ncreate_clock -name clk_virt -period 10\n```\n\n**规则：**\n- 在输入端口上定义主时钟，而非 BUFG 输出\n- 必须首先定义主时钟——其他约束引用它们\n- 虚拟时钟必须在使用它们的 set_input_delay\u002Fset_output_delay 之前定义\n\n### 生成时钟\n```tcl\n# MMCM\u002FPLL 输出 → 自动派生，无需手动约束\n# 用户逻辑分频器 → 必须手动定义：\ncreate_generated_clock -name clkdiv2 -source [get_ports clkin] -divide_by 2 [get_pins REGA\u002FQ]\n\n# 使用 -edges（主时钟的边沿索引）\ncreate_generated_clock -name clkdiv2 -source [get_pins REGA\u002FC] -edges {1 3 5} [get_pins REGA\u002FQ]\n\n# 占空比变化 + 相移通过 -edges 和 -edge_shift\ncreate_generated_clock -name clkshift -source [get_pins mmcm0\u002FCLKIN] \\\n    -edges {1 2 3} -edge_shift {2.5 0 2.5} [get_pins mmcm0\u002FCLKOUT]\n\n# 乘以 + 除以（用于 MMCM 手动定义）\ncreate_generated_clock -name clk43 -source [get_pins mmcm0\u002FCLKIN] \\\n    -multiply_by 4 -divide_by 3 [get_pins mmcm0\u002FCLKOUT]\n\n# 仅组合路径（MUX 输出）\ncreate_generated_clock -name clkout -source [get_pins mmcm0\u002FCLKIN] \\\n    -combinational [get_pins MUX\u002FO]\n\n# 重命名自动派生时钟（仅名称 + source_object）\ncreate_generated_clock -name clk_rx [get_pins clk_gen_i0\u002Fclk_core_i0\u002Finst\u002Fmmcm_adv_inst\u002FCLKOUT0]\n```\n\n**规则：**\n- `-source` 仅接受引脚\u002F端口，不接受时钟对象\n- MMCM\u002FPLL 输出自动派生——仅在需要自定义设置时才手动定义\n- 自动派生时钟仅可在 CMB 输出引脚上重命名\n- 使用 `get_clocks -of_objects [get_pins \u003Cpin>]` 查询自动派生时钟名称\n\n### 时钟组\n```tcl\n# 异步时钟（最常见 — 独立振荡器）\nset_clock_groups -name async_clk0_clk1 -asynchronous \\\n    -group {clk0 usrclk itfclk} -group {clk1 gtclkrx gtclktx}\n\n# 带 -include_generated_clocks（自动包含派生时钟）\nset_clock_groups -name async_grp -asynchronous \\\n    -group [get_clocks -include_generated_clocks clk0] \\\n    -group [get_clocks -include_generated_clocks clk1]\n\n# 互斥时钟（BUFGMUX — 一次仅一个活跃）\nset_clock_groups -name exclusive_clk0_clk1 -physically_exclusive \\\n    -group clk0 -group clk1\n```\n\n**规则：**\n- `set_clock_groups` 在时序异常中具有**最高优先级**\n- 无法被 `-reset_path` 覆盖\n- 对于异步 CDC，优先使用 `set_clock_groups` 而非两个 `set_false_path`\n- `-logically_exclusive` 和 `-physically_exclusive` 对 AMD FPGA 等效\n\n---\n\n## 时钟延迟、抖动、不确定性\n\n```tcl\n# 源延迟（板级延迟，FPGA 外部）\nset_clock_latency -source -early 0.2 [get_clocks sysClk]\nset_clock_latency -source -late 0.5 [get_clocks sysClk]\n\n# 输入抖动（仅主时钟，每个时钟）\nset_input_jitter [get_clocks -of_objects [get_ports clkin]] 0.1\n\n# 系统抖动（全局，所有时钟）\nset_system_jitter 0.05\n\n# 额外时钟不确定性（额外时序裕量）\nset_clock_uncertainty 0.5 [get_clocks clk1]\n\n# 跨时钟不确定性（必须定义两个方向）\nset_clock_uncertainty 2.0 -from [get_clocks clk1] -to [get_clocks clk2]\nset_clock_uncertainty 2.0 -from [get_clocks clk2] -to [get_clocks clk1]\n```\n\n---\n\n## I\u002FO 延迟模板\n\n### SDR 输入\n```tcl\n# 基本（min 和 max）\nset_input_delay -clock sysClk 2 [get_ports DIN]\n\n# 分开 min\u002Fmax\nset_input_delay -clock sysClk -max 4 [get_ports DIN]\nset_input_delay -clock sysClk -min 1 [get_ports DIN]\n\n# 相对于虚拟时钟\ncreate_clock -name clk_port_virt -period 10\nset_input_delay -clock clk_port_virt 2 [get_ports DIN]\n```\n\n### DDR 输入\n```tcl\ncreate_clock -name clk_ddr -period 6 [get_ports DDR_CLK_IN]\nset_input_delay -clock clk_ddr -max 2.1 [get_ports DDR_IN]\nset_input_delay -clock clk_ddr -max 1.9 [get_ports DDR_IN] -clock_fall -add_delay\nset_input_delay -clock clk_ddr -min 0.9 [get_ports DDR_IN]\nset_input_delay -clock clk_ddr -min 1.1 [get_ports DDR_IN] -clock_fall -add_delay\n```\n\n### SDR 输出\n```tcl\nset_output_delay -clock sysClk 6 [get_ports DOUT]\n\n# 分开 min\u002Fmax\nset_output_delay -clock sysClk -max 6 [get_ports DOUT]\nset_output_delay -clock sysClk -min 1 [get_ports DOUT]\n```\n\n### DDR 输出\n```tcl\ncreate_clock -name clk_ddr -period 6 [get_ports DDR_CLK_IN]\nset_output_delay -clock clk_ddr -max 2.1 [get_ports DDR_OUT]\nset_output_delay -clock clk_ddr -max 1.9 [get_ports DDR_OUT] -clock_fall -add_delay\nset_output_delay -clock clk_ddr -min 0.9 [get_ports DDR_OUT]\nset_output_delay -clock clk_ddr -min 1.1 [get_ports DDR_OUT] -clock_fall -add_delay\n```\n\n### 组合路径（输入到输出）\n```tcl\ncreate_clock -name sysClk -period 10\nset_input_delay -clock sysClk 4 [get_ports DIN]\nset_output_delay -clock sysClk 1 [get_ports DOUT]\n# 有效预算：10 - 4 - 1 = 5 ns\n```\n\n**关键规则：**\n- `-clock` 在 Vivado 中是必需的（在 SDC 标准中可选）\n- `-clock_fall` 指的是时钟边沿，而非数据边沿\n- 第二个约束在同一端口上需要 `-add_delay`（DDR）\n- 使用虚拟时钟来模拟不同的抖动\u002F源延迟场景\n\n---\n\n## 时序异常\n\n### 多周期路径 — 决策表\n\n| 场景 | 约束 |\n|------|------|\n| 相同频率同相位 | `set_multicycle_path N -setup -from CLK1 -to CLK2` |\n| | `set_multicycle_path N-1 -hold -from CLK1 -to CLK2` |\n| SLOW → FAST | `set_multicycle_path N -setup -from CLK1 -to CLK2` |\n| | `set_multicycle_path N-1 -hold -end -from CLK1 -to CLK2` |\n| FAST → SLOW | `set_multicycle_path N -setup -start -from CLK1 -to CLK2` |\n| | `set_multicycle_path N-1 -hold -from CLK1 -to CLK2` |\n\n**关键规则：**\n- `-setup` 默认：移动目标（capture）时钟边沿 → 使用 `-start` 移动源端\n- `-hold` 默认：移动源端（launch）时钟边沿 → 使用 `-end` 移动目标端\n- `-start` 和 `-end` 在相同时钟域内无效\n- **始终配对 setup + hold** 多周期约束\n\n### False Path\n```tcl\n# 异步时钟域之间（优先使用 set_clock_groups）\nset_false_path -from [get_clocks CLKA] -to [get_clocks CLKB]\nset_false_path -from [get_clocks CLKB] -to [get_clocks CLKA]\n\n# 复位信号\nset_false_path -from [get_ports reset] -to [all_registers]\n\n# 通过特定路径（-through 顺序很重要！）\nset_false_path -through [get_pins MUX1\u002Fa0] -through [get_pins MUX2\u002Fa1]\n\n# 仅 setup 或仅 hold\nset_false_path -setup -from [get_clocks CLKA] -to [get_clocks CLKB]\n```\n\n**注意：** `-through` 无 `-from` 或 `-to` 会移除通过该引脚\u002F网络的所有路径。\n\n### 最大\u002F最小延迟\n```tcl\n# 覆盖 setup 要求\nset_max_delay 5 -from [get_pins FD1\u002FC] -to [get_pins FD2\u002FD]\n\n# 覆盖 hold 要求\nset_min_delay 1 -from [get_pins FD1\u002FC] -to [get_pins FD2\u002FD]\n\n# CDC 路径带 -datapath_only（无时钟 skew，hold 自动 false-pathed）\nset_max_delay -datapath_only -from [get_cells src_reg*] -to [get_cells dst_reg*] 10.0\n```\n\n**-datapath_only 差异：**\n\n| | set_max_delay | set_max_delay -datapath_only |\n|---|---|---|\n| 时钟 skew | 包含 | 从不包含 |\n| hold 要求 | 不变 | 自动 false-pathed |\n| -from | 可选 | 必需 |\n\n### Case 分析\n```tcl\nset_case_analysis \u003Cvalue> \u003Cpins_or_ports>\n# 值：0, 1, zero, one, rise, rising, fall, falling\n# rise\u002Frising\u002Ffall\u002Ffalling → 仅分析指定转换\n\n# 示例：通过 BUFGMUX 选择 clk_2\nset_case_analysis 1 [get_pins clock_sel\u002FS]\n```\n\n### 禁用时序\n```tcl\n# 禁用单元时序弧\nset_disable_timing -from WCLK -to O [get_cells inst_fifo_gen\u002Fgdm.dm\u002Fgprl.dout_i_reg[*]]\n\n# 检查所有禁用的弧\nreport_disable_timing -file disabled_arcs.rpt\n```\n\n---\n\n## XDC 优先级规则\n\n### 异常优先级（高 → 低）\n1. **set_clock_groups** — 无法覆盖\n2. **set_false_path**\n3. **set_max_delay \u002F set_min_delay**\n4. **set_multicycle_path**\n\n### 对象特异性（高 → 低）\n1. 端口、引脚、单元（单元解析为引脚）\n2. 时钟\n\n### 过滤特异性（高 → 低）\n1. `-from -through -to`\n2. `-from -to`\n3. `-from -through`\n4. `-from`\n5. `-through -to`\n6. `-to`\n7. `-through`\n\n**`-reset_path`** 可以覆盖 false_path\u002Fmax_delay\u002Fmulticycle 优先级，但**不能**覆盖 clock_groups。\n\n**相同约束**（相同类型、相同特异性）以**最后约束获胜**。\n\n---\n\n## CDC 约束\n\n### 异步 CDC\n```tcl\n# 选项 1：set_clock_groups（推荐 — 覆盖两个方向）\nset_clock_groups -asynchronous -group [get_clocks clkA] -group [get_clocks clkB]\n\n# 选项 2：set_false_path（需要两个方向）\nset_false_path -from [get_clocks clkA] -to [get_clocks clkB]\nset_false_path -from [get_clocks clkB] -to [get_clocks clkA]\n```\n\n### 带 max delay 约束的 CDC\n```tcl\n# 限制 CDC 路径延迟（使用同步器 + set_false_path 时）\nset_max_delay -datapath_only -from [get_cells src_reg*] -to [get_cells dst_sync_reg*] 10.0\n```\n\n### 多位 CDC 带总线 skew\n```tcl\n# CE 控制的 CDC（握手）：skew = N_sync_stages * dst_period\nset_bus_skew -from [get_cells src_hsdata_ff_reg*] -to [get_cells dest_hsdata_ff_reg*] 10.000\n\n# Gray 编码 FIFO：skew = dst_period\nset_bus_skew -from [get_cells src_gray_ff_reg*] -to [get_cells {dest_graysync_ff_reg[0]*}] 2.500\n\n# set_bus_skew 需要：-from 和 -to，至少 2 个起点 + 2 个终点\n# 值应 > 0.5 * min(src_period, dst_period)\n```\n\n---\n\n## 性能约束排序\n\n按此顺序编写 XDC 部分以最小化运行时间影响：\n\n| 顺序 | 命令 | 原因 |\n|------|------|------|\n| 1 | `set_disable_timing`、`set_case_analysis` | 首先剪枝时序图 |\n| 2 | `create_clock`、`create_generated_clock`、`set_clock_sense` | 引用前定义时钟 |\n| 3 | `set_clock_latency`、`set_propagated_clock`、`set_clock_uncertainty`、`set_input_jitter`、`set_system_jitter` | 时钟属性 |\n| 4 | `set_input_delay`、`set_output_delay` | I\u002FO 时序 |\n| 5 | `set_clock_groups`、`set_false_path`、`set_min_delay`、`set_max_delay`、`set_multicycle_path`、`set_bus_skew` | 时序异常 |\n| 6 | `set_max_time_borrow`、`set_external_delay` | 很少使用 |\n\n**性能提示：**\n- 对于大型查询使用 `get_cells` 而非 `get_pins`\n- 将重复查询缓存在 Tcl 变量中\n- 避免 `all_fanin`\u002F`all_fanout` 与 `set_disable_timing` 结合使用\n- 在可能的地方用 `get_clocks clk1` 替换 `all_registers -clock clk1`\n\n---\n\n## 约束验证命令\n\n```tcl\n# 检查未约束路径\ncheck_timing -file check_timing.rpt\n\n# 审查时序异常覆盖、冲突、被忽略的约束\nreport_exceptions -coverage -file exceptions_coverage.rpt\nreport_exceptions -ignored -file exceptions_ignored.rpt\nreport_exceptions -scope_override -file exceptions_scope.rpt\nreport_exceptions -ignored_objects -file exceptions_ignored_obj.rpt\n\n# 时钟域交互矩阵\nreport_clock_interaction -file clock_interaction.rpt\n\n# 方法学检查（大型约束集合的 XDCV-1、XDCV-2）\nreport_methodology -file methodology.rpt\n```",{"name":5,"description":7},"main","2713ffd8a8fb17d50ccd55714af0d8c5829e3e2f",0,"https:\u002F\u002Fgithub.com\u002Fra9fael\u002Fxilinx-skills","https:\u002F\u002Fgithub.com\u002Fra9fael","https:\u002F\u002Fgithub.com\u002Fra9fei\u002Fblog\u002Fissues","Coincidence-Oriented Programming","2026-05-07 01:52:06",{"source":8,"skillName":5,"commands":53,"prompt":63,"zipAvailable":64},[54,57,60],{"tool":55,"command":56},"npx","npx skills add ra9fael\u002Fxilinx-skills --skill vivado-constraints",{"tool":58,"command":59},"bunx","bunx skills add ra9fael\u002Fxilinx-skills --skill vivado-constraints",{"tool":61,"command":62},"pnpm","pnpm dlx skills add ra9fael\u002Fxilinx-skills --skill vivado-constraints","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fra9fael\u002Fxilinx-skills\u002Fblob\u002Fmain\u002Fvivado-constraints\u002FSKILL.md",true,[66],{"path":67,"resourceType":68,"resourceTypeDesc":69,"sizeBytes":70,"sourceHtmlUrl":71},"REFERENCE.md","REFERENCE","参考文档",12128,"https:\u002F\u002Fgithub.com\u002Fra9fael\u002Fxilinx-skills\u002Fblob\u002Fmain\u002Fvivado-constraints\u002FREFERENCE.md",[73,83,103,118,144,160],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":39},"01M71Y65DRAP7ZKNWFY94BHB9D","xilinx-docs","当用户需要查找xilinx官方文档时使用该技能","https:\u002F\u002Fgithub.com\u002Fra9fael\u002Fxilinx-skills\u002Fblob\u002Fmain\u002Fxilinx-docs\u002FSKILL.md",[],[80,81,82],"xilinx docs","docs","文档",{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":94,"publishedAt":39},"01M71Y5K7NEZF32CFVNVHV0YXV","vivado-tcl","当用户想要生成、编写或执行 Vivado\u002FVitis TCL 脚本用于 FPGA 设计流程时使用此技能。包括创建项目、运行综合\u002F实现、编程设备、使用 IP Integrator 块设计、插入调试核、管理约束、仿真以及任何 Vivado 自动化任务。当用户提及 Vivado、Vitis、FPGA、硬件设计的 TCL 脚本、比特流生成、XDC 约束、ILA\u002FVIO 调试或任何 Xilinx\u002FAMD FPGA 工具链任务时触发。此技能生成并执行 TCL——它不分析 Vivado 输出或报告。对于调试策略和调试核配置决策使用 vivado-debug，对于时序分析使用 vivado-analysis。","https:\u002F\u002Fgithub.com\u002Fra9fael\u002Fxilinx-skills\u002Fblob\u002Fmain\u002Fvivado-tcl\u002FSKILL.md",[89],{"categoryNo":90,"categoryName":91,"taxonomyType":92,"taxonomyTypeDesc":93},"01JBSEEDCAT000000000000015","视觉设计","SCENARIO","使用场景",[95,96,30,97,35,98,99,100,27,101,102],"vivado tcl","tcl","debug","生成","ip","自动化","工具","报告",{"skillNo":104,"name":105,"nameZh":6,"description":106,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":107,"categories":108,"keywords":110,"publishedAt":39},"01M71Y55MVEMB29C0YK8CX5F55","vivado-synth","当用户需要 Vivado 综合策略选择、综合属性配置、synth_design 选项调优、资源推断控制（RAM\u002FDSP\u002FSRL\u002FBRAM）、层次结构优化（flatten_hierarchy、KEEP_HIERARCHY）、OOC（离屏）综合、增量综合、RTL linting、块级综合（BLOCK_SYNTH）或任何综合优化决策时使用此技能。当用户提及综合策略、综合指令、综合属性、资源映射控制、FSM 编码、重定时或询问如何优化综合结果以获得更好的面积\u002F时序\u002F功耗时触发。此技能提供决策知识——如需执行 TCL 命令，请使用 vivado-tcl 技能。","https:\u002F\u002Fgithub.com\u002Fra9fael\u002Fxilinx-skills\u002Fblob\u002Fmain\u002Fvivado-synth\u002FSKILL.md",[109],{"categoryNo":90,"categoryName":91,"taxonomyType":92,"taxonomyTypeDesc":93},[111,30,112,113,114,115,116,96,117],"vivado synth","fsm","定时","linting","keep","block","hierarchy",{"skillNo":119,"name":120,"nameZh":6,"description":121,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":122,"categories":123,"keywords":124,"publishedAt":39},"01M71Y4GPRVZP5C8VD1D7METEW","vivado-sim","当用户需要 Vivado 仿真策略、流程选择和调试方面的帮助时使用此技能。这包括行为仿真（RTL 功能验证）、综合后仿真（网表功能验证）、实现后时序仿真（SDF 反标注，时序验证）、Vivado 仿真器 xsim 使用（xvlog\u002Fxvhdl\u002Fxelab\u002Fxsim 三步流程，launch_simulation 工程模式）、第三方仿真器集成（Questa\u002FModelSim\u002FVCS\u002FXcelium\u002FRiviera\u002FActiveHDL，compile_simlib，export_simulation）、SAIF\u002FVCD 功耗仿真（open_saif\u002Flog_saif，open_vcd\u002Flog_vcd，read_saif + report_power）、仿真网表生成（write_verilog -mode funcsim\u002Ftimesim，write_sdf）、xsim 调试命令（add_force、add_wave、log_wave、add_bp、step、run、restart、get_objects、get_value）、仿真属性和设置、glbl.v 使用，或选择正确仿真方法进行验证或功耗分析的任何问题。","https:\u002F\u002Fgithub.com\u002Fra9fael\u002Fxilinx-skills\u002Fblob\u002Fmain\u002Fvivado-sim\u002FSKILL.md",[],[125,126,127,98,128,129,130,131,132,133,134,135,136,137,138,139,140,141,142,143],"vivado sim","sim","vcs","launch","run","report","compile","simulation","open","read","write","export","power","objects","get","add","Verilog","mode","value",{"skillNo":145,"name":146,"nameZh":6,"description":147,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":148,"categories":149,"keywords":151,"publishedAt":39},"01M71Y45TYXDCYV3R9ZNN546VG","vivado-impl","当用户需要 Vivado 实现策略选择和优化方面的帮助时使用此技能。这包括 opt_design（逻辑优化指令和选项）、place_design（布局指令、拥塞分析、PSIP 物理综合）、phys_opt_design（物理优化 - 扇出\u002F布局\u002F布线\u002FSLR 交叉\u002F寄存器优化、hold 修复）、route_design（布线指令、拥塞解决、预布线关键网络）、power_opt_design（时钟门控、BRAM 功耗优化）、增量实现（read_checkpoint -incremental、auto_incremental、reuse 分析）、ECO 流程、实现运行策略（Performance\u002FCongestion\u002FArea 策略）或选择实现指令或解决实现过程中时序\u002F拥塞问题的任何问题。此技能为实现阶段提供决策知识——如需执行 TCL 命令使用 vivado-tcl，如需综合使用 vivado-synth，如需约束使用 vivado-constraints，如需时序报告解释和分析使用 vivado-analysis。","https:\u002F\u002Fgithub.com\u002Fra9fael\u002Fxilinx-skills\u002Fblob\u002Fmain\u002Fvivado-impl\u002FSKILL.md",[150],{"categoryNo":90,"categoryName":91,"taxonomyType":92,"taxonomyTypeDesc":93},[152,153,154,35,20,155,30,137,156,96,102,157,158,159,134],"vivado impl","impl","checkpoint","performance","reuse","opt","auto","route",{"skillNo":161,"name":162,"nameZh":6,"description":163,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":164,"categories":165,"keywords":166,"publishedAt":39},"01M71Y3M2HSW8R1G9SGZECQNGX","vivado-git","当用户需要实现Vivado工程GIT化的时候使用该技能。","https:\u002F\u002Fgithub.com\u002Fra9fael\u002Fxilinx-skills\u002Fblob\u002Fmain\u002Fvivado-git\u002FSKILL.md",[],[167,168],"vivado git","git"]