当前位置：首页 > news >正文

STM32F103CBT6 + W5500：用官方库5分钟搞定TCP客户端连接（附网络调试助手配置）

news 2026/6/4 5:06:33

STM32F103CBT6与W5500的极简TCP通信实战指南

第一次拿到W5500模块和STM32开发板时，最让人兴奋的莫过于快速搭建起第一个TCP通信连接。本文将带你用最短的时间完成从硬件连接到数据收发的全过程，特别适合那些希望立即看到成果的嵌入式开发新手。

1. 硬件准备与连接

W5500作为一款集成了全硬件TCP/IP协议栈的以太网控制器，其最大优势在于8个独立硬件Socket的设计，能够实现多路互不干扰的网络通信。与STM32F103CBT6的配合使用，可以快速构建嵌入式网络应用。

关键引脚连接清单：

SPI接口：
- W5500的MISO → STM32的PA6(SPI1_MISO)
- W5500的MOSI → STM32的PA7(SPI1_MOSI)
- W5500的SCLK → STM32的PA5(SPI1_SCK)
- W5500的SCS → STM32的PA4(自定义GPIO)
控制信号：
- W5500的RSTn → STM32的复位电路或可控GPIO
- W5500的INTn → STM32的外部中断引脚(可选)

提示：确保所有电源引脚(3.3V)和地线(GND)正确连接，这是最容易被忽视却导致各种异常的问题根源。

2. STM32 SPI配置要点

SPI作为W5500与STM32之间的通信桥梁，其配置直接影响网络通信的稳定性。以下是基于STM32标准外设库的核心配置代码：

void SPI1_Init(void) { SPI_InitTypeDef SPI_InitStructure; // 启用SPI1时钟 RCC_APB2PeriphClockCmd(RCC_APB2Periph_SPI1, ENABLE); // SPI参数配置 SPI_InitStructure.SPI_Direction = SPI_Direction_2Lines_FullDuplex; SPI_InitStructure.SPI_Mode = SPI_Mode_Master; SPI_InitStructure.SPI_DataSize = SPI_DataSize_8b; SPI_InitStructure.SPI_CPOL = SPI_CPOL_Low; SPI_InitStructure.SPI_CPHA = SPI_CPHA_1Edge; SPI_InitStructure.SPI_NSS = SPI_NSS_Soft; SPI_InitStructure.SPI_BaudRatePrescaler = SPI_BaudRatePrescaler_2; SPI_InitStructure.SPI_FirstBit = SPI_FirstBit_MSB; SPI_InitStructure.SPI_CRCPolynomial = 7; SPI_Init(SPI1, &SPI_InitStructure); SPI_Cmd(SPI1, ENABLE); }

关键参数解析：

参数	设置值	意义
SPI_Mode	Master	STM32作为主设备
DataSize	8b	每次传输8位数据
CPOL	Low	时钟空闲时为低电平
CPHA	1Edge	数据在第一个时钟边沿采样
BaudRatePrescaler	2	系统时钟2分频

3. 网络环境搭建

为了简化测试环境，推荐使用直连电脑的方式。这种方法避免了路由器的复杂配置，特别适合快速验证阶段。

电脑端网络配置步骤：

使用交叉网线连接开发板和电脑网口
进入"网络和共享中心" → "更改适配器设置"
右键点击对应网卡 → "属性" → 双击"Internet协议版本4(TCP/IPv4)"
设置固定IP地址，例如：
- IP地址：192.168.1.100
- 子网掩码：255.255.255.0
- 默认网关：可不填

网络调试助手配置：

运行网络调试工具（如TCP&UDP测试工具）
创建TCP服务器，监听端口设为8080
确保选择的本地IP地址与之前设置的固定IP一致

4. W5500官方库关键API实战

W5500官方驱动库提供了简洁的Socket接口，以下是TCP客户端开发中最核心的五个函数及其典型用法。

4.1 Socket初始化与连接

// 定义服务器信息 #define DEST_IP {192,168,1,100} // 目标IP地址 #define DEST_PORT 8080 // 目标端口 uint8_t socket_init(void) { uint8_t sock_status = 0; uint8_t dest_ip[4] = DEST_IP; // 初始化W5500硬件 W5500_Init(); // 配置网络参数 setSHAR(mac); // 设置MAC地址 setSIPR(local_ip); // 设置本地IP setSUBR(subnet); // 设置子网掩码 setGAR(gateway); // 设置网关 // 创建Socket socket(0, Sn_MR_TCP, 0, 0); // 连接服务器 if(connect(0, dest_ip, DEST_PORT)) { sock_status = 1; printf("Connected to server!\r\n"); } return sock_status; }

4.2 数据发送与接收

数据收发是网络通信的核心功能，下面展示一个完整的发送接收流程：

void tcp_communication(void) { uint8_t send_buf[] = "Hello from STM32!"; uint8_t recv_buf[100]; uint16_t len; // 发送数据 send(0, (uint8_t *)send_buf, strlen((char *)send_buf)); // 接收数据 len = getSn_RX_RSR(0); // 获取接收缓冲区大小 if(len > 0) { recv(0, recv_buf, len); recv_buf[len] = '\0'; // 添加字符串结束符 printf("Received: %s\r\n", recv_buf); } }

4.3 连接状态监测

稳定的网络通信需要持续监测连接状态：

uint8_t check_connection(void) { uint8_t status = getSn_SR(0); switch(status) { case SOCK_ESTABLISHED: return 1; // 连接正常 case SOCK_CLOSE_WAIT: case SOCK_CLOSED: close(0); // 关闭Socket return 0; default: return 0; } }