Bluetooth® LE SDK 7.3.0.0 GA
Gecko SDK Suite 4.4
26. února 2025
Gecko SDK Suite Bluetooth hardware a software
Silicon Labs je předním dodavatelem hardwarových a softwarových technologií Bluetooth používaných v produktech, jako je sport a fitness, spotřební elektronika, majáky a aplikace pro chytrou domácnost. Jádro SDK je pokročilý stack kompatibilní s Bluetooth 5.4, který poskytuje
všechny základní funkce spolu s více API pro zjednodušení vývoje. Základní funkce nabízí jak samostatný režim, který umožňuje vývojářům vytvářet a spouštět své aplikace přímo na SoC, nebo v režimu NCP, což umožňuje použití externího hostitelského MCU.
Tyto poznámky k vydání se týkají verzí sady SDK:
7.3.0.0 GA vydáno 26. února 2025
7.2.0.0 GA vydáno 23. října 2024
7.1.2.0 GA vydáno 14. srpna 2024
7.1.1.0 GA vydáno 2. května 2024
7.1.0.0 GA vydáno 10. dubna 2024
7.0.1.0 GA vydáno 14. února 2024
7.0.0.0 GA vydáno 13. prosince 2023
KLÍČOVÉ VLASTNOSTI
Bluetooth
- Nová komponenta bluetooth_feature_connection_analyzer poskytuje funkci pro zachycení a analýzu RSSI přenosů na Bluetooth připojení.
Multiprotokol
- Podpora souběžného poslechu (RCP) – MG21 a MG24.
- Concurrent Multiprotocol (CMP) Zigbee NCP + OpenThread RCP – produkční kvalita.
- Dynamic Multiprotocol Bluetooth + Concurrent Multiprotocol (CMP) podpora Zigbee a OpenThread na SoC.
Oznámení o kompatibilitě a použití
Informace o aktualizacích zabezpečení a upozorněních naleznete v kapitole Zabezpečení v poznámkách k vydání platformy Gecko nainstalované s touto sadou SDK nebo na kartě TECH DOCS na https://www.silabs.com/developers/bluetooth-low-energy. Silicon Labs také důrazně doporučuje, abyste se přihlásili k odběru bezpečnostních rad pro aktuální informace. Pokyny a poznámky k používání funkcí Secure Vault nebo pokud jste se sadou SDK Silicon Labs Bluetooth SDK poprvé, viz Používání této verze.
Kompatibilní kompilátory:
IAR Embedded Workbench pro ARM (IAR-EWARM) verze 9.40.1.
- Použití vína k sestavení pomocí nástroje příkazového řádku IarBuild.exe nebo grafického uživatelského rozhraní IAR Embedded Workbench v systému macOS nebo Linux může vést k nesprávným files se používá kvůli kolizím v hashovacím algoritmu vína pro generování zkratů file jména.
- Zákazníkům se systémem macOS nebo Linux se doporučuje, aby nevytvářeli s IAR mimo Simplicity Studio. Zákazníci, kteří tak učiní, by měli pečlivě ověřit, že je to správné files se používají.
GCC (The GNU Compiler Collection) verze 12.2.1, dodávaná se Simplicity Studio.
Nové položky
1.1 Nové funkce
Přidáno ve verzi 7.3.0.0
Klient GATT pouze pro výměnu ATT MTU
Přidána komponenta bluetooth_feature_gatt_client_att_mtu_request_only. Tato komponenta poskytuje minimálního klienta GATT pro automatické zahájení procedury výměny ATT MTU, když je otevřené spojení GATT. Tato komponenta neposkytuje rozhraní API klienta GATT. Pomocí rozhraní API serveru GATT sl_bt_gatt_server_set_max_mtu nastavte maximální velikost ATT MTU v hostitelském zásobníku BLE.
Komponenty pro specifické role připojení
Přidány nové komponenty bluetooth_feature_connection_role_central a bluetooth_feature_connection_role_peripheral. Tyto součásti poskytují podporu pro konkrétní roli připojení. Když aplikace zahrnuje bluetooth_feature_connection, měla by aplikace také zahrnovat jednu nebo obě součásti specifické pro roli na základě potřeb aplikace. Pokud aplikace obsahuje pouze bluetooth_feature_connection, budou z důvodu zpětné kompatibility podporovány obě role připojení.
Lepší optimalizace kódu v Bluetooth Security Manager
Správce zabezpečení Bluetooth nyní automaticky zruší centrální nebo periferní stavový stroj, pokud v aplikaci není zahrnuta komponenta bluetooth_feature_connec-tion_role_central nebo bluetooth_feature_connection_role_peripheral.
Přidáno ve verzi 7.2.0.0
Nová možnost skeneru
Přidána nová možnost skeneru SL_BT_SCANNER_IGNORE_BONDING pro použití s příkazem sl_bt_scanner_set_parameters_and_filter. Pokud aplikace nepotřebuje informace o lepení v reklamních zprávách, může nastavit tuto možnost skeneru, aby se zabránilo zbytečnému hledání vazeb.
Velká velikost seznamu přijetí
Maximální velikost seznamu přijatých položek byla zvýšena na 127 položek.
Filtrování událostí HCI
Link Layer v režimu HCI používá k filtrování událostí filtrování událostí dodávané aplikací. To lze použít k omezení provozu událostí HCI odeslaných do hostitelského zásobníku.
Přidáno ve verzi 7.1.0.0
Nastavení výkonu periodické reklamy
Nastavení TX power na reklamním setu je také použito pro periodickou reklamu.
Přidáno ve verzi 7.0.0.0
Bluetooth Connection Analyzer
Nová komponenta bluetooth_feature_connection_analyzer poskytuje funkci pro zachycení a analýzu RSSI přenosů na Bluetooth připojení.
1.2 Nová rozhraní API
Přidáno ve verzi 7.0.1.0
ID # | Popis |
1245616 | Představte nové konfigurace knihovny ESL C: ESL_TAG_POWER_DOWN_ENABLE a ESL_TAG_POWER_DOWN_TIMEOUT_MIN. Časový limit vypnutí lze upravit v ESL Tag example projekt pomocí těchto. Funkci lze také zcela vypnout. |
Přidáno ve verzi 7.0.0.0
Příkaz sl_bt_connection_analyzer_start: Spustí analýzu připojení jiného zařízení a nahlásí měření RSSI.
Příkaz sl_bt_connection_analyzer_stop: Zastavení analýzy připojení Bluetooth jiného zařízení.
Událost sl_bt_evt_connection_analyzer_report: Spustí se, když jsou zachyceny pakety přenášené na připojení.
Událost sl_bt_evt_connection_analyzer_completed: Spustí se, když je dokončena operace analýzy připojení.
Příkaz sl_bt_connection_get_scheduling_details: Získejte parametry a podrobnosti o plánování další události připojení.
Příkaz sl_bt_connection_get_median_rssi: Získání hodnoty RSSI naměřené na připojení.
Příkaz sl_bt_sm_resolve_rpa: Najděte adresu identity spojeného zařízení podle rozlišitelné soukromé adresy (RPA).
Událost sl_bt_evt_connection_set_parameters_failed: Spustí se, když partnerské zařízení odmítlo požadavek na aktualizaci parametrů připojení L2CAP.
ID # | Popis |
1203776 | Zaveďte nové ID události knihovny ESL C: ESL_LIB_EVT_PAWR_CONFIG. Konfigurace PAwR nyní podléhá předběžné kontrole zdravého rozumu knihovnou ESL C před nastavením konfigurace – pokud kontrola selže, konfigurace je zamítnuta. |
1196297 | Přidána podpora HADM pro libovolný počet kanálů až 80. |
1187941 | 'bt_abr_host_initiator' má nyní funkci pro uložení protokolu jsonlfiles do vybrané složky pomocí argumentu příkazu '-d'. V případě, že je parametr prázdný nebo neplatná cesta k adresáři, použije aktuální pracovní adresář a informuje uživatele. |
1158040 | Přidejte metriky kvality do HADM Initiator zobrazením vypočítané pravděpodobnosti vzdálenosti na uživatelském rozhraní. |
1152853 | Nová možnost komunikačního kanálu přidána do NCP-host examples: SPI over Co-Processor Communication (CPC). |
1108849 | Skript Python create_bl_files.py zavedeno ke sloučení skriptů .bat a .sh do jednoho. Nové funkce ve srovnání se starými skripty: – pomocník a další argumenty příkazu pro výběr požadované konfigurace – interaktivní režim: v případě, že některý z nástrojů popř files are missin tento skript vám pomůže jej nastavit – generovat komprimované GBL (jak lzma, tak lz4 kompresní metody) – zpracování logiky zařízení pro zařízení řady 1 a řady 2 |
Vylepšení
2.1 Změněné položky
Změněno ve verzi 7.0.1.0
ID # | Popis |
1231551 | Parametr 'start_time_us' funkce sl_bt_connection_analyzer_start() se změní z celého čísla bez znaménka na celé číslo se znaménkem, protože jeho hodnota může být záporná (označující čas v minulosti). |
1245597 | BLE RCP exampsoubory mají nyní ve výchozím nastavení povoleno řízení toku hardwaru. |
1246269 | Vylepšené ESL Tag průměrná spotřeba energie v synchronizovaném stavu až o 11 % s výchozími parametry ESL AP PAwR. |
Změněno ve verzi 7.0.0.0
ID # | Popis |
1203109 | Vylepšená detekční logika pro ESL, které nemají platnou konfiguraci GATT podle specifikace služby ESL. Nová logika nyní zabraňuje řadě falešně pozitivních detekcí a následnému vyloučení platných ESL ze sítě. |
1144612 | Aktualizace knihovny třetích stran cJSON z GitHubu: https://github.com/DaveGamble/cJSON @commit: b45f48e600671feade0b6bd65d1c69de7899f2be (master) |
1193924 | Migrujte BLE SDK examppoužít buď legacy_scanner API nebo extended_scanner API místo zastaralého rozhraní API skeneru. |
1177424 | Otevřením knihovny komponent v aplikaci Studio a výběrem kterékoli z komponent, které pocházejí z aplikace/bluetooth, se nyní v sekcích „Závislosti“ a „Závislosti“ zobrazí sekce „Dokumentace“ s obsahem hostovaným na docs.silabs.com pro danou komponentu. |
2.2 Změněná rozhraní API
Změněno ve verzi 7.1.0.0
Událost sl_bt_evt_system_resource_exhausted: Nový parametr 'num_message_allocation_failures' je připojen k seznamu parametrů pro hlášení situace vyčerpání zdrojů, že systému došly interní předem přidělené položky zprávy a že selhalo vytvoření interní zprávy.
Příkaz sl_bt_advertiser_set_tx_power: Funkčnost je rozšířena tak, aby se síla TX vztahovala i na periodickou reklamu.
Změněno ve verzi 7.0.0.0
Žádný.
2.3 Zamýšlené chování
Změněno ve verzi 7.0.0.0
Žádný.
Opravené problémy
Opraveno ve verzi 7.3.0.0
ID # | Popis |
1378000 | Opraven problém v plánovači úloh Link Layer, který v určitých scénářích vedl k tomu, že úlohy nebyly provedeny v chronologickém pořadí. |
Opraveno ve verzi 7.2.0.0
ID # | Popis |
1348090 | Opraven problém PAwR, kdy Link Layer správně nezpracovával nastavená data dílčích událostí, která byla odeslána příliš pozdě. |
1358600 | Opraven případ živého zámku, pokud zařízení dojde paměť přesně ve stejnou dobu jako odpojení. |
Opraveno ve verzi 7.1.2.0
ID # | Popis |
1279821 | Opraven problém v Link Layer, kdy periodický inzerent nezahrnoval hodnotu TX power v periodickém reklamním paketu při konfiguraci hostitelem. |
1282707 | Pokud centrální zařízení ztratilo spojovací klíče a periferní zařízení má povoleno potvrzení spojení, aby bylo možné spojení znovu navázat, klientem podporované funkce, nastavení a přihlášení k oznámením a indikacím již nebudou vymazány. |
1288445 | Opraven problém v Link Layer, kdy PAwR správně neinformoval hostitele o neúspěšných přenosech. |
1295837 | Opraven problém, který mohl vést k aktivacím během připojení nových periferií. Tento problém se vyskytuje pouze u Bluetooth SDK verze 7.1.1 a 8.0.0. |
1296939 | Opraven problém v Link Layer, kdy nezahrnutí komponenty Connection do určitých projektů mohlo vést k vážné chybě. |
1297876 | Optimalizované skenování na primárních kanálech při příjmu rozšířené reklamy s dlouhým pomocným ukazatelem. |
1330263 | Opraven problém v Link Layer, který způsoboval, že inzerent PAwR přestal přijímat nastavení dat dílčích událostí od hostitele. |
Opraveno ve verzi 7.1.0.0
ID # | Popis |
1247634 | Opraven problém, že server GATT nemusí reagovat na požadavek ATT, pokud nelze alokovat paměť pro zprávu s odpovědí. K tomuto problému může dojít, když zařízení skenuje a inzeruje souběžně s připojením GATT v rušném prostředí, kde mnoho zařízení inzeruje a skenuje současně. Tento případ použití může způsobit, že zásobníku Bluetooth často dojde paměť a výsledkem je selhání serveru GATT, pokud je nakonfigurovaná velikost vyrovnávací paměti pro zásobník (SL_BT_CONFIG_BUFFER_SIZE) příliš malá pro případ použití aplikace. |
1252462 | Opraven problém se skenerem, kdy kódované pakety rozšířené reklamy nejsou přijímány po vytvoření spojení s nekódovaným PHY. |
1254794 | Opraven poškozený paket odesílaný při spouštění šifrování při současném streamování dat v hlučném prostředí. |
1256359 | Snížené využití paměti při zpracování zpráv ATT. Nyní je požadavek ATT, odpověď nebo zpráva o aktualizaci stavu doručena vrstvě BGAPI bez dalšího přidělování paměti. |
1257056 | Vylepšená stabilita ESL C lib v případě neočekávaných ztrát spojení. |
1257110 | Zákazníkem hlášený problém s chybějícím příznakem linkeru pod msys2/mingw64 byl vyřešen. |
1258764 | Opraven problém v plánovači připojení s podporou PAwR, který způsoboval nežádoucí posun v poli posunu okna paketu požadavku na připojení. |
ID # | Popis |
1262944 | Opraven problém, který bránil komponentě adaptivního frekvenčního přeskakování v přesném sledování konfigurace parametru cooldown. |
1267946 | Opraven problém se sestavením „bt_abr_ncp_initiator“ pro vlastní nástěnky. |
1268312 | Opraven problém v plánovači připojení s podporou PAwR, který způsoboval, že se některá připojení překrývala s paketem PAwR Sync Indication. |
1275210 | Opraven problém, který zabraňoval úspěšným připojením založeným na PAwR po hodině provozu, kdy byla spuštěna pouze úloha PAwR. |
Opraveno ve verzi 7.0.1.0
ID # | Popis |
1222271 | Opraven problém ve vrstvě spojení Bluetooth, kdy PAwR zablokoval plánovač úloh při pokusu o odeslání žádosti o připojení těsně po provedení jiné úlohy. |
1231551 | Opraven problém v Bluetooth Link Layer, který nesprávně vypočítal počet kanálů pro aktualizaci s podepsaným časovým posunem ve funkci analyzátoru připojení. |
1232169 | Aplikace ABR lze nyní vytvářet pro díly BG24 a MG24. |
1233996 | Opraven problém s dodržováním GATT, když se v aplikaci nenachází komponenta klienta GATT. Problém byl v tom, že zásobník Bluetooth reaguje na ATT_HANDLE_VALUE_IND chybou, když vzdálený server GATT odešle nevyžádanou indikaci GATT. To je nyní opraveno, takže zásobník Bluetooth bude odpovídat ATT_HANDLE_VALUE_IND s ATT_HANDLE_VALUE_CFM.
Tento problém se nevyskytuje, když je v aplikaci přítomna součást funkce klienta GATT. |
1236361 | Opraven problém ve vrstvě spojení Bluetooth, který způsoboval vážné selhání zařízení, když bylo čekající vytvoření připojení zrušeno těsně před odesláním paketu indikace připojení. |
1240181 | Opraven problém ve vrstvě spojení Bluetooth, který způsobil, že reklamní paket zaměřený na starší verzi (ADV_DIRECT_IND) měl bajty navíc a nesprávnou délku. |
1245534 | Opraven problém v hostitelském zásobníku Bluetooth pro funkci Privacy, který může způsobit selhání spojení, pokud vzdálené zařízení změní svou rozlišitelnou soukromou adresu (RPA) a RPA je znovu vyřešena před dokončením propojení. |
1248834 | Opraven problém ve vrstvě spojení Bluetooth, který mohl způsobit zablokování mechanismu ukládání do vyrovnávací paměti, když jiné úlohy BLE, jako je skenování, běží současně s reklamní úlohou PAwR. |
1249259 | Opraven problém ve vrstvě spojení Bluetooth, že nenamapovaný kanál není inicializován pro algoritmus výběru kanálu č. 1 ve funkci analyzátoru připojení, což způsobovalo proměnlivé zpoždění zachycení paketu po zahájení procesu analýzy. |
1243489 | Opraveny potenciální úniky paměti v implementaci knihovny klíčů ESL. |
1241153 | Opraven problém v komponentě Simple Communication Interface (UART), který občas způsoboval ztrátu dat v komunikaci hostitele NCP (x86/x64) s cílem NCP (EFR32), což způsobovalo ESL AP Python example zavěsit bez zjevného důvodu během hromadného nasazení ESL. |
1253610 | Opraven problém, který mohl potenciálně způsobit uvíznutí ESL AP při nekonečném pokusu o připojení k blízkým inzerujícím nesynchronizovaným ESL, které jsou spojeny s jinými přístupovými body. |
1231407 | Opravena podmínka nesprávného vymazání při spuštění bt_app_ota_dfu. Nyní má krok čtení a mazání flash úložiště své vlastní stavy, takže lze rozlišit, kdy se skutečně provede mazání nebo se aplikace OTA DFU spustí bez mazání. |
1197438 | Opraven problém v nastavení řízení toku v testu NCP Host example. |
Opraveno ve verzi 7.0.0.0
ID # | Popis |
1077663 | Opraven problém, který mohl způsobit, že některé příkazy Bluetooth byly úspěšné, aniž by byl příkaz skutečně proveden, pokud byl použit RTOS a komponenta Bluetooth na vyžádání a aplikace vydala příkaz Bluetooth, zatímco byl zásobník Bluetooth zastaven. |
1130635 | Opraven problém, který mohl způsobit pád na FreeRTOS, pokud je použita funkce Bluetooth na vyžádání a úloha časovače FreeRTOS byla nakonfigurována tak, aby měla nižší prioritu než úlohy Bluetooth. |
1164357 | Když se klient GATT pokusí o přístup k atributu GATT, který vyžaduje zabezpečení, a spojení není svázané nebo šifrované, byl aktualizován kód chyby z nedostatečné_šifrování na nedostatečné_ověření, jak je uvedeno ve specifikaci Bluetooth. |
ID # | Popis |
1170640 | Opraven spor v klientovi GATT, že výměně ATT MTU bylo možné zabránit, pokud uživatelská aplikace zavolá příkaz klienta GATT, který zase spustí proceduru GATT se vzdáleným serverem GATT v kontextu zpracování událostí sl_bt_evt_connection_opened v režimu SoC. |
1180413 | Opraven problém, který mohl způsobit inverzi priority vláken a snížit spolehlivost připojení Bluetooth s FreeRTOS, pokud byla úloha časovače FreeRTOS nakonfigurována tak, aby měla nižší prioritu než úlohy Bluetooth. |
1192858 | Vylepšené zpracování reklamních sestav přes rozhraní HCI. Nyní je možné konfigurovat maximální počet hlášení reklam ve frontě. To zlepšuje výkon přes pomalé připojení HCI. |
1196365 | Opraven problém pozorovaný u DTM, když se zobrazí komponenta hlídacího časovače. |
1196429 | Optimalizované navázání připojení v konfiguraci DMP. V některých případech nebyl paket zpracován dostatečně rychle, což způsobilo ztrátu spojení. |
1198175 | Opraven výpočet rozšíření okna skeneru PAwR po zmeškaném paketu dílčí události. Přidejte výpočet rozšíření okna bloku odpovědi PAwR do zařízení inzerenta. Oprava je k dispozici v Bluetooth SDK 6.2.0 a novějších. |
1206647 | Opravena chyba ve vrstvě spojení Bluetooth, která byla způsobena nesprávným zpracováním chyby, pokud selhal přenos paketu indikace připojení centrálou. |
1209154 | Opravena chyba, která mohla bránit tomu, aby demo režim fungoval více než jednou v relaci ESL AP. Společnost AP Pyhon sample code nyní neumožňuje změnu režimu, když je aplikace EFR Connect připojena v demo režimu, a nyní je možné dotazovat se na aktuální stav dema přes rozhraní CLI. |
1212515 | Opraven problém v režimu RCP, který způsoboval, že příkaz LE_Set_Periodic_Advertising_Subevent_Data HCI chybně selhal, když byla současně nastavena data pro více dílčích událostí s určitou délkou. Opravte další problém v režimu RCP, který umožňoval neomezeně rezervovat nepoužitelný popisovač připojení, když hostitel nečekal na událost Connection Complete HCI, než zavolal další příkaz LE_Create_Connection. |
1215158 | Postup žádosti o data dílčí události PAwR se nyní striktně řídí základní specifikací. Data poskytnutá hostitelem budou zasílána v daném pořadí a data, která dorazí příliš pozdě, nebudou odeslána v nadcházejícím periodickém inzertním intervalu. |
1216550 | Opravena chyba v příkazu sl_bt_gatt_server_send_user_read_response, že server GATT může přidat více než ATT MTU – 4 počet bajtů jako charakteristickou hodnotu v odpovědi čtení k operačnímu kódu ATT_READ_BY_TYPE_REQ. V dokumentaci tohoto příkazu je také stanoveno, že maximální počet bajtů v odpovědi na operační kód ATT_READ_BY_TYPE_REQ je ATT MTU – 4. |
1218112 | Opraven spor mezi ukončením připojení a procedurou aktualizace mapy kanálů, který mohl způsobit dvojité uvolnění vyrovnávací paměti. |
1223155 | Opraveno narušení přístupu k paměti v hostitelském zásobníku při zpracování události HCI_LE_Read_Remote_Features_Complete, pokud je popisovač připojení v události neplatný. |
1218866 | Bluetooth RAIL DMP – SoC Empty FreeRTOS/Micrium OS Sample Aplikace jsou nyní k dispozici pro xG28 (BRD4400A/B/C, BRD4401A/B/C). |
1214140 | BLE ESL exampsoubory nyní podporují desky BRD4402B a BRD4403B. |
1212633 | Opraveno iop_create_bl_fileSelhání skriptu s.sh v systému MacOS. |
1209154 | Opravena chyba, která mohla bránit tomu, aby demo režim ESL fungoval více než jednou v relaci AP. AP Python sample code nyní neumožňuje změnu režimu, když je aplikace EFR Connect připojena v demo režimu, zatímco nyní je možné dotazovat se na aktuální stav dema přes rozhraní CLI. |
1205333 | Eliminovala nutnost ručně měnit typ řízení toku UART po vytvoření projektu ESL AP NCP pro řadu podporovaných desek. |
1205317 | Do dokumentu readme ESL AP byl přidán operační kód 0x1F specifický pro dodavatele Silabs pro experimentální funkci přeskočení intervalu PAwR ESL. |
1192305 | Do komponenty In-Place OTA DFU byla přidána konfigurovatelná prodleva před uzavřením spojení s centrálním zařízením. Tím jsou vyřešeny problémy procedury s přenosem OTA na místě a nejnovější EFR Connect v2.7.1 nebo novější. |
1225207 | Opravený problém: V ESL C lib může dojít k dereferencování NULL, což vede k selhání ESL AP při konfiguraci velkých sítí. |
1223186 | Opravený app_timer pro OS, aby se použil strop požadované hodnoty na základě frekvence časovače OS, aby fungoval stejným způsobem jako varianta s holou kovem. Rozšířená dokumentace, která popisuje omezení rozlišení a zmiňuje parametry konfigurace frekvence časovače OS, které lze nastavit pro úpravu frekvence časovače (a rozlišení). |
1203408 | Aplikace OTA DFU může vstoupit do nesprávného stavu, pokud aplikace odešle událost sl_bt_evt_gatt_server_user_write_request_id. |
1208252 | Iniciátor nyní uzavře spojení při výstupu. |
1180678 | Zlepšení stability. |
Známé problémy v aktuální verzi
Problémy označené tučně byly přidány od předchozí verze. Pokud jste zmeškali vydání, poslední poznámky k vydání jsou k dispozici na https://www.silabs.com/developers/bluetooth-low-energy na kartě Technické dokumenty.
ID # | Popis | Řešení |
361592 | Událost sync_data nehlásí sílu vysílání. | Žádný |
368403 |
Pokud nastavíte interval CTE na 1, měl by být požadavek CTE odeslán v každém intervalu připojení. Odesílá se ale pouze v každém druhém intervalu připojení. |
Žádný |
641122 |
Komponenta Bluetooth stack neposkytuje konfiguraci pro RF anténu. |
Toto je problém konkrétně pro BGM210P. Jedním z řešení je ruční aktualizace konfigurace v sl_bluetooth_config.h v režimu úprav textu. Pokud se používá OTA s Apploaderem, zahrňte do projektu aplikace komponentu bluetooth_feature_ota_config. Voláním příkazu sl_bt_ota_set_rf_path() nastavte RF cestu pro režim OTA. |
650079 | LE 2M PHY na EFR32[B|M]G12 a EFR32[B|M]G13 nefunguje se smartphony používajícími čip Mediatek Helio kvůli problému s interoperabilitou. | Neexistuje žádné řešení. Při vývoji a testování aplikací se lze odpojení vyhnout deaktivací 2M PHY pomocí sl_bt_connection_set_preferred_phy() nebo sl_bt_connection_set_default_preferred_phy(). |
682198 | Bluetooth stack má problém s interoperabilitou na 2M PHY s Windows PC. | Neexistuje žádné řešení. Při vývoji a testování aplikací se lze odpojení vyhnout deaktivací 2M PHY pomocí sl_bt_connection_set_preferred_phy() nebo sl_bt_connection_set_default_preferred_phy(). |
730692 | Na zařízeních EFR4M|BG7 je pozorována 32-13% chybovost paketů, když je RSSI mezi -25 a -10 dBm. PER je nominální (podle datového listu) nad i pod tímto rozsahem. | Žádný |
756253 | Hodnota RSSI u připojení Bluetooth vrácená rozhraním Bluetooth API je na zařízeních EFR32M|B1, EFR32M|B12, EFR32M|B13 a EFR32M|B21 nesprávná. Na zařízeních EFR32M|B21. Podle měření je asi o 8~10 dBm vyšší než skutečná hodnota. | Nainstalujte komponentu „RAIL Utility, RSSI“ do projektu aplikace. Tato komponenta poskytuje výchozí RSSI offset pro čip, který je aplikován na úrovni RAIL a může pomoci dosáhnout přesnějších měření RSSI. |
845506 | Když je zahrnuta komponenta Bluetooth_feature_afh pro AFH, inicializace funkce vždy povolí AFH. | Chcete-li komponentu zahrnout, ale nepovolit AFH při spouštění zařízení, změňte hodnotu parametru z 1 na 0 ve volání funkce sl_btctrl_init_afh() v sl_bt_stack_init.c. |
1031031 | Změna konfigurace v aplikaci bt_aoa_host_locator má za následek pád aplikace. | Žádný |
1227955 | amazon_aws_soc_mqtt_over_ble a amazon_aws_soc_gatt_server examppo spuštění neinzerují. | Zvyšte configTIMER_TASK_STACK_DEPTH na 600 nebo více v config/FreeRTOSConfig.h v projektu. |
Zastaralé položky
Zastaralé ve verzi 7.0.0.0
Příkaz sl_bt_connection_get_rssi
Odebrané položky
Odebráno z verze 7.0.0.0
ID # | Popis |
1219750 | Vizualizační skript HADM založený na Pythonu byl odstraněn. Zákazníci by měli v budoucnu používat grafické uživatelské rozhraní Studio HADM. |
Multiprotokolová brána a RCP
7.1 nové položky
Přidáno ve verzi 7.0.0.0
Současný poslech, schopnost zásobníků Zigbee a OpenThread pracovat na nezávislých kanálech 802.15.4 při použití EFR32xG24 nebo xG21 RCP, je uvolněna. Souběžný poslech není k dispozici pro kombinaci 802.15.4 RCP/Bluetooth RCP, kombinaci Zigbee NCP/OpenThread RCP ani pro systém Zigbee/OpenThread system-on-chip (SoC). K těmto produktům bude přidán v budoucí verzi.
Rozšíření dodavatele OpenThread CLI bylo přidáno do hostitelských aplikací OpenThread multiprotokolových kontejnerů. To zahrnuje příkazy coex cli.
NIKDY vylepšení
Změněno ve verzi 7.0.0.0
Multiprotokolová kombinace Zigbee NCP/OpenThread RCP je nyní výrobní kvalitou. Tato sampTato aplikace není podporována na zařízeních Series-1 EFR.
7.3 Opravené problémy
Opraveno ve verzi 7.3.0.0
ID # | Popis |
1275378 | Opraven problém, kdy volání emberRadioSetSchedulerPriorities() před emberInit() mohlo vést k selhání (Jiné ref: 1381882). |
1361436 | Opraven problém, který způsoboval, že se aplikaci dmp_gp_proxy (s přidaným CLI) nepodařilo včas připojit k síti. |
1363050 | Inicializace zásobníku Zigbee již neaktivuje rádio (nebo RCP pro zásobníky hostitelů) před voláním rozhraní API zásobníku aplikací. Tím se zabrání nechtěné operaci multi-PAN na kanálu 11 (výchozí kanál) při použití konfigurace RCP s podporou multi-PAN. |
1365665 | Opraven problém, kdy hostitel hlásil přijetí paketu s neplatným kontrolním součtem na koncovém bodě 12. (Jiné ref: 1366154) |
1392787 | Opraven problém, který způsoboval, že se Zigbeed nerestartoval při provádění akce Zálohování a obnovení důvěryhodného centra Reset Node. |
1405226 | Opraven problém s migrací projektu a zahrnuto pravidlo upgradu projektu OT, aby odráželo novější změny SDK. Upozorňujeme, že když zákazníci upgradují svůj projekt Multiprotocol, fileNapříklad app.c bude nutné ručně portovat, aby odrážel novější změny SDK. |
Opraveno ve verzi 7.2.2.0
ID # | Popis |
1328799 | Měkký reset spuštěný příkazem Spinel RESET nyní vymaže vyrovnávací paměti 15.4 RCP. |
1337101 | Neúplné přenosové operace 15.4 (Tx čekání na potvrzení, Tx potvrzení jako odpověď na zprávu atd.) již nejsou předčasně považovány za neúspěšné při přerušení rádia v důsledku DMP. To umožňuje, aby byla dané operaci dána příležitost k přeplánování po přerušení nebo trvalém selhání ze strany RAIL (chybové události stavu plánovače).
(Další ref.: 1339032) |
1337228 | V Zigbeed je nyní tick API halCommonGetInt32uMillisecondTick() aktualizováno tak, aby používalo MONOTONICKÉ hodiny, takže není ovlivněno NTP v hostitelském systému. (Další ref.: 1339032) |
1346785 | Opraven spor, který mohl způsobit, že souběžný poslech na 802.15.4 RCP byl zakázán, když oba protokoly vysílaly současně. (Další ref: 1349176) |
1346849 | Přidání komponenty rail_mux do projektu nyní způsobí, že se automaticky sestaví s přidruženými variantami knihovny zásobníku. (Další ref.: 1349102) |
Opraveno ve verzi 7.1.2.0
ID # | Popis |
1184065 | Snížená paměť RAM pro zigbee_ncp-ot_rcp-spi a zigbee_ncp-ot_rcp_uart na MG13 a MG21. |
1282264 | Opraven problém, který mohl přerušit operace rádiového přenosu předčasným vymazáním vysílacího fifo způsobující podtečení. |
1292537 | Aplikace DMP Zigbee-BLE NCP se nyní správně zobrazuje v uživatelském rozhraní Simplicity Studio. (Další ref.: 1292540) |
1230193 | Opraven problém s nesprávným typem uzlu při připojování k síti na koncovém zařízení. (Další ref: 1298347) |
1332330 | Opraven problém, kdy RCP 15.4+BLE pracující v prostředí se silným síťovým provozem mohl občas narazit na spor, který by mu znemožnil odesílat zprávy až do CPCd, dokud se zařízení nerestartuje. (Další ref: 1333156) |
Opraveno ve verzi 7.1.0.0
ID # | Popis |
1022972 | Přidán koexistenční plugin zpět do Zigbee-OpenThread NCP/RCP sample aplikace. |
1231021 | Vyhněte se tvrzení v OTBR, které bylo pozorováno při připojování 80+ zigbee zařízení, a to obnovením RCP spíše než předáním nezpracovaných chyb přenosu do sub mac. |
1249346 | Byl vyřešen problém, kdy RCP mohlo nesprávně vyřadit pakety určené pro hostitele, což vedlo k chybě analýzy v OTBR a neočekávanému ukončení. |
Opraveno ve verzi 7.0.1.0
ID # | Popis |
1213701 | zigbeed neumožnil vytvoření položky zdrojové identifikační tabulky pro potomka, pokud nepřímá fronta MAC obsahuje data pro tohoto potomka již čekající na vyřízení. Toto chování by mohlo vést k selhání transakcí aplikační vrstvy mezi podřízeným zařízením a některým jiným zařízením kvůli nedostatku APS Ack nebo odezvy aplikační vrstvy, zejména narušení a neočekávané ukončení upgradů ZCL OTA zaměřených na podřízené zařízení. |
1244461 | Záznam zdrojové identifikační tabulky pro dítě bylo možné odstranit navzdory čekajícím zprávám. |
Opraveno ve verzi 7.0.0.0
ID # | Popis |
1081828 | Problém s propustností u Zigbee/BLE DMP s FreeRTOSample aplikace. |
1090921 | Z3GatewayCpc měl potíže s vytvořením sítě v hlučném prostředí. |
1153055 | Aserence na hostiteli byla způsobena, když došlo k selhání komunikace při čtení verze NCP ze souboru zigbee_ncp-ble_ncp-uart sampaplikace. |
1155676 | 802.15.4 RCP zahodil všechny přijaté unicast pakety (po potvrzení MAC), pokud více rozhraní 15.4 sdílelo stejné 16bitové ID uzlu. |
1173178 | Hostitel falešně hlásil stovky paketů přijatých pomocí mfglib v nastavení Host-RCP. |
1190859 | Chyba EZSP při odesílání náhodných paketů mfglib v nastavení Host-RCP. |
ID # | Popis |
1199706 | Výzvy dat od zapomenutých potomků koncových zařízení správně nenastavovaly čekající rámec na RCP pro zařazení příkazu Leave & Rejoin k bývalému dítěti. |
1207967 | Příkaz „mfglib send random“ odesílal další pakety na Zigbeed. |
1208012 | Režim mfglib rx neaktualizoval správně informace o paketech při příjmu na RCP. |
1214359 | Uzel koordinátora selhal, když se 80 nebo více směrovačů pokusilo připojit současně v nastavení Host-RCP. |
1216470 | Po předání vysílání pro masku adresy 0xFFFF by Zigbee RCP jednající jako nadřazené zařízení ponechalo nevyřízený datový příznak nastavený pro každého potomka. To vedlo k tomu, že každé dítě zůstalo vzhůru a očekávalo data po každém dotazování a vyžadovalo to nějakou další nevyřízenou datovou transakci do každého koncového zařízení, aby se tento stav nakonec vymazal. |
7.4 Známé problémy v aktuální verzi
Problémy označené tučně byly přidány od předchozí verze. Pokud jste zmeškali vydání, poslední poznámky k vydání jsou k dispozici na https://www.silabs.com/developers/gecko-software-development-kit.
ID # | Popis | Řešení |
937562 | Příkaz Bluetoothctl „reklamovat na“ selže s aplikací rcp-uart-802154-blehci na Raspberry Pi OS 11. | Místo bluetoothctl použijte aplikaci btmgmt. |
1074205 | CMP RCP nepodporuje dvě sítě na stejném PAN id. | Pro každou síť použijte různá ID PAN. Podpora je plánována v budoucí verzi. |
1122723 | V rušném prostředí může CLI přestat reagovat v aplikaci z3-light_ot-ftd_soc. | Žádné známé řešení. |
1124140 | z3-light_ot-ftd_soc sampAplikace není schopna vytvořit síť Zigbee, pokud je síť OT již aktivní. | Nejprve spusťte síť Zigbee a poté síť OT. |
1170052 | CMP Zigbee NCP + OT RCP a DMP Zigbee NCP + BLE NCP se v tomto aktuálním vydání nemusí vejít na 64KB a nižší části RAM. (Další ref.: 1393057) | Části 64KB RAM se nedoporučují pro aplikace NCP + RCP. |
1209958 | ZB/OT/BLE RCP na MG24 může přestat fungovat po několika minutách při spuštění všech tří protokolů. | Bude řešeno v budoucí verzi. |
1221299 | Hodnoty RSSI Mfglib se mezi RCP a NCP liší. | Bude řešeno v budoucí verzi. |
1334477 | Několikanásobné spuštění a zastavení zásobníku BLE může způsobit, že zásobník BLE nebude moci znovu spustit reklamu na zařízeních EFR Series 64 řady 1 s nízkou RAM v DMP Zigbee-BLE sample aplikace. | N/A |
7.5 Zastaralé položky
Žádný
7.6 Odebrané položky
Odstraněno ve verzi 7.0.0.0
Makro „NONCOMPLIANT_ACK_TIMING_WORKAROUND“ bylo odstraněno. Všechny aplikace RCP nyní ve výchozím nastavení podporují 192 µs pro nevylepšená acks, zatímco stále používají 256 µs pro vylepšená acks vyžadovaná CSL.
Použití této verze
Toto vydání obsahuje následující
- Silicon Labs Bluetooth stack knihovna
- Bluetooth sample aplikace
Další informace o sadě Bluetooth SDK viz https://docs.silabs.com/bluetooth/latest/ . Pokud s Bluetooth začínáte, přečtěte si UG103.14: Bluetooth LE Fundamentals.
8.1 Instalace a použití
Bluetooth SDK je poskytován jako součást Gecko SDK (GSDK), sady SDK Silicon Labs. Chcete-li rychle začít s GSDK, nainstalujte Simplicity Studio 5, které nastaví vaše vývojové prostředí a provede vás instalací GSDK. Simplicity Studio 5 obsahuje vše potřebné pro vývoj produktů IoT se zařízeními Silicon Labs, včetně spouštěče zdrojů a projektů, softwarových konfiguračních nástrojů, plného IDE s GNU toolchain a analytických nástrojů. Pokyny k instalaci jsou uvedeny v online příručce Simplicity Studio 5 User's Guide.
Alternativně lze Gecko SDK nainstalovat ručně stažením nebo klonováním nejnovější verze z GitHubu. Vidět https://github.com/SiliconLabs/gecko_sdk pro více informací.
Simplicity Studio standardně nainstaluje GSDK do:
- (Windows): C:\Users\ \SimplicityStudio\SDKs\gecko_sdk
- (MacOS): /Users/ /SimplicityStudio/SDKs/gecko_sdk
Dokumentace specifická pro verzi SDK je nainstalována se sadou SDK. Další informace lze často nalézt v článcích znalostní báze (KBA). Reference API a další informace o tomto a dřívějších vydáních jsou k dispozici na https://docs.silabs.com/.
8.2 Bezpečnostní informace
Bezpečná integrace Vault
Při nasazení do zařízení Secure Vault High jsou citlivé klíče, jako je Long Term Key (LTK), chráněny pomocí funkce Secure Vault Key Management. Níže uvedená tabulka ukazuje chráněné klíče a jejich charakteristiky ochrany úložiště.
Zabalený klíč | Exportovatelné / Neexportovatelné |
Poznámky |
Dálkový dlouhodobý klíč (LTK) | Neexportovatelné | |
Místní dlouhodobý klíč (pouze starší verze) | Neexportovatelné | |
Remote Identity Resolving Key (IRK) | Exportovatelné | Musí být exportovatelné z důvodu budoucí kompatibility |
Klíč pro rozpoznání místní identity | Exportovatelné | Musí být exportovatelné, protože klíč je sdílen s jinými zařízeními. |
Zabalené klíče, které jsou označeny jako „Neexportovatelné“, lze použít, ale nikoli viewed nebo sdílené za běhu.
Zabalené klíče, které jsou označeny jako „Exportovatelné“, lze používat nebo sdílet za běhu, ale zůstávají zašifrované, dokud jsou uloženy ve flashi.
Další informace o funkci správy klíčů zabezpečeného trezoru viz AN1271: Zabezpečené úložiště klíčů.
Bezpečnostní upozornění
Chcete-li se přihlásit k odběru bezpečnostních rad, přihlaste se na zákaznický portál Silicon Labs a vyberte Domovská stránka účtu. Kliknutím na DOMŮ přejděte na domovskou stránku portálu a poté klikněte na dlaždici Spravovat oznámení. Ujistěte se, že je zaškrtnuto 'Software/Security Advisory Notices & Product Change Notices (PCN)' a že jste přihlášeni minimálně pro svou platformu a protokol. Klepnutím na tlačítko Uložit uložte změny.
Následující obrázek je exampten:
8.3 Podpora
Zákazníci sady Development Kit mají nárok na školení a technickou podporu. Použijte Silicon Labs Bluetooth LE web na stránce získáte informace o všech produktech a službách Bluetooth společnosti Silicon Labs a přihlásíte se k podpoře produktu.
Podporu Silicon Laboratories můžete kontaktovat na adrese http://www.silabs.com/support.
Studio jednoduchosti
Přístup jedním kliknutím k MCU a bezdrátovým nástrojům, dokumentaci, softwaru, knihovnám zdrojového kódu a dalším. K dispozici pro Windows, Mac a Linux!
![]() |
![]() |
![]() |
![]() |
www.silabs.com/IoT | www.silabs.com/simplicity | www.silabs.com/quality | www.silabs.com/community |
Zřeknutí se odpovědnosti
Silicon Labs má v úmyslu poskytovat zákazníkům nejnovější, přesnou a hloubkovou dokumentaci všech periferií a modulů dostupných pro implementátory systémů a softwaru, kteří používají nebo hodlají používat produkty Silicon Labs. Charakterizační údaje, dostupné moduly a periferie, velikosti paměti a adresy paměti se vztahují ke každému konkrétnímu zařízení a poskytnuté „typické“ parametry se mohou v různých aplikacích lišit a mění se. Aplikace exampzde popsané texty slouží pouze pro ilustrativní účely. Společnost Silicon Labs si vyhrazuje právo provádět změny bez dalšího upozornění v informacích o produktech, specifikacích a popisech zde uvedených a neposkytuje žádné záruky na přesnost nebo úplnost obsažených informací. Bez předchozího upozornění může společnost Silicon Labs aktualizovat firmware produktu během výrobního procesu z důvodů bezpečnosti nebo spolehlivosti. Takové změny nezmění specifikace ani výkon produktu. Silicon Labs nenese žádnou odpovědnost za důsledky použití informací uvedených v tomto dokumentu. Tento dokument neimplikuje ani výslovně neuděluje žádnou licenci k navrhování nebo výrobě jakýchkoli integrovaných obvodů. Produkty nejsou navrženy ani schváleny k použití v zařízeních třídy III FDA, aplikacích, pro které je vyžadováno schválení FDA před uvedením na trh, nebo v systémech podpory života bez konkrétního písemného souhlasu Silicon Labs. „Systém podpory života“ je jakýkoli produkt nebo systém určený k podpoře nebo udržení života a/nebo zdraví, u kterého lze důvodně předpokládat, že pokud selže, povede k vážnému zranění nebo smrti. Produkty Silicon Labs nejsou navrženy ani schváleny pro vojenské aplikace. Produkty Silicon Labs se za žádných okolností nesmějí používat ve zbraních hromadného ničení, včetně (ale nejen) jaderných, biologických nebo chemických zbraní nebo střel schopných takové zbraně nést. Silicon Labs se zříká všech výslovných a předpokládaných záruk a nenese odpovědnost za jakákoli zranění nebo škody související s používáním produktu Silicon Labs v takových neautorizovaných aplikacích.
Informace o ochranných známkách Silicon Laboratories Inc.®, Silicon Laboratories®, Silicon Labs®, SiLabs® a logo Silicon Labs®, Bluegiga®, Bluegiga Logo®, EFM®, EFM32®, EFR, Ember®, Energy Micro, Energy Micro®, logo Energy Micro® a jejich kombinace, nejvíce přívětivé energetické značky „the microcontrollers world's WiSeConnect, n-Link, EZLink®, EZRadio®, EZRadioPRO®, Gecko®, Gecko OS, Gecko OS Studio, Precision32®, Simplicity Studio®, Telegesis, Logo Telegesis®, USBXpress®, Zentri, logo Zentri a Z-WaDMS jsou registrované ochranné známky, Z-Wa DMS a další registrované ochranné známky. Silicon Labs. ARM, CORTEX, Cortex-M3 a THUMB jsou ochranné známky nebo registrované ochranné známky společnosti ARM Holdings. Keil je registrovaná ochranná známka společnosti ARM Limited. Wi-Fi je registrovaná ochranná známka sdružení Wi-Fi Alliance. Všechny ostatní produkty nebo názvy značek zde uvedené jsou ochrannými známkami příslušných vlastníků.
Silicon Laboratories Inc.
400 West Cesar Chavez
Austin, TX 78701
USA
www.silabs.com
Dokumenty / zdroje
![]() |
SILICON LABS Gecko SDK Suite Bluetooth hardware a software [pdfUživatelská příručka 7.3.0.0, 7.2.0.0, 7.1.2.0, Gecko SDK Suite Bluetooth hardware a software, Suite Bluetooth hardware a software, Bluetooth hardware a software, software |