WT9932S31-TINY 开发指南
更新历史
| 日期 | 版本 | 作者 | 更新内容 |
|---|---|---|---|
| 2026-11-05 | 1.0.0 | Iris | 首次创建文档 |
一、开发方式概览
WT_BSP 是 Wireless-Tag 为 ESP32 系列开发板维护的板级支持包。使用 WT9932S31-TINY 开发时,推荐把应用逻辑建立在 WT_BSP 之上,而不是在业务代码中直接写具体 GPIO、屏幕初始化参数、摄像头引脚或 SD 卡管脚。
本指南所有选板、USB 接线和外设入口均按 WT9932S31-TINY 适配。S31 的摄像头接口是 DVP。
基于 WT_BSP 开发的核心思路是:
- 应用工程通过
components/wt_bsp引入 BSP 组件。 - 使用
idf.py set-board选择WT9932S31-TINY。 - 应用调用
wt_bsp_init()初始化板级资源。 - 应用通过
wt_bsp_get_rgb()、wt_bsp_get_button()、wt_bsp_get_sdmmc()、wt_bsp_get_dsi()、wt_bsp_get_csi()、wt_bsp_get_touch()获取资源句柄。 - 应用根据返回值判断功能是否可用,并实现自己的业务逻辑。
这样做的好处是:
- 应用代码不绑定具体硬件引脚。
- 同一个示例可以较低成本适配多块 Wireless-Tag 开发板。
- 外设能力可通过
menuconfig裁剪。 - 板级差异由
components/wt_bsp/boards/WT9932S31-TINY统一维护。
二、获取与更新 WT_BSP
WT_BSP 的官方仓库地址为:
仓库仍在持续更新。首次获取时应从官方仓库克隆;已经下载过仓库的用户,在开始新项目或排查问题前应先同步 main 分支,以便使用最新的板级适配、示例和工具。
2.1 环境要求
开始前请准备:
- Git。
- ESP-IDF v6.1 或以上版本;本指南验证基线为 v6.1 release。
- 已激活的 ESP-IDF 命令行环境。
- 支持数据传输的 USB Type-C 线;验证 HUSB 应用时建议准备两根线。
- 进行 SD 或摄像头示例时,准备对应的配件。
ESP-IDF v6.1 将 esp32s31 列为 preview target,因此本指南对选板、编译、配置和烧录统一使用 --preview。这里的 preview 指 S31 目标支持状态,SDK 本身仍是正式发布的 v6.1。
2.2 首次克隆仓库
选择一个用于存放开发项目的目录,然后克隆官方仓库:
mkdir -p ~/work
cd ~/work
git clone https://github.com/Wireless-TAG-Maker/WT_BSP.git
cd WT_BSP
当前仓库不要求通过 --recursive 获取子模块,直接执行上述 git clone 即可。克隆完成后检查当前分支和最新提交:
git status --short --branch
git log -1 --oneline
正常情况下应位于 main 分支。后续示例统一假设仓库位于:
~/work/WT_BSP
实际开发时可以使用其他目录,只需把文档命令中的路径替换为自己的真实路径。
2.3 更新已有仓库
如果本地已经存在 WT_BSP,先进入仓库并检查是否有未提交修改:
cd ~/work/WT_BSP
git status --short --branch
如果工作区干净,可以切换到 main 并使用仅快进方式同步官方更新:
git switch main
git pull --ff-only origin main
更新后再次确认当前版本:
git log -1 --oneline
如果 git status 显示有本地修改,请先提交到自己的开发分支,或使用 git stash 暂存,再更新 main。不要为了更新仓库直接删除本地修改。
建议:自定义应用尽量放在 WT_BSP 仓库外部,或保存在独立 Git 分支中。这样后续同步官方
main时,不容易与自己的业务代码产生冲突。团队协作时还应记录验证过的 WT_BSP commit,便于其他开发者复现相同的构建环境。
2.4 从 blink 开始验证
每次更新 WT_BSP 后,建议先编译最小的 blink 示例,确认 ESP-IDF、BSP 和板卡选择工具工作正常:
cd ~/work/WT_BSP/examples/get-started/blink
idf.py set-board
idf.py build
在交互列表中选择 WT9932S31-TINY。如果需要非交互构建,可以执行:
WT_BSP_BOARD=WT9932S31-TINY idf.py set-board
idf.py build
set-board 会生成当前工程使用的板级默认配置;切换到目标芯片不同的开发板时,工具会自动执行 fullclean。
三、WT_BSP 目录结构
以下路径均相对于 WT_BSP 仓库根目录。
| 路径 | 用途 |
|---|---|
components/wt_bsp |
BSP 核心组件 |
components/wt_bsp/include/wt_bsp.h |
顶层公共入口 |
components/wt_bsp/src |
BSP 公共实现 |
components/wt_bsp/features |
RGB、Button、SDMMC、USB CDC、Camera 等可复用能力 |
components/wt_bsp/boards/WT9932S31-TINY |
S31 板级引脚、资源生命周期、DVP 与 UVC 适配 |
components/wt_bsp/tools |
set-board 与 CMake 辅助脚本 |
examples/get-started/blink |
RGB 最小示例 |
examples/get-started/button |
按键事件示例 |
examples/storage/sdmmc |
SD 卡挂载、文件读写与重命名示例 |
examples/usb/device_cdc |
HUSB CDC 字节回显示例 |
examples/camera/usb_device_uvc |
DVP 摄像头转 HUSB UVC |
examples/wt_factory/wt9932s31-tiny |
摄像头、SD、RGB、SW2、UVC+CDC 综合示例 |
应用开发者通常只需要关注:
examples/:优先阅读与需求最接近的示例及其README_CN.md,再复制或参考代码。components/wt_bsp/include/wt_bsp.h:查看 BSP 顶层 API。components/wt_bsp/features/*/include/:查看各外设能力的 API。
不建议应用层直接包含:
#include "boards/WT9932S31-TINY/board.h"
#include "board_config.h"
这些文件属于板级适配内部实现,应用层应通过 wt_bsp.h 获取统一接口。
四、新建自己的应用工程
4.1 选择起点
| 开发需求 | 推荐示例 |
|---|---|
| 验证环境、设置 RGB 状态灯 | examples/get-started/blink |
| 响应 BOOT/SW2 用户操作 | examples/get-started/button |
| MicroSD 存储 | examples/storage/sdmmc |
| 电脑与 S31 自定义串口协议 | examples/usb/device_cdc |
| DVP 摄像头作为电脑摄像头 | examples/camera/usb_device_uvc |
| 摄像头、存储与 USB 综合应用 | examples/wt_factory/wt9932s31-tiny |
先阅读所选示例目录中的 README_CN.md,确认硬件连接和构建步骤,再以该示例为基线开发。
4.2 从 blink 示例复制最小应用
如果是第一个自定义应用,建议从 blink 示例复制,因为它结构最小、依赖清晰。
get_idf
cd ~/work/WT_BSP/examples
mkdir -p my_apps
cp -r get-started/blink my_apps/my_s31_app
cd my_apps/my_s31_app
复制后建议清理旧构建产物:
rm -rf build managed_components sdkconfig sdkconfig.old
保留以下文件:
| 文件 | 是否保留 | 说明 |
|---|---|---|
CMakeLists.txt |
保留 | 已接入 WT_BSP 的 CMake 辅助脚本 |
main/CMakeLists.txt |
保留 | 注册应用源码 |
main/main.c |
修改 | 替换为自己的业务逻辑 |
sdkconfig.defaults |
保留或修改 | 工程默认配置 |
sdkconfig.wt9932s31_tiny |
保留 | set-board 需要读取的板级默认配置 |
README.md / README_CN.md |
修改 | 改成自己的应用说明 |
然后选择开发板并构建:
WT_BSP_BOARD=WT9932S31-TINY idf.py set-board
idf.py build
4.3 新工程必须具备的 CMake 配置
工程顶层 CMakeLists.txt 需要把 WT_BSP 的 components 目录加入 ESP-IDF,并调用 WT_BSP 的板级默认配置函数。
如果工程仍放在 WT_BSP/examples/... 下,可参考:
cmake_minimum_required(VERSION 3.16)
set(EXTRA_COMPONENT_DIRS "../../../components")
include("../../../components/wt_bsp/tools/wt_bsp_project.cmake")
wt_bsp_apply_sdkconfig_defaults()
include($ENV{IDF_PATH}/tools/cmake/project.cmake)
project(my_s31_app)
如果工程放在 WT_BSP 仓库外部,例如:
~/work/my_s31_app
而 WT_BSP 位于:
~/work/WT_BSP
则可以写成:
cmake_minimum_required(VERSION 3.16)
set(WT_BSP_PATH "$ENV{HOME}/work/WT_BSP")
set(EXTRA_COMPONENT_DIRS "${WT_BSP_PATH}/components")
include("${WT_BSP_PATH}/components/wt_bsp/tools/wt_bsp_project.cmake")
wt_bsp_apply_sdkconfig_defaults()
include($ENV{IDF_PATH}/tools/cmake/project.cmake)
project(my_s31_app)
main/CMakeLists.txt 通常保持简单:
idf_component_register(SRC_DIRS "."
INCLUDE_DIRS ".")
如果你的应用拆分了更多源码目录,可以在 SRC_DIRS 或 SRCS 中继续添加。
4.4 添加板级默认配置文件
idf.py set-board 会在当前工程目录查找开发板对应的默认配置文件。对于 WT9932S31-TINY,文件名应为:
sdkconfig.wt9932s31_tiny
最小内容可以包含:
CONFIG_WT_BSP_BOARD_WT9932S31_TINY=y
实际项目中还可以加入与该板卡相关的默认配置,例如分区表、PSRAM、LVGL、显示或摄像头相关配置。建议从官方示例复制同名文件,再按项目需求调整。
执行:
idf.py set-board
会生成:
sdkconfig.board
sdkconfig.board.Kconfig
这两个文件由工具生成,不建议手动编辑。
五、基础应用模板
下面是一个最小应用模板,用于初始化 BSP、点亮 RGB LED,并读取板卡信息。
#include "esp_err.h"
#include "esp_log.h"
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "wt_bsp.h"
static const char *TAG = "my_app";
void app_main(void)
{
esp_err_t ret = wt_bsp_init();
if (ret != ESP_OK) {
ESP_LOGE(TAG, "BSP init failed: %s", esp_err_to_name(ret));
return;
}
wt_bsp_board_t board = wt_bsp_get_board();
if (board) {
ESP_LOGI(TAG, "WT_BSP board initialized");
}
wt_bsp_rgb_t rgb = wt_bsp_get_rgb();
if (rgb) {
wt_bsp_rgb_set_pixel(rgb, 0, (wt_bsp_rgb_color_t){.r = 0, .g = 64, .b = 255});
wt_bsp_rgb_refresh(rgb);
}
while (1) {
vTaskDelay(pdMS_TO_TICKS(1000));
}
}
关键点:
wt_bsp_init()必须先调用。wt_bsp_get_*()可能返回NULL,应用必须检查。- 不要假设所有板卡都具备显示、摄像头、触摸或 SD 卡。
- 不要在应用代码中直接使用板级私有引脚宏。
六、选择、编译、烧录
6.1 选择开发板
交互方式:
idf.py set-board
非交互方式:
WT_BSP_BOARD=WT9932S31-TINY idf.py set-board
构建时直接指定:
WT_BSP_BOARD=WT9932S31-TINY idf.py build
如果工程中存在多个开发板配置文件,set-board 会列出可选开发板。选择 WT9932S31-TINY 后,目标芯片会被设置为 esp32s31。
6.2 编译
idf.py build
如果修改了板级选择、目标芯片或底层配置后遇到奇怪的编译错误,可清理后重试:
idf.py fullclean
idf.py build
6.3 烧录
s31 应用使用 FUSB 烧录:
idf.py -p /dev/ttyACM0 flash monitor
退出监视器:
Ctrl + ]
6.4 使用 menuconfig 裁剪能力
进入配置界面:
idf.py menuconfig
可以按工程需要关闭不使用的外设能力,减少初始化开销和依赖。配置后重新编译:
idf.py build
应用代码中仍然需要检查 wt_bsp_get_*() 返回值。因为某个外设可能由于硬件不支持、配置关闭或初始化失败而不可用。
七、常用 BSP 能力
7.1 RGB LED
调用顺序为:
#if WT_BSP_RGB_ENABLED
wt_bsp_rgb_t rgb = wt_bsp_get_rgb();
if (rgb != NULL) {
ESP_ERROR_CHECK(wt_bsp_rgb_set_pixel(
rgb, 0, (wt_bsp_rgb_color_t){.r = 24, .g = 0, .b = 0}));
ESP_ERROR_CHECK(wt_bsp_rgb_refresh(rgb));
}
#endif
应用设置颜色时使用 RGB 字段顺序;底层 WS2812 的 GRB 排列由 BSP 配置处理,不必在业务代码里交换颜色通道。
7.2 BOOT / SW2 按键
wt_bsp_get_button() 返回 SW2 的默认句柄。当前公共事件包括:
WT_BSP_BUTTON_EVENT_PRESS:按下。WT_BSP_BUTTON_EVENT_RELEASE:释放。WT_BSP_BUTTON_EVENT_CLICK:完整点击。WT_BSP_BUTTON_EVENT_KEEPALIVE:长按保持。
通过 wt_bsp_button_register_event_cb(button, callback, user_data) 注册回调,并检查返回值。回调中只通知任务或投递队列,耗时业务放到应用任务。
examples/get-started/button/main/main.c 展示了事件处理流程。测试普通按键时,在应用正常运行后操作 SW2;复位期间按住 SW2 会影响启动模式。
7.3 MicroSD / TF
S31 的 SDMMC 接线为 slot 0、4-bit:
| 信号 | GPIO |
|---|---|
| CLK | 24 |
| CMD | 25 |
| D0、D1、D2、D3 | 20、21、22、23 |
卡槽电源为 3.3 V,当前 BSP 的 SD pad 使用片上 LDO1、1.8 V。卡槽 VCC 与主控信号电源域不能混为一谈,GPIO20~25 也不是可任意改线的 s31 GPIO matrix 用法。
BSP 初始化只准备资源,应用显式挂载后才能访问文件:
#if WT_BSP_SDMMC_ENABLED
wt_bsp_sdmmc_t sdmmc = wt_bsp_get_sdmmc();
if (sdmmc != NULL) {
esp_err_t ret = wt_bsp_sdmmc_mount(sdmmc);
if (ret == ESP_OK) {
const char *mount_point = wt_bsp_sdmmc_get_mount_point(sdmmc);
ESP_LOGI("storage", "Mounted at %s", mount_point);
} else {
ESP_LOGE("storage", "Mount failed: %s", esp_err_to_name(ret));
}
}
#endif
examples/storage/sdmmc 会创建或覆盖 /sdcard/hello.txt、删除已有 foo.txt 并进行重命名/读取测试。应使用测试卡,不要直接对存放重要文件的卡执行该示例。
BSP 不会在挂载失败时自动格式化卡。写入后及时关闭文件;重要数据按业务需要同步。更换卡片前停止写入并断电,不把 RGB 灯色当成文件收尾完成的证明。
7.4 HUSB USB CDC
USB CDC通信案例: examples/usb/device_cdc:
cd WT_BSP/examples/usb/device_cdc
idf.py --preview set-board
idf.py --preview build
idf.py --preview -p $flashPort flash
构建前按 6.2 节将主日志控制台设为 FUSB USB Serial/JTAG;烧录仍使用 FUSB。固件启动后连接 HUSB,电脑应出现应用提供的 Wireless-Tag CDC 串口。打开该串口时需要启用 DTR,发送的字节会原样回显。
两个端口承担不同任务:
- FUSB:查看
usb_device_cdc应用启动日志、再次下载。 - HUSB:发送/接收本示例的回显数据。
USB CDC 的“115200 波特率”是串口应用设置,不等于 USB 总线传输速度。验证回显时应关闭串口工具的“本地回显”,避免把本地显示误判为板端返回。
应用通过 wt_bsp_get_usb_device_cdc() 获取句柄:
wt_bsp_usb_device_cdc_is_mounted()表示 USB 已被主机配置,不要求打开 CDC。wt_bsp_usb_device_cdc_is_connected()表示主机已置 DTR。wt_bsp_usb_device_cdc_read()读取当前已收到的数据。wt_bsp_usb_device_cdc_write()报告实际排队字节数,可能短写;只重试尚未排队的后缀。
当前硬件没有可用于该功能的 J1 VBUS 检测线。这两个软件状态都不能直接视为物理拔线检测;FUSB 继续供电时,仅拔掉 HUSB 不保证立即清除枚举状态。
BSP 持有 TinyUSB 驱动,应用不要再安装第二个 USB 栈或自行释放 BSP 句柄。
7.5 DVP 摄像头与 UVC
S31 使用 DVP FPC,不使用 MIPI CSI。连接摄像头前先断开两根 USB 线,核对 24Pin 接口线序、接触面、排线方向和电压;针数相同不代表兼容。
独立 UVC 示例:
cd WT_BSP/examples/camera/usb_device_uvc
idf.py --preview set-board
idf.py --preview menuconfig
idf.py --preview build
idf.py --preview -p $flashPort flash
在menuconfig配置中,在 WT BSP → Camera sensor 选择实际摄像头:
| 摄像头 | 当前独立 UVC 配置 | 编码路径 |
|---|---|---|
| GC2145 / 匹配模块,默认 | MJPEG 1600×1200,标称 8 FPS,Bulk | DVP 图像进入 S31 硬件 JPEG |
| OV3660 | MJPEG 640×480,标称 25 FPS,Isochronous | 传感器原生 JPEG |
这些是示例配置,不是本轮实测帧率。两种型号共用 SCCB 地址 0x3c,必须编译时选择与实物一致的驱动,不能仅凭地址判断型号。
固件成功启动后,将 HUSB 连接电脑,使用兼容 UVC 的软件选择 Wireless-Tag Camera。FUSB 仍用于日志和下载。
本 UVC 示例由 wt_bsp_init() 管理摄像头与 USB 资源;S31 的 wt_bsp_get_csi() 始终返回 NULL。本地 JPEG 采集使用 wt_bsp_get_camera()、wt_bsp_camera_prepare()、wt_bsp_camera_capture() 和 wt_bsp_camera_get_status()。capture 回调拿到的帧只在回调期间有效,不能将其数据指针保存后继续使用。
USB 已拥有采集路径时,本地 capture 可能返回 ESP_ERR_INVALID_STATE。应用不要并发重复初始化 esp_video、TinyUSB 或相机生命周期。
独立 UVC 与独立 CDC 不是把两个示例简单叠加即可共存。S31 的复合设备实现应参考工厂示例。
八、基于出厂示例做功能开发
examples/wt_factory/wt9932s31-tiny 同时使用摄像头、SDMMC、RGB、SW2 和 HUSB UVC+CDC,适合作为综合业务的起点。
8.1 构建与配置
cd WT_BSP/examples/wt_factory/wt9932s31-tiny
idf.py --preview set-board
idf.py --preview menuconfig
idf.py --preview build
idf.py --preview -p $flashPort flash
- menuconfig:在
WT BSP → Camera sensor选择 GC2145 或 OV3660。 - menuconfig:
S31 factory → Enable SD card recording控制 SD 录像。 - 当前示例默认关闭录像:仍检查摄像头和 SD,不创建录像目录或文件。
- 启用录像后才会创建 MJPEG AVI 分段,使用前检查卡容量和既有数据。
- 两款摄像头均使用 Bulk,不能将独立 OV3660 示例的 Isochronous 配置直接当作工厂设备配置。
8.2 FUSB 与 HUSB 的用法
- J2/FUSB:下载、启动日志和诊断日志。
- J1/HUSB:枚举为 UVC 摄像头及 CDC 诊断串口。
- 默认未连 HUSB 时,示例进行离线检查;启用录像时按配置录制。
- HUSB 完成枚举后进入 USB 模式,停止离线录像,提供 UVC 和 CDC。
- 从 USB 模式回到离线模式:拔掉 HUSB,保留 FUSB 供电,再按 SW1/EN 复位。
8.3 CDC 诊断命令
工厂 CDC 与独立 CDC 回显示例的协议不同。出厂示例打开 HUSB 串口、启用 DTR 后,发送 ASCII 命令并以换行结束:
| 命令 | 作用 |
|---|---|
ping |
返回 pong |
status |
返回模式、录像配置、摄像头/SD 状态等 JSON |
list |
列出符合规则的已完成录像,最后返回 END |
get rec_000001.avi |
读取一个已完成录像,包含长度头、二进制数据和结束标记 |
每次完整读完上一条响应后再发下一条。list/get 有 USB 模式和存储状态限制,不能将其当成任意文件访问接口。FUSB 日志不会混入 HUSB 的二进制文件数据。
8.4 RGB 与按键
工厂示例的颜色状态代表:
| 状态 | RGB |
|---|---|
| 摄像头、SD、按键注册与 CDC 控制台均正常 | 绿色 |
| SD 异常,摄像头正常 | 红色 |
| 摄像头异常,SD 正常 | 蓝色 |
| 摄像头和 SD 均异常 | 黄色 |
| 摄像头与 SD 正常,但按键回调注册或 CDC 控制台异常 | 白色 |
| SW2 手动关闭灯光 | 熄灭,不能据此判断硬件是否正常 |
SW2 每按一次切换灯光亮/灭;启用录像且在离线模式时,还会同时暂停/恢复录像。复位后恢复默认亮灯。启动检测期间的短暂红灯不能单独判定为 SD 故障。
上述是该示例的逻辑,不是所有 WT_BSP 应用的通用灯色定义。录像是否已安全结束,应以暂停及文件收尾日志确认,不能只看颜色。
8.5 改造成自己的应用
建议按顺序进行:
- 先用未修改的对应配置完成编译、烧录和运行。
- 保留
wt_bsp_init()与板级资源获取方式。 - 将相机、SD 和 USB 的业务处理移到自己的任务或状态机。
- 删除不用的录像、诊断命令或 UI 逻辑。
- 最后再调整分区表、缓冲区、日志等级和性能参数。
- 每次只更改一组行为,保留可回退的版本与验证日志。
仓库 README 中的旧实机记录只能作为历史背景;新业务、不同传感器或不同主机仍需重新验证。
九、调试建议与常见问题
9.1 模块日志
每个业务模块使用自己的 TAG:
static const char *TAG = "my_module";
ESP_LOGI(TAG, "module started");
先确认启动信息中的 SDK、目标芯片、Flash、PSRAM 与工程名,再分析 BSP 外设日志。不要把另一个示例或旧固件的输出误认为当前运行结果。
9.2 构建目录与依赖
同一工程可使用不同构建目录:
idf.py --preview -B build_debug build
idf.py --preview -B build_release build
同一构建目录不要混用不同板卡或传感器配置。新建 build_debug、build_release 等目录时,会生成各自的 SDKCONFIG;主控制台等配置需在各目录设置,或由自有工程默认配置提供。Component Manager 会生成 managed_components/ 和 dependencies.lock,团队应保留 lock 文件,记录经过验证的组件版本。
9.3 故障定位
| 现象 | 优先检查 |
|---|---|
| 找不到下载串口 | 是否接 J2/FUSB、数据线是否支持数据、端口是否变化 |
| 两个 COM 不知道选哪个 | FUSB 看 USB Serial/JTAG;HUSB 看应用枚举,必要时分别拔插确认 |
| 烧录连接失败 | 关闭占用串口的程序,按 BOOT+RESET 操作进入下载模式 |
| HUSB 在 blink 下没有设备 | blink 关闭 CDC/UVC,属于预期;烧对应 USB 示例再测试 |
| FUSB 能下载但没有启动日志 | 检查主控制台是否为 USB Serial/JTAG,在监视器就绪后复位;blink 不会持续打印日志 |
| CDC 不回显 | 是否连接 HUSB、选择应用 COM、启用 DTR、关闭本地回显 |
esp32s31 目标被拒绝 |
SDK 是否至少 v6.1,v6.1 命令是否带 --preview |
| SDKCONFIG 与板卡不一致 | 回到工程目录重新选板,检查生成配置及构建目录 |
| 实际 Flash 比镜像配置大 | 检查 S31 16MB 板级默认配置是否生效 |
| TinyUSB 依赖复制时报 No such file,或 Windows 路径过长 | 把仓库重新克隆到短 ASCII 路径,例如 C:\espwork\WT_BSP,重新构建;不要复用深目录中的 managed_components/build,也不必为此全局修改注册表 |
| SD 挂载失败 | 卡格式、接触、BSP 电源域配置 |
| 相机探测失败 | DVP 接线、传感器型号、编译配置;断电检查排线 |
| UVC 正常不代表本地 capture 正常 | 检查当前 USB 是否拥有采集路径及本地 Camera 功能开关 |
| 仅拔掉 HUSB 后离线模式未恢复 | J1 无可靠 VBUS 检测,按说明拔线后复位 |
| 启动反复复位 | 保存完整 FUSB 日志,区分电源问题、panic、看门狗与应用主动复位 |
电脑 USB 口建议能提供至少 5V/1A,使用质量良好的数据线。连接相机、换卡或调整接线前断电;两根 USB 都接着时要断开两根,不能只拔一根。
十、开发规范建议
- 应用层通过
wt_bsp.h和公共 feature API 操作资源。 - 所有 getter 检查
NULL,所有关键esp_err_t返回值处理错误。 - 功能关闭时需要让应用仍能构建,可使用 BSP 功能宏保护相应代码。
- 不把摄像头、USB 和存储耗时工作放到按键或 USB 回调中。
- 相机回调数据是借用帧,回调结束后不得继续引用。
- USB CDC 短写只重试未排队数据,不重复发送整块。
- 不把 HUSB 枚举状态当成精确的物理插线检测。
- 重要写入按业务需要同步,断电前完成关闭;使用测试卡验证写入流程。
- 记录 SDK、BSP commit、lock、板卡型号、传感器型号、配置与主机端口。
- 日志中的时间、COM、MAC、构建目录与样机相关,不应作为产品常量。
十一、推荐阅读顺序
- 根目录
README_CN.md:支持板卡和仓库使用方式。 components/wt_bsp/boards/WT9932S31-TINY/README.md:S31 引脚、USB 与摄像头边界。examples/get-started/blink:选板、BSP 初始化与 RGB。examples/get-started/button:按键事件。examples/usb/device_cdc:HUSB CDC 与 FUSB 分工。examples/storage/sdmmc:挂载与文件操作。examples/camera/usb_device_uvc:S31 DVP/UVC 部分。examples/wt_factory/wt9932s31-tiny:复合 USB、摄像头与存储。components/wt_bsp/include/wt_bsp.h及features/*/include/:公共 API。
板卡资源与 USB 接线依据官方板卡功能说明和本节链接的固定 BSP 提交核对。
官方参考: