FPGA新手必看：手把手教你用SFP光口实现千兆以太网传输（附XAPP1082实战代码）

FPGA新手必看手把手教你用SFP光口实现千兆以太网传输附XAPP1082实战代码最近有不少刚开始接触FPGA的朋友跟我聊说想搞点高速接口的项目练练手但一看到SFP光口、千兆以太网这些词就有点发怵总觉得是高手才能玩的东西。其实真没那么玄乎我刚开始做的时候也踩过不少坑比如参考时钟死活不对、PHY驱动不起来、设备树配置一头雾水。今天我就把自己从ZC706开发板到自定义硬件平台折腾SFP光口的完整过程掰开揉碎了讲给你听。这篇文章的目标很明确让你能拿着这份指南结合Xilinx的XAPP1082参考设计真正把代码跑起来看到网口灯亮起来测出接近线速的带宽。我们不光讲操作更会解释为什么要这么操作帮你避开那些新手最容易栽进去的坑。1. 项目蓝图理解SFP光口以太网的系统架构在动手写第一行代码之前我们得先搞清楚整个系统是怎么运转的。用FPGA实现SFP光口千兆以太网本质上是在FPGA内部构建一个完整的网络处理子系统。这和你用现成的网卡芯片完全不同你需要自己充当“芯片设计师”的角色。整个数据通路的核心是AXI 1G/2.5G Ethernet Subsystem这个IP核。你可以把它理解为一个高度可配置的“软核网卡”。它内部集成了MAC媒体访问控制层、PCS/PMA物理编码子层/物理介质接入层并直接通过GT吉比特收发器与SFP光模块的电气接口相连。数据从你的应用逻辑比如通过AXI Stream接口进入这个IP核经过封装成以太网帧、编码最终变成高速串行差分信号从GTX/GTH收发器发送出去。注意选择正确的IP核工作模式是第一步。对于SFP光口常见的协议是1000BASE-X和SGMII。1000BASE-X是光纤以太网的标准协议直接通过光模块传输而SGMII通常用于板级芯片间互连。在XAPP1082的例子中我们主要关注1000BASE-X模式。为了让这个“软核网卡”能高效工作还需要几个关键伙伴AXI DMA负责在PS处理器系统的DDR内存和PL可编程逻辑的AXI Ethernet IP之间搬运大量的网络数据包。没有它CPU光靠自己搬数据会累死。AXI Interconnect作为AXI总线的“交通枢纽”管理PS、DMA、Ethernet IP以及其他外设之间的数据通信。处理器系统PS运行LWIP协议栈或Linux网络驱动处理TCP/IP等高层协议并为整个系统提供控制平面。它们之间的关系可以用下面这个简化的表格来理解组件角色关键接口备注AXI 1G/2.5G Ethernet Subsystem数据链路层核心AXI4-Lite (配置), AXI4-Stream (数据), GT Serial (光口)需配置为1000BASE-X模式参考时钟至关重要AXI DMA数据搬运工AXI4 Memory Map, AXI4-Stream连接PS DDR与Ethernet IP的数据通道Zynq PS控制与协议处理AXI Master, EMIO (可选)运行SDK裸机程序或Petaliux系统SFP光模块光电信号转换光纤接口电气接口连接GT需注意模块兼容性波长、距离理解了这张蓝图你就知道我们接下来在Vivado里连线其实就是在用图形化的方式把这些组件按照既定规则连接起来。这比盲目照着教程点鼠标要有底气得多。2. 硬件工程搭建从IP核配置到时钟设计打开Vivado创建新工程选择你的器件型号比如XC7Z045。这一步没什么特别的。关键从创建Block Design开始。首先添加并配置核心IPAXI 1G/2.5G Ethernet Subsystem。在IP Catalog中找到并添加该IP。双击打开配置界面在Basic标签下Physical Interface: 选择1000BASE-X。Interface Type: 选择AXI Streaming。Data Width: 保持32位即可。切换到Shared Logic标签。这里有个重要选择Include Shared Logic in core。通常我们选择包含在IP内部这样Vivado会自动帮我们生成GT收发器所需的时钟和复位逻辑省去很多手动连线的麻烦。但如果你对GT收发器有非常特殊的时钟需求也可以选择外部逻辑。接着Vivado会自动提示你添加AXI DMA IP。接受建议并采用默认配置。一个典型的DMA配置是Width of Buffer Length Register:23Memory Map Data Width:64Stream Data Width:32勾选Enable Scatter Gather以提升效率。然后连接它们。使用Run Connection Automation和Run Block Automation可以快速完成大部分连线。但有几处需要你手动检查或连接时钟域确保AXI Ethernet IP的axis_clk、s_axi_lite_clk以及DMA的s_axi_lite_clk都连接到同一个时钟比如FCLK_CLK0。而gt_ref_clk必须连接到125MHz的参考时钟源。这是整个GT收发器正常工作的基石。复位同样确保相关复位信号连接到正确的复位源。外部端口将AXI Ethernet IP的gt_serial_port(收发差分对) 和sfp相关的状态引脚如sfp_tx_disable引出到顶层端口。gt_serial_port直接连接到FPGA引脚与SFP模块的RX/TX对接。最后也是新手最容易出错的地方参考时钟设计。在XAPP1082的ZC706示例中板载了一个可编程时钟芯片SI570SDK程序在上电时会通过I2C将其配置为125MHz输出。但很多自定义硬件并没有这个芯片而是直接用了一个固定的125MHz晶振连接到FPGA的GT参考时钟专用引脚上。如果你的板子是固定晶振在Vivado中你需要创建一个Clock Wizard IP或使用IBUFDS_GTE2原语将外部差分时钟信号引入并生成一个125MHz的单端时钟连接到gt_ref_clk。最关键的是你必须注释掉或删除SDK示例程序中那个配置SI570的函数调用否则程序会试图操作一个不存在的I2C设备而卡住。如何判断时钟是否正确在硬件上电后你可以用示波器测量连接到GT REFCLK引脚上的时钟频率是否为稳定的125MHz。在Vivado的I/O Planning中也要确保该时钟引脚分配到了支持GT参考时钟的专用Bank。完成连线后你的Block Design应该类似下图示意图然后生成HDL Wrapper进行综合、实现、生成比特流。这个过程可能会遇到时序警告通常与时钟约束有关需要根据你的具体时钟拓扑进行约束。3. 裸机SDK调试让LWIP先跑起来生成比特流后导出硬件到Vivado SDK或Vitis。在SDK里我们先用简单的裸机LWIP程序验证硬件通路是否畅通这比直接上Linux更直接问题也更易定位。创建应用工程File - New - Application Project。选择刚才导出的硬件平台.xsa文件。在模板选择中找到lwip Echo Server或lwIP TCP Perf Server。后者自带带宽测试功能我们优先选它。修改模板代码打开src目录下的main.c。找到init_platform()函数或其附近的代码。ZC706模板里很可能包含类似si570_init()或setup_clocks()的函数。如果你的板子使用固定晶振必须把这两个函数调用注释掉int main() { /* 注释掉配置外部时钟芯片的代码 */ // init_platform(); // 这个函数内部可能调用了时钟配置 // setup_clocks(); // 明确找到并注释掉这个函数 /* 或者更安全地直接替换init_platform */ // 自定义一个不包含时钟初始化的平台初始化 my_simple_platform_init(); print(--- Starting LWIP TCP Perf Server ---\r\n); /* ... 后续LWIP初始化代码 ... */ }配置LWIP参数在lwipopts.h文件中你可以调整LWIP协议栈的参数。对于千兆性能测试可能需要调整TCP发送/接收缓冲区大小TCP_SND_BUF,TCP_WND但初始测试用默认值也可以。连接硬件与测试将比特流下载到FPGA。将编译好的ELF程序下载到PS端运行。通过串口终端观察打印信息。成功的话你会看到服务器IP地址和端口号例如TCP server started on port 5001。找一台电脑用网线连接到一个千兆电口转SFP光口的模块俗称“光猫”或“光纤收发器”另一端用光纤连接你的FPGA板卡SFP模块。在电脑上运行iperf或iperf3进行带宽测试。命令格式如下# 在电脑的命令行中运行假设FPGA板卡IP为192.168.1.10 iperf -c 192.168.1.10 -t 30 -i 5如果一切顺利你应该能看到接近千兆线速约940Mbps的TCP带宽。我第一次成功时测出来大概在850-930 Mbps之间这已经证明了整个硬件链路和数据通路是完好的。如果速度很低比如只有几十Mbps很可能是DMA配置或LWIP缓冲区大小的问题。4. 进阶在Petalinux系统中驱动SFP光口裸机测试通过后我们可以进入更实用的阶段让Linux系统能识别并使用这个SFP网口。这涉及到Linux内核驱动和设备树Device Tree的配置。首先创建一个Petalinux工程并配置内核source petalinux安装路径/settings.sh petalinux-create -t project --template zynq --name sfp_eth_project cd sfp_eth_project petalinux-config --get-hw-description包含.xsa文件的路径进入内核配置菜单petalinux-config -c kernel你需要确保以下驱动被编译进内核或编译为模块Xilinx AXI Ethernet driver(CONFIG_XILINX_AXI_ETHERNET)对应的PHY驱动。对于1000BASE-XPHY是集成在AXI Ethernet IP内部的需要启用CONFIG_XILINX_GMII2RGMII或相关的PCS/PMA驱动。实际上Xilinx的驱动通常通过CONFIG_MDIO_BITBANG和CONFIG_VITESSE_PHY等来支持SFP。最保险的方法是参考XAPP1082的Wiki页面它明确列出了需要开启的配置项。通常你需要启用CONFIG_XILINX_AXI_ETHERNET启用CONFIG_MDIO_BITBANG找到PHY相关的选项确保支持1000base-x模式。其次修改设备树.dts或.dtsi文件。这是将硬件信息告知Linux内核的关键步骤。你需要添加一个描述我们AXI Ethernet IP的节点。位置通常在project-spec/meta-user/recipes-bsp/device-tree/files/system-user.dtsi。一个基础的设备树节点示例如下/ { amba_pl: amba_pl { #address-cells 1; #size-cells 1; compatible simple-bus; ranges; /* 这是你的AXI Ethernet IP在地址空间的映射 */ axi_ethernet_0: ethernet40000000 { compatible xlnx,axi-ethernet-1.00.a; reg 0x40000000 0x40000; /* 起始地址和范围需与Vivado中一致 */ interrupts 0 29 4; /* SPI中断号需与硬件一致 */ interrupt-parent intc; phy-mode 1000base-x; /* 关键指定PHY模式 */ xlnx,phy-type 0x5; /* 对应1000BASE-X */ local-mac-address [00 0a 35 00 01 22]; /* 设置一个MAC地址 */ /* PHY处理对于集成PHY可能这样指定 */ phy-handle phy0; mdio { #address-cells 1; #size-cells 0; phy0: phy0 { compatible vitesse,vsc8574, ethernet-phy-ieee802.3-c22; reg 0; }; }; }; }; };提示reg和interrupts参数必须严格对应你在Vivado中分配给AXI Ethernet IP的地址和中断号。local-mac-address可以自定义但需保证局域网内唯一。最后编译并启动petalinux-build petalinux-package --boot --fsbl --fpga --u-boot将生成的BOOT.BIN和image.ub拷贝到SD卡启动板卡。在Linux启动日志中通过串口查看你应该能看到类似xilinx_axienet 40000000.ethernet: Link is Up - 1Gbps/Full的消息。使用ifconfig或ip addr命令就能看到新的网络接口比如eth0或eth1并可以配置IP地址进行网络通信了。走到这一步你已经完成了一个从硬件逻辑设计、底层驱动到上层系统应用的完整SFP光口以太网项目。这个过程里最深的体会就是时钟和设备树是两大“拦路虎”但只要理解了原理耐心对照硬件设计去调试就一定能打通。下次你可以尝试在此基础上实现更复杂的网络功能比如硬件加速的包过滤、自定义网络协议栈那才是FPGA玩高速接口的真正魅力所在。