USB設(shè)備

USB 控制器驅(qū)動包括設(shè)備驅(qū)動和主機(jī)驅(qū)動，我們只啟用設(shè)備驅(qū)動。 它有兩層：硬件訪問層（HAL）和RT-Thread的適配層。
HAL 提供用于訪問 USB 控制器外圍設(shè)備的寄存器的基本 API。 有關(guān)詳細(xì)信息，請參閱 USB HAL 的 API 文檔。
適配層提供對 RT-Thread 驅(qū)動框架的支持。 用戶可以使用 RT-Thread POSIX 驅(qū)動程序接口對 USB 設(shè)備進(jìn)行編程。 請參閱 RT-Thread 驅(qū)動程序的 API 文檔。
主要功能包括：

• Mstorage 存儲支持
• VCOM 支持
• 支持復(fù)合設(shè)備
• 最多 8 個端點

Note

只有SF32LB58X系列支持USB 2.0 high speed mode, SF32LB55X/SF32LB56X僅支持USB full/low speed.

驅(qū)動配置

硬件驅(qū)動程序可以用作 mstorage、ecm、hid、vcom。 可以使用menuconfig 工具為每個項目選擇函數(shù)及其外設(shè)，通常保存在C 頭文件中。 默認(rèn)情況下，配置保存為 rtconfig.h。

以下示例顯示在一個項目頭文件中定義的標(biāo)志，該項目使用 MSTORAGE 和 VCOM。 為 BSP 選擇配置的步驟：

• 在項目下的命令中輸入“menuconfig”
• 選擇“RTOS —>”
• 選擇“On-chip Peripheral Driver—>”
• 選擇“Enable USB Device”啟用USB驅(qū)動，定義宏BSP_USING_USBD

  #define BSP_USING_USBD

為操作系統(tǒng)選擇配置的步驟（在 menuconfig 主菜單中）：

• 選擇“RTOS”—>
• 選擇“RT-Thread Components—>”
• 選擇“Device Driver—>”
• 選擇“Using USB —>”
• 選擇“Enable USB device” 啟用 USB 設(shè)備模式，定義 RT_USING_USB_DEVICE
• 啟用“Enable composite device”
• 啟用“Enable to use device as CDC device” 使能將設(shè)備用作CDC設(shè)備 USB可以用作CDC VCOM設(shè)備，定義RT_USB_DEVICE_CDC
• 啟用“Enable to use device as Mass Storage device” 啟用將設(shè)備用作大容量存儲設(shè)備 USB 可以用作 mstorage 設(shè)備，定義 RT_USB_DEVICE_MSTORAGE
• "msc class disk name" 輸入存儲設(shè)備，通常我們使用flash，所以輸入mtd設(shè)備名如"flash1"

#define RT_USING_USB_DEVICE
#define RT_USBD_THREAD_STACK_SZ 4096
#define USB_VENDOR_ID 0x0FFE
#define USB_PRODUCT_ID 0x0001
#define RT_USB_DEVICE_COMPOSITE
#define RT_USB_DEVICE_CDC
#define RT_USB_DEVICE_NONE
#define RT_USB_DEVICE_MSTORAGE
#define RT_VCOM_TASK_STK_SIZE 512
#define RT_VCOM_SERNO "32021919830108"
#define RT_VCOM_SER_LEN 14
#define RT_VCOM_TX_TIMEOUT 1000
#define RT_USB_MSTORAGE_DISK_NAME "flash1"

配置完成后，用戶需要在所有需要訪問驅(qū)動程序的源代碼中包含頭文件。

使用USB設(shè)備

在上述配置中，插入USB接口，PC上可以識別出USB 硬盤和一個USB串口，使用方式和其他USB硬盤/串口一致。