STM32CubeMX学习笔记（47）——USB接口使用（MSC基于内部Flash模拟U盘）

一、USB简介

USB（Universal Serial BUS）通用串行总线，是一个外部总线标准，用于规范电脑与外部设备的连接和通讯。是应用在 PC 领域的接口技术。USB 接口支持设备的即插即用和热插拔功能。USB 是在 1994 年底由英特尔、康柏、IBM、Microsoft 等多家公司联合提出的。

USB 发展到现在已经有 USB1.0/1.1/2.0/3.0 等多个版本。目前用的最多的就是 USB1.1 和 USB2.0，USB3.0 目前已经开始普及。STM32F103 自带的 USB 符合 USB2.0 规范，不过 STM32F103 的 USB 都只能用来做设备，而不能用作主机。

标准 USB 共四根线组成,除 VCC/GND 外,另外为 D+,D-; 这两根数据线采用的是差分电压的方式进行数据传输的。在 USB 主机上，D-和 D+都是接了 15K 的电阻到低的，所以在没有设备接入的时候，D+、D-均是低电平。而在 USB 设备中，如果是高速设备，则会在 D+上接一个 1.5K 的电阻到 VCC，而如果是低速设备，则会在 D-上接一个 1.5K 的电阻到 VCC。这样当设备接入主机的时候，主机就可以判断是否有设备接入，并能判断设备是高速设备还是低速设备。

STM32F103 的 MCU 自带 USB 从控制器，符合 USB 规范的通信连接；PC 主机和微控制器之间的数据传输是通过共享一专用的数据缓冲区来完成的，该数据缓冲区能被 USB 外设直接访问。这块专用数据缓冲区的大小由所使用的端点数目和每个端点最大的数据分组大小所决定，每个端点最大可使用 512 字节缓冲区（专用的 512 字节，和 CAN 共用），最多可用于 16 个单向或 8 个双向端点。USB 模块同 PC 主机通信，根据 USB 规范实现令牌分组的检测，数据发送/接收的处理，和握手分组的处理。整个传输的格式由硬件完成，其中包括 CRC 的生成和校验。

1.1 USB MSC简介

USB大容量存储设备类（The USB mass storage device class）是一种计算机和移动设备之间的传输协议，它允许一个通用串行总线（USB）设备来访问主机的计算设备，使两者之间进行文件传输。通过这个标准的计算机连接到的设备包括：移动硬盘、移动光驱、U盘、SD、TF等储存卡读卡器、数码相机、各种数字音频播放器和便携式媒体播放器、智能卡阅读器、掌上电脑和手机。
MSC的通用性和操作简单使他成为移动设备上最常见的文件系统，USB MSC并不需要任何特定的文件系统, 相反，它提供了一个简单的界面来读写接口用于访问任何硬盘驱动器。操作系统可以把MSC像本地硬盘一样格式化，并可以与他们喜欢的任何文件系统格式它，当然也可以创建多个分区。

二、新建工程

1. 打开 STM32CubeMX 软件，点击“新建工程”

2. 选择 MCU 和封装

3. 配置时钟
RCC 设置，选择 HSE(外部高速时钟) 为 Crystal/Ceramic Resonator(晶振/陶瓷谐振器)

选择 Clock Configuration，配置系统时钟 SYSCLK 为 72MHz
修改 HCLK 的值为 72 后，输入回车，软件会自动修改所有配置

4. 配置调试模式
非常重要的一步，否则会造成第一次烧录程序后续无法识别调试器
SYS 设置，选择 Debug 为 Serial Wire

三、USB

3.1 参数配置

在 Connectivity 中选择 USB 设置，并勾选 Device（FS） 激活 USB 设备。

在 Parameter Settings 进行具体参数配置。

• Speed： Full Speed 12MBit/s（固定为全速）
• Low Power： 默认 Disabled（在任何不需要使用usb模块的时候，通过写控制寄存器总可以使usb模块置于低功耗模式（low power mode ，suspend模式）。在这种模式下，不产生任何静态电流消耗，同时usb时钟也会减慢或停止。通过对usb线上数据传输的检测，可以在低功耗模式下唤醒usb模块。也可以将一特定的中断输入源直接连接到唤醒引脚上，以使系统能立即恢复正常的时钟系统，并支持直接启动或停止时钟系统。）

3.2 引脚配置

USB 的 DP 引脚必须上拉 1.5K 欧的电阻，电脑才能检测到 USB，否则检测不到。

查看野火指南者开发板原理图可知，需要将 PD6 配置为低电平使能 USB。

在右边图中找到 PD6 引脚，选择 GPIO_Output。

在GPIO output level 中选择 Low 输出低电平。

3.3 配置时钟

选择 Clock Configuration，USB 时钟配置为 48MHz，且来源最好是外部晶振分频得到。

3.4 USB Device

USB有主机（Host）和设备（Device）之分。一般电脑的USB接口为主机接口，而键盘、鼠标、U盘等则为设备。

部分型号的STM32芯片有1~2个USB接口。像STM32F103系列的有一个USB Device接口，STM32F407系列的有2个USB接口，既可以作为HOST，又可以作为Device，还可以作为OTG接口。

在 Middleware 中选择 USB_DEVICE 设置，在 Class For FS IP 设备类别选择 Mass Storage Class（HID） 大容量存储设备类。

参数配置保持默认（或根据存储介质的最小存储单元修改缓冲区大小）。

• MSC_MEDIA_PACKET (Media I/O buffer Size)（读写缓冲区大小）： 2048（默认为512，这个的大小对于USB读写速度会有一些影响，最好和存储介质的最小存储单元一致）

本实验板使用的 STM32F103VET6 型号芯片的参数，即 STM32F1 大容量产品。若使用超大容量、中容量或小容量产品，它们主存储器的页数量、页大小均有不同，使用的时候要注意区分。
主存储器是以页为单位划分的。stm32根据FLASH主存储块容量、页面的不同，系统存储器的不同，分为小容量、中容量、大容量、互联型，共四类产品。

• 小容量产品：主存储块1-32KB， 每页1KB。系统存储器2KB
• 中容量产品：主存储块64-128KB， 每页1KB。系统存储器2KB
• 大容量产品：主存储块256KB以上， 每页2KB。系统存储器2KB
• 互联型产品：主存储块256KB以上， 每页2KB。系统存储器18KB

设备描述符保持默认。

四、生成代码

输入项目名和项目路径

选择应用的 IDE 开发环境 MDK-ARM V5

每个外设生成独立的 ’.c/.h’ 文件
不勾：所有初始化代码都生成在 main.c
勾选：初始化代码生成在对应的外设文件。 如 GPIO 初始化代码生成在 gpio.c 中。

点击 GENERATE CODE 生成代码

五、修改usbd_storage_if.c

打开工程文件夹Application/User/USB_DEVICE/App下usbd_storage_if.c文件

5.1 修改扇区个数和大小

/** @defgroup USBD_STORAGE_Private_Defines
  * @brief Private defines.
  * @{
  */

//#define STORAGE_LUN_NBR                  1
//#define STORAGE_BLK_NBR                  0x10000
//#define STORAGE_BLK_SIZ                  0x200

#define STORAGE_LUN_NBR                  1      // 1个盘
#define STORAGE_BLK_NBR                  48    // 模拟48个扇区
#define STORAGE_BLK_SIZ                  FLASH_PAGE_SIZE  // VET6是2k的页

• STORAGE_BLK_NBR 是扇区个数，此处使用的是48，大小完全根据自己需求定义。

• STORAGE_BLK_SIZ 扇区大小取决于所用芯片Flash页面的单位，实验所用STMF103VET6为一页的大小是2K，所以
  STORAGE_BLK_SIZ = FLASH_PAGE_SIZE = 0x800

• U盘实际容量 = 扇区个数 * 扇区大小，所以这个U盘最终大小应该是48*2K = 96K

5.2 添加Flash起始地址

/* USER CODE BEGIN PRIVATE_DEFINES */
#define FLASH_START_ADDR                 ((uint32_t)0x08008000)
/* USER CODE END PRIVATE_DEFINES */

由于内部 FLASH 本身存储有程序数据，若不是有意删除某段程序代码，一般不应修改程序空间的内容，所以在使用内部 FLASH 存储其它数据前需要了解哪一些空间已经写入了程序代码，存储了程序代码的扇区都不应作任何修改。通过查询应用程序编译时产生的“*.map”后缀文件，可以了解程序存储到了哪些区域。

打开 map 文件后，查看文件最后部分的区域，可以看到一段以 “Memory Map of the image” 开头的记录(若找不到可用查找功能定位)

观察表中的最后一项，它的基地址是 0x0800175c，大小为 0x00000020，可知它占用的最高的地址空间为 0x0800177c，跟执行区域的最高地址 0x0000177c 一样，但它们比加载区域说明中的最高地址 0x80017a8 要小，所以我们以加载区域的大小为准。对比表 45-1 的内部 FLASH 页地址分布表，可知仅使用页 0 至页 2 就可以完全存储本应用程序，所以从页3 (地址 0x08001800) 后的存储空间都可以作其它用途，使用这些存储空间时不会篡改应用程序空间的数据。

5.3 修改存储读写函数

• STORAGE_Read_FS

/**
  * @brief  .
  * @param  lun: .
  * @retval USBD_OK if all operations are OK else USBD_FAIL
  */
int8_t STORAGE_Read_FS(uint8_t lun, uint8_t *buf, uint32_t blk_addr, uint16_t blk_len)
{
  /* USER CODE BEGIN 6 */
  //将(FLASH_START_ADDR + blk_addr * FLASH_PAGE_SIZE)起始地址处的blk_len * FLASH_PAGE_SIZE大小的数据拷贝到buf里面
  memcpy(buf, (uint8_t*)(FLASH_START_ADDR + blk_addr * STORAGE_BLK_SIZ), blk_len * STORAGE_BLK_SIZ);
  return (USBD_OK);
  /* USER CODE END 6 */
}

• STORAGE_Write_FS

/**
  * @brief  .
  * @param  lun: .
  * @retval USBD_OK if all operations are OK else USBD_FAIL
  */
int8_t STORAGE_Write_FS(uint8_t lun, uint8_t *buf, uint32_t blk_addr, uint16_t blk_len)
{
  /* USER CODE BEGIN 7 */
    uint16_t i;
    HAL_FLASH_Unlock();
    FLASH_EraseInitTypeDef flash_erase_handler;
    flash_erase_handler.TypeErase = FLASH_TYPEERASE_PAGES;
    flash_erase_handler.PageAddress = FLASH_START_ADDR + blk_addr*STORAGE_BLK_SIZ ;
    flash_erase_handler.NbPages = blk_len;
    uint32_t PageError = 0;
    HAL_FLASHEx_Erase(&flash_erase_handler, &PageError);   //页擦除，擦除后才能往这个页面写入东西        
 
    for(i=0;i

六、查看效果

编译工程，下载到板子上，插上USB线连接到电脑上，识别出为大容量存储设备

注意： 如果设备带有感叹号，则参考下面八、注意事项

弹出格式化对话框，直接格式化就行

文件系统选择FAT模式

这里的显示空间为72KB，但是U盘容量应该是有96K的，剩下的24K应该与WINDOWS格式化的FAT32的文件表有关

新建一个文档测试.txt然后在文档中输入一些内容：

重新上电断开后再次打开U盘看里面的内容和已用空间

七、工程代码

链接：https://pan.baidu.com/s/1maV4gnFFNNfAEqUVOSuKXw?pwd=xs3o 提取码：xs3o

八、注意事项

用户代码要加在 USER CODE BEGIN N 和 USER CODE END N 之间，否则下次使用 STM32CubeMX 重新生成代码后，会被删除。

如果USB端口出现感叹号设备无法启动的问题，可适当将堆改大，如0x400

---

• 由 Leung 写于 2022 年 11 月 16 日

• 参考：STM32 基础系列教程 26 - USB_MSC
　　　　4.2、CUBEMX USB之MSC(基于内部FLASH)