最近在整理一个数据采集设备的导出功能遇到了一个很实用的需求设备里攒了几百KB的运行日志想导到电脑上分析。传统做法是串口加协议栈要么写上位机要么开个串口终端复制粘贴对终端客户来说门槛太高。最好的体验是——设备往电脑上一插出现一个U盘双击就能拷文件。这个玩法就是“STM32虚拟U盘”。具体说用STM32的USB外设把单片机模拟成大容量存储设备USB Mass Storage ClassMSC存储介质用一片W25Q648MB SPI NOR Flash文件系统用FATFS托管。电脑插上USB线后识别到的就是一块7.x MB的FAT16 U盘断开USB线后STM32自己也能通过FATFS读写同一片Flash用来记录日志、保存配置参数、存放固件升级包。整套组合在STM32F103这种入门级芯片上就能跑成本低、电路简单、不依赖SD卡槽也不用额外的USB桥接芯片。这篇文章我从需求拆解讲起把USB MSC、FATFS、W25Q64三者协作的完整链路展开重点放在diskio层对SPI Flash的读改写策略、MSC库的对接方式以及实机调试验证中容易踩的坑上。手里有STM32开发板、想给项目加一个“U盘数据口”的直接照着做就行。1. 需求拆解为什么单片机要伪装成U盘1.1 典型应用场景虚拟U盘看起来像是个花活实际上嵌入式产品里需求非常明确。第一类是日志导出。设备长时间运行后内部积累了大量运行状态、传感器数据、故障记录。这些数据如果要通过串口导出要么波特率低得让人抓狂要么协议复杂要么上位机软件没人维护。做成U盘后运维人员插上USB线把文件拖出来发邮件也好、导入分析工具也好都顺畅。第二类是参数配置和固件备份。很多工业设备需要离线配置参数之前的人机交互方式可能是按键加数码管改一个参数要按半天。有了U盘接口可以在电脑上编辑好配置文件拷进去单片机自己解析或者把当前固件版本信息、校准参数以文件形式备份出来。第三类是技术演示和教学。虚拟U盘的技术栈覆盖USB协议、SCSI命令、SPI Flash驱动、文件系统移植四个领域做完一个项目等于把嵌入式存储相关的知识全过了一遍。毕业设计、开源项目、个人作品集里这类项目非常讨喜。1.2 存储介质选型W25Q64、SD卡还是内部Flash做虚拟U盘存储介质的选择直接决定工作量和最终体验三种常见方案对比如下。方案容量成本电路复杂度可靠性适合场景STM32内部Flash几十KB到1MB最低最低高但频繁擦写有寿命风险参数存储不适合U盘场景SD卡 SPI/SDIO数百MB到数十GB中中需要插座和卡一般接触不良/掉卡风险大容量数据记录W25Q64 SPI NOR Flash8MB低极低只需6根线高擦写寿命约10万次无机械结构虚拟U盘、日志、配置存储8MB容量听起来不大但对日志、配置、固件包这类数据来说完全够用。重要的是W25Q64的驱动极简单一颗芯片就可以完成“SPI通信、页编程、扇区擦除、状态寄存器查询”几个操作不像SD卡那样要考虑CMD响应超时、CRC校验、4-bit模式切换这些麻烦事。另一个关键点是可靠性。SD卡在USB连接状态下直接拔线文件分配表可能损坏而NOR Flash虽然也可能因为意外断电导致FAT表不一致但没有机械结构和磨损均衡策略失效的问题配合FATFS的掉电保护措施比如先写备份目录项整体可靠性反而容易做高。1.3 为什么“USB MSC FATFS W25Q64”是最省力的组合很多人会问既然已经模拟成U盘了文件系统能不能让电脑直接管理单片机侧不挂FATFS理论上可以但现实很骨感。如果单片机自己不挂文件系统那W25Q64里的数据对单片机侧就是一堆无结构的扇区U盘模式下电脑能读写文件USB拔掉后单片机却读不出“文件”内容。比如设备想在U盘模式下让电脑写入一个config.ini然后拔掉USB线单片机自己去解析这个文件——如果不挂FATFS单片机就得手工去解析FAT表、目录项这等于自己实现文件系统工作量巨大且容易出Bug。更优雅的方案是FATFS同时服务于USB MSC和单片机应用程序。USB侧把FATFS底层的disk_read/disk_write暴露给MSC库电脑的任何文件操作最终会调用到disk层函数单片机自己的日志、配置读写也调用FATFS上层接口f_open、f_write、f_read。这样同一片Flash、同一套文件系统两个访问口不需要任何格式转换。当然这也带来一个核心难点——数据一致性后面第4节会详细讲。2. 系统架构USB MSC、FATFS与Flash三层协作2.1 三层职责划分整个虚拟U盘从底层到顶层可以分成四层每一层只干一件事。硬件层W25Q64 SPI接口 ↓ 提供 Read/Write/Erase 基础操作 磁盘抽象层disk_read / disk_write / disk_ioctl ↓ 以512字节扇区为粒度提供读写 文件系统层FATFS挂载、格式化、文件操作 ↓ 提供文件/目录接口 应用层USB MSC库模拟U盘 业务代码日志、配置其中磁盘抽象层是关键桥接。STM32官方USB库里的MSC类Mass Storage Class并不关心底层是什么存储介质它只负责处理USB协议包把SCSI命令里的读写请求转换成对MAL_Read/MAL_Write或Mass_Memory_Read/Mass_Memory_Write函数的调用。FATFS也一样它把文件逻辑读写转换成对disk_read、disk_write的扇区级调用。所以我们要做的就是用W25Q64驱动去实现FATFS的disk_*函数再把FATFS的disk_*函数桥接到USB MSS的MAL层函数。听起来就是“翻来覆去接接口”但实现细节里全是坑比如Flash擦除粒度、写前擦除、扇区缓存一致性等。2.2 数据通路电脑写入一个文件发生了什么以电脑往虚拟U盘写一个log.txt为例完整的调用链是这样的电脑文件系统驱动发出SCSI WRITE(10)命令携带目标扇区LBA和数据。USB总线以Bulk传输方式把CBWCommand Block Wrapper31字节命令块包装和实际数据发给STM32。STM32的USB中断里接收到数据后MSC库解析出是写命令调用MAL_Write(USBD_BULK_OUT_EP, LBA, buffer, 长度)。我们把这个函数内部实现为调用FATFS的disk_write进而调用W25Q64的扇区写入函数。W25Q64因为最小擦除单位是4KB而FATFS和USB协议都是按512字节扇区操作的所以写入512字节前要把所在4KB块先读出来在内存里修改后整块擦除再写回。写完后返回状态MSC库组装CSWCommand Status Wrapper13字节命令状态包装发给电脑。电脑读文件的过程类似只是不需要擦除和写回直接读512字节扇区即可。2.3 关键设计决策点移植过程中有几个决策点直接影响成败先列表说明后面展开讲。决策点推荐做法原因SPI时钟频率SPI1时钟18MHz以内W25Q64最高支持104MHz读但STM32F103的SPI外设稳定性优先18MHz实测足够FATFS扇区大小512字节与USB MSC和PC兼容性最好别用4KB替代W25Q64写入策略4KB块“读改写”512字节小扇区无法直接写入Flash需先读后写FAT类型FAT168MB容量在FAT16支持范围4MB~2GB兼容性最好模式切换USB插入时切到MSC模式拔掉后恢复本地文件访问避免PC和MCU同时写FAT表导致文件系统损坏3. 硬件准备SPI接线、USB电路与选型3.1 最小硬件清单本项目的物料成本非常低全部从淘宝或者立创商城采购市面上任何一块带USB接口的STM32开发板都能改造主控STM32F103C8T6正点原子、野火、或者最小系统板都可以带USB口就行NOR FlashW25Q648MB容量SOIC-8封装几毛钱一片也可以直接买W25Q128代码几乎不用改USB接口开发板上自带的USB座子或者用杜邦线引到USB母座电容若干SPI flash供电旁路电容104USB D上拉电阻如果芯片内部没启用上拉我用的是一块STM32F103C8T6最小系统板板载一个MicroUSB座和AMS1117稳压非常适合做USB类实验。3.2 SPI接线细节W25Q64的SPI接口有6根线要接CS片选、CLK时钟、DIMOSI、DOMISO、VCC、GND。我选择接了SPI1因为F103的SPI1最高支持36MHzAPB2时钟72MHz/2速度上限比SPI2的18MHz高而且引脚和USB接口不冲突。SPI1引脚STM32F103引脚连接目标SPI1_NSS软件片选PA4W25Q64 CSSPI1_SCKPA5W25Q64 CLKSPI1_MISOPA6W25Q64 DOSPI1_MOSIPA7W25Q64 DICS可以用硬件NSS也可以用普通GPIO控制我个人一直用GPIO操作CS因为控制时机更灵活。时钟极性CPOL/CPHA设置为模式0CPOL0CPHA0这是W25Q64默认支持的SPI模式。3.3 USB电路注意点USB的D和D-接STM32F103的PA12和PA11这个不能接反。D上需要一个1.5kΩ上拉电阻到3.3V用来告诉主机“这是一个全速设备”。STM32F103的部分USB库会通过在内部启用DP上拉来实现但有些库和开发板会外置这个电阻做板子前要确认清楚。由于是全速USB走线要求不像高速设备那么苛刻但建议D和D-尽量等长、靠近走避免引入过大寄生电容导致枚举失败。如果用的是开发板自带的USB座直接插就行如果自己飞线线越短越好。供电方面需要注意F103最大USB工作电流约几十毫安不算Flash从调试器取电或USB取电均可。但如果板子同时带LCD屏、WiFi模块、舵机之类的大功率外设务必用有供电能力的USB口或单独供电否则可能出现USB枚举不稳定甚至烧坏电脑USB口的风险。4. FATFS移植到W25Q64diskio层最容易被坑的地方4.1 ffconf.h必须改的参数FATFS开源项目从主站直接下载源码就四五个文件把它移植到STM32工程里关键是配置ffconf.h。我用的FATFS版本是R0.15针对这个项目核心配置如下#define FF_USE_MKFS 1 // 允许格式化操作 #define FF_USE_STRFUNC 2 // 支持f_gets/f_puts字符串读写日志记录方便 #define FF_USE_LFN 1 // 支持长文件名Windows下不会显示成8.3短文件名 #define FF_MAX_SS 512 // 最大扇区大小固定512 #define FF_MIN_SS 512 #define FF_FS_FAT16 1 // 使能FAT16文件系统 #define FF_FS_RPATH 0 // 不需要相对路径降低代码体积 #define FF_FS_NORTC 1 // 如果没有RTC芯片用宏固定时间戳这里特别强调FF_USE_MKFS和FF_USE_LFN。前者决定单片机侧能否直接格式化Flash后面会用到后者决定电脑写入的长文件名比如“2025年数据备份.txt”能不能被正确识别。如果你图省事把LFN关了FATFS会把文件截断成2025年~1.TXT这种8.3格式还可能出现中文乱码。4.2 disk_read / disk_write512字节扇区的“读改写”W25Q64虽然是8MB大容量Flash但它的编程特性有三个硬约束写前必须擦除Flash只能把1写成0不能把0写成1。最小擦除单位是4KB一个扇区不是512字节。页编程大小是256字节一次最多写256字节跨页需要分多次。FATFS和USB MSC可不管这些它们天然按512字节逻辑扇区操作。这就导致disk_write必须做“读-改-写”// W25Q64的4KB块号 逻辑扇区号 / 8每个4KB块有8个512B扇区 // 块内偏移 (逻辑扇区号 % 8) * 512 uint8_t block_buf[4096]; uint8_t W25Q64_WriteSector(uint32_t sector_addr, uint8_t *data, uint32_t len) { uint32_t block_index sector_addr / 4096; uint32_t offset_in_block sector_addr % 4096; if (offset_in_block 0 len 4096) { // 整块写入直接擦除再写不需要先读 W25Q64_EraseSector(block_index); W25Q64_WritePage(block_index * 4096, data, 4096); } else { // 局部写入先把整块读到RAM修改目标位置再整体擦除重写 W25Q64_ReadData(block_index * 4096, block_buf, 4096); memcpy(block_buf offset_in_block, data, len); W25Q64_EraseSector(block_index); W25Q64_WritePage(block_index * 4096, block_buf, 4096); } return 0; }关键优化在这里FATFS的disk_write一次传入的可能是连续多个扇区。如果我每个512字节都做一次“读-改-写”性能会非常惨。正确做法是能合并就合并——判断传入的扇区范围是否覆盖整个4KB块是的话直接擦除重写整个块否则才读改写。FATFS在连续写文件时写入粒度通常是4KB甚至更大所以这个优化对实际传输速度提升非常明显。4.3 disk_ioctl的GET_SECTOR_COUNT和CTRL_SYNC实现disk_ioctl是FATFS和磁盘之间的“能力查询”接口f_mkfs格式化前会调用它获取磁盘大小PC枚举U盘时USB MSC库也会读取磁盘容量。DRESULT disk_ioctl(BYTE drv, BYTE cmd, void *buff) { switch (cmd) { case GET_SECTOR_COUNT: *(DWORD *)buff W25Q64_TOTAL_SIZE / 512; // 8MB / 512B 16384个扇区 return RES_OK; case GET_BLOCK_SIZE: *(DWORD *)buff 8; // 每8个512B逻辑扇区对应一个4KB物理擦除块 return RES_OK; case CTRL_SYNC: return RES_OK; } return RES_PARERR; }GET_BLOCK_SIZE返回的8很关键它告诉FATFS“这个磁盘优化写入的粒度是8个扇区”。FATFS在写这块磁盘时会尽量凑够8个扇区即4KB再调用disk_write这样我们的“整块直写”优化就会频繁命中效率高得多。4.4 格式化操作f_mkfs如何创建PC可识别的FAT16新买的W25Q64内部全是0xFF没有文件系统。直接把这样的Flash暴露给电脑Windows会提示“需要格式化磁盘”。两种方式可以解决一种是在电脑上点格式化Windows会帮你建立FAT文件系统另一种是在固件里预置格式化逻辑首次上电自动格式化。为了用户体验我选择固件里做。由于8MB容量落在FAT16范围内4MB~2GB直接调用FATFS标准函数即可void FormatFlash(void) { FATFS fs; FRESULT res f_mount(fs, , 1); if (res FR_NO_FILESYSTEM) { uint8_t work[FF_MAX_SS]; res f_mkfs(, FM_FAT16, 0, work, sizeof(work)); if (res FR_OK) { f_mkdir(LOGS); // 预建一个日志目录 f_mkdir(CONFIG); } } f_mount(NULL, , 0); }这里有个实际经验电脑端格式化8MB的盘时会用FAT12或FAT16不同系统的默认参数不一致可能导致某些老设备不兼容。自己在固件里格式化为FAT16所有系统上都表现一致这是最稳妥的做法。5. USB MSC库对接让电脑正常枚举和收发SCSI命令5.1 描述符配置STM32F103的USB Device库中usb_desc.c的配置描述符决定了设备如何被PC识别。MSC设备需要声明为Mass Storage类接口描述符如下/* 接口描述符 */ 0x09, // bLength USB_DESC_TYPE_INTERFACE, // bDescriptorType 0x00, // bInterfaceNumber 0x00, // bAlternateSetting 0x02, // bNumEndpointsBULK IN 和 BULK OUT 0x08, // bInterfaceClassMass Storage 0x06, // bInterfaceSubClassSCSI透明命令集 0x50, // bInterfaceProtocolBulk-Only Transport 0x00, // iInterface无字符串描述符 /* BULK OUT端点 */ 0x07, USB_DESC_TYPE_ENDPOINT, 0x01, // bEndpointAddressOUT端点1 0x02, // bmAttributesBulk LOBYTE(EP1_MAX_PACKET_SIZE), HIBYTE(EP1_MAX_PACKET_SIZE), 0x00, // bIntervalBulk端点忽略 /* BULK IN端点 */ 0x07, USB_DESC_TYPE_ENDPOINT, 0x81, // bEndpointAddressIN端点1 0x02, // bmAttributesBulk LOBYTE(EP1_MAX_PACKET_SIZE), HIBYTE(EP1_MAX_PACKET_SIZE), 0x00,SCSI透明命令集是MSC最常用的子类Bulk-Only TransportBOT是Windows和Linux都能原生支持的数据传输协议。设备枚举成功后Windows会发出INQUIRY命令询问设备厂商和产品信息标准库的usb_scsi.c已经写好了返回内容默认厂商信息是ST_MSC。如果想改成自己的产品名在Standard_Request里修改字符串描述符里的iManufacturer和iProduct即可。5.2 MAL层对接disk_read / disk_writeSTM32F103标准库的USB MSC例程中usb_pwr.c负责USB挂起恢复usb_scsi.c处理SCSI命令真正和存储介质打交道的是mass_mal.c里的Mass_Memory_Read、Mass_Memory_Write和Mass_Memory_GetStatus。在这个文件里USB库会分配一个内部缓冲区USB中断收到写数据后填充缓冲区然后调用Mass_Memory_Write此时我直接把数据桥接给FATFS底层disk函数uint32_t Mass_Memory_Write(uint32_t Memory_Offset, uint8_t *Writebuff, uint32_t Transfer_Length) { // Memory_Offset 是扇区LBATransfer_Length 是字节数 // 调用 disk_write 时扇区地址是8的倍数GET_BLOCK_SIZE已经告诉FATFS DRESULT res disk_write(0, Writebuff, Memory_Offset, Transfer_Length / 512); return (res RES_OK) ? MAL_OK : MAL_FAIL; }注意这里的Memory_Offset在官方库中通常是byte偏移但在BOT协议里实际是按LBA逻辑扇区数传输。不同版本的库有差异用之前最好把USB抓包或者printf打印出来确认一下。我调试时遇到过一次偏移量没除512导致写入扇区错位8倍文件全乱的惨案。disk_read同理uint32_t Mass_Memory_Read(uint32_t Memory_Offset, uint8_t *Readbuff, uint32_t Transfer_Length) { DRESULT res disk_read(0, Readbuff, Memory_Offset, Transfer_Length / 512); return (res RES_OK) ? MAL_OK : MAL_FAIL; }5.3 连接/断开事件处理避免数据丢失USB插入和拔出事件处理是整个方案里最容易被忽略、但最重要的一环。当USB线插入时PC会立刻开始枚举设备之后随时可能发送SCSI WRITE命令写入数据。如果此时MCU侧的应用程序还在通过FATFS写日志两边会同时操作FAT表和目录项轻则数据错乱重则整个文件系统崩溃。处理办法是模式互斥volatile uint8_t usb_msc_active 0; void USB_EVENT_CONNECTED(void) { usb_msc_active 1; // 让出文件系统确保所有文件已关闭和flush f_write(file, ..., bw); // 这是直接销毁不正确做法见下 f_close(file); // 关闭当前打开的文件 f_mount(NULL, , 0); // 卸载FATFSMSC模式接管磁盘 } void USB_EVENT_DISCONNECTED(void) { usb_msc_active 0; f_mount(fs, , 1); // 重新挂载FATFS // 业务代码可以恢复日志记录 }实际应用中我的业务代码在每次打开文件前都会检查usb_msc_active标志为1时说明当前是U盘模式跳过所有Flash写操作为0时才允许写日志。这样即使USB在写入中途被拔出MCU侧也能安全恢复。6. 核心代码实现与工程组织6.1 工程结构建议整个工程不用分得太复杂建议保持如下结构STM32_Virtual_USB/ ├── User/ │ ├── main.c // 主程序、模式切换 │ ├── usbd_usr.c // USB事件回调 │ ├── usb_desc.c // USB描述符 │ └── w25q64.c // W25Q64底层驱动 ├── FatFs/ │ ├── ff.c / ff.h │ ├── diskio.c // 磁盘抽象层对接W25Q64 │ └── ffconf.h ├── USB/ │ ├── usb_scsi.c // SCSI命令处理 │ ├── mass_mal.c // MAL层桥接disk_read/disk_write │ └── usb_prop.c └── MDK-ARM/ // Keil工程文件工程文件用Keil5 STM32F1xx标准外设库或者HAL库都可以。个人体感标准外设库的USB例程更成熟稳定HAL库的USB例程虽然封装了更多但调试MSC类时反而多了一层抽象出了问题不好定位。6.2 主循环与初始化流程main函数逻辑非常简单核心是初始化外设和进入死循环int main(void) { HAL_Init(); SystemClock_Config(); // 配置72MHz主频 USART1_Init(); // 调试串口115200 SPI1_Init(); // SPI1模式0时钟18MHz W25Q64_Init(); FormatFlash(); // 首次使用自动格式化为FAT16 f_mount(fs, , 1); // 挂载文件系统 USB_Init(); // 初始化USB MSC设备 while (1) { // 业务主循环 if (!usb_msc_active) { WriteLogEntry(); // USB拔出时写日志 } delay_ms(100); } }主循环没有复杂逻辑因为USB协议处理全部在中断里完成。MSC模式下USB中断去处理SCSI命令主循环只要不碰Flash就万事大吉。6.3 USB断开时的日志记录示例演示一下最实用的日志记录功能这部分代码运行在USB断开模式void WriteLogEntry(void) { if (usb_msc_active) return; // U盘模式下禁止本地写 FIL f; FRESULT res f_open(f, LOGS/run.log, FA_OPEN_ALWAYS | FA_WRITE); if (res FR_OK) { f_lseek(f, f_size(f)); // 移动到文件末尾 char buf[128]; sprintf(buf, [%lu] temp%.2f\r\n, HAL_GetTick()/1000, read_temperature()); f_write(f, buf, strlen(buf), bw); f_close(f); } }注意每次写完立即f_close而不是长期保持文件打开状态。因为在USB插入瞬间MSC模式可能随时接管Flash如果还有文件句柄没关闭FATFS卸载时会失败可能导致文件表残留脏数据。7. 实测验证与踩坑排查链路7.1 实测环境与结果测试环境STM32F103C8T6最小系统板 W25Q64 自制的USB转接板Windows 11系统USB线缆大概1米未加任何缓冲芯片。首次插入电脑系统提示“发现新硬件”设备管理器中识别为“ST_MSC USB Device”磁盘管理器中看到一块7.62GB不这里要算清楚——8MB 8,388,608字节减去FAT16文件系统的元数据占用实际可用空间显示为7.81 MB7,995,392字节文件系统格式为FAT16。我格式化后取log文件验证写入一个5MB的压缩包拷贝完成约耗时30秒左右。各环节性能实测数据操作平均速度备注PC读取文件350~500 KB/s读不受擦除影响瓶颈在SPI和USBPC写入文件150~250 KB/s写需要4KB块读改写速度明显下降MCU侧日志写入约20次/秒每条16字节无压力Flash擦写时间约50~100ms如果用W25Q12816MB或者把SPI时钟提到30MHz以上速度还能提升但F103全速USB的瓶颈在12Mbps协议层Flash速度再快也没用。7.2 踩坑一Windows提示“需要格式化”新焊接的板子插上电脑后Windows直接弹窗“使用驱动器中的光盘之前需要将其格式化”但点格式化又会报错。这个问题的根源是Flash里全0xFF既没有MBR也没有FAT引导扇区Windows无法识别任何文件系统。排查链路先用串口打印确认W25Q64能否正常读出ID读出来是0xEF4017说明芯片OK。确认FATFS挂载时返回什么错误码。我在FormatFlash()里遇到FR_NO_FILESYSTEM就自动执行f_mkfs但这个函数返回值是FR_OK说明格式化本身成功。格式化后用disk_ioctl打印扇区总数确认是否等于16384。如果这里返回错误PC端容量读取也会失败。最后用串口打印disk_read(0, buf, 0, 1)读取第一个扇区如果读到前三个字节是EB 3C 90这就是合法的引导扇区标志电脑就能正常识别。这个坑80%的情况是因为漏了FormatFlash()或者格式化函数写错剩下20%是disk_ioctl的扇区总数返回错误。按以上步骤逐层打印很快能定位。7.3 踩坑二USB枚举失败设备管理器显示未知设备插上USB线后电脑没有任何反应或者显示“未知USB设备”。这个问题通常不是MSC库的问题而是USB底层初始化失败。排查链路先看D上拉电阻是否接对。F103的D必须通过1.5k电阻上拉到3.3V如果忘记接USB主机完全不会发现设备。检查USB时钟。全速USB需要48MHz时钟F103的USB外设时钟源是PLL 72MHz经过1.5分频得到48MHz。如果系统主频不是72MHz或者时钟树配置错误USB会枚举失败。用示波器看D波形最直观。检查PA11/PA12是否被别的外设占用。某些开发板把PA11/PA12复用为CAN或按键会造成信号冲突。排除供电问题。开发板的USB口电流不足时枚举可能时好时坏。把调试器也拔掉只用USB供电试试。我遇到过一次最阴间的故障是芯片复位后第一次插USB能设备识别但按复位键后设备失效。最后定位到复位瞬间USB D上拉被POR上电复位重置需要在USB初始化完成后延迟一小段时间再使能上拉。这个问题在纯硬件方案里不常见但在某些开发板带USB切换开关时会出现。7.4 踩坑三文件复制后校验不一致电脑端写入一个文件拔掉USB再插回来发现文件内容变了或者电脑提示目录损坏。这个问题通常指向数据一致性而非单个函数出错。排查链路先排除“读改写”逻辑错误。在disk_write里加串口打印记录每次写入的扇区号和长度和PC的SCSI命令对照看是否有重复写或者漏写。确认USB拔出时是否正确处理了缓存。Windows在写入文件时并不会每条SCSI命令都返回后才算“复制完成”它有自己的文件系统缓存。复制进度条完成后实际上后台可能还在写。等到进度条消失、托盘图标消失后再拔线这一点要在使用文档中明确。MCU侧FATFS卸载时机要正确。如果USB断开事件来临时FATFS还有打开的文件句柄卸载会失败FAT表在Flash上留下不一致。我在USB_EVENT_DISCONNECTED里先f_mount(NULL,,0)强制卸载虽然会丢失最后一次媒体缓存但能保证下次挂载一定进入干净状态。还有一个隐藏坑FATFS的f_write函数每次写完并不立即调用物理层写盘它自己也有扇区缓存。如果业务代码长时间运行后突然插USB必须确保所有文件关闭且FATFS执行了f_sync等效于fflush否则最后几条日志会丢。我的做法是“USB插入前倒数5秒主循环检测到VBUS电平变化后先执行f_close所有句柄再初始化USB”。7.5 从“能用”到“好用”的细节优化项目跑通之后我做了几个小优化对整个使用体验提升非常大增加USB拔出后自动恢复日志之前日志写到一半拔线重新插入U盘后日志文件损坏或丢失。现在MSC模式下完全禁止本地写一旦断开USB立即恢复日志记录日志完整性大幅提升。把格式化按钮做成开机按键检测长按某个按键2秒启动时强制格式化Flash方便产品出厂前快速清理数据。增加容量不足保护Flash剩余空间不足时自动删除最早的日志文件或者进入只读模式避免写爆导致文件系统不可用。用内部Flash保存挂载标志上电时先检查Flash内是否有合法文件系统没有才触发格式化避免误格式化。如果后续想扩展方向也很多加一个CONFIG目录做配置导入导出把f_mkfs做成隐藏的“恢复出厂设置”命令或者参考STM32官方的HIDMSC复合设备示例做一个既能当U盘又能当HID控制面板的设备。这个项目做完之后我最大的体会是虚拟U盘看着简单实际上把USB协议、文件系统、Flash特性三条线拧在了一起任何一条线没捋清都会出问题。但只要分层清晰、每一步都验证到位整套方案的稳定性和实用性远比想象中高。
