WT9932S31-TINY 上手指南
更新历史
| 日期 | 版本 | 作者 | 更新内容 |
|---|---|---|---|
| 2026-11-04 | 1.0.0 | Iris | 首次创建文档 |
1. 教程目标
本指南面向第一次使用 WT9932S31-TINY 的用户,引导用户完成从开发板熟悉、开发环境准备、WT_BSP 获取,到 blink 示例编译、烧录和运行验证的完整流程。
WT9932S31-TINY 是一款基于 WT0132S31-S1 模组的小尺寸开发板,以乐鑫 ESP32-S31 为核心。芯片搭载主频最高 320 MHz 的双核 RISC-V 处理器,支持 2.4 GHz Wi-Fi 6、低功耗蓝牙、经典蓝牙、Zigbee 和 Thread。开发板尺寸为 54 × 28 mm,板载 DVP 摄像头接口、4 线 TF 卡槽、WS2812 RGB LED,并引出可用于面包板连接的 GPIO。
开发板提供两个 USB Type-C 接口:
| 接口 | 丝印/编号 | 主要用途 |
|---|---|---|
| FUSB Type-C | FUSB |
全速 USB 2.0,用于供电、固件烧录和 JTAG 调试,最高理论速率 12 Mbps |
| HUSB Type-C | HUSB |
高速 USB 2.0 接口,最高理论速率 480 Mbps,也可给开发板供电 |
本指南中的示例烧录和串口连接统一使用
FUSB。两个 USB 接口同时接入时,开发板优先使用FUSB供电。
2. 准备工作
2.1 硬件准备
WT9932S31-TINY开发板一块。- 支持数据传输的 USB Type-C 数据线一根。
- FPC 天线一根。使用无线功能前应正确连接天线。
- Windows、Linux 或 macOS 电脑。
- 可选配件:
- MicroSD 卡,用于数据存储。
WTDK-CAM-2145摄像头,用于图像采集。
若使用电脑 USB 接口供电,建议该接口至少能提供
5V@1A。供电不足时,开发板可能无法正常启动。
2.2 固件准备
WT9932S31-TINY 只需要烧录一个合并固件: |
|
|---|---|
| 固件名称 | 烧录芯片 |
WT9932S31-TINY · wt9932s31-tiny-factory-gc2145-sd-recording-off-20261022 |
ESP32-S31 |
2.3 烧录方式
可以选择以下任一种方式:
使用启明云端在线烧录工具。浏览器中即可完成设备连接、Flash 擦除、固件烧录和串口日志查看。
使用乐鑫 Flash Download Tool。该方式适合 Windows 用户。
3. 通过在线工具烧录
下载固件包
点击跳转打开在线工具:启明云端在线小工具,下图是打开的页面:
这个时候我们先下载固件包,需要在页面的这个位置选择下载 在线烧录->官方固件,下图所示的区域:
点击下载固件包按钮后会自动下载,下载下来的固件包的名称:wt9932s31-tiny-factory-gc2145-sd-recording-off-20261022-Online.zip
注意:下载后的固件包不用解压,后面直接在在线下载工具中使用。
烧录步骤
- 使用USB Type-C数据线,将Type-C端接入到
FUSB口,USB端接入到电脑,打开在线工具,按照下图所示点击连接设备:
点击
连接设备按钮后会弹出一个对话框,其中的列表可能有多个设备,如果不确定哪个是当前设备接入的COM口,那么请拔除其他设备,或者拔插一次本设备,即可确定哪个COM是当前要操作的硬件。
- 选中设备com口后,点击
Connect按钮后会进行连接操作,可以通过最底部的日志区域,查看连接状态,下图所示是连接成功的提示:
- 连接成功之后,即可进行烧录,按照下图所示点击
加载固件包按钮,会弹出一个窗口,在窗口中选择第一个固件wt9932s31-tiny-factory-gc2145-sd-recording-off-20261022-Online.zip:
- 接下来点击
开始烧录按钮进行烧录,注意点击按钮后,顶部会有一个对话框,点击确定才会正式开始烧录:
- 烧录完成的提示:
到这里,固件已经烧录完成!把接在开发板上的Type-C线拔除,接下来可进入测试验证。
4. 编译 blink 示例
4.1 进入示例目录
每次更新 WT_BSP 后,建议先编译最小的 blink 示例,以确认 ESP-IDF、BSP 和板卡选择工具均能正常工作:
cd ~/work/WT_BSP/examples/get-started/blink
4.2 选择开发板
运行 WT_BSP 提供的板卡选择命令:
idf.py set-board
命令会列出当前示例支持的开发板。找到以下选项:
7: WT9932S31-TINY (esp32s31)
输入 7 并按回车。选择成功后,终端中应出现类似输出:
Selected WT9932S31-TINY (esp32s31)
Done
set-board会选择目标芯片并生成当前工程使用的板级预设配置。除非清楚set-board完成了哪些操作,否则不要再运行idf.py set-target覆盖这些配置。
4.3 编译示例
完成板卡选择后执行:
idf.py build
编译成功后,即可进入烧录和测试步骤。后续其他 WT_BSP 示例也使用相同的选板与编译流程。
5. 烧录与测试
5.1 硬件连接
- 如需使用无线功能,先将 FPC 天线正确连接到开发板。
- 使用 USB Type-C 数据线连接开发板的
FUSB端口和电脑 USB 端口。 - 确认开发板已经通电,并在电脑上找到对应串口。
如果已经插入 MicroSD 卡,卡片可能遮挡电源指示灯。俯视开发板看不到指示灯时,请从侧面观察。
5.2 烧录示例
在 blink 示例目录中运行:
idf.py -p <COM> flash
将 <COM> 替换为开发板的实际串口,例如 Windows 下的 COM5 或 Linux/WSL 下对应的串口设备。
如果连接 FUSB 后,电脑上的串口反复出现和消失,或烧录工具中的串口状态不稳定,可手动进入烧录模式:
- 按住开发板的
BOOT按键。 - 点按一次
RESET/EN按键。 - 松开
BOOT按键。 - 再次执行烧录命令。
5.3 运行验证
烧录成功后,开发板会自动运行 blink 示例。正常现象应为:
- 板载 RGB LED 的颜色每隔约一秒变化一次。
- 串口日志能够正常输出启动信息。
如需使用 ESP-IDF 串口监视器查看日志,可运行:
idf.py -p <COM> monitor
日志中的时间戳和版本号可能不同,但应能看到与以下内容相近的关键信息:
boot.esp32s31: SPI Flash Size : 16MB
cpu_start: cpu freq: 320000000 Hz
app_init: Project name: blink
blink: Initializing Wireless-Tag BSP
如果 RGB LED 持续按周期变色,且串口日志中没有反复复位或明显报错,即可认为基础环境、板卡选择、编译和烧录流程验证通过。
5.4 常见问题
| 现象 | 处理方法 |
|---|---|
| 找不到串口 | 确认数据线支持数据传输,并检查是否连接到 FUSB |
| 串口反复出现和消失 | 按住 BOOT,点按 RESET/EN,再松开 BOOT,然后重新烧录 |
| 板卡或目标芯片不正确 | 重新执行 idf.py set-board,选择 7: WT9932S31-TINY (esp32s31) |
| 开发板启动不稳定 | 更换质量良好的数据线,并确认 USB 接口可提供至少 5V@1A |
| 插入 MicroSD 卡后看不到电源灯 | MicroSD 卡可能遮挡指示灯,请从开发板侧面观察 |
6. 下一步
完成 blink 示例验证后,可以继续尝试 WT_BSP 中的其他示例,使用 DVP 摄像头、TF 卡、无线通信和 GPIO 等功能开发自己的 ESP32-S31 应用。