WT9932S31-TINY 上手指南

  • WT9932S31-TINY
  • ESP32-S31
  • WT_BSP
  • blink
更新历史
日期 版本 作者 更新内容
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

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

烧录步骤

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

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

在线烧录工具串口设备选择窗口
  1. 选中设备com口后,点击Connect按钮后会进行连接操作,可以通过最底部的日志区域,查看连接状态,下图所示是连接成功的提示:
ESP32-S31 设备连接成功日志
  1. 连接成功之后,即可进行烧录,按照下图所示点击加载固件包按钮,会弹出一个窗口,在窗口中选择第一个固件wt9932s31-tiny-factory-gc2145-sd-recording-off-20261022-Online.zip:
加载 WT9932S31-TINY 固件包
  1. 接下来点击开始烧录按钮进行烧录,注意点击按钮后,顶部会有一个对话框,点击确定才会正式开始烧录:
确认烧录 WT9932S31-TINY 固件
  1. 烧录完成的提示:
WT9932S31-TINY 固件烧录完成

到这里,固件已经烧录完成!把接在开发板上的Type-C线拔除,接下来可进入测试验证。

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 硬件连接

  1. 如需使用无线功能,先将 FPC 天线正确连接到开发板。
  2. 使用 USB Type-C 数据线连接开发板的 FUSB 端口和电脑 USB 端口。
  3. 确认开发板已经通电,并在电脑上找到对应串口。

如果已经插入 MicroSD 卡,卡片可能遮挡电源指示灯。俯视开发板看不到指示灯时,请从侧面观察。

5.2 烧录示例

在 blink 示例目录中运行:

idf.py -p <COM> flash

将 <COM> 替换为开发板的实际串口,例如 Windows 下的 COM5 或 Linux/WSL 下对应的串口设备。

如果连接 FUSB 后,电脑上的串口反复出现和消失,或烧录工具中的串口状态不稳定,可手动进入烧录模式:

  1. 按住开发板的 BOOT 按键。
  2. 点按一次 RESET/EN 按键。
  3. 松开 BOOT 按键。
  4. 再次执行烧录命令。

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 应用。