1. 课程导学与开发环境搭建
大家好，我是你们的讲师。做嵌入式这些年，我调试过不少USB设备，也踩过不少坑。说实话，USB协议看起来复杂，但只要你把基础框架搭对了，后面的事情就顺了。这一章，我们先聊聊USB到底是什么，再把手头的工具链装好。
1.1 USB协议概述——它到底解决了什么问题？
USB，全称Universal Serial Bus，通用串行总线。说白了，就是让各种外设能“即插即用”地连到电脑上。我刚开始做嵌入式时，用的还是串口和并口，每次换个设备都要重启电脑，那叫一个痛苦。USB的出现，彻底改变了这个局面。
USB协议有几个核心特点，我列个表，大家一看就明白：
| 特性 | 说明 | 我的一点体会 |
|---|---|---|
| 热插拔 | 设备可以在系统运行时插入或拔出 | 这个功能看似简单，但底层电气协议做了大量工作 |
| 即插即用 | 系统自动识别设备并加载驱动 | 枚举过程就是设备和主机“握手”的过程 |
| 总线供电 | 设备可以从USB口取电（最大500mA） | 设计低功耗设备时，这个限制要牢记 |
| 拓扑结构 | 星型拓扑，通过Hub扩展 | 最多支持127个设备，实际中别挂太多 |
| 传输速度 | 从低速1.5Mbps到高速480Mbps | STM32F4支持全速12Mbps和高速480Mbps |
USB的物理层就是4根线：VBUS（电源）、D+、D-（数据）、GND（地）。D+和D-是一对差分信号线，抗干扰能力强。为什么用差分？因为高速信号容易受噪声影响，差分对能有效抑制共模干扰。嗯，这个知识点在硬件设计时特别重要。
核心概念：USB是主从架构，主机（Host）发起所有通信，设备（Device）只能被动响应。我们的STM32F4 Discovery板，既可以做Host（比如接U盘），也可以做Device（比如模拟键盘）。本课程主要讲Device模式。
1.2 课程目标——学完你能做什么？
这门课不是光讲理论，我们要动手做项目。我设计这门课的初衷，就是让你能真正把USB驱动跑起来，而不是停留在看文档的阶段。
具体来说，学完这门课，你应该能：
- 理解USB协议栈的核心层次——从物理层到应用层，知道数据是怎么打包、传输、解包的。
- 熟练使用CubeMX生成USB设备驱动框架——不用手写底层寄存器，但要知道生成的代码在干什么。
- 实现常见的USB设备类——比如HID（鼠标键盘）、CDC（虚拟串口）、MSC（U盘）。
- 学会用USB分析仪抓包调试——这个技能很值钱，我当年就是靠它解决了一个棘手的兼容性问题。
- 独立完成一个USB复合设备项目——把多个功能合在一个设备里，这才是实战。
我的建议：不要急着跳着看，USB协议一环扣一环。你跳过枚举过程，后面设备描述符配错了都不知道怎么查。跟着课程一步步来，稳扎稳打。
1.3 硬件平台介绍——STM32F4 Discovery
我们用的板子是STM32F407VGT6 Discovery，这块板子我用了好几年，性价比很高。它集成了ST-Link调试器，一根USB线就能供电和调试，非常方便。
板子上与USB相关的硬件资源：
- USB_OTG_FS：全速接口，支持Host和Device模式。板子上有一个Micro-USB插座，默认用于Device模式。
- USB_OTG_HS：高速接口，需要外接PHY芯片才能用。本课程主要用FS接口。
- ST-Link虚拟串口：通过另一个USB口实现，用于打印调试信息。
- 用户按键和LED：可以用来模拟HID设备的输入输出。
为什么选这块板子？我个人的经验是，STM32F4的USB外设比较典型，学会了它，其他STM32系列（比如F1、F7、H7）的USB驱动你也能很快上手。而且Discovery板价格亲民，淘宝一百多块就能买到。
注意：有些盗版Discovery板USB电路有缩水，可能导致枚举不稳定。建议从正规渠道购买。我曾经遇到过一块板子，插上电脑没反应，查了半天发现是D+上拉电阻没焊。嗯，硬件坑多，大家留个心眼。
1.4 软件工具链安装——把武器备好
工欲善其事，必先利其器。下面我把需要用到的软件列出来，并说明安装要点。
1.4.1 STM32CubeMX——图形化配置神器
CubeMX是ST官方出的配置工具，可以图形化选择芯片、配置外设、生成初始化代码。我们用它来生成USB设备驱动的框架代码。
安装步骤：
- 去ST官网下载最新版CubeMX（需要注册账号，免费）。
- 安装时选择Java运行环境（如果电脑没有JRE，安装包会自动下载）。
- 安装完成后，打开CubeMX，在Help菜单下安装STM32F4的固件包（F4的包大约1GB，下载需要点时间）。
避坑指南：我曾经因为CubeMX版本太旧，生成的USB代码有bug，折腾了两天。建议使用最新版，至少是6.x以上。另外，固件包版本也要对应，别用F1的包去配F4的芯片。
1.4.2 Keil MDK / IAR EWARM——编译调试环境
这两个都是嵌入式开发的IDE，选一个就行。我个人习惯用Keil，因为它的调试器对ST-Link支持很好。当然IAR的编译优化更激进，看个人喜好。
安装要点：
- Keil MDK：安装后需要注册License（社区版有代码大小限制，建议用正版或学校授权）。
- IAR EWARM：同样需要License，但提供30天试用版。
- 安装完成后，确保能识别ST-Link调试器。插上Discovery板，在设备管理器里能看到“STMicroelectronics STLink dongle”。
注意：Keil和IAR的工程文件不通用。CubeMX可以同时生成两种格式的工程，但建议选定一个工具后就不要来回切换，否则容易出配置问题。
1.4.3 USB分析仪——调试的“眼睛”
USB分析仪是调试USB设备最重要的工具。它能抓取USB总线上的所有数据包，让你看到主机和设备之间到底在“聊”什么。
我推荐两种方案：
| 方案 | 工具 | 价格 | 适用场景 |
|---|---|---|---|
| 硬件分析仪 | Beagle USB 12 / USBlyzer | 几百到几千元 | 专业调试，能抓高速信号 |
| 软件分析仪 | Wireshark + USBPcap | 免费 | 入门学习，只能抓主机侧数据 |
对于本课程，先用Wireshark就够了。安装USBPcap驱动后，Wireshark就能捕获USB数据包。虽然它看不到物理层的电气信号，但协议层的分析完全够用。
我的经验：有一次客户说我们的设备在某个主板上无法识别，我用自己的Beagle分析仪一抓，发现是枚举过程中设备返回的描述符长度不对。这种问题，没有分析仪根本无从下手。所以，我强烈建议你至少装一个Wireshark。
1.5 本章知识体系总览
下面这张图，把本章的核心知识点串起来了。你可以把它当作一个“地图”，后面每学一章，都可以回来对照一下，看看自己走到了哪里。