WT9932S31-TINY 开发指南

  • WT9932S31-TINY
  • ESP32-S31
  • WT_BSP
  • BSP
  • ESP-IDF
  • FUSB
  • HUSB
更新历史
日期 版本 作者 更新内容
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 开发的核心思路是:

  1. 应用工程通过 components/wt_bsp 引入 BSP 组件。
  2. 使用 idf.py set-board 选择 WT9932S31-TINY。
  3. 应用调用 wt_bsp_init() 初始化板级资源。
  4. 应用通过 wt_bsp_get_rgb()、wt_bsp_get_button()、wt_bsp_get_sdmmc()、wt_bsp_get_dsi()、wt_bsp_get_csi()、wt_bsp_get_touch() 获取资源句柄。
  5. 应用根据返回值判断功能是否可用,并实现自己的业务逻辑。

这样做的好处是:

  • 应用代码不绑定具体硬件引脚。
  • 同一个示例可以较低成本适配多块 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,便于其他开发者复现相同的构建环境。

每次更新 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,确认硬件连接和构建步骤,再以该示例为基线开发。

如果是第一个自定义应用,建议从 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 改造成自己的应用

建议按顺序进行:

  1. 先用未修改的对应配置完成编译、烧录和运行。
  2. 保留 wt_bsp_init() 与板级资源获取方式。
  3. 将相机、SD 和 USB 的业务处理移到自己的任务或状态机。
  4. 删除不用的录像、诊断命令或 UI 逻辑。
  5. 最后再调整分区表、缓冲区、日志等级和性能参数。
  6. 每次只更改一组行为,保留可回退的版本与验证日志。

仓库 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、构建目录与样机相关,不应作为产品常量。

十一、推荐阅读顺序

  1. 根目录 README_CN.md:支持板卡和仓库使用方式。
  2. components/wt_bsp/boards/WT9932S31-TINY/README.md:S31 引脚、USB 与摄像头边界。
  3. examples/get-started/blink:选板、BSP 初始化与 RGB。
  4. examples/get-started/button:按键事件。
  5. examples/usb/device_cdc:HUSB CDC 与 FUSB 分工。
  6. examples/storage/sdmmc:挂载与文件操作。
  7. examples/camera/usb_device_uvc:S31 DVP/UVC 部分。
  8. examples/wt_factory/wt9932s31-tiny:复合 USB、摄像头与存储。
  9. components/wt_bsp/include/wt_bsp.h 及 features/*/include/:公共 API。

板卡资源与 USB 接线依据官方板卡功能说明和本节链接的固定 BSP 提交核对。

官方参考: