简介本资源是一套面向FPGA开发者的SPI接口ADC配置工程适用于需要通过三线SPI协议对高速模数转换器如HMCAD1511、HMCAD1520、ADS8694系列等进行寄存器初始化与控制的硬件设计场景兼顾初学者理解SPI时序实现与进阶工程师复用核心逻辑的需求。压缩包共176个文件含22个log日志、17个pb综合文件、14个rst重置脚本、12个rpt报告及7个txt说明文档等涵盖从Verilog源码.v、Testbench仿真.v/.svtype、综合/仿真批处理脚本.bat/.sh、约束文件.xdc到调试数据库.wdb/.xsim.dbg的完整开发链路整体大小为29.44MB。已有2283人学习下载提供可直接运行的testbench验证环境、ROM查表驱动机制、SCLK生成与并串转换模块以及多层级仿真脚本elaborate.bat/compile.bat/simulate.bat便于快速上手、时序调试与跨平台移植。1. SPI配置ADC不是“连上线就跑”而是时序、寄存器、采样节奏三者咬合的硬核协同你手头有一颗支持SPI接口的ADC芯片比如ADS8688、MCP3008或AD7928Verilog代码里写了SPI master模块testbench也搭好了——但仿真波形里SCLK歪斜、MOSI数据错位、ADC返回的DRDY信号永远不拉低这不是代码没写完而是SPI配置ADC这件事本质是数字前端与模拟器件之间一次精确到ns级的契约执行SPI协议规定了通信框架ADC数据手册定义了寄存器映射和采样触发条件而Verilog必须把这两者在时钟域、状态机、采样点上严丝合缝地对齐。它不适合纯软件思维的“调API式开发”更适合硬件工程师用always (posedge clk)一拍一拍推演的闭环验证。本文面向已能写基础FSM、熟悉reg/wire语义、正卡在“波形看起来像SPI但ADC不响应”阶段的FPGA/ASIC前端开发者不讲SPI协议ABC只拆解从寄存器写入、采样启动、数据读取到testbench断言验证的完整链路。2. 为什么必须用Verilog而非IP核——SPI-ADC交互中不可绕过的三个硬件敏感点2.1 ADC的SPI模式选择直接决定Verilog状态机设计逻辑并非所有ADC都支持标准SPI四线全双工。以常见12位串行ADC MCP3208为例其SPI模式为Mode 0CPOL0, CPHA0即空闲时SCLK为低电平数据在SCLK上升沿采样而高精度24位ADC ADS1256则要求Mode 1CPOL0, CPHA1数据在SCLK下降沿采样。若Verilog中SPI master的采样沿设置错误哪怕命令字节完全正确ADC也会静默忽略。更关键的是部分ADC如TI的ADS8688需在SPI传输前通过特定引脚如/CS或/CONV触发采样该信号的建立/保持时间tsu/th必须由Verilog精确控制IP核往往无法暴露这些底层时序参数。提示查阅ADC datasheet的Timing Characteristics表格重点关注Serial Interface Timing小节中的tCSSCS setup time、tCSHCS hold time、tDVdata valid after clock edge三项它们将直接转化为Verilog中cs_n信号的驱动延迟和rdy信号的采样窗口。2.2 寄存器配置序列必须按ADC手册逐字节构造不能套用通用SPI模板SPI本身无协议语义ADC厂商自定义寄存器地址与功能。以ADS8688为例配置通道增益需向地址0x01写入0x000A10进制而启动单次转换需向地址0x00写入0x0001。Verilog中若用固定8h01作为地址字节却未考虑ADC要求地址数据共16位连续发送非分两次8位则ADC将误判为两个独立操作。常见错误是把“写配置寄存器”和“发转换命令”混为同一SPI事务而实际ADC可能要求先发配置帧含地址值等待tconv后再发读数据帧地址0x00 dummy byte。2.2.1 构造符合ADC时序的16位SPI帧// 假设adc_reg_write为16位寄存器写操作bit[15:12]为地址bit[11:0]为值 // 注意ADS8688要求MSB first且地址高位在前 always (posedge clk) begin if (rst_n 1b0) begin spi_tx_data 16h0000; end else if (spi_state WRITE_REG tx_cnt 0) begin // 地址0x01对应bit[15:12] 4b0001值0x000A对应bit[11:0] spi_tx_data {4b0001, 12h00A}; // 合成16位帧0x100A end end此代码确保地址与数据在单次SPI传输中连续发出避免因分拆导致ADC解析失败。若ADC要求LSB first如某些MAX116系列则需在赋值前对{4b0001, 12h00A}做位反转。2.3 testbench必须模拟ADC真实响应行为而非仅回传预设值许多初学者testbench仅用initial begin #100 spi_rx_data 12h3FF; end这无法暴露时序问题。真实ADC在收到有效配置后需经内部时钟同步典型1~2个ADC主时钟周期才更新状态寄存器DRDY信号下降沿表示转换完成其宽度受采样率约束如100ksps下DRDY脉宽约5us。Verilog testbench需建模这一延迟// 模拟ADC内部转换延迟假设ADC主频为1MHz转换需10个周期 reg [3:0] adc_conv_delay; always (posedge adc_clk) begin if (adc_start_conv) begin adc_conv_delay 4d10; end else if (adc_conv_delay 0) begin adc_conv_delay adc_conv_delay - 1; end end assign drdy_n (adc_conv_delay 0) ? 1b0 : 1b1; // DRDY低电平有效若testbench忽略此延迟仿真中DRDY立即变低则Verilog读取逻辑会因过早采样而得到无效数据。3. 用Verilog实现SPI-ADC最小可运行系统从状态机到testbench断言3.1 SPI Master核心状态机五态精简设计兼顾时序与可读性采用Moore型状态机明确划分空闲、地址发送、数据发送、等待应答、结束五个阶段。关键在于tx_cnt计数器与spi_clk边沿的严格对齐// 状态定义 localparam IDLE 3b000; localparam ADDR_SEND 3b001; localparam DATA_SEND 3b010; localparam WAIT_RDY 3b011; localparam DONE 3b100; reg [2:0] spi_state; reg [3:0] tx_cnt; // 4-bit计数器覆盖16位传输0~15 always (posedge clk or negedge rst_n) begin if (!rst_n) begin spi_state IDLE; tx_cnt 0; sclk 1b0; mosi 1b0; end else begin case (spi_state) IDLE: begin if (start_spi) begin spi_state ADDR_SEND; tx_cnt 0; sclk 1b0; end end ADDR_SEND: begin // 发送16位地址数据帧 if (tx_cnt 4d0) sclk 1b0; // SCLK低电平起始 if (tx_cnt 4d16) begin if (tx_cnt[0]) begin // 在SCLK上升沿tx_cnt奇数采样MOSI mosi spi_tx_data[15-tx_cnt]; end if (tx_cnt 4d15) begin spi_state WAIT_RDY; tx_cnt 0; end end tx_cnt tx_cnt 1; end WAIT_RDY: begin // 等待ADC DRDY信号 if (!drdy_n) begin // DRDY低电平表示转换完成 spi_state DONE; end end DONE: begin if (done_pulse) begin spi_state IDLE; end end endcase end end此状态机确保每个SCLK周期严格对应一位数据tx_cnt[0]判断奇偶实现上升沿采样避免因计数器溢出导致时序偏移。3.2 ADC寄存器配置与数据读取的Verilog封装将ADC操作抽象为可复用模块隐藏底层SPI细节module adc_spi_ctrl ( input logic clk, input logic rst_n, input logic start_conv, // 外部触发转换 output reg logic [11:0] adc_data, // 12位ADC结果 output reg logic conv_done // 转换完成标志 ); logic [15:0] reg_write_data; // 写寄存器帧 logic [15:0] read_data; // 读数据帧地址0x00 dummy logic spi_done; // 配置ADC设置通道0增益1x禁用内部参考 assign reg_write_data {4b0001, 12h000}; // 地址0x01, 值0x000 // 实例化SPI master spi_master #(.DATA_WIDTH(16)) uut_spi ( .clk(clk), .rst_n(rst_n), .start_spi(start_conv), .spi_tx_data(reg_write_data), .spi_done(spi_done), .sclk(sclk), .mosi(mosi), .miso(miso), .cs_n(cs_n) ); // 状态机控制ADC流程 enum logic [1:0] {IDLE_S, CONFIG, START_CONV, READ_DATA} ctrl_state; always (posedge clk or negedge rst_n) begin if (!rst_n) begin ctrl_state IDLE_S; conv_done 1b0; adc_data 12h000; end else begin case (ctrl_state) IDLE_S: begin if (start_conv) ctrl_state CONFIG; end CONFIG: begin if (spi_done) ctrl_state START_CONV; end START_CONV: begin // 向地址0x00写0x0001启动转换 if (spi_done) ctrl_state READ_DATA; end READ_DATA: begin // 读取地址0x00获取12位数据 if (spi_done) begin adc_data read_data[11:0]; // 假设read_data[11:0]为有效数据 conv_done 1b1; ctrl_state IDLE_S; end end endcase end end endmodule该模块将ADC操作分解为CONFIG→START_CONV→READ_DATA三步每步依赖spi_done信号确保操作严格串行避免并发冲突。3.3 testbench中构建可断言的ADC行为模型testbench需验证三点SPI波形符合Mode 0时序、ADC响应满足手册延迟、读取数据与预期一致// testbench关键断言 initial begin $dumpfile(adc_spi.vcd); $dumpvars(0, tb); // 初始化 clk 1b0; rst_n 1b0; start_conv 1b0; #100 rst_n 1b1; // 触发转换 #100 start_conv 1b1; #10 start_conv 1b0; // 等待转换完成并检查数据 repeat (1000) (posedge clk); if (tb.dut.adc_data ! 12h3FF) begin $display(ERROR: ADC data mismatch! Expected 0x3FF, got %h, tb.dut.adc_data); $finish; end else begin $display(PASS: ADC data correct); end // 验证SCLK频率 real period; period $realtime / 100; // 假设100个周期 if (period 100.0 || period 105.0) begin // 目标10MHz ±5% $display(ERROR: SCLK period out of range: %f ns, period); end end // 监控SPI波形关键点 initial begin $monitor(Time%t, SCLK%b, MOSI%b, CS_N%b, DRDY_N%b, ADC_DATA%h, $time, tb.sclk, tb.mosi, tb.cs_n, tb.drdy_n, tb.dut.adc_data); end$monitor输出实时波形快照$display配合$finish实现失败自动终止便于CI流水线集成。4. SPI-ADC Verilog开发中必须调的3个参数与2个致命坑4.1 三个必调参数从datasheet到代码的精准映射参数名来源ADC datasheetVerilog影响位置典型值与调整逻辑tCSSCS setup timeTiming Characteristics表cs_n信号驱动延迟若手册要求tCSS10ns而FPGA时钟周期为100ns10MHz则需在cs_n拉低后插入至少1个时钟周期延迟否则ADC可能忽略指令tconvconversion timeElectrical Characteristics表wait_rdy状态持续时间ADS8688在100ksps下tconv10us若系统时钟为50MHz则需计数500周期若设为400则导致DRDY未就绪就读取数据无效SCLK max frequencyAbsolute Maximum Ratingsspi_clk分频系数MCP3008最大SCLK为1.8MHz若系统时钟100MHz分频系数至少为56100/56≈1.78MHz设为50则超频ADC可能锁死4.2 两个高频致命坑及规避方案4.2.1 坑跨时钟域采样DRDY信号导致亚稳态丢失中断ADC的DRDY信号由模拟电路产生其边沿与FPGA数字时钟异步。若直接将drdy_n接入状态机可能因亚稳态导致WAIT_RDY状态跳过。解决方案两级触发器同步reg drdy_sync0, drdy_sync1; always (posedge clk) begin drdy_sync0 drdy_n; drdy_sync1 drdy_sync0; end assign drdy_stable drdy_sync1; // 使用drdy_stable替代原始drdy_n同步后drdy_stable在clk域内稳定状态机可安全检测其下降沿。4.2.2 坑testbench中未建模ADC电源上电时序导致初始寄存器值错误多数ADC上电后需等待tPOWER-UP典型10ms才能响应SPI。若testbench在rst_n释放后立即发配置命令ADC仍处于复位状态所有SPI操作被忽略。解决方案在testbench中添加上电延迟initial begin rst_n 1b0; #100 rst_n 1b1; #10_000_000; // 等待10ms假设1ns单位 start_conv 1b1; // 此时ADC已就绪 end该延迟确保ADC内部LDO和基准电压稳定寄存器初始化完成。5. 验证ADC采样精度用testbench生成已知正弦激励并比对FFT结果仅验证SPI通信成功不够需确认ADC前端链路整体精度。testbench可注入可控模拟信号通过Verilog建模ADC量化过程与DUT输出比对// testbench中生成1kHz正弦波12位量化 real t, sine_val; integer i; initial begin for (i 0; i 1000; i i 1) begin t i * 1e-6; // 1us采样间隔 → 1MHz采样率 sine_val 2047.0 * sin(2.0 * 3.1415926 * 1000.0 * t); // 幅度±2047 // 量化为12位有符号整数 tb.dut.simulated_adc_out $rtoi(sine_val) 12hFFF; #1; end end // DUT中接收模拟输入并触发转换 // 此处需在DUT顶层添加analog_in端口并连接至ADC模型随后在仿真后导出adc_data波形为CSV用Python做FFT分析import numpy as np import matplotlib.pyplot as plt data np.loadtxt(adc_out.csv) fft_result np.fft.fft(data) freqs np.fft.fftfreq(len(data), d1e-6) # 1us采样间隔 plt.plot(freqs[:len(freqs)//2], np.abs(fft_result[:len(fft_result)//2])) plt.xlabel(Frequency (Hz)) plt.ylabel(Amplitude) plt.title(ADC Output FFT - Expect peak at 1kHz) plt.show()若FFT图中1kHz处峰值尖锐谐波成分低于-60dB则证明ADC前端链路包括SPI配置、时钟抖动、电源噪声未引入显著失真。此方法将验证从Verilog代码到物理ADC行为的端到端保真度远超单纯波形比对。本文还有配套的精品资源点击获取
