STM32 USB 实现

STM32 有三种 USB 设备控制器，见下表。完整的端点配置可以参考代码生成工具生成的 CDC 代码。
设备序列号建议使用芯片内置 UID：把 UID 的地址和长度作为构造函数的最后一个参数传入，协议栈将其转换为十六进制字符串追加在 Serial 前缀之后。

控制器	对应类	角色	说明
`USB_BASE / FSDEV`	`LibXR::STM32USBDeviceDevFs`	从机	FSDEV / DRD FS 的设备侧路径
`USB_OTG_FS`	`LibXR::STM32USBDeviceOtgFS`	主机/从机中的设备侧	OTG FS 设备路径
`USB_OTG_HS`	`LibXR::STM32USBDeviceOtgHS`	主机/从机中的设备侧	OTG HS 设备路径

`STM32USBDeviceDevFs`

STM32USBDeviceDevFs 支持两种端点声明方式，缓冲区端点号自动递增：

{usb_fs_ep0_in_buf, usb_fs_ep0_out_buf, 8, 8}：声明一个双向端点
- usb_fs_ep0_in_buf: EP0 IN软件缓冲区数组
- usb_fs_ep0_out_buf: EP0 OUT软件缓冲区数组
- 8: EP0 IN硬件RAM大小
- 8: EP0 OUT硬件RAM大小
{usb_fs_ep2_in_buf, 16, true}：声明一个单向端点
- usb_fs_ep2_in_buf: EP2 IN软件缓冲区数组
- 16: EP2 IN硬件RAM大小
- bool: 是in方向

为了确保传输速度，对于bulk端点，硬件RAM大小应当不小于64，软件缓冲区可以远大于64，大小与传输速度成正比。

STM32USBDeviceDevFs usb_fs(
    /* USB Handler */
    &hpcd_USB_FS,
    /* Endpoints */
    {
        {usb_fs_ep0_in_buf, usb_fs_ep0_out_buf, 8, 8},
        {usb_fs_ep1_in_buf, usb_fs_ep1_out_buf, 128, 128},
        {usb_fs_ep2_in_buf, 16, true}
    },
    USB::DeviceDescriptor::PacketSize0::SIZE_8,
    0x1D50, 0x6199, 0x0100,
    /* 语言包（内部包含可读 Serial Number 字符串前缀） */
    {&USB_FS_LANG_PACK},
    /* Classes */
    {{&usb_fs_cdc}},
    /* Serial Number UID（STM32 UID 原始字节的地址和长度） */
    {reinterpret_cast<void *>(UID_BASE), 12}
);

代码块已折叠

USB_OTG_FS/USB_OTG_HS

STM32USBDeviceOtgHS和STM32USBDeviceOtgFS同样支持两种端点声明方式，IN/OUT端点缓冲区端点号各自自动递增：

{{usb_otg_fs_ep0_in_buf, 8},...}：in端点必须声明缓冲区与Fifo大小
{usb_otg_fs_ep0_out_buf, ...}：out端点只需要声明缓冲区

所有out端点共用一个rx fifo，应该分配较大的空间。为了保证速度，IN端点Fifo的大小不应小于包大小，软件缓冲区大小与传输速度成正比。

// STM32USBDeviceOtgHS usb_hs(
STM32USBDeviceOtgFS usb_fs(
    /* USB Handler */
    &hpcd_USB_OTG_FS,
    /* RX Fifo Size */
    256,
    /* Out Endpoints */
    {usb_otg_fs_ep0_out_buf, usb_otg_fs_ep1_out_buf},
    /* In Endpoints */
    {{usb_otg_fs_ep0_in_buf, 8}, {usb_otg_fs_ep1_in_buf, 128}, {usb_otg_fs_ep2_in_buf, 16}},
    USB::DeviceDescriptor::PacketSize0::SIZE_8,
    0x1D50, 0x6199, 0x0100,
    /* 语言包（内部包含可读 Serial Number 字符串前缀） */
    {&USB_OTG_FS_LANG_PACK},
    /* Classes */
    {{&usb_otg_fs_cdc}},
    /* Serial Number UID（STM32 UID 原始字节的地址和长度） */
    {reinterpret_cast<void *>(UID_BASE), 12}
);
usb_fs.Init(false);
usb_fs.Start(false);

代码块已折叠

运行

添加以下语句即可。

usb_fs.Init(false);
usb_fs.Start(false);

STM32USBDeviceDevFs​

USB_OTG_FS/USB_OTG_HS​

运行​

`STM32USBDeviceDevFs`

USB_OTG_FS/USB_OTG_HS

运行