基于 WS8712x-C5 与 STM32F407 的Wi-Fi 无线图传系统设计与实现
无线通信 WS8712x-C5 · Wi-Fi STA / TCP | 主控平台 STM32F407VET6 · 168 MHz |
显示终端 ST7789 · 1.47 英寸 · 320 × 172 | 图像格式 RGB565 · 110,080 Bytes / 全屏 |

实机硬件平台与无线图片显示效果
本次成果摘要 完成 PC → Wi-Fi → WS8712x-C5 TCP Server → STM32F407 → ST7789 的端到端图像传输验证。320×172 RGB565 全屏数据量为 110,080 Bytes,分包传输后完成 CRC32 校验;同时完成 TCP 文本接收及 1~10 数字局部刷新演示。 |
第一篇开箱与过程贴主要完成了 WS8712x-C5 开发板的初步认识、硬件连接及 AT 指令基础验证。本篇作为成果篇,重点展示在此基础上完成的无线图像传输与显示应用。
系统以 PC 上位机作为图像发送端,WS8712x-C5 负责 Wi-Fi 联网及 TCP 数据通信,STM32F407VET6 负责串口数据接收、应用层协议解析、数据校验与显示控制,最终通过 SPI 驱动 ST7789 TFT 显示图片。
1.1 已完成的功能
· WS8712x-C5 AT 指令自检、Wi-Fi STA 联网及 DHCP 地址获取。
· 配置 TCP Server,并通过 PC 客户端建立局域网 TCP 连接。
· PC 到 STM32 的 TCP 文本数据接收验证,测试消息为 HELLO PixelLink(17 Bytes)。
· 320×172 RGB565 图片分包传输,单张全屏图片数据量 110,080 Bytes,共 588 个数据包。
· 应用层逐包 CRC16 校验、PLKACK 确认,以及整图 CRC32 完整性校验。
· 1~10 数字控制消息及 LCD 局部区域刷新;退出演示后恢复 PixelLink Logo。
1.2 本次测试关键结果
项目 | 实测结果 | 说明 |
Wi-Fi STA IP | 192.168.0.105 | 网关 192.168.0.1,掩码 255.255.255.0 |
TCP Server | 192.168.0.105:8888 | 配置读回确认 |
文本接收 | 17 Bytes | HELLO PixelLink |
全屏图像 | 320 × 172 | RGB565,110,080 Bytes |
分包数量 | 588 包 | 上位机传输日志记录 |
整图校验 | CRC32 = 3061B125 | STM32 完成日志确认 |
接收状态 | tcp_oversize = 0 | 本次最终状态日志 |
测试边界说明 本次成果验证聚焦 AT 控制、Wi-Fi/TCP 通信和应用层无线图传,不等同于 Wi-Fi 6 峰值吞吐、覆盖距离、功耗或 Bluetooth 性能测试。 |
2.1 硬件组成
硬件模块 | 在系统中的职责 | 关键说明 |
WS8712x-C5 开发板 | 无线网络接入及 TCP 通信 | 使用 AT 固件;STA 模式接入局域网 |
STM32F407VET6 | 系统主控及协议处理 | SYSCLK / HCLK 实测 168 MHz |
ST7789 TFT | 图片与数字显示 | 1.47 英寸,逻辑分辨率 320×172 |
PC 上位机 | 图像预处理及数据发送 | 图片裁剪/缩放、RGB565 转换、分包、等待 ACK |
2.2 主要接口连接
接口 | STM32 引脚 | 连接对象 / 配置 |
USART2 | PA2 / PA3 | WS8712x-C5 UART;115200,8N1 |
SPI2 | PB13 / PB15 | ST7789;SCK / MOSI |
USART1 | PA9(TX) | U1T 调试日志输出;115200,8N1 |
公共地 | GND | STM32、Wi-Fi 模组及显示模块共地 |
从实物连接方式看,系统采用模块化搭建:Wi-Fi 模组通过 UART 接入 STM32,显示屏由 STM32 的 SPI 接口驱动。PC 与 Wi-Fi 模组处于同一局域网,通过 TCP 连接设备,不需要 PC 与 STM32 之间再增加独立的 USB 数据链路。
03 系统架构与软件设计3.1 系统功能框图
PC 上位机 图片选择 / 裁剪缩放 / RGB565 转换 / 分包 / ACK 管理 ↓ |
Wi-Fi 局域网 PC TCP Client ⇄ 路由器 / AP ⇄ WS8712x-C5 TCP Server ↓ |
WS8712x-C5 Wi-Fi STA / TCP Server / AT+CIPSEND / +IPD 数据转发 ↓ |
STM32F407VET6 USART2 接收 / +IPD 提取 / PLK 协议解析 / CRC 校验 ↓ |
ST7789 TFT SPI2 写入 RGB565 图像 / 数字局部刷新 / Logo 恢复 |
3.2 软件启动与网络状态流程
系统上电 ↓ GPIO / SPI2 / USART1 / USART2 初始化 ↓ LCD 初始化并绘制默认 PixelLink Logo ↓ WiFi_AT_Init:AT 自检、查询模组状态 ↓ 查询 STA IP ├─ IP 无效:检查 DHCP / 等待联网事件 / 继续查询 └─ IP 有效:继续网络配置 ↓ 查询并设置 CIPMUX,读回确认 ↓ 查询并设置 TCP Server,读回确认 ↓ tcp_ready = 1,等待 PC 客户端连接 ↓ WiFi_AT_Poll:解析 AT 行、+IPD 数据及应用层帧 ↓ PixelLink 协议处理 → LCD 显示 → PLKACK |
网络状态机将 AT 指令响应、Wi-Fi 连接事件、DHCP 地址获取和 TCP Server 就绪分开管理。例如,CWJAP 命令被接受并不代表已经连上路由器;最终仍需结合 +WSCONN 事件和非零 STA IP 判断联网成功。
3.3 PC、Wi-Fi 与 MCU 的数据路径
· 下行:PC 上位机 → TCP Client → 局域网 → WS8712x-C5 TCP Server → UART → STM32F407。
· 上行确认:STM32 生成 PLKACK → 通过 WS8712x-C5 的 AT+CIPSEND 返回 PC。
· 显示输出:STM32 将已校验的 RGB565 数据按行写入 ST7789;数字模式仅更新对应笔画区域。
04 关键实现过程4.1 AT 自检、Wi-Fi 联网与 TCP Server
STM32 启动后先完成外设初始化,并通过 USART2 与 WS8712x-C5 进行 AT 通信。程序读取固件信息、UART 参数、Wi-Fi 工作模式和 STA IP 等状态。当 IP 为 0.0.0.0 时,不会直接进入 TCP 配置,而是继续处理 DHCP 和联网事件。
+WSCONN="OK" +WSIP="192.168.0.105" +CIPSTA="192.168.0.105","192.168.0.1","255.255.255.0" +CIPSERVER=1,8888,"TCP",0,0 |
最终读回确认 STA IP 为 192.168.0.105,TCP Server 监听端口为 8888。PC 上位机随后连接 192.168.0.105:8888,完成 TCP 链路建立。

WS8712x-C5 AT 控制台及联网状态日志
4.2 TCP 文本数据验证
在开始大容量图片传输前,先使用短文本对 PC → Wi-Fi → STM32 的数据链路进行验证。PC 发送 HELLO PixelLink,长度为 17 Bytes;STM32 心跳日志中的 tcp_bytes 随后增加到 17,证明数据已经进入 MCU 接收处理路径。

4.3 RGB565 图像转换与分包传输
图像预处理放在 PC 上位机完成。上位机将待显示图片裁剪或缩放到目标尺寸,再转换为 RGB565 像素数据。320×172 全屏图像包含 55,040 个像素,每像素 2 Bytes,因此图像有效载荷为 110,080 Bytes。
参数 | 数值 |
图像宽 × 高 | 320 × 172 |
像素总数 | 55,040 |
像素格式 | RGB565(16 bit / pixel) |
有效图像数据 | 110,080 Bytes |
上位机分包数量 | 588 包(传输日志记录) |
上位机采用逐包等待确认的发送方式:每个应用层数据包发送后等待对应 PLKACK,收到成功状态后再继续发送。单包校验使用 CRC16,整张图片结束时再使用 CRC32 对完整像素流进行校验。这种机制将大图拆成可确认的小数据块,便于定位丢包、顺序错误和内容损坏。

RGB565 图片传输上位机:320×172、110,080 Bytes、588 packets,整图 CRC32 完成
4.4 LCD 显示与数字同步
STM32 在收到 BEGIN 帧后记录图片宽高、显示起始位置并初始化整图 CRC32;接收 DATA 帧时按偏移顺序累计像素,并在一行数据完整后调用 LCD 显示接口写入屏幕。收到 END 帧后,检查像素总数与整图 CRC32,只有全部匹配才将图片标记为完成。
数字演示使用独立控制帧,数值限定为 1~10。程序通过局部绘制七段数字笔画实现刷新,不需要每次都清屏或重新发送整张图片。收到恢复 Logo 命令后,调用 Logo 显示接口恢复默认画面。
05 关键代码与协议解析5.1 PLK1 应用层帧格式
工程在 TCP 字节流之上定义了 PixelLink 应用层协议。TCP 本身只提供有序字节流,因此 MCU 需要根据协议头中的长度字段组装完整帧,不能假设一次 TCP 接收就恰好对应一条应用消息。
字段 | 长度 | 说明 |
Magic | 4 Bytes | 固定标识:PLK1 |
Kind | 1 Byte | 命令类型 |
Sequence | 2 Bytes | 大端序包序号 |
Length | 2 Bytes | 大端序 Payload 长度 |
CRC16 | 2 Bytes | CRC16-CCITT-FALSE |
Payload | 最多 192 Bytes | 命令数据或 RGB565 像素数据 |
5.2 命令类型
Kind | 功能 | Payload 内容 |
1 | BEGIN | 图像宽度、高度(各 2 Bytes,大端序) |
2 | DATA | 图像偏移(4 Bytes)+ RGB565 像素数据 |
3 | END | 整图 CRC32(4 Bytes) |
4 | COUNT | 数字值,范围 1~10 |
5 | RESTORE_LOGO | 空 Payload,恢复默认 Logo |
5.3 关键函数职责
模块 / 函数 | 关键职责 |
WiFi_AT_Poll() | 在主循环中推进 AT / TCP 状态处理,处理接收数据及待发送响应。 |
parse_ipd_header() | 解析模组 +IPD 头部中的连接 ID 和数据长度。 |
tcp_payload_complete() | 在完整 +IPD 载荷收齐后统计 TCP 数据,并交给 PixelLink 协议解析。 |
PixelLink_Image_OnTcpData() | 接收 TCP 载荷,按帧头、长度和 CRC 规则组装应用层帧。 |
packet_crc() | 计算包级 CRC16,覆盖前 9 字节头部和 Payload。 |
accept_frame() | 处理 BEGIN / DATA / END / COUNT / RESTORE_LOGO 等命令。 |
reply() | 通过 Wi-Fi 模组 TCP 回复路径发送 PLKACK,seq,status。 |
5.4 ACK、重发与数据完整性
ACK 格式为 ASCII 文本 PLKACK,seq,status。status 为 0 表示成功;非零值用于表示格式错误、无活跃图片、CRC 错误、顺序错误、尺寸或长度超限以及 LCD 错误等情况。
工程还处理了 ACK 丢失后的重复包场景:当相同连接、相同序号和相同 CRC16 的帧再次到达时,接收端重新回复 ACK,但不会再次执行 LCD 写入,从而避免重复绘制。
PC 上位机 STM32 | | | -------- PLK1 DATA(seq) ------> | | | 组帧 / CRC16 / 检查序号 | | 更新像素 / LCD | <------- PLKACK,seq,0 --------- | | | | 发送下一数据包 | | | | -------- PLK1 END(CRC32) -----> | | | 检查像素总数与整图 CRC32 | <------- PLKACK,seq,0 --------- | |
实现上的一个关键点 UART 接收中断侧只负责将字节放入接收环形缓冲区;完整 +IPD 解析、应用层帧处理和 LCD 更新放在主循环处理路径中,避免在中断上下文中执行较重的协议与显示操作。 |
06 功能展示与实机测试结果
6.1 测试项目与结果
测试项目 | 结果 | 验证依据 |
AT 指令基础通信 | 通过 | 固件版本、UART、CWMODE、CIPSTA 查询有响应 |
Wi-Fi STA / DHCP | 通过 | 获取 192.168.0.105 |
TCP Server | 通过 | CIPSERVER 读回 1,8888,TCP |
PC TCP 连接 | 通过 | 上位机显示已连接 192.168.0.105:8888 |
TCP 文本接收 | 通过 | HELLO PixelLink,17 Bytes |
RGB565 全屏图像 | 通过 | 320×172,110,080 Bytes |
分包传输 | 通过 | 上位机日志记录 588 packets |
整图 CRC32 | 通过 | 3061B125 |
数字 1~10 演示 | 通过 | 日志记录 value=1…10,序号持续递增 |
退出数字演示 | 通过 | 日志记录 PixelLink logo restored |
超长 TCP 数据计数 | 0 | 最终 tcp_oversize=0 |
6.2 关键实测日志
[PIXEL] COMPLETE 320x172 bytes=110080 crc32=3061B125
[SYS] ... tcp_ready=1, tcp_bytes=119852, tcp_oversize=0, img_ok=1 ...
[COUNT] value=1 ... seq=1 [COUNT] value=2 ... seq=2 ... [COUNT] value=10 ... seq=10
[LCD] PixelLink logo restored [COUNT] exit demo, PixelLink logo restored ... seq=78 |
说明:tcp_bytes 是该轮运行期间累计接收的 TCP 字节数,包含图片数据及后续控制数据,不应直接作为单张图片的有效载荷大小。单张图片有效数据量以 COMPLETE 日志中的 110,080 Bytes 为准。
6.3 实机显示

ST7789 屏幕显示由 PC 端发送的图片
07 项目总结
本次基于 WS8712x-C5 Wi-Fi 6 & Bluetooth 开发板,完成了以 STM32F407VET6 为主控的 PixelLink 无线图传与显示系统。从 AT 自检、STA 联网、TCP Server 配置,到 PC 上位机发送 RGB565 图片、STM32 分包接收、CRC 校验及 ST7789 显示,已经形成一条完整的端到端应用链路。
本次最重要的成果不是单独证明模组能够连接 Wi-Fi,而是完成了真实图像数据从 PC 经无线网络到 MCU,再由 MCU 驱动显示屏呈现的闭环验证。与此同时,逐包 ACK、CRC16、整图 CRC32、重复包幂等处理和数字局部刷新,也为后续扩展更多 MCU 无线应用提供了可复用的设计思路。
本次测评结论 已完成 Wi-Fi/TCP 应用链路和 RGB565 图片显示的实机功能验证。下一阶段重点从“功能跑通”转向“稳定性、效率和无线性能量化”。 |
我要赚赏金
