深入解析STM32F103的USB Mass Storage实现：SCSI命令实战指南

1. USB Mass Storage基础概念与STM32F103适配

在嵌入式系统开发中，实现USB Mass Storage功能是让设备被识别为U盘的关键技术。STM32F103系列作为经典的Cortex-M3内核微控制器，其内置的USB外设为这一功能提供了硬件基础。这里有个常见的误解：很多人以为USB Mass Storage只是简单的数据传输，实际上它是一套完整的协议栈，包含USB传输层、BOT（Bulk-Only Transport）协议和SCSI命令集三层结构。

我刚开始接触这个功能时，最头疼的就是理解这三层之间的关系。简单来说，USB层负责物理传输，BOT协议规定了数据包格式（CBW/CSW），而SCSI命令才是真正控制存储介质的"语言"。STM32CubeMX生成的USB库已经帮我们处理了前两层，开发者需要重点实现的就是SCSI命令响应。

硬件配置上要注意几个关键点：

• USB时钟必须精确配置为48MHz（使用PLL时钟）
• DP引脚需要接1.5k上拉电阻
• 建议使用Dedicated端点（不要用端点0）进行批量传输
• 内存缓冲区要足够大（至少512字节）

// USB初始化代码片段 void USB_Init(void) { __HAL_RCC_USB_CLK_ENABLE(); HAL_PCDEx_SetRxFiFo(&hpcd, 0x80); HAL_PCDEx_SetTxFiFo(&hpcd, 0, 0x40); HAL_PCDEx_SetTxFiFo(&hpcd, 1, 0x80); HAL_PCD_Start(&hpcd); }

2. SCSI命令协议深度解析

SCSI命令看似复杂，其实可以归纳为三种基本类型：状态查询类（如TEST_UNIT_READY）、数据传输类（如READ10/WRITE10）和设备控制类（如START_STOP_UNIT）。每个命令通过CBW包的Operation Code字段区分，后面跟着的参数就像函数参数一样控制具体行为。

命令处理流程的黄金法则：

1. 先检查LUN（逻辑单元号）是否有效
2. 验证命令参数是否合法
3. 执行具体操作
4. 返回CSW状态包

以最常用的READ10命令为例，它的参数结构就像这样：

• CB[2]-CB[5]：起始逻辑块地址（LBA）
• CB[7]-CB[8]：要读取的块数
• CB[1]：各种标志位（DPO/FUA等）

void SCSI_ProcessRead10(uint8_t lun) { uint32_t lba = (gMscCBW.CB[2]<<24) | (gMscCBW.CB[3]<<16) | (gMscCBW.CB[4]<<8) | gMscCBW.CB[5]; uint16_t blkLen = (gMscCBW.CB[7]<<8) | gMscCBW.CB[8]; if(!SCSI_CheckAddressRange(lun, lba, blkLen)) { SCSI_SenseCode(lun, ILLEGAL_REQUEST, INVALID_FIELED_IN_CDB); MSC_BOT_SendCSW(CSW_CMD_FAILED); return; } MSC_BOT_DataInTransfer(lun, Mass_Block[lun]+lba*BLOCK_SIZE, blkLen*BLOCK_SIZE); }

3. 关键SCSI命令实战实现

3.1 设备就绪检测（TEST_UNIT_READY）

这个命令相当于主机的"心跳检测"，会不断轮询设备状态。实现时最容易踩的坑是没处理好介质状态变化。比如插入SD卡时，如果检测太慢会导致主机认为设备无响应。我的经验是：

• 在命令处理函数里加超时检测
• 对于可移动介质，状态变化要立即更新Sense Key
• 保持响应时间在100ms以内

void SCSI_TestUnitReady(uint8_t lun) { if(Mass_Storage_Status(lun) != 0) { SCSI_SenseCode(lun, NOT_READY, MEDIUM_NOT_PRESENT); MSC_BOT_SendCSW(CSW_CMD_FAILED); return; } MSC_BOT_SendCSW(CSW_CMD_PASSED); }

3.2 容量查询（READ_CAPACITY10）

这个命令返回两个关键参数：最大LBA地址和块大小。有个细节很多人会忽略——LBA地址是从0开始的，所以最大地址等于块数减1。我在项目中就因为这个错误导致Windows显示容量总是少一个块。

void SCSI_ReadCapacity10(uint8_t lun) { uint8_t data[8]; data[0] = (BlockCount[lun]-1)>>24; data[1] = (BlockCount[lun]-1)>>16; data[2] = (BlockCount[lun]-1)>>8; data[3] = (BlockCount[lun]-1); data[4] = BlockSize[lun]>>24; data[5] = BlockSize[lun]>>16; data[6] = BlockSize[lun]>>8; data[7] = BlockSize[lun]; MSC_BOT_SendData(data, 8); }

3.3 数据传输优化技巧

READ10/WRITE10命令的性能直接影响文件传输速度。通过实测发现三个优化点：

1. 使用DMA传输而非中断方式
2. 提前准备好数据缓冲区
3. 合理设置USB包大小（建议最大包长设为64字节）

void Mass_Storage_Out(uint8_t lun, uint8_t *buf, uint32_t len) { if(SCSI_Write10_State == 0) { // 第一阶段：接收CBW USB_Receive(EP_OUT, (uint8_t*)&gMscCBW, CBW_LENGTH); } else { // 第二阶段：接收数据 USB_Receive(EP_OUT, buf, len); SCSI_Write10_State = 2; } }

4. 异常处理与调试经验

4.1 常见错误排查

在开发过程中，我遇到过各种奇怪的问题。比如电脑突然提示"需要格式化"，通常是因为：

• CSW包的Signature字段错误（正确应为0x53425355）
• 数据残留长度（dDataResidue）计算错误
• Sense Data没有正确设置

建议在调试时用逻辑分析仪抓取USB数据包，重点关注：

1. CBW包的标志和长度
2. 数据阶段的传输方向
3. CSW包的状态值

4.2 Sense Key设置规范

Sense Data是错误诊断的关键，相当于设备的"异常描述"。几个常用组合：

• NOT READY + MEDIUM_NOT_PRESENT：介质未就绪
• ILLEGAL REQUEST + INVALID_FIELED_IN_CDB：命令参数错误
• HARDWARE ERROR + UNRECOVERED_READ_ERROR：读取失败

void SCSI_SenseCode(uint8_t lun, uint8_t sKey, uint8_t ASC) { gSense[lun].key = sKey; gSense[lun].asc = ASC; gSense[lun].ascq = 0x00; }

4.3 稳定性提升技巧

经过多个项目验证，这些措施能显著提高稳定性：

1. 在USB中断里不做复杂处理
2. 为DMA传输添加内存屏障（__DSB()）
3. 处理完一个命令前屏蔽新请求
4. 添加看门狗超时检测

最后分享一个真实案例：某次产品批量生产时，发现部分设备在Win10上识别不稳定。后来发现是CSW发送时序问题——必须在数据阶段完成后立即发送CSW，添加了50μs延迟后问题彻底解决。这说明USB Mass Storage对时序的要求极其严格，任何细微偏差都可能导致兼容性问题。