W5500入门级项目：实现TCP客户端连接

用W5500实现TCP客户端：从零开始的嵌入式以太网实战

你有没有遇到过这样的场景？手头是一个资源有限的STM32F103，却需要把传感器数据稳定上传到服务器。如果用软件协议栈（比如LwIP），CPU占用飙升、内存告急；可要是换高性能MCU，成本又压不住。这时候，W5500就像一个“外挂大脑”——它把整个TCP/IP协议栈都封装进芯片里，只让主控MCU负责发指令和收发数据。

今天我们就来实打实地走一遍：如何用W5500作为TCP客户端，连接远端服务器并完成数据交互。不讲虚的，只聚焦你能立刻上手的关键步骤、寄存器操作逻辑以及那些手册不会明说但新手必踩的坑。

W5500 是什么？为什么选它做联网？

先别急着写代码。我们得明白，W5500不是普通的PHY芯片，也不是Wi-Fi模块那种黑盒方案。它的定位很特别：为普通单片机提供硬件级网络能力。

核心优势一句话概括：

协议处理全靠它，MCU只管读写SPI。

这意味着：

• TCP三次握手、重传机制、窗口管理……全部由W5500内部状态机自动完成；
• 主控不需要跑RTOS或协议任务，哪怕裸机循环也能搞定联网；
• 内存占用极低，Flash几乎不增加，RAM仅用于缓存应用层数据。

这在工业控制、远程终端、智能电表等对稳定性要求高、主控资源紧张的应用中，简直是救星。

它到底能干什么？

支持UDP、TCP、ICMP、ARP、PPPoE等多种协议，其中最常用的就是TCP客户端/服务器模式。本文重点讲前者——也就是你的设备主动去连一台固定IP的服务器，比如本地网关或者云主机。

硬件怎么接？这些细节决定成败

再好的软件也架不住硬件翻车。下面是W5500典型应用电路中最容易出问题的几个点：

RJ45接口要带网络变压器（如HR911105A），直连普通网口可能协商失败。另外，电源去耦不可省：每个VDD-GND之间放一个0.1μF陶瓷电容，最好再并一个10μF钽电容滤低频噪声。

第一步：建立SPI通信 —— 和W5500“对话”的前提

W5500通过SPI与MCU通信，采用命令+地址+数据三段式传输格式。例如读寄存器的操作序列是：

CS=0 → [0x0F] ← [data] ↑ 读控制码（bit7=0表示读）

所以你需要先确保SPI能正常读取W5500的ID寄存器（MR，地址0x0000）。这是判断硬件是否连通的第一步。

STM32 HAL示例初始化（SPI1为主机）

SPI_HandleTypeDef hspi1; void MX_SPI1_Init(void) { hspi1.Instance = SPI1; hspi1.Init.Mode = SPI_MODE_MASTER; hspi1.Init.Direction = SPI_DIRECTION_2LINES; hspi1.Init.DataSize = SPI_DATASIZE_8BIT; hspi1.Init.CLKPolarity = SPI_POLARITY_LOW; // CPOL=0 hspi1.Init.CLKPhase = SPI_PHASE_1EDGE; // CPHA=0 → 模式0 hspi1.Init.NSS = SPI_NSS_SOFT; hspi1.Init.BaudRatePrescaler = SPI_BAUDRATEPRESCALER_4; // APB2=80MHz → SCLK=20MHz hspi1.Init.FirstBit = SPI_FIRSTBIT_MSB; HAL_SPI_Init(&hspi1); }

✅ 提示：首次调试建议将波特率设为更低值（如分频16），排除高速下的信号完整性问题。

有了这个基础，接下来就可以封装两个核心函数：

uint8_t wiz_read_reg(uint16_t addr); void wiz_write_reg(uint16_t addr, uint8_t value);

这两个函数就是你操控W5500的“遥控器”。

初始化流程：四步走稳，才能谈连接

很多初学者一上来就想连服务器，结果卡在第一步。记住：必须按顺序完成系统级初始化，否则Socket操作全是无效的。

步骤1：软复位W5500

读取模式寄存器（MR），检查bit7是否为1。如果是，说明芯片处于复位状态，需手动清零激活。

uint8_t mr = wiz_read_reg(0x0000); if (mr & 0x80) { wiz_write_reg(0x0000, 0x80); // 写1触发复位 HAL_Delay(10); wiz_write_reg(0x0000, 0x00); // 清零退出复位 }

⚠️ 注意：有些开发板硬复位后仍需执行此步，别跳过！

步骤2：设置本地网络参数

包括MAC、IP、子网掩码、网关。这些信息对应四个关键寄存器：

示例代码：

uint8_t mac[6] = {0x00, 0x08, 0xDC, 0x1A, 0x2B, 0x3C}; uint8_t ip[4] = {192, 168, 1, 100}; uint8_t gw[4] = {192, 168, 1, 1}; uint8_t sn[4] = {255, 255, 255, 0}; for (int i = 0; i < 6; i++) wiz_write_reg(0x0009 + i, mac[i]); for (int i = 0; i < 4; i++) { wiz_write_reg(0x000F + i, ip[i]); wiz_write_reg(0x0001 + i, gw[i]); wiz_write_reg(0x0005 + i, sn[i]); }

🔍 小技巧：可以用ping 192.168.1.100测试是否能收到ARP响应，验证IP配置生效。

Socket配置：真正的“连接发起者”

W5500支持8个独立Socket（S0~S7），每个都可以独立工作。我们要用Socket0作为TCP客户端。

Step 1: 关闭Socket并设为TCP模式

wiz_write_reg(S0_CR, CR_CLOSE); // 先关闭 HAL_Delay(1); wiz_write_reg(S0_MR, MR_TCP); // 设置为TCP

这里S0_CR是命令寄存器，CR_CLOSE是关闭命令（值为0x10）。一定要先关再配，避免状态混乱。

Step 2: 配置目标服务器地址

假设你要连接192.168.1.50:8080：

uint8_t dest_ip[4] = {192, 168, 1, 50}; uint16_t dest_port = 8080; // 写目标IP for (int i = 0; i < 4; i++) { wiz_write_reg(S0_DIPR + i, dest_ip[i]); // S0_DIPR = 0x000C } // 写目标端口（注意字节序！） wiz_write_reg(S0_DPORT, (dest_port >> 8) & 0xFF); wiz_write_reg(S0_DPORT + 1, dest_port & 0xFF);

❗重要提醒：W5500寄存器是大端存储，所有多字节字段都要注意字节序转换。可以用宏HTONS()辅助。

Step 3: 发起连接！

wiz_write_reg(S0_CR, CR_CONNECT); // 写命令：0x04

这一行代码下去，W5500就会自动向目标发送SYN包，进入TCP连接流程。

如何知道连上了？状态机才是关键

很多人以为写了CR_CONNECT就完事了，其实后面的状态轮询才是成败所在。

W5500内部维护了一个TCP状态机，你可以通过读取S0_SR（Socket Status Register）来查看当前状态：

正确的等待逻辑如下：

while (1) { uint8_t status = wiz_read_reg(S0_SR); switch(status) { case SOCK_ESTABLISHED: printf("🎉 TCP连接成功建立！\n"); return 0; // 成功返回 case SOCK_CLOSED: printf("❌ 连接失败，请检查目标IP是否可达\n"); return -1; default: HAL_Delay(100); // 避免频繁查询 continue; } }

💡 经验之谈：若长时间停留在SYN_SENT，大概率是目标服务器没开对应端口，或者防火墙拦截。

数据怎么发？别忘了“缓冲区+命令”双操作

你以为调个send函数就行？在W5500的世界里，数据写入和命令触发是分开的两步。

发送流程详解：

1. 查询Tx缓冲区剩余空间：
   c uint16_t free_size = getSn_TX_FSR(0); // 实际是读两个寄存器拼成16位 if (free_size < data_len) { // 等待或丢弃 }

2. 将数据写入Tx缓冲区（通过SPI写特定地址区域）：
   ```c
   void wiz_send_data(uint8_t s, uint8_t *buf, uint16_t len) {
   uint16_t ptr = wiz_read_reg(S0_TX_WR); // 当前写指针
   uint16_t offset = ptr & 0x07FF; // 取低11位（32KB空间寻址）
   uint16_t dst_addr = 0x8000 + (s << 13) + offset; // Tx Buffer Base + Socket偏移

   for (int i = 0; i < len; i++) {
   wiz_write_buf(dst_addr + i, buf[i]); // 自定义写函数
   }

   ptr += len;
   wiz_write_reg(S0_TX_WR, ptr); // 更新写指针
   }
   ```

3. 触发SEND命令：
   c wiz_write_reg(S0_CR, CR_SEND);

4. 等待发送完成（中断或轮询Sn_IR中的SEND_OK标志）：
   c while (!(wiz_read_reg(S0_IR) & IR_SEND_OK)) { HAL_Delay(10); } wiz_write_reg(S0_IR, IR_SEND_OK); // 清除标志

📌 关键点：不更新写指针会导致下次发送错位；不清除中断会造成后续事件漏检。

数据接收：被动也要主动轮询

接收相对简单，但要注意两点：

1. 数据到达会触发IR_RECV中断（如果你启用了中断功能）；
2. 收到后必须发出RECV命令确认，否则不会再收新数据。

基本流程：

if (wiz_read_reg(S0_IR) & IR_RECV) { wiz_write_reg(S0_IR, IR_RECV); // 清标志 int size = getSn_RX_RSR(0); // 获取接收大小 if (size > 0) { wiz_recv_data(0, rx_buf, size); // 从Rx Buffer读数据 wiz_write_reg(S0_CR, CR_RECV); // 回复RECV命令 } }

这里的wiz_recv_data函数类似发送，只是从Rx Buffer地址读取数据，并更新读指针S0_RX_RD。

实战建议：让你的项目更健壮

光能连上还不够，实际工程要考虑更多边界情况。

✅ 必做的五件事：

1. 添加重试机制
   c for (int retry = 0; retry < 3; retry++) { if (tcp_connect() == 0) break; HAL_Delay(2000); }

2. 监控异常中断
   监听Sn_IR中的TIMEOUT、DISCON、FIN_WAIT等事件，及时处理断链。

3. 合理分配缓冲区
   默认Tx/Rx各2KB per socket，可通过SIMR和RXMEMR/TXMEMR寄存器调整。例如发送频繁可设为Tx=4KB, Rx=0KB（共32KB总缓存）。

4. 使用DHCP（可选）
   若部署环境IP不确定，可用WIZnet官方DHCP库动态获取IP，比静态配置更灵活。

5. 加入心跳保活
   每隔30秒发一次心跳包，防止NAT超时断开。

常见问题与避坑指南

结语：掌握它，你就掌握了嵌入式联网的“捷径”

W5500不是一个炫技的芯片，而是一个务实的选择。当你面对一个GD32或STM32小核，又要实现稳定TCP上传时，它提供的不只是功能，更是确定性——你知道每一次连接的背后没有任务调度抖动、没有内存泄漏风险、也没有协议栈崩溃的隐患。

这篇文章带你从硬件连接、SPI通信、寄存器配置到完整TCP客户端流程走了一遍。你现在完全可以基于这套框架，扩展出自己的温湿度上传、远程控制、固件升级等功能。

下一步可以尝试：
- 多Socket并发连接不同服务器；
- 实现HTTP客户端请求JSON接口；
- 结合MQTT over TCP接入物联网平台。

如果你在实现过程中遇到了其他挑战，欢迎在评论区分享讨论。毕竟，每一个成功的联网背后，都有无数次ping不通的日志。