引言

搞過藍(lán)牙音箱、U盤播放、TF卡音樂播放的朋友都知道，文件系統(tǒng)這塊要是捋不順，掃個(gè)盤卡半天，寫個(gè)配置老出錯(cuò)，調(diào)試起來真是頭大。最近在杰理AC696N開發(fā)板（包括同系列AC6966B開發(fā)板）上折騰了一波文件系統(tǒng)API，把掃描、讀寫、重命名這些常用操作過了一遍。下面整理成幾個(gè)小點(diǎn)，希望對做杰理藍(lán)牙音頻系列芯片開發(fā)或嵌入式音頻產(chǎn)品的弟兄們有點(diǎn)幫助。

一、文件掃描：記得跳過隱藏文件

掃盤函數(shù)dev_manager_scan_disk可以遞歸掃描指定路徑下的所有文件，并通過回調(diào)函數(shù)處理每個(gè)文件項(xiàng)。

實(shí)際使用中可以設(shè)置跳過隱藏文件，避免把系統(tǒng)文件當(dāng)歌曲或配置拉進(jìn)來，省得用戶懵圈。

二、文件名：短名 vs 長名

短名：15字節(jié)內(nèi)，u8 格式，比較簡單。

長名：Unicode 格式，需要先用在線工具轉(zhuǎn)成對應(yīng)編碼再傳進(jìn)去。

注意：底層很多操作同時(shí)支持短名和長名，獲取時(shí)用fget_name按需取就行。

三、文件打開與寫入的幾個(gè)坑

fopen 寫模式 如果在文件中間插入數(shù)據(jù)，關(guān)閉前一定要 fseek 到文件末尾，否則后面內(nèi)容可能被覆蓋或亂掉。

fwrite 對齊 512字節(jié)對齊時(shí)寫入速度最快。建議搞個(gè)緩存 Buffer，攢夠 512 的整數(shù)倍再寫，別一個(gè)字節(jié)一個(gè)字節(jié)寫。

fseek 限制 這個(gè) API 不允許向前偏移（即往文件頭方向移動(dòng)），只能往后跳。想往前只能重新打開文件。

四、高級功能，提效必備

文件重命名：frename，批量整理文件時(shí)好用。

獲取文件名：fget_name，能取到長名或短名，看界面需要。

斷點(diǎn)加速二次掃盤：利用第一次掃盤保存的斷點(diǎn)信息，下次掃盤可以秒過，對大容量 TF 卡尤其友好。

創(chuàng)建隱藏文件夾：fmk_dir 配合屬性設(shè)置，可以藏住系統(tǒng)目錄，用戶看不到也不容易誤刪。

總結(jié)

杰理這套文件系統(tǒng) API 整體比較直接，掌握了掃描、命名、讀寫對齊、斷點(diǎn)加速這幾個(gè)關(guān)鍵點(diǎn)，基本能搞定 U 盤和 TF 卡上的音頻文件管理。無論是在 AC696N 上做藍(lán)牙音箱，還是其他杰理藍(lán)牙音頻方案，文件操作都是基礎(chǔ)但重要的環(huán)節(jié)。建議先在板子上把每個(gè) API 單獨(dú)跑通，再組合到實(shí)際項(xiàng)目里，踩坑更少，效率更高。

審核編輯 黃宇