USB¶

本文说明本章节功能的接入方式、关键源码和应用参考，帮助开发者快速完成集成。

1. 参考代码¶

文件	作用
`solution\components\usb_mstorage\usb_detection.c`	检测 USB 插拔状态并通知业务层
`solution\components\usb_mstorage\usb_mstorage.c`	实现 USB Mass Storage 模式的数据访问流程
`solution\components\usb_mstorage\usb_ota.c`	通过 USB 通道接收并触发 OTA 升级

场景	文件	调用接口
USB 存储弹窗	`popup_usb_storage.c`	`app_usb_mount_enable()`、`ota_set_ui_invalid()`

该文档围绕 USB 应用展开，主要从简介、从机与主机的定义及应用场景、配置方法、主要特性和使用注意事项等方面进行说明。

USB-SLAVE（从设备）是指在 USB 通信中，设备作为被动端响应主机（Host）的请求，完成数据的收发和控制。

常见的 USB-SLAVE 应用场景包括：

在这些场景中，USB-SLAVE 设备通过标准的 USB 协议与主机进行通信，实现即插即用、跨平台的数据交换和控制功能。

目前在平台中已经调试完成的应用场景如下：

USB-HOST（主机）是指在 USB 通信中，设备作为主动端发起对从设备（Device）的控制和数据传输。主机负责总线管理、设备枚举、供电和数据交换等任务。

常见的 USB-HOST 应用场景包括：

在这些场景中，USB-HOST 通过标准 USB 协议管理和访问各种 USB 从设备，实现灵活的外设扩展和数据交互。

按下表打开 USB Device，并按产品形态选择设备类。

步骤	路径	配置项	说明
1	`SiFli SDK configuration → Board Config → On-chip Peripherals → USB Device`	`BSP_USING_USBD`	USB Device 硬件开关。打开后会选中 `RT_USING_USB_DEVICE`；PC Simulator 不显示该板级菜单。
2	`RTOS → RT Thread → RT-Thread Components → Using USB → Using USB device`	`RT_USING_USB_DEVICE`	USB 设备协议栈。先打开第 1 步硬件开关，再选择 CDC、Mass Storage、HID、Printer、RNDIS、ECM 或 WinUSB。
3	同上	`USB_VENDOR_ID` / `USB_PRODUCT_ID`	配置设备 VID/PID，默认分别为 `0x38F4` / `0x0001`。

注意

USB Device 的 Enable USB TX DMA (USB_TX_DMA_ENABLED) 与 Enable USB RX DMA (USB_RX_DMA_ENABLED) 仅在非 SF32LB55X 平台显示，且默认均为启用；SF32LB55X 不支持 USB DMA。

按下表打开 USB Host，并选择需要支持的外设类型。

步骤	路径	配置项	说明
1	`SiFli SDK configuration → Board Config → On-chip Peripherals → USB Host`	`BSP_USING_USBH`	USB Host 硬件开关。打开后会选中 `RT_USING_USB_HOST`；PC Simulator 不显示该板级菜单。
2	`RTOS → RT Thread → RT-Thread Components → Using USB → Using USB host`	`RT_USING_USB_HOST`	USB Host 协议栈。先打开第 1 步硬件开关。
3	同上	`RT_USBH_MSTORAGE` / `RT_USBH_HID` / `RT_USBH_RNDIS`	按实际外设选择 U 盘、HID 或 RNDIS；RNDIS 会显示并默认启用 `RT_USBH_RNDIS_DEV`。

注意

SF32LB55X 仅支持 USB Device，不支持 USB Host；请勿在该平台配置 BSP_USING_USBH。

目前在平台中已经调试完成的应用场景如下：

56x/52x 芯片拥有 ep0~ep7 8 个通道，其中 ep2~ep4 只支持 rx (即 host 只支持 IN，device 只支持 OUT)，ep5~ep7 只支持 tx (即 host 只支持 OUT，device 只支持 IN)；
55x 芯片不支持 DMA 模式；只支持 device 模式
58x 芯片 ep0~ep7 8 个通道都支持 IN 与 OUT; 支持高速（HS）、全速模式（FS）

//禁止睡眠
rt_pm_request(PM_SLEEP_MODE_IDLE);

//退出禁止睡眠
rt_pm_release(PM_SLEEP_MODE_IDLE);

//禁止降频
rt_pm_hw_device_start();

//退出禁止降频
rt_pm_hw_device_stop();