以下是使用 STM32CubeMX 配置 USB 功能的简明教程（以 USB Device 模式为例）：

1. 创建新工程

1. 打开 STM32CubeMX，点击 File → New Project。
2. 在芯片选择界面，输入你的 STM32 型号（如 STM32F103C8T6），双击选中对应的芯片。

2. 配置 USB 外设

1. 启用 USB 模块：

   • 在 Pinout & Configuration 标签页，左侧找到 Connectivity 或 USB 选项。
   • 选择 USB Device（如 USB_DEVICE 或 USB_OTG_FS，具体取决于芯片型号）。
   • 自动分配的 USB 引脚（如 DP (PA12) 和 DM (PA11)）无需修改。

2. 配置时钟：

   • 进入 Clock Configuration 标签页。
   • 确保 USB 时钟为 48 MHz（USB 全速模式必需）：
     • 对于 STM32F1，需配置 PLL 输出为 72 MHz，再分频得到 48 MHz。
     • 其他系列（如 F4/F7/H7）需通过 PLL 直接生成 48 MHz。

3. 配置 USB 中间件

1. 在 Middleware 部分，选择 USB_DEVICE。

2. 选择设备类（Class）：

   • Human Interface Device (HID)：用于鼠标、键盘等。
   • Communication Device Class (CDC)：虚拟串口。
   • Mass Storage Class (MSC)：U盘模式。
   • 其他类（如自定义类）。

3. 设置参数（以 CDC 为例）：

   • 在 Configuration 标签页下，配置端点大小、缓冲区等（通常默认即可）。

4. 生成代码

1. 进入 Project Manager 标签页：
   • 设置工程名称、存储路径。
   • 选择 IDE（如 STM32CubeIDE、Keil 等）。
2. 点击 Generate Code 生成工程。

5. 编写用户代码

1. USB 初始化：

   • 生成的代码会自动初始化 USB 外设，无需手动修改。

2. 实现功能逻辑（以 CDC 为例）：

   • 发送数据：调用 CDC_Transmit_FS() 函数。

     uint8_t data[] = "Hello USB!";
     CDC_Transmit_FS(data, sizeof(data));

   • 接收数据：在 CDC_Receive_FS() 回调函数中处理接收的数据。

6. 烧录与测试

1. 将程序烧录到开发板。
2. 用 USB 线连接开发板与电脑：
   • HID 设备：在设备管理器中查看是否识别为 HID 设备。
   • CDC 设备：安装驱动（如 STM32 Virtual COM Port Driver），用串口工具测试通信。
   • MSC 设备：电脑应识别为 U 盘（需实现存储介质驱动）。

常见问题

1. USB 无法识别：

   • 检查 USB 时钟是否为 48 MHz。
   • 确认 USB 描述符（usbd_desc.c）正确。
   • 检查硬件连接（DP/DM 是否接反，是否需外接 1.5kΩ 上拉电阻）。

2. 端点冲突：

   • 确保不同 USB 类或功能使用的端点不冲突。

参考资源

• ST 官方文档：UM1718（STM32CubeMX 用户手册）
• 例程：STM32CubeMX 安装目录下的 \STM32Cube\Repository\STM32Cube_FW_xxx\Projects\USB_Device 示例。

如有具体需求（如 HID 或 CDC 详细配置），可进一步说明！