前言
本文档描述 STM32Cube™ 的 USB 主机库中间件模块。
众所周知，通用串行总线 （USB）是介于作为主机的个人计算机 （PC）与所连接的 USB 外设之间的事实通信标准。目前嵌入式便携设备数量日益增多，USB 主机已不再局限于 PC，嵌入式消费终端与工业设备作为主机已越来越普遍，而嵌入式主机功能有限，仅支持特定的USB 类 （比如大容量存储类、虚拟通信端口等）或特定的供应商设备。
本文档详细描述了 STM32Cube™ USB 主机库，即在 STM32CubeF2 和 STM32CubeF4 软件包中所提供的 USB 主机协议栈。它使用 STM32 微控制器作为 USB 嵌入式主机，与各种USB 类的 USB 外设进行通信 （MSC、 HID、 CDC、音频和 MTP）。
STM32Cube™ 软件包是一款免费解决方案，可以从意法半导体网站下载：


1 STM32Cube™ 概述
STMCube™ 计划源自意法半导体，旨在通过减少开发的工作量、时间与成本，使开发者受益。 STM32Cube™ 将涵盖 STM32 全线产品组合。
STM32Cube™1.x 版包括：
• 图形软件配置工具 STM32CubeMX，可通过图形向导生成初始化 C 代码。
• 针对每个系列提供综合的嵌入式软件平台，（比如用于 STM32F4 系列的 STM32CubeF4）
– STM32 抽象层嵌入式软件 STM32Cube HAL，确保用户应用在 STM32 各个产品之间实现最大限度的可移植性。
– 一套中间件组件，比如 RTOS、 USB、 TCP/IP、图形处理。
– 一整套例程用于演示所有嵌入式软件功能。





2 简介
本文档描述 STM32Cube 的 USB 的主机库中间件模块。
USB 主机库处于 STM32Cube USB 主机 HAL 驱动之上。该库提供用于访问各类 USB 设备的 API。
USB 主机模块可用于实现主要的 USB 类。
• 大容量存储类 （MSC） • 人机接口鼠标与键盘类 （HID） • 通信设备类 （CDC） • 音频类 （AUDIO） • 媒体传输协议类 （MTP）
除了以上所列的类以外，用户还能通过库提供的 API 来实现自己的应用类别。
该库可单独运行也可以运行在 RTOS 模式之下。该库还支持多实例，比如可以在两个或更多的 USB 主机模块上工作。




3 USB 主机库架构与文件组织
3.1 USB 主机库架构



如 图 3 所示， USB 主机库分为两个主要部分：内核部分和类相关的驱动部分。
主机内核用于处理库的内核服务，这些服务主要用于：
• 设备的连接 / 断连管理与标准枚举。
• 主机管道控制与 USB 传输管理 （控制、中断、批量、同步）。
内核数据块被细分为两个主要子数据块：
• 被用户应用或类驱动所调用的内核 API。 • 处理主机状态机的内核过程。类驱动用于实现各种 USB 类。

这些类驱动包括：
• 一套类专用的 API （比如 disk_read、 disk_write），可在应用层调用。
• 一个类处理程序，由内核主机状态机 （内核过程）所调用，用于处理类操作 （类的初始化、解除初始化、类过程）。
主机内核和类驱动在经历某些已定义事件 （比如设备的连接 / 断连，数据接收）后，会调用用户回调函数。
USB 主机库利用接口层与 STM32Cube HAL 驱动相连接。
库中提供了实现底层接口层的模板文件。用户可以定制文件中与板支持包要求有关的内容部分。

3.2 USB 主机库文件组织
3.2.1 USB 主机内核文件
USB 主机内核文件位于 Core 文件夹 （STM32_USB_Host_Library\Core）中。 表 1 列出了
内核文件。




3.2.2 USB 主机类文件
表 2 列出了位于 Class 文件夹 （TM32_USB_Host_Library\Core）中的类文件





完整版请查看：附件