30、USB开发综合实战项目：项目需求分析、系统架构设计与模块集成
各位同学，终于到了咱们这门课的重头戏——综合实战项目。说实话，前面讲了那么多USB协议、驱动开发、HID/CDC/MSC的细节，如果你只是一个个知识点去学，很容易陷入“只见树木不见森林”的困境。我自己带团队做嵌入式开发这些年，最深的体会就是：真正考验功力的，不是你会写某个驱动，而是你能把多个模块捏合成一个稳定可靠的产品。
这一章，我们就来完整走一遍USB多功能数据采集仪的设计与实现过程。我会把我在项目中踩过的坑、总结的经验，毫无保留地分享出来。
30.1 项目需求分析：我们要做什么？
先说说这个项目的背景。我去年接手过一个工业数据采集的项目，客户要求设备既能当USB Host接U盘存数据，又能当Device连电脑实时监控，还得支持自定义HID命令来控制外围设备。说白了，就是一台设备要同时扮演好几个角色。
嗯，咱们这个综合实战项目，就是基于那个需求提炼出来的——USB多功能数据采集仪。
核心需求清单：
- 双模式切换：设备既能作为USB Host（接U盘、鼠标等），也能作为USB Device（连PC、平板）
- HID自定义协议：用于传输控制指令和状态信息，延迟要求低于5ms
- CDC虚拟串口：用于大数据量的数据流传输，比如传感器实时波形
- MSC大容量存储：支持U盘热插拔，数据自动存储为CSV格式
- 电源管理：Host模式下要能对外供电，Device模式下要支持USB充电
你可能会问：为什么不用蓝牙或者WiFi？其实原因很简单——工业现场的环境太复杂了。无线信号容易被干扰，而USB有线连接稳定可靠，而且供电也一并解决了。我在一个工厂里就遇到过，蓝牙设备在电机旁边根本连不上，换成USB一点问题没有。
30.2 系统架构设计：Host + Device 双模式
架构设计是整个项目的骨架。我个人的习惯是，先画一张整体框图，把各个模块的关系理清楚，再动手写代码。
从架构图可以看到，核心是USB OTG控制器，它负责在Host和Device之间切换。我选的是STM32F407，因为它内置了OTG外设，而且有足够的RAM来跑协议栈。
经验之谈： 选主控芯片时，一定要留足余量。我最初用了一颗低端芯片，结果HID+CDC+MSC三个协议栈同时跑的时候，RAM直接爆了。后来换了F407，才稳下来。建议至少预留30%的RAM和Flash空间。
30.3 模块集成：HID + CDC + MSC 三合一
三个协议模块同时工作，听起来很复杂，但其实只要理清它们的优先级和资源分配，就没那么难了。
30.3.1 HID 模块：控制指令的“快车道”
HID的特点是低延迟、小数据量。我们用它来传输控制指令，比如“开始采集”、“停止采集”、“设置采样率”等。
// HID 报告描述符（自定义）
static const uint8_t CustomHID_ReportDesc[] = {
0x06, 0x00, 0xFF, // Usage Page (Vendor Defined)
0x09, 0x01, // Usage (Vendor Usage 1)
0xA1, 0x01, // Collection (Application)
0x09, 0x02, // Usage (Vendor Usage 2)
0x15, 0x00, // Logical Minimum (0)
0x26, 0xFF, 0x00, // Logical Maximum (255)
0x75, 0x08, // Report Size (8)
0x95, 0x40, // Report Count (64)
0x81, 0x02, // Input (Data,Var,Abs)
0x09, 0x03, // Usage (Vendor Usage 3)
0x15, 0x00, // Logical Minimum (0)
0x26, 0xFF, 0x00, // Logical Maximum (255)
0x75, 0x08, // Report Size (8)
0x95, 0x40, // Report Count (64)
0x91, 0x02, // Output (Data,Var,Abs)
0xC0 // End Collection
};这里我定义了一个64字节的输入报告和64字节的输出报告。输入报告用于设备向PC发送状态，输出报告用于PC向设备下发指令。为什么是64字节？因为USB全速模式下，HID的中断传输最大包长就是64字节。
注意： 自定义HID在Windows上需要安装驱动，但在Linux和macOS上可以直接用hidraw接口访问。如果你要跨平台，建议在PC端用libusb或者hidapi库。
30.3.2 CDC 模块：数据流的“高速公路”
CDC虚拟串口适合传输大数据量，比如传感器采集到的波形数据。我们配置成115200波特率，但实际上USB CDC的速率远高于此，能达到1Mbps以上。
// CDC 初始化配置
USBD_CDC_Init(&hUsbDeviceFS, &USBD_CDC_fops_FS);
// 数据发送函数
int8_t CDC_Transmit(uint8_t *buf, uint16_t len) {
// 我习惯加一个超时机制，防止死等
uint32_t tickstart = HAL_GetTick();
while (USBD_CDC_GetTxState(&hUsbDeviceFS) != USBD_OK) {
if ((HAL_GetTick() - tickstart) > 100) {
return -1; // 超时返回
}
}
return USBD_CDC_TransmitPacket(&hUsbDeviceFS, buf, len);
}嗯，这里有个坑——CDC的发送缓冲区是共享的。如果你在中断里调用CDC_Transmit，而主循环也在发数据，就会冲突。我当时的解决办法是加一个环形缓冲区，所有数据先入队，再由一个专门的发送任务去处理。
30.3.3 MSC 模块：数据的“仓库”
MSC模块负责把数据存到U盘里。我们用的是FATFS文件系统，配合USB Host库来读写U盘。
// MSC 挂载U盘
FATFS fs;
FRESULT res = f_mount(&fs, "0:", 1);
if (res != FR_OK) {
// 挂载失败，可能是U盘未插入或格式不支持
printf("Mount failed: %d\n", res);
return;
}
// 写入CSV文件
FIL fil;
f_open(&fil, "0:/data.csv", FA_WRITE | FA_CREATE_ALWAYS);
f_printf(&fil, "timestamp,value1,value2\n");
f_printf(&fil, "%lu,%d,%d\n", timestamp, sensor1, sensor2);
f_close(&fil);避坑指南： 我曾经遇到过U盘在写入过程中被拔出，导致文件系统损坏。后来我加了一个“写保护”机制——在写入前检测U盘是否还在，写入完成后立即关闭文件。另外，建议用f_sync()定期刷新缓存，而不是等到f_close()才写。
30.4 测试与发布：兼容性测试和CTS认证
产品做出来只是第一步，能不能在用户手里稳定运行，才是关键。
30.4.1 兼容性测试
USB设备的兼容性是个大问题。不同品牌的电脑、不同版本的Windows/Linux/macOS，行为可能完全不同。
| 测试项 | 测试内容 | 通过标准 |
|---|---|---|
| Host模式 | 接不同品牌U盘（金士顿、闪迪、三星） | 识别率 > 95% |
| Device模式 | 连Windows 10/11、Ubuntu 22.04、macOS Ventura | 免驱识别，功能正常 |
| HID功能 | 发送1000次控制指令 | 成功率100%，延迟 < 5ms |
| CDC功能 | 连续传输1GB数据 | 无丢包，无断流 |
| MSC功能 | 反复插拔U盘100次 | 文件系统无损坏 |
| 电源管理 | Host模式对外供电500mA | 电压稳定在5V ± 5% |
我个人的习惯是，测试用例要覆盖90%以上的用户场景。比如U盘，不能只测新U盘，还要测用了好几年的旧U盘，因为它们的电气特性可能已经老化了。
30.4.2 CTS认证
CTS（Compliance Test Suite）是Google为Android设备制定的兼容性测试套件。如果你的设备要打上“Android Compatible”的标签，就必须通过CTS。
CTS里和USB相关的测试项包括：
- USB Device 枚举测试：验证设备描述符、配置描述符是否正确
- HID 功能测试：验证报告描述符和输入输出是否正常
- CDC 功能测试：验证虚拟串口的收发是否稳定
- MSC 功能测试：验证U盘的挂载、读写、卸载是否正常
- 电源管理测试：验证挂起、唤醒、远程唤醒等功能
重要提醒： CTS认证不是一次就能过的。我当年第一次跑CTS，挂了30多个测试项，大部分都是描述符里的细节问题。比如字符串描述符的语言ID没填对，或者配置描述符的bMaxPower值超出了范围。建议在开发阶段就定期跑CTS，不要等到最后才去修。
30.5 写在最后
这一章我们完整走了一遍USB多功能数据采集仪的需求分析、架构设计、模块集成和测试发布。说实话，这个项目看起来模块很多，但只要把架构搭好，每个模块独立开发、独立测试，最后再集成，就不会乱。
我记得有一次，客户要求三天内出一个原型机。我直接拿开发板，把HID和CDC的代码从之前的项目里移植过来，MSC用现成的库，半天就搭好了框架。剩下的时间全在调电源管理和兼容性。所以说，积累可复用的代码模块，比什么都重要。
好了，这一章就到这里。希望你能动手把这个项目做一遍，遇到问题不要怕，多查USB规范，多抓包分析，慢慢就有感觉了。