1. UART发送别急着写always块:代码开发工具里的四模块拆法
手上有一块FPGA开发板,想把一串并行数据从TX脚送出去,很多人的第一版代码是一个always块里同时做波特率计数、并串移位和起始位拼接。仿真看着能出波形,一进代码开发工具综合,时序报告里全是组合逻辑长路径,改一个波特率参数还得动半个文件。UART发送的难点从来不是协议本身,而是怎么把它组织成能在开发工具里独立编译、单独验证、换项目直接搬的模块。下面这份结构把发送侧拆成波特率、复位、应用层、物理层四块,顶层只负责连线。适合已经能写Verilog、但工程组织还停留在"一个文件打天下"的人。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 四个模块怎么分:uart_tx_top 的架构与信号流
2.1 波特率、复位、应用层、物理层各管什么
先把顶层例化能看到的接口摆出来,职责边界就清楚了。四个子模块的输入输出不是随手定的,每一根线都对应一个具体的分工,读者对照下面的表再看代码会顺很多。
| 模块 | 主要输入 | 主要输出 | 在链路里的角色 |
|---|---|---|---|
| uart_bps | clk、rst | uart_clk | 产生发送节拍,供后面所有逻辑使用 |
| uart_rst | clk(接 uart_clko)、rst | uart_rsto | 把系统复位同步到发送时钟域 |
| uart_app_tx | clk、rst、data_in[15:0]、data_in_en | data_out[7:0]、data_out_en | 位宽收窄与发送请求握手 |
| uart_tx | clk、rst、i_uart_txdata[7:0]、i_uart_txdata_en | o_uart_tx | 并串移位,驱动TX脚 |
uart_bps 是节拍源。它只干一件事:把系统时钟分频成发送用的 uart_clko,后面三个模块全部踩这个节拍走。把分频单独拎出来,好处是改波特率只动这一个模块,物理层和应用层一行不用改。我见过把分频计数器写进 uart_tx 里的工程,换个波特率要重新核对移位逻辑的边界,改一次错一次。
uart_rst 是复位处理。从顶层例化看,它用 uart_clko 采样系统复位,输出 uart_rsto 给应用层和物理层。这么做的意图很明确:让后面两个模块在同一个时钟域里同步退出复位,避免一个模块已经干活、另一个还压在复位里。复位没对齐,首帧数据最容易错位,后面第5章会专门讲这个现象。
uart_app_tx 是应用层,输入是16位的 tx_data_in 和使能 tx_data_in_en,输出是8位的 data_out 和 data_out_en。位宽从16收窄到8,说明应用层要决定这16位怎么拆成字节流、什么时候发第一个字节。具体拆法材料没限定,可能是取低8位先发、也可能是分两次握手,读者按自己的数据组织方式实现,但接口契约要守住:data_out_en 有效时,data_out 上的字节必须是稳定的。
uart_tx 是物理层,只认8位数据和使能,按 uart_clko 的节拍把起始位、数据位、停止位依次挪到 o_uart_tx。它不关心数据从哪来、波特率是多少,只要节拍对,帧就出得对。这种"物理层不掺业务"的边界,是这套结构能在开发工具里被反复复用的关键。
2.2 时钟与复位为什么从波特率模块派生
这套结构里最值得说的一处取舍,是物理层直接用 uart_clko 当工作时钟,而不是用系统时钟加一个波特率计数器。两种做法都常见,差别在综合工具怎么看待这根时钟。
用"系统时钟+计数器"的做法,整个设计只有一个时钟域,时序约束简单,综合工具不会报未知时钟。代价是物理层里要多一套计数比较逻辑,每发一位判一次计数值,代码量和出错面都大一些。用"uart_clko 直接当节拍"的做法,物理层每个时钟发一位,逻辑极简,但 uart_clko 是一根派生时钟,必须在开发工具里显式告诉综合和时序分析工具它的频率和来源,否则这根时钟上的路径不被约束,上板后跑久了就出偶发错误。
从 uart_tx 的接口看,它只有 clk、rst 和并串数据,没有波特率参数,说明设计者选的是第二种:时钟即波特率。这个选择对代码组织友好,对约束提出了更高要求。实际做的时候,我一般会在约束里为 uart_clko 建一个生成时钟,源是系统时钟,分频比按 uart_bps 的实际分频值填。分频值由系统时钟频率除以目标波特率算出来,材料没给具体数值,读者按自己板子的晶振和目标波特率算,别照抄别人的数。
复位这边同理。uart_rst 用 uart_clko 采样系统复位,等于是把异步的系统复位同步到发送时钟域。这个动作本身是对的,但要注意两点:采样链通常要打两拍再输出,单拍采样在跨时钟域时可能采到亚稳态;复位释放的时机要落在 uart_clko 的节拍上,不能比时钟先撤。这两点在内部门级实现里决定,顶层看不出来,但上板现象会告诉你有没有做对——第一帧数据错位、或者发送状态机卡死,八成是复位释放没对齐节拍。
2.3 信号流走一遍:从 tx_data_in 到 o_uart_tx
把一根数据从入口走到出口,能看清模块之间到底怎么接力。外部逻辑把16位数据放到 tx_data_in,同时拉高 tx_data_in_en,这是应用层看到的"有活干了"。uart_app_tx 在自己的节拍下接住这个请求,把数据整理成8位,在 data_out 上给出字节,同时用 data_out_en 通知物理层"这个字节有效"。
物理层 uart_tx 收到 data_out_en 后,把 data_out 锁进内部的移位寄存器,先发起始位,再按 uart_clko 的节拍逐位送出8个数据位,最后补停止位。发完一帧,它要把 data_out_en 这条握手清掉,等应用层给下一个字节。这里最容易被忽略的是"发完清握手"这一步:如果物理层收下使能后不清,应用层会以为上一个字节还没被取走,链路就卡在第一个字节上,现象是TX脚只动了一次就再也不动。
整条链路里,uart_clko 是唯一的节拍基准,uart_rsto 是唯一的复位基准,其余全是数据和握手。只要这两根基准在开发工具里被正确约束、在仿真里被正确激励,中间三块可以各自单独验证:给 uart_bps 一个时钟看分频对不对,给 uart_tx 一个字节看帧格式对不对,给 uart_app_tx 看握手有没有丢。分开验证比盯着整条链路猜要快得多,这也是拆模块最实际的回报。
3. 顶层集成代码逐段拆:端口、例化与那个没声明的信号
3.1 端口表与位宽对齐
顶层 uart_tx_top 的端口只有五个:clk、rst、tx_data_in、tx_data_in_en、o_uart_tx。数量少,但每一根都要和子模块对齐,位宽错一位,综合工具不一定报错,上板数据就少一截。下面这段是顶层模块的端口和内部声明部分,先看结构,再逐段说。
verilog复制module uart_tx_top (
clk ,
rst ,
tx_data_in ,
tx_data_in_en ,
o_uart_tx );
//========================================================================
//port
//========================================================================
input clk ;
input rst ;
input [15:0] tx_data_in ;
input tx_data_in_en ;
output o_uart_tx ;
//========================================================================
//reg
//========================================================================
wire o_uart_tx ;
wire uart_clko ;
wire uart_rsto ;
wire [7:0] data_out ;
wire o_uart_rxdata_en;
端口部分有两个位宽要盯住。tx_data_in 是16位,进来之后到应用层还是16位,应用层再收窄成8位的 data_out,所以顶层内部必须同时存在16位和8位两条数据路径,不能图省事全用16位。o_uart_tx 是单比特输出,声明成 wire 而不是 reg,因为它由物理层模块驱动,顶层只做连线,不产生逻辑。
内部声明里有四个信号值得注意:uart_clko 和 uart_rsto 是节拍与复位,data_out 是8位数据,o_uart_rxdata_en 是一个声明了却没接到任何地方的信号。前三个是链路必需的,最后一个从名字看像是接收方向的使能,出现在发送顶层里属于命名残留。这类残留信号编译不报错,但会误导后来读代码的人,以为这里有接收逻辑,排查问题时白白绕一圈。我一般会在整理工程时把它删掉,或者至少加注释说明它不参与发送。
位宽对齐还有一处隐性要求:tx_data_in 是16位,应用层的 data_in 也必须是16位,不能因为最终只发8位就在顶层提前截断。提前截断等于把"取哪8位"的决定从应用层挪到了顶层,应用层就失去了对数据组织方式的控制,后面想改成发两个字节都改不动。接口位宽要按最上游的数据宽度定,收窄放在真正需要收窄的那一层做。
3.2 四个例化的连接关系
顶层的主体是四个例化,连线逻辑比端口更能说明设计意图。下面这段是完整的例化部分,读者可以对照 2.1 的表逐个核对连接。
verilog复制//========================================================================
//code rtl
//========================================================================
uart_bps uart_bps_tx(
.clk (clk),
.rst (rst),
.uart_clk (uart_clko));
uart_rst uart_rst_tx(
.clk (uart_clko),
.rst (rst),
.uart_rsto (uart_rsto));
uart_app_tx uart_app_tx(
.clk (uart_clko),
.rst (uart_rsto),
.data_in (tx_data_in),
.data_in_en (tx_data_in_en),
.data_out (data_out),
.data_out_en (data_out_en));
uart_tx uart_tx(
.clk (uart_clko ),
.rst (uart_rsto ),
.o_uart_tx (o_uart_tx ),
.i_uart_txdata (data_out ),
.i_uart_txdata_en (data_out_en));
第一段例化把系统时钟和复位送进 uart_bps,输出 uart_clko。注意它的复位用的是系统复位 rst,不是 uart_rsto,因为它就是产生节拍和复位链的源头,不能自己等自己。
第二段例化 uart_rst,时钟接 uart_clko,复位接系统 rst,输出 uart_rsto。这里有个细节:复位模块的输入时钟是 uart_clko,说明它在用发送节拍采样系统复位,这是典型的复位同步做法。把系统复位直接分给后面模块也能跑,但释放时刻不受 uart_clko 约束,首帧容易错位,所以多这一级是值得的。
第三段例化应用层,时钟接 uart_clko,复位接 uart_rsto,16位数据进、8位数据出。它的 data_out_en 输出连到物理层的 i_uart_txdata_en,这是整条链路唯一的握手线,断了就发不出数据。
第四段例化物理层,时钟和复位与应用层同源,8位数据 data_out 接 i_uart_txdata,使能接 i_uart_txdata_en,输出 o_uart_tx。物理层不接系统时钟,只接 uart_clko,再次印证了"时钟即波特率"的取舍。
四个例化看下来,连线原则很清楚:时钟从 uart_bps 出发,复位从 uart_rst 出发,数据从应用层流向物理层,握手从应用层流向物理层。没有反向握手,也没有跨级的旁路,这种单向结构在综合时最容易被工具优化干净,仿真时也最容易定位问题出在哪一级。
3.3 声明缺口与命名残留
前面贴的两段代码里藏着一个真实问题:例化里用了 data_out_en,但顶层的 wire 声明里只有 data_out 和 o_uart_rxdata_en,没有 data_out_en。这不是排版漏看,是代码本身的声明缺口。
在Verilog里,端口连接中出现的未声明标识符,不同工具的处理不一样:有的按隐式1位wire处理并给警告,有的直接报错,有的在综合阶段才暴露成连接悬空。无论哪种,结果都是 data_out_en 这条握手线没有在顶层被正式声明,读代码的人无法从声明区确认它的位宽和用途。修法很简单,在 wire 声明区补一行 wire data_out_en;,位宽1位,和握手信号的性质一致。
另一处是 o_uart_rxdata_en。它被声明成 wire,但全文没有任何例化或逻辑驱动它,也没接到输出端口。从命名看它属于接收方向,出现在发送顶层里是复制粘贴留下的残迹。它的危害不在功能,在可读性:新人读到这里会停下来想"发送模块为什么有接收使能",然后花时间确认它没用。工程代码里这种残留越多,排查时干扰越大。我的习惯是每轮整理都把未驱动的声明清掉,清之前用工具的未使用信号报告过一遍,确认没有隐藏的连接再删。
这两处放在一起说明一个道理:顶层代码短,不等于可以少看。恰恰因为顶层只做连线,任何一处声明缺口或命名不一致都会直接体现在链路上,而且往往在综合或上板阶段才发作。写完顶层先做一次声明与例化的交叉核对,比上板后抓波形猜要省时间。
4. 在代码开发工具里跑通发送链路:综合、约束与上板三步
4.1 工程创建与文件组织
代码写完之后,进开发工具的第一件事不是点综合,是把文件组织对。这套结构有五个源文件:顶层 uart_tx_top 一个,四个子模块各一个。文件组织和模块层级保持一致,顶层单独放,子模块平铺在同一目录,不要按功能再套多层文件夹,层级一深,综合工具报路径问题时很难找。
工程创建时把顶层设为 uart_tx_top,其余四个设为设计源文件。如果工具支持自动识别层级,加完文件让它自己推顶层;不支持的,手动指定,别让工具把某个子模块误当顶层综合,那样端口对不上,报错信息会指向一堆和顶层无关的引脚。
文件加完先做一次语法检查或 elaboration,不要直接跑全流程综合。语法检查阶段就能抓到 3.3 说的 data_out_en 未声明问题,早发现早补,比综合跑完看警告快。elaboration 通过之后,再确认四个子模块都被正确例化、没有黑盒,工具报告里出现"未解析的模块"就说明有文件没加进来。
4.2 综合与实现阶段看什么
综合阶段最该看的不是面积和频率数字,是时钟和复位有没有被正确识别。打开综合后的时序或时钟报告,确认 uart_clko 被识别成一根时钟,而不是普通信号。如果报告里只有系统时钟 clk,没有 uart_clko,说明派生时钟没约束上,这根时钟上的路径全在"未约束"状态,上板后行为不可预测。
约束要补三类。第一类是系统时钟周期,按板子晶振的实际频率填,源是 clk 端口。第二类是 uart_clko 的生成时钟,源指定为系统时钟,分频比按 uart_bps 的实际分频值填,这个值由系统时钟除以目标波特率算出,别拍脑袋写。第三类是输入输出延迟和异步复位,tx_data_in 和 tx_data_in_en 相对 clk 的建立保持关系要按上游逻辑给,系统复位如果来自异步源,要标成异步并做同步处理。
实现阶段重点看复位路径。uart_rsto 是由 uart_clko 采样系统复位产生的,如果工具报告里出现复位信号跨时钟域但没加约束的警告,不要忽略。处理方法是在约束里把系统复位到 uart_rsto 的路径标成异步,并确认 uart_rst 内部确实做了同步。这一条不做,综合能过,上板偶发,最难查。
4.3 上板前的约束与测试
上板前把引脚约束补全:clk 接板载晶振脚,rst 接复位按键或上电复位,o_uart_tx 接USB转串口模块的RX,tx_data_in 和 tx_data_in_en 如果来自板上其他逻辑就按实际连,没有就用一个简单的按键或常量驱动做测试。
测试分两步走。第一步只验节拍:让 uart_bps 单独输出 uart_clko 到一个测试引脚,用示波器或逻辑分析仪量频率,确认分频值和目标波特率对得上。这一步不过,后面全白搭。第二步验帧:给 tx_data_in 一个固定值,拉高 tx_data_in_en 一个节拍,用串口工具在电脑上看收到什么。收到正确字节说明整条链路通;收到乱码先查波特率,收不到先查握手和复位。
上板测试最忌讳一次把所有逻辑都接上再debug。按"节拍—单字节—连续字节"的顺序分三步验,每步过了再进下一步,出问题时范围小,定位快。这套顺序看着笨,实际比一次上全再抓波形省时间得多。
5. 避坑排查:UART发送集成时最容易翻车的五处
5.1 编译与声明类问题
现象一:综合报 data_out_en 未声明,或者只给警告但上板后握手无效。原因是顶层 wire 声明区漏了这一行,例化里却引用了它。不同工具对未声明标识符的处理不一致,有的隐式补一根1位wire,有的直接报错,隐式补的那种最坑,编译过了但连接关系不是你以为的那样。解决是在声明区补 wire data_out_en;,补完再做一次 elaboration,确认例化连接和声明一一对应。
现象二:读代码的人把 o_uart_rxdata_en 当成接收使能,排查方向跑偏。原因是这个信号声明了却没被任何逻辑驱动,是复制粘贴留下的命名残留。它不影响功能,但影响可读性和排查效率。解决方法是在整理阶段用工具的未使用信号报告过一遍,确认无驱动后删除,或者保留但加注释说明它不参与发送。
5.2 时钟与复位类问题
现象三:仿真波形正常,上板后跑一段时间偶发错帧,重启又正常。原因多半是 uart_clko 作为派生时钟没被约束,时序分析工具没分析这根时钟上的路径,实际延时超标但报告不报。解决是在约束里为 uart_clko 建生成时钟,源指定为系统时钟,分频比按实际值填,综合后确认时钟报告里能看到它。
现象四:第一帧数据错位,后面帧正常。原因是 uart_rsto 的释放时刻没有对齐 uart_clko 节拍,应用层和物理层退出复位的时间差了一拍,物理层可能把应用层刚给出的第一个字节当成半个字节收。解决是确认 uart_rst 内部用 uart_clko 打两拍再输出 uart_rsto,并且复位释放落在时钟沿上,不要比时钟先撤。
5.3 上板现象类问题
现象五:串口工具收到的全是乱码,但帧长度对。原因是发送节拍和接收端波特率不匹配,常见于 uart_bps 的分频值按理论算完没考虑时钟容差,或者约束里填的分频比和实际 RTL 不一致。解决是先单独量 uart_clko 的频率,和接收端波特率对一遍,再检查约束里的分频比是不是和 uart_bps 里的分频参数一致,两处不一致是高频错误。
6. 上板之后怎么确认发对了:波形、回环与一份自检表
上板收到正确字节只是第一步,真正让我放心的是能复现地验证。我习惯先看仿真波形里的 o_uart_tx:起始位是不是一个节拍的低电平,8个数据位是不是按 uart_clko 逐位变化,停止位是不是回到高电平。这三段对上了,帧格式就没问题。仿真里给 tx_data_in 换几个值,包括全0和全1,边界值最容易暴露移位逻辑的差一错误。
仿真过了再上板做回环。把 o_uart_tx 接到USB转串口的RX,电脑端发一个已知字节,看收回来的对不对。回环能同时验证节拍、帧格式和握手三件事,比单看波形更接近真实使用。回环不稳的时候,我会把 uart_clko 引到测试脚上用逻辑分析仪抓一段,量实际位宽,和理论值比,差超过半个位宽就是分频或约束的问题。
下面这份自检表是我每次集成UART发送都会过一遍的,按顺序走,基本不会漏。
| 检查项 | 看什么 | 不过怎么办 |
|---|---|---|
| 顶层声明 | data_out_en 等握手信号是否都声明 | 补声明,重新 elaboration |
| 时钟识别 | 综合报告里有没有 uart_clko | 补生成时钟约束 |
| 复位同步 | uart_rsto 是否由 uart_clko 打拍产生 | 检查 uart_rst 内部实现 |
| 节拍频率 | uart_clko 实测频率与目标波特率 | 核对分频参数与约束分频比 |
| 帧格式 | 起始位、8数据位、停止位宽度 | 查物理层移位逻辑 |
| 握手清理 | 发完一帧 data_out_en 是否释放 | 查物理层握手清除逻辑 |
这套流程走顺之后,我落下一个习惯:每次新工程集成串口发送,先把 uart_bps 单独上板量频率,再谈数据。频率不对,后面所有调试都是白费;频率对了,剩下的就是握手和帧格式,范围小得多。踩过的坑告诉我,UART发送不怕逻辑复杂,怕的是一上来就把所有模块接在一起猜。希望帮到你。
