📖 第 42 章：USB U盘(Host)实验（USB U-Disk (Host)）

42.1 FATFS 简介

FATFS = 通用 FAT 文件系统模块（Chan 出品，嵌入式圈最常用）。

• 支持 FAT12/FAT16/FAT32/exFAT；
• 平台无关（需要自己实现 disk_read/disk_write）；
• API：f_open / f_read / f_write / f_close / f_mount。

42.2 U 盘简介

U 盘是 USB Mass Storage Device：

• SCSI 命令 + Bulk 传输；
• 文件系统一般是 FAT32；
• 一般 4 GB ~ 1 TB。

42.3 硬件设计

USB OTG FS 引脚 PA11/PA12 接 USB 母口。

42.4 程序设计

42.4.1 CubeMX 配置

• USB_OTG_FS → Mode = Host Only, Activate VBUS
• USB_HOST → Class = Mass Storage Host, Activate FATFS
• Middleware → USB_HOST + FATFS（Code Generation → Platform Settings → 下拉选 Key/LCD）

42.4.2 关键代码

FATFS fs;
FIL f;
UINT br;

// 挂载
f_mount(&fs, "0:", 1);

// 读文件
f_open(&f, "0:/test.txt", FA_READ);
f_read(&f, buf, sizeof(buf), &br);
f_close(&f);

// 写文件
f_open(&f, "0:/log.txt", FA_WRITE | FA_OPEN_ALWAYS);
f_write(&f, "Hello\n", 6, &bw);
f_close(&f);

42.5 下载验证

插入 U 盘 → 串口打印 f_mount 成功 → 读 test.txt 串口显示 → 写 log.txt → PC 上能看到新文件。