当前位置：首页 > news >正文

【工具使用】STM32CubeMX-USB配置-实现U盘功能

news 来源：原创 2025/7/16 11:26:55

一、概述

无论是新手还是大佬，基于STM32单片机的开发，使用STM32CubeMX都是可以极大提升开发效率的，并且其界面化的开发，也大大降低了新手对STM32单片机的开发门槛。
本文主要讲述STM32芯片USB功能的配置及其相关知识。

二、软件说明

STM32CubeMX是ST官方出的一款针对ST的MCU/MPU跨平台的图形化工具，支持在Linux、MacOS、Window系统下开发，其对接的底层接口是HAL库，另外习惯于寄存器开发的同学们，也可以使用LL库。STM32CubeMX除了集成MCU/MPU的硬件抽象层，另外还集成了像RTOS，文件系统，USB，网络，显示，嵌入式AI等中间件，这样开发者就能够很轻松的完成MCU/MPU的底层驱动的配置，留出更多精力开发上层功能逻辑，能够更进一步提高了嵌入式开发效率。
演示版本 6.1.0

三、USB功能简介

STM32F103C8T6的USB外设

顶部模块： - Analog transceiver：模拟收发器，通过 DP 和 DM 引脚实现物理层信号的收发，是 USB 与外部连接的接口。
绿色区域（USB 时钟 48MHz 驱动）： - Suspend timer：挂起定时器，用于管理 USB 的挂起状态。 - RX - TX、Control S.I.E.：负责数据的接收（RX）与发送（TX），以及控制相关操作。 - Clock recovery：时钟恢复模块，从输入信号中恢复时钟。 - Endpoint selection：端点选择模块，用于选择不同的 USB 端点。 - 这些模块连接到 Control registers and logic（控制寄存器及逻辑）和 Interrupt registers and logic（中断寄存器及逻辑），实现配置与中断管理；同时连接到多个 Endpoint registers（端点寄存器），用于存储端点相关数据。 - Packet buffer interface：数据包缓冲区接口，负责与下方的缓冲区模块交互。
灰色区域（PCLK 驱动，通过 APB1 总线通信）： - Arbiter：仲裁器，管理总线访问优先级。 - Packet buffer memory：数据包缓冲存储器，存储 USB 数据。 - Register mapper：寄存器映射，将端点寄存器映射到系统地址空间。 - Interrupt mapper：中断映射，将 USB 中断路由到 NVIC（嵌套向量中断控制器）。 - APB1 wrapper：APB1 总线封装，通过 APB1_bus 与系统连接，PCLK1 提供时钟。整体上，该框图展示了 USB 外设从物理信号收发、时钟处理、数据传输到系统接口（APB1）的完整流程，以及寄存器配置、中断管理等功能模块的协作关系。

四、USB配置及代码实现

STM32CubeMX配置

USB设备类选择

这是USB设备类选择的下拉菜单，因为我们要实现一个U盘的功能，所以这里我们选择Mass Storage Class（简称MSC）。
Disable：禁用，表示不使用任何设备类功能。
Audio Device Class：音频设备类，用于音频相关设备，如声卡、耳机等音频输入输出设备。
Communication Device Class (Virtual Port Com)：通信设备类（虚拟串口），用于实现虚拟串口通信功能，方便设备与计算机进行数据传输，常应用于一些需要串口通信模拟的场景。
Download Firmware Update Class (DFU)：下载固件更新类，用于设备固件的更新操作，允许设备在运行过程中通过特定方式更新自身固件。
Human Interface Device Class (HID)：人机接口设备类，像键盘、鼠标、游戏手柄等直接与用户交互的设备属于此类。
Custom Human Interface Device Class (HID)：自定义人机接口设备类，是在标准 HID 基础上，根据特定需求进行定制开发的人机交互设备类别。
Mass Storage Class：大容量存储类，用于 U 盘、移动硬盘等存储设备，使设备能像存储介质一样被计算机识别和读写数据。

USB设备相关参数

这部分是 USB 设备相关的参数设置，分为 Basic Parameters（基本参数）和 Class Parameters（类参数）两部分，这些参数共同配置了 USB 设备的基本属性、调试行为以及大容量存储类的缓冲区设置，确保设备在特定场景下正常工作。

Basic Parameters
USBD_MAX_NUM_INTERFACES：表示 USB 设备支持的最大接口数量，图中设置为 1。接口用于区分设备的不同功能（如一个设备仅实现单一功能时，接口数为 1）。
USBD_MAX_NUM_CONFIGURATION：最大配置数量，设为 1。USB 设备配置代表不同工作模式，此处表示仅有一种工作模式。
USBD_MAX_STR_DESC_SIZE：USB 描述符字符串的最大长度，为 512 bytes，用于定义设备名称等描述信息的最大长度。
USBD_SELF_POWERED：设备自供电状态，显示 Enabled，即设备采用自供电方式，而非依赖 USB 主机供电。
USBD_DEBUG_LEVEL：调试级别为 0: No debug message，表示调试时不输出任何调试信息。
Class Parameters
MSC_MEDIA_PACKET：针对大容量存储类（Mass Storage Class, MSC），定义媒体输入 / 输出缓冲区大小为 512 bytes，用于数据传输时的缓冲处理。

USB设备描述符相关配置

这部分是 USB 设备描述符相关的配置信息，分为 Device Descriptor（设备描述符）和 Device Descriptor FS（全速设备描述符）两部分，这些描述符信息是 USB 设备在与主机通信时，用于向主机声明自身属性和功能的关键参数，确保设备能被正确识别和驱动，这部分不需要修改，了解下其作用即可。

Device Descriptor
VID (Vendor Identifier)：厂商标识符，值为 1155，用于唯一标识设备的生产厂商。
LANGID_STRING (Language Identifier)：语言标识符，值为 English(United States)，表示设备使用的语言为美国英语。
MANUFACTURER_STRING (Manufacturer Identifier)：制造商标识符，值为 STMicroelectronics，表明设备由意法半导体制造。
Device Descriptor FS
PID (Product Identifier)：产品标识符，值为 22314，用于唯一标识该厂商下的具体产品。
PRODUCT_STRING (Product Identifier)：产品描述字符串，值为 STM32 Mass Storage，说明这是一个基于 STM32 的大容量存储设备（如 U 盘、移动存储等）。
CONFIGURATION_STRING (Configuration Identifier)：配置描述字符串，值为 MSC Config，表示设备的配置与大容量存储类（Mass Storage Class, MSC）相关。
INTERFACE_STRING (Interface Identifier)：接口描述字符串，值为 MSC Interface，表明设备使用的接口属于大容量存储类接口，用于实现数据的存储读写功能。

完整配置如下，USB 协议规定时钟误差需≤±0.25%，而STM32F103的内部 RC 振荡器（HSI，8MHz）精度仅 ±1%，无法满足要求，所以这时必须使用外部晶振。时钟按CubeMX自己计算的即可，一般是用48MHz。
USB配置

相关接口实现

完成以上配置后生成工程，为实现电脑对U盘的读写功能，这里还需要实现usbd_storage_if.c文件下的STORAGE_Read_FS和STORAGE_Write_FS接口，以完成电脑识别USB后对单片机内部Flash的操作，同时可以修改一下STORAGE_GetCapacity_FS接口，用来给电脑识别U盘设备的容量大小。如果需要使用外部Flash，则在此处实现外部Flash的读写操作。

/** @defgroup USBD_STORAGE_Private_Defines* @brief Private defines.* @{*/#define STORAGE_LUN_NBR                  1
#define STORAGE_BLK_NBR                  44//0x10000
#define STORAGE_BLK_SIZ                  0x400//0x200/* USER CODE BEGIN PRIVATE_DEFINES */
#define FLASH_START_ADDR                 0x08005000
/* USER CODE END PRIVATE_DEFINES *//*** @brief  .* @param  lun: .* @param  block_num: .* @param  block_size: .* @retval USBD_OK if all operations are OK else USBD_FAIL*/
int8_t STORAGE_GetCapacity_FS(uint8_t lun, uint32_t *block_num, uint16_t *block_size)
{/* USER CODE BEGIN 3 */*block_num  = STORAGE_BLK_NBR;*block_size = STORAGE_BLK_SIZ;return (USBD_OK);/* USER CODE END 3 */
}/*** @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 */if (lun == 0){memcpy(buf, (uint8_t *)(FLASH_START_ADDR + blk_addr * FLASH_PAGE_SIZE), blk_len * FLASH_PAGE_SIZE);}return (USBD_OK);/* USER CODE END 6 */
}/*** @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 */if (lun == 0){FLASH_EraseInitTypeDef f;uint32_t err = 0;uint16_t i;/* Flash解锁 */HAL_FLASH_Unlock();f.TypeErase = FLASH_TYPEERASE_PAGES;f.PageAddress = FLASH_START_ADDR + blk_addr * FLASH_PAGE_SIZE;f.NbPages = blk_len;f.Banks = FLASH_BANK_1;/* Flash擦除 */HAL_FLASHEx_Erase(&f, &err);for (i = 0; i < blk_len * FLASH_PAGE_SIZE; i += 4){/* Flash写入 */HAL_FLASH_Program(FLASH_TYPEPROGRAM_WORD, FLASH_START_ADDR + blk_addr * FLASH_PAGE_SIZE + i, *(uint32_t *)(&buf[i]));}/* Flash锁 */HAL_FLASH_Lock();}return (USBD_OK);/* USER CODE END 7 */
}

效果演示

效果演示

五、注意事项

1、如果是自己画的板子，注意D+口（DP）需要上拉个1.5k的电阻到3.3V。

六、相关链接

对于刚入门的小伙伴可以先看下STM32CubeMX的基础使用及Keil的基础使用。
【工具使用】STM32CubeMX-基础使用篇
【工具使用】Keil5软件使用-基础使用篇
【工具使用】STM32CubeMX-片内Flash读写操作

【工具使用】STM32CubeMX-USB配置-实现U盘功能

一、概述无论是新手还是大佬，基于STM32单片机的开发，使用STM32CubeMX都是可以极大提升开发效率的，并且其界面化的开发，也大大降低了新手对STM32单片机的开发门槛。本文主要讲述STM32芯片USB功能的配置及其相关知识。二…...

编程日记 2025/7/16 11:26:55

【LUT技术专题】DnLUT代码解读

目录原文概要 1. 训练本文是对DnLUT技术的代码解读，原文解读请看DnLUT。原文概要 DnLUT通过PCM模块和L型卷积，有效提升以往基于LUT方法降低色噪声的能力，用最小的存储量得到了同样的感受野范围，主要是2个创新点&#xff1…...

编程日记 2025/7/16 10:39:19

python宠物用品商城系统

目录技术栈介绍具体实现截图系统设计研究方法：设计步骤设计流程核心代码部分展示研究方法详细视频演示试验方案论文大纲源码获取/详细视频演示技术栈介绍 Django-SpringBoot-php-Node.js-flask 本课题的研究方法和研究步骤基本合理，难度适中&#xf…...

编程日记 2025/6/28 22:01:14

2156. 查找给定哈希值的子串

给定整数 p 和 m ，一个长度为 k 且下标从 0 开始的字符串 s 的哈希值按照如下函数计算： hash(s, p, m) (val(s[0]) * p0 val(s[1]) * p1 ... val(s[k-1]) * pk-1) mod m. 其中 val(s[i]) 表示 s[i] 在字母表中的下标，从 val(a) 1 到 v…...

编程日记 2025/7/13 10:53:31

Index-AniSora技术升级开源：动漫视频生成强化学习

B站升级动画视频生成模型Index-AniSora技术并开源，支持番剧、国创、漫改动画、VTuber、动画PV、鬼畜动画等多种二次元风格视频镜头一键生成！ 整个工作技术原理基于B站提出的 AniSora: Exploring the Frontiers of Animation Video Generation in the So…...

编程日记 2025/7/13 16:25:11

游戏引擎学习第297天:将实体分离到Z层中

回顾并为今天的内容做准备昨天我们做了雾效混合（fog blend）和透明度混合（alpha blending）的尝试，现在正在进行渲染部分的深度（Z）清理工作。今天的重点是把“切片”（slices&#xf…...

编程日记 2025/7/16 4:55:17

全局对比度调整

目录一、全局对比度调整原理二、饱和度保持一、全局对比度调整原理 Figure1.2 展示了一幅全局对比度较低的图像及其亮度直方图。该直方图分布范围较窄，像素的强度仅集中在中间调区域，不存在明亮或深色的像素，因此图像中的细节难以区分，可用动态范围未得到有效利用。在动…...

编程日记 2025/7/13 16:58:39

Canvas SVG BpmnJS编辑器中Canvas与SVG职能详解

Canvas详解与常见API 一、Canvas基础核心特性 • 像素级绘图：Canvas是基于位图的绘图技术，通过JavaScript操作像素实现图形渲染，适合动态、高性能场景（如游戏、数据可视化）。 • 即时模式：每次绘制需手动…...

编程日记 2025/7/16 2:08:22

【图像大模型】Stable Diffusion 3 Medium：多模态扩散模型的技术突破与实践指南

Stable Diffusion 3 Medium：多模态扩散模型的技术突破与实践指南一、架构设计与技术演进1.1 核心架构革新1.2 关键技术突破1.2.1 整流流（Rectified Flow）1.2.2 动态掩码训练二、系统架构解析2.1 完整推理流程2.2 性能对比三、实战部署指南…...

编程日记 2025/7/12 19:12:52

PID项目---硬件设计

该项目是立创训练营项目，这些是我个人学习的记录，记得比较潦草 1.硬件-电路原理电赛-TI-基于MSPM0的简易PID项目_哔哩哔哩_bilibili 这个地方接地是静电的考量这个保护二极管是为了在电源接反的时候保护电脑等设备大电容的作用：当电机工作…...

编程日记 2025/7/15 7:01:20

渗透测试流程

2.1 信息收集 2.1.1 资产监控与架构分析目标：明确目标范围（IP、域名、子公司资产），识别网络架构（云服务/CDN/反向代理）。工具与技巧：使用FOFA、Shodan搜索关联资产（如title="目标公司"）。通过nslookup或dig解析域名，确认真实IP是否隐藏于CDN…...

编程日记 2025/7/13 5:43:18

PCIe EP/RC 核心功能解释

1. Bar访问（BAR Access） BAR（Base Address Register） 是 PCIe 设备上的地址窗口，用于主机与设备之间的寄存器访问。功能： 主机通过 BAR 访问 EP 卡的控制寄存器或数据缓冲区。每个 BAR 对应一段物理内…...

编程日记 2025/7/12 22:03:17

srs-7.0 支持obs推webrtc流

demo演示官方教程： https://ossrs.net/lts/zh-cn/blog/Experience-Ultra-Low-Latency-Live-Streaming-with-OBS-WHIP 实现原理就是通过WHIP协议来传输 SDP信息 1、运行 ./objs/srs -c conf/rtc.conf 2、obs推流 3、web端播放webrtc流打开web:ht...

编程日记 2025/7/12 12:17:52

SQLynx 团队协作实践：提升数据库开发效率的解决方案

在数据库开发与管理场景中，团队协作的效率直接影响项目进度与质量。传统协作方式常面临权限混乱、代码复用率低、跨地域协作困难等问题，而 SQLynx 作为一款轻量化 Web SQL 工具，凭借其独特的团队协作功能，为这些难题提供了有效解决…...

编程日记 2025/6/28 23:57:49

基于自然语言转SQL的BI准确率如何？

基于自然语言转SQL的商业智能（BI）工具的准确率受多种因素影响，目前整体处于中等偏上水平，但尚未达到完全精准的程度。以下从技术原理、影响准确率的因素、实际应用场景及未来趋势等方面展开分析： 一、技术原理与当前准…...

编程日记 2025/7/15 14:58:12

「华为」持续加码人形机器人赛道！

温馨提示：查看运营团队2025年最新原创报告（共210页） —— 正文： 现阶段，全球大厂入局具身智能赛道典型代表：[英伟达]和[特斯拉]，是全球科技巨头/大厂（谷歌、微软、Meta、OpenAI、华…...

编程日记 2025/7/13 17:01:11

Visual Studio 2022 无法编译.NET 9 项目的原因和解决方法

Visual Studio 2022 无法运行.NET 9 项目的原因和解决方法。目录 1. Visual Studio 2022 无法编译TargetFramework是.NET 9 项目 2. 解决方法 3. 用Visual Studio Code开发 1. Visual Studio 2022 无法编译TargetFramework是.NET 9 项目本机安装了Visual Studio 2022 版…...

编程日记 2025/7/13 23:00:15

C++从入门到实战（十六）String（中）String的常用接口（构造接口，析构接口，迭代器，遍历修改，容量管理与数据访问）

C从入门到实战（十六）String（中）详细讲解String的常用接口前言一、std::string二、string的构造接口1. 默认构造函数：创建空字符串2. 拷贝构造函数：复制已有字符串3. 从已有字符串截取部分4. 用C风格字符串…...

编程日记 2025/6/29 0:16:46

RabbitMQ ⑤-顺序性保障 || 消息积压 || 幂等性

幂等性保障幂等性（Idempotency） 是计算机科学和网络通信中的一个重要概念，指的是某个操作无论被执行多少次，所产生的效果与执行一次的效果相同。应用程序的幂等性： 在应用程序中，幂等性就是指对一个系统…...

编程日记 2025/6/29 8:30:55

go.mod:5: unknown directive: toolchain

Go语言版本较旧，而项目使用了较新版本的Go语言特性。错误信息"unknown directive: toolchain"表明go.mod文件中使用了"toolchain"指令，这是在Go 1.21版本中新引入的特性，但您当前安装的Go版本不支持这个指令。解决方法…...

编程日记 2025/7/14 17:58:17

分布式序列生成方案： Redis Incr | 基于Redisson创建自增获取序号，每天更换一个key, key到期时间1天，用于创建订单号、快递单号

文章目录引言I 在 Spring Boot 应用程序中集成 Redisson1. Maven2. 配置 Redisson 客户端3. 创建 Redisson 配置类4. 自动装配 RedissonClientII 应用：基于Redisson创建自增获取序号生成每日自增序号创建订单号创建快递单号封装：系统自动生成单号引言应用：创建订单号、…...

编程日记 2025/6/29 1:28:15

Android7 Input（八）App Input事件接收器InputEventReceiver

概述上一个章节，我们讲解了App如何使用InputChannel通道与input系统服务建立通信的桥梁的过程，本章我们讲述App如何从input系统服务中获取上报的输入事件，也就是我们本章讲述的InputEventReceiver。本文涉及的源码路径 frameworks/base/c…...

编程日记 2025/7/15 20:24:57

阿里云服务器Ubuntu的git clone失败问题解决方案

一、问题我们再使用阿里云服务器或者别的服务器，git clone失败二、解决方案 1. 确认SSH密钥是否存在并正确配置检查密钥文件： ls -al ~/.ssh 确认存在 id_rsa（私钥）和 id_rsa.pub（公钥&#xff…...

编程日记 2025/7/12 7:38:15

Mujoco 学习系列（二）基础功能与xml使用

这篇文章是 Mujoco 学习系列第二篇，主要介绍一些基础功能与 xmI 使用，重点在于如何编写与读懂 xml 文件。运行这篇博客前请先确保正确安装 Mujoco 并通过了基本功能与GUI的验证，即至少完整下面这个博客的第二章节内容： Mujoc…...

编程日记 2025/7/12 22:03:50

8 定时任务与周期性调度

在构建复杂的分布式系统时，我们经常会遇到需要“定时”或“周期性”执行的任务。比如，每天凌晨生成报表，每小时同步一次数据，或者在特定时间发送提醒邮件。这些任务如果都依赖人工触发，不仅效率低下，而且容…...

编程日记 2025/7/12 20:19:38

idea 插件开发自动发布到 nexus 私服中（脚本实例）

如下脚本内容为 idea 插件开发项目中的 build.gradle.kts 文件示例，其中自定了 updatePluginsXml 和 uploadPluginToNexus 两个任务，一个用来自动修改 nexus 中的配置文件，一个用来自动将当前插件打包后的 zip 文件上传到 nexus 私服中。脚…...

编程日记 2025/7/14 21:33:16

关于 APK 反编译与重构工具集

一、apktool — APK 解包 / 重打包 apktool 是一款开源的 Android APK 工具，用于： 反编译 APK 查看资源和布局文件生成 smali 文件（DEX 的反汇编） 对 APK 进行修改后重新打包它不能还原 Java 源码，只能将 D…...

编程日记 2025/7/14 7:49:30

【课堂笔记】核方法和Mercer定理

文章目录 Kernal引入定义Mercer定理描述有限情形证明一般情形证明 Kernal 引入在实际数据中常常遇到不可线性分割的情况，此时通常需要将其映射到高维空间中，使其变得线性可分。例如二维数据： 通过映射 ϕ ( x 1 , x 2 ) ( x 1 2 , 2 x 1…...

编程日记 2025/7/13 22:23:11

Cribl 中 Parser 扮演着重要的角色 + 例子

先看文档: Parser | Cribl Docs Parser The Parser Function can be used to extract fields out of events or reserialize (rewrite) events with a subset of fields. Reserialization will preserve the format of the events. For example, if an event contains comma…...

编程日记 2025/6/29 1:09:31