电子产品世界 » 论坛首页 » 活动中心 » 有奖活动 » 【WS8712x-C5开发板试用】成果贴

共1条 1/1 1 跳转至页

【WS8712x-C5开发板试用】成果贴

菜鸟
2026-11-19 01:43:26     打赏

基于 WS8712x-C5 与 STM32F407 的Wi-Fi 无线图传系统设计与实现


无线通信

WS8712x-C5 · Wi-Fi STA / TCP

主控平台

STM32F407VET6 · 168 MHz

显示终端

ST7789 · 1.47 英寸 · 320 × 172

图像格式

RGB565 · 110,080 Bytes / 全屏



image.png

实机硬件平台与无线图片显示效果

本次成果摘要

完成 PC →   Wi-Fi → WS8712x-C5 TCP Server → STM32F407 → ST7789 的端到端图像传输验证。320×172 RGB565 全屏数据量为   110,080 Bytes,分包传输后完成 CRC32 校验;同时完成 TCP 文本接收及 1~10 数字局部刷新演示。

01  项目介绍

第一篇开箱与过程贴主要完成了 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 性能测试。


02  硬件方案与核心器件

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 链路建立。

image.png

WS8712x-C5 AT 控制台及联网状态日志

4.2 TCP 文本数据验证

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


image.png

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 对完整像素流进行校验。这种机制将大图拆成可确认的小数据块,便于定位丢包、顺序错误和内容损坏。

image.png

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 实机显示

image.png

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 图片显示的实机功能验证。下一阶段重点从“功能跑通”转向“稳定性、效率和无线性能量化”。






共1条 1/1 1 跳转至页

回复

匿名不能发帖!请先 [ 登陆 注册 ]