引言
搞过蓝牙音箱、U盘播放、TF卡音乐播放的朋友都知道，文件系统这块要是捋不顺，扫个盘卡半天，写个配置老出错，调试起来真是头大。最近在杰理AC696N开发板（包括同系列AC6966B开发板）上折腾了一波文件系统API，把扫描、读写、重命名这些常用操作过了一遍。下面整理成几个小点，希望对做杰理蓝牙音频系列芯片开发或嵌入式音频产品的弟兄们有点帮助。
一、文件扫描：记得跳过隐藏文件
扫盘函数dev_manager_scan_disk可以递归扫描指定路径下的所有文件，并通过回调函数处理每个文件项。
实际使用中可以设置跳过隐藏文件，避免把系统文件当歌曲或配置拉进来，省得用户懵圈。
二、文件名：短名 vs 长名
短名：15字节内，u8 格式，比较简单。
长名：Unicode 格式，需要先用在线工具转成对应编码再传进去。
注意：底层很多操作同时支持短名和长名，获取时用fget_name按需取就行。
三、文件打开与写入的几个坑
fopen 写模式 如果在文件中间插入数据，关闭前一定要 fseek 到文件末尾，否则后面内容可能被覆盖或乱掉。
fwrite 对齐 512字节对齐时写入速度最快。建议搞个缓存 Buffer，攒够 512 的整数倍再写，别一个字节一个字节写。
fseek 限制 这个 API 不允许向前偏移（即往文件头方向移动），只能往后跳。想往前只能重新打开文件。
四、高级功能，提效必备
文件重命名：frename，批量整理文件时好用。
获取文件名：fget_name，能取到长名或短名，看界面需要。
断点加速二次扫盘：利用第一次扫盘保存的断点信息，下次扫盘可以秒过，对大容量 TF 卡尤其友好。
创建隐藏文件夹：fmk_dir 配合属性设置，可以藏住系统目录，用户看不到也不容易误删。
总结
杰理这套文件系统 API 整体比较直接，掌握了扫描、命名、读写对齐、断点加速这几个关键点，基本能搞定 U 盘和 TF 卡上的音频文件管理。无论是在 AC696N 上做蓝牙音箱，还是其他杰理蓝牙音频方案，文件操作都是基础但重要的环节。建议先在板子上把每个 API 单独跑通，再组合到实际项目里，踩坑更少，效率更高。
审核编辑 黄宇
