搞嵌入式這幾年只要項(xiàng)目里同時(shí)出現(xiàn)“BLE”和“RTOS”這兩個(gè)詞基本就告別“打開CubeMX生成代碼直接跑”的省心模式了。尤其當(dāng)你拿到的芯片是STM32WB55RG這顆雙核MCU時(shí)很多人第一反應(yīng)是“這不就是帶BLE的STM32嘛”結(jié)果一動(dòng)手就發(fā)現(xiàn)事情遠(yuǎn)沒(méi)有這么簡(jiǎn)單——因?yàn)樗腂LE協(xié)議棧根本不在你寫應(yīng)用代碼的那個(gè)核上跑。這個(gè)標(biāo)題問(wèn)的是“如何在已有工程里把BLE集成到FreeRTOS中”但我實(shí)際做下來(lái)真正卡的往往不是“怎么調(diào)用BLE API”而是“BLE協(xié)議棧和FreeRTOS到底誰(shuí)聽誰(shuí)的”。這枚芯片是Cortex-M4主核 Cortex-M0射頻核的雙核架構(gòu)你的FreeRTOS跑在M4上BLE協(xié)議棧跑在M0上兩邊通過(guò)共享內(nèi)存和核間通信機(jī)制配合。所以整個(gè)集成過(guò)程本質(zhì)是在解決“兩個(gè)核之間怎么高效、安全地傳遞事件和命令”的問(wèn)題。這篇文章我就拿一個(gè)真實(shí)的工程改造過(guò)程來(lái)講從架構(gòu)認(rèn)知、CubeMX配置、協(xié)議棧初始化到任務(wù)劃分、事件回調(diào)處理、常見坑排查把一條能直接復(fù)用的集成路徑完整走一遍。不管你是第一次在STM32WB上碰BLE還是已經(jīng)在M4核上調(diào)過(guò)FreeRTOS但沒(méi)搞過(guò)雙核協(xié)作這篇文章都能給你省下不少折騰時(shí)間。1. 先吃透STM32WB55RG的雙核架構(gòu)再談集成1.1 為什么說(shuō)“雙核”是理解整個(gè)集成的鑰匙很多從單核MCU比如STM32F103、STM32F407遷移過(guò)來(lái)的朋友第一個(gè)不適應(yīng)的點(diǎn)就是以前一個(gè)核既跑邏輯又跑通信頂多是中斷優(yōu)先級(jí)分一分到了STM32WB55RG這里芯片里有兩個(gè)完全獨(dú)立的Cortex核心職責(zé)被強(qiáng)行拆開了。Cortex-M4內(nèi)核最高主頻64MHz負(fù)責(zé)跑你的應(yīng)用邏輯、FreeRTOS調(diào)度、外設(shè)驅(qū)動(dòng)、算法以及所有跟“業(yè)務(wù)”相關(guān)的事情。Cortex-M0內(nèi)核最高主頻32MHz專門跑藍(lán)牙協(xié)議棧和802.15.4協(xié)議棧這顆芯片同時(shí)支持BLE和Zigbee/Thread以及射頻相關(guān)的底層調(diào)度。這個(gè)分工帶來(lái)的好處很明顯BLE協(xié)議棧的時(shí)序要求極高尤其是廣播間隔、連接事件、加密握手這些實(shí)時(shí)性很強(qiáng)的操作如果和你的業(yè)務(wù)代碼搶占同一個(gè)CPU很容易出問(wèn)題?，F(xiàn)在單獨(dú)劃一個(gè)核來(lái)跑協(xié)議棧應(yīng)用核這邊怎么卡頓、怎么調(diào)度都不會(huì)直接影響射頻時(shí)序。但代價(jià)就是——應(yīng)用核和射頻核之間必須有一套高效的通信機(jī)制。這套機(jī)制在STM32WB上叫IPCCInter-Processor Communication Controller核間通信控制器配合硬件信號(hào)量HSEMHardware Semaphore來(lái)管理共享資源的訪問(wèn)。M4核向M0核發(fā)命令、M0核向M4核發(fā)事件都是走這個(gè)通道。提示IPCC不是一個(gè)“可選項(xiàng)”而是BLE在STM32WB上跑起來(lái)的基礎(chǔ)設(shè)施。如果它沒(méi)配好你調(diào)用BLE API時(shí)可能卡死、可能返回錯(cuò)誤甚至直接HardFault。所以集成FreeRTOS前先接受“雙核協(xié)作”這個(gè)前提后面很多奇怪的Bug都能從這條主線上找到原因。1.2 FreeRTOS在該項(xiàng)目中扮演的真實(shí)角色回到標(biāo)題的問(wèn)題FreeRTOS在這個(gè)項(xiàng)目里到底負(fù)責(zé)什么用一句話概括——它負(fù)責(zé)讓M4核上的所有“非BLE協(xié)議?！钡氖虑樽兊糜行颉＞唧w來(lái)說(shuō)主要管三件事任務(wù)調(diào)度你的業(yè)務(wù)邏輯拆成多個(gè)任務(wù)比如按鍵掃描任務(wù)、傳感器采集任務(wù)、數(shù)據(jù)處理任務(wù)、顯示刷新任務(wù)由FreeRTOS統(tǒng)一調(diào)度。資源同步多個(gè)任務(wù)之間共享數(shù)據(jù)緩沖區(qū)需要互斥鎖Mutex防止競(jìng)爭(zhēng)一個(gè)任務(wù)等待另一個(gè)任務(wù)的數(shù)據(jù)需要隊(duì)列Queue或信號(hào)量Semaphore來(lái)通信。與BLE事件對(duì)接M0核通過(guò)IPCC把BLE事件連接建立、斷開、收到數(shù)據(jù)、廣播完成等拋給M4核M4核這邊需要一個(gè)事件處理任務(wù)來(lái)響應(yīng)。這個(gè)任務(wù)由FreeRTOS管理事件到來(lái)時(shí)喚醒它事件處理完它就睡下不占用CPU。而CMSIS-RTOS2在這里的作用就比較特殊了——它不是一套“新的操作系統(tǒng)”而是一個(gè)統(tǒng)一的操作系統(tǒng)抽象層。你寫的代碼調(diào)用的是osThreadNew、osMessageQueuePut這類API底層具體是FreeRTOS還是別的RTOS實(shí)現(xiàn)由CMSIS-RTOS2適配層去翻譯。換句話說(shuō)你打開CubeMX生成代碼時(shí)選中的“FreeRTOS CMSIS-RTOS2”這個(gè)選項(xiàng)本質(zhì)上就是幫你在FreeRTOS之上套了一層標(biāo)準(zhǔn)接口。為什么要多套這一層因?yàn)镾TM32的BLE中間件ST官方提供的無(wú)線協(xié)議棧接口代碼內(nèi)部就是基于CMSIS-RTOS2寫的。它需要?jiǎng)?chuàng)建線程、需要掛起/恢復(fù)調(diào)度器、需要獲取當(dāng)前tick計(jì)數(shù)。如果直接用原生FreeRTOS API中間件的代碼就得跟FreeRTOS強(qiáng)耦合以后ST想支持其他RTOS就麻煩了。所以你先接受這套“間接層”后面看ble_hl、tl_if這些模塊的源碼時(shí)就不會(huì)覺得它們寫得繞了。1.3 已有工程集成前需要先做的三個(gè)判斷標(biāo)題特別強(qiáng)調(diào)了“in an Existing Project”也就是說(shuō)很多人的場(chǎng)景不是從零新建工程而是手里已經(jīng)有一個(gè)在跑的FreeRTOS工程現(xiàn)在想把BLE加進(jìn)去。這種場(chǎng)景下我建議你先做三個(gè)判斷能省掉后面一大半的返工第一工程里的時(shí)鐘樹和CubeMX配置是否保留了默認(rèn)的HSE/HSI分配。STM32WB的M4核和M0核共用一個(gè)時(shí)鐘源但各自的分頻獨(dú)立。如果你的工程是手工改過(guò)時(shí)鐘樹的老工程而射頻核那邊跑在錯(cuò)誤的時(shí)鐘頻率上最典型的癥狀是BLE能初始化但搜不到設(shè)備或者廣播信號(hào)極弱。第二是否已經(jīng)能把M0核的固件燒進(jìn)去。STM32WB的射頻核有自己的獨(dú)立Firmware需要單獨(dú)燒錄。很多人拿到開發(fā)板M4核程序下載進(jìn)去了但M0核還是白片結(jié)果BLE初始化永遠(yuǎn)卡在等待固件響應(yīng)這一步。這一點(diǎn)在“已有工程”里特別容易被忽略——因?yàn)槟阒芭艿煤煤玫氖羌僃reeRTOS工程根本不涉及射頻核。第三你是否清楚原有工程的中斷優(yōu)先級(jí)配置。FreeRTOS對(duì)中斷優(yōu)先級(jí)分組有硬性要求而BLE中間件對(duì)IPCC中斷優(yōu)先級(jí)也有要求。如果原來(lái)的工程為了某個(gè)裸機(jī)外設(shè)把中斷優(yōu)先級(jí)分組設(shè)置得很隨意那接下來(lái)在后續(xù)章節(jié)里你會(huì)看到這個(gè)配置會(huì)如何深刻影響B(tài)LE和FreeRTOS的共存。2. 集成前的環(huán)境準(zhǔn)備與工程配置要點(diǎn)2.1 芯片型號(hào)與射頻核固件版本匹配問(wèn)題先單獨(dú)說(shuō)說(shuō)“軟硬件版本匹配”這件事因?yàn)檫@個(gè)坑我見過(guò)太多人踩了。STM32WB55RG這顆料屬于STM32WB55系列內(nèi)置1MB Flash、256KB SRAMBLE 5.0和802.15.4雙模。它的射頻核固件分兩類FUS固件Firmware Upgrade Services負(fù)責(zé)管理射頻核固件的升級(jí)和安全服務(wù)相當(dāng)于射頻核的“Bootloader”。協(xié)議棧固件比如stm32wb5x_BLE_Stack_full_fw.bin真正的BLE協(xié)議棧二進(jìn)制由FUS負(fù)責(zé)加載到M0核里運(yùn)行。FUS和協(xié)議棧固件的版本必須匹配。我遇到過(guò)一種情況開發(fā)板出廠FUS是較老版本我拿最新的CubeMX生成工程里面帶的協(xié)議棧固件要求新版本FUS支持結(jié)果燒錄后BLE初始化一直超時(shí)。最后查了一圈不是代碼問(wèn)題是固件版本匹配問(wèn)題。所以準(zhǔn)備工作里我強(qiáng)烈建議你使用STM32CubeProgrammer先讀一下芯片里現(xiàn)有FUS和協(xié)議棧固件的版本然后打開CubeMX生成工程時(shí)注意看中間件版本和射頻核固件包版本是否一致。如果你在生成代碼時(shí)選擇了“STM32WB55RG”并勾選了BLECubeMX會(huì)自動(dòng)把匹配的無(wú)線協(xié)議棧固件列出來(lái)這時(shí)你只需要用CubeProgrammer把它燒到射頻核即可不需要手動(dòng)找版本對(duì)應(yīng)關(guān)系。2.2 CubeMX工程配置的逐項(xiàng)解讀現(xiàn)在到關(guān)鍵一部分CubeMX里的具體配置。我不準(zhǔn)備把所有選項(xiàng)都列一遍那就成操作手冊(cè)了。我只挑幾個(gè)直接影響“BLEFreeRTOS能否正常集成”的選項(xiàng)說(shuō)說(shuō)它們背后是什么邏輯。時(shí)鐘配置STM32WB55RG的RF核要求射頻時(shí)鐘非常精確。標(biāo)準(zhǔn)做法是使用外部高速晶振HSE通常為32MHzM4核跑到64MHzM0核跑到32MHz。如果你用內(nèi)部HSI頻率精度雖然也能跑但藍(lán)牙射頻指標(biāo)會(huì)明顯變差實(shí)測(cè)廣播距離會(huì)縮短。所以建議硬件上保留HSE晶振位置軟件里確認(rèn)HSE被正確使能。RCC和電源配置STM32WB有專門的SMPS開關(guān)電源和LDO兩種供電模式。CubeMX里默認(rèn)的配置通常沒(méi)問(wèn)題但有一項(xiàng)要注意——RF核的喚醒源和低功耗配置不要隨便改動(dòng)。BLE本身有功耗管理如果SMPS配置不對(duì)可能導(dǎo)致射頻核無(wú)法正常進(jìn)入低功耗狀態(tài)繼而影響B(tài)LE連接事件調(diào)度。中間件配置在Middleware and Software Packs里勾選BLE后會(huì)有幾個(gè)子選項(xiàng)Task numberBLE中間件需要一個(gè)專用的FreeRTOS任務(wù)來(lái)處理協(xié)議棧事件。這個(gè)任務(wù)的數(shù)量通常填1到2就夠了CubeMX會(huì)根據(jù)你的配置自動(dòng)生成對(duì)應(yīng)的osThreadNew調(diào)用。最大連接數(shù)量、服務(wù)數(shù)量、屬性數(shù)量這些參數(shù)直接決定了BLE協(xié)議棧申請(qǐng)的內(nèi)存大小。如果你只是做一個(gè)單連接從機(jī)保持默認(rèn)即可如果做多連接Central就需要調(diào)大。GATT緩存和ATT MTU默認(rèn)256字節(jié)的MTU對(duì)于普通數(shù)據(jù)透?jìng)鲏蛴玫绻阋獋鞔髷?shù)據(jù)包建議提前規(guī)劃好。FreeRTOS配置啟用FreeRTOS并選擇CMSIS-RTOS2后在“Advanced settings”里有個(gè)USE_TIMERS、USE_COUNTING_SEMAPHORES等選項(xiàng)默認(rèn)勾選即可。真正需要關(guān)注的是TOTAL_HEAP_SIZE。BLE中間件本身會(huì)通過(guò)CMSIS-RTOS2動(dòng)態(tài)創(chuàng)建任務(wù)、隊(duì)列和互斥鎖而C庫(kù)的malloc在FreeRTOS里默認(rèn)不一定安全所以CubeMX生成的BLE代碼會(huì)使用RTOS Heap。如果你原本的工程Heap只有8KB加了BLE后一般不夠我建議直接給到16KB以上具體大小取決于你的任務(wù)數(shù)量和隊(duì)列深度。生成代碼后你打開main.c會(huì)看到CubeMX自動(dòng)做了兩件很重要的事一是初始化了IPCC和HSEM二是調(diào)用了MX_APPE_Init()或類似函數(shù)來(lái)啟動(dòng)BLE中間件。這說(shuō)明BLE的“骨架”已經(jīng)被搭好了剩下的任務(wù)是往這個(gè)骨架上填業(yè)務(wù)邏輯。2.3 FreeRTOS優(yōu)先級(jí)與BLE任務(wù)優(yōu)先級(jí)的取舍很多人在這個(gè)環(huán)節(jié)開始糾結(jié)BLE協(xié)議棧任務(wù)該設(shè)多高的優(yōu)先級(jí)我的業(yè)務(wù)任務(wù)該設(shè)多少這里給一個(gè)我自己反復(fù)驗(yàn)證過(guò)的參考基準(zhǔn)并解釋為什么這樣分配。STM32WB的BLE中間件在M4核上會(huì)創(chuàng)建幾個(gè)內(nèi)部任務(wù)比如管理協(xié)議棧事件的任務(wù)這些任務(wù)通過(guò)CMSIS-RTOS2接口創(chuàng)建。任務(wù)優(yōu)先級(jí)的高低直接影響的是“M0核拋上來(lái)的事件能被多快地處理”。如果你的BLE任務(wù)優(yōu)先級(jí)太低而業(yè)務(wù)任務(wù)里有大循環(huán)占著CPUBLE事件的響應(yīng)會(huì)被延遲嚴(yán)重時(shí)可能出現(xiàn)連接斷開或數(shù)據(jù)丟包。我常用的做法是把BLE相關(guān)任務(wù)優(yōu)先級(jí)設(shè)為“正常偏上”比如7~8業(yè)務(wù)中的耗時(shí)操作任務(wù)比如傳感器采集、圖片處理優(yōu)先級(jí)設(shè)為正常5~6UI或按鍵這種非實(shí)時(shí)任務(wù)設(shè)為較低3~4。同時(shí)要注意FreeRTOS中configMAX_PRIORITIES默認(rèn)是56CMSIS-RTOS2里也有對(duì)應(yīng)的配置把優(yōu)先級(jí)數(shù)值設(shè)成個(gè)位數(shù)就好不用把它撐滿。核心思想是BLE事件不必達(dá)到中斷級(jí)響應(yīng)但要保證它在絕大多數(shù)情況下都能在幾個(gè)毫秒內(nèi)被取走。注意不要試圖把BLE相關(guān)任務(wù)設(shè)成最高優(yōu)先級(jí)來(lái)“一勞永逸”。因?yàn)锽LE任務(wù)一旦持續(xù)占用CPU低優(yōu)先級(jí)任務(wù)會(huì)餓死反而導(dǎo)致看門狗超時(shí)或者業(yè)務(wù)邏輯卡住。好的做法是讓BLE任務(wù)做完一件事就掛起等待下一個(gè)事件把CPU讓出來(lái)。3. 核心細(xì)節(jié)解析BLE協(xié)議棧與FreeRTOS的協(xié)作機(jī)制3.1 從“事件驅(qū)動(dòng)”角度看FreeRTOS里的BLE任務(wù)如果你翻過(guò)ST提供的BLE示例代碼會(huì)發(fā)現(xiàn)主流程基本長(zhǎng)這樣void ble_app_task(void *argument) { /* 初始化BLE協(xié)議棧 */ BLE_Init(); /* 任務(wù)主循環(huán) */ for(;;) { /* 處理IPCC消息讓協(xié)議棧事件得到響應(yīng) */ Ble_Hci_Gap_Gatt_Listener(); /* 處理用戶隊(duì)列/信號(hào)量執(zhí)行實(shí)際業(yè)務(wù) */ ... } }這段代碼看起來(lái)像輪詢但背后其實(shí)是事件驅(qū)動(dòng)的Ble_Hci_Gap_Gatt_Listener()函數(shù)會(huì)檢查IPCC是否有新事件如果沒(méi)有任務(wù)可以進(jìn)入阻塞等待狀態(tài)直到被信號(hào)量或隊(duì)列喚醒。在CubeMX生成的FreeRTOS工程里這個(gè)等待動(dòng)作對(duì)應(yīng)一個(gè)osMessageQueueGet或osSemaphoreAcquire調(diào)用后任務(wù)會(huì)掛起不占CPU。關(guān)鍵點(diǎn)在于等待的“信號(hào)來(lái)源”是兩個(gè)核之間的中斷。當(dāng)M0核收到BLE事件比如手機(jī)連上了、手機(jī)發(fā)了數(shù)據(jù)過(guò)來(lái)它會(huì)通過(guò)IPCC產(chǎn)生一個(gè)中斷通知M4核M4核的中斷服務(wù)函數(shù)里再通過(guò)osSemaphoreRelease或osMessageQueuePut把事件交給BLE任務(wù)。這樣整個(gè)鏈條就是“射頻核硬件事件 → IPCC中斷 → RTOS信號(hào)量 → BLE任務(wù)被喚醒”清晰且高效。我第一次做這個(gè)集成時(shí)犯過(guò)一個(gè)錯(cuò)誤在M4核的IPCC中斷里放了很長(zhǎng)的處理邏輯導(dǎo)致BLE事件被處理得太慢連接事件錯(cuò)過(guò)最后被對(duì)端斷開。后來(lái)改成“中斷里只做信號(hào)量通知復(fù)雜處理全部丟給任務(wù)”問(wèn)題立刻消失了。這也是FreeRTOS項(xiàng)目里最常見的“中斷里干活太多”的教訓(xùn)。3.2 BLE協(xié)議?；卣{(diào)機(jī)制不要在回調(diào)里睡大覺BLE協(xié)議棧在M4核這邊通過(guò)“回調(diào)函數(shù)”把上層事件GAP事件、GATT事件告訴你的應(yīng)用代碼。最典型的是連接事件、斷開事件、數(shù)據(jù)讀寫事件。很多人第一次對(duì)接時(shí)會(huì)覺得自己寫的回調(diào)函數(shù)跑在協(xié)議棧任務(wù)里所以想在回調(diào)里做很多操作。這是個(gè)大坑。原因在于回調(diào)函數(shù)本質(zhì)上是在BLE協(xié)議棧任務(wù)的上下文里執(zhí)行的它占用的就是那個(gè)任務(wù)的時(shí)間片。如果你在回調(diào)里調(diào)用HAL_Delay(100)去等待某個(gè)外設(shè)或者調(diào)用osMessageQueuePut往已經(jīng)被占滿的隊(duì)列里塞數(shù)據(jù)而阻塞整個(gè)BLE協(xié)議棧事件處理都會(huì)被拖慢甚至導(dǎo)致IPCC消息積壓。我的習(xí)慣是在回調(diào)里只做“記錄數(shù)據(jù)發(fā)送信號(hào)量/消息”具體業(yè)務(wù)邏輯放到專門的業(yè)務(wù)任務(wù)里處理。舉個(gè)實(shí)際場(chǎng)景——收到手機(jī)寫過(guò)來(lái)的數(shù)據(jù)需要解析后去控制電機(jī)void on_ble_write(uint16_t handle, uint8_t *data, uint16_t len) { /* 快速拷貝數(shù)據(jù)到全局緩沖區(qū) */ memcpy(rx_buffer, data, len); rx_len len; /* 通知業(yè)務(wù)任務(wù)去處理不要在這里做電機(jī)控制 */ osMessageQueuePut(motor_control_queue, rx_buffer, 0, 0); }這樣BLE協(xié)議棧任務(wù)能立刻返回去處理下一個(gè)事件不會(huì)因?yàn)橐粋€(gè)耗時(shí)操作阻塞整個(gè)鏈路。業(yè)務(wù)任務(wù)拿到消息后再去控制電機(jī)哪怕電機(jī)控制邏輯再?gòu)?fù)雜也不影響B(tài)LE連接的穩(wěn)定性。3.3 內(nèi)存布局與共享緩沖區(qū)雙核協(xié)作的隱形難題STM32WB的M4核和M0核共享同一塊SRAM但它們的訪問(wèn)權(quán)限是有區(qū)分的。CubeMX生成的工程里會(huì)自動(dòng)有一個(gè)“核間通信內(nèi)存區(qū)域”的定義通常是通過(guò)MEMORY區(qū)域劃分或鏈接腳本來(lái)保證的。如果你在已有工程里集成BLE而原來(lái)手工改過(guò)鏈接腳本比如為了把某個(gè)數(shù)據(jù)放到指定RAM地址這就要特別小心了——?jiǎng)e把共享內(nèi)存區(qū)域的地址給覆蓋了。具體表現(xiàn)可能是BLE能跑但偶發(fā)數(shù)據(jù)錯(cuò)誤、協(xié)議棧初始化成功但連接后收發(fā)異常。排查起來(lái)非常隱蔽。我的做法是在集成分支上先檢查鏈接腳本里RAM和RAM_SHARED區(qū)域的地址、大小是否和CubeMX生成的一致確保沒(méi)有重疊。另外FreeRTOS的堆Heap默認(rèn)是從M4核可用的SRAM里分配的這塊內(nèi)存不能被共享給M0核。如果你在M4核上申請(qǐng)了一塊緩沖區(qū)然后試圖直接讓M0核通過(guò)IPCC消息訪問(wèn)它的指針這在STM32WB上是行不通的。正確的做法是需要跨核傳輸?shù)臄?shù)據(jù)必須放在專門劃分的共享內(nèi)存區(qū)域里再通過(guò)IPCC傳遞“指向共享內(nèi)存的指針”。這也是為什么ST的BLE中間件代碼里大量使用__attribute__((section(.shared)))或類似的屬性來(lái)說(shuō)明變量所在區(qū)域。4. 實(shí)操全過(guò)程把一個(gè)FreeRTOS工程改造成“BLEFreeRTOS”4.1 從“已有工程”生成可復(fù)現(xiàn)的改造步驟以下是我在真實(shí)項(xiàng)目中從零把BLE集成到一個(gè)已有FreeRTOS工程里的完整流程整個(gè)過(guò)程按順序做下來(lái)基本能一次跑通。第一步用CubeMX重新生成一個(gè)帶BLE的FreERTOS基礎(chǔ)工程。雖然你手里是“已有工程”但我建議不要直接在老工程文件里手動(dòng)加代碼。正確做法是在CubeMX里新建一個(gè)同型號(hào)芯片的配置把外設(shè)和中間件配好生成一個(gè)新工程然后把老工程的應(yīng)用代碼逐步移植過(guò)來(lái)。原因是BLE中間件涉及的文件關(guān)聯(lián)很復(fù)雜手動(dòng)添加容易漏文件或版本不匹配。第二步確認(rèn)射頻核固件已經(jīng)燒錄。用STM32CubeProgrammer連接芯片點(diǎn)擊“Firmware Upgrade Services”標(biāo)簽查看當(dāng)前射頻核的固件狀態(tài)。如果顯示“No stack”或者版本過(guò)低先把CubeMX生成的stm32wb5x_BLE_Stack_full_fw.bin燒進(jìn)去。燒錄時(shí)注意選擇正確的地址一般是0x080EC000具體以CubeMX生成的readme.md為準(zhǔn)。第三步生成工程后先編譯一次原始代碼確認(rèn)RF核和M4核的代碼能同時(shí)工作。CubeMX生成的工程默認(rèn)會(huì)有一個(gè)app_ble.c里面包含了BLE初始化和事件處理的模板代碼。你可以在MX_APPE_Init()之后在任務(wù)循環(huán)里加一句printf(BLE init done\n)驗(yàn)證串口能打印、系統(tǒng)不崩潰。第四步把老工程的任務(wù)逐個(gè)遷移過(guò)來(lái)。遷移時(shí)注意原有任務(wù)如果用了vTaskDelay、xQueueSend這類原生FreeRTOS API可以直接保留如果你想讓代碼風(fēng)格統(tǒng)一也可以換成CMSIS-RTOS2的osDelay、osMessageQueuePut。功能上兩者等價(jià)但CMSIS-RTOS2的接口更通用。如果老任務(wù)里使用了HAL_Delay建議替換成osDelay或vTaskDelay因?yàn)镠AL_Delay是忙等待會(huì)占著CPU空轉(zhuǎn)削弱FreeRTOS調(diào)度的意義。第五步添加你的BLE業(yè)務(wù)邏輯。在app_ble.c里你會(huì)看到ST用“任務(wù)事件循環(huán)”的方式組織代碼。你可以在APP_BLE_Init里注冊(cè)自己的服務(wù)在事件回調(diào)里處理GATT讀寫。如果需要自定義服務(wù)一般在app_ble里創(chuàng)建一個(gè)service初始化函數(shù)例如static void APP_BLE_Add_Custom_Service(void) { /* 添加自定義UUID的Service */ aci_gatt_add_service(...); /* 添加Characteristic */ aci_gatt_add_char(...); }這里要注意aci_gatt_add_service等函數(shù)返回的Service Handle要保存下來(lái)后續(xù)收發(fā)數(shù)據(jù)都會(huì)用到。對(duì)應(yīng)的Handle可以放在全局變量里但要注意跨文件訪問(wèn)時(shí)的命名規(guī)范避免和ST內(nèi)部變量沖突。第六步驗(yàn)證BLE掃描、連接、收發(fā)。這個(gè)階段我的測(cè)試順序是先拿手機(jī)上的nRF Connect或LightBlue掃描到設(shè)備廣播然后連接再嘗試讀寫自定義Characteristic。如果廣播都看不到優(yōu)先檢查射頻核固件是否燒錄、雙核時(shí)鐘是否正常如果連得上但讀寫有問(wèn)題優(yōu)先檢查GATT屬性的事件回調(diào)有沒(méi)有正確注冊(cè)。4.2 關(guān)鍵代碼解析初始化、事件輪詢與業(yè)務(wù)分發(fā)這段代碼直接決定整個(gè)集成的骨架。以下是我項(xiàng)目中使用過(guò)的精簡(jiǎn)版結(jié)構(gòu)注釋解釋了每段代碼的作用方便你對(duì)照自己的工程。/* 在FreeRTOS任務(wù)里啟動(dòng)整個(gè)BLE應(yīng)用 */ void BLE_App_Task(void *argument) { /* 1. 初始化BLE協(xié)議棧。 這一步會(huì)請(qǐng)求M0核加載/啟動(dòng)BLE棧并完成GATT、GAP等基礎(chǔ)參數(shù)設(shè)置。 */ if (BLE_Init() ! BLE_STATUS_SUCCESS) { Error_Handler(); } /* 2. 注冊(cè)GAP/GATT事件回調(diào)。 */ hci_gap_event_handler My_GAP_EventHandler; hci_gatt_event_handler My_GATT_EventHandler; /* 3. 添加服務(wù)設(shè)置廣播數(shù)據(jù)啟動(dòng)廣播。 */ APP_BLE_Add_Custom_Service(); APP_BLE_Set_Advertise_Data(); aci_gap_set_discoverable(...); /* 4. 進(jìn)入事件處理循環(huán)。 */ for (;;) { /* 處理IPCC中來(lái)自M0核的BLE事件。 沒(méi)有事件時(shí)內(nèi)部會(huì)等待信號(hào)量/消息任務(wù)掛起不占CPU。 */ BLE_Protocol_Stack_Event_Handler(); /* 處理我們自己的業(yè)務(wù)消息隊(duì)列。 */ Process_App_Message(); } }注意第4步里的“事件處理”和“業(yè)務(wù)消息”是分兩層的BLE_Protocol_Stack_Event_Handler()負(fù)責(zé)把M0核拋上來(lái)的協(xié)議棧事件交給ST中間件內(nèi)部處理最終會(huì)回調(diào)到你的My_GAP_EventHandler和My_GATT_EventHandler而Process_App_Message()則是處理你自己業(yè)務(wù)層通過(guò)隊(duì)列發(fā)來(lái)的消息。這種分離的好處是不管你業(yè)務(wù)層有多少種消息協(xié)議棧事件始終能被及時(shí)處理。在實(shí)際項(xiàng)目里我會(huì)再定義一個(gè)專門的消息結(jié)構(gòu)體把BLE收到原始數(shù)據(jù)的指針、長(zhǎng)度、連接Handle一并打包進(jìn)消息隊(duì)列typedef struct { uint16_t conn_handle; uint8_t *data; uint16_t len; } Ble_Rx_Message_t;業(yè)務(wù)任務(wù)收到這個(gè)消息后再?zèng)Q定是解析成指令、存到Flash還是轉(zhuǎn)發(fā)給其他外設(shè)。這套模式在中小型BLE項(xiàng)目里非常通用也符合FreeRTOS“事件驅(qū)動(dòng)任務(wù)隔離”的推薦用法。4.3 雙核啟動(dòng)順序與RF核固件加載的注意事項(xiàng)STM32WB上電后的啟動(dòng)順序也值得單獨(dú)講一下因?yàn)檫@直接影響“為什么有時(shí)代碼能跑但BLE起不來(lái)”。M4核先運(yùn)行芯片上電后M4核從Flash取出向量表開始執(zhí)行初始化時(shí)鐘、GPIO、外圍設(shè)備。M4核通過(guò)FUS或直接加載的方式啟動(dòng)M0核固件在CubeMX生成的代碼里MX_APPE_Init()會(huì)調(diào)用底層的SHCI_C2_BLE_Init此函數(shù)會(huì)通過(guò)IPCC向M0核發(fā)送啟動(dòng)命令M0核被喚醒后開始執(zhí)行BLE協(xié)議棧固件。雙方通過(guò)IPCC握手一旦M0核的協(xié)議棧就緒會(huì)發(fā)送一個(gè)“Ready”事件給M4核此時(shí)應(yīng)用層才能安全地調(diào)用BLE API。這里最容易犯的錯(cuò)誤是在FreeRTOS調(diào)度器啟動(dòng)前就調(diào)用BLE初始化。我看到過(guò)一些人的代碼在main()里、在osKernelStart()之前就調(diào)用了MX_APPE_Init()導(dǎo)致BLE中間件內(nèi)部想創(chuàng)建任務(wù)、使用信號(hào)量時(shí)RTOS還沒(méi)跑起來(lái)輕則卡在初始化重則直接HardFault。正確做法是在main()里只初始化硬件相關(guān)時(shí)鐘、GPIO、串口等把MX_APPE_Init()放到一個(gè)FreeRTOS任務(wù)里去執(zhí)行。CubeMX默認(rèn)生成的代碼就是這樣做的——它會(huì)在defaultTask或?qū)ｉT的BLE任務(wù)里調(diào)用MX_APPE_Init()。如果因?yàn)槟撤N原因想在調(diào)度器啟動(dòng)前初始化BLE那你必須在osKernelStart()之前手動(dòng)確保RTOS Heap已經(jīng)可用但我不建議這樣繞直接順著CubeMX的默認(rèn)流程走最穩(wěn)。5. 常見問(wèn)題與排查技巧實(shí)錄5.1 我的“高頻踩坑清單”及解決思路以下這些問(wèn)題如果你在做BLEFreeRTOS集成大概率會(huì)遇到其中幾個(gè)。我把排查思路一并列出來(lái)方便你對(duì)照排查?，F(xiàn)象可能原因排查方法BLE初始化超時(shí)或卡死射頻核沒(méi)燒固件、FUS版本不匹配、IPCC未初始化用CubeProgrammer確認(rèn)RF核固件狀態(tài)檢查IPCC和HSEM初始化能初始化但搜不到廣播廣播數(shù)據(jù)設(shè)置錯(cuò)誤、時(shí)鐘偏差、協(xié)議棧任務(wù)優(yōu)先級(jí)太低核對(duì)廣播數(shù)據(jù)是否符合規(guī)范用nRF Connect檢查提高BLE任務(wù)優(yōu)先級(jí)連接后偶發(fā)斷開事件處理不及時(shí)、內(nèi)存越界、低功耗配置沖突在“連接事件回調(diào)”里打日志量到斷開前事件是否被延遲了檢查共享緩沖區(qū)是否越界數(shù)據(jù)收發(fā)錯(cuò)誤GATT服務(wù)配置錯(cuò)誤、MTU太小、共享內(nèi)存指針錯(cuò)誤逐個(gè)檢查Characteristic的UUID、屬性必要時(shí)抓包確認(rèn)數(shù)據(jù)流向系統(tǒng)重啟或HardFault任務(wù)棧溢出、堆空間不足、在中斷里調(diào)用阻塞API開啟FreeRTOS的棧溢出檢測(cè)增大任務(wù)?；騂eap確認(rèn)IPCC中斷里不調(diào)用RTOS阻塞API低功耗模式下BLE死掉RF核被掛起但沒(méi)有正確喚醒確認(rèn)低功耗模式下M0核的喚醒源配置不要在低功耗模式里瘋狂調(diào)用BLE API5.2 兩個(gè)讓我印象深刻的Debug實(shí)例第一個(gè)是“BLE能連上但手機(jī)發(fā)數(shù)據(jù)后設(shè)備不響應(yīng)”。我排查了很久發(fā)現(xiàn)是GATT事件的回調(diào)函數(shù)沒(méi)有注冊(cè)到正確的Characteristic Handle上。因?yàn)槲以谔砑臃?wù)的時(shí)候用了全局變量來(lái)保存handle但中途改了UUID之后忘了同步handle結(jié)果回調(diào)里拿到的handle和實(shí)際服務(wù)不匹配。最后還是用ST的“HCI事件日志”打出來(lái)發(fā)現(xiàn)事件里的handle和我訂閱的不一致才定位到。所以我的建議是如果你改過(guò)服務(wù)定義一定要回頭確認(rèn)handle變量的賦值是否同步。第二個(gè)是“系統(tǒng)一加BLE就頻繁HardFault”。后來(lái)把FreeRTOS的configCHECK_FOR_STACK_OVERFLOW打開發(fā)現(xiàn)是BLE任務(wù)棧給太小了。ST中間件調(diào)用的某些函數(shù)調(diào)用鏈比較深動(dòng)輒需要800字節(jié)到1KB的棧空間。我之前給BLE任務(wù)只分配了512字words的空間結(jié)果爆了。把棧加大到1024或1280字節(jié)后問(wèn)題消失。如果你不確定任務(wù)棧該給多大折中方案是“先給大穩(wěn)定后再逐步調(diào)小”用棧水位檢測(cè)工具查看實(shí)際用量。5.3 調(diào)試工具與日志策略如何在雙核環(huán)境里定位問(wèn)題BLEFreeRTOS的調(diào)試比純裸機(jī)復(fù)雜因?yàn)閱?wèn)題可能出現(xiàn)在“應(yīng)用邏輯層”“RTOS調(diào)度層”“雙核通信層”甚至“射頻協(xié)議棧層”。我的調(diào)試策略是分層打日志、逐層縮小范圍不要一上來(lái)就抓RF波形。串口打印最基礎(chǔ)也最有效。建議在M4核的BLE任務(wù)入口打印“BLE init start”和“BLE init finish”在事件回調(diào)里打印連接/斷開事件在業(yè)務(wù)任務(wù)里打印數(shù)據(jù)處理結(jié)果。這樣你至少能判斷是哪一層先出問(wèn)題。HCI日志ST的BLE中間件支持把M0核和M4核之間的HCI指令/事件打印出來(lái)。這屬于“協(xié)議棧內(nèi)部視角”能看到廣播配置是否正確、連接事件是否成功。CubeMX里開啟CFG_DEBUG_BLE或類似宏后日志量會(huì)大幅增加但排查問(wèn)題非常有用。FreeRTOS系統(tǒng)視圖System view或Tracealyzer如果你需要分析任務(wù)調(diào)度、堆棧水位、優(yōu)先級(jí)反轉(zhuǎn)這兩類問(wèn)題用這類工具比肉眼看強(qiáng)太多。我的經(jīng)驗(yàn)是把工程跑起來(lái)后先采集一段系統(tǒng)日志找找有沒(méi)有任務(wù)長(zhǎng)期占著CPU不釋放、有沒(méi)有互斥鎖長(zhǎng)時(shí)間被持有。6. 結(jié)尾補(bǔ)充一段個(gè)人體會(huì)寫到這里我在實(shí)際項(xiàng)目里把BLE和FreeRTOS集成到STM32WB55RG上的經(jīng)驗(yàn)已經(jīng)基本說(shuō)完了。最后想給正在折騰的朋友一個(gè)錦囊當(dāng)代碼和配置都檢查不出問(wèn)題的時(shí)候退回到“最小可運(yùn)行工程”的狀態(tài)從最簡(jiǎn)單的“廣播 連接 一讀一寫”開始逐步加功能。BLE協(xié)議棧和RTOS都是“狀態(tài)機(jī)復(fù)雜度”很高的系統(tǒng)一旦疊加出了問(wèn)題很難一眼看穿。很多我們以為的玄學(xué)Bug最后都不是玄學(xué)而是“某個(gè)細(xì)節(jié)配置和實(shí)際硬件狀態(tài)不一致”。再分享一個(gè)小技巧做集成時(shí)建議把CubeMX生成的工程單獨(dú)建一個(gè)Git分支每次改動(dòng)前提交一次每次出問(wèn)題能回退到“能編譯、能燒錄、能跑”的狀態(tài)。雙核調(diào)試本身就增加了排查維度良好的版本管理能幫你快速定位是哪一步改動(dòng)引入了問(wèn)題。如果你沒(méi)跑過(guò)STM32WB也沒(méi)在FreeRTOS里接過(guò)BLE中間件第一次做不要急著直接梭哈到復(fù)雜業(yè)務(wù)。先讓板子廣播起來(lái)再把你的設(shè)備和手機(jī)連上再去動(dòng)業(yè)務(wù)邏輯。這個(gè)從簡(jiǎn)到繁的過(guò)程會(huì)幫你省下最多的調(diào)試時(shí)間。