WT9932C5-TINY 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 下载固件包
点击跳转打开在线工具:启明云端在线小工具,下图是打开的页面:

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

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

点击下载固件包按钮后会自动下载,下载下来的固件包的名称为: 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按钮后会进行连接操作,可以通过最底部的日志区域,查看连接状态,下面所示是连接成功的提示:

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

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

烧录完成的提示:

到这里,固件已经烧录完成!接下来可进入测试验证。
4. AT 指令测试
按照上面的烧录流程,烧录了固件之后,将接在设备上的Type-C线拔除。
将串口模块按照下面所示的接线对接到WT9932C5-TINY:
串口模块的TX ----> GPIO24
串口模块的RX ----> GPIO1
串口模块的5V ----> 5V
串口模块的GND ----> GND

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

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 固件工程及相关开发资源。 |