1. W5500：你的嵌入式设备联网“外挂”
如果你正在做一个智能家居的温湿度监测器，或者一个工业现场的传感器数据采集盒，想让它们的数据能通过网络传到你的电脑或手机App上，你可能会头疼：我的单片机（MCU）性能有限，跑个复杂的TCP/IP网络协议栈太吃力了，内存和CPU都捉襟见肘。这时候，W5500这颗芯片就像给你的设备装了一个“网络外挂”，它把联网这件事，从需要MCU“亲自下场”的软件活，变成了一个硬件模块“包办”的轻松事。
简单来说，W5500是一款全硬件TCP/IP协议栈的以太网控制器。这句话是它的核心价值。什么叫“全硬件协议栈”？你可以把它想象成一个专门处理网络协议的“协处理器”。传统上，我们要在MCU里运行像LWIP这样的软件协议栈来处理TCP连接、数据包封装、ARP请求等一堆复杂事务，这非常消耗MCU的资源和精力。而W5500把这些网络协议的处理逻辑，全部用硬件电路实现了。你的MCU只需要通过一个简单的SPI接口，像读写普通外设寄存器一样，告诉W5500“建立连接”、“发送数据”、“接收数据”就行了，具体怎么握手、怎么分包、怎么重传，W5500自己全搞定。
这带来的好处是显而易见的。首先，极大地减轻了MCU的负担，一个主频几十兆的Cortex-M0也能轻松处理高速网络数据。其次，连接稳定可靠，硬件实现的协议栈不受软件中断、任务调度的影响，响应更及时，抗干扰能力也更强。最后，开发极其简单，你不需要去啃厚厚的TCP/IP协议RFC文档，厂家提供的ioLibrary库已经把底层操作封装好了，你调用几个API函数就能完成网络通信。
W5500内部集成了MAC（媒体访问控制层）和PHY（物理层），也就是说，你只需要给它接上一个网络变压器和RJ45网口，它就能直接插网线了。它支持10M/100M自适应、全双工/半双工自动协商，最高SPI通信速率能达到80MHz，数据传输速度非常快。最厉害的是，它内部有8个独立的硬件Socket，你可以理解为8个独立的网络通信通道。这意味着你的设备可以同时作为TCP服务器，接受最多8个客户端的连接，或者同时创建多个TCP/UDP连接，而且这8个通道互不干扰，性能有保障。
2. 高速SPI通信：与W5500对话的“语言”
要让MCU和W5500协同工作，第一步就是建立通信。它们之间通过标准的4线SPI（串行外设接口）进行对话。SPI是一种高速、全双工的同步通信总线，理解它的配置是成功驱动W5500的关键。
2.1 SPI模式与速率：说对方能听懂的话
SPI通信有四种模式（Mode 0, 1, 2, 3），区别在于时钟极性（CPOL）和时钟相位（CPHA）的不同组合。你可以把CPOL理解为时钟线在空闲时的状态（0为低电平，1为高电平），把CPHA理解为数据在时钟的哪个边沿被采样（第一个边沿或第二个边沿）。W5500只支持模式0（CPOL=0， CPHA=0）和模式3（CPOL=1， CPHA=1）。这两种模式有一个共同点：数据都在时钟的上升沿被采样（锁存）。这是通信成功的前提，如果模式设错，双方就“鸡同鸭讲”，根本收不到正确数据。
在实际项目中，我强烈建议你优先使用模式0，因为这是最常用、兼容性最好的模式。大部分MCU的SPI外设例程默认也是模式0，不容易出错。配置时，你只需要在MCU的SPI初始化代码里，将CPOL和CPHA都设为0即可。
另一个关键参数是SPI时钟速率。W5500最高支持80MHz，但这取决于你的MCU SPI主控制器能跑多快，以及PCB布线的质量。对于常见的STM32F103系列（主频72MHz），其SPI时钟通常可以配置到系统时钟的一半，即36MHz。这个速度对于大多数应用已经绰绰有余。我实测过，在36MHz下进行大数据量传输非常稳定。如果你想追求极限速度，可以尝试配置到更高的分频系数，但务必注意，过高的速率可能导致信号完整性变差，如果PCB走线过长或干扰较大，反而容易出错。一个稳妥的做法是，先从较低速率（如9MHz或18MHz）开始调试，通信稳定后再逐步提高速率。
2.2 硬件连接与驱动函数实现
硬件连接非常简单，就是四根线：
- SCLK（串行时钟）：由MCU主机产生，用于同步数据。
- MOSI（主机输出，从机输入）：MCU通过这根线向W5500发送数据。
- MISO（主机输入，从机输出）：MCU通过这根线从W5500读取数据。
- CS（片选）：MCU通过拉低这根线来选中W5500，开始一次通信。通常接MCU的一个普通GPIO口。
除了这四根线，别忘了给W5500提供稳定的3.3V电源和良好的接地，复位引脚也需要正确处理。
在软件层面，我们需要为ioLibrary库提供几个最底层的驱动函数。这些函数是库与硬件之间的桥梁。以STM32的标准外设库为例，你需要实现以下五个函数：
// 1. SPI读一个字节 uint8_t SPI_ReadByte(void) { // 发送一个虚拟字节（如0xFF）以产生时钟，同时读取MISO上的数据 while (SPI_I2S_GetFlagStatus(SPI2, SPI_I2S_FLAG_TXE) == RESET); // 等待发送缓冲区空 SPI_I2S_SendData(SPI2, 0xFF); // 写入一个数据，触发时钟 while (SPI_I2S_GetFlagStatus(SPI2, SPI_I2S_FLAG_RXNE) == RESET); // 等待接收完成 return SPI_I2S_ReceiveData(SPI2); // 返回收到的数据 } // 2. SPI写一个字节 void SPI_WriteByte(uint8_t TxData) { while (SPI_I2S_GetFlagStatus(SPI2, SPI_I2S_FLAG_TXE) == RESET); SPI_I2S_SendData(SPI2, TxData); // 直接发送数据 while (SPI_I2S_GetFlagStatus(SPI2, SPI_I2S_FLAG_RXNE) == RESET); // 发送的同时也会接收，需要清空缓冲区 SPI_I2S_ReceiveData(SPI2); } // 3. 片选拉低（选中W5500） void SPI_CS_Select(void) { GPIO_ResetBits(GPIOB, GPIO_Pin_12); // 假设CS接在PB12上 } // 4. 片选拉高（取消选中） void SPI_CS_Deselect(void) { GPIO_SetBits(GPIOB, GPIO_Pin_12); } // 5. 进入临界区（关闭全局中断） void SPI_CrisEnter(void) { __disable_irq(); // 防止SPI通信过程被中断打断 } // 6. 退出临界区（开启全局中断） void SPI_CrisExit(void) { __enable_irq(); }这里有个细节需要注意：SPI_ReadByte函数里为什么要发送一个0xFF？因为在SPI的全双工模式下，读和写是同时进行的。主设备必须产生时钟信号，从设备才会在MISO线上输出数据。发送一个无意义的0xFF（或任何值），目的就是为了产生8个时钟脉冲，从而把从设备的数据“挤”出来。SPI_WriteByte函数里最后也读了一下数据寄存器，是为了清空接收标志位，保持SPI状态机的正常。
3. ioLibrary库移植：站在巨人的肩膀上
官方提供的ioLibrary库是开发W5500的利器，它把芯片所有寄存器操作、Socket管理、数据收发都封装成了清晰的API。我们的工作不是从头造轮子，而是把这个库“请”到我们的工程里，并告诉它如何操作我们的硬件。
3.1 库文件结构与核心配置
从WIZnet官网或GitHub下载ioLibrary库后，你会发现里面文件夹不少。对于快速实现TCP通信，我们主要关注Ethernet目录。关键文件就这几个：
wizchip_conf.c/.h：芯片配置核心，你需要在这里注册我们上面实现的那些SPI驱动函数。socket.c/.h：Socket API实现，我们创建服务器、收发数据主要用这里的函数。w5500.c/.h：W5500芯片的底层寄存器定义和基础操作。
移植的第一步，就是把这三个.c文件添加到你的MDK、IAR或者Makefile的编译列表里，并把对应的头文件路径设置好。
接下来是最关键的一步：注册回调函数。在main函数初始化阶段，在调用任何网络功能之前，必须用下面这行代码，把我们自己写的SPI读写、片选、临界区函数“告诉”ioLibrary库：
#include "wizchip_conf.h" int main(void) { // ... 你的系统时钟、GPIO、SPI、串口初始化代码 ... // 注册底层驱动函数 reg_wizchip_cris_cbfunc(SPI_CrisEnter, SPI_CrisExit); // 注册临界区函数 reg_wizchip_cs_cbfunc(SPI_CS_Select, SPI_CS_Deselect); // 注册片选函数 reg_wizchip_spi_cbfunc(SPI_ReadByte, SPI_WriteByte); // 注册SPI读写函数 // ... 后续网络初始化代码 ... }这个过程就像给库装上了“手”和“脚”，它现在知道如何去操作你的硬件SPI了。我遇到过有人移植后通信失败，十有八九是这一步忘了做，或者函数指针注册错了。
3.2 网络信息配置与芯片初始化
函数注册好后，就可以初始化W5500芯片了。首先需要定义你的网络参数，是使用静态IP还是动态获取（DHCP）。对于简单的局域网测试，用静态IP最直接。
// 定义网络信息结构体 wiz_NetInfo gWIZNETINFO = { .mac = {0x00, 0x08, 0xDC, 0x00, 0xAB, 0xCD}, // MAC地址，局域网内唯一即可 .ip = {192, 168, 1, 200}, // 静态IP地址 .sn = {255, 255, 255, 0}, // 子网掩码 .gw = {192, 168, 1, 1}, // 网关（如果只在局域网通信，可设为自身IP） .dns = {8, 8, 8, 8}, // DNS服务器（局域网通信可忽略） .dhcp = NETINFO_STATIC // 使用静态IP };然后，调用库函数进行初始化：
uint8_t memsize[2] = {2, 2}; // 定义每个Socket的发送和接收缓冲区大小，单位是KB。{2,2}表示各2KB。 // 1. 初始化W5500芯片，并设置缓冲区 if(ctlwizchip(CW_INIT_WIZCHIP, (void*)memsize) == -1) { printf("WIZCHIP Initialized fail.\r\n"); while(1); // 初始化失败，死循环 } // 2. 配置网络参数 ctlnetwork(CN_SET_NETINFO, (void*)&gWIZNETINFO); // 3. （可选）检查物理链路（网线是否插好） uint8_t phy_link; do { if(ctlwizchip(CW_GET_PHYLINK, (void*)&phy_link) == -1) { printf("Unknown PHY Link status.\r\n"); } } while(phy_link == PHY_LINK_OFF); // 等待网线连接 printf("PHY Link is up.\r\n");这里的memsize数组很重要，它决定了W5500内部那32KB内存如何分配给8个Socket。{2, 2}表示每个Socket有2KB发送缓存和2KB接收缓存。如果你的应用只有一个Socket进行大数据传输，可以将其改为{16, 16}，把大部分内存都分配给Socket 0，其他Socket分配0KB。这需要根据你的实际应用场景灵活调整。
4. 构建TCP服务器：从监听端口到数据回环
一切准备就绪，现在我们来创建一个最经典的TCP回环服务器。它的功能很简单：监听一个端口，接受客户端的连接，客户端发来任何数据，服务器都原封不动地发回去。这是测试网络连通性和基本功能最有效的方法。
4.1 Socket状态机与编程模型
W5500的Socket编程遵循一个清晰的状态机模型，理解这个模型是写出稳定服务器程序的关键。一个TCP Socket的生命周期通常包括以下几个状态：
- SOCK_CLOSED：初始关闭状态。
- SOCK_INIT：调用
socket()函数后，Socket被创建并进入初始化状态。 - SOCK_LISTEN：调用
listen()函数后，进入监听状态，等待客户端连接。 - SOCK_ESTABLISHED：客户端连接成功，进入已建立连接状态，可以收发数据。
- SOCK_CLOSE_WAIT：对方发起关闭，进入关闭等待状态，我方还可以发送剩余数据。
- SOCK_CLOSED：调用
close()函数后，回到关闭状态。
我们的服务器程序，就是在一个循环里，不断地检查Socket的状态，并根据状态执行相应的操作。下面是一个典型的实现框架：
#define SOCKET_PORT 5000 // 定义服务器监听端口 #define DATA_BUF_SIZE 2048 // 定义数据缓冲区大小 int32_t loopback_tcps(uint8_t sn, uint8_t* buf, uint16_t port) { int32_t ret; uint16_t size = 0, sentsize = 0; switch(getSn_SR(sn)) { // 获取当前Socket的状态 case SOCK_CLOSED: // 状态：关闭 -> 创建Socket并绑定端口 printf("Socket %d: Creating and opening...\r\n", sn); if((ret = socket(sn, Sn_MR_TCP, port, 0x00)) != sn) { printf("Socket open failed! Error: %ld\r\n", ret); return ret; } printf("Socket %d: Opened, start listening on port %d\r\n", sn, port); break; case SOCK_INIT: // 状态：已创建 -> 开始监听 printf("Socket %d: Start listening...\r\n", sn); if((ret = listen(sn)) != SOCK_OK) { printf("Listen failed! Error: %ld\r\n", ret); return ret; } break; case SOCK_ESTABLISHED: // 状态：连接已建立 -> 处理数据收发 // 检查是否有新的连接事件（可打印日志） if(getSn_IR(sn) & Sn_IR_CON) { printf("Socket %d: A new client connected.\r\n", sn); setSn_IR(sn, Sn_IR_CON); // 清除连接中断标志 } // 检查接收缓冲区是否有数据 if((size = getSn_RX_RSR(sn)) > 0) { // 确保要读取的数据不超过我们的缓冲区大小 if(size > DATA_BUF_SIZE) size = DATA_BUF_SIZE; // 读取数据 ret = recv(sn, buf, size); if(ret <= 0) { // 接收出错，关闭Socket close(sn); return ret; } // 将接收到的数据原样发回（回环） sentsize = 0; while(size != sentsize) { ret = send(sn, buf + sentsize, size - sentsize); if(ret < 0) { close(sn); return ret; } sentsize += ret; // 累加已发送的字节数 } // 可选：将收到的数据通过串口打印出来，方便调试 buf[size] = '\0'; // 添加字符串结束符 printf("Received and echoed: %s\r\n", buf); } break; case SOCK_CLOSE_WAIT: // 状态：对方请求关闭 -> 我方也关闭连接 printf("Socket %d: Peer closed connection, closing...\r\n", sn); if((ret = disconnect(sn)) != SOCK_OK) { return ret; } // 断开连接后，Socket会回到SOCK_CLOSED状态，等待下一次创建 break; default: // 其他状态，暂时不处理 break; } return 1; // 正常返回 }在主循环中，你只需要定期（例如每10毫秒）调用这个loopback_tcps函数，并传入Socket编号（0~7）、数据缓冲区和端口号即可。这个函数会自己管理Socket的整个生命周期。
4.2 实战调试与连通性测试
代码写好了，怎么验证它真的在工作呢？你需要一个TCP客户端来连接你的设备。这里我推荐使用电脑上的“网络调试助手”或者“SocketTool”这类软件，它们非常直观。
第一步：硬件连接。用一根网线，一端连接你的W5500模块，另一端直接连接到你的电脑网口。如果你的电脑没有有线网口，可以使用USB转以太网适配器。
第二步：配置IP地址在同一网段。因为我们的程序设置了静态IP192.168.1.200，子网掩码255.255.255.0。所以我们需要把电脑的本地连接也设置为同一网段的静态IP，比如192.168.1.199。记住要关闭电脑这个网卡的DHCP功能，否则它可能会自动获取到别的IP。
第三步：运行程序并观察串口。给设备上电，打开串口调试助手。你应该能看到类似这样的打印信息：
PHY Link is up. Socket 0: Creating and opening... Socket 0: Opened, start listening on port 5000 Socket 0: Start listening...这说明W5500硬件初始化成功，网络链路已通，并且Socket 0已经在5000端口进入监听状态。
第四步：使用客户端连接。打开网络调试助手，选择“TCP Client”模式，服务器地址填写192.168.1.200，端口填5000，点击连接。如果一切正常，串口会打印Socket 0: A new client connected.。此时，你在网络调试助手的发送框输入“Hello W5500!”，点击发送，你会立刻在接收框看到相同的“Hello W5500!”被回传回来。同时，串口也会打印出Received and echoed: Hello W5500!。
恭喜你！至此，一个基于W5500和ioLibrary库的TCP回环服务器就成功搭建并运行起来了。这个过程看似步骤不少，但一旦跑通，你就会发现它比用软件协议栈要简单和稳定得多。这个服务器框架是许多物联网应用的基础，你可以在此基础上，修改SOCK_ESTABLISHED状态下的数据处理逻辑，来实现你自己的协议，比如解析HTTP请求、处理Modbus TCP指令，或者转发传感器数据。W5500的8个独立Socket，让你甚至可以轻松实现一个多客户端并发的小型服务器，为你的嵌入式设备打开网络世界的大门。
