1. 为什么需要PL端串口扩展很多工程师第一次接触ZYNQ时都会遇到一个尴尬的问题PS端自带的两个UART接口根本不够用。在实际项目中我们经常需要连接多个传感器、显示屏或调试终端这时候就需要在PL端扩展串口。我去年做过一个工业控制项目需要同时连接4个Modbus RTU设备PS端的两个串口完全不够分配。这时候在PL端用AXI UART16550 IP核扩展串口就成了最佳选择。这个IP核不仅兼容标准16550串口控制器还支持中断驱动实测波特率可以达到3Mbps完全满足工业场景需求。2. Vivado硬件工程搭建2.1 创建基础工程首先新建一个ZYNQ7020工程其他ZYNQ型号也适用在Block Design中添加ZYNQ7 Processing System核。这里有个小技巧建议先双击ZYNQ核进入配置界面在PS-PL Configuration中勾选Fabric Resets和Interrupts下的PL-PS中断选项这样后续添加中断时会更方便。接着添加AXI UART16550 IP核这个核在Xilinx官方IP库里就能找到。我在多个项目中发现这个IP核的FIFO深度设置很有讲究对于低速串口115200bps以下16字节FIFO足够对于高速通信1Mbps以上建议设置为64或128字节2.2 关键连接配置完成IP核添加后需要特别注意几个关键连接将UART核的AXI接口连接到ZYNQ的GP接口通常是M_AXI_GP0将UART核的中断输出连接到ZYNQ的IRQ_F2P[0:0]将UART核的串口信号引出到顶层注意TX/RX交叉连接这里有个我踩过的坑如果发现中断无法触发请检查Vivado是否自动生成了concat IP。有时候需要手动添加一个Concat核将多个中断信号合并后再接入ZYNQ。2.3 引脚约束与生成完成连接后建议先运行Validate Design检查连接关系。确认无误后在约束文件中添加如下典型配置set_property PACKAGE_PIN Y18 [get_ports uart_tx] set_property IOSTANDARD LVCMOS33 [get_ports uart_tx] set_property PACKAGE_PIN AA18 [get_ports uart_rx] set_property IOSTANDARD LVCMOS33 [get_ports uart_rx]最后生成Bitstream时建议勾选-bin_file选项这样会同时生成.bin文件方便后续通过SD卡更新固件。3. SDK软件工程开发3.1 创建基础工程导出硬件到SDK后新建一个空白应用工程。这里推荐使用BSP模板它会自动包含UART驱动库。我习惯先测试基础收发功能再添加中断处理这样排查问题更有条理。在BSP设置中需要确认已启用xuartns550驱动中断控制器设置为ScuGicZYNQ的标准配置编译器优化等级建议先设为-O0方便调试3.2 中断服务程序实现Xilinx提供了标准的中断示例但实际使用时需要做以下关键修改在xparameters.h中确认中断ID定义正确#define UART_IRPT_INTR XPAR_FABRIC_AXI_UART16550_0_IP2INTC_IRPT_INTR中断初始化代码需要包含以下关键步骤// 初始化中断控制器 XScuGic_Config *IntcConfig XScuGic_LookupConfig(INTC_DEVICE_ID); XScuGic_CfgInitialize(IntcInstance, IntcConfig, IntcConfig-CpuBaseAddress); // 设置中断优先级和触发类型 XScuGic_SetPriorityTriggerType(IntcInstance, UART_IRPT_INTR, 0xA0, 0x3); // 连接中断处理函数 XScuGic_Connect(IntcInstance, UART_IRPT_INTR, (Xil_ExceptionHandler)XUartNs550_InterruptHandler, UartInstance); // 启用中断 XScuGic_Enable(IntcInstance, UART_IRPT_INTR);中断处理函数建议按这个模板编写void UartIntrHandler(void *CallBackRef, u32 Event, unsigned int EventData) { static u8 buffer[64]; if (Event XUN_EVENT_RECV_DATA) { int count XUartNs550_Recv(UartInstance, buffer, sizeof(buffer)); // 处理接收到的数据 for(int i0; icount; i){ xil_printf(Recv: 0x%02X\r\n, buffer[i]); } } }3.3 调试技巧调试中断驱动时我总结了几条实用经验先用示波器确认硬件线路正常在中断入口处添加调试打印确认中断是否触发检查中断屏蔽寄存器(IER)设置是否正确使用XUartNs550_GetInterruptMask()读取当前中断状态如果遇到数据丢失问题可以尝试增大FIFO深度提高中断优先级在中断服务程序中尽快读取数据4. 性能优化实战4.1 中断响应时间测试通过GPIO翻转逻辑分析仪测量在150MHz CPU频率下从中断触发到进入ISR的平均延迟约为1.2us。这个时间主要消耗在中断控制器响应时间约0.4us上下文保存约0.3us跳转到ISR约0.5us对于波特率115200的串口每个字节间隔86us这个延迟完全可接受。但在3Mbps时每个字节间隔3.3us就需要考虑DMA方案了。4.2 缓冲区设计为了避免数据丢失我设计了一个双缓冲机制#define BUF_SIZE 256 typedef struct { u8 buffer1[BUF_SIZE]; u8 buffer2[BUF_SIZE]; u8 *active_buf; volatile int write_idx; } DoubleBuffer; void IntrHandler(void *CallBackRef, u32 Event, unsigned int EventData) { DoubleBuffer *dbuf (DoubleBuffer *)CallBackRef; if(Event XUN_EVENT_RECV_DATA) { int avail XUartNs550_Recv(UartInstance, dbuf-active_buf dbuf-write_idx, BUF_SIZE - dbuf-write_idx); dbuf-write_idx avail; if(dbuf-write_idx BUF_SIZE/2) { // 切换缓冲区 ProcessBuffer(dbuf-active_buf, dbuf-write_idx); dbuf-active_buf (dbuf-active_buf dbuf-buffer1) ? dbuf-buffer2 : dbuf-buffer1; dbuf-write_idx 0; } } }4.3 实际项目经验在一个智能电表项目中我们需要同时处理4个串口数据。通过以下优化实现了稳定运行为每个串口分配独立的中断优先级使用RTOS的任务通知机制唤醒处理线程在Vivado中为每个UART核分配独立的中断线避免共享中断线关键配置参数如下表参数推荐值说明中断优先级0xA0-0xC0高于系统任务FIFO深度64字节平衡延迟和资源接收超时4字符时间避免数据滞留波特率容差3%保证稳定性5. 常见问题解决5.1 中断不触发这是新手最常见的问题可按以下步骤排查确认Vivado中中断线已正确连接检查SDK中的中断ID是否与硬件设计一致验证中断控制器是否已正确初始化用XUartNs550_GetInterruptStatus()读取中断状态寄存器5.2 数据丢失遇到数据丢失时建议降低波特率测试增大FIFO深度检查中断服务程序是否耗时过长使用逻辑分析仪捕获实际波形5.3 性能瓶颈当需要更高性能时可以考虑使用AXI DMA串口方案在PL端实现数据预处理改用更高端的ZYNQ UltraScale系列我在一个高速数据采集项目中通过将UART IP核时钟提升到100MHz配合DMA传输实现了5Mbps的稳定传输。关键是在Vivado中正确设置时钟域交叉Clock Domain Crossing参数。6. 进阶应用6.1 与Linux驱动集成如果需要移植到Linux系统需要注意在设备树中添加UART节点配置正确的时钟频率实现中断资源映射典型设备树配置示例axi_uart16550_0: serial43c00000 { compatible xlnx,xps-uart16550-2.00.a; reg 0x43c00000 0x10000; interrupts 0 29 4; clock-frequency 100000000; current-speed 115200; };6.2 多串口管理管理多个PL串口时我推荐采用面向对象的设计模式typedef struct { XUartNs550 instance; DoubleBuffer buffer; u32 baudrate; } UartDevice; void Uart_Init(UartDevice *dev, u16 dev_id, u16 intr_id) { XUartNs550_Initialize(dev-instance, dev_id); XUartNs550_SetHandler(dev-instance, IntrHandler, dev); // ...其他初始化 } void Uart_Send(UartDevice *dev, const u8 *data, size_t len) { XUartNs550_Send(dev-instance, data, len); }这种设计在需要管理4个以上串口时特别有用代码可维护性大大提高。
1. 为什么需要PL端串口扩展很多工程师第一次接触ZYNQ时都会遇到一个尴尬的问题PS端自带的两个UART接口根本不够用。在实际项目中我们经常需要连接多个传感器、显示屏或调试终端这时候就需要在PL端扩展串口。我去年做过一个工业控制项目需要同时连接4个Modbus RTU设备PS端的两个串口完全不够分配。这时候在PL端用AXI UART16550 IP核扩展串口就成了最佳选择。这个IP核不仅兼容标准16550串口控制器还支持中断驱动实测波特率可以达到3Mbps完全满足工业场景需求。2. Vivado硬件工程搭建2.1 创建基础工程首先新建一个ZYNQ7020工程其他ZYNQ型号也适用在Block Design中添加ZYNQ7 Processing System核。这里有个小技巧建议先双击ZYNQ核进入配置界面在PS-PL Configuration中勾选Fabric Resets和Interrupts下的PL-PS中断选项这样后续添加中断时会更方便。接着添加AXI UART16550 IP核这个核在Xilinx官方IP库里就能找到。我在多个项目中发现这个IP核的FIFO深度设置很有讲究对于低速串口115200bps以下16字节FIFO足够对于高速通信1Mbps以上建议设置为64或128字节2.2 关键连接配置完成IP核添加后需要特别注意几个关键连接将UART核的AXI接口连接到ZYNQ的GP接口通常是M_AXI_GP0将UART核的中断输出连接到ZYNQ的IRQ_F2P[0:0]将UART核的串口信号引出到顶层注意TX/RX交叉连接这里有个我踩过的坑如果发现中断无法触发请检查Vivado是否自动生成了concat IP。有时候需要手动添加一个Concat核将多个中断信号合并后再接入ZYNQ。2.3 引脚约束与生成完成连接后建议先运行Validate Design检查连接关系。确认无误后在约束文件中添加如下典型配置set_property PACKAGE_PIN Y18 [get_ports uart_tx] set_property IOSTANDARD LVCMOS33 [get_ports uart_tx] set_property PACKAGE_PIN AA18 [get_ports uart_rx] set_property IOSTANDARD LVCMOS33 [get_ports uart_rx]最后生成Bitstream时建议勾选-bin_file选项这样会同时生成.bin文件方便后续通过SD卡更新固件。3. SDK软件工程开发3.1 创建基础工程导出硬件到SDK后新建一个空白应用工程。这里推荐使用BSP模板它会自动包含UART驱动库。我习惯先测试基础收发功能再添加中断处理这样排查问题更有条理。在BSP设置中需要确认已启用xuartns550驱动中断控制器设置为ScuGicZYNQ的标准配置编译器优化等级建议先设为-O0方便调试3.2 中断服务程序实现Xilinx提供了标准的中断示例但实际使用时需要做以下关键修改在xparameters.h中确认中断ID定义正确#define UART_IRPT_INTR XPAR_FABRIC_AXI_UART16550_0_IP2INTC_IRPT_INTR中断初始化代码需要包含以下关键步骤// 初始化中断控制器 XScuGic_Config *IntcConfig XScuGic_LookupConfig(INTC_DEVICE_ID); XScuGic_CfgInitialize(IntcInstance, IntcConfig, IntcConfig-CpuBaseAddress); // 设置中断优先级和触发类型 XScuGic_SetPriorityTriggerType(IntcInstance, UART_IRPT_INTR, 0xA0, 0x3); // 连接中断处理函数 XScuGic_Connect(IntcInstance, UART_IRPT_INTR, (Xil_ExceptionHandler)XUartNs550_InterruptHandler, UartInstance); // 启用中断 XScuGic_Enable(IntcInstance, UART_IRPT_INTR);中断处理函数建议按这个模板编写void UartIntrHandler(void *CallBackRef, u32 Event, unsigned int EventData) { static u8 buffer[64]; if (Event XUN_EVENT_RECV_DATA) { int count XUartNs550_Recv(UartInstance, buffer, sizeof(buffer)); // 处理接收到的数据 for(int i0; icount; i){ xil_printf(Recv: 0x%02X\r\n, buffer[i]); } } }3.3 调试技巧调试中断驱动时我总结了几条实用经验先用示波器确认硬件线路正常在中断入口处添加调试打印确认中断是否触发检查中断屏蔽寄存器(IER)设置是否正确使用XUartNs550_GetInterruptMask()读取当前中断状态如果遇到数据丢失问题可以尝试增大FIFO深度提高中断优先级在中断服务程序中尽快读取数据4. 性能优化实战4.1 中断响应时间测试通过GPIO翻转逻辑分析仪测量在150MHz CPU频率下从中断触发到进入ISR的平均延迟约为1.2us。这个时间主要消耗在中断控制器响应时间约0.4us上下文保存约0.3us跳转到ISR约0.5us对于波特率115200的串口每个字节间隔86us这个延迟完全可接受。但在3Mbps时每个字节间隔3.3us就需要考虑DMA方案了。4.2 缓冲区设计为了避免数据丢失我设计了一个双缓冲机制#define BUF_SIZE 256 typedef struct { u8 buffer1[BUF_SIZE]; u8 buffer2[BUF_SIZE]; u8 *active_buf; volatile int write_idx; } DoubleBuffer; void IntrHandler(void *CallBackRef, u32 Event, unsigned int EventData) { DoubleBuffer *dbuf (DoubleBuffer *)CallBackRef; if(Event XUN_EVENT_RECV_DATA) { int avail XUartNs550_Recv(UartInstance, dbuf-active_buf dbuf-write_idx, BUF_SIZE - dbuf-write_idx); dbuf-write_idx avail; if(dbuf-write_idx BUF_SIZE/2) { // 切换缓冲区 ProcessBuffer(dbuf-active_buf, dbuf-write_idx); dbuf-active_buf (dbuf-active_buf dbuf-buffer1) ? dbuf-buffer2 : dbuf-buffer1; dbuf-write_idx 0; } } }4.3 实际项目经验在一个智能电表项目中我们需要同时处理4个串口数据。通过以下优化实现了稳定运行为每个串口分配独立的中断优先级使用RTOS的任务通知机制唤醒处理线程在Vivado中为每个UART核分配独立的中断线避免共享中断线关键配置参数如下表参数推荐值说明中断优先级0xA0-0xC0高于系统任务FIFO深度64字节平衡延迟和资源接收超时4字符时间避免数据滞留波特率容差3%保证稳定性5. 常见问题解决5.1 中断不触发这是新手最常见的问题可按以下步骤排查确认Vivado中中断线已正确连接检查SDK中的中断ID是否与硬件设计一致验证中断控制器是否已正确初始化用XUartNs550_GetInterruptStatus()读取中断状态寄存器5.2 数据丢失遇到数据丢失时建议降低波特率测试增大FIFO深度检查中断服务程序是否耗时过长使用逻辑分析仪捕获实际波形5.3 性能瓶颈当需要更高性能时可以考虑使用AXI DMA串口方案在PL端实现数据预处理改用更高端的ZYNQ UltraScale系列我在一个高速数据采集项目中通过将UART IP核时钟提升到100MHz配合DMA传输实现了5Mbps的稳定传输。关键是在Vivado中正确设置时钟域交叉Clock Domain Crossing参数。6. 进阶应用6.1 与Linux驱动集成如果需要移植到Linux系统需要注意在设备树中添加UART节点配置正确的时钟频率实现中断资源映射典型设备树配置示例axi_uart16550_0: serial43c00000 { compatible xlnx,xps-uart16550-2.00.a; reg 0x43c00000 0x10000; interrupts 0 29 4; clock-frequency 100000000; current-speed 115200; };6.2 多串口管理管理多个PL串口时我推荐采用面向对象的设计模式typedef struct { XUartNs550 instance; DoubleBuffer buffer; u32 baudrate; } UartDevice; void Uart_Init(UartDevice *dev, u16 dev_id, u16 intr_id) { XUartNs550_Initialize(dev-instance, dev_id); XUartNs550_SetHandler(dev-instance, IntrHandler, dev); // ...其他初始化 } void Uart_Send(UartDevice *dev, const u8 *data, size_t len) { XUartNs550_Send(dev-instance, data, len); }这种设计在需要管理4个以上串口时特别有用代码可维护性大大提高。
