WT9932C5-TINY AT 指令固件上手指南

  • WT9932C5-TINY
  • ESP32-C5
  • Wi-Fi 6
  • ESP-AT
  • AT
更新历史
日期 版本 作者 更新内容
2026-11-11 1.0.0 Iris 新增 ESP-AT 入门指南

1. 教程目标

本指南面向使用 WT9932C5-TINY + esp-at 进行开发的用户,引导用户完成 esp-at 固件包下载、在线烧录、AT 指令验证和配网的完整流程。

WT9932C5-TINY 基于乐鑫 ESP32-C5,板载 CH343P USB 转串口芯片。开发板的 FUSB USB Type-C 接口用于供电、固件烧录和日志输出。默认 ESP-AT 固件通过 UART1 收发 AT 指令,因此进行 AT 指令测试时还需外接 USB 转串口模块,接线如下:

开发板接口 USB 转串口模块接口 说明
UART1 RX(GPIO24) TX USB 转串口模块向开发板发送数据
UART1 TX(GPIO1) RX 开发板向 USB 转串口模块发送数据
5V 5V 供电
GND GND 共地

注意: 本指南中使用的WT9932C5-TINY的AT固件的引脚与乐鑫官方 ESP-AT 固件的默认引脚是不一样的,本指南中使用的固件的TX/RX引脚分别是 GPIO24(RX)和 GPIO1(TX)。如需使用乐鑫官方默认 AT 引脚,请前往乐鑫 AT 指南下载并烧录对应固件。

2.准备工作

2.1 硬件准备

  • WT9932C5-TINY 开发板 * 1
  • 串口通信模块 * 1
  • 质量可靠的 USB Type-C 数据线 * 1,建议至少准备一根支持数据传输的线。
  • Windows、Linux 或 macOS 电脑。

2.2 软件准备

  • 使用启明云端在线烧录工具,不需要提前下载软件包,此在线工具只需要打开浏览器即可完成烧录、擦除Flash、读取查看芯片信息、串口监视器、Flash读取备份、固件校验等操作。

3.通过在线工具完成烧录

3.1 下载固件包

点击跳转打开在线工具:启明云端在线小工具,下图是打开的页面:

启明云端在线烧录工具首页

这个时候我们先下载固件包,需要在页面的这个位置选择下载 在线烧录->官方固件,下图所示的区域:

在线烧录工具官方固件区域

上图框起来的区域是可以滑动的,滑动选择下载这个固件包,注意固件名字,下图所示:

WT9932C5-TINY AT固件包

点击下载固件包按钮后会自动下载,下载下来的固件包的名称为: esp32-c5-4mb-at-v5.1.0.0-dev-95934064-online.zip

注意:下载后的固件包不用解压,后面直接在在线下载工具中使用。

3.2 烧录步骤

使用USB Type-C数据线,将Type-C端接入到 FUSB口,USB端接入到电脑,打开在线工具,按照下图所示点击连接设备:

点击连接设备按钮后会弹出一个对话框,其中的列表可能有多个设备,如果不确定哪个是当前设备接入的COM口,那么请拔除其他设备,或者拔插一次本设备,即可确定哪个COM是当前要操作的硬件。

在线烧录工具串口设备选择窗口

选中设备com口后,点击Connect按钮后会进行连接操作,可以通过最底部的日志区域,查看连接状态,下面所示是连接成功的提示:

WT9932C5-TINY 设备连接成功日志

连接成功之后,即可进行烧录,按照下图所示点击加载固件包按钮,会弹出一个窗口,在窗口中选择前面下载的固件 esp32-c5-4mb-at-v5.1.0.0-dev-95934064-online.zip:

加载固件包

接下来点击开始烧录按钮进行烧录,注意点击按钮后,顶部会有一个对话框,点击OK才会正式开始烧录:

确认烧录固件

烧录完成的提示:

C5 固件烧录完成

到这里,固件已经烧录完成!接下来可进入测试验证。

4. AT 指令测试

按照上面的烧录流程,烧录了固件之后,将接在设备上的Type-C线拔除。

将串口模块按照下面所示的接线对接到WT9932C5-TINY:

  • 串口模块的TX ----> GPIO24

  • 串口模块的RX ----> GPIO1

  • 串口模块的5V ----> 5V

  • 串口模块的GND ----> GND

    接线

将串口模块接入到PC电脑,此时电脑会识别出COM端口,使用串口工具打开,按照下图所示配置进行连接,连接之后发送测试指令 AT\r\n 指令会看到如图所示的现象:

AT指令测试

5.配网教程

​ 确认发送 AT 能正常返回 OK 后,在串口工具中依次发送以下指令,将开发板连接到指定的 Wi-Fi 路由器或热点:

注意:每条指令后都要添加回车换行

AT指令 作用 执行成功返回
AT+CWMODE=1 将开发板设为 Station,连接路由器 OK
AT+CWLAP 列出附近可以连接的 Wi-Fi 返回一个或多个 +CWLAP: 条目,最后返回 OK
AT+CWJAP="你的WiFi名称","你的WiFi密码" 使用指定名称和密码连接路由器/热点 WIFI CONNECTED、WIFI GOT IP、OK
AT+CWSTATE? 判断是否正在连接、已经连接或已经断开 +CWSTATE:2,"SSID" 表示已连接并获得 IPv4 地址
AT+CIPSTA? 查询开发板获得的 IP、网关和子网掩码 返回 ip、gateway、netmask

下面是一次完整的配网交互示例;请将示例中的 Wi-Fi 名称和密码替换为实际信息:

» AT
« AT
OK
» AT+CWMODE=1
« AT+CWMODE=1
OK
» AT+CWLAP
« AT+CWLAP
+CWLAP:(3,"CMW-AP2025",-33,"fc:34:97:04:61:80",7,-1,-1,4,4,7,1)
+CWLAP:(7,"CMCC-SORZ-5G",-56,"b2:39:0d:ed:a9:01",36,-1,-1,4,4,116,0)
+CWLAP:(7,"CMCC-SORZ-7G",-56,"ba:fb:7a:69:14:0f",36,-1,-1,4,4,116,0)
+CWLAP:(3,"GW192C-C49E7E15C6BD",-57,"c4:9e:7e:15:06:bd",1,-1,-1,4,4,7,0)
+CWLAP:(3,"CMCC-SORZ",-58,"9e:31:41:c3:0d:0e",11,-1,-1,4,4,23,0)
+CWLAP:(3,"CMCC-TEST",-58,"f2:a8:33:d0:0c:4d",11,-1,-1,4,4,23,0)
+CWLAP:(7,"CMCC-SORZ-7G",-58,"12:55:36:d:28:d4",11,-1,-1,4,4,23,0)
OK
» AT+CWJAP="CMW-AP2025","12345678"
« AT+CWJAP="CMW-AP2025","12345678"
WIFI CONNECTED
WIFI GOT IP
OK
» AT+CWSTATE?
« AT+CWSTATE?
+CWSTATE:2,"CMW-AP2025"
OK
» AT+CIPSTA?
« AT+CIPSTA?
+CIPSTA:ip:"192.168.50.244"
+CIPSTA:gateway:"192.168.50.1"
+CIPSTA:netmask:"255.255.255.0"
OK

当AT+CIPSTA? 返回有效 IP 地址时,说明配网成功。SSID 或密码中含有逗号、双引号或反斜杠时,需要按照 ESP-AT 文档要求进行转义。

6. 深入学习

完成固件烧录、AT 指令通信和 Wi-Fi 配网后,说明 WT9932C5-TINY 的 ESP-AT 基础使用流程已经打通。后续可在ESP-AT 用户指南中继续深入学习AT指令。

7. 参考链接

文档名称 链接 说明
ESP-AT 用户指南 ESP-AT 用户指南 ESP32-C5 ESP-AT 入门、硬件连接与固件下载指南
ESP-AT UserGuide ESP-AT UserGuide ESP32-C5 ESP-AT 官方英文入门指南
ESP-AT 官方源码仓库 GitHub 仓库 乐鑫官方维护的 ESP-AT 工程源码、版本分支和开发资源;需要自行编译、定制固件或查看源码时使用。
ESP32-C5 ESP-IDF 在线文档 在线文档 ESP-IDF 编程指南与 API 说明
ESP32-C5 技术参考手册 技术参考手册 ESP32-C5 芯片参数参考
启明云端 ESP-AT 固件仓库 GitHub 仓库 查看启明云端维护的 ESP-AT 固件工程及相关开发资源。