【STM32CubeMX学习教程】——USB（MSC）实战：内部Flash模拟U盘开发指南

1. 项目概述与准备工作

大家好，今天我来分享一个非常实用的STM32开发技巧：如何使用STM32CubeMX配置USB MSC设备类，将STM32内部Flash模拟成U盘。这个功能在实际项目中特别有用，比如你可以用它来存储日志文件、配置文件，甚至实现固件在线升级功能。

我刚开始接触这个功能时也踩过不少坑，比如电脑识别不到设备、读写速度慢等问题。经过多次实践，我总结出了一套稳定可靠的配置方法，现在分享给大家。这个教程适合已经有一定STM32开发基础的朋友，如果你刚接触STM32，建议先掌握GPIO、时钟配置等基础知识。

需要准备的硬件环境：

• 一块支持USB功能的STM32开发板（我用的STM32F407，其他型号也类似）
• USB数据线（一定要质量好的，我之前用劣质线导致各种奇怪问题）
• 电脑安装好STM32CubeMX和IDE（Keil或IAR都可以）

软件环境：

• STM32CubeMX最新版本（我用的6.10.0）
• 对应的HAL库版本
• 串口调试助手（用于调试信息输出）

2. CubeMX工程创建与基础配置

首先打开STM32CubeMX，点击"New Project"创建新工程。在选择芯片型号时，要特别注意选型，确保你选的芯片支持USB外设。比如STM32F103系列只有部分型号支持USB，而STM32F4系列基本都支持。

选好芯片后，我们先配置时钟树。USB外设对时钟要求很严格，必须提供准确的48MHz时钟。我建议使用外部晶振作为时钟源，这样更稳定。具体配置步骤如下：

在Pinout & Configuration界面，找到RCC配置，将HSE设置为Crystal/Ceramic Resonator。然后转到Clock Configuration标签页，按照以下步骤配置：

• 输入你的外部晶振频率（我的是8MHz）
• 配置PLL倍频参数，使系统时钟达到芯片最高频率
• 确保USB时钟准确为48MHz

这里有个小技巧：你可以使用CubeMX的自动计算功能，输入想要的USB时钟频率，软件会自动帮你计算合适的分频系数。记得最后要点击"Apply"保存配置。

接下来配置调试接口，我习惯用SWD接口，在SYS配置中选择Serial Wire。这样配置后就可以用ST-Link进行调试和下载了。

3. USB外设详细配置

现在来到最重要的部分——USB配置。在Connectivity中找到USB_OTG_FS或USB_OTG_HS（根据你的芯片选择），将Mode设置为Device_Only。

然后转到Middleware and Software Packs，选择USB_DEVICE。在Class下拉菜单中选择Mass Storage Class（MSC）。这时候会多出很多配置参数，我来详细解释几个关键的：

基本参数配置：

• USBD_MAX_NUM_INTERFACES：保持默认1即可，除非你要做复合设备
• USBD_MAX_STR_DESC_SIZ：字符串描述符大小，建议设为256避免溢出
• USBD_SELF_POWERED：根据实际情况选择，如果板子有外部电源就选Enabled

MSC类特定参数：

• MSC_MEDIA_PACKET：这个参数特别重要，它决定了数据传输的缓冲区大小。对于内部Flash，我建议设置为512字节，因为这是标准扇区大小。设置太大会浪费RAM，太小会影响性能。

在Device Descriptor页面，需要配置设备描述符信息：