DFU V2 CDC Loader 示例

源码路径：example/dfu_v2/cdc/loader

支持的平台

本例程是 DFU V2 在 USB-CDC 通道上的 DFU loader 子程序。它独立烧写在 DFU_V2_LOADER 分区，开机由 bootloader 在检测到升级标志后跳入，负责通过 USB-CDC 接收新固件并直写目标分区，可选地在屏幕上显示升级进度。

本 loader 通常无需单独构建：CDC 用户应用工程的 SConstruct 通过 AddDFU_CDC(SIFLI_SDK)（见 tools/build/building.py）把它作为子工程自动加入，构建用户应用时会一并生成 loader 固件。也可以单独构建本 loader。

运行该例程前，需要准备：

本例程的关键配置（已在 proj.conf 中默认开启）：

CONFIG_USING_DFU_V2=y — 启用 DFU V2 中间件。
CONFIG_DFU_V2_USE_CDC_TRANSPORT=y — 选择 USB-CDC 作为 DFU 传输通道。
CONFIG_PKG_USING_CHERRYUSB=y / CONFIG_PKG_CHERRYUSB_DEVICE=y — 启用 CherryUSB 设备栈。
CONFIG_PKG_CHERRYUSB_DEVICE_MUSB_SIFLI=y — SiFli MUSB USB 设备控制器驱动。
CONFIG_PKG_CHERRYUSB_DEVICE_CDC_ACM=y — CDC ACM 设备类。
CONFIG_PKG_USING_LITTLEVGL2RTT=y / CONFIG_LVGL_V9=y — 启用 LVGL（v9）升级界面；关闭后 loader 仍可完成升级，仅不显示 UI。
CONFIG_PKG_SIFLI_MBEDTLS_BOOT=y — 引导阶段固件校验所需的 mbedTLS 支持。

直接构建 CDC 用户应用（会自动带上本 loader），切换到用户应用 project 目录，运行 scons 命令执行编译：

> scons --board=sf32lb52-lcd_n16r8_hcpu -j8

如需单独构建本 loader，切换到本例程 project 目录，运行 scons 命令执行编译：

> scons --board=sf32lb52-lcd_n16r8_hcpu -j8

产物在对应的 build_<board> 目录下。关于编译、下载的详细步骤，请参考快速入门的相关介绍。

烧入工程后，板子运行的是用户应用（屏幕显示版本号 Ver: 1.0.9）。
PC 端通过 USB-CDC 向用户应用发送 4 字节触发魔数 0xAA 0x55 0xDF 0x00；应用回 ACK 0xAA 0x55 0xDF 0x01，随后调用 dfu_enter_dfu_mode() 写下升级标志并重启。
bootloader 重启后检测到升级标志，跳入本 loader（DFU_V2_LOADER 分区）。loader 在 main() 中先 dfu_init() 初始化中间件，再 dfu_check_install() 处理可能的待装任务，然后等待 USB-CDC 连接。
PC 工具连上后把新固件分块发给 loader。loader 通过 dfu_process() 接收并直写目标分区，期间 on_dfu_event() 回调把进度推给 LVGL 界面，屏幕显示百分比；全部完成后弹出成功提示。
loader 完成安装并重启，bootloader 跳回新的用户应用。屏幕上的版本号变化即可确认升级成功。

调试时可在串口控制台用 cdc_dfu_info 命令查看 USB 就绪状态与当前传输进度。