简介基于STM32与CH376 USB主机芯片的U盘读写例程面向嵌入式开发者演示通过SPI总线驱动CH376实现U盘文件读写覆盖硬件连接、SPI初始化、USB设备枚举、FAT文件系统操作及异常处理等完整流程。资源为RAR压缩包共99个文件、333KB以34个C源文件、33个头文件和12个汇编文件为主体另含IAR与Keil工程文件、说明文档及批处理脚本可直接导入工程或迁移到其他STM32项目。已有1724人学习使用对入门STM32 USB Host应用具有参考价值。例程代码来自Ex201-U盘读写例程目录结构清晰开发者可据此理解CH376命令交互复用其中文件读写函数附带修改记录与工程配置便于结合芯片数据手册开展二次开发。 做嵌入式这几年最头疼的事情之一就是给STM32加U盘读写功能。不是说STM32不行而是USB Host协议栈加FAT文件系统这一整套东西,光是把官方USB库调通就要掉一层头发更别提还要处理各种U盘兼容性问题。后来我换了个思路用CH376这颗USB接口控制芯片直接把U盘读写这件事从“地狱难度”降到了“SPI读写Flash”的级别整个开发周期缩短了大概三分之二。这篇就把我实际调试CH376驱动STM32的完整过程、源码逻辑和踩过的坑都摊开讲。1. 为什么是CH376一个例程解决USB Host和文件系统两件大事先明确说清楚CH376到底是个什么角色。它是南京沁恒出的一颗USB接口芯片最大的特点是把USB Host控制器和FAT文件系统固件全部做到了芯片内部。MCU通过SPI或者并口给CH376发命令CH376自己去枚举U盘、处理FAT表、维护目录项MCU层面只需要关心“我要打开哪个文件”“我要读多少字节”剩下的脏活累活它全包了。这个架构给开发带来的好处是本质性的。以前用STM32自带的USB OTG做Host你要面对的是USB枚举状态机、控制传输、批量传输、SCSI指令集、FAT12/16/32的簇链管理这些东西随便哪一个拎出来都够写上两周。而CH376方案下STM32只是通过SPI发几个字节的命令字比如CMD_FILE_OPEN、CMD_FILE_READ、CMD_FILE_WRITE然后等中断、查状态、搬数据就这么简单。而且CH376的库文件是官方直接提供的底层已经把命令封装成CH376FileOpen、CH376FileRead、CH376FileWrite、CH376FileClose这么几个接口用户只需要关心应用层逻辑。我最初用的时候还怀疑过这芯片是不是有坑实际跑下来发现它对市面常见U盘的兼容性做得确实不错至少比我以前自己移植USB Host栈时稳定得多。如果你项目里只是需要“插个U盘导数据”这种功能CH376是当前性价比最高的选择没有之一。顺带说一句CH376和CH375的关系也要理清。CH375是早期型号只提供USB Host底层传输能力FAT文件系统需要MCU自己实现。CH376则在CH375基础上把文件系统固件做进了芯片ROM里命令接口更上层所以叫“内置文件系统固件的USB接口芯片”。直接用CH376不要再拿CH375的方案硬套。2. 硬件连接与最小系统搭建2.1 引脚分配与SPI接线CH376有SPI、并口、UART三种接口模式STM32项目里最常用的是SPI模式因为省引脚、速度快、接线简单。建议分配如下STM32引脚CH376引脚说明PA4CS片选低电平有效PA5SCKSPI时钟PA6MISOSDICH376输出STM32输入PA7MOSISDOSTM32输出CH376输入PB0INT中断请求输出低电平有效NRSTRST复位低电平复位这里有个特别容易犯迷糊的地方CH376数据手册里标注的是SDI和SDO这跟STM32的MISO/MOSI正好是反着对应的。SDI全称是Serial Data In从CH376自己角度看是输入所以接STM32的MOSIPA7SDO是Serial Data Out接STM32的MISOPA6。我第一次接反了结果读状态寄存器永远是0xFF折腾了半天还以为是芯片烧了。INT引脚必须处理。CH376完成一个命令后会拉低INT引脚通知MCUMCU可以轮询也可以接外部中断。实测下来中断方式更省CPU但轮询方式逻辑更简单不容易出bug。我的做法是接PB0并配置为外部中断下降沿触发代码里用信号量通知主循环既省资源又不会卡死。2.2 电路级注意事项CH376是3.3V器件供电必须用3.3V不要直接怼5V芯片会冒烟。但USB接口的VBUS是5V这意味着U盘供电要从VBUS单独取CH376的VCC必须独立接3.3V电源。成熟的电路设计是VBUS接5V给U盘供电CH376的VCC接3.3V两者之间通过磁珠和电容做电源隔离避免U盘电机启动瞬间拉低3.3V导致芯片复位。复位电路建议用RC复位10K电阻加0.1uF电容时间常数约1ms足够保证上电稳定复位。RST引脚也可以直接接到STM32的GPIO上由STM32控制复位时序这样在调试时可以通过软复位让CH376重新初始化方便排查问题。晶振方面CH376内置了PLL外部只需要一个12MHz的无源晶振两个20pF负载电容接地即可。如果发现写文件时数据偶尔出错优先检查晶振起振是否稳定用示波器量一下波形幅度是否达到满幅。3. 驱动库移植与初始化3.1 库文件结构CH376的官方库文件名是CH375HF*.C注意这里虽然写的是CH375但实际是兼容CH376的。库文件的核心是一个约3000行的C文件里面封装了所有底层命令接口。你需要在工程里做的事情是把CH375HF*.C加入工程在头文件里配置接口模式为SPI实现xWriteByte、xReadByte、CH375_INT这几个底层函数整个库对底层的依赖非常小这就意味着移植到任何MCU都很容易。如果你用的是STM32标准库或者HAL库只需要在对应文件里填充SPI收发代码即可。配置接口模式有一个全局宏通常在CH375HF*.H里类似CH375_SPI_IF或者CH375_INTF_GPIO之类的定义必须确保它设置为SPI模式而非并口模式。不同版本的库宏名称略有差异建议在工程里全局搜索SPI关键字把所有相关配置都检查一遍。我之前就是漏了一个宏结果插上U盘后CH376完全没有中断输出白白浪费了大半天。3.2 SPI底层适配SPI底层是整个驱动的基础硬件SPI和模拟SPI我都试过。硬件SPI的优势是速度快CH376的SPI时钟最高可以跑到几MHz到几十MHz实测稳定值在2MHz左右比较安全。模拟SPI的优势是引脚任意、调试方便、不用跟其他外设抢SPI外设。对于U盘读写这种场景数据量通常不会大到需要跑满SPI带宽所以模拟SPI完全够用而且代码可读性更好。硬件SPI模式下建议用SPI_MODE0即CPOL0、CPHA0空闲时时钟为低电平数据在上升沿采样。这个参数必须和CH376匹配否则通信会得到乱码。调试时可以先用SPI读CH376的芯片版本寄存器能读到固定值就说明底层通了。模拟SPI的实现代码很简单核心就两个函数一个拉高拉低SCK一个按位收发数据。如果选择模拟SPI建议把时钟频率控制在1MHz以下减小线间干扰。而且要用同一个GPIO端口组比如都用PA口这样代码执行效率更高时序抖动更小。3.3 初始化与自检初始化流程是固定的先给CH376发复位等待100ms以上然后设置USB工作模式为Host最后断开U盘连接等待插入事件。具体代码流程如下CH375_UART_Init(); // 如果有串口调试先初始化 CH375_SPI_Init(); // SPI底层初始化 CH375_Reset(); // 硬件复位 delay_ms(100); CH375SetUSBMode(0x06); // 0x06表示USB Host模式此命令会耗时较久 delay_ms(20); // 等待U盘插入 while (1) { if (CheckInsert() TRUE) { printf(U盘已插入\r\n); break; } delay_ms(50); }这里有个官方文档没写明白的点CH375SetUSBMode(0x06)这个命令执行后会等待至少几十毫秒因为芯片要在内部完成USB控制器初始化期间串口打印可能会卡住。所以这个函数之后一定要加延时不要立刻发下一条命令否则命令会被丢掉。自检成功的标准是能正确读取芯片版本号CH376的版本寄存器读出来通常是0x34或0x35。如果读出来是0xFF一般是SPI接线错误如果是0x00检查复位和电源。4. 文件读写例程实战4.1 文件写入流程文件写入是U盘读写最核心的场景比如把采集到的传感器数据记录到U盘。整个流程可以拆成“挂载、打开/创建、写数据、关闭”四步每一步都有一个对应的库函数逻辑非常清晰。先看初始化U盘并挂载文件系统的代码uint8_t status; status CH376DiskConnect(); // 检测U盘连接 if (status ! USB_INT_SUCCESS) { printf(U盘连接失败状态: 0x%02X\r\n, status); return; } status CH376DiskMount(); // 挂载文件系统 if (status ! USB_INT_SUCCESS) { printf(文件系统挂载失败状态: 0x%02X\r\n, status); return; } printf(U盘挂载成功\r\n);然后创建或打开文件写入数据uint8_t buf[512]; uint32_t i; // 创建文件如果已经存在则打开 status CH376FileCreate(TEST.BIN); if (status ! USB_INT_SUCCESS) { printf(文件创建失败状态: 0x%02X\r\n, status); return; } // 写入512字节 for (i 0; i 512; i) { buf[i] i 0xFF; } status CH376FileWrite(buf, 512, wLen); if (status USB_INT_SUCCESS) { printf(写入成功实际写入 %d 字节\r\n, wLen); } else { printf(写入失败状态: 0x%02X\r\n, status); } // 关闭文件必须执行否则文件内容可能不会更新 CH376FileClose(FILE_CLOSE_FLUSH);这里有两个细节容易出错。第一CH376FileWrite并不是一次就能把数据全部写入物理U盘它内部可能分为“写命令-写数据-等待写入完成”三个步骤库函数返回USB_INT_SUCCESS只代表数据已经交给CH376真正落盘要等关闭文件。第二CH376FileClose必须带FILE_CLOSE_FLUSH参数这个参数会强制CH376把缓存中的文件目录项和数据块写回U盘。如果你只创建文件、写入数据但不更新目录重新插拔U盘后会发现文件长度是0或者根本不存在。4.2 文件读取流程读取流程和写入几乎对称区别在于打开文件时要先用CH376FileOpen找到文件然后循环读取直到文件尾。CH376会记录当前文件指针每次读取都会自动向后移动不需要手动维护偏移量。uint8_t buf[512]; uint16_t readLen; uint32_t totalRead 0; // 打开文件 status CH376FileOpen(TEST.BIN); if (status ! USB_INT_SUCCESS) { printf(文件打开失败\r\n); return; } // 循环读取 while (1) { status CH376FileRead(buf, 512, readLen); if (status USB_INT_SUCCESS) { for (i 0; i readLen; i) { printf(%02X , buf[i]); } totalRead readLen; if (readLen 512) { break; // 读到了文件尾 } } else { break; } } CH376FileClose(FILE_CLOSE_DISCARD);读取流程的关键问题是怎么判断文件已经读完了。CH376FileRead的返回值有三种情况正常返回USB_INT_SUCCESS且读满指定长度返回成功但实际读取长度小于请求长度以及返回文件结束错误。判断逻辑很简单当实际读取长度小于请求长度时就说明已经到了文件末尾可以安全退出循环。还有一种更保险的做法是读之前先调用CH376FileGetFileSize获取文件大小然后按大小精确循环。另外注意读取完之后关闭文件用FILE_CLOSE_DISCARD和FILE_CLOSE_FLUSH都行因为读操作不会修改文件内容不需要写回目录项。但为了代码一致性我习惯统一用FILE_CLOSE_FLUSH省得哪天改了代码忘了改参数导致文件内容丢失。4.3 文件名规则与兼容性CH376的FAT文件系统固件对文件名是有要求的。标准8.3短文件名格式即最多8个字符的主文件名加3个字符的扩展名不区分大小写但必须是ASCII字符不支持中文长文件名。它内部会自动把文件信息从长文件名目录项转换成短文件名格式但如果你创建文件时传入的是中文名它会直接返回错误。这个限制在产品设计阶段就要考虑清楚否则后期改起来很痛苦。存储介质方面CH376支持FAT12、FAT16和FAT32也就是说格式化时选择FAT32肯定能兼容。但要注意有些新出的U盘默认格式是exFATCH376是不支持的插上去会挂载失败。处理办法有两个一个是产品说明里写清楚“仅支持FAT32格式”另一个是在固件里做检测挂载失败时通过LED或屏幕提示用户重新格式化U盘。另外某些U盘会有多分区或者加密分区CH376只能识别第一个可用的FAT分区。5. 调试中的常见问题与排查链路5.1 问题一U盘插上没反应这是刚开始调试时最容易遇到的问题表现形式是CheckInsert一直返回FALSE好像CH376完全没感知到U盘插入。排查链路应该按照“电源-晶振-SPI-中断-命令”的顺序逐层检查。最先查供电CH376的VCC是不是干净的3.3VU盘的VBUS是不是稳定的5V用万用表量一下芯片供电引脚和USB座的VBUS。很多开发板的USB座是直接接5V的如果你把U盘的5V接到了CH376的3.3V网络上肯定是不行的。然后查晶振用示波器量CH376的XI和XO引脚正常能看到12MHz的正弦波。如果晶振没起振芯片的SPI接口是没有任何响应的。接着查SPI底层通信读版本寄存器是判断通信是否正常的最快方式。如果读到0xFF大概率是MOSI和MISO接反了如果读到其他异常值检查SPI模式和时钟极性问题。最后查中断用示波器或者逻辑分析仪抓INT引脚正常插入U盘后INT应该会拉低产生一个下降沿。如果INT一直保持高电平说明芯片没能识别到U盘直接往前翻查前面几步。5.2 问题二DiskMount挂载失败挂载失败返回的错误码通常是ERR_DISK_MOUNT或者类似的宏定义值排查的核心是区分“物理层问题”还是“逻辑层问题”。物理层问题最常见的坑是供电不足。有些U盘在读写时峰值电流能达到100~200mA如果USB座的VBUS滤波电容不够大或者走线太细电压会被拉低导致U盘内部主控掉电复位。解决办法是在VBUS和GND之间加一个100uF以上的电解电容并且尽量缩短USB座到电容之间的走线。逻辑层问题主要是U盘格式不兼容。前面提到过exFAT格式或者未格式化分区会导致挂载失败。排查时可以把U盘插到电脑上右键查看属性确认文件系统是FAT32。另外某些U盘出厂带有一个隐藏的软件分区比如用于存厂家工具也会干扰CH376的识别。彻底的办法是换一个普通的品牌U盘做交叉测试。5.3 问题三写文件时间过长或数据错误写入耗时异常的根源在CH376的缓冲区策略。CH376内部有缓冲区CH376FileWrite写入的数据会先暂存在缓冲区里只有缓冲区满了或者显式关闭文件时才会批量写入U盘。如果你的数据是间断写入的比如每秒钟才写几百字节那么U盘处于“频繁等待-批量写入”的状态单次写入的响应时间会很长这是芯片的正常机制不是故障。数据错误的问题则多半出在SPI时序。CH376对SPI时钟的边沿是敏感的如果MCU主频很高硬件SPI的时钟频率设置过高可能导致数据采样错误。我的经验是硬件SPI分频系数选16或32对应2.25MHz或1.125MHz在72MHz主频下宁可慢一点也要稳。模拟SPI反而很少出现数据错误因为它不依赖外设时序只要GPIO操作正确数据就是准的。另外一个容易被忽视的点是库文件里的缓冲区尺寸宏。CH375HF*.C文件里有一个宏定义比如MAX_PATH_LENGTH或者内部缓冲区大小如果你开启了长文件名支持但这个宏没有定义的足够大文件打开操作可能失败。建议在移植时把这个宏值设大一些比如256字节避免文件名稍长就报错。6. 量产经验与替代方案思考方案确定用CH376以后有几个点会影响量产稳定性这里也一并聊聊。一是U盘供电设计。量产板上USB座的VBUS不要直接从CH376的3.3V取电一定要从5V电源轨取电并且串一个500mA的PPTC自恢复保险丝防止劣质U盘短路烧板。同时在U盘电源引脚两端并联一个100uF和0.1uF电容分别滤低频和高频干扰。二是固件升级场景的扩展。CH376不仅能在U盘里建文件还能读任意文件这就让它成了固件升级的好帮手。量产固件只需要在启动时检测U盘里有没有UPDATE.BIN这个文件有就读取并写入STM32内部Flash写完后删除文件或者改个后缀名就能实现完全没有串口、没有下载器的现场升级。这个方案我至今还在用比OTA网络升级简单且可靠得多。三是如果产品需要频繁大量写文件比如连续记录几个小时的高频数据要考虑写入速度和U盘寿命。CH376单次写文件的理论吞吐量大概在几百KB/s因为底层是批量写一扇区512字节所以应用程序尽量攒够512字节再调用一次CH376FileWrite这样效率最高。不要一个字节一个字节写那样不仅慢还会频繁触发U盘内部垃圾回收加速Flash磨损。再聊聊替代方案给做选型的同学一个参照。如果项目已经用了带USB OTG的STM32型号比如F4系列、F7系列、H7系列并且团队里有USB协议栈经验比较丰富的人直接用STM32自带的USB Host库加FatFS也是可行的省一颗芯片的钱但代价是开发周期和调试难度会上一个台阶。如果项目数据量特别大需要高速传输CH376的速度可能不够看这时候可以考虑USB3300这种高速PHY芯片走USB HS模式但复杂度呈指数级上升。中间路线是直接上一颗带USB Host且跑RTOS的高性能MCU用成熟的开源USB栈适合量产规模大、需求多变的产品。最后说一句CH376这颗芯片虽然看起来“老”但它的稳定性和易用性是真的经历过市场验证的。我见过很多工程师一开始嫌弃它“不够高级”绕了一圈又回来了。在一个追求稳定交付的功能点上用成熟方案把效率拉满本身就是一种核心竞争力。希望这篇能把你的U盘读写功能稳稳落地少走我当年走过的弯路。本文还有配套的精品资源点击获取