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

6 N! F; F: `- N" O9 N( ~. e
( ?- w* S1 w" M: E/ i1 |1 STM32Cube™ 概述
) U3 ]/ q  r/ _STMCube™ 计划源自意法半导体，旨在通过减少开发的工作量、时间与成本，使开发者受益。 STM32Cube™ 将涵盖 STM32 全线产品组合。
STM32Cube™1.x 版包括：
• 图形软件配置工具 STM32CubeMX，可通过图形向导生成初始化 C 代码。
• 针对每个系列提供综合的嵌入式软件平台，（比如用于 STM32F4 系列的 STM32CubeF4）
– STM32 抽象层嵌入式软件 STM32Cube HAL，确保用户应用在 STM32 各个产品之间实现最大限度的可移植性。
; S% \' G1 _: n! F– 一套中间件组件，比如 RTOS、 USB、 TCP/IP、图形处理。
+ T% i: R/ n* D1 q5 e; ^+ g6 |– 一整套例程用于演示所有嵌入式软件功能。
* k: p$ }; Y2 @; o! o' X- z- y) q

& @5 c/ @# g" j6 H9 E
9 B' P4 L& X) Q% \
; {" a% A6 ~1 t8 i" N
8 I8 b6 s% T; l8 B" M2 简介
本文档描述 STM32Cube 的 USB 的主机库中间件模块。
  s' e0 e  R! L! R0 a  H( bUSB 主机库处于 STM32Cube USB 主机 HAL 驱动之上。该库提供用于访问各类 USB 设备的 API。
USB 主机模块可用于实现主要的 USB 类。
, T# E! C- `$ H  j• 大容量存储类 （MSC） • 人机接口鼠标与键盘类 （HID） • 通信设备类 （CDC） • 音频类 （AUDIO） • 媒体传输协议类 （MTP）
除了以上所列的类以外，用户还能通过库提供的 API 来实现自己的应用类别。
该库可单独运行也可以运行在 RTOS 模式之下。该库还支持多实例，比如可以在两个或更多的 USB 主机模块上工作。

, Z# B' b* G8 t* \  t

- Y- N  W! X8 f
3 USB 主机库架构与文件组织
3.1 USB 主机库架构
  F: a6 T9 g4 M  S
4 l) Y# C3 u$ ]( s

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

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

3.2 USB 主机库文件组织
2 M8 _' d& i9 F. R3.2.1 USB 主机内核文件
USB 主机内核文件位于 Core 文件夹 （STM32_USB_Host_Library\Core）中。 表 1 列出了
内核文件。
3 j1 D  R6 Z" O9 |
' C5 T6 @: p  t


: d# |9 M2 U# J0 ^  K3.2.2 USB 主机类文件
/ f! w5 C% J$ t% j( K2 N表 2 列出了位于 Class 文件夹 （TM32_USB_Host_Library\Core）中的类文件
- P7 o) y& S+ Z$ l1 j7 r. u6 R
4 L# B& A" Y: k: T1 D


+ e5 _+ R* F: y
  m& o7 }; R+ L8 {, X+ Y4 B3 X完整版请查看：附件
5 s0 p) e- M) C+ {" _3 E
* {+ ~. U! {8 _4 F* p& z