简介本资源是基于STM32F407与W5500以太网控制器协同开发的嵌入式网络通信完整例程包面向嵌入式初学者、物联网开发工程师及高校课程实践者解决ARM Cortex-M4平台下轻量级TCP/IP协议栈集成与网络控制落地难题。压缩包共185个文件含51个头文件.h定义寄存器与接口50个C源码.c实现SPI驱动、W5500初始化、TCP服务器/客户端逻辑及中断事件处理另有.o/.d/.axf/.hex等编译产物及Keil工程文件.uvprojx/.uvoptx完整覆盖从代码编写、调试到固件烧录全流程包体大小为4.39MB。已有617人学习下载内容源自官方适配思路并经实测验证包含多socket并发管理、MAC/IP配置、ARP/TCP/UDP协议调用等核心实现预览可见tcp_server.axf及stm32f4xx系列外设驱动文件适合用于网络功能模块开发参考、课程实验复现或IoT终端联网方案快速原型搭建。1. STM32F407 W5500 实现稳定以太网 TCP Server 控制不是“烧录即用”而是要过三关硬件时序对齐、W5500 寄存器初始化顺序、Keil 工程中中断与 socket 状态机协同你手上有块 STM32F407 开发板焊好了 W5500 以太网模块解压出F407W5500官网例程.rar_new35x_pourfzj_w5500_w5500例程 407_网络 控制这类命名混乱但内含关键逻辑的压缩包——别急着导入 Keil。这类“官网例程”往往跳过最致命的细节W5500 的 SPI 通信必须严格满足 tSHSL ≥ 10ns、tVSL ≥ 15ns 的保持时间而 F407 的 SPI1 在 42MHz APB2 下若未配置为 2 分频低电平空闲高位先发SPI 写入 W5500 的 SNIRSocket n Interrupt Register会始终读回 0x00导致 TCP_Server 状态机卡死在SOCK_ESTABLISHED之外。这不是代码 bug是硬件握手失败。本篇不讲“如何点亮 LED”只聚焦真实产线级调试场景用 Keil MDK-ARM v5.36适配stm32f4xx_dfp.2.13.0.pack构建可复位、可断连重试、支持多客户端轮询的 TCP_Server覆盖从原理图引脚核对W5500 的 /CS、/RESET、INT 引脚是否接对 F407 的 GPIOE.3/GPIOE.2/EXTI2、到wizchip_init()中ctlwizchip(CW_INIT_WIZCHIP, (void*)0)返回 -1 的定位方法、再到 Keil 调试时HAL_SPI_TransmitReceive_IT()卡在HAL_SPI_STATE_BUSY_TX_RX的根因排查。适合已能用 ST-Link 烧录 F407、但首次接入 W5500 模块的嵌入式工程师。2. W5500 与 STM32F407 的硬件协同设计从原理图验证到 SPI 时序强制校准W5500 不是即插即用的“黑盒”其数据手册明确要求SPI 时钟相位CPHA必须为 0采样在第一个边沿极性CPOL必须为 0空闲低电平且 SCLK 频率上限为 80MHz但实际推荐 ≤ 20MHz 以留足建立/保持余量。F407 的 SPI1 挂在 APB2 总线上默认最大频率 84MHz若直接配置为 42MHz 分频SPI 波形将违反 W5500 的 tSU数据建立时间≥ 10ns 要求。必须通过寄存器级配置强制降频并校验波形。2.1 原理图级引脚确认W5500 应用电路的三个致命检查点W5500 的典型应用电路包含 3 组关键信号任何一处错接都会导致初始化失败信号名W5500 引脚推荐 F407 引脚必查事项/CSPIN 33GPIOE.3 (SPI1_NSS)必须配置为推挽输出初始化前拉高W5500 手册强调 /CS 下降沿触发内部寄存器锁存若接错为 GPIOA.4 等非 NSS 功能引脚wiz_write_buf()将写入无效地址/RESETPIN 32GPIOE.2 (推挽输出)上电后需保持 ≥ 10ms 低电平再拉高若接至 F407 的 NRST 引脚复位芯片则 W5500 无法独立复位ctlwizchip(CW_RESET_WIZCHIP, (void*)0)永远超时INTPIN 31GPIOE.1 (EXTI1)必须配置为下降沿触发外部中断若误接为 GPIOB.0无 EXTI 功能则getsockopt()无法感知连接事件TCP_Server 无法响应新客户端提示使用万用表通断档实测 PCB 走线而非仅依赖原理图标注。常见错误是 W5500 的 /CS 接至 F407 的 PA4非 NSS 功能此时即使 Keil 工程编译通过wiz_read_buf()读取VERSIONR寄存器地址 0x0039永远返回 0x00因为片选未生效。2.2 SPI1 寄存器级配置绕过 HAL 库默认值强制满足 W5500 时序HAL 库的MX_SPI1_Init()默认配置SPI_BAUDRATEPRESCALER_2APB2 频率 /2在 F407 84MHz 系统下产生 42MHz SCLK超出 W5500 安全范围。必须手动修改 SPI1 的SPI_CR1寄存器启用 4 分频// 在 MX_SPI1_Init() 函数末尾添加非替换原有 HAL_SPI_Init __HAL_SPI_DISABLE(hspi1); // 先关闭 SPI hspi1.Instance-CR1 ~SPI_CR1_BR; // 清除原分频位 hspi1.Instance-CR1 | SPI_CR1_BR_1 | SPI_CR1_BR_0; // 设置 BR[1:0] 11 → 分频系数 884MHz/810.5MHz __HAL_SPI_ENABLE(hspi1); // 重新使能此配置将 SCLK 降至 10.5MHz确保 tCYCLE95.2ns tSHSL(10ns) tVSL(15ns) tSU(10ns) 35ns 的最小总和。用示波器抓取 PB3(SCK) 和 PB5(MOSI) 波形确认 SCK 高电平宽度 ≥ 45ns即半周期 ≥ 47.6ns否则需进一步加大分频。2.3 W5500 初始化状态机wizchip_init()失败的三层诊断法wizchip_init()返回 -1 是高频问题按以下顺序逐层验证2.3.1 物理层连通性验证用wiz_read_buf()直读芯片 IDuint8_t ver_reg[2]; wiz_read_buf(0x0039, ver_reg, 2); // VERSIONR 寄存器地址 printf(W5500 VER: 0x%02X%02X\r\n, ver_reg[0], ver_reg[1]); // 正常应输出 W5500 VER: 0x04010x0401 表示 W5500 V1.0若输出0x0000说明 /CS 或 SPI 时序失效若输出0xFFFF说明 /RESET 未正确释放用示波器测 GPIOE.2 电平确认上电后 15ms 内由低变高。2.3.2 寄存器映射验证检查WIZNET_INFO结构体绑定W5500 驱动库要求WIZNET_INFO中的tx_size和rx_size必须与实际分配的内存一致#define TXBUF_SIZE 2048 #define RXBUF_SIZE 2048 uint8_t g_txbuf[TXBUF_SIZE]; uint8_t g_rxbuf[RXBUF_SIZE]; WIZNET_INFO wiznet_info { .tx_buf g_txbuf, .rx_buf g_rxbuf, .tx_size TXBUF_SIZE, .rx_size RXBUF_SIZE }; // 若 tx_size 设为 1024 但实际分配 2048wiz_write_buf() 会越界写入 SRAM2.3.3 中断向量表校准EXTI1 中断服务函数必须注册到正确位置W5500 的 INT 引脚触发 EXTI1其 ISR 必须为EXTI1_IRQHandler且需在stm32f4xx_it.c中显式启用void EXTI1_IRQHandler(void) { HAL_GPIO_EXTI_IRQHandler(GPIO_PIN_1); // GPIOE.1 对应 PIN_1 } // 并在 MX_GPIO_Init() 后调用 HAL_NVIC_EnableIRQ(EXTI1_IRQn); // 若误写为 EXTI0_IRQHandler则中断永不触发socket 状态无法更新3. Keil 工程中 TCP_Server 的状态机实现从 socket 创建到客户端轮询控制W5500 的 TCP_Server 不是简单调用socket()listen()其核心在于Sn_SRSocket n Status Register的轮询与Sn_IRSocket n Interrupt Register的清零时机。Keil 工程中若未处理Sn_IR的写 1 清零机制会导致中断持续触发CPU 占用率 100%。3.1 Socket 初始化四步法规避 W5500 的 8 个 socket 通道竞争W5500 仅提供 8 个 socket0~7每个 socket 独立工作。TCP_Server 必须独占一个 socket如 socket 0且需按严格顺序操作int sock 0; uint8_t destip[4] {0,0,0,0}; // 0.0.0.0 表示监听所有 IP uint16_t destport 5000; // Step 1: 关闭 socket清除可能残留状态 close(sock); // Step 2: 设置协议类型为 TCP setSn_PROTO(sock, Sn_PROTO_TCP); // Step 3: 绑定本地端口W5500 不支持 bind()直接设 Sn_PORT setSn_PORT(sock, destport); // Step 4: 启动监听触发 Sn_SR 进入 SOCK_LISTEN listen(sock);注意setSn_PORT()必须在listen()之前调用否则 W5500 内部状态机无法进入SOCK_LISTEN。若顺序颠倒getSn_SR(sock)将始终返回SOCK_CLOSED。3.2 主循环状态机基于 Sn_SR 的非阻塞轮询Keil 调试时若使用while(1)死循环必须避免recv()阻塞。W5500 的recv()是查询式需先读Sn_RX_RSR接收缓存大小再读数据while (1) { uint8_t status getSn_SR(sock); if (status SOCK_LISTEN) { // 检查是否有新连接请求 if (getSn_IR(sock) Sn_IR_CON) { setSn_IR(sock, Sn_IR_CON); // 写 1 清零 CON 中断标志 printf(New connection accepted\r\n); } } else if (status SOCK_ESTABLISHED) { uint16_t rx_len getSn_RX_RSR(sock); // 获取待接收字节数 if (rx_len 0) { uint8_t rx_buf[64]; int ret recv(sock, rx_buf, MIN(rx_len, 64)); if (ret 0) { // 解析控制指令如 LED_ON - GPIO_WriteBit(GPIOC, GPIO_Pin_13, Bit_SET) parse_control_command(rx_buf, ret); // 回复确认 send(sock, (uint8_t*)ACK, 3); } } } else if (status SOCK_CLOSE_WAIT) { // 客户端发起关闭需主动发送 FIN disconnect(sock); close(sock); printf(Connection closed\r\n); } HAL_Delay(1); // 防止 CPU 占用率过高 }3.3 Keil 调试关键设置解决HAL_SPI_TransmitReceive_IT()卡死问题当使用中断模式 SPI 时HAL_SPI_TransmitReceive_IT()卡在HAL_SPI_STATE_BUSY_TX_RX根源在于 W5500 的 /CS 信号未在 SPI 传输完成前及时拉高。必须在HAL_SPI_TxRxCpltCallback()中强制操作 /CSvoid HAL_SPI_TxRxCpltCallback(SPI_HandleTypeDef *hspi) { if (hspi-Instance SPI1) { HAL_GPIO_WritePin(GPIOE, GPIO_PIN_3, GPIO_PIN_SET); // 手动拉高 /CS // 此处可添加 wizchip_isr() 处理中断 } }同时在 Keil 的Options for Target → Debug → Settings → SWD中勾选Reset and Run确保每次下载后 F407 全局复位避免 W5500 寄存器残留状态干扰。4. W5500 TCP_Server 的抗干扰加固断连重试、内存泄漏防护与 Keil 生成 BIN 文件部署工业现场中网线插拔、交换机重启会导致 TCP 连接异常中断。裸写的recv()会因Sn_SR滞留在SOCK_ESTABLISHED而无法检测断连。必须引入心跳包与超时机制并确保 Keil 生成的 BIN 文件可直接烧录至 Flash 指定地址。4.1 断连检测与自动重试基于 Sn_SSR 的 Keep-Alive 实现W5500 的Sn_SSRSocket n Source Port Register在连接断开时不会自动变化需主动发送心跳包并检测响应static uint32_t last_heartbeat 0; #define HEARTBEAT_INTERVAL 30000 // 30秒 if (HAL_GetTick() - last_heartbeat HEARTBEAT_INTERVAL) { last_heartbeat HAL_GetTick(); // 发送单字节心跳0xFF int sent send(sock, (uint8_t*)\xFF, 1); if (sent 0) { // 发送失败判定连接断开 printf(Heartbeat failed, closing socket\r\n); disconnect(sock); close(sock); // 重置 socket 等待新连接 listen(sock); } }4.2 内存泄漏防护W5500 接收缓冲区的严格管理W5500 的Sn_RX_RSR返回的是硬件 FIFO 中的字节数recv()调用后该值不会自动清零需通过Sn_RX_RD接收读指针和Sn_RX_WR接收写指针计算实际已读字节数。若忽略此细节多次recv()后Sn_RX_RSR会溢出导致后续接收失败// 正确做法recv() 后手动更新 Sn_RX_RD int ret recv(sock, rx_buf, len); if (ret 0) { // 更新读指针Sn_RX_RD ret uint16_t rd_ptr getSn_RX_RD(sock); setSn_RX_RD(sock, rd_ptr ret); }4.3 Keil 生成 BIN 文件并烧录至 Flash 指定位置产线部署需将程序烧录至 Flash 的固定地址如 0x08004000而非默认的 0x08000000。在 Keil 中配置Options for Target → Target → IROM1起始地址改为0x08004000大小设为0x000FB000避开系统启动区Options for Target → Output → Create HEX File取消勾选勾选Create Binary File编译后Keil 生成ProjectName.bin使用 ST-Link Utility 烧录# 命令行烧录需安装 ST-Link driver ST-LINK_CLI.exe -c SWD -p ProjectName.bin 0x08004000此 BIN 文件不含 ELF 头信息直接映射到 Flash 地址避免 Keil 默认生成的 AXF 文件需额外解析。5. W5500 与 STM32F407 协同调试的终极技巧用 Keil Logic Analyzer 抓取 INT 信号与 socket 状态跃变Keil uVision5 内置的 Logic Analyzer 是调试 W5500 中断响应的利器无需外接示波器即可关联硬件信号与软件状态。关键在于将 GPIOE.1INT 引脚和Sn_SR寄存器值同步采样。5.1 配置 Keil Logic Analyzer 抓取 INT 电平与 Sn_SR 变化在 Keil 中打开View → Analysis Windows → Logic Analyzer添加信号点击Add→ 输入GPIOE_IDR输入数据寄存器→ 展开后勾选BIT1对应 GPIOE.1添加寄存器点击Add→ 输入0x10000000W5500 的 Sn_SR 地址socket 0 为0x10000000设置采样深度为10000触发条件设为GPIOE_IDR.BIT1 0下降沿运行程序后Logic Analyzer 将显示当 PC 端telnet 192.168.1.100 5000连接时GPIOE.1 出现一次下降沿脉冲紧随其后0x10000000地址的值从0x13SOCK_INIT跃变为0x14SOCK_LISTEN再变为0x17SOCK_ESTABLISHED。若脉冲后Sn_SR无变化则证明EXTI1_IRQHandler未执行或wizchip_isr()未被调用。5.2 利用 Keil Memory Browser 实时监控 W5500 寄存器W5500 的寄存器映射在0x10000000开始的 1MB 空间可在 Keil 调试时直接查看View → Memory BrowserAddress 栏输入0x10000000socket 0 的 Sn_SR右键选择Unsigned 32-bit显示格式当Sn_SR值卡在0x13不变时立即检查0x10000002Sn_PORT是否为0x13885000 的十六进制若为0x0000说明setSn_PORT()调用失败根源在 SPI 写入时序错误。5.3 Keil 编译警告的精准解读warning: #177-D: variable was declared but never referenced此类警告常出现在wizchip_init()中声明的uint8_t memsize[2]未被使用。W5500 驱动库要求该数组用于ctlwizchip(CW_GET_MAX_HEAP_SIZE, (void*)memsize)但若跳过此调用Keil 会报此警告。不要删除该变量而应补全调用uint8_t memsize[2]; ctlwizchip(CW_GET_MAX_HEAP_SIZE, (void*)memsize); printf(Max heap: %d KB\r\n, (memsize[0]8)|memsize[1]); // 输出 16KB该值决定了 W5500 内部 TX/RX 缓冲区的最大分配空间影响并发连接数。忽略此步骤将导致socket()分配失败Sn_SR始终为SOCK_CLOSED。本文还有配套的精品资源点击获取
STM32F407+W5500以太网TCP Server实战调试指南
简介本资源是基于STM32F407与W5500以太网控制器协同开发的嵌入式网络通信完整例程包面向嵌入式初学者、物联网开发工程师及高校课程实践者解决ARM Cortex-M4平台下轻量级TCP/IP协议栈集成与网络控制落地难题。压缩包共185个文件含51个头文件.h定义寄存器与接口50个C源码.c实现SPI驱动、W5500初始化、TCP服务器/客户端逻辑及中断事件处理另有.o/.d/.axf/.hex等编译产物及Keil工程文件.uvprojx/.uvoptx完整覆盖从代码编写、调试到固件烧录全流程包体大小为4.39MB。已有617人学习下载内容源自官方适配思路并经实测验证包含多socket并发管理、MAC/IP配置、ARP/TCP/UDP协议调用等核心实现预览可见tcp_server.axf及stm32f4xx系列外设驱动文件适合用于网络功能模块开发参考、课程实验复现或IoT终端联网方案快速原型搭建。1. STM32F407 W5500 实现稳定以太网 TCP Server 控制不是“烧录即用”而是要过三关硬件时序对齐、W5500 寄存器初始化顺序、Keil 工程中中断与 socket 状态机协同你手上有块 STM32F407 开发板焊好了 W5500 以太网模块解压出F407W5500官网例程.rar_new35x_pourfzj_w5500_w5500例程 407_网络 控制这类命名混乱但内含关键逻辑的压缩包——别急着导入 Keil。这类“官网例程”往往跳过最致命的细节W5500 的 SPI 通信必须严格满足 tSHSL ≥ 10ns、tVSL ≥ 15ns 的保持时间而 F407 的 SPI1 在 42MHz APB2 下若未配置为 2 分频低电平空闲高位先发SPI 写入 W5500 的 SNIRSocket n Interrupt Register会始终读回 0x00导致 TCP_Server 状态机卡死在SOCK_ESTABLISHED之外。这不是代码 bug是硬件握手失败。本篇不讲“如何点亮 LED”只聚焦真实产线级调试场景用 Keil MDK-ARM v5.36适配stm32f4xx_dfp.2.13.0.pack构建可复位、可断连重试、支持多客户端轮询的 TCP_Server覆盖从原理图引脚核对W5500 的 /CS、/RESET、INT 引脚是否接对 F407 的 GPIOE.3/GPIOE.2/EXTI2、到wizchip_init()中ctlwizchip(CW_INIT_WIZCHIP, (void*)0)返回 -1 的定位方法、再到 Keil 调试时HAL_SPI_TransmitReceive_IT()卡在HAL_SPI_STATE_BUSY_TX_RX的根因排查。适合已能用 ST-Link 烧录 F407、但首次接入 W5500 模块的嵌入式工程师。2. W5500 与 STM32F407 的硬件协同设计从原理图验证到 SPI 时序强制校准W5500 不是即插即用的“黑盒”其数据手册明确要求SPI 时钟相位CPHA必须为 0采样在第一个边沿极性CPOL必须为 0空闲低电平且 SCLK 频率上限为 80MHz但实际推荐 ≤ 20MHz 以留足建立/保持余量。F407 的 SPI1 挂在 APB2 总线上默认最大频率 84MHz若直接配置为 42MHz 分频SPI 波形将违反 W5500 的 tSU数据建立时间≥ 10ns 要求。必须通过寄存器级配置强制降频并校验波形。2.1 原理图级引脚确认W5500 应用电路的三个致命检查点W5500 的典型应用电路包含 3 组关键信号任何一处错接都会导致初始化失败信号名W5500 引脚推荐 F407 引脚必查事项/CSPIN 33GPIOE.3 (SPI1_NSS)必须配置为推挽输出初始化前拉高W5500 手册强调 /CS 下降沿触发内部寄存器锁存若接错为 GPIOA.4 等非 NSS 功能引脚wiz_write_buf()将写入无效地址/RESETPIN 32GPIOE.2 (推挽输出)上电后需保持 ≥ 10ms 低电平再拉高若接至 F407 的 NRST 引脚复位芯片则 W5500 无法独立复位ctlwizchip(CW_RESET_WIZCHIP, (void*)0)永远超时INTPIN 31GPIOE.1 (EXTI1)必须配置为下降沿触发外部中断若误接为 GPIOB.0无 EXTI 功能则getsockopt()无法感知连接事件TCP_Server 无法响应新客户端提示使用万用表通断档实测 PCB 走线而非仅依赖原理图标注。常见错误是 W5500 的 /CS 接至 F407 的 PA4非 NSS 功能此时即使 Keil 工程编译通过wiz_read_buf()读取VERSIONR寄存器地址 0x0039永远返回 0x00因为片选未生效。2.2 SPI1 寄存器级配置绕过 HAL 库默认值强制满足 W5500 时序HAL 库的MX_SPI1_Init()默认配置SPI_BAUDRATEPRESCALER_2APB2 频率 /2在 F407 84MHz 系统下产生 42MHz SCLK超出 W5500 安全范围。必须手动修改 SPI1 的SPI_CR1寄存器启用 4 分频// 在 MX_SPI1_Init() 函数末尾添加非替换原有 HAL_SPI_Init __HAL_SPI_DISABLE(hspi1); // 先关闭 SPI hspi1.Instance-CR1 ~SPI_CR1_BR; // 清除原分频位 hspi1.Instance-CR1 | SPI_CR1_BR_1 | SPI_CR1_BR_0; // 设置 BR[1:0] 11 → 分频系数 884MHz/810.5MHz __HAL_SPI_ENABLE(hspi1); // 重新使能此配置将 SCLK 降至 10.5MHz确保 tCYCLE95.2ns tSHSL(10ns) tVSL(15ns) tSU(10ns) 35ns 的最小总和。用示波器抓取 PB3(SCK) 和 PB5(MOSI) 波形确认 SCK 高电平宽度 ≥ 45ns即半周期 ≥ 47.6ns否则需进一步加大分频。2.3 W5500 初始化状态机wizchip_init()失败的三层诊断法wizchip_init()返回 -1 是高频问题按以下顺序逐层验证2.3.1 物理层连通性验证用wiz_read_buf()直读芯片 IDuint8_t ver_reg[2]; wiz_read_buf(0x0039, ver_reg, 2); // VERSIONR 寄存器地址 printf(W5500 VER: 0x%02X%02X\r\n, ver_reg[0], ver_reg[1]); // 正常应输出 W5500 VER: 0x04010x0401 表示 W5500 V1.0若输出0x0000说明 /CS 或 SPI 时序失效若输出0xFFFF说明 /RESET 未正确释放用示波器测 GPIOE.2 电平确认上电后 15ms 内由低变高。2.3.2 寄存器映射验证检查WIZNET_INFO结构体绑定W5500 驱动库要求WIZNET_INFO中的tx_size和rx_size必须与实际分配的内存一致#define TXBUF_SIZE 2048 #define RXBUF_SIZE 2048 uint8_t g_txbuf[TXBUF_SIZE]; uint8_t g_rxbuf[RXBUF_SIZE]; WIZNET_INFO wiznet_info { .tx_buf g_txbuf, .rx_buf g_rxbuf, .tx_size TXBUF_SIZE, .rx_size RXBUF_SIZE }; // 若 tx_size 设为 1024 但实际分配 2048wiz_write_buf() 会越界写入 SRAM2.3.3 中断向量表校准EXTI1 中断服务函数必须注册到正确位置W5500 的 INT 引脚触发 EXTI1其 ISR 必须为EXTI1_IRQHandler且需在stm32f4xx_it.c中显式启用void EXTI1_IRQHandler(void) { HAL_GPIO_EXTI_IRQHandler(GPIO_PIN_1); // GPIOE.1 对应 PIN_1 } // 并在 MX_GPIO_Init() 后调用 HAL_NVIC_EnableIRQ(EXTI1_IRQn); // 若误写为 EXTI0_IRQHandler则中断永不触发socket 状态无法更新3. Keil 工程中 TCP_Server 的状态机实现从 socket 创建到客户端轮询控制W5500 的 TCP_Server 不是简单调用socket()listen()其核心在于Sn_SRSocket n Status Register的轮询与Sn_IRSocket n Interrupt Register的清零时机。Keil 工程中若未处理Sn_IR的写 1 清零机制会导致中断持续触发CPU 占用率 100%。3.1 Socket 初始化四步法规避 W5500 的 8 个 socket 通道竞争W5500 仅提供 8 个 socket0~7每个 socket 独立工作。TCP_Server 必须独占一个 socket如 socket 0且需按严格顺序操作int sock 0; uint8_t destip[4] {0,0,0,0}; // 0.0.0.0 表示监听所有 IP uint16_t destport 5000; // Step 1: 关闭 socket清除可能残留状态 close(sock); // Step 2: 设置协议类型为 TCP setSn_PROTO(sock, Sn_PROTO_TCP); // Step 3: 绑定本地端口W5500 不支持 bind()直接设 Sn_PORT setSn_PORT(sock, destport); // Step 4: 启动监听触发 Sn_SR 进入 SOCK_LISTEN listen(sock);注意setSn_PORT()必须在listen()之前调用否则 W5500 内部状态机无法进入SOCK_LISTEN。若顺序颠倒getSn_SR(sock)将始终返回SOCK_CLOSED。3.2 主循环状态机基于 Sn_SR 的非阻塞轮询Keil 调试时若使用while(1)死循环必须避免recv()阻塞。W5500 的recv()是查询式需先读Sn_RX_RSR接收缓存大小再读数据while (1) { uint8_t status getSn_SR(sock); if (status SOCK_LISTEN) { // 检查是否有新连接请求 if (getSn_IR(sock) Sn_IR_CON) { setSn_IR(sock, Sn_IR_CON); // 写 1 清零 CON 中断标志 printf(New connection accepted\r\n); } } else if (status SOCK_ESTABLISHED) { uint16_t rx_len getSn_RX_RSR(sock); // 获取待接收字节数 if (rx_len 0) { uint8_t rx_buf[64]; int ret recv(sock, rx_buf, MIN(rx_len, 64)); if (ret 0) { // 解析控制指令如 LED_ON - GPIO_WriteBit(GPIOC, GPIO_Pin_13, Bit_SET) parse_control_command(rx_buf, ret); // 回复确认 send(sock, (uint8_t*)ACK, 3); } } } else if (status SOCK_CLOSE_WAIT) { // 客户端发起关闭需主动发送 FIN disconnect(sock); close(sock); printf(Connection closed\r\n); } HAL_Delay(1); // 防止 CPU 占用率过高 }3.3 Keil 调试关键设置解决HAL_SPI_TransmitReceive_IT()卡死问题当使用中断模式 SPI 时HAL_SPI_TransmitReceive_IT()卡在HAL_SPI_STATE_BUSY_TX_RX根源在于 W5500 的 /CS 信号未在 SPI 传输完成前及时拉高。必须在HAL_SPI_TxRxCpltCallback()中强制操作 /CSvoid HAL_SPI_TxRxCpltCallback(SPI_HandleTypeDef *hspi) { if (hspi-Instance SPI1) { HAL_GPIO_WritePin(GPIOE, GPIO_PIN_3, GPIO_PIN_SET); // 手动拉高 /CS // 此处可添加 wizchip_isr() 处理中断 } }同时在 Keil 的Options for Target → Debug → Settings → SWD中勾选Reset and Run确保每次下载后 F407 全局复位避免 W5500 寄存器残留状态干扰。4. W5500 TCP_Server 的抗干扰加固断连重试、内存泄漏防护与 Keil 生成 BIN 文件部署工业现场中网线插拔、交换机重启会导致 TCP 连接异常中断。裸写的recv()会因Sn_SR滞留在SOCK_ESTABLISHED而无法检测断连。必须引入心跳包与超时机制并确保 Keil 生成的 BIN 文件可直接烧录至 Flash 指定地址。4.1 断连检测与自动重试基于 Sn_SSR 的 Keep-Alive 实现W5500 的Sn_SSRSocket n Source Port Register在连接断开时不会自动变化需主动发送心跳包并检测响应static uint32_t last_heartbeat 0; #define HEARTBEAT_INTERVAL 30000 // 30秒 if (HAL_GetTick() - last_heartbeat HEARTBEAT_INTERVAL) { last_heartbeat HAL_GetTick(); // 发送单字节心跳0xFF int sent send(sock, (uint8_t*)\xFF, 1); if (sent 0) { // 发送失败判定连接断开 printf(Heartbeat failed, closing socket\r\n); disconnect(sock); close(sock); // 重置 socket 等待新连接 listen(sock); } }4.2 内存泄漏防护W5500 接收缓冲区的严格管理W5500 的Sn_RX_RSR返回的是硬件 FIFO 中的字节数recv()调用后该值不会自动清零需通过Sn_RX_RD接收读指针和Sn_RX_WR接收写指针计算实际已读字节数。若忽略此细节多次recv()后Sn_RX_RSR会溢出导致后续接收失败// 正确做法recv() 后手动更新 Sn_RX_RD int ret recv(sock, rx_buf, len); if (ret 0) { // 更新读指针Sn_RX_RD ret uint16_t rd_ptr getSn_RX_RD(sock); setSn_RX_RD(sock, rd_ptr ret); }4.3 Keil 生成 BIN 文件并烧录至 Flash 指定位置产线部署需将程序烧录至 Flash 的固定地址如 0x08004000而非默认的 0x08000000。在 Keil 中配置Options for Target → Target → IROM1起始地址改为0x08004000大小设为0x000FB000避开系统启动区Options for Target → Output → Create HEX File取消勾选勾选Create Binary File编译后Keil 生成ProjectName.bin使用 ST-Link Utility 烧录# 命令行烧录需安装 ST-Link driver ST-LINK_CLI.exe -c SWD -p ProjectName.bin 0x08004000此 BIN 文件不含 ELF 头信息直接映射到 Flash 地址避免 Keil 默认生成的 AXF 文件需额外解析。5. W5500 与 STM32F407 协同调试的终极技巧用 Keil Logic Analyzer 抓取 INT 信号与 socket 状态跃变Keil uVision5 内置的 Logic Analyzer 是调试 W5500 中断响应的利器无需外接示波器即可关联硬件信号与软件状态。关键在于将 GPIOE.1INT 引脚和Sn_SR寄存器值同步采样。5.1 配置 Keil Logic Analyzer 抓取 INT 电平与 Sn_SR 变化在 Keil 中打开View → Analysis Windows → Logic Analyzer添加信号点击Add→ 输入GPIOE_IDR输入数据寄存器→ 展开后勾选BIT1对应 GPIOE.1添加寄存器点击Add→ 输入0x10000000W5500 的 Sn_SR 地址socket 0 为0x10000000设置采样深度为10000触发条件设为GPIOE_IDR.BIT1 0下降沿运行程序后Logic Analyzer 将显示当 PC 端telnet 192.168.1.100 5000连接时GPIOE.1 出现一次下降沿脉冲紧随其后0x10000000地址的值从0x13SOCK_INIT跃变为0x14SOCK_LISTEN再变为0x17SOCK_ESTABLISHED。若脉冲后Sn_SR无变化则证明EXTI1_IRQHandler未执行或wizchip_isr()未被调用。5.2 利用 Keil Memory Browser 实时监控 W5500 寄存器W5500 的寄存器映射在0x10000000开始的 1MB 空间可在 Keil 调试时直接查看View → Memory BrowserAddress 栏输入0x10000000socket 0 的 Sn_SR右键选择Unsigned 32-bit显示格式当Sn_SR值卡在0x13不变时立即检查0x10000002Sn_PORT是否为0x13885000 的十六进制若为0x0000说明setSn_PORT()调用失败根源在 SPI 写入时序错误。5.3 Keil 编译警告的精准解读warning: #177-D: variable was declared but never referenced此类警告常出现在wizchip_init()中声明的uint8_t memsize[2]未被使用。W5500 驱动库要求该数组用于ctlwizchip(CW_GET_MAX_HEAP_SIZE, (void*)memsize)但若跳过此调用Keil 会报此警告。不要删除该变量而应补全调用uint8_t memsize[2]; ctlwizchip(CW_GET_MAX_HEAP_SIZE, (void*)memsize); printf(Max heap: %d KB\r\n, (memsize[0]8)|memsize[1]); // 输出 16KB该值决定了 W5500 内部 TX/RX 缓冲区的最大分配空间影响并发连接数。忽略此步骤将导致socket()分配失败Sn_SR始终为SOCK_CLOSED。本文还有配套的精品资源点击获取