STM32F103 USB MassStorage实战：如何将SPI Flash或EEPROM伪装成U盘？
STM32F103 USB MassStorage实战：SPI Flash模拟U盘全解析
1. 硬件架构与协议栈解析
在嵌入式系统中实现USB Mass Storage功能，本质上是通过硬件接口与协议栈的协同工作。STM32F103系列微控制器内置全速USB 2.0外设，配合SPI接口的Flash存储器（如W25Q系列），可以构建一个完整的存储设备解决方案。
核心组件交互关系：
[Host PC] ←USB协议→ [STM32 USB PHY] ←内部总线→ [Firmware] ←SPI接口→ [W25Q Flash]关键协议栈分层：
- 物理层：USB差分信号传输
- 协议层：USB Mass Storage Class规范
- 传输层：Bulk-Only Transport (BOT)协议
- 命令层：SCSI命令集（精简版）
- 存储层：Flash物理块管理
硬件连接示例（以W25Q128为例）：
// SPI引脚定义 #define FLASH_CS_PIN GPIO_Pin_4 #define FLASH_CS_PORT GPIOA #define FLASH_SPI SPI1 // USB连接检测 #define USB_DM_PIN GPIO_Pin_11 #define USB_DP_PIN GPIO_Pin_12 #define USB_GPIO GPIOA2. 存储介质适配改造
2.1 SPI Flash特性处理
与SD卡不同，SPI Flash具有独特的物理特性需要特殊处理：
| 特性 | SD卡 | SPI Flash | 解决方案 |
|---|---|---|---|
| 块大小 | 512字节 | 4KB/64KB | 软件模拟扇区 |
| 擦除方式 | 按块擦除 | 必须整页擦除 | 写前自动擦除 |
| 寿命周期 | 约10万次 | 约10万次 | 均衡写入算法 |
| 访问接口 | SDIO/SPI | SPI | 直接SPI驱动 |
关键适配代码（扇区模拟）：
#define FLASH_SECTOR_SIZE 4096 // 物理块大小 #define DISK_SECTOR_SIZE 512 // 模拟扇区大小 int SPIFlash_ReadSector(uint32_t sector, uint8_t *buffer) { uint32_t flash_addr = sector * DISK_SECTOR_SIZE; // 处理跨物理块读取 if((flash_addr % FLASH_SECTOR_SIZE) + DISK_SECTOR_SIZE > FLASH_SECTOR_SIZE) { // 需要分两次读取 uint16_t first_part = FLASH_SECTOR_SIZE - (flash_addr % FLASH_SECTOR_SIZE); W25Q_Read(flash_addr, buffer, first_part); W25Q_Read(flash_addr + first_part, buffer + first_part, DISK_SECTOR_SIZE - first_part); } else { W25Q_Read(flash_addr, buffer, DISK_SECTOR_SIZE); } return 0; }2.2 坏块管理与磨损均衡
工业级应用需要考虑Flash寿命问题，推荐实现方案：
- 坏块标记：在Flash保留区建立坏块表
- 动态映射：逻辑地址到物理地址的转换表
- 写入计数：记录每个块的擦写次数
- 热备块：保留部分块用于替换损坏块
磨损均衡算法伪代码：
def write_with_wear_leveling(logical_sector, data): physical_block = translation_table[logical_sector] if physical_block.erase_count > threshold: new_block = find_least_used_block() copy_data(physical_block, new_block) mark_block_bad_if_needed(physical_block) physical_block = new_block write_to_block(physical_block, data) update_erase_count(physical_block)3. USB Mass Storage协议实现
3.1 描述符配置要点
设备描述符关键字段配置示例：
const uint8_t MSD_DeviceDescriptor[] = { 0x12, // bLength 0x01, // bDescriptorType (Device) 0x00, // bcdUSB LSB 0x02, // bcdUSB MSB (USB 2.0) 0x00, // bDeviceClass (Defined at Interface) 0x00, // bDeviceSubClass 0x00, // bDeviceProtocol 0x40, // bMaxPacketSize0 (64 bytes) 0x83, // idVendor LSB (ST) 0x04, // idVendor MSB 0x20, // idProduct LSB 0x57, // idProduct MSB 0x00, // bcdDevice LSB 0x02, // bcdDevice MSB 0x01, // iManufacturer 0x02, // iProduct 0x03, // iSerialNumber 0x01 // bNumConfigurations };接口描述符特别注意：
- bInterfaceClass必须设为0x08（Mass Storage）
- bInterfaceSubClass通常为0x06（SCSI透明命令集）
- bInterfaceProtocol建议为0x50（Bulk-Only Transport）
3.2 SCSI命令处理核心
必须实现的SCSI命令列表：
- INQUIRY (0x12)：返回设备基本信息
- READ CAPACITY (0x25)：报告存储容量
- READ (0x28)：读取数据
- WRITE (0x2A)：写入数据
- REQUEST SENSE (0x03)：错误报告
- TEST UNIT READY (0x00)：设备状态检查
READ CAPACITY响应示例：
void Handle_ReadCapacity(void) { uint32_t last_lba = (FLASH_SIZE / DISK_SECTOR_SIZE) - 1; uint32_t block_size = DISK_SECTOR_SIZE; MSD_Data[0] = (last_lba >> 24) & 0xFF; MSD_Data[1] = (last_lba >> 16) & 0xFF; MSD_Data[2] = (last_lba >> 8) & 0xFF; MSD_Data[3] = last_lba & 0xFF; MSD_Data[4] = (block_size >> 24) & 0xFF; MSD_Data[5] = (block_size >> 16) & 0xFF; MSD_Data[6] = (block_size >> 8) & 0xFF; MSD_Data[7] = block_size & 0xFF; }4. 性能优化技巧
4.1 高速缓存策略
针对SPI Flash的读取延迟，建议采用：
- 写缓存：积累多个扇区写入后批量编程
- 读预取：提前读取相邻扇区
- 块映射表缓存：在RAM中维护活跃块映射
缓存配置示例：
typedef struct { uint32_t sector; uint8_t dirty; uint8_t data[DISK_SECTOR_SIZE]; } SectorCache; #define CACHE_SIZE 8 SectorCache write_cache[CACHE_SIZE]; void AddToWriteCache(uint32_t sector, uint8_t* data) { // 查找空闲或LRU缓存槽 int slot = find_cache_slot(sector); memcpy(write_cache[slot].data, data, DISK_SECTOR_SIZE); write_cache[slot].sector = sector; write_cache[slot].dirty = 1; // 缓存满时触发写入 if(cache_full()) { flush_write_cache(); } }4.2 SPI时序优化
通过硬件SPI配置提升传输效率：
void SPI_ConfigForHighSpeed(void) { SPI_InitTypeDef SPI_InitStructure; SPI_InitStructure.SPI_Direction = SPI_Direction_2Lines_FullDuplex; SPI_InitStructure.SPI_Mode = SPI_Mode_Master; SPI_InitStructure.SPI_DataSize = SPI_DataSize_8b; SPI_InitStructure.SPI_CPOL = SPI_CPOL_High; SPI_InitStructure.SPI_CPHA = SPI_CPHA_2Edge; SPI_InitStructure.SPI_NSS = SPI_NSS_Soft; SPI_InitStructure.SPI_BaudRatePrescaler = SPI_BaudRatePrescaler_4; // 18MHz @72MHz SPI_InitStructure.SPI_FirstBit = SPI_FirstBit_MSB; SPI_InitStructure.SPI_CRCPolynomial = 7; SPI_Init(FLASH_SPI, &SPI_InitStructure); SPI_Cmd(FLASH_SPI, ENABLE); }5. 实战调试技巧
5.1 常见问题排查表
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 设备无法识别 | USB D+上拉电阻未使能 | 检查USB连接检测电路 |
| 识别为"未知设备" | 描述符配置错误 | 使用USB分析仪抓取描述符 |
| 能识别但无法格式化 | READ CAPACITY响应错误 | 检查容量计算和字节序 |
| 写入后数据丢失 | 未正确实现WRITE(10)命令 | 验证写缓存刷新机制 |
| 传输速度慢 | SPI时钟配置过低 | 提升SPI时钟，启用DMA传输 |
5.2 性能测试指标
使用CrystalDiskMark测试典型性能：
| 测试项 | SPI Flash (W25Q128) | SD卡 (Class 10) |
|---|---|---|
| 顺序读取(MB/s) | 1.2-1.8 | 15-20 |
| 顺序写入(MB/s) | 0.5-0.8 | 10-15 |
| 4K读取(IOPS) | 300-500 | 2000-3000 |
| 4K写入(IOPS) | 100-200 | 1000-1500 |
提示：实际性能受SPI时钟频率、芯片负载和固件优化程度影响较大
6. 进阶应用扩展
6.1 多存储介质支持
通过修改MAL（Memory Access Layer）接口，可支持多种存储设备：
uint16_t MAL_Init(uint8_t lun) { switch(lun) { case 0: return SPI_FLASH_Init(); // W25Q系列 case 1: return EEPROM_Init(); // AT24C系列 case 2: return FRAM_Init(); // FM25系列 default: return MAL_FAIL; } }6.2 安全功能实现
写保护机制：
- 硬件写保护引脚控制
- 软件写保护标志位
- 密码验证写入
#define WRITE_PROTECT_PIN GPIO_Pin_0 #define WRITE_PROTECT_PORT GPIOB int Check_WritePermission(uint32_t sector) { // 检查硬件写保护 if(GPIO_ReadInputDataBit(WRITE_PROTECT_PORT, WRITE_PROTECT_PIN) == 0) { return 0; // 硬件写保护启用 } // 检查软件写保护区域 if(sector >= PROTECT_START_SECTOR && sector <= PROTECT_END_SECTOR) { return verify_password(current_password); } return 1; // 允许写入 }在完成SPI Flash模拟U盘的整个开发过程中，最关键的突破点在于正确处理SCSI命令集与物理存储特性的映射关系。特别是在处理WRITE(10)命令时，必须注意Flash的擦除-写入特性，避免数据损坏。实际测试中发现，在Windows系统下，适当的延迟插入（在USB初始化完成后再连接D+上拉）可以显著提高枚举成功率。