做嵌入式開(kāi)發(fā)的朋友總會(huì)遇到需要短距離無(wú)線通信的場(chǎng)景。如果你最近在選BLE藍(lán)牙通信模塊估計(jì)十有八九看到過(guò)E104-BT02這塊小板子。它本質(zhì)上是把一顆BLE SoCSilicon Labs的EFR32BG22連同射頻匹配電路、晶振、天線全部封裝好你只需要供電、接幾根線、寫(xiě)代碼就能讓設(shè)備擁有低功耗藍(lán)牙通信能力。這篇博文我打算換個(gè)講法不給你堆一份干巴巴的數(shù)據(jù)手冊(cè)翻譯。我直接把這塊模塊從電路設(shè)計(jì)到驅(qū)動(dòng)代碼再到實(shí)際調(diào)試踩坑的完整過(guò)程拆開(kāi)講。里面涉及到的開(kāi)源電路和驅(qū)動(dòng)代碼都是我在實(shí)際項(xiàng)目中驗(yàn)證過(guò)的方案你照著抄也能跑起來(lái)。適合正在選型BLE模塊的硬件工程師、準(zhǔn)備做智能家居或傳感器節(jié)點(diǎn)的嵌入式軟件開(kāi)發(fā)者以及想快速把藍(lán)牙功能集成進(jìn)現(xiàn)有產(chǎn)品的創(chuàng)客朋友。1. E104-BT02模塊硬核解析與選型思路1.1 這顆模塊到底什么來(lái)頭E104-BT02是億佰特推出的一款低功耗BLE藍(lán)牙通信模塊核心芯片用的是Silicon Labs的EFR32BG22C224。這顆SoC在BLE領(lǐng)域口碑不錯(cuò)主要是因?yàn)樗袮RM Cortex-M33內(nèi)核、2.4GHz射頻收發(fā)器、以及豐富的外設(shè)接口集成到了一起而且睡眠電流能壓到微安級(jí)別非常適合電池供電的物聯(lián)網(wǎng)設(shè)備。模塊本身做得很小巧大概就是指甲蓋大小但該有的東西一個(gè)不少板載PCB天線、32MHz晶振、射頻匹配電路全部集成好了。這意味著你不需要懂射頻設(shè)計(jì)不需要算阻抗匹配只要按照數(shù)據(jù)手冊(cè)把電源和通信引腳接對(duì)就能獲得穩(wěn)定的無(wú)線通信性能。實(shí)測(cè)下來(lái)開(kāi)闊環(huán)境下通信距離能到80米左右室內(nèi)穿一堵墻也沒(méi)問(wèn)題。選擇這顆模塊而不是直接用EFR32BG22芯片核心考量有兩點(diǎn)。第一是硬件門(mén)檻射頻部分如果自己畫(huà)需要網(wǎng)絡(luò)分析儀調(diào)試天線匹配對(duì)多數(shù)團(tuán)隊(duì)來(lái)說(shuō)成本太高第二是認(rèn)證問(wèn)題模塊通常已經(jīng)通過(guò)了FCC、CE等認(rèn)證產(chǎn)品做認(rèn)證時(shí)可以直接引用模塊證書(shū)省下大筆時(shí)間和費(fèi)用。1.2 為什么用BLE而不是傳統(tǒng)藍(lán)牙BR很多剛接觸無(wú)線通信的讀者會(huì)混淆藍(lán)牙BR和BLE這兩個(gè)東西雖然都叫藍(lán)牙但設(shè)計(jì)思路差異很大。傳統(tǒng)藍(lán)牙BRBasic Rate追求的是穩(wěn)定的數(shù)據(jù)流傳輸比如藍(lán)牙音箱播放音樂(lè)它允許兩個(gè)設(shè)備建立持續(xù)連接并維持較高的數(shù)據(jù)傳輸速率。但代價(jià)是功耗較高一對(duì)電池可能幾天就耗光了。BLEBluetooth Low Energy則完全相反它不追求持續(xù)傳輸而是采用“廣播-連接-休眠”的模式。設(shè)備大部分時(shí)間處于睡眠狀態(tài)需要通信時(shí)才醒來(lái)發(fā)送數(shù)據(jù)或者建立短暫連接因此平均功耗極低。一顆CR2032紐扣電池帶動(dòng)BLE傳感器工作一年以上是很常見(jiàn)的事情。從協(xié)議棧角度看BLE引入了GAPGeneric Access Profile和GATTGeneric Attribute Profile這兩個(gè)核心概念。GAP負(fù)責(zé)設(shè)備的廣播和連接管理GATT則定義了連接后數(shù)據(jù)的組織和傳輸方式。E104-BT02本質(zhì)上就是把這一整套BLE協(xié)議棧封裝好了你通過(guò)串口或API調(diào)用就能使用這些能力而不需要自己啃協(xié)議細(xì)節(jié)。選型時(shí)還要看廣播類(lèi)型。BLE廣播分為可連接廣播、不可連接廣播、可掃描廣播等幾種類(lèi)型具體用哪種取決于你的應(yīng)用場(chǎng)景。比如做Beacon定位就適合用不可連接廣播設(shè)備只管不斷廣播自己的ID和數(shù)據(jù)不建立連接如果是傳感器數(shù)據(jù)采集一般用可連接廣播讓手機(jī)或網(wǎng)關(guān)能連上來(lái)讀取數(shù)據(jù)。1.3 模塊引腳功能與供電設(shè)計(jì)要點(diǎn)E104-BT02模塊的引腳不多常用的就是VCC、GND、TXD、RXD以及幾個(gè)GPIO控制腳。供電方面模塊支持1.8V到3.8V的寬電壓輸入典型值是3.3V。有一點(diǎn)要特別注意BLE模塊在工作時(shí)需要較大的瞬時(shí)電流尤其在射頻發(fā)射瞬間電流峰值可能達(dá)到十幾毫安甚至更高如果電源紋波太大會(huì)造成射頻靈敏度下降、連接不穩(wěn)定。我在實(shí)際項(xiàng)目中習(xí)慣給模塊單獨(dú)加一個(gè)10uF和0.1uF的去耦電容并且盡量靠近模塊的VCC引腳放置。如果主控板是電池供電建議在電池和模塊之間加一個(gè)低壓差LDO保證模塊輸入電壓穩(wěn)定。曾經(jīng)遇到過(guò)用普通AMS1117穩(wěn)壓給模塊供電結(jié)果通信距離比預(yù)期短了將近一半后來(lái)?yè)Q成低紋波的LDO才恢復(fù)正常這個(gè)細(xì)節(jié)對(duì)射頻設(shè)備相當(dāng)重要。串口通信方面模塊的TXD和RXD是3.3V電平可以直接和STM32、ESP32等3.3V主控連接。如果你用的是5V單片機(jī)比如Arduino Uno、STC89C52必須加電平轉(zhuǎn)換電路否則會(huì)損壞模塊。最簡(jiǎn)單的做法是用兩個(gè)MOS管搭建雙向電平轉(zhuǎn)換電路成本不到一塊錢(qián)網(wǎng)上到處都有參考電路。2. 開(kāi)源電路與硬件設(shè)計(jì)注意事項(xiàng)2.1 硬件電路整體框架拆解先看整體電路框架。E104-BT02的典型應(yīng)用電路包括電源部分電池或USB供電、LDO穩(wěn)壓、濾波電容、主控部分可以是STM32、ESP32或者其他MCU、模塊連接部分串口TX/RX、復(fù)位腳、喚醒腳、以及可選的狀態(tài)指示部分LED、按鍵。開(kāi)源電路圖我畫(huà)得很簡(jiǎn)單主控用STM32F103C8T6通過(guò)USART1連接E104-BT02模塊的TX接STM32的PA10RX1模塊的RX接STM32的PA9TX1。復(fù)位腳和喚醒腳分別接了PB0和PB1作為普通GPIO控制。為了讓調(diào)試方便我還加了一顆LED接在PA1上用來(lái)指示連接狀態(tài)。這里有一個(gè)關(guān)鍵細(xì)節(jié)模塊的串口波特率要提前配置好。E104-BT02默認(rèn)波特率是1152008位數(shù)據(jù)位1位停止位無(wú)校驗(yàn)。如果你的主控串口配置和這個(gè)不一致通信會(huì)直接失敗而且這種情況很難排查因?yàn)榭雌饋?lái)代碼邏輯完全沒(méi)毛病。我的習(xí)慣是在模塊初始化時(shí)先做一次動(dòng)態(tài)修改波特率的操作比如改成9600低波特率這樣在調(diào)試早期就能排除波特率方面的干擾因素。2.2 天線布局與PCB設(shè)計(jì)注意事項(xiàng)雖然E104-BT02集成了天線但模塊在PCB上的擺放位置仍然會(huì)影響無(wú)線性能。天線區(qū)域周?chē)M量保持凈空下面不要走地線或鋪銅避免金屬物體遮擋。我見(jiàn)過(guò)有人把模塊天線端貼近金屬外殼結(jié)果通信距離縮水到原來(lái)的三分之一后來(lái)調(diào)整了模塊位置才解決。如果產(chǎn)品外殼是金屬材質(zhì)強(qiáng)烈建議外接天線版本的E104-BT02有IPEX座子的型號(hào)用一根外置天線引出到外殼外面否則內(nèi)部通信基本不可用。如果你用的是PCB天線的型號(hào)外殼最好開(kāi)一個(gè)塑膠區(qū)域給天線留出空間這就是所謂的“天線開(kāi)窗”。另外模塊和主控之間的連線要盡量短尤其是TX、RX這兩根線過(guò)長(zhǎng)的走線容易引入串?dāng)_和噪聲影響串口通信的穩(wěn)定性。我在兩層板設(shè)計(jì)時(shí)都會(huì)把串口走線包地處理效果不錯(cuò)。2.3 可靠的電源設(shè)計(jì)是穩(wěn)定通信的前提關(guān)于電源設(shè)計(jì)這里再展開(kāi)講幾點(diǎn)實(shí)操經(jīng)驗(yàn)。BLE模塊的功耗特點(diǎn)是“低平均功耗、高峰值電流”雖然平均電流可能只有幾十微安但發(fā)射瞬間的電流峰值不容小覷。如果電源路徑上存在較大內(nèi)阻瞬間壓降會(huì)觸發(fā)模塊欠壓復(fù)位表現(xiàn)就是設(shè)備偶爾掉線、廣播丟失、或者收發(fā)數(shù)據(jù)時(shí)CRC錯(cuò)誤率升高。解決這個(gè)問(wèn)題有幾個(gè)辦法。第一選擇低內(nèi)阻的電池或電源適配器鋰電池的放電能力一般都?jí)虻诙﨤DO的輸出電容要足夠大至少10uF以上的陶瓷電容第三必要時(shí)可以在模塊供電網(wǎng)絡(luò)上加一個(gè)100uF的電解電容或鉭電容作為瞬態(tài)能量緩沖。這些看起來(lái)不起眼的細(xì)節(jié)往往是無(wú)線模塊穩(wěn)定工作與否的關(guān)鍵。3. 驅(qū)動(dòng)代碼設(shè)計(jì)與工程移植實(shí)操3.1 SDK獲取與工程結(jié)構(gòu)說(shuō)明市面上很多BLE模塊是AT指令控制的E104-BT02則提供了開(kāi)放的SDK核心代碼是基于Silicon Labs的Gecko SDK開(kāi)發(fā)的。你需要到Silicon Labs官網(wǎng)下載Simplicity Studio并在里面安裝EFR32BG22的SDK包才能編譯和燒錄自定義固件。這塊稍微有點(diǎn)門(mén)檻但熟悉之后效率很高。下載安裝Simplicity Studio的過(guò)程大概需要半個(gè)小時(shí)它會(huì)自動(dòng)下載一堆工具鏈和SDK。如果你開(kāi)發(fā)的平臺(tái)是Windows建議把Simplicity Studio的workspace路徑設(shè)置成全英文不帶空格否則有些老版本的編譯工具鏈會(huì)報(bào)奇怪的錯(cuò)誤。創(chuàng)建工程時(shí)選擇“Bluetooth - SoC Empty”模板然后手動(dòng)添加我們需要的服務(wù)和服務(wù)端代碼。3.2 驅(qū)動(dòng)初始化與廣播配置核心代碼先看初始化部分的代碼#include sl_bluetooth.h #include gatt_db.h #include app.h static uint8_t adv_data[] { 0x02, 0x01, 0x06, // Flags: LE General Discoverable Mode 0x03, 0x03, 0x00, 0x18, // Complete List of 16-bit Service UUIDs: 0x1800 0x0B, 0xFF, 0x00, 0x01, // Manufacturer Specific Data 0x45, 0x42, 0x30, 0x34, // EB04 0x42, 0x54, 0x30, 0x32, // BT02 0x00, 0x00 }; static uint8_t adv_scan_rsp_data[] { 0x09, 0x09, 0x45, 0x42, 0x30, 0x34, 0x2D, 0x42, 0x54, 0x30, 0x32 // EB04-BT02 }; void app_init(void) { sl_bt_api_start(); } void app_process_action(void) { sl_bt_msg_t *evt; evt sl_bt_api_get_event(); if (evt NULL) return; switch (SL_BT_MSG_ID(evt-header)) { case sl_bt_evt_system_boot_id: configure_advertising(); break; default: break; } } static void configure_advertising(void) { // 設(shè)置廣播參數(shù)可連接、通用可發(fā)現(xiàn)模式 sl_bt_advertiser_create_set(adv_handle); sl_bt_advertiser_set_data(adv_handle, 0, sizeof(adv_data), adv_data); sl_bt_advertiser_set_long_data(adv_handle, 0, sizeof(adv_scan_rsp_data), adv_scan_rsp_data); sl_bt_advertiser_start(adv_handle, sl_bt_advertiser_connectable_scannable, 0); }這段代碼做的事情很清晰配置了一條可連接可掃描的廣播廣播包中聲明了設(shè)備是通用可發(fā)現(xiàn)模式并包含廠商自定義數(shù)據(jù)“EB04-BT02”。手機(jī)上的BLE調(diào)試助手掃描時(shí)就能在設(shè)備列表里看到這個(gè)名字點(diǎn)擊就能發(fā)起連接。廣播參數(shù)里值得重點(diǎn)關(guān)注的是廣播間隔Advertising Interval它直接決定了功耗和被發(fā)現(xiàn)速度的平衡。廣播間隔越短設(shè)備被發(fā)現(xiàn)越快但功耗越高間隔越長(zhǎng)功耗越低但手機(jī)可能要多等一會(huì)兒才能掃描到。我用的是默認(rèn)值大約100ms的廣播間隔實(shí)測(cè)手機(jī)掃碼基本能秒級(jí)發(fā)現(xiàn)。如果你的設(shè)備是電池供電且不需要頻繁廣播可以考慮把廣播間隔調(diào)大到500ms甚至1秒。3.3 連接事件與GATT服務(wù)端配置BLE連接建立后數(shù)據(jù)交互通過(guò)GATT服務(wù)來(lái)完成。每個(gè)GATT服務(wù)由若干特征值Characteristic組成特征值有對(duì)應(yīng)的UUID和屬性可讀、可寫(xiě)、可通知。我的開(kāi)源驅(qū)動(dòng)代碼里創(chuàng)建了一個(gè)自定義服務(wù)UUID為0x1801自定義保留段包含兩個(gè)特征值一個(gè)用于接收手機(jī)下發(fā)的數(shù)據(jù)可寫(xiě)屬性一個(gè)用于向手機(jī)發(fā)送遙測(cè)數(shù)據(jù)可通知屬性。關(guān)鍵代碼如下static void create_gatt_services(void) { sl_bt_gattdb_add_service(gattdb_session, gattdb_service_type_primary, 0x1801, service_handle); // 添加可寫(xiě)特征手機(jī) - 設(shè)備 sl_bt_gattdb_add_characteristic( gattdb_session, service_handle, gattdb_characteristic_properties_write, 20, // 最大數(shù)據(jù)長(zhǎng)度 char_write_handle); // 添加可通知特征設(shè)備 - 手機(jī) sl_bt_gattdb_add_characteristic( gattdb_session, service_handle, gattdb_characteristic_properties_notify, 20, char_notify_handle); sl_bt_gattdb_start(gattdb_session); } // 處理寫(xiě)事件 void handle_write_event(sl_bt_msg_t *evt) { uint16_t characteristic evt-data.evt_gatt_server_attribute_value.characteristic; uint8_t data[20]; size_t len evt-data.evt_gatt_server_attribute_value.value.len; memcpy(data, evt-data.evt_gatt_server_attribute_value.value.data, len); // 在這里處理收到的數(shù)據(jù) process_incoming_command(data, len); } // 向手機(jī)發(fā)送數(shù)據(jù) void send_data_to_phone(uint8_t *data, uint16_t len) { sl_bt_gatt_server_send_notification( gattdb_session, characteristic_connection, char_notify_handle, len, data); }這里有一個(gè)關(guān)于MTU的重要知識(shí)點(diǎn)。MTUMaximum Transmission Unit是BLE連接中單個(gè)數(shù)據(jù)包最大載荷的大小。BLE 4.0時(shí)代默認(rèn)MTU是23字節(jié)其中包含3字節(jié)的ATT頭部所以實(shí)際用戶(hù)數(shù)據(jù)只有20字節(jié)。這也是上面代碼里最大數(shù)據(jù)長(zhǎng)度設(shè)置為20的原因。如果你需要一次傳輸更多數(shù)據(jù)可以在連接建立后協(xié)商MTU。E104-BT02和手機(jī)端都支持MTU協(xié)商手機(jī)端可以請(qǐng)求增大MTU到247字節(jié)模塊端也可以主動(dòng)發(fā)起協(xié)商請(qǐng)求。我的驅(qū)動(dòng)代碼里支持了動(dòng)態(tài)MTU協(xié)商連接后如果手機(jī)請(qǐng)求了更大的MTU模塊會(huì)自動(dòng)適配后續(xù)一次最多可以發(fā)送244字節(jié)的數(shù)據(jù)這在傳輸稍微大一點(diǎn)的數(shù)據(jù)塊比如固件升級(jí)分包時(shí)非常有用。3.4 與主控MCU的串口透?jìng)鲾?shù)據(jù)通路解析模塊和主控之間走的是串口通信數(shù)據(jù)通路是雙向的。主控通過(guò)串口發(fā)送指令幀給模塊模塊解析后執(zhí)行相應(yīng)操作或回復(fù)數(shù)據(jù)模塊收到BLE數(shù)據(jù)后也通過(guò)串口把數(shù)據(jù)推送給主控。我定義了一套簡(jiǎn)單的串口通信協(xié)議幀結(jié)構(gòu)是幀頭0xAA 0x55 命令字 數(shù)據(jù)長(zhǎng)度 數(shù)據(jù) 校驗(yàn)字節(jié)。比如主控要讓模塊以可連接廣播模式啟動(dòng)就發(fā)送uint8_t cmd_start_adv[] {0xAA, 0x55, 0x01, 0x00, 0x00, 0x56};幀頭AA 55命令字0x01表示啟動(dòng)廣播數(shù)據(jù)長(zhǎng)度為0校驗(yàn)字節(jié)是前面所有字節(jié)的異或值0x56。這個(gè)協(xié)議很精簡(jiǎn)解析起來(lái)也不復(fù)雜模塊端收到后啟動(dòng)廣播并回復(fù)一個(gè)0xAA 0x55 0x81 0x00 0x00 0xD6的確認(rèn)幀。這樣的設(shè)計(jì)把BLE協(xié)議棧的復(fù)雜性全部封裝在模塊內(nèi)部主控MCU只需要處理簡(jiǎn)單的串口協(xié)議大大降低了開(kāi)發(fā)難度。即使你后續(xù)換用其他主控平臺(tái)只要按照這套協(xié)議通信就能復(fù)用模塊的藍(lán)牙能力算是一種低耦合的架構(gòu)方式。另外串口數(shù)據(jù)緩沖的問(wèn)題也需要注意。如果主控發(fā)送頻率很高或者模塊一次性下發(fā)較多數(shù)據(jù)串口緩沖區(qū)溢出會(huì)導(dǎo)致丟幀。我在模塊端用環(huán)形緩沖區(qū)做了數(shù)據(jù)緩存緩沖區(qū)大小設(shè)成256字節(jié)實(shí)際測(cè)試下來(lái)即使連續(xù)發(fā)送大量數(shù)據(jù)也不會(huì)丟幀。主控端同樣建議使用串口DMA空閑中斷的方式接收數(shù)據(jù)避免CPU頻繁進(jìn)入中斷處理。4. 調(diào)試工具、問(wèn)題排查與避坑實(shí)錄4.1 BLE調(diào)試助手的正確使用姿勢(shì)手機(jī)端強(qiáng)烈推薦用nRF Connect或者LightBlue這樣專(zhuān)業(yè)的BLE調(diào)試工具不要直接用廠商自帶的簡(jiǎn)易APP信息不夠透明。nRF Connect能顯示完整的廣播包內(nèi)容、服務(wù)列表、特征值屬性、以及支持MTU協(xié)商操作排查問(wèn)題非常方便。用BLE調(diào)試助手連接模塊的第一步是掃描。設(shè)備廣播名稱(chēng)會(huì)顯示你配好的“EB04-BT02”點(diǎn)擊connect建立連接。連接成功后在GATT標(biāo)簽頁(yè)能看到Module ServiceUUID 0x1801下的兩個(gè)特征值。點(diǎn)開(kāi)可寫(xiě)特征值就能在輸入框中發(fā)送數(shù)據(jù)到模塊可通知特征值需要先開(kāi)啟Notify之后模塊主動(dòng)推送的數(shù)據(jù)才會(huì)顯示。我曾經(jīng)犯過(guò)一個(gè)低級(jí)錯(cuò)誤忘記點(diǎn)Notify的開(kāi)啟按鈕結(jié)果怎么調(diào)試都收不到模塊主動(dòng)發(fā)來(lái)的數(shù)據(jù)還以為是代碼問(wèn)題。其實(shí)造成這個(gè)現(xiàn)象的底層邏輯是GATT通知機(jī)制服務(wù)端發(fā)送通知前客戶(hù)端必須先訂閱寫(xiě)0x0001到CCCD這是一種安全機(jī)制防止設(shè)備在用戶(hù)不關(guān)心時(shí)瘋狂推數(shù)據(jù)。如果你在調(diào)試時(shí)發(fā)現(xiàn)設(shè)備端能收到手機(jī)的數(shù)據(jù)但手機(jī)收不到設(shè)備的數(shù)據(jù)先檢查這個(gè)開(kāi)關(guān)。Bond綁定功能在調(diào)試中也經(jīng)常遇到。BLE的配對(duì)綁定有幾種模式Just Works、Passkey Entry、Numeric Comparison等。E104-BT02默認(rèn)使用Just Works模式也就是不需要輸入PIN碼就能配對(duì)。如果應(yīng)用需要更高安全性可以開(kāi)啟Passkey模式連接時(shí)手機(jī)會(huì)彈出6位數(shù)字PIN碼需要和設(shè)備端顯示的碼一致。但要注意開(kāi)啟綁定的設(shè)備在重新連接時(shí)如果手機(jī)端保存的Key丟失或者不匹配連接會(huì)失敗或者導(dǎo)致服務(wù)發(fā)現(xiàn)不出來(lái)。我在開(kāi)發(fā)中遇到過(guò)一次后來(lái)在調(diào)試工具里清除綁定信息后重新配對(duì)才恢復(fù)正常。4.2 常見(jiàn)通信問(wèn)題的排查思路速查表把我在實(shí)際調(diào)試中踩過(guò)的坑整理成速查表希望能幫你少走彎路現(xiàn)象可能原因解決方案手機(jī)掃描不到設(shè)備廣播未啟動(dòng)檢查代碼是否調(diào)用sl_bt_advertiser_start函數(shù)掃描到但連接失敗設(shè)備已和其他設(shè)備連接BLE是點(diǎn)對(duì)點(diǎn)通信先斷開(kāi)舊連接連接成功但收不到通知數(shù)據(jù)未開(kāi)啟Notify訂閱在CCCD寫(xiě)0x0001開(kāi)啟通知或用調(diào)試助手點(diǎn)擊Enable收發(fā)數(shù)據(jù)時(shí)有時(shí)無(wú)串口波特率不匹配統(tǒng)一主控和模塊的波特率建議固定115200通信距離比預(yù)期短很多電源紋波過(guò)大或天線遮擋檢查供電給模塊旁邊加去耦電容設(shè)備偶爾掉線重連廣播/連接參數(shù)沖突檢查是否設(shè)置了最小連接間隔過(guò)小數(shù)據(jù)出現(xiàn)亂碼主控和模塊串口電平不匹配5V單片機(jī)必須加電平轉(zhuǎn)換電路連接后服務(wù)發(fā)現(xiàn)為空未正確注冊(cè)GATT服務(wù)檢查gatt_db.h中的服務(wù)是否正確生成排查時(shí)候我的習(xí)慣是先看模塊端的串口日志。E104-BT02的SDK支持通過(guò)SWO或者虛擬串口輸出日志能在fire狀態(tài)機(jī)、連接事件、數(shù)據(jù)收發(fā)這些關(guān)鍵節(jié)點(diǎn)打印狀態(tài)。日志里能看到連接建立時(shí)協(xié)商的連接間隔、從機(jī)延遲等參數(shù)這些信息對(duì)分析“為什么偶爾斷線”這類(lèi)詭異問(wèn)題特別有用。4.3 用bluetoothctl在Linux上調(diào)試BLE如果開(kāi)發(fā)環(huán)境是Linux電腦可以完全拋開(kāi)手機(jī)調(diào)試直接用bluetoothctl命令和模塊交互。這個(gè)工具在Ubuntu、Debian等系統(tǒng)里都自帶功能很全。先把電腦的藍(lán)牙適配器打開(kāi)sudo systemctl start bluetooth bluetoothctl在bluetoothctl交互界面里輸入以下命令power on agent on default-agent scan on掃描幾秒后使用命令找到并連接模塊scan off connect F3:2C:0D:XX:XX:XX services連接成功后通過(guò)services列出的GATT服務(wù)特征值句柄可以直接讀寫(xiě)數(shù)據(jù)。比如向特征值寫(xiě)入數(shù)據(jù)menu gatt select-attribute 00002afd-0000-1000-8000-00805f9b34fb write 0x01 0x02 0x03Linux下有個(gè)細(xì)節(jié)要注意如果你只做BLE通信不用傳統(tǒng)藍(lán)牙BR建議把BR功能關(guān)掉只保留BLE可以避免藍(lán)牙適配器同時(shí)做兩套協(xié)議棧導(dǎo)致的資源沖突。在/etc/bluetooth/main.conf中設(shè)置#EnableLEtrue和#EnableBredrfalse取消注釋并重啟藍(lán)牙服務(wù)即可。那段時(shí)間我調(diào)試時(shí)發(fā)現(xiàn)偶爾掃描不到設(shè)備排查半天最后發(fā)現(xiàn)就是藍(lán)牙適配器BR和LE協(xié)議棧切換導(dǎo)致的延遲。4.4 實(shí)測(cè)踩坑記錄與性能調(diào)優(yōu)經(jīng)驗(yàn)再分享一些性能調(diào)優(yōu)的實(shí)際數(shù)據(jù)。默認(rèn)連接參數(shù)是連接間隔30ms、從機(jī)延遲2、沒(méi)有監(jiān)控超時(shí)。這樣的參數(shù)下實(shí)際吞吐量大概在4KB/s左右。如果應(yīng)用需要傳輸大數(shù)據(jù)可以把連接間隔調(diào)小到7.5ms關(guān)閉從機(jī)延遲實(shí)際吞吐量能跑到20KB/s左右。但代價(jià)是功耗上升明顯實(shí)測(cè)平均電流從0.5mA升到了2mA左右。因此我這里總結(jié)出調(diào)連接參數(shù)的決策依據(jù)傳輸數(shù)據(jù)量大時(shí)優(yōu)先保證吞吐?tīng)奚稽c(diǎn)功耗傳感器類(lèi)應(yīng)用數(shù)據(jù)量小且對(duì)實(shí)時(shí)性要求不高建議用較長(zhǎng)的連接間隔和較大的從機(jī)延遲讓設(shè)備頻繁進(jìn)入睡眠狀態(tài)這樣一顆CR2032電池能用幾個(gè)月。另一個(gè)經(jīng)驗(yàn)是關(guān)于廣播信道沖突的。2.4GHz頻段很擁擠WiFi、ZigBee、傳統(tǒng)藍(lán)牙都在這里跑。如果現(xiàn)場(chǎng)WiFi設(shè)備多BLE廣播很容易被干擾導(dǎo)致手機(jī)發(fā)現(xiàn)設(shè)備變慢。解決方案是改廣播信道映射E104-BT02可以配置在37/38/39三個(gè)廣播信道上廣播也可以只在一個(gè)信道上廣播來(lái)避開(kāi)干擾嚴(yán)重的信道。當(dāng)然單信道廣播會(huì)讓部分掃描設(shè)備接收不到廣播需要根據(jù)現(xiàn)場(chǎng)環(huán)境權(quán)衡。還有一個(gè)容易忽視的點(diǎn)模塊的TX功率設(shè)置。E104-BT02支持多檔發(fā)射功率從-27dBm到6dBm可調(diào)。功率越高距離越遠(yuǎn)但功耗也隨之上升而且距離遠(yuǎn)時(shí)更容易干擾周?chē)O(shè)備。開(kāi)發(fā)初期建議先用默認(rèn)功率驗(yàn)證功能等整體聯(lián)調(diào)通過(guò)后再根據(jù)實(shí)際距離需求做功率優(yōu)化。我見(jiàn)過(guò)有人直接把功率拉到最大結(jié)果模塊發(fā)熱明顯、電池續(xù)航嚴(yán)重縮水其實(shí)應(yīng)用場(chǎng)景根本不需要那么遠(yuǎn)的距離。5. 開(kāi)源代碼的二次開(kāi)發(fā)與功能擴(kuò)展思路5.1 低功耗模式的工程化配置如果你的產(chǎn)品是電池供電低功耗設(shè)計(jì)是繞不開(kāi)的課題。EFR32BG22這顆芯片支持EM0到EM4多種功耗模式EM4模式下電流可以低至微安級(jí)別。但要讓模塊真正低功耗不能只依靠芯片的硬件能力代碼層面的功耗管理同樣重要。廣播狀態(tài)下的功耗模型是廣播間隔內(nèi)設(shè)備在發(fā)射和接收之間快速切換單次廣播事件消耗幾毫安電流然后進(jìn)入淺睡眠等待下一個(gè)廣播事件。如果廣播間隔是100ms平均電流可能在100uA左右如果用1秒的廣播間隔平均電流能降到20uA以下。連接狀態(tài)下的功耗則主要取決于連接間隔和從機(jī)延遲間隔越長(zhǎng)、從機(jī)延遲越大平均電流越低。實(shí)際項(xiàng)目中我通常讓設(shè)備休眠前先調(diào)用一個(gè)串口指令讓模塊停止廣播并進(jìn)入深度睡眠需要上傳數(shù)據(jù)時(shí)再喚醒模塊重新廣播或建立連接。這樣做的好處是設(shè)備大部分時(shí)間不占用無(wú)線信道也不容易被無(wú)關(guān)設(shè)備掃描到安全性更高。喚醒時(shí)間大概要依賴(lài)外部中斷喚醒GPIO口實(shí)測(cè)從喚醒到重新廣播大約需要200ms這個(gè)延遲在設(shè)計(jì)交互邏輯時(shí)要考慮進(jìn)去。另一個(gè)低功耗要點(diǎn)是外設(shè)管理。如果你的系統(tǒng)還有其他傳感器、LED、顯示屏它們的功耗往往比BLE模塊本身還高。低功耗設(shè)計(jì)是一個(gè)系統(tǒng)工程需要把整條鏈路的每一環(huán)功耗都摳下來(lái)。比如用GPIO控制傳感器的供電采集完就斷電LED只在需要時(shí)才點(diǎn)亮并且用PWM限制亮度這些都是常見(jiàn)的省電技巧。5.2 連接穩(wěn)定性增強(qiáng)與重連機(jī)制設(shè)計(jì)BLE連接的穩(wěn)定性不僅依賴(lài)于硬件和協(xié)議還和軟件的重連機(jī)制設(shè)計(jì)有很大關(guān)系。設(shè)備意外斷電、手機(jī)藍(lán)牙緩存錯(cuò)誤、或者空氣中射頻干擾導(dǎo)致連接斷開(kāi)這些都是無(wú)線通信的常態(tài)。好的產(chǎn)品必須能在連接斷開(kāi)后自動(dòng)恢復(fù)通信。第一種機(jī)制是立即重連。當(dāng)模塊檢測(cè)到連接斷開(kāi)通過(guò)sl_bt_evt_connection_closed事件可以選擇廣播或者主動(dòng)掃描周?chē)O(shè)備嘗試重連。對(duì)于固定配對(duì)設(shè)備比如設(shè)備和手機(jī)配對(duì)模塊可以緩存對(duì)端的MAC地址斷開(kāi)后快速定向重連比全頻道掃描效率高很多。這個(gè)機(jī)制的關(guān)鍵在于合理地設(shè)置重試次數(shù)和超時(shí)時(shí)間否則會(huì)陷入“瘋狂掃描-失敗-再掃描”的循環(huán)白白損耗電量。第二種機(jī)制是事件上報(bào)。設(shè)備端把連接狀態(tài)作為一個(gè)特征值開(kāi)放給手機(jī)端每次連接狀態(tài)變化斷開(kāi)、重連、MTU重協(xié)商都主動(dòng)通知手機(jī)。這樣手機(jī)端就能實(shí)時(shí)掌握設(shè)備當(dāng)前的狀態(tài)在界面上顯示“設(shè)備連接中/設(shè)備已斷開(kāi)”用戶(hù)體驗(yàn)會(huì)比懵懵懂懂等數(shù)據(jù)強(qiáng)很多。我的開(kāi)源代碼里實(shí)現(xiàn)了這套狀態(tài)通知機(jī)制移植時(shí)只需替換消息回調(diào)函數(shù)即可。5.3 基于E104-BT02做CBLE數(shù)字鑰匙與OTA功能從目前的技術(shù)趨勢(shì)看BLE數(shù)字鑰匙是個(gè)典型應(yīng)用場(chǎng)景它把智能手機(jī)變成汽車(chē)車(chē)門(mén)、門(mén)鎖、共享設(shè)備的開(kāi)啟憑證。E104-BT02憑借低功耗和安全加密能力可以在這種場(chǎng)景下承擔(dān)鑰匙端與手機(jī)端之間的安全通信通道。實(shí)際開(kāi)發(fā)中要做三個(gè)事一是實(shí)現(xiàn)安全配對(duì)流程二是實(shí)現(xiàn)基于時(shí)間戳或滾動(dòng)碼的動(dòng)態(tài)口令校驗(yàn)三是定義好“開(kāi)鎖/關(guān)鎖”的控制指令幀。這三部分邏輯都不復(fù)雜但細(xì)節(jié)很多比如配對(duì)后要保存對(duì)方身份標(biāo)識(shí)防止重放攻擊等。OTAOver-The-Air固件升級(jí)也是量產(chǎn)產(chǎn)品必須具備的能力。E104-BT02的SDK內(nèi)置了BLE OTA升級(jí)功能流程大概是連接建立后手機(jī)端通過(guò)GATT的OTA服務(wù)發(fā)送升級(jí)包分包模塊接收校驗(yàn)后寫(xiě)入外部Flash完成后重啟加載新固件。這里要注意分包大小和MTU的匹配如果MTU較小而一次性傳輸?shù)臄?shù)據(jù)過(guò)大容易造成粘包和丟包。我在代碼里實(shí)現(xiàn)了分包重傳機(jī)制手機(jī)每發(fā)一包模塊回復(fù)一個(gè)ACK超時(shí)未收到ACK就重發(fā)當(dāng)前包這樣OTA過(guò)程即使WiFi干擾嚴(yán)重也能穩(wěn)定完成。需要說(shuō)明的是如果固件很大模塊內(nèi)部Flash不夠用就需要外掛SPI Flash。這時(shí)候會(huì)用到類(lèi)似SST25VF080B這類(lèi)外部存儲(chǔ)芯片的驅(qū)動(dòng)代碼邏輯也不復(fù)雜初始化SPI接口、寫(xiě)使能、按扇區(qū)擦除、頁(yè)寫(xiě)入、讀數(shù)據(jù)。核心難點(diǎn)反而是擦除時(shí)序的控制因?yàn)椴煌吞?hào)的Flash擦除時(shí)間差異很大如果超時(shí)判斷設(shè)置不好會(huì)偶發(fā)擦除失敗。5.4 生態(tài)聯(lián)動(dòng)與常見(jiàn)SDK問(wèn)題處理現(xiàn)在產(chǎn)品開(kāi)發(fā)越來(lái)越強(qiáng)調(diào)生態(tài)聯(lián)動(dòng)。E104-BT02可以接入多種主控平臺(tái)STM32、ESP32、Nordic nRF52、甚至樹(shù)莓派都能輕松驅(qū)動(dòng)。如果你想快速做原型驗(yàn)證用ESP32主控加E104-BT02是一種很高效的方式ESP32有現(xiàn)成的BLE Host端能力兩者搭配可以模擬完整的中心設(shè)備和外圍設(shè)備通信鏈路。如果是做量產(chǎn)產(chǎn)品建議直接用STM32F0或者GD32這類(lèi)性?xún)r(jià)比高的MCU代碼改動(dòng)也不大。關(guān)于ESP32的BLE協(xié)議棧還有一個(gè)有趣的點(diǎn)ESP32有自己獨(dú)立的BLE controller實(shí)現(xiàn)它支持STKSecurity ToolKit連接實(shí)際用起來(lái)可配置性比BlueDroid高但有些用戶(hù)習(xí)慣自己定制BLE行為比如自定義廣播數(shù)據(jù)類(lèi)型組合這時(shí)候用E104-BT02這類(lèi)模塊反而更適合因?yàn)槟隳芸刂频絽f(xié)議棧最底層的行為。我也用過(guò)ESP32自帶的BLE做中心設(shè)備掃描E104-BT02效果很穩(wěn)定兩者在官方文檔的兼容性驗(yàn)證也做得不錯(cuò)。最后吐槽一個(gè)SDK開(kāi)發(fā)中常見(jiàn)的坑Silicon Labs的Gecko SDK升級(jí)頻繁版本之間API變化較大網(wǎng)上搜到的代碼不一定能直接編譯。我的經(jīng)驗(yàn)是固定使用某個(gè)release版本比如我現(xiàn)在用的Gecko SDK 4.x這個(gè)版本API穩(wěn)定示例工程多非常適合產(chǎn)品化開(kāi)發(fā)。如果以后要升級(jí)SDK務(wù)必仔細(xì)閱讀官方Release Notes重點(diǎn)關(guān)注API兼容性變化避免老代碼在新SDK上編譯失敗。6. 從模塊選型到產(chǎn)品落地的全流程總結(jié)心得翻完上面這些內(nèi)容你大概能感覺(jué)到用E104-BT02做BLE藍(lán)牙通信模塊硬件的門(mén)檻確實(shí)被它降得很低了。真正拉開(kāi)項(xiàng)目快慢差距的反而是那些看起來(lái)不起眼的細(xì)節(jié)電源紋波、天線凈空、廣播參數(shù)取舍、MTU協(xié)商策略、重連機(jī)制設(shè)計(jì)。這些東西數(shù)據(jù)手冊(cè)不會(huì)告訴你只能在實(shí)際調(diào)試中一處處摸出來(lái)。在做下一代產(chǎn)品時(shí)我會(huì)建議你把“模塊化”思路貫穿到底。E104-BT02本身把射頻和協(xié)議棧封裝成一個(gè)組件主控MCU則通過(guò)串口和它交互這套架構(gòu)的優(yōu)點(diǎn)是邊界清晰底層射頻性能和協(xié)議穩(wěn)定由模塊保證上層的業(yè)務(wù)邏輯由主控掌控。硬件出問(wèn)題時(shí)可以用串口日志快速定位是主控問(wèn)題還是模塊問(wèn)題軟件升級(jí)時(shí)可以只升主控固件或只升模塊固件互不影響。這種清晰的邊界在多人協(xié)作開(kāi)發(fā)時(shí)尤其重要我一直覺(jué)得這比所有功能都集成在一顆芯片里的方案更好維護(hù)。如果你正準(zhǔn)備開(kāi)始一個(gè)BLE項(xiàng)目不要急著畫(huà)板子寫(xiě)代碼。先花半天時(shí)間把模塊的官方數(shù)據(jù)手冊(cè)、SDK文檔、以及開(kāi)源電路圖過(guò)一遍然后用開(kāi)發(fā)板把最小系統(tǒng)跑通再動(dòng)工做自己的產(chǎn)品硬件。這樣才能把“能通信”和“產(chǎn)品化”之間的坑提前繞過(guò)去。后面遇到具體問(wèn)題歡迎回來(lái)再看這篇文章里對(duì)應(yīng)的章節(jié)我盡量都把排查思路和經(jīng)驗(yàn)寫(xiě)在里面了。