STM32+CH376实现U盘读写：方案选型、硬件连接与调试经验

简介面向嵌入式开发者的STM32CH376 U盘读写例程包解决单片机通过SPI总线控制CH376芯片完成USB存储设备读写的问题。例程基于STM32F10x标准外设库覆盖硬件连接、SPI初始化、CH376主机模式配置、USB设备枚举、FAT16/FAT32文件系统操作及异常处理等关键环节适合学习USB主机协议或需要快速集成U盘功能的开发者。包体共99个文件压缩后仅333KB其中34个C源文件与33个头文件构成驱动与示例主体12个启动汇编文件适配不同编译环境IAR与Keil工程配置文件可让开发环境直接打开另有说明文档与打包脚本便于查阅修改和二次开发。工程目录保留CMSIS库与CH376驱动分层结构内容预览中可看到src/inc等模块划分方便对照数据手册理解命令调用流程。已有1724人学习/下载该经典例程参考价值较高结合源码与修改记录可快速掌握SPI通信细节与文件操作流程减少入门排错成本。 CH376这颗芯片在嵌入式U盘读写领域算是一颗老将了很多做数据采集、固件升级、设备配网的工程师都跟它打过交道。我最初接触这颗芯片是在一个需要给设备增加“数据导出”功能的项目上——设备实时采集传感器数据存在本地Flash里客户希望插上U盘就能把数据拷走而不是拆机连串口。当时对比了几种方案最终选了STM32CH376的组合一路从画板、写驱动到调通文件读写踩了不少坑也沉淀了一套比较完整的例程思路。这篇文章就把这套方案从头到尾拆开讲透从芯片选型、硬件连接到驱动移植、文件读写流程再到各种诡异问题的排查尽量把能说的细节都写出来给准备入坑或正在调试CH376的朋友做个参考。1. 方案选型与整体设计思路1.1 为什么选择CH376而不是其他方案在STM32上做U盘读写市面上主流的方案大致有三类用带USB OTG功能的STM32直接操作U盘比如STM32F4系列用CH376这类专用USB Host芯片或者用SPI转USB的桥接方案。我最终选择CH376核心原因是“省心”——如果直接用STM32的USB Host功能需要移植USB协议栈、处理Mass Storage类协议、还要自己实现FAT文件系统或者移植FatFs整个软件栈非常庞大调试周期很长。而CH376芯片内部已经固化好了USB Host控制器和FAT文件系统支持FAT12/16/32MCU只需要通过并口、SPI或异步串口发送简单的命令就能完成U盘的枚举、挂载、文件打开、读写、删除等操作相当于把最复杂的USB底层协议和文件系统全封装掉了。从成本角度看CH376的单价也不算高比起用一颗带OTG的高端STM32整体BOM成本能省下不少。而且CH376支持3.3V和5V供电电平兼容性也比较好在实际工程中不必额外做电平转换。当然这个方案的代价是灵活性受限——比如你要支持exFAT或者NTFSCH376就无能为力了但对于大多数工业数据导出、固件升级、日志记录场景来说FAT32完全够用。1.2 通信接口的选择并口、SPI还是串口CH376提供了三种与MCU通信的接口8位并口、SPI从机接口和异步串口。我实际用的是SPI接口这是我最推荐的方式。原因有三个第一并口会占用大量GPIO在STM32管脚紧张的项目里很不现实第二串口虽然接线最少但速度受限于波特率传输大文件时会有瓶颈第三SPI接口全双工、速度快理论上可达几十Mbps而且STM32的硬件SPI外设用起来很顺手。举个例子我在项目中用STM32F103C8T6蓝色Pill小板SPI1的SCK、MOSI、MISO分别接PA5、PA7、PA6另外还需要一个片选引脚我用PA4和一个CH376的中断输出引脚INT#接PA3配置为外部中断输入。CH376的SPI接口是“半双工”性质的——因为命令/数据是单线双向传输的所以MISO和MOSI实际上要短接在一条线上具体接法我后面详细说这是很多人第一次接线容易踩坑的地方。如果觉得半双工麻烦也可以用并口CH376并口读写的时序比较简单类似操作SRAM不过程序里就要多写几个IO模拟并口时序的函数了。1.3 软硬件架构分层这套例程的软件架构我建议分成三层来写底层驱动层CH376底层命令收发负责SPI初始化、片选控制、以及最基础的CH376命令帧/数据帧的收发。这一层最容易出错但接口不要设计得太复杂我一般就提供CH376_Init、CH376_WriteCommand、CH376_WriteData、CH376_ReadData、CH376_ReadStatus这几个函数。功能封装层文件操作API基于底层驱动封装成面向应用的函数比如CH376_FileOpen、CH376_FileRead、CH376_FileWrite、CH376_FileClose等。这层代码几乎可以直接从WCH官方资料里参考但要根据自己的硬件平台修正延时和IO操作。应用层根据实际业务逻辑调用文件操作API比如把一段内存数据写入U盘里一个名为LOG_20240622.TXT的文件或者从U盘读取配置文件解析参数。这样分层的好处是拿到官方例程后你只需要先搞定底层驱动上层代码基本不用动后续如果换芯片型号比如从F103换成G031只需要改底层SPI相关的部分上层逻辑完全复用。2. 硬件连接与关键电路说明2.1 引脚连接对照表以STM32F103 CH376 SPI模式为例完整接线如下CH376引脚功能连接目标说明SCSSPI片选PA4低电平有效拉低选中CH376SCKSPI时钟PA5由STM32产生时钟SDI串行数据输入PA7 (MOSI)数据线见下方半双工说明SDO串行数据输出PA6 (MISO)数据线见下方半双工说明INT#中断输出PA3 (EXIT3)命令完成时拉低通知MCUVCC电源3.3V也可5V具体看模块设计GND地GND必须共地UD / UD-USB信号USB座/Type-C连接U盘VBUSUSB供电5V给U盘供电用注意SPI半双工接法是最容易搞错的地方。CH376的SDI和SDO实际上在芯片内部是同一个双向口所以外部必须把STM32的MOSI和MISO短接后再连到CH376的SDI/SDO上。也就是说CH376那边其实只需要一根数据线。如果照常规SPI全双工方式分开接通信会直接失败或者出现数据错乱。2.2 电源与电平细节CH376虽然工作在3.3V~5V范围但U盘的供电必须格外注意。U盘在读写瞬间会有明显的大电流需求尤其是在写入大文件时电流可以飙到200mA甚至更高。如果直接用STM32开发板的3.3V引脚给U盘供电大概率会出现U盘识别不稳定、写入中断、文件系统损坏等问题。我实际测试下来最可靠的做法是单独用一片5V稳压或直接从USB/VIN取5V给U盘VBUS供电地线跟STM32和CH376共地。如果是在面包板上做实验务必用外部电源给U盘供电别图省事从3.3V的LDO后面取电。另外CH376官方芯片手册里的典型电路还给VBUS加了一个220uF的大电解电容和0.1uF的退耦电容用来吸收U盘突发电流这个电容建议保留不要省。2.3 硬件调试前的检查清单在动手写代码之前建议用万用表和示波器先确认以下几项VCC对地电压是否正常3.3V或5V看模块要求CH376的晶振是否起振CH376需要外部12MHz晶振如果听不到或看不到振荡波形芯片不会工作SCS上电默认是高还是低CH376复位后SCS应该处于高电平否则片选逻辑会乱INT#引脚是否可以通过外部上拉到高电平上电后应该确实为高。我在第一版样板调试时曾经因为CH376模块上的晶振没焊好导致所有命令都无响应排查了很久才发现是晶振的问题。所以硬件上电后优先确认这三件事电源、晶振、电平能省掉大量软件调试时间。3. 驱动层初始化与核心命令收发3.1 CH376 命令体系速览CH376的交互模式很简洁主机STM32向芯片发送“命令码”然后根据命令码的要求继续发送数据或读取结果数据。所有命令的格式分两类无数据命令只发一个字节的命令码然后读状态寄存器获取操作结果。带数据命令发送命令码后再发若干字节的数据比如文件名、缓冲区数据或者读取若干字节比如读取U盘数据、读取状态。CH376的常用命令码在官方手册里有表我挑几个最重要的列出来命令码名称功能0x06CMD_CHECK_EXIST测试芯片是否在线0x11CMD_DISK_INIT初始化U盘相当于挂载0x14CMD_DISK_READ读取U盘数据扇区0x15CMD_DISK_RD_GO继续读取扇区数据0x16CMD_DISK_WRITE写入U盘数据扇区0x17CMD_DISK_WR_GO继续写入扇区数据0x32CMD_FILE_OPEN打开文件或创建文件0x36CMD_FILE_READ读取文件数据0x3CCMD_FILE_WRITE向文件写入数据0x3DCMD_FILE_CLOSE关闭文件3.2 底层收发函数实现SPI模式下CH376的命令帧、数据帧和状态帧时序略有差异但其核心是每个字节前先拉低SCS片选发送完再拉高SCS。我整理了一份最精简的底层代码可直接参考// SPI 底层发送一个字节并读取一个字节半双工数据线 uint8_t CH376_SPI_Transfer(uint8_t byte) { uint8_t recv; // 这里用的是标准库 SPI1 SPI_I2S_SendData(SPI1, byte); while (SPI_I2S_GetFlagStatus(SPI1, SPI_I2S_FLAG_RXNE) RESET); recv SPI_I2S_ReceiveData(SPI1); return recv; } // 写命令 void CH376_WriteCommand(uint8_t cmd) { GPIO_ResetBits(GPIOA, GPIO_Pin_4); // CS 拉低 CH376_SPI_Transfer(0x00); // 发送命令操作码前置字节 CH376_SPI_Transfer(cmd); GPIO_SetBits(GPIOA, GPIO_Pin_4); // CS 拉高 } // 写数据 void CH376_WriteData(uint8_t data) { GPIO_ResetBits(GPIOA, GPIO_Pin_4); CH376_SPI_Transfer(0x00); CH376_SPI_Transfer(data); GPIO_SetBits(GPIOA, GPIO_Pin_4); } // 读数据 uint8_t CH376_ReadData(void) { uint8_t val; GPIO_ResetBits(GPIOA, GPIO_Pin_4); CH376_SPI_Transfer(0x00); // 前置字节 val CH376_SPI_Transfer(0x00); // 读一个字节 GPIO_SetBits(GPIOA, GPIO_Pin_4); return val; }关于前置字节CH376在SPI模式下每个字节传输前需要先在MOSI上发一个0x00这点看起来有点别扭但这是芯片的时序规定必须照做。我曾试过去掉这个前置字节结果状态寄存器永远读不到预期值。3.3 检测芯片在线的“握手”操作驱动写完后第一件事是验证MCU和CH376之间是否通信正常这时候用CMD_CHECK_EXIST0x06最直观uint8_t CH376_CheckExist(void) { uint8_t i, result 0; CH376_WriteCommand(0x06); // CMD_CHECK_EXIST CH376_WriteData(0x55); // 任意数据 // 数据手册说正常时应返回 0xAA result CH376_ReadData(); return (result 0xAA) ? 0 : 1; }如果这个函数返回正确读到0xAA说明SPI时序、片选、电平、晶振都OK可以进入下一步。如果读不到0xAA把SPI时钟调慢一点比如分频到1MHz以下再试排除“速率过快导致时序太紧”的问题。我调试时遇到过一次读回0xAA但偶尔出错的情况最后发现是SPI的极性/相位配置不对CH376要求CPOL0、CPHA0模式0务必检查。3.4 U盘挂载流程通信验证通过后就可以进行U盘初始化和挂载uint8_t CH376_DiskMount(void) { // 等待U盘插入 CH376_WriteCommand(0x11); // CMD_DISK_INIT // 等待中断 CH376_WaitInterrupt(); if (CH376_ReadStatus() 0x14) // USB_INT_USB_READY return 0; // 挂载成功 return 1; }这里有个关键点CMD_DISK_INIT是个异步命令芯片完成初始化后会通过INT#引脚拉低来通知MCU所以MCU需要等待中断然后再读取状态寄存器确认结果。实际项目中我一般把等待中断写成一个带超时的函数比如500ms超时防止U盘故障导致程序卡死uint8_t CH376_WaitInterrupt(void) { uint32_t timeout 5000; // 约500ms while (GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_3) ! RESET) { if (--timeout 0) return 1; // 超时 Delay_1ms(1); } return 0; }这一步如果失败常见原因是U盘供电不足或者U盘本身格式不支持比如NFTS格式就挂载不了需要格式化成FAT32。另外CH376对“插上U盘但未格式化”的情况也会返回错误此时建议先把U盘在电脑上格式化为FAT32再试。4. 文件读写核心流程实现4.1 打开/创建文件挂载U盘后对文件的操作几乎都是类似“打开→读/写→关闭”的流程。CH376打开文件的指令是CMD_FILE_OPEN0x32它接受一个完整的文件路径字符串比如\LOG.TXT根目录下或者\DATA\RECORD.BIN子目录下。uint8_t CH376_FileOpen(const char *path) { CH376_WriteCommand(0x32); // CMD_FILE_OPEN // 发送文件名 while (*path) CH376_WriteData(*path); CH376_WriteData(0x00); // 字符串结束符 // 等待中断 CH376_WaitInterrupt(); return CH376_ReadStatus(); // 0x14成功其他值可查手册 }如果文件不存在会返回错误0x1CERR_MISS_DIR 或类似错误码。这时如果业务上需要“创建新文件”可以先发送CMD_FILE_CREATE0x33再走同样的流程。我经常遇到的一个需求是每次开机创建当日日志文件所以要组合使用“先尝试打开打开失败则创建”。4.2 文件写入操作写入流程可以简单概括为发送CMD_FILE_WRITE0x3C等中断读取状态确认如果返回0x14说明芯片准备好接收数据然后写入一帧数据再次等待中断确认循环直到写完最后CMD_FILE_CLOSE0x3D收尾。uint8_t CH376_FileWrite(uint8_t *buf, uint16_t len) { uint16_t sent 0; while (sent len) { CH376_WriteCommand(0x3C); // CMD_FILE_WRITE CH376_WriteData(len - sent); // 请求写入长度 if (CH376_WaitInterrupt()) return 1; if (CH376_ReadStatus() ! 0x14) return 2; // 芯片就绪逐字节发送数据 uint16_t chunk len - sent; while (chunk--) CH376_WriteData(buf[sent]); // 再次等中断确认写入完成 if (CH376_WaitInterrupt()) return 3; } return 0; }注意CH376的FIFO缓冲区大小有限一次写入的数据长度不建议超过255字节如果文件较大可以分包循环写。另外单次写入后最好加一点小延时几百微秒给芯片擦写Flash的时间不然连续高频写入偶尔会遇到“中断没及时触发”的情况。4.3 文件读取操作读取流程和写入对称打开文件后用CMD_FILE_READ0x36请求读取等待中断芯片返回数据后逐字节读出来持续到文件结束读到0x42 ERR_END_OF_FILE。uint16_t CH376_FileRead(uint8_t *buf, uint16_t maxLen) { uint16_t received 0; while (received maxLen) { CH376_WriteCommand(0x36); // CMD_FILE_READ CH376_WriteData(maxLen - received); if (CH376_WaitInterrupt()) break; uint8_t st CH376_ReadStatus(); if (st 0x14) // 有数据 { uint16_t cnt maxLen - received; while (cnt--) buf[received] CH376_ReadData(); } else if (st 0x42) // 文件结束 break; else break; } return received; }这里有一个隐蔽的坑CH376的CMD_FILE_READ返回的“可读长度”不一定等于你请求的长度如果文件剩余字节数不足它会返回剩余的实际字节数所以一定要以状态寄存器返回的0x14为准在数据读取完后检查是否真的还有数据可读否则容易多读导致错位。4.4 关闭文件与目录操作文件写完务必调用CMD_FILE_CLOSE0x3D否则U盘上的文件大小不会刷新甚至会出现文件系统损坏。关闭文件时还可以带一个“更新长度”模式选择具体看官方手册位定义我一般默认传0即可。如果需要遍历U盘根目录CH376也提供了CMD_FILE_ENUM_OPEN、CMD_FILE_ENUM_NEXT等命令可以用来查找特定文件是否存在、列出所有文件等。这个功能在设备需要“自动识别U盘里的升级固件”时非常有用——先枚举目录匹配到指定文件名再打开读取。5. 实际调试中的坑与排查技巧5.1 U盘插上后不能识别或者识别极慢这个问题我在实验阶段遇到过无数次。排查顺序是供电问题换一个短一点的USB线、或者用带独立供电的USB Hub/外部5V给U盘供电排除U盘欠压。USB座虚焊/接触不良很多CH376模块上的USB座是直插式焊盘很小容易虚焊用放大镜仔细检查。U盘兼容性CH376对U盘主控有兼容性问题一些老U盘或杂牌U盘可能无法枚举。手头多备两个不同品牌的U盘做交叉验证。晶振起振CH376的12MHz晶振不起振会导致芯片完全无响应直接测SCK引脚或INT#引脚上电波形来确认。5.2 写入U盘速度慢只有几KB/s如果发现写入大文件特别慢先确认用的是SPI模式还是并口模式。并口模式理论速度更高但SPI模式只要SPI时钟配置合理我习惯4分频即18MHz但我调试时发现18MHz在长线上容易出错稳妥起见用8分频即9MHz实际写入速度能到50~100KB/s左右对日志记录场景够用。如果速度远低于这个多半是每写一个字节都在等中断检查等中断逻辑是否有长时间延时或者单次写入请求的长度没有按255字节分包来利用满FIFO。5.3 文件名带中文或长文件名无法打开CH376自带FAT系统支持的是8.3短文件名格式。如果你在电脑上给文件起名叫2024年数据记录.logCH376枚举时大概率看到的是截断后的短文件名类似2024~1.LOG直接按长文件名打开会失败。解决办法文件名的命名尽量用纯大写字母数字下划线的8.3形式比如LOG2024.TXT、UPDATE.BIN不要用中文、空格、特殊符号。这也是工业设备上固件命名普遍约定俗成的原因。5.4 频繁拔插后文件系统损坏CH376在文件写入未关闭时就拔U盘文件分配表很容易损坏。实际工程中除了程序上保证写完即关闭还可以考虑硬件上增加U盘插入检测比如USB座的VBUS引脚做分压检测在写入期间检测到U盘拔出就立刻停止写操作并重新初始化。如果U盘已经损坏插回电脑上可以用chkdsk工具修复但更省事的方式是格式化为FAT32后重新测试。5.5 使用逻辑分析仪辅助调试调试CH376这类带严格时序的芯片强烈建议准备一个便宜的24MHz/8通道逻辑分析仪几十块钱把SCS、SCK、MISO/MOSI、INT# 这几根线都抓进去对照官方手册里的时序图比对。很多时候程序看起来“发送了数据但芯片不响应”一抓波形立刻能看到是片选拉低太短、还是时钟极性反了、还是数据位顺序反了。这套调试方法帮我在半小时内解决过一次三天都没查出来的通信问题非常值得投入。6. 例程的可复用性与扩展思路6.1 把例程移植到自己的STM32型号上这套例程在STM32F103上验证通过但由于底层驱动只依赖SPI和GPIO移植到其他STM32型号基本只需改三处SPI初始化引脚的宏定义、延时函数替换成对应平台的时间基准、中断引脚的配置方式。如果换用HAL库只需把最底层那三个CH376_SPI_Transfer、GPIO_ResetBits/SetBits换成HAL对应的API即可。我后来把它移植到STM32G030F6P6一块几块钱的Cortex-M0芯片上也稳定跑起来了。6.2 常见业务场景扩展基于这套U盘读写例程可以快速扩展出几类常见功能数据记录仪周期采集传感器数据定时写入U盘生成CSV文件供上位机分析作图。固件升级把编译好的固件bin文件放到U盘根目录设备开机时枚举检测到文件读取并写入Bootloader指定的Flash区域实现“U盘一键升级”。配置导入导出设备参数通过电脑生成一个配置文件放U盘插入设备后自动读取并解析免去逐项设置的麻烦。批量数据采集回传在户外或无网络环境采集数据存放在U盘回到办公室再导入电脑处理适合现场运维场景。6.3 性能优化思路如果觉得写U盘速度不够可以结合CH376的扇区级读写接口CMD_DISK_READ/CMD_DISK_WRITE直接操作文件底层扇区跳过文件系统层但这需要自己在MCU端维护FAT表复杂度和风险都会上升除非速度是硬性指标否则我不建议这么做。另外一个折中方案是加大写入缓冲例如每256字节作为一个扇区按扇区边界对齐写入也能稍微减少FAT表更新频率实测对速度有一定改善。7. 写在最后的调试心得回头看这套STM32CH376方案最大的价值在于“用简单的代码换来可靠的功能”。和直接用USB Host协议栈相比它省去了大量底层调试工作特别适合资源和时间都有限的嵌入式项目。实际开发中我建议把官方例程当作“参考手册”而不是“万灵药”——官方代码在标准平台上没问题但换到自己的板子上时序延时、上电时序、电源纹波都可能引入意想不到的问题。每改一个硬件参数都建议回归测试一遍第一章节的“硬件检查清单”再逐级调通底层命令、挂载、文件读写这样即使出了问题也能快速定位。如果你也要在STM32上做U盘读写强烈建议先把这套例程在最小系统板上完整跑一遍把每一个命令的返回状态都通过串口打印出来确认再接入自己的业务逻辑。CH376这颗芯片虽然不算“新”但它在U盘读写这个细分场景里把复杂度和可靠性平衡得非常好直到今天依然是很值得用的方案。希望这篇文章能帮你少踩几个坑顺利调通自己的项目。本文还有配套的精品资源点击获取