STM32 USB复合设备简易创建指南：I-CUBE-USBD-Composite

STM32 USB复合设备简易创建指南：I-CUBE-USBD-Composite

I-CUBE-USBD-Composite Create STM32 USB Composite devices with ease. 项目地址: https://gitcode.com/gh_mirrors/ic/I-CUBE-USBD-Composite

项目基础介绍

I-CUBE-USBD-Composite 是一款专为STM32微控制器设计的开源项目，由alambe94维护于GitHub。此项目提供了一个简便的方式来利用ST公司的USB堆栈创建USB复合设备。USB复合设备指的是能在单个USB接口上呈现多种功能的设备，如同时具备串口通讯（CDC）和人机界面设备（HID）等功能。项目基于MIT许可协议发布，广泛适用于从工业控制到个人创意项目的各种场景。

主要编程语言

本项目核心部分主要采用 C 语言编程，适配STM32系列MCU的固件开发环境。

关键技术和框架

• STM32CubeMX: 配置工具，用于初始化项目设置和生成初始化代码。
• ST USB Stack: ST意法半导体提供的USB库，项目对其进行了二次封装以支持更便捷的复合设备开发。
• HAL库: STM32硬件抽象层，简化了底层硬件的访问。

安装和配置教程

准备工作

1. 开发环境: 确保安装有STM32CubeIDE或者类似的支持STM32的IDE。
2. STM32CubeMX: 下载并安装STM32CubeMX配置工具。
3. Git: 如需从GitHub克隆项目，确保已安装Git。

安装步骤

步骤1：获取源码

• 打开命令行工具，使用以下命令克隆项目：

  git clone https://github.com/alambe94/I-CUBE-USBD-Composite.git
  

步骤2：配置STM32CubeMX

1. 打开STM32CubeMX。
2. 选择或导入你的STM32芯片型号。
3. Project Manager 设置中，添加 AL94_I-CUBE-USBD-COMPOSITE 作为中间件包，如果尚未自动列出，则需手动添加路径指向刚克隆的项目目录。
4. 配置USB选项，启用USB外设，并选择“USB Composite Device”作为USB类型。
5. 根据需要启用特定的USB类（例如CDC、HID等）。
6. 完成配置后，生成代码。

步骤3：在IDE中配置项目

1. 在STM32CubeIDE中打开刚生成的项目文件夹。
2. 进入项目设置，确保USB相关的中断和服务已被正确配置。
3. 查找并调用 MX_USB_DEVICE_Init() 函数以手动初始化USB设备。

步骤4：调整参数和测试

• 根据具体MCU的资源，可能需要调整“Target/usbd_conf.c”中的端点大小和PMA缓冲区。
• 对于某些USB类，检查是否需启用“SOF”帧。
• 确认MCU的时钟配置，并确保USB中断已开启。对于STM32L5系列，记得调用 HAL_PWREx_EnableVddUSB() 函数。

步骤5：编译与调试

• 编译项目，解决任何可能出现的编译错误。
• 烧写代码至STM32，并进行功能测试，验证各USB类的功能是否正常工作。

至此，您已经成功配置和测试了使用I-CUBE-USBD-Composite创建的STM32 USB复合设备。记得根据实际应用场景调整配置，享受自定义USB设备带来的便利与乐趣！

I-CUBE-USBD-Composite Create STM32 USB Composite devices with ease. 项目地址: https://gitcode.com/gh_mirrors/ic/I-CUBE-USBD-Composite