簡介針對Airoha洛達AB1568藍牙耳機芯片的應(yīng)用開發(fā)資料面向固件工程師與進階學(xué)習(xí)者系統(tǒng)梳理耳機工程的啟動與功能實現(xiàn)路徑。內(nèi)容從設(shè)備上電后的初始化、宏定義與編譯配置文件入手延伸到應(yīng)用活動行為管理、主動降噪模式切換、呼吸燈樣式修改、充電參數(shù)監(jiān)測、超時機制、事件發(fā)送接收與刪除、自動關(guān)機、配對時間、開機電量提示、清除配對記錄和鏈路重連等常用模塊并補充接口函數(shù)參考、回調(diào)注冊、界面框架、側(cè)音、音頻路徑、射頻測試、硬件復(fù)位、均衡設(shè)定和通話降噪等專題便于建立從底層到應(yīng)用層的完整開發(fā)脈絡(luò)。壓縮包內(nèi)含一個PDF文件約9.58MB章節(jié)按知識點編排適合按模塊檢索和對照代碼查閱可作為開發(fā)手冊與排錯參考。已有374人學(xué)習(xí)能輔助快速定位關(guān)鍵流程與接口用法。1. 一條事件總線撐起整只耳機為什么主循環(huán)里找不到業(yè)務(wù)代碼很多人第一次翻藍牙耳機固件會下意識去找while(1)里堆業(yè)務(wù)邏輯的地方結(jié)果發(fā)現(xiàn)主循環(huán)幾乎是空的。AB1568 這類音頻平臺的真實骨架是「活動堆 事件總線」上電后先跑 bootloader再進 apps 工程的 main隨后apps_inits把一堆活動掛到堆上。按鍵、定時器、協(xié)議?；卣{(diào)都只做一件事——往總線扔事件由當(dāng)前活動決定誰接。搞不清這條鏈調(diào) ANC 切換就會卡在「三連擊有提示音、降噪?yún)s沒變化」這種玄學(xué)問題上翻遍按鍵配置也找不到根因。這篇就從 bootloader 的第一條指令一路拆到濾波器參數(shù)真正生效的那一刻。2. 從上電到跑起來bootloader、main和mk宏到底誰先誰后2.1 上電后先跑的不是你的應(yīng)用代碼芯片復(fù)位后取指地址先落到 bootloader 的 main而不是 apps 下 earbuds 或 headset 工程的 main。bootloader 這一段只做最小初始化時鐘、看門狗、調(diào)試串口保證后面能打 log。真正關(guān)鍵的是升級分支——FOTA 處理函數(shù)被一個條件編譯宏包著宏沒開這段邏輯在預(yù)處理階段就被剔掉鏈接出來的 bin 里根本沒有它。// bootloader 的 main 骨架示意非逐行還原 int main(void) { bsp_early_init(); // 時鐘、看門狗、調(diào)試串口先保證能打 log #ifdef BL_FOTA_ENABLE bl_fota_process(); // 只有宏開了這段才會被編進來 #endif app_main_entry(); // 跳板進 apps 下對應(yīng)工程的 main for (;;) { } return 0; }bsp_early_init是后續(xù)所有 log 能出來的前提調(diào)不出來先查串口引腳和波特率。BL_FOTA_ENABLE決定bl_fota_process是否成為被編譯的代碼這是「宏不生效」類問題的第一層根因。app_main_entry只是個跳板真正的業(yè)務(wù)初始化在 apps 工程的 main 里。理解這一點后面看啟動 log 就不會把 bootloader 和 apps 的打印混在一起。2.2 宏定義藏在哪個mk文件./build.sh list的用法代碼里看到的宏不是隨便哪個 mk 文件里寫了就生效它取決于編譯命令實際調(diào)用了哪個 mk。第一步永遠是先列出來別憑記憶猜。用./build.sh list能看到每個工程對應(yīng)的板級目錄和 mk 文件當(dāng)前頭戴耳機工程基于某 1568 評估板開發(fā)走的是 headset 參考設(shè)計工程編譯時調(diào)feature_68_evk.mk。# 列出所有可編譯工程以及它們各自調(diào)用的 mk ./build.sh list # 輸出里會看到類似映射不同 SDK 版本命名略有差異 # headset_ref_design - 某1568評估板 - feature_68_evk.mk打開feature_68_evk.mk能看到一串CFLAGS -D...形式的宏開關(guān)ANC 使能、通話降噪、bootloader 的 FOTA 都在這里。新增宏也加在這個文件里不要在 .c 里隨手#define——換工程或換板子時隨手寫的宏不會跟著走這是血淚經(jīng)驗里最常見的一類翻車。# feature_68_evk.mk 片段示意 CFLAGS -DANC_ENABLE # ANC 總開關(guān) CFLAGS -DBL_FOTA_ENABLE # bootloader 的 FOTA 處理 CFLAGS -DENC_ENABLE # 通話降噪判斷一個宏到底有沒有生效不用讀代碼直接看編譯產(chǎn)物里的預(yù)處理結(jié)果或者運行時 log 里對應(yīng)的分支有沒有被打出來。宏改了行為沒變九成是改錯了 mk或者 build.sh list 里當(dāng)前工程壓根沒指向你以為的那個文件。2.3 apps_inits與主進程開機后初始化了什么進到 apps 工程 main 后apps_inits負責(zé)把各個應(yīng)用模塊拉起來其中就包括所有活動行為的初始化。每個活動通過ui_shell_start_activity在活動堆里申請一個空閑 item相當(dāng)于給這個「界面」占個位。app_preproc_activity_proc是主進程負責(zé)管理和調(diào)配子進程比如app_home_screen_idle_activity_proc這類子 UI 界面。開機后會同時存在很多進程每個進程自帶事件組。系統(tǒng)產(chǎn)生一個事件就往外拋所有進程都能監(jiān)聽到只有事件組對得上的那個進程才處理。這解釋了為什么主循環(huán)是空的業(yè)務(wù)不在循環(huán)里順序跑而是被事件推著走?；顒佣牙锿粫r刻只有一個當(dāng)前活動它決定了這條事件先給誰看。把這一層想通后面 ANC 按鍵為什么進_proc_key_event_group、為什么最后落到app_home_screen_process_anc_and_pass_through就都是順理成章的事。3. UI Shell事件總線活動堆憑什么決定這條事件歸誰處理3.1 ui_shell_start_activity申請活動item活動堆不是普通數(shù)組它維護的是「當(dāng)前活動」和「可被喚醒的活動」兩類狀態(tài)。ui_shell_start_activity在堆里找一個空閑 item把活動 ID、事件處理回調(diào)、活動私有數(shù)據(jù)填進去然后掛到活動表上。每個活動類似手機里的一個頁面home screen 空閑態(tài)是一個活動設(shè)置頁是另一個通話中又是另一個。這里有個容易忽略的點活動不是越早注冊越好注冊順序影響事件分發(fā)時的遍歷順序。常見實現(xiàn)思路是按活動優(yōu)先級排序當(dāng)前活動排最前其余按狀態(tài)掛起。如果兩個活動都對同一個事件 ID 感興趣先被遍歷到的先處理處理完是否繼續(xù)往下傳由返回值決定。調(diào) UI 行為時如果發(fā)現(xiàn)事件被「截胡」先查活動注冊順序和事件組的匹配關(guān)系而不是懷疑事件沒發(fā)出去。3.2 事件的發(fā)送、接收與刪除三件套怎么配合事件的生命周期就三件事發(fā)、收、刪。發(fā)用ui_shell_send_event收靠ui_shell_init_input_msg注冊的輸入消息處理刪用ui_shell_remove_event把還在隊列里沒來得及處理的事件摘掉。三者配合不好最常見的就是事件重復(fù)處理或者內(nèi)存越界。// 發(fā)送一個自定義事件示意 bool ok ui_shell_send_event( false, // 是否立即發(fā)送false 走隊列 EVENT_PRIORITY_HIGH, // 優(yōu)先級高優(yōu)先級先出隊 EVENT_GROUP_APP, // 事件組決定哪些活動能收到 MY_CUSTOM_EVENT_ID, // 事件 ID payload, // 攜帶數(shù)據(jù)指針 sizeof(payload), // 數(shù)據(jù)長度 0, // 延時發(fā)送毫秒數(shù) 500 // 超時毫秒數(shù)超時后事件被丟棄 );payload是棧上變量時false走隊列就有生命周期風(fēng)險——事件還在隊列里函數(shù)已經(jīng)返回指針懸空。穩(wěn)妥做法是傳堆上拷貝或者用值傳遞。EVENT_GROUP_APP要和接收方注冊的事件組一致組不對事件發(fā)出去也沒人接。500這個超時值不是隨便填的它決定這條事件在隊列里最多等多久超時后被靜默丟棄log 里往往只有一行不起眼的丟棄記錄。ui_shell_remove_event適合在活動切走時清理未處理事件避免舊頁面的回調(diào)打到新頁面的數(shù)據(jù)上。3.3 超時、自動關(guān)機與配對時間的調(diào)度超時時間設(shè)置、自動關(guān)機配置、配對時間窗口本質(zhì)都是同一個機制的不同參數(shù)化往事件總線注冊一個定時事件到點觸發(fā)觸發(fā)后看當(dāng)前狀態(tài)決定執(zhí)行什么。自動關(guān)機通常是「無連接 無按鍵 超時」三個條件同時滿足才觸發(fā)配對時間窗口則是「進入配對態(tài)后啟動一個倒計時超時自動退出」。調(diào)這類參數(shù)時不要只改一個數(shù)字就完事。配對時間改短了用戶可能還沒連上窗口就關(guān)了自動關(guān)機改長了待機功耗壓不住。常見的實現(xiàn)思路是把這些時間做成 NVKEY 或配置表里的字段運行時讀出來再用而不是硬編碼在 .c 里。這樣產(chǎn)測和不同客戶版本可以用同一套代碼、不同的配置。改完參數(shù)記得確認寫進了哪一層是編譯期宏、運行時 NVKEY還是 Config Tool 里的 UI 項三層混了就是典型踩坑。4. ANC切換鏈路從按鍵key_action到濾波器參數(shù)生效中間隔了幾層4.1 按鍵事件進入_proc_key_event_group物理按鍵按下先產(chǎn)生的是按鍵事件進_proc_key_event_group處理。這里做的第一件事是把「哪個鍵、什么手勢」翻譯成key_action枚舉。ANC 相關(guān)的四個典型值KEY_PASS_THROUGH是通透模式開關(guān)KEY_ANC是 ANC 開關(guān)KEY_SWITCH_ANC_AND_PASSTHROUGH是全關(guān)到通透再到 ANC 的循環(huán)KEY_BETWEEN_ANC_PASSTHROUGH是通透和 ANC 之間來回切。物理按鍵到key_action的映射不寫在按鍵處理函數(shù)里而在customerized_key_config.c這張表里。改按鍵行為先改這張表別去動_proc_key_event_group的分發(fā)邏輯。// customerized_key_config.c 里的按鍵映射示意 static const key_config_t key_table[] { { KEY_POWER, KEY_TRIPLE_CLICK, KEY_SWITCH_ANC_AND_PASSTHROUGH }, { KEY_POWER, KEY_DOUBLE_CLICK, KEY_PASS_THROUGH }, { KEY_POWER, KEY_LONG_PRESS, KEY_ANC }, };表里第一列是物理鍵第二列是手勢第三列是行為。三連擊 Power 映射到循環(huán)切換就意味著每按三次觸發(fā)一次 ANC 狀態(tài)機往前走一步。這張表改錯表現(xiàn)就是「按鍵有提示音但模式不切」因為提示音在按鍵事件層就響了跟 ANC 服務(wù)是否被調(diào)用是兩回事。4.2 target_anc_type與app_anc_service_enable狀態(tài)機怎么往下走KEY_SWITCH_ANC_AND_PASSTHROUGH被識別后處理函數(shù)做兩件事把target_anc_type推到下一個狀態(tài)把target_filter_id換成對應(yīng)的濾波器 ID然后一起傳給app_anc_service_enable。所有 ANC 事件行為最終都匯到這個函數(shù)它是 ANC 服務(wù)的統(tǒng)一入口。// 按鍵行為到 ANC 服務(wù)調(diào)用的鏈路示意 case KEY_SWITCH_ANC_AND_PASSTHROUGH: target_anc_type next_anc_type(target_anc_type); // 全關(guān) - 通透 - ANC 循環(huán) target_filter_id anc_type_to_filter(target_anc_type); app_anc_service_enable(target_anc_type, target_filter_id); break;target_anc_type是模式枚舉target_filter_id是濾波器編號。ANC 默認濾波器AUDIO_ANC_CONTROL_ANC_FILTER_DEFAULT值為 1PassThrough 默認濾波器AUDIO_ANC_CONTROL_PASS_THRU_FILTER_DEFAULT值為 9。切換時 log 里能看到anc_result循環(huán)打出三個模式過濾這個字段就能確認狀態(tài)機有沒有走對。如果 log 顯示狀態(tài)在變、聽感沒變問題就不在這層往下查濾波器參數(shù)。4.3 NVKEY濾波器參數(shù)與NVR解析0xE1E5到底怎么讀聲學(xué)調(diào)好的 ANC 參數(shù)不在代碼里在 Config Tool 的 NVR 文件里。四組濾波器 Filter 1 到 Filter 4每組包含 FF前饋、FB反饋、FBC反饋補償左右聲道。把 NVR 導(dǎo)入工程或直接在 Tool 上調(diào)整Write NV 后 Reset參數(shù)才真正寫進耳機。這一步?jīng)]做前面按鍵切得再對降噪也不會有變化——這是「三連擊有提示音沒效果」最經(jīng)典的根因。NVR 里的數(shù)值是高字節(jié)在前、低字節(jié)在后解析時要先反轉(zhuǎn)。比如0xE1E5 10FF 1400 D8DC D8DC10FF反轉(zhuǎn)成FF10十進制 65296減 65536 得 -240對應(yīng) Component Gain 的 -2.4dB1400反轉(zhuǎn)成0014十進制 20對應(yīng) 0.2dB。// NVR 里 Component Gain 的解析示意 int16_t parse_component_gain(uint16_t raw) { uint16_t swapped (uint16_t)((raw 8) | (raw 8)); // 前后位反轉(zhuǎn) if (swapped 0x8000) { // 最高位為 1 表示負數(shù) return (int16_t)(swapped - 65536); } return (int16_t)swapped; }這個函數(shù)只做反轉(zhuǎn)和補碼還原不負責(zé)單位換算。-240是 Tool 里的內(nèi)部單位對應(yīng) -2.4dB別直接把 -240 當(dāng) dB 用。NVKEY 里 ANC 相關(guān)參數(shù)的 KeyID 段是0xEE00~0xEEFF在nvkey.xml里可能原本沒有這一段需要手動補。補的時候要對齊 XML 和 bin 兩個產(chǎn)物只改一個編譯出來的 download 文件里參數(shù)還是舊的。5. 常見問題與排查ANC沒效果、宏不生效、NVKEY寫不進去5.1 現(xiàn)象三連擊有提示音但降噪沒變化現(xiàn)象很直觀按鍵提示音響了log 里anc_result也在循環(huán)打但耳朵聽不出降噪差異。原因通常不在按鍵鏈路而在 NVKEY 里的 ANC 參數(shù)是空的或者只寫了默認值。Config Tool 打開工程的 download 文件夾看 ANC 模式里有沒有實際調(diào)過的參數(shù)沒有就是沒導(dǎo)入 NVR。解決分兩步先用 Config Tool 導(dǎo)入聲學(xué)調(diào)好的 NVR 文件Write NV 后 Reset如果要固化到代碼還要走 Special_Export 把變更導(dǎo)出來更新nvkey.xml和filesystem.bin然后 clean 后重新 build。少任何一步download 文件里的參數(shù)都不會變。5.2 現(xiàn)象改了宏但編譯行為沒變改了feature_68_evk.mk里的宏重新編譯運行時行為跟沒改一樣。原因有兩個一是當(dāng)前編譯的工程根本沒調(diào)這個 mk./build.sh list一看就露餡二是改了 mk 但沒 clean增量編譯復(fù)用了舊的目標(biāo)文件。先 list 確認工程和 mk 的映射關(guān)系再 clean 后全量 build。判斷宏有沒有生效不用讀代碼看預(yù)處理產(chǎn)物里對應(yīng)的#ifdef分支有沒有被展開或者運行時 log 里那個分支的打印有沒有出現(xiàn)。這兩步都過了還不對才去懷疑宏本身寫錯。5.3 現(xiàn)象Config Tool導(dǎo)入NVR后參數(shù)還是舊值導(dǎo)入 NVR、Write NV、Reset 都做了Config Tool 里看參數(shù)是新的但耳機行為還是舊的。原因是參數(shù)只寫進了耳機沒寫進工程的 download 文件下次編譯又把舊的 download 燒回去了。要把參數(shù)固化到代碼必須走 Special_Export 導(dǎo)出變更生成的文件里syskey.xml和bin要更新到工程對應(yīng)的nvkey.xml和filesystem.bin。syskey.xml里有的 KeyID 在nvkey.xml里不一定有沒有的要手動添加有的要替換。只改 XML 不改 bin或者只改 bin 不改 XML編譯出來的 download 都是半新半舊。5.4 現(xiàn)象FOTA后NVKEY回退FOTA 升級完成耳機重啟之前調(diào)好的 ANC 參數(shù)回到默認值。原因是 FOTA 更新固件時沒有把 NVKEY 的變更一起帶過去新固件里的默認 NVKEY 覆蓋了舊值。解決思路是把 NVKEY 變更做成升級包的一部分或者升級后由NVKEY_Setting.c里的寫入函數(shù)重新寫一遍。FOTA 和 NVDM 的配合要提前驗證升級前記錄關(guān)鍵 KeyID 的值升級后讀出來比對不一致就說明 NVKEY 沒跟過去。這個坑在量產(chǎn)后才暴露出來代價很大產(chǎn)測階段就要把 FOTA 前后 NVKEY 一致性加進檢查項。6. 設(shè)計取舍事件驅(qū)動與參數(shù)固化為什么選這條難走的路事件驅(qū)動不是唯一解。輪詢也能實現(xiàn)按鍵掃描和狀態(tài)切換代碼寫起來更直白調(diào)試時打個斷點就能看到調(diào)用棧。但耳機這種多狀態(tài)、多回調(diào)、低功耗的場景輪詢的空轉(zhuǎn)功耗和狀態(tài)耦合會迅速失控。事件總線的代價是調(diào)用鏈變長一個按鍵按下要經(jīng)過按鍵組、活動分發(fā)、服務(wù)層好幾跳出問題時 log 是唯一的黑匣子。這套設(shè)計換來的是活動之間解耦home screen 不需要知道 ANC 服務(wù)怎么實現(xiàn)ANC 服務(wù)也不需要知道當(dāng)前是哪個界面觸發(fā)的大家只認事件 ID。代價和收益擺在一起事件驅(qū)動在耳機固件這個約束下是更劃算的選擇。參數(shù)固化走 XML bin Special_Export 這條路看起來比直接改代碼麻煩但它是為量產(chǎn)服務(wù)的。聲學(xué)工程師在 Config Tool 里調(diào)參數(shù)不碰代碼固件工程師維護nvkey.xml的 KeyID 結(jié)構(gòu)產(chǎn)測程序拿 XML 和 bin 去燒錄。三方各管一層參數(shù)變更不需要重新理解代碼邏輯。這條鏈的脆弱點在于「同步」Tool 里的參數(shù)、XML、bin、耳機里的 NVKEY四處任何一處對不上表現(xiàn)都是「看起來改了但沒生效」。所以每次改完參數(shù)我都會按固定順序走一遍——Tool 導(dǎo)入 NVR、Write NV、Reset 驗證聽感、Special_Export 導(dǎo)出、更新 XML 和 bin、clean 后 build、再燒錄驗證。從那以后我每次動 ANC 參數(shù)都強制走完這套流程不再相信「這次應(yīng)該只改了一個值」的直覺。希望幫到你。本文還有配套的精品資源點擊獲取