W5500硬件TCP/IP协议栈驱动开发详解

1. W5500以太网控制器驱动技术深度解析W5500是由WIZnet公司推出的硬件TCP/IP嵌入式以太网控制器其核心价值在于将完整的TCP/IP协议栈包括MAC、PHY、IPv4、ICMP、ARP、UDP、TCP、PPPoE等固化于芯片内部通过SPI接口与MCU通信彻底剥离了软件协议栈的移植负担和资源开销。该器件不依赖外部RAM或Flash存储协议代码所有网络状态机、Socket缓冲区、重传逻辑均在片上SRAM中自主运行MCU仅需通过寄存器读写和Socket命令操作即可完成网络通信。这种“硬件协议栈”架构使其在资源受限的MCU平台如Cortex-M0/M3/M4、8051、AVR、PIC等上具备极高的实时性、确定性和低功耗特性广泛应用于工业PLC、智能电表、楼宇自控、远程IO模块及物联网边缘节点等对网络可靠性要求严苛的场景。1.1 硬件架构与关键特性W5500采用单芯片集成方案内部结构高度模块化主要包含以下功能单元物理层PHY内置10/100Mbps自适应以太网PHY支持全双工/半双工模式集成MDI/MDIX自动翻转兼容标准RJ45接口无需外接变压器即可直连网络需配合符合IEEE 802.3标准的磁性元件媒体访问控制MAC实现CSMA/CD机制、帧校验FCS、地址过滤、流量控制等功能支持单播/广播/多播帧收发硬件TCP/IP协议栈完全由硬件逻辑实现包含IPv4协议处理地址解析、分片重组、TTL管理ICMP协议Ping应答、错误报告ARP协议IP-MAC地址映射支持静态/动态条目UDP协议无连接数据报传输支持广播/多播TCP协议面向连接支持超时重传、滑动窗口、拥塞控制、Nagle算法可选PPPoE协议用于ADSL拨号接入8 Socket并行处理引擎每个Socket独立配置协议类型TCP Client/Server、UDP、MAC Raw、IP Raw、本地端口、目标IP/端口、中断使能、超时时间等参数各Socket拥有独立的发送/接收缓冲区共64KB SRAM可按需分配最小单位为2KBSPI主从接口支持Mode 0/3CPOL0/1, CPHA0最高时钟频率80MHz典型应用推荐20–40MHz支持全双工DMA式数据传输中断系统提供单一IRQ引脚通过读取IRInterrupt Register和Sn_IRSocket Interrupt Register寄存器识别中断源如Socket连接建立、数据到达、断开完成、超时等支持电平触发与边沿触发配置低功耗模式支持Power Down模式电流10μA可通过WAKEUP引脚或SPI唤醒。其关键性能参数如下表所示参数规格网络速率10/100 Mbps 自适应最大Socket数8并发总缓冲区容量64 KB SRAM可配置分配SPI时钟频率最高80 MHzDC特性保证工作电压3.3 V ±10%I/O兼容5V工作温度-40°C ~ 85°C工业级封装形式48-pin LQFP该架构的本质优势在于网络协议状态机完全脱离MCU CPU周期MCU无需参与任何协议解析、校验、重传、超时判断等耗时操作仅承担“指令下发”与“数据搬运”两类任务。这使得即使在主频仅48MHz的Cortex-M0 MCU上也能稳定维持8个TCP连接并实现毫秒级响应。1.2 寄存器映射与内存模型W5500的寄存器空间分为三类公共寄存器Common Registers、Socket寄存器Socket n Registers和缓冲区TX/RX Buffer全部通过SPI地址映射访问。其内存模型为线性地址空间起始地址0x0000最大寻址范围0xFFFF64KB但实际有效区域远小于此。公共寄存器0x0000–0x00FF位于地址空间起始段用于全局配置与状态监控。关键寄存器如下地址寄存器名功能说明典型配置值0x0000MR(Mode Register)复位、环回、PPPoe使能、WOL使能0x80复位后清零0x0001GAR(Gateway IP Address)默认网关IP4字节192.168.1.1→0xC0,0xA8,0x01,0x010x0005SUBR(Subnet Mask)子网掩码4字节255.255.255.0→0xFF,0xFF,0xFF,0x000x0009SHAR(Source Hardware Address)MAC地址6字节0x00,0x08,0xDC,0x12,0x34,0x560x000FSIPR(Source IP Address)本机IP4字节192.168.1.100→0xC0,0xA8,0x01,0x640x0013INTLEVEL中断低电平持续时间ms0x02002ms0x0015IR(Interrupt Register)全局中断标志读清零BIT(0)CONFLICT,BIT(1)UNREACH,BIT(2)PPPCONNECT,BIT(3)PPPDISCONNECT,BIT(4)SOCK0, ...,BIT(11)SOCK70x0017IMR(Interrupt Mask Register)中断屏蔽位0x000F默认屏蔽Socket0–3中断0x001CPHYCFGRPHY配置与状态速度、双工、Link状态0x7800100M全双工Link Up0x0020VERSIONR芯片版本号只读0x04W5500 v1.0工程要点MR寄存器第7位RST为硬复位位写0x80将触发内部复位复位完成后需重新初始化所有寄存器PHYCFGR第15位LINK反映物理链路状态必须在初始化后轮询确认为1方可进行网络操作。Socket寄存器0x0100–0x01FF per Socket每个Socketn0~7拥有独立的寄存器组起始地址为0x0100 n*0x0100。核心寄存器包括地址偏移寄存器名功能说明典型值TCP Server0x0000Sn_MR(Mode)Socket协议模式0x02TCP Server0x0002Sn_CR(Command)Socket命令寄存器写触发0x01OPEN→0x02LISTEN0x0003Sn_IR(Interrupt)Socket中断标志读清零BIT(0)RECV,BIT(1)SEND_OK,BIT(2)TIMEOUT,BIT(3)DISCON,BIT(4)ESTABLISH,BIT(5)CLOSE_WAIT0x0004Sn_SR(Status)Socket当前状态0x13SOCK_ESTABLISHED0x0006Sn_PORT本地端口号2字节0x01BB4430x0008Sn_DHAR目标MAC地址6字节TCP Client用—0x000ESn_DIPR目标IP地址4字节TCP Client/UDP用—0x0010Sn_DPORT目标端口号2字节TCP Client/UDP用—0x0012Sn_MSSR最大分段大小2字节0x05B414600x0014Sn_PROTOIP协议号IP Raw用—0x0016Sn_TOS服务类型TOS0x000x0017Sn_TTL生存时间TTL0x801280x0018Sn_RXBUF_SIZE接收缓冲区大小KB0x022KB0x0019Sn_TXBUF_SIZE发送缓冲区大小KB0x022KB0x001ASn_TX_FSR发送空闲空间2字节只读0x08002KB0x001CSn_RX_RSR接收待读数据量2字节只读0x0100256B关键机制Sn_CR是命令触发寄存器向其写入特定值如0x01OPEN、0x02LISTEN、0x04CONNECT、0x10CLOSE将启动对应状态机写操作本身即为指令无需等待返回Sn_SR状态寄存器需轮询或通过中断Sn_IR获取变化Sn_TX_FSR和Sn_RX_RSR是驱动数据吞吐的核心依据任何发送前必须确保Sn_TX_FSR data_len任何接收前必须确认Sn_RX_RSR 0。缓冲区地址映射0x0200–0xFFFFTX/RX缓冲区起始于0x0200具体布局由Sn_TXBUF_SIZE和Sn_RXBUF_SIZE决定。以Socket0为例若配置为2KB TX 2KB RX则TX Buffer:0x0200–0x09FF2KBRX Buffer:0x0A00–0x11FF2KB数据读写通过SPI的地址自动递增模式完成向指定起始地址写入多个字节W5500内部地址指针自动1避免MCU频繁计算地址。这是实现高效数据搬运的关键。2. 驱动设计原理与核心API实现W5500驱动的本质是SPI总线控制器与硬件协议栈寄存器的精确协同。驱动层需严格遵循“配置→命令→轮询/中断→数据搬运”的四步流程任何步骤的时序或状态误判都将导致连接失败或数据丢失。2.1 底层SPI接口抽象驱动首先需封装SPI底层操作确保满足W5500时序要求tSPS ≥ 10ns, tSUD ≥ 10ns。典型HAL实现如下以STM32 HAL库为例// w5500_spi.h typedef struct { SPI_HandleTypeDef *hspi; GPIO_TypeDef *cs_port; uint16_t cs_pin; } w5500_spi_t; // w5500_spi.c static void w5500_cs_select(w5500_spi_t *spi) { HAL_GPIO_WritePin(spi-cs_port, spi-cs_pin, GPIO_PIN_RESET); } static void w5500_cs_deselect(w5500_spi_t *spi) { HAL_GPIO_WritePin(spi-cs_port, spi-cs_pin, GPIO_PIN_SET); } // 单字节读写地址数据 static uint8_t w5500_spi_read_byte(w5500_spi_t *spi, uint16_t addr) { uint8_t tx_buf[3], rx_buf[3]; tx_buf[0] 0x00; // Read command (00) tx_buf[1] (addr 8) 0xFF; // Address MSB tx_buf[2] addr 0xFF; // Address LSB HAL_SPI_TransmitReceive(spi-hspi, tx_buf, rx_buf, 3, HAL_MAX_DELAY); return rx_buf[2]; // Data byte at index 2 } static void w5500_spi_write_byte(w5500_spi_t *spi, uint16_t addr, uint8_t data) { uint8_t tx_buf[4]; tx_buf[0] 0x04; // Write command (01) tx_buf[1] (addr 8) 0xFF; tx_buf[2] addr 0xFF; tx_buf[3] data; HAL_SPI_Transmit(spi-hspi, tx_buf, 4, HAL_MAX_DELAY); } // 多字节读写用于寄存器块或缓冲区 static void w5500_spi_read_buffer(w5500_spi_t *spi, uint16_t addr, uint8_t *buf, uint16_t len) { uint8_t tx_header[3]; tx_header[0] 0x00; tx_header[1] (addr 8) 0xFF; tx_header[2] addr 0xFF; w5500_cs_select(spi); HAL_SPI_Transmit(spi-hspi, tx_header, 3, HAL_MAX_DELAY); HAL_SPI_Receive(spi-hspi, buf, len, HAL_MAX_DELAY); w5500_cs_deselect(spi); } static void w5500_spi_write_buffer(w5500_spi_t *spi, uint16_t addr, uint8_t *buf, uint16_t len) { uint8_t tx_header[3]; tx_header[0] 0x04; tx_header[1] (addr 8) 0xFF; tx_header[2] addr 0xFF; w5500_cs_select(spi); HAL_SPI_Transmit(spi-hspi, tx_header, 3, HAL_MAX_DELAY); HAL_SPI_Transmit(spi-hspi, buf, len, HAL_MAX_DELAY); w5500_cs_deselect(spi); }工程要点w5500_spi_read_buffer和w5500_spi_write_buffer必须使用连续SPI事务CS保持低电平否则地址指针不会自动递增导致数据错位。HAL库的HAL_SPI_TransmitReceive无法直接用于多字节读因首3字节为指令后续为纯数据故需拆分为TransmitReceive两步并确保CS不释放。2.2 寄存器读写封装基于SPI接口构建寄存器级操作函数// w5500_reg.h #define W5500_BASE_ADDR 0x0000 #define W5500_SOCK_BASE(n) (0x0100 (n)*0x0100) // w5500_reg.c uint8_t w5500_read_common_reg(w5500_spi_t *spi, uint16_t reg) { return w5500_spi_read_byte(spi, W5500_BASE_ADDR reg); } void w5500_write_common_reg(w5500_spi_t *spi, uint16_t reg, uint8_t val) { w5500_spi_write_byte(spi, W5500_BASE_ADDR reg, val); } uint8_t w5500_read_socket_reg(w5500_spi_t *spi, uint8_t sock, uint16_t reg) { return w5500_spi_read_byte(spi, W5500_SOCK_BASE(sock) reg); } void w5500_write_socket_reg(w5500_spi_t *spi, uint8_t sock, uint16_t reg, uint8_t val) { w5500_spi_write_byte(spi, W5500_SOCK_BASE(sock) reg, val); } // 批量读写如MAC、IP地址 void w5500_read_common_block(w5500_spi_t *spi, uint16_t reg, uint8_t *buf, uint16_t len) { w5500_spi_read_buffer(spi, W5500_BASE_ADDR reg, buf, len); } void w5500_write_common_block(w5500_spi_t *spi, uint16_t reg, uint8_t *buf, uint16_t len) { w5500_spi_write_buffer(spi, W5500_BASE_ADDR reg, buf, len); }2.3 Socket状态机驱动API核心API围绕Socket生命周期展开严格遵循W5500状态转换图RFC 793// w5500_socket.h typedef enum { SOCK_CLOSED 0x00, SOCK_INIT 0x13, SOCK_LISTEN 0x14, SOCK_ESTABLISHED 0x17, SOCK_CLOSE_WAIT 0x1C, SOCK_UDP 0x22, SOCK_IPRAW 0x24, SOCK_MACRAW 0x26 } w5500_sock_state_t; typedef enum { W5500_PROTO_TCP 0x01, W5500_PROTO_UDP 0x02, W5500_PROTO_IPRAW 0x03, W5500_PROTO_MACRAW 0x04 } w5500_proto_t; // w5500_socket.c w5500_sock_state_t w5500_get_socket_state(w5500_spi_t *spi, uint8_t sock) { return (w5500_sock_state_t)w5500_read_socket_reg(spi, sock, 0x0004); // Sn_SR } // 初始化Socket设置协议、端口、缓冲区大小 bool w5500_socket_init(w5500_spi_t *spi, uint8_t sock, w5500_proto_t proto, uint16_t port, uint8_t tx_size_kb, uint8_t rx_size_kb) { // 1. 设置协议模式 uint8_t mr_val 0; switch(proto) { case W5500_PROTO_TCP: mr_val 0x01; break; // TCP Client case W5500_PROTO_UDP: mr_val 0x02; break; // UDP case W5500_PROTO_IPRAW: mr_val 0x03; break; case W5500_PROTO_MACRAW: mr_val 0x04; break; } w5500_write_socket_reg(spi, sock, 0x0000, mr_val); // Sn_MR // 2. 设置端口 w5500_write_socket_reg(spi, sock, 0x0006, (port 8) 0xFF); w5500_write_socket_reg(spi, sock, 0x0007, port 0xFF); // 3. 设置缓冲区大小必须在OPEN前 w5500_write_socket_reg(spi, sock, 0x0018, rx_size_kb); w5500_write_socket_reg(spi, sock, 0x0019, tx_size_kb); // 4. 发送OPEN命令 w5500_write_socket_reg(spi, sock, 0x0002, 0x01); // Sn_CR OPEN // 5. 等待状态变为INIT for(uint32_t i 0; i 10000; i) { if(w5500_get_socket_state(spi, sock) SOCK_INIT) return true; HAL_Delay(1); } return false; } // TCP Server监听 bool w5500_socket_listen(w5500_spi_t *spi, uint8_t sock) { w5500_write_socket_reg(spi, sock, 0x0002, 0x02); // Sn_CR LISTEN for(uint32_t i 0; i 10000; i) { if(w5500_get_socket_state(spi, sock) SOCK_LISTEN) return true; HAL_Delay(1); } return false; } // TCP Client连接 bool w5500_socket_connect(w5500_spi_t *spi, uint8_t sock, const uint8_t *ip, uint16_t port) { // 设置目标IP w5500_write_common_block(spi, 0x000E, (uint8_t*)ip, 4); // Sn_DIPR // 设置目标端口 w5500_write_socket_reg(spi, sock, 0x0010, (port 8) 0xFF); w5500_write_socket_reg(spi, sock, 0x0011, port 0xFF); // 发送CONNECT命令 w5500_write_socket_reg(spi, sock, 0x0002, 0x04); // Sn_CR CONNECT for(uint32_t i 0; i 10000; i) { w5500_sock_state_t state w5500_get_socket_state(spi, sock); if(state SOCK_ESTABLISHED || state SOCK_CLOSE_WAIT) return true; HAL_Delay(1); } return false; } // 关闭Socket void w5500_socket_close(w5500_spi_t *spi, uint8_t sock) { w5500_write_socket_reg(spi, sock, 0x0002, 0x10); // Sn_CR CLOSE }关键设计w5500_socket_init中缓冲区大小配置Sn_RXBUF_SIZE/Sn_TXBUF_SIZE必须在OPEN命令前完成否则无效w5500_socket_connect需同时检查SOCK_ESTABLISHED成功和SOCK_CLOSE_WAIT对方主动关闭因W5500在连接失败时可能进入后者。2.4 数据收发核心API数据搬运是驱动性能瓶颈所在必须高效利用缓冲区状态寄存器// w5500_data.c // 获取Socket TX空闲空间字节 uint16_t w5500_get_tx_freespace(w5500_spi_t *spi, uint8_t sock) { uint16_t val ((uint16_t)w5500_read_socket_reg(spi, sock, 0x001A) 8) | w5500_read_socket_reg(spi, sock, 0x001B); return val; } // 获取Socket RX待读数据量字节 uint16_t w5500_get_rx_recvsize(w5500_spi_t *spi, uint8_t sock) { uint16_t val ((uint16_t)w5500_read_socket_reg(spi, sock, 0x001C) 8) | w5500_read_socket_reg(spi, sock, 0x001D); return val; } // 发送数据阻塞式直到全部发出 int16_t w5500_socket_send(w5500_spi_t *spi, uint8_t sock, const uint8_t *buf, uint16_t len) { uint16_t freespace w5500_get_tx_freespace(spi, sock); if(len freespace) return -1; // 缓冲区不足 // 计算TX Buffer起始地址固定偏移 uint16_t tx_start_addr 0x0200 (sock * 0x0800); // 每Socket 2KB TX buffer w5500_spi_write_buffer(spi, tx_start_addr, (uint8_t*)buf, len); // 发送SEND命令 w5500_write_socket_reg(spi, sock, 0x0002, 0x20); // Sn_CR SEND // 等待SEND_OK中断或轮询Sn_IR uint32_t timeout 10000; while(timeout--) { uint8_t ir w5500_read_socket_reg(spi, sock, 0x0003); if(ir 0x10) { // BIT(4) SEND_OK w5500_write_socket_reg(spi, sock, 0x0003, 0x10); // 清中断 return len; } HAL_Delay(1); } return -2; // 超时 } // 接收数据非阻塞返回实际读取字节数 int16_t w5500_socket_recv(w5500_spi_t *spi, uint8_t sock, uint8_t *buf, uint16_t max_len) { uint16_t recv_size w5500_get_rx_recvsize(spi, sock); if(recv_size 0) return 0; uint16_t read_len (recv_size max_len) ? recv_size : max_len; // 计算RX Buffer起始地址 uint16_t rx_start_addr 0x0A00 (sock * 0x0800); // 每Socket 2KB RX buffer w5500_spi_read_buffer(spi, rx_start_addr, buf, read_len); // 发送RECV命令告知W5500已读取 w5500_write_socket_reg(spi, sock, 0x0002, 0x40); // Sn_CR RECV return read_len; }性能关键w5500_socket_send中w5500_get_tx_freespace必须在每次发送前调用因W5500在发送过程中会动态更新Sn_TX_FSRw5500_socket_recv必须在读取数据后立即发送RECV命令否则W5500不会释放RX缓冲区空间导致后续数据被丢弃。3. 典型应用场景与工程实践3.1 TCP ServerModbus TCP从站在工业现场W5500常作为Modbus TCP从站响应主站读写请求。其优势在于协议解析由硬件完成MCU仅需处理应用层逻辑// Modbus TCP从站主循环FreeRTOS Task void modbus_task(void *pvParameters) { w5500_spi_t spi {...}; uint8_t sock 0; uint8_t rx_buf[256], tx_buf[256]; // 初始化W5500 w5500_init(spi); // 配置IP、MAC w5500_set_ip(spi, 192.168.1.100, 255.255.255.0, 192.168.1.1); w5500_set_mac(spi, \x00\x08\xDC\x12\x34\x56); // 初始化Socket0为TCP Server端口502 if(!w5500_socket_init(spi, sock, W5500_PROTO_TCP, 502, 2, 2)) { Error_Handler(); } if(!w5500_socket_listen(spi, sock)) { Error_Handler(); } while(1) { // 检查是否有新连接状态变为SOCK_ESTABLISHED if(w5500_get_socket_state(spi, sock) SOCK_ESTABLISHED) { // 处理Modbus请求 int16_t recv_len w5500_socket_recv(spi, sock, rx_buf, sizeof(rx_buf)); if(recv_len 0) { // 解析Modbus TCP ADU跳过7字节头 uint8_t *mb_pdu rx_buf 7; uint8_t func_code mb_pdu[0]; uint16_t resp_len modbus_handle_request(mb_pdu, tx_buf 7); if(resp_len 0) { // 构造响应头事务ID、协议ID、长度、单元ID memcpy(tx_buf, rx_buf, 6); // 复制事务ID和协议ID tx_buf[6] (resp_len 1) 8; // 长度MSB tx_buf[7] (resp_len 1) 0xFF; // 长度LSB tx_buf[8] rx_buf[6]; // 单元ID w5500_socket_send(spi, sock, tx_buf, 9 resp_len); } } } vTaskDelay(1); } }3.2 UDP数据上报传感器采集对于低延迟、高频率的传感器数据上报UDP模式可规避TCP握手开销// UDP上报任务 void udp_report_task(void *pvParameters) { w5500_spi_t spi {...}; uint8_t sock 1; uint8_t tx_buf[128]; uint8_t server_ip[4] {192, 168, 1, 200}; w5500_init(spi); w5500_socket_init(spi, sock, W5500_PROTO_UDP, 0, 2, 2); // 端口0表示随机 while(1) { // 采集传感器数据 float temp read_temperature(); float humi read_humidity(); // 构造UDP payload自定义二进制格式 uint16_t *p (uint16_t*)tx_buf; *p __builtin_bswap16((uint16_t)(temp * 10)); // 温度×10 *p __builtin_bswap16((uint16_t)(humi * 10)); // 湿度×10 uint16_t payload_len 4; // 发送UDP包到服务器 w5500_udp_sendto(spi, sock, server_ip, 8080, tx_buf, payload_len); vTaskDelay(2000); // 每2秒上报一次 } } // UDP专用发送函数需先设置目标地址 void w5500_udp_sendto(w5500_spi_t *spi, uint8_t sock, const uint8_t *ip, uint16_t port, const uint8_t *buf, uint16_t len) { // 设置目标IP和端口 w5500_write_common_block(spi, 0x000E, (uint8_t*)ip, 4); // Sn_DIPR w5500_write_socket_reg(spi, sock, 0x0010, (port 8) 0xFF); w5500_write_socket_reg(spi, sock, 0x0011, port 0xFF); // 写入数据到TX Buffer uint16_t tx_start 0x0200 (sock * 0x0800); w5500_spi_write_buffer(spi, tx_start, (uint8_t*)buf, len); // 发送UDP_SEND命令 w5500_write_socket_reg(spi, sock, 0x0002, 0x21); // Sn_CR UDP_SEND }3.3 中断驱动优化降低CPU占用在资源紧张的系统中轮询Sn_IR会浪费大量CPU周期。启用中断可显著提升效率// EXTI中断服务程序W5500 IRQ引脚连接到PA0 void EXTI0_IRQHandler(void) { HAL_GPIO_EXTI_IRQHandler(GPIO_PIN_0); } void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin) { if(GPIO_Pin