OpenSTA 虚拟时钟做板级 IO 时序预算:UART 可复算实例
SDC 编写流程解决了约束按什么顺序落地,本篇进一步处理一块更难复核的边界:DUT 内部寄存器由 clk 驱动,片外 UART 对端却不在网表里,怎样让 OpenSTA 同时核算 RX 输入和 TX 输出,而不是把板级延迟误算成片内路径。答案是创建一个没有设计源的虚拟时钟,把外部发射沿、外部捕获沿和内部 core_clk 分开记账。本篇所有数值都可由随文实验重算,重点不是两条 delay 命令的语法,而是预算表怎样与 arrival、required、slack 一一对应。
本文要回答的问题
- 为什么片外 UART 对端没有出现在网表里,仍能为它建立 launch/capture 时序参考?
board_clk与core_clk周期相同,为什么还要建成两个时钟对象?- RX 的
tCO、TX 的tSU/tH、走线和偏斜怎样合成四个 max/min 数值? - setup 与 hold 报告里的 arrival、required、slack 怎样逐项手算闭合?
-clock_fall和-add_delay何时确实需要,虚拟时钟又不能替代哪些真实约束?
这张图的三栏对应三类证据:输入路径的起点、内部真实时钟的端点、输出路径的外部终点。做预算评审时,任何一栏缺数都不能用另外一栏的裕量补;例如 RX setup 很宽松,并不能证明 TX hold 合格。
一、先限定接口:这是同步外壳,不是异步 UART 协议签核
标准 UART 的 RX 是异步串行位流,实际芯片通常先做过采样、起始沿检测和跨时钟同步。那样的接口不能只靠一个周期性的外部时钟就证明每位数据都安全。本篇刻意把问题收窄为一个同步 UART 外壳:假定板级参考时钟已经存在,外部器件按该时钟发射 uart_rx,DUT 内部在 core_clk 上升沿采样;TX 方向则假定外部接收器按同一板级参考沿捕获 uart_tx。串行帧格式、波特率误差和异步 CDC 不在本次 STA 范围内。
这个限定很重要。虚拟时钟不是把异步信号“变成同步信号”的命令,它只是告诉 STA:网表之外存在一个有时序关系的对象。如果真实系统没有这种周期关系,就应该先解决同步与协议约束,而不是套用本篇的数值。
实验网表只有三个关键单元:RX 经 NAND2 到 u_rx/D,TX 从 u_tx/Q 经 BUF_X 到端口。教学 Liberty 给 DFF 的 C→Q 固定为 0.20 ns、setup 为 0.10 ns、hold 为 0 ns,NAND2 和 BUF_X 分别为 0.15 ns、0.10 ns。它们与下面的板级参数一样,都是为了让手算和报告完全对齐的教学假设,不代表某个工艺或通用 UART 芯片。
读图时沿着两条数据线走,不要把紫色虚拟时钟当成第三条数据通路。蓝色是片外输入侧,橙色是 DUT 内部和输出侧,绿色是外部捕获端,紫色只给两侧提供参考沿。RX 报告由 board_clk 发射、core_clk 捕获;TX 则反过来,由 core_clk 发射、board_clk 捕获,这就是两个时钟角色必须分开的原因。
二、两个时钟对象,分别回答“谁发射、谁捕获”
约束先创建真实内部时钟,再创建无源虚拟时钟:
create_clock -name core_clk -period 10.0 \
-waveform {0.0 5.0} [get_ports clk]
create_clock -name board_clk -period 10.0 \
-waveform {0.0 5.0}第一条末尾的 [get_ports clk] 把 core_clk 绑定到设计源,内部 u_rx、u_tx 因而有时钟。第二条故意没有源列表,OpenSTA 不会因此新增内部寄存器时钟,也不会为 board_clk 生成一棵时钟树;它只在 IO delay 被引用后,作为端口路径的发射或捕获参考。两条时钟周期、相位相同,表示本教学场景共享 10 ns 板级参考;如果外部器件实际使用不同相位,就应修改 board_clk 的 waveform,而不是靠随意增大 input delay 掩盖。
-clock board_clk 是 IO 约束与虚拟时钟之间的连接点。若名字写错或引用前尚未创建,OpenSTA 可能只给出诊断而进程仍返回成功,相关排查见 OpenSTA set_input_delay 时钟引用错误。本实验另外扫描日志中的 Error:,避免只看进程退出码便误判约束完整。
还要区分“没有内部时钟源”与“没有时钟约束”。board_clk 无源是刻意设计,core_clk 若漏掉绑定端口则会让内部路径失去真实捕获依据;后者的典型症状见 OpenSTA no clocks found 排查。
三、把外部参数先列成预算表,再写 SDC
以下全部是本篇可复算的教学假设,不是通用器件参数。实际项目必须从对端数据手册、板级仿真或测量、时钟拓扑分别取得 tCO/tSU/tH、传播延迟和偏斜,不能照抄。
| 预算项 | 假设值(ns) | 进入哪条约束 | 计算含义 |
|---|---|---|---|
外部发射器 tCO(max) | 2.00 | RX -max | 参考沿后最迟出数 |
外部发射器 tCO(min) | 0.40 | RX -min | 参考沿后最早可能换数 |
外部接收器 tSU | 1.20 | TX -max | 捕获沿前必须稳定的时间 |
外部接收器 tH | 0.40 | TX -min | 捕获沿后必须保持的时间 |
| RX/TX 单向走线 | 0.35 | 四个数值 | 本例假定两方向相同 |
| 时钟偏斜余量 | 0.10 | 四个数值 | setup 取不利符号,hold 取相反不利符号 |
据此得到四条可审计公式:
| 路径 | 计算公式 | SDC 数值(ns) |
|---|---|---|
| RX setup | 2.00 + 0.35 + 0.10 | input max = 2.45 |
| RX hold | 0.40 + 0.35 - 0.10 | input min = 0.65 |
| TX setup | 1.20 + 0.35 + 0.10 | output max = 1.65 |
| TX hold | -0.40 + 0.35 - 0.10 | output min = -0.15 |
set_input_delay 2.45 -max -clock board_clk [get_ports uart_rx]
set_input_delay 0.65 -min -clock board_clk [get_ports uart_rx]
set_output_delay 1.65 -max -clock board_clk [get_ports uart_tx]
set_output_delay -0.15 -min -clock board_clk [get_ports uart_tx]最值得核对的是 TX hold 的负值。外部接收器要求捕获后保持 0.40 ns,而走线带来 0.35 ns、偏斜项按本例方向再抵去 0.10 ns,所以端口最小 output delay 为 −0.15 ns。OpenSTA 在 hold 要求时间中使用 0.00 - (-0.15) = 0.15,这不是负延迟“让电路变快”,而是最小外部时序合同在报告中的符号约定。若你的偏斜定义方向不同,必须先画时钟到达两端的先后关系,不能机械复制正负号。
四、四条路径逐项闭合:先核时钟沿,再核加法
下面的终端记录来自 OpenSTA 2.0.17。RX setup 报告开头同时出现两个时钟角色,随后每个数字都能回到预算表或 Liberty:
RX setup 的闭合式是:外部参考沿 0 ns,arrival = 2.45 + 0.15 = 2.60 ns;内部下一捕获沿为 10 ns,减去库 setup 0.10 ns,required = 9.90 ns;最终 slack = 9.90 - 2.60 = 7.30 ns。这里 output delay 没有参与,DFF C→Q 0.20 ns 也没有参与——输入路径起点是端口,不是内部发射寄存器。
RX hold 改用 input min:最早到达为 0.65 + 0.15 = 0.80 ns,同一内部捕获沿 0 ns 的 hold 要求为 0 ns,所以 slack 为 0.80 ns。setup 看下一沿最迟到,hold 看当前沿附近是否太早变化;两套输入数值不能用平均数合并。
TX 方向换手:内部 core_clk 在 0 ns 发射,C→Q 与 BUF 构成 0.20 + 0.10 = 0.30 ns 到达时间。setup 的外部捕获沿是 board_clk 的 10 ns,减去 output max 1.65 ns,required 为 8.35 ns,slack 为 8.05 ns。输出端口不是 DFF 的 D 端,因此这条要求时间里没有再减 0.10 ns 库 setup;那 0.10 ns 只属于内部 u_rx 的输入采样检查。
TX hold 的 arrival 仍为 0.30 ns,但 required 变成 0.00 - (-0.15) = 0.15 ns,slack 只有 0.15 ns。它也是四条主路径中最紧的一条,说明不能拿 RX setup 的 7.30 ns 或 TX setup 的 8.05 ns 代替整个接口结论。
这张汇总表不是另造一组结果,而是脚本直接从各段报告提取 arrival、required、slack。复算时应先核对 Startpoint/Endpoint 和 Path Type,再做减法;只 grep 最后一行 slack,可能把 setup 与 hold、RX 与 TX 混在一起。
五、追加外部下降沿:-clock_fall 与 -add_delay 要一起审
主模式只有 board_clk 上升沿发射 RX。实验还提供一个独立的可选场景:假定同一外部源还允许在下降沿发射另一种数据,下降沿模式的 tCO(max/min) 另假设为 3.00/1.00 ns。它不是标准 UART 的默认行为,只用于验证同一端口的多组外部时序合同:
set_input_delay 3.00 -max -clock board_clk \
-clock_fall -add_delay [get_ports uart_rx]
set_input_delay 1.00 -min -clock board_clk \
-clock_fall -add_delay [get_ports uart_rx]-clock_fall 指定外部参考时钟的下降沿,不改变 DUT 内部 u_rx 仍是上升沿采样。-add_delay 表示追加这组端口延迟,而不是替换同端口已有约束;本例正需要保留原来的上升沿 max/min。若只有一组时钟和边沿约束,就不必为了“保险”到处添加它。
追加后最差 RX setup 变为下降沿 5 ns 发射:arrival = 5 + 3.00 + 0.15 = 8.15 ns,required 仍为 9.90 ns,slack 从 7.30 ns 收敛到 1.75 ns。RX hold 最差仍是原上升沿的 0.80 ns,TX 两项不受影响。这组对照同时证明追加约束没有抹掉原路径,也说明报告只显示当前最差路径,不能把未显示理解为未约束。
六、预算评审时还要守住哪些边界
第一,外部参数必须有出处。本篇的数值明确是教学假设;真实项目若只有“典型值”而没有慢角最大值、快角最小值,就不能把它直接当 setup/hold 签核输入。第二,走线和偏斜不是固定加 0.35、减 0.10 的模板,要依据发射端、接收端和时钟到达方向分别建符号表。
第三,max/min 要与库角一致。本例用单个标量 Liberty,只演示公式;真实流程通常在慢角审 setup、快角审 hold,并分别确认外部器件参数是否也采用对应角。第四,虚拟时钟不会给内部寄存器提供时钟。若报告里 u_rx 或 u_tx 没有 core_clk,必须修真实时钟定义,不能再创建一个虚拟时钟顶替。
第五,理想时钟不等于真实时钟树。本实验没有设置 set_clock_uncertainty,报告里的时钟网络按 ideal 处理、延迟为 0;预算表中的 0.10 ns 只是人为指定的板级偏斜余量,既不是抖动,也不能冒充完整的时钟不确定度。迁移到真实项目时,应把片外时钟偏斜、内部时钟树偏差和周期抖动分别列出来源,再决定哪些进入板级 max/min,哪些通过 uncertainty 或时序模型表达。尤其要避免同一偏差既塞进 input/output delay、又设置 uncertainty,造成重复扣减;也不能因为理想报告裕量很大,就省略这些项目。对 setup 与 hold 分别核对 uncertainty 的作用方向后,再重跑四条路径,不能只检查一条 setup 最差值。
最后,不要用 false path 或多周期例外掩盖预算错误。IO 数值来自板级合同,只有功能上确实不检查或确实跨多拍时才使用例外;相关边界可对照 false path 审计 与 多周期路径约束。本篇主预算没有使用这些例外,四条路径全部进入 max/min 报告。
七、迁移到真实板卡时,按什么顺序替换这份预算
拿到真实原理图和对端资料后,可以先复制实验的表格结构,再逐项替换证据,而不是直接改 SDC 数字。第一步写清数据方向和采样边沿:谁产生参考时钟,时钟是否随数据一起出板,RX 在内部哪个沿采样,TX 对端在哪个沿捕获。只要其中一个问题没有答案,就还不能确定 launch/capture 关系。特别是标准异步 UART,应先回到过采样和 CDC 方案,不能把“115200 波特”换算成周期后当作虚拟时钟周期。
第二步分别建立慢角与快角输入。setup 关心最迟到数,因此 RX 使用外部最大 tCO,TX 使用接收端 tSU;hold 关心最早换数,因此 RX 使用最小 tCO,TX 使用接收端 tH。如果数据手册只给从另一种边沿起算的参数,要先换算到本例参考沿。不要把最大输出延迟同时填入 max 和 min,也不要把 tH 的正数原样填进 output min 后就不看报告符号。
第三步单列板级修正项。走线时间可以来自提取的传播延迟或仿真,偏斜要比较“数据发射时钟到源器件”和“捕获时钟到目的器件”的先后。建议每个修正项同时记录方向、最大值、最小值与来源,再由表格生成 SDC。这样当报告差 0.10 ns 时,可以定位是哪一项假设发生变化,而不是直接在端口延迟上加一个无法解释的补丁。
| 评审字段 | RX 应记录的内容 | TX 应记录的内容 |
|---|---|---|
| 发射参考 | 外部源时钟、边沿、相位 | 内部 core_clk、边沿、相位 |
| 捕获参考 | 内部采样沿与库 setup/hold | 外部接收沿与 tSU/tH |
| 外部延迟 | 对端 tCO(max/min) 出处 | 对端 tSU/tH 出处 |
| 板级修正 | RX 走线、两端时钟偏斜 | TX 走线、两端时钟偏斜 |
| 验收报告 | max 与 min 各一条端口到寄存器路径 | max 与 min 各一条寄存器到端口路径 |
第四步做“数字、路径、覆盖”三种复核。数字复核就是本文的减法:required 减 arrival 必须等于 slack;路径复核要看起点和终点是否确实由预期的两个时钟驱动;覆盖复核则确认所有需要约束的 IO 都至少出现在对应报告中。最差报告只显示一条路径时,还要按端口或端点补查,避免一个宽松端口遮掉另一个紧张端口。
最后保留预算版本。外部器件换料、PCB 改版、时钟树调整或内部采样沿改变,都可能让旧 slack 失效。把参数来源、约束文件和 OpenSTA 输出放在同一次评审记录里,才能回答“这次裕量为什么变化”。若修改后 hold 变小而 setup 不变,通常先查最小延迟与捕获后保持要求;若 setup 变差而 hold 不变,则先查最大 tCO、周期、相位和 tSU。这种分方向定位比看到总 WNS 就统一收紧约束更可靠。
代码获取:完整 RTL、教学 Liberty、主预算与下降沿 SDC、OpenSTA Tcl、运行脚本、Makefile、结果日志和汇总脚本位于 geek-doc.cn/experiments/flow-opensta-io-budget-virtual-clock。进入目录执行 make run,即可重算本文全部数字。
实验环境
- 机器/系统:macOS 宿主运行 Docker,容器内为 Linux;镜像
geek-eda:0.3-sta。 - 工具版本:OpenSTA 2.0.17,
sta -version输出2.0.17;汇总使用 Python 3。 - 日期:2026-11-22。
- 完整命令:
docker run --rm -v "$PWD":/work -w /work geek-eda:0.3-sta bash -lc 'bash -x run.sh';容器内依次运行baseline.tcl与dual_edge.tcl,并从报告生成汇总。 - 测量边界:所有外部器件数值、走线和偏斜都是教学假设;Liberty 为标量常数延迟,结果只证明预算与报告计算一致,不构成任何真实 UART 器件、PCB 或工艺角的签核结论。
这一篇在知识体系里的位置
本篇位于 静态时序分析 STA 入门 与完整约束编写之间,专门解决“网表外的对端怎样进入时序合同”。需要先梳理 create_clock、IO delay 和例外的落地次序,可读 SDC 编写流程:从时钟到 IO;若考虑用 false path 或 multicycle 调整路径责任,先按 OpenSTA false path 与 multicycle 约束决策 核对功能协议和检查沿,不用例外修补预算错误。遇到时钟对象引用失败,再沿 set_input_delay 时钟引用错误 排查。异步时钟分组属于另一类问题,应另见 SDC 时钟组约束,不能用本篇共享参考沿的假定替代 CDC 设计。
总结
OpenSTA 虚拟时钟做板级 IO 时序预算的关键,是让无源 board_clk 只描述片外 launch/capture 参考沿,让绑定端口的 core_clk 负责内部寄存器,再把外部参数逐项写成可审计的 max/min 预算。本篇 UART 同步外壳得到 RX setup/hold slack 7.30/0.80 ns、TX setup/hold 8.05/0.15 ns,四项都能由 arrival 与 required 手算闭合;追加 -clock_fall -add_delay 的外部下降沿模式后,最差 RX setup 收敛为 1.75 ns。虚拟时钟不生成真实内部时钟,也不解决异步 UART 的 CDC;真实项目必须用数据手册和板级数据替换教学假设,并分别复核 setup 与 hold。