FPGA实战：用AXI3和AXI4协议打通Zynq PS和PL的通信（附代码避坑）

FPGA实战AXI3与AXI4协议在Zynq PS-PL通信中的工程化应用在Xilinx Zynq系列SoC的开发中处理器系统(PS)与可编程逻辑(PL)之间的高效数据交互是系统设计的核心挑战。AXI(Advanced eXtensible Interface)协议作为ARM AMBA标准的重要组成部分为这种异构计算架构提供了理想的通信桥梁。本文将从一个图像处理加速器的实际案例出发深入解析AXI3与AXI4协议的选择策略、信号配置要点以及开发过程中常见的坑点与解决方案。1. 协议选择与架构设计Zynq平台支持AXI3、AXI4和AXI4-Lite三种协议变体选择不当会导致性能瓶颈或资源浪费。我们的图像处理加速器案例中PS需要向PL发送配置参数控制寄存器和图像数据大数据量传输这正对应了两种典型的AXI应用场景。协议选型决策矩阵应用场景数据特征推荐协议理由控制寄存器访问小数据量、随机访问AXI4-Lite简化协议节省逻辑资源适合寄存器映射式控制图像数据传输大数据块、顺序访问AXI4支持突发长度256(比AXI3的16更长)更高带宽利用率支持乱序传输(ID标记)在Vivado中创建AXI IP核时接口类型选择直接影响后续的系统性能。我们采用混合接口策略控制接口AXI4-Lite32位数据宽度用于参数配置和状态查询数据接口AXI464位数据宽度支持突发传输用于图像数据搬运# 示例Vivado中创建AXI接口的Tcl命令 create_ip -name axi_dma -vendor xilinx.com -library ip -version 7.1 -module_name axi_dma_0 set_property -dict [list \ CONFIG.c_include_mm2s {1} \ CONFIG.c_include_s2mm {1} \ CONFIG.c_sg_length_width {16} \ CONFIG.c_mm2s_burst_size {256} \ CONFIG.c_s2mm_burst_size {256} \ ] [get_ips axi_dma_0]2. 关键信号配置与优化AXI协议的灵活性带来了配置复杂性特别是在通道信号设置上需要格外注意。以下是我们在多个项目中总结出的信号配置经验。2.1 地址通道信号精要AW/ARLEN配置陷阱AXI3的突发长度字段为4位(最大16次传输)AXI4扩展为8位(最大256次传输)实际项目中曾遇到一个性能问题当配置AXI4接口但误用AXI3的突发长度设置时DMA传输效率只有预期的1/16。解决方法是在IP核包装器中明确定义协议版本// 正确声明AXI4接口的Verilog示例 module axi4_master #( parameter C_M_AXI_PROTOCOL AXI4 )( // 接口信号... ); generate if (C_M_AXI_PROTOCOL AXI4) begin assign awlen 8d255; // 最大突发长度 end else begin assign awlen 4d15; // AXI3的最大突发长度 end endgenerate endmoduleAxCACHE配置实战缓存属性直接影响系统性能和一致性特别是在多主设备系统中。推荐配置应用场景AxCACHE值含义设备寄存器访问4b0000Non-cacheable, Non-bufferable视频帧缓冲区4b1111Cacheable, Bufferable共享内存区域4b0011Non-cacheable, Bufferable注意PS与PL共享的存储区域必须配置为Non-cacheable否则会导致数据一致性问题。我们曾在一个视频处理项目中遇到因缓存配置不当导致的图像撕裂问题耗时两周才定位到这个隐蔽问题。2.2 数据通道信号实战WSTRB的字节对齐陷阱在32位总线传输24位RGB图像数据时需要正确处理字节使能信号。错误示例// 错误的内存拷贝方式忽略字节对齐 memcpy(axi_buffer, rgb_data, width*height*3);正确做法应显式设置WSTRB// 正确的字节使能处理 for(int i0; iwidth*height; i) { axi_buffer[i].data (rgb_data[3*i2]16) | (rgb_data[3*i1]8) | rgb_data[3*i]; axi_buffer[i].strb 0x07; // 仅低3字节有效 }WLAST信号缺失的灾难在早期项目中我们曾因忘记在DMA传输结束时置位WLAST信号导致PS端一直等待传输完成而系统死锁。现在采用以下检查清单避免此类问题突发传输计数器达到AWLEN值时必须置位WLAST单次传输时WLAST应与WVALID同时置位仿真时必须验证WLAST的时序符合协议要求3. 握手机制与性能优化AXI协议的VALID/READY握手机制虽然简单但实际应用中存在诸多时序陷阱。我们开发了一套验证方法来确保握手信号的正确性。3.1 握手时序检查表VALID不依赖READY规则发送方不能等待接收方的READY信号才置位VALID。这会导致死锁。正确做法// 正确VALID仅基于发送方状态 always (posedge ACLK) begin if (ARESETn 1b0) begin AWVALID 1b0; end else if (~AWVALID || (AWVALID AWREADY)) begin AWVALID next_transfer_ready; end endREADY信号灵活置位策略接收方可以提前置位READY性能优先检测到VALID后置位READY资源优先跨时钟域处理PS(100MHz)与PL(150MHz)时钟不同源时必须添加异步FIFO# Vivado中添加AXI跨时钟域IP create_ip -name axi_clock_converter -vendor xilinx.com -library ip -version 2.1 \ -module_name axi_clock_conv set_property -dict [list \ CONFIG.ADDR_WIDTH {32} \ CONFIG.DATA_WIDTH {64} \ CONFIG.ID_WIDTH {4} \ ] [get_ips axi_clock_conv]3.2 性能优化技巧通过AXI协议分析仪捕获的实际传输波形显示以下优化可提升吞吐量30%以上流水线深度优化在IP集成器中合理设置接口的读写接受容量参数推荐值说明Read Acceptance Cap8预取8个读地址Write Acceptance Cap4缓冲4个写地址Outstanding Reads16支持16个未完成读事务突发传输重组将多个小突发合并为单个大突发减少地址通道开销// 优化前多次小突发 for(int i0; i16; i) { dma_transfer(addri*64, 64); // 每次64字节 } // 优化后单次大突发 dma_transfer(addr, 1024); // 单次1024字节数据宽度匹配PS端64位总线与PL端128位总线交互时使用AXI Data Width Converter IP避免带宽浪费create_ip -name axi_dwidth_converter -vendor xilinx.com -library ip \ -version 2.1 -module_name axi_width_conv set_property -dict [list \ CONFIG.SI_DATA_WIDTH.VALUE_SRC USER \ CONFIG.SI_DATA_WIDTH {64} \ CONFIG.MI_DATA_WIDTH {128} \ ] [get_ips axi_width_conv]4. 调试技巧与常见问题AXI协议问题往往表现为数据损坏、系统挂死等难以定位的现象。我们总结了一套有效的调试方法。4.1 系统级调试工具链Vivado ILA抓取AXI总线信号的标准方法# 示例插入ILA核 create_debug_core u_ila_0 ila set_property port_width 1 [get_debug_ports u_ila_0/clk] connect_debug_port u_ila_0/clk [get_nets ACLK] set_property port_width 1 [get_debug_ports u_ila_0/probe0] connect_debug_port u_ila_0/probe0 [get_nets AWVALID]Xilinx AXI Protocol Checker自动检测协议违规VALID信号持续为高但无READY响应突发长度超过协议限制WLAST信号缺失自定义断言检查在RTL中添加协议检查代码// 检查WLAST在突发结束时置位 assert property ( (posedge ACLK) disable iff (ARESETn 1b0) (AWVALID AWREADY) |- ##[1:16] (WVALID WREADY WLAST) ) else $error(WLAST not asserted at burst end);4.2 典型问题解决方案问题1数据丢失现象PS写入PL的数据部分丢失原因WSTRB信号未正确配置PL端忽略部分字节解决在Vivado IP配置中启用所有字节通道set_property CONFIG.C_HAS_WSTRB {1} [get_bd_cells axi_data_fifo]问题2系统死锁现象DMA传输中途挂起原因AXI Interconnect中未完成事务数超过设计容量解决调整Interconnect的仲裁参数参数推荐值说明NUM_READ_OUTSTANDING16最大未完成读事务数NUM_WRITE_OUTSTANDING16最大未完成写事务数MAX_BURST_LENGTH256支持AXI4最大突发问题3性能波动现象相同数据传输时间差异达30%原因AXI Interconnect采用默认轮询仲裁解决启用QoS优先级设置set_property CONFIG.AR_QOS {15} [get_bd_cells axi_vdma] set_property CONFIG.AW_QOS {12} [get_bd_cells axi_vdma]在完成一个基于AXI4的4K视频处理系统后我们发现合理配置QoS优先级可以使最坏情况下的帧传输时间从33ms降低到25ms这对于60fps的实时系统至关重要。这个优化点通常被大多数开发者忽视却往往能带来意想不到的性能提升。