简介压缩包 W5500Test-20180314.7z 是一套面向 W5500 以太网控制器与 STM32F4 微控制器的测试工程目的在于快速评估 W5500 的全硬件 TCP/IP 协议栈与 SPI 接口特性适合嵌入式网络开发者和物联网项目工程师用作集成参考。资源共 1256 个文件整体约 10.86MB主体为 C 源码与 H 头文件覆盖驱动、协议栈和 ARM DSP 库另有 JS/PNG/GIF 等网页与界面资源、汇编启动文件、PDF/CHM 文档、Hex 固件以及 Keil 工程配置uvproj/uvopt便于在 STM32F4 上直接编译、烧录和查阅。该资源在 CSDN 已有 1055 人学习/下载。具体价值上开发者可从中获得 W5500 的 SPI 驱动例程、TCP/UDP/IP/ARP/ICMP 协议实现思路、MAC/IP/端口等网络参数的配置方法以及完整的基于 Keil MDK 的工程框架既可用于 W5500 的功能性验证与通信调试也能借助其中文档和代码快速移植到其他 Cortex-M 平台缩短网关、工业控制器等网络产品的原型开发周期。1. 拿到 W5500Test-20180314.7z这个压缩包到底在测什么看到“W5500Test-20180314.7z”这个文件名第一反应是这是某一次针对 W5500 的测试工程打包。W5500 是一颗把 TCP/IP 协议栈做进芯片里的以太网控制器MCU 通过 SPI 接口读写它的寄存器就能完成网络收发不用在单片机里跑协议栈。这个 7z 压缩包通常包含编译好的工程源码、驱动库和接线说明日期 20180314 大概率是工程导出的时间点。对做嵌入式联网设备的人来说这个包的价值在于用最快速度验证 W5500 硬件焊接、SPI 通路和网络链路是否正常。适合手里有一块 W5500 模块、想在三天内看到 TCP 通信结果的开发者也适合刚接触硬件协议栈、不想从零啃协议文档的人。下文按“原理 → 移植 → 调参 → 避坑 → 进阶”的顺序把这条链路讲透。2. SPI 与寄存器读写的底层机制先看懂 W5500 怎么被驱动起来写 W5500 之前要理解它是“寄存器型”芯片。MCU 通过 SPI 访问芯片内部的 Common 寄存器区和 Socket 寄存器区所有网络收发、socket 状态、缓冲区位置都映射在寄存器里。相比用软件协议栈这种方式把协议处理从 MCU 里移出去了代价是每一次读写都要走一条明确的 SPI 帧。很多移植问题其实都出在 SPI 帧拼错、CS 时序不对、寄存器块选错这三个点上所以这一章值得先看。2.1 8 位控制字节与 16 位地址SPI 帧结构里的三个关键位域W5500 的每次 SPI 访问分三个阶段8 位控制字节、16 位地址、8 位数据。控制字节是 W5500 区别于普通 SPI 外设的核心它决定了这次访问落在哪个寄存器块、哪个 socket、是读还是写。常见库函数已经封装好了帧拼接但排查问题时你必须能看懂波形里的控制字节。// 手动拼接控制字节的参考实现方便理解位域含义 uint8_t spi_frame_ctrl(uint8_t block, uint8_t sock_no, uint8_t is_read) { uint8_t ctrl 0; // SBLK[1:0]寄存器块选择 // 00 Common 寄存器区全局配置 // 01 Socket 寄存器区按 socket 编号访问 // 10 TX 发送缓冲区 // 11 RX 接收缓冲区 if (block BLOCK_COMMON) { ctrl | (0x00 5); } else if (block BLOCK_SOCKET) { ctrl | (0x01 5); } else if (block BLOCK_TXBUF) { ctrl | (0x02 5); } else if (block BLOCK_RXBUF) { ctrl | (0x03 5); } // BSB[4:3]socket 编号只对 Socket 寄存器和缓冲区有效 ctrl | ((sock_no 0x03) 3); // RD/WB1 表示读0 表示写 ctrl | (is_read ? (1 2) : 0); // OM[1:0]地址自动增加模式连续读写时设 0x01 ctrl | 0x01; return ctrl; }这段代码的逻辑说明SBLK 是最高位的块选择访问 Common 寄存器时 socket 号必须填 0否则地址会偏移到错误的位置访问 Socket 寄存器时 BSB 决定操作哪个 socket。RD/WB 位决定数据方向很多移植失败是因为读操作时忘记把这一位置 1结果读回来的永远是上次写入的值。OM 位设成地址自动增加后连续读一大段 RX 缓冲数据时只需发一次首地址这个特性在收发大量数据时能省一半 SPI 开销。在实际工程里一般不会手写这个帧而是把 CS 片选和 SPI 读写注册给驱动库// 把 MCU 的 SPI 读写函数注册给 W5500 驱动库 reg_wizchip_cs_cbfunc(spi_cs_select, spi_cs_deselect); reg_wizchip_spi_cbfunc(spi_read_byte, spi_write_byte); // 注册之后库内部所有寄存器访问都会走这两个回调要注意的是CS 回调里不能做耗时操作。某工程师把 CS 拉低后加了延时导致整个 SPI 时钟变慢最后链路能通但吞吐只有几 KB/s。CS 拉低到第一个 SCK 上升沿之间通常会有几十纳秒余量普通 GPIO 操作足够不需要额外加延时。2.2 最小初始化序列从硬件复位到 TCP 就绪的四个步骤W5500 的初始化顺序有讲究跳步会导致 PHY 没起来、IP 没写进去、socket 打不开。常见做法是硬件复位 → 验证 SPI 通路 → 配置网络信息 → 分配缓冲区。以下是一段可用的初始化流程// 第一步硬件复位RSTn 拉低至少 10ms 再拉高 HAL_GPIO_WritePin(RST_PORT, RST_PIN, GPIO_PIN_RESET); HAL_Delay(50); HAL_GPIO_WritePin(RST_PORT, RST_PIN, GPIO_PIN_SET); HAL_Delay(200); // 等芯片内部 PHY 完成上电初始化 // 第二步读版本寄存器验证 SPI 通路是否真正打通 uint8_t ver 0; spi_cs_select(); spi_read_byte(0x003F, ver); // VERSIONR 寄存器地址 0x003F spi_cs_deselect(); if (ver ! 0x04) { // 版本号固定为 0x04读不到就说明 SPI 时序或接线有问题 error_handler(); }版本寄存器读回 0x04 是识别 W5500 的关键标志也是区分 W5100、W5200 的重要依据。如果你读回来是 0xFF大概率是 SPI 模式不对或 CS 没有包住整个帧如果读回来是 0x00检查 MISO 是否虚焊。这一步通过之后再配置网络信息// 第三步写入 MAC、IP、网关、子网掩码 wizchip_initialize(); // 库初始化包含 PHY 配置移植版可能叫 wizchip_init() wizchip_setnetinfo(netinfo); // netinfo 结构体示例 wiz_NetInfo netinfo { .mac {0x00, 0x08, 0xDC, 0x12, 0x34, 0x56}, .ip {192, 168, 1, 100}, .gw {192, 168, 1, 1}, .sn {255, 255, 255, 0} }; // 第四步分配 8 个 socket 的收发缓冲区 uint8_t tx_size[8] {2, 2, 2, 2, 2, 2, 2, 2}; // 单位 KB uint8_t rx_size[8] {2, 2, 2, 2, 2, 2, 2, 2}; wizchip_setbufferinfo(tx_size, rx_size);这段代码的核心是顺序不能乱。先复位再读版本确认 SPI 通路可靠后才写网络参数缓冲区分配放在最后因为 socket 打开时会直接检查缓冲区大小如果为 0 会返回失败。netinfo 里的 MAC 不能全 0 也不能全 FF后面第 4 章会展开讲。2.3 三个基础参数的取舍晶振、MAC 与 SPI 时钟W5500 需要外部 25MHz 晶振模块上一般已经焊好但自己画板时晶振起振失败会导致 PHY 无法 link up。判断方法上电后测量 XI 引脚波形正常会有 25MHz 震荡如果没有检查晶振负载电容是否匹配。参数典型值注意事项晶振频率25MHz不能用内部 RC 替代精度要求高SPI 时钟10~20MHz上限约 33MHz但建议留余量SPI 模式Mode 0 或 Mode 3两种都支持固定一种后不要随意切换MAC 地址单播地址不能全 0、全 FF不能和局域网内设备重复MAC 地址这块有个实用技巧用 MCU 的 96 位唯一 ID 生成 MAC可以保证每台设备出厂不冲突。最简单做法是取 UID 低 4 字节再把第一个字节的最低两位清零单播地址要求填到 SHAR 寄存器。如果你只是内网测试手工指定一个不冲突的地址就够了。3. 把 W5500Test 工程跑起来解压、接线、烧录与第一次通信无论这个 7z 压缩包里的工程原本跑在哪个 MCU 上解压后都绕不开三块内容W5500 驱动层、平台相关的 SPI 适配、基于 socket 的测试应用。把这三层分开看移植就能少走弯路。3.1 解压后的三类文件怎么认先找 README再找 main最后看 SPI 适配7z 压缩包需要用 7-Zip 或支持 7z 格式的工具解压。解压后先找 README、readme.txt 或说明文档里面通常会写默认 IP、端口、引脚定义如果压缩包里没有说明文档就直接打开 main 函数看它初始化了哪些 GPIO、用了哪个 SPI 外设。W5500 测试工程的文件命名通常很直白看到 spi、w5500、socket 字样的文件就能猜到归属。我一般会按这个顺序阅读先看 main 函数里调用初始化函数的顺序确认 SPI 和 CS 引脚定义再看驱动的 SPI 回调函数确认 CS 拉低拉高的时机最后才看 socket 测试逻辑。如果解压出来是 Keil 或 IAR 工程直接打开看工程文件树比逐个翻源文件快得多。有些工程会带逻辑分析仪抓取的 SPI 波形截图或者串口打印调试信息这些是确认移植是否成功的重要参照。3.2 接线与 SPI 配置把 W5500 模块连到自己的板子上接线是移植里最容易出低级错误的一步。W5500 模块和 MCU 之间有六个关键引脚SCK、MOSI、MISO、CSn、RSTn、DINTn。其中 DINTn 是可选的测试阶段可以不接靠轮询 socket 状态寄存器也能完成收发RSTn 必须接而且不能直接悬空。电源建议统一用 3.3V注意模块上有无电平转换芯片如果模块是 5V 容忍设计也要确认 MCU 引脚是否兼容。// SPI 初始化示例模式 09MHz 时钟 SPI_InitTypeDef spi {0}; spi.Mode SPI_MODE_MASTER; spi.Direction SPI_DIRECTION_2LINES; spi.DataSize SPI_DATASIZE_8BIT; spi.CLKDivider SPI_BAUDRATEPRESCALER_8; // 72MHz/8 9MHz spi.CPolarity SPI_CPOL_LOW; // CPOL0 spi.CPhase SPI_CPHASE_1EDGE; // CPHA0 HAL_SPI_Init(hspi); // CS 引脚配置为普通 GPIO 输出默认拉高 GPIO_InitTypeDef gpio {0}; gpio.Mode GPIO_MODE_OUTPUT_PP; gpio.Pull GPIO_NOPULL; gpio.Speed GPIO_SPEED_FREQ_HIGH; gpio.Pin CS_PIN; HAL_GPIO_Init(CS_PORT, gpio); HAL_GPIO_WritePin(CS_PORT, CS_PIN, GPIO_PIN_SET);SPI 时钟频率这里给了 9MHz是很多 MCU 在默认时钟树下的一个安全值。如果系统主频更高可以把分频系数降下来跑到 18MHz 左右W5500 官方上限约为 33MHz。对测试工程来说 9MHz 和 18MHz 差异不大但如果你后面要做大数据量传输SPI 时钟直接决定吞吐上限。模式 0 和模式 3 都支持选定后不要随意切换否则读回的数据全是乱的。CS 引脚的控制要特别注意W5500 的一个完整 SPI 帧必须由 CS 低电平包住期间不能出现 CS 拉高的操作。如果用 HAL 库的 SPI 中断或 DMA 传输务必确认 CS 在整个传输期间保持低电平。很多翻车案例是 SPI 一字节一字节发送时库函数内部把 CS 拉高拉低了导致 W5500 认为每次只有一个字节的数据帧。3.3 编译、烧录、验证用 telnet 完成第一次 TCP 握手跑通最小 TCP 服务器是验证 W5500 链路最快的方法。烧录后先 ping 设备 IP通了再 telnet不要直接跳一步。以下是一个最简 TCP 回显服务端的 socket 逻辑uint8_t socket_no 0; uint8_t buf[256] {0}; // 打开 socket 0TCP 服务端模式监听 5000 端口 socket(socket_no, Sn_MR_TCP, 5000, 0); listen(socket_no); while (1) { if (getSn_SR(socket_no) SOCK_ESTABLISHED) { // 有客户端连入读数据并原样回发 int16_t len recv(socket_no, buf, sizeof(buf)); if (len 0) { send(socket_no, buf, len); } } else if (getSn_SR(socket_no) SOCK_CLOSED) { // 连接断开后必须重新 socket listen否则无法再次接入 close(socket_no); socket(socket_no, Sn_MR_TCP, 5000, 0); listen(socket_no); } }这里最容易漏的是连接断开后的“重新 socket listen”组合。如果只调用 listen 不重新 socketsocket 状态会一直停在 SOCK_CLOSED客户端再也连不进来必须复位 MCU 才能恢复。验证步骤PC 上把 IP 改成 192.168.1.x 网段先 ping 192.168.1.100通了之后在命令行执行telnet 192.168.1.100 5000连上后随便敲几个字符板子串口或调试器里能看到收到的数据。如果你用的系统没有 telnet 客户端也可以用网络调试助手效果一样。ping 不通就先检查网线连接和 IP 配置ping 通但 telnet 不通检查 socket 是否成功进入 LISTEN 状态以及防火墙是否拦截了 5000 端口。4. 必调的四组参数网关、端口、超时与缓冲区分配W5500 的寄存器配置直接决定网络行为测试工程能跑通不代表换到产品环境还能跑通。这一章列四组必调参数都是实际项目中反复踩过的坑。4.1 网关与子网掩码设错的典型翻车现象同网段直连时网关可以填 0.0.0.0但设备一旦需要跨网段访问服务器网关必须正确。典型翻车现象设备 IP 能 ping 通但设备主动连接外网服务器时一直超时。原因往往不是 W5500 坏了而是 GAR 寄存器里没有写入有效网关地址ARP 请求发不出去。这个问题的排查顺序先确认 PC 和设备在同一个网段比如设备是 192.168.1.100PC 就设 192.168.1.50再确认 W5500 的三个地址——GAR网关、SUBR子网掩码、SIPR本机 IP——都正确写入了。用调试器直接读这三个寄存器核对比在代码里反复检查 netinfo 结构体有效得多。子网掩码设错的表现更隐蔽设备能 ping 通但向局域网外发数据时没有反应。原因是 W5500 判断目的地址是否在同一网段时用掩码做与运算掩码错了就把所有地址都当成网外数据全扔给网关而网关可能根本不存在。测试阶段固定用 255.255.255.0别省事。4.2 端口绑定与 socket 重连逻辑本地端口建议固定不要传 0。W5500 的驱动里端口传 0 时行为依赖具体库版本有的会随机分配端口有的直接返回失败这会让调试变得不可控。测试工程里一般固定 5000 或 8080产品上如果多设备共存端口按设备 ID 或功能划分。socket 重连有个状态细节主动 close 之后socket 会进入 TIME-WAIT 状态此时立刻重新 socket 同一个端口大概率失败。可靠做法是 close 之后加一个延时约 2~3 秒或者直接换一个本地端口。下面这段代码演示了带状态判断的重连逻辑uint8_t sock_state getSn_SR(socket_no); if (sock_state SOCK_TIME_WAIT) { // TIME-WAIT 是主动断开后的状态等 2MSL 再复用端口 HAL_Delay(2000); close(socket_no); } else if (sock_state SOCK_CLOSED) { // 完全关闭后重新进入监听 socket(socket_no, Sn_MR_TCP, local_port, 0); listen(socket_no); }这里 close 之后延时 2000ms 是工程上的常用折中值W5500 的 TIME-WAIT 实际时长由 MSL 决定但嵌入式场景没必要做精确协议计时延时 2 秒后重新监听端口通常足够。如果你的产品对重连速度要求高更推荐换端口而不是等 TIME-WAIT 结束。4.3 超时参数的设置与掉线重连W5500 的重发超时和重试次数通过 RTR 和 RCR 两个寄存器控制驱动库封装成 setRetransmit 函数。RTR 单位是 100us默认值 0x07D0 对应 200msRCR 是重试次数默认 3 次。// 设置 TCP 重发超时 300ms重试 5 次 // RTR 300ms / 100us 3000 // RCR 5最多重发 5 次 setRetransmit(3000, 5);参数选择的经验网络环境差、Wi-Fi 桥接或有丢包时重发间隔长一点反而可靠300ms 到 500ms 是常见区间重试次数太少会导致短暂网络波动就把连接断了次数太多会在对端无响应时拖很久才报错。我一般先设 300ms、5 次跑稳定性测试发现频繁掉线再往大调发现连接失败要等太久再往小调。还有一个容易忽略的点ARP 超时。TCP 建立连接前要先解析对端 MAC 地址如果 ARP 缓存过期且网络中 ARP 响应慢第一次连接会明显卡顿甚至失败。W5500 的 ARP 相关寄存器不多常见的缓解方式是设备端做周期性 Ping 保活或者应用层主动建连前先发一个 ICMP 探测。在测试工程里保持默认即可产品上要留意这个细节。5. W5500 调试避坑5 个反复出现的问题与定位方法下面这五条是按出现频率排的每条都是现象 → 原因 → 解决的结构基本覆盖了从硬件到协议栈的常见故障面。5.1 读版本寄存器返回 0xFF 或 0x00现象调用读 VERSIONR 寄存器的函数返回值不是 0x04而是 0xFF 或 0x00SPI 通路直接失败。原因SPI 模式不匹配W5500 要求 Mode 0 或 Mode 3MCU 配成了其他模式或者 CS 没有包住整个 SPI 帧W5500 把每次字节传输都当成独立帧解析再或者 MISO 引脚虚焊数据根本读不回来。解决先用逻辑分析仪抓 SPI 波形确认 8 位控制字节加 16 位地址加 8 位数据的帧结构完整然后把 SPI 模式在 Mode 0 和 Mode 3 之间切换对比确认 CS 在整个帧期间保持低电平。读版本寄存器是最小的验证用例这个都过不了就不要往下调网络。5.2 网口灯亮但 ping 不通现象以太网口的 LINK 灯正常亮起但 PC 上 ping 设备 IP 没有任何响应。原因IP 配置没有真正写入芯片常见于调用了 wizchip_setnetinfo 但库内部没执行写入操作或者 MAC 地址全是 0x00芯片发出的 ARP 请求被对端丢弃也有可能是网线直连 PC 时 PC 侧 IP 还没配到同一网段。解决第一步直接读 SHAR、SIPR、GAR、SUBR 四个寄存器确认写入值与期望一致这一步能排除八成问题。第二步把 MAC 改成非全 0 的任意单播地址。第三步检查 PC 网卡的 IP 和掩码确保与设备在同一网段。如果上述都正确还不通换一根网线或换个交换机口再试PHY 自适应有时会出玄学问题。5.3 TCP 能连接但收不到完整数据现象telnet 能连上但给板子发数据后串口只有第一帧有输出后续数据全部丢失。原因接收缓冲区配置成了 0或者接收完成后没有向 Sn_CR 写入 RECV 命令。W5500 的接收流程是读取 Sn_RX_RSR 得到接收字节数从 RX 缓冲区读走数据最后必须写 Sn_CR 的 RECV 命令清标志芯片才会把新到的数据放进缓冲区。漏掉最后一步后续数据会被丢弃。解决检查 socket 的 RX 缓冲区大小是否为 0确认分配过缓冲区在 recv 返回后立即执行 Sn_CR 的 RECV 命令。注意读取 Sn_RX_RSR 时要用连续两次读取结果一致的机制先读高字节再读低字节否则多线程环境下可能读到中间状态值。5.4 主动断开后 socket 无法重新监听现象客户端主动断开后调用 close 加 listen 重新监听但客户端再也连不上socket 状态停在 SOCK_TIME_WAIT 或 SOCK_CLOSED。原因主动 close 后 W5500 会进入 TIME-WAIT这个状态下即使执行 close 和 listen驱动也可能没有真正释放端口或者重连逻辑没有判断当前 socket 状态在 TIME-WAIT 时直接执行了 socket 操作。解决在重连前先读取 Sn_SR根据状态分支处理。TIME-WAIT 状态延时 2 秒再 closeSOCK_CLOSED 状态才重新执行 socket 加 listen。这个逻辑前面第 4.2 节有完整代码直接套用即可。5.5 连接几秒后周期掉线现象TCP 连接建立后能通几秒然后断线过一会儿又自动连上反复循环。原因看门狗复位导致 MCU 重启socket 状态丢失或者 SPI 引脚被其他外设复用通信时序被中断再或者上电初始化时 PHY 还没完全就绪就开始了 socket 监听芯片内部状态异常。解决先用串口打印 MCU 复位标志寄存器确认是不是看门狗在复位。如果 SPI 引脚和调试串口复用调试时可能正常拔掉调试器就掉线。初始化上电后延时从 200ms 加到 500ms给 PHY 留足稳定时间。还有一种情况是电源纹波过大导致芯片偶发复位用示波器看 3.3V 波形掉电瞬间是否跌破 2.7V。6. 从能跑通到能上线几个值得加进去的小改动当测试工程能稳定跑完 TCP 回环后距离真正产品化还差几步。第一个改动是把轮询改成中断驱动W5500 的 DINTn 引脚在 socket 状态变化或数据到达时拉低接到 MCU 的外部中断脚可以避免主循环频繁查询 Sn_SR 寄存器。这样 CPU 占用率能明显下降在低主频 MCU 上尤其明显。第二个改动是收发缓冲区分区策略。测试工程默认 8 个 socket 平均分每 socket 各 2KB但如果产品只用 1 个 TCP 连接完全可以给 socket 0 分 TX 8KB、RX 8KB其余 socket 全部设 0。缓冲区分配越大单次能收发的数据量越大SPI 传输效率越高。注意修改后要重新调用 wizchip_setbufferinfo 并复位芯片。第三个改动是 SPI DMA。W5500 读写收发缓冲区动辄上百字节用轮询方式逐字节传输会卡死 CPU。常见做法是CS 拉低后用 SPI DMA 连续传输控制字节、地址和数据字段传输完成中断里再拉高 CS。这里有个容易踩的细节控制字节和地址字段可以先拼进一个发送数组再和接收数组一起启动 DMA避免 DMA 中途 CS 被释放。实测一般场景下 DMA 加 18MHz SPI 时钟可以把吞吐做到几百 KB/s 级别足够大多数物联网设备用。第四个改动是协议层设计。不要在 W5500 上直接跑复杂的 HTTP 解析先用回环测试把链路可靠性验证足够再叠加 MQTT 或自定义二进制协议。W5500 的优势是内核帮你处理了 TCP 状态机但应用层超时重传、心跳保活仍然要自己做。我会在心跳间隔和断线重连之间找一个平衡心跳太快浪费带宽太慢又可能被运营商或交换机回收连接一般 30 秒到 60 秒是一个比较稳妥的区间。最后说一个我的习惯每次拿到一块新的 W5500 板子不管是什么平台都从读版本寄存器 0x04 开始验证再到 ping再到 TCP 回环最后才动协议层。这个顺序帮我省了很多排查时间也避免了把 SPI 问题和网络问题混在一起。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/15 16:49:28 · 阅读 1.2k W5500嵌入式以太网控制器SPI驱动与调试实战
简介压缩包 W5500Test-20180314.7z 是一套面向 W5500 以太网控制器与 STM32F4 微控制器的测试工程目的在于快速评估 W5500 的全硬件 TCP/IP 协议栈与 SPI 接口特性适合嵌入式网络开发者和物联网项目工程师用作集成参考。资源共 1256 个文件整体约 10.86MB主体为 C 源码与 H 头文件覆盖驱动、协议栈和 ARM DSP 库另有 JS/PNG/GIF 等网页与界面资源、汇编启动文件、PDF/CHM 文档、Hex 固件以及 Keil 工程配置uvproj/uvopt便于在 STM32F4 上直接编译、烧录和查阅。该资源在 CSDN 已有 1055 人学习/下载。具体价值上开发者可从中获得 W5500 的 SPI 驱动例程、TCP/UDP/IP/ARP/ICMP 协议实现思路、MAC/IP/端口等网络参数的配置方法以及完整的基于 Keil MDK 的工程框架既可用于 W5500 的功能性验证与通信调试也能借助其中文档和代码快速移植到其他 Cortex-M 平台缩短网关、工业控制器等网络产品的原型开发周期。1. 拿到 W5500Test-20180314.7z这个压缩包到底在测什么看到“W5500Test-20180314.7z”这个文件名第一反应是这是某一次针对 W5500 的测试工程打包。W5500 是一颗把 TCP/IP 协议栈做进芯片里的以太网控制器MCU 通过 SPI 接口读写它的寄存器就能完成网络收发不用在单片机里跑协议栈。这个 7z 压缩包通常包含编译好的工程源码、驱动库和接线说明日期 20180314 大概率是工程导出的时间点。对做嵌入式联网设备的人来说这个包的价值在于用最快速度验证 W5500 硬件焊接、SPI 通路和网络链路是否正常。适合手里有一块 W5500 模块、想在三天内看到 TCP 通信结果的开发者也适合刚接触硬件协议栈、不想从零啃协议文档的人。下文按“原理 → 移植 → 调参 → 避坑 → 进阶”的顺序把这条链路讲透。2. SPI 与寄存器读写的底层机制先看懂 W5500 怎么被驱动起来写 W5500 之前要理解它是“寄存器型”芯片。MCU 通过 SPI 访问芯片内部的 Common 寄存器区和 Socket 寄存器区所有网络收发、socket 状态、缓冲区位置都映射在寄存器里。相比用软件协议栈这种方式把协议处理从 MCU 里移出去了代价是每一次读写都要走一条明确的 SPI 帧。很多移植问题其实都出在 SPI 帧拼错、CS 时序不对、寄存器块选错这三个点上所以这一章值得先看。2.1 8 位控制字节与 16 位地址SPI 帧结构里的三个关键位域W5500 的每次 SPI 访问分三个阶段8 位控制字节、16 位地址、8 位数据。控制字节是 W5500 区别于普通 SPI 外设的核心它决定了这次访问落在哪个寄存器块、哪个 socket、是读还是写。常见库函数已经封装好了帧拼接但排查问题时你必须能看懂波形里的控制字节。// 手动拼接控制字节的参考实现方便理解位域含义 uint8_t spi_frame_ctrl(uint8_t block, uint8_t sock_no, uint8_t is_read) { uint8_t ctrl 0; // SBLK[1:0]寄存器块选择 // 00 Common 寄存器区全局配置 // 01 Socket 寄存器区按 socket 编号访问 // 10 TX 发送缓冲区 // 11 RX 接收缓冲区 if (block BLOCK_COMMON) { ctrl | (0x00 5); } else if (block BLOCK_SOCKET) { ctrl | (0x01 5); } else if (block BLOCK_TXBUF) { ctrl | (0x02 5); } else if (block BLOCK_RXBUF) { ctrl | (0x03 5); } // BSB[4:3]socket 编号只对 Socket 寄存器和缓冲区有效 ctrl | ((sock_no 0x03) 3); // RD/WB1 表示读0 表示写 ctrl | (is_read ? (1 2) : 0); // OM[1:0]地址自动增加模式连续读写时设 0x01 ctrl | 0x01; return ctrl; }这段代码的逻辑说明SBLK 是最高位的块选择访问 Common 寄存器时 socket 号必须填 0否则地址会偏移到错误的位置访问 Socket 寄存器时 BSB 决定操作哪个 socket。RD/WB 位决定数据方向很多移植失败是因为读操作时忘记把这一位置 1结果读回来的永远是上次写入的值。OM 位设成地址自动增加后连续读一大段 RX 缓冲数据时只需发一次首地址这个特性在收发大量数据时能省一半 SPI 开销。在实际工程里一般不会手写这个帧而是把 CS 片选和 SPI 读写注册给驱动库// 把 MCU 的 SPI 读写函数注册给 W5500 驱动库 reg_wizchip_cs_cbfunc(spi_cs_select, spi_cs_deselect); reg_wizchip_spi_cbfunc(spi_read_byte, spi_write_byte); // 注册之后库内部所有寄存器访问都会走这两个回调要注意的是CS 回调里不能做耗时操作。某工程师把 CS 拉低后加了延时导致整个 SPI 时钟变慢最后链路能通但吞吐只有几 KB/s。CS 拉低到第一个 SCK 上升沿之间通常会有几十纳秒余量普通 GPIO 操作足够不需要额外加延时。2.2 最小初始化序列从硬件复位到 TCP 就绪的四个步骤W5500 的初始化顺序有讲究跳步会导致 PHY 没起来、IP 没写进去、socket 打不开。常见做法是硬件复位 → 验证 SPI 通路 → 配置网络信息 → 分配缓冲区。以下是一段可用的初始化流程// 第一步硬件复位RSTn 拉低至少 10ms 再拉高 HAL_GPIO_WritePin(RST_PORT, RST_PIN, GPIO_PIN_RESET); HAL_Delay(50); HAL_GPIO_WritePin(RST_PORT, RST_PIN, GPIO_PIN_SET); HAL_Delay(200); // 等芯片内部 PHY 完成上电初始化 // 第二步读版本寄存器验证 SPI 通路是否真正打通 uint8_t ver 0; spi_cs_select(); spi_read_byte(0x003F, ver); // VERSIONR 寄存器地址 0x003F spi_cs_deselect(); if (ver ! 0x04) { // 版本号固定为 0x04读不到就说明 SPI 时序或接线有问题 error_handler(); }版本寄存器读回 0x04 是识别 W5500 的关键标志也是区分 W5100、W5200 的重要依据。如果你读回来是 0xFF大概率是 SPI 模式不对或 CS 没有包住整个帧如果读回来是 0x00检查 MISO 是否虚焊。这一步通过之后再配置网络信息// 第三步写入 MAC、IP、网关、子网掩码 wizchip_initialize(); // 库初始化包含 PHY 配置移植版可能叫 wizchip_init() wizchip_setnetinfo(netinfo); // netinfo 结构体示例 wiz_NetInfo netinfo { .mac {0x00, 0x08, 0xDC, 0x12, 0x34, 0x56}, .ip {192, 168, 1, 100}, .gw {192, 168, 1, 1}, .sn {255, 255, 255, 0} }; // 第四步分配 8 个 socket 的收发缓冲区 uint8_t tx_size[8] {2, 2, 2, 2, 2, 2, 2, 2}; // 单位 KB uint8_t rx_size[8] {2, 2, 2, 2, 2, 2, 2, 2}; wizchip_setbufferinfo(tx_size, rx_size);这段代码的核心是顺序不能乱。先复位再读版本确认 SPI 通路可靠后才写网络参数缓冲区分配放在最后因为 socket 打开时会直接检查缓冲区大小如果为 0 会返回失败。netinfo 里的 MAC 不能全 0 也不能全 FF后面第 4 章会展开讲。2.3 三个基础参数的取舍晶振、MAC 与 SPI 时钟W5500 需要外部 25MHz 晶振模块上一般已经焊好但自己画板时晶振起振失败会导致 PHY 无法 link up。判断方法上电后测量 XI 引脚波形正常会有 25MHz 震荡如果没有检查晶振负载电容是否匹配。参数典型值注意事项晶振频率25MHz不能用内部 RC 替代精度要求高SPI 时钟10~20MHz上限约 33MHz但建议留余量SPI 模式Mode 0 或 Mode 3两种都支持固定一种后不要随意切换MAC 地址单播地址不能全 0、全 FF不能和局域网内设备重复MAC 地址这块有个实用技巧用 MCU 的 96 位唯一 ID 生成 MAC可以保证每台设备出厂不冲突。最简单做法是取 UID 低 4 字节再把第一个字节的最低两位清零单播地址要求填到 SHAR 寄存器。如果你只是内网测试手工指定一个不冲突的地址就够了。3. 把 W5500Test 工程跑起来解压、接线、烧录与第一次通信无论这个 7z 压缩包里的工程原本跑在哪个 MCU 上解压后都绕不开三块内容W5500 驱动层、平台相关的 SPI 适配、基于 socket 的测试应用。把这三层分开看移植就能少走弯路。3.1 解压后的三类文件怎么认先找 README再找 main最后看 SPI 适配7z 压缩包需要用 7-Zip 或支持 7z 格式的工具解压。解压后先找 README、readme.txt 或说明文档里面通常会写默认 IP、端口、引脚定义如果压缩包里没有说明文档就直接打开 main 函数看它初始化了哪些 GPIO、用了哪个 SPI 外设。W5500 测试工程的文件命名通常很直白看到 spi、w5500、socket 字样的文件就能猜到归属。我一般会按这个顺序阅读先看 main 函数里调用初始化函数的顺序确认 SPI 和 CS 引脚定义再看驱动的 SPI 回调函数确认 CS 拉低拉高的时机最后才看 socket 测试逻辑。如果解压出来是 Keil 或 IAR 工程直接打开看工程文件树比逐个翻源文件快得多。有些工程会带逻辑分析仪抓取的 SPI 波形截图或者串口打印调试信息这些是确认移植是否成功的重要参照。3.2 接线与 SPI 配置把 W5500 模块连到自己的板子上接线是移植里最容易出低级错误的一步。W5500 模块和 MCU 之间有六个关键引脚SCK、MOSI、MISO、CSn、RSTn、DINTn。其中 DINTn 是可选的测试阶段可以不接靠轮询 socket 状态寄存器也能完成收发RSTn 必须接而且不能直接悬空。电源建议统一用 3.3V注意模块上有无电平转换芯片如果模块是 5V 容忍设计也要确认 MCU 引脚是否兼容。// SPI 初始化示例模式 09MHz 时钟 SPI_InitTypeDef spi {0}; spi.Mode SPI_MODE_MASTER; spi.Direction SPI_DIRECTION_2LINES; spi.DataSize SPI_DATASIZE_8BIT; spi.CLKDivider SPI_BAUDRATEPRESCALER_8; // 72MHz/8 9MHz spi.CPolarity SPI_CPOL_LOW; // CPOL0 spi.CPhase SPI_CPHASE_1EDGE; // CPHA0 HAL_SPI_Init(hspi); // CS 引脚配置为普通 GPIO 输出默认拉高 GPIO_InitTypeDef gpio {0}; gpio.Mode GPIO_MODE_OUTPUT_PP; gpio.Pull GPIO_NOPULL; gpio.Speed GPIO_SPEED_FREQ_HIGH; gpio.Pin CS_PIN; HAL_GPIO_Init(CS_PORT, gpio); HAL_GPIO_WritePin(CS_PORT, CS_PIN, GPIO_PIN_SET);SPI 时钟频率这里给了 9MHz是很多 MCU 在默认时钟树下的一个安全值。如果系统主频更高可以把分频系数降下来跑到 18MHz 左右W5500 官方上限约为 33MHz。对测试工程来说 9MHz 和 18MHz 差异不大但如果你后面要做大数据量传输SPI 时钟直接决定吞吐上限。模式 0 和模式 3 都支持选定后不要随意切换否则读回的数据全是乱的。CS 引脚的控制要特别注意W5500 的一个完整 SPI 帧必须由 CS 低电平包住期间不能出现 CS 拉高的操作。如果用 HAL 库的 SPI 中断或 DMA 传输务必确认 CS 在整个传输期间保持低电平。很多翻车案例是 SPI 一字节一字节发送时库函数内部把 CS 拉高拉低了导致 W5500 认为每次只有一个字节的数据帧。3.3 编译、烧录、验证用 telnet 完成第一次 TCP 握手跑通最小 TCP 服务器是验证 W5500 链路最快的方法。烧录后先 ping 设备 IP通了再 telnet不要直接跳一步。以下是一个最简 TCP 回显服务端的 socket 逻辑uint8_t socket_no 0; uint8_t buf[256] {0}; // 打开 socket 0TCP 服务端模式监听 5000 端口 socket(socket_no, Sn_MR_TCP, 5000, 0); listen(socket_no); while (1) { if (getSn_SR(socket_no) SOCK_ESTABLISHED) { // 有客户端连入读数据并原样回发 int16_t len recv(socket_no, buf, sizeof(buf)); if (len 0) { send(socket_no, buf, len); } } else if (getSn_SR(socket_no) SOCK_CLOSED) { // 连接断开后必须重新 socket listen否则无法再次接入 close(socket_no); socket(socket_no, Sn_MR_TCP, 5000, 0); listen(socket_no); } }这里最容易漏的是连接断开后的“重新 socket listen”组合。如果只调用 listen 不重新 socketsocket 状态会一直停在 SOCK_CLOSED客户端再也连不进来必须复位 MCU 才能恢复。验证步骤PC 上把 IP 改成 192.168.1.x 网段先 ping 192.168.1.100通了之后在命令行执行telnet 192.168.1.100 5000连上后随便敲几个字符板子串口或调试器里能看到收到的数据。如果你用的系统没有 telnet 客户端也可以用网络调试助手效果一样。ping 不通就先检查网线连接和 IP 配置ping 通但 telnet 不通检查 socket 是否成功进入 LISTEN 状态以及防火墙是否拦截了 5000 端口。4. 必调的四组参数网关、端口、超时与缓冲区分配W5500 的寄存器配置直接决定网络行为测试工程能跑通不代表换到产品环境还能跑通。这一章列四组必调参数都是实际项目中反复踩过的坑。4.1 网关与子网掩码设错的典型翻车现象同网段直连时网关可以填 0.0.0.0但设备一旦需要跨网段访问服务器网关必须正确。典型翻车现象设备 IP 能 ping 通但设备主动连接外网服务器时一直超时。原因往往不是 W5500 坏了而是 GAR 寄存器里没有写入有效网关地址ARP 请求发不出去。这个问题的排查顺序先确认 PC 和设备在同一个网段比如设备是 192.168.1.100PC 就设 192.168.1.50再确认 W5500 的三个地址——GAR网关、SUBR子网掩码、SIPR本机 IP——都正确写入了。用调试器直接读这三个寄存器核对比在代码里反复检查 netinfo 结构体有效得多。子网掩码设错的表现更隐蔽设备能 ping 通但向局域网外发数据时没有反应。原因是 W5500 判断目的地址是否在同一网段时用掩码做与运算掩码错了就把所有地址都当成网外数据全扔给网关而网关可能根本不存在。测试阶段固定用 255.255.255.0别省事。4.2 端口绑定与 socket 重连逻辑本地端口建议固定不要传 0。W5500 的驱动里端口传 0 时行为依赖具体库版本有的会随机分配端口有的直接返回失败这会让调试变得不可控。测试工程里一般固定 5000 或 8080产品上如果多设备共存端口按设备 ID 或功能划分。socket 重连有个状态细节主动 close 之后socket 会进入 TIME-WAIT 状态此时立刻重新 socket 同一个端口大概率失败。可靠做法是 close 之后加一个延时约 2~3 秒或者直接换一个本地端口。下面这段代码演示了带状态判断的重连逻辑uint8_t sock_state getSn_SR(socket_no); if (sock_state SOCK_TIME_WAIT) { // TIME-WAIT 是主动断开后的状态等 2MSL 再复用端口 HAL_Delay(2000); close(socket_no); } else if (sock_state SOCK_CLOSED) { // 完全关闭后重新进入监听 socket(socket_no, Sn_MR_TCP, local_port, 0); listen(socket_no); }这里 close 之后延时 2000ms 是工程上的常用折中值W5500 的 TIME-WAIT 实际时长由 MSL 决定但嵌入式场景没必要做精确协议计时延时 2 秒后重新监听端口通常足够。如果你的产品对重连速度要求高更推荐换端口而不是等 TIME-WAIT 结束。4.3 超时参数的设置与掉线重连W5500 的重发超时和重试次数通过 RTR 和 RCR 两个寄存器控制驱动库封装成 setRetransmit 函数。RTR 单位是 100us默认值 0x07D0 对应 200msRCR 是重试次数默认 3 次。// 设置 TCP 重发超时 300ms重试 5 次 // RTR 300ms / 100us 3000 // RCR 5最多重发 5 次 setRetransmit(3000, 5);参数选择的经验网络环境差、Wi-Fi 桥接或有丢包时重发间隔长一点反而可靠300ms 到 500ms 是常见区间重试次数太少会导致短暂网络波动就把连接断了次数太多会在对端无响应时拖很久才报错。我一般先设 300ms、5 次跑稳定性测试发现频繁掉线再往大调发现连接失败要等太久再往小调。还有一个容易忽略的点ARP 超时。TCP 建立连接前要先解析对端 MAC 地址如果 ARP 缓存过期且网络中 ARP 响应慢第一次连接会明显卡顿甚至失败。W5500 的 ARP 相关寄存器不多常见的缓解方式是设备端做周期性 Ping 保活或者应用层主动建连前先发一个 ICMP 探测。在测试工程里保持默认即可产品上要留意这个细节。5. W5500 调试避坑5 个反复出现的问题与定位方法下面这五条是按出现频率排的每条都是现象 → 原因 → 解决的结构基本覆盖了从硬件到协议栈的常见故障面。5.1 读版本寄存器返回 0xFF 或 0x00现象调用读 VERSIONR 寄存器的函数返回值不是 0x04而是 0xFF 或 0x00SPI 通路直接失败。原因SPI 模式不匹配W5500 要求 Mode 0 或 Mode 3MCU 配成了其他模式或者 CS 没有包住整个 SPI 帧W5500 把每次字节传输都当成独立帧解析再或者 MISO 引脚虚焊数据根本读不回来。解决先用逻辑分析仪抓 SPI 波形确认 8 位控制字节加 16 位地址加 8 位数据的帧结构完整然后把 SPI 模式在 Mode 0 和 Mode 3 之间切换对比确认 CS 在整个帧期间保持低电平。读版本寄存器是最小的验证用例这个都过不了就不要往下调网络。5.2 网口灯亮但 ping 不通现象以太网口的 LINK 灯正常亮起但 PC 上 ping 设备 IP 没有任何响应。原因IP 配置没有真正写入芯片常见于调用了 wizchip_setnetinfo 但库内部没执行写入操作或者 MAC 地址全是 0x00芯片发出的 ARP 请求被对端丢弃也有可能是网线直连 PC 时 PC 侧 IP 还没配到同一网段。解决第一步直接读 SHAR、SIPR、GAR、SUBR 四个寄存器确认写入值与期望一致这一步能排除八成问题。第二步把 MAC 改成非全 0 的任意单播地址。第三步检查 PC 网卡的 IP 和掩码确保与设备在同一网段。如果上述都正确还不通换一根网线或换个交换机口再试PHY 自适应有时会出玄学问题。5.3 TCP 能连接但收不到完整数据现象telnet 能连上但给板子发数据后串口只有第一帧有输出后续数据全部丢失。原因接收缓冲区配置成了 0或者接收完成后没有向 Sn_CR 写入 RECV 命令。W5500 的接收流程是读取 Sn_RX_RSR 得到接收字节数从 RX 缓冲区读走数据最后必须写 Sn_CR 的 RECV 命令清标志芯片才会把新到的数据放进缓冲区。漏掉最后一步后续数据会被丢弃。解决检查 socket 的 RX 缓冲区大小是否为 0确认分配过缓冲区在 recv 返回后立即执行 Sn_CR 的 RECV 命令。注意读取 Sn_RX_RSR 时要用连续两次读取结果一致的机制先读高字节再读低字节否则多线程环境下可能读到中间状态值。5.4 主动断开后 socket 无法重新监听现象客户端主动断开后调用 close 加 listen 重新监听但客户端再也连不上socket 状态停在 SOCK_TIME_WAIT 或 SOCK_CLOSED。原因主动 close 后 W5500 会进入 TIME-WAIT这个状态下即使执行 close 和 listen驱动也可能没有真正释放端口或者重连逻辑没有判断当前 socket 状态在 TIME-WAIT 时直接执行了 socket 操作。解决在重连前先读取 Sn_SR根据状态分支处理。TIME-WAIT 状态延时 2 秒再 closeSOCK_CLOSED 状态才重新执行 socket 加 listen。这个逻辑前面第 4.2 节有完整代码直接套用即可。5.5 连接几秒后周期掉线现象TCP 连接建立后能通几秒然后断线过一会儿又自动连上反复循环。原因看门狗复位导致 MCU 重启socket 状态丢失或者 SPI 引脚被其他外设复用通信时序被中断再或者上电初始化时 PHY 还没完全就绪就开始了 socket 监听芯片内部状态异常。解决先用串口打印 MCU 复位标志寄存器确认是不是看门狗在复位。如果 SPI 引脚和调试串口复用调试时可能正常拔掉调试器就掉线。初始化上电后延时从 200ms 加到 500ms给 PHY 留足稳定时间。还有一种情况是电源纹波过大导致芯片偶发复位用示波器看 3.3V 波形掉电瞬间是否跌破 2.7V。6. 从能跑通到能上线几个值得加进去的小改动当测试工程能稳定跑完 TCP 回环后距离真正产品化还差几步。第一个改动是把轮询改成中断驱动W5500 的 DINTn 引脚在 socket 状态变化或数据到达时拉低接到 MCU 的外部中断脚可以避免主循环频繁查询 Sn_SR 寄存器。这样 CPU 占用率能明显下降在低主频 MCU 上尤其明显。第二个改动是收发缓冲区分区策略。测试工程默认 8 个 socket 平均分每 socket 各 2KB但如果产品只用 1 个 TCP 连接完全可以给 socket 0 分 TX 8KB、RX 8KB其余 socket 全部设 0。缓冲区分配越大单次能收发的数据量越大SPI 传输效率越高。注意修改后要重新调用 wizchip_setbufferinfo 并复位芯片。第三个改动是 SPI DMA。W5500 读写收发缓冲区动辄上百字节用轮询方式逐字节传输会卡死 CPU。常见做法是CS 拉低后用 SPI DMA 连续传输控制字节、地址和数据字段传输完成中断里再拉高 CS。这里有个容易踩的细节控制字节和地址字段可以先拼进一个发送数组再和接收数组一起启动 DMA避免 DMA 中途 CS 被释放。实测一般场景下 DMA 加 18MHz SPI 时钟可以把吞吐做到几百 KB/s 级别足够大多数物联网设备用。第四个改动是协议层设计。不要在 W5500 上直接跑复杂的 HTTP 解析先用回环测试把链路可靠性验证足够再叠加 MQTT 或自定义二进制协议。W5500 的优势是内核帮你处理了 TCP 状态机但应用层超时重传、心跳保活仍然要自己做。我会在心跳间隔和断线重连之间找一个平衡心跳太快浪费带宽太慢又可能被运营商或交换机回收连接一般 30 秒到 60 秒是一个比较稳妥的区间。最后说一个我的习惯每次拿到一块新的 W5500 板子不管是什么平台都从读版本寄存器 0x04 开始验证再到 ping再到 TCP 回环最后才动协议层。这个顺序帮我省了很多排查时间也避免了把 SPI 问题和网络问题混在一起。希望帮到你。本文还有配套的精品资源点击获取