Software SILICON LABS Bluetooth LE SDK

Datum vydání: 5. září 2023

Informace o produktu

Gecko SDK Suite 3.2 je sada pro vývoj softwaru (SDK) poskytovaná společností Silicon Labs. Je navržen tak, aby usnadnil vývoj aplikací Bluetooth a nabízí různé funkce a nástroje pro vylepšení procesu vývoje.

Klíčové vlastnosti:

• Oznámení o kompatibilitě a použití
• Kompatibilní kompilátory

Oznámení o kompatibilitě a použití:

Sada SDK poskytuje upozornění na kompatibilitu a použití, aby bylo zajištěno správné používání a zabezpečení softwaru. Aktualizace zabezpečení a upozornění najdete v kapitole Zabezpečení v poznámkách k vydání platformy Gecko nainstalované s touto sadou SDK nebo navštivte stránku Poznámky k vydání Silicon Labs. Pro aktuální informace se doporučuje přihlásit se k odběru bezpečnostních rad. Pokyny k používání funkcí Secure Vault nebo pokud jste noví se sadou Silicon Labs Bluetooth SDK, naleznete v části „Použití této verze“.

Kompatibilní kompilátory:

Sada G ecko SDK Suite 3.2 je kompatibilní s následujícím kompilátorem:

• GCC (The GNU Compiler Collection) verze 10.2.0, dodávaná se Simplicity Studio.

Vylepšení:

Ve verzi 3.2.9.0 byla provedena následující vylepšení:

• Změněná API

Nové předměty:

V předchozích verzích byly přidány následující nové funkce:

Vydání 3.2.4.0:

• Hostitel založený na Pythonu Examples: hostitel založený na Pythonu examplesy k použití
  s pyBGAPI jsou nyní k dispozici. Najdete je na https://github.com/SiliconLabs/pybgapi-examples.

Vydání 3.2.0.0:

• Rozhraní hostitelského řadiče Bluetooth: Nyní je podporováno rozhraní hostitelského řadiče Bluetooth. Další informace naleznete v části AN1328: Povolení rádiového koprocesoru pomocí funkce Bluetooth HCI.
• Dynamická databáze GATT: Databázi GATT na serveru GATT lze nyní vytvářet a spravovat dynamicky pomocí rozhraní Bluetooth API. Chcete-li použít tuto funkci, zahrňte komponentu „bluetooth_feature_dynamic_gattdb“. Další podrobnosti naleznete v dokumentaci ke komponentám a konfiguraci a v referenční příručce k rozhraní Bluetooth API.
• Simultánní skenování: Bluetooth stack nyní podporuje simultánní skenování na LE 1M a Coded PHY. Tato funkce vyžaduje hardwarovou podporu a je dostupná pouze na určitých zařízeních.
• Protokolování propustnosti: Hostitelské aplikace NCP nyní podporují protokolování propustnosti aplikace. Pro aktivaci této funkce použijte volbu „-l“. Hodnota propustnosti je uložena ve formátu CSV a jednou za minutu se zapisuje záznam.
• pyBGAPI: Knihovna pyBGAPI, která implementuje protokol BGAPI v Pythonu, je nyní vydána na pypi.org. Najdete ho na https://pypi.org/project/pybgapi/.
• Nové nástroje pro vývoj úhlu příjezdu (AoA): Sada SDK obsahuje analyzátor AoA, nový 3D grafický nástroj integrovaný do aplikace Studio pro vyhodnocení výpočtu AoA pomocí jednoho lokátoru a několika tags. Tento nástroj nahrazuje předchozí aplikaci AoA Compass Demo.

KLÍČOVÉ VLASTNOSTI

• Podpora Bluetooth HCI
• Simultánní skenování na 1M a Coded-PHY
• Dynamická konfigurace GATT
• Vydání pyBGAPI na pypi.org
• Nové nástroje pro vývoj Angle-of-Arrival

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. Core SDK je pokročilý stack kompatibilní s Bluetooth 5.2, 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 jejich aplikace přímo na SoC, nebo režim NCP umožňující použití externího hostitelského MCU.

Tyto poznámky k vydání se týkají verzí sady SDK:

• 3.2.9.0 vydáno 5. září 2023 (pouze základní změny platformy)
• 3.2.8.0 vydáno 13. července 2023 (podpora pro EFR32xG21, revize C a novější)
• 3.2.6.0 vydáno 29. března 2023 (podpora části pro časný přístup)
• 3.2.5.0 vydáno 11. ledna 2023 (podpora části pro časný přístup)
• 3.2.4.0 vydáno 13. října 2021
• 3.2.3.0 vydáno 24. září 2021
• 3.2.2.0 vydáno 8. září 2021
• 3.2.1.0 vydáno 21. července 2021
• 3.2.0.0 vydáno 16. června 2021

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ých s touto sadou SDK nebo na stránce Poznámky k vydání Silicon Labs. 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 8.50.9

• 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 10.2.0, dodávaná se Simplicity Studio.

Nové položky

Nové funkce

Přidáno ve verzi 3.2.4.0

Hostitel založený na Pythonu Examples
Hostitel založený na Pythonu, napřampsoubory pro použití s ​​pyBGAPI jsou nyní k dispozici (https://github.com/SiliconLabs/pybgapi-examples).

Přidáno ve verzi 3.2.0.0

Rozhraní hostitelského řadiče Bluetooth
Počínaje tímto vydáním je podporováno rozhraní hostitelského řadiče Bluetooth. Viz AN1328: Povolení rádiového koprocesoru pomocí funkce Bluetooth HCI.

Dynamická databáze GATT
Na serveru GATT lze databázi GATT vytvářet a spravovat dynamicky pomocí rozhraní Bluetooth API. Chcete-li použít tuto funkci, zahrňte
komponenta bluetooth_feature_dynamic_gattdb. Viz dokumentaci ke komponentám a konfiguraci a referenční informace k rozhraní Bluetooth API.

Simultánní skenování
Bluetooth stack podporuje simultánní skenování na LE 1M a Coded PHY. Tato funkce vyžaduje hardwarovou podporu a je dostupná pouze na určitých zařízeních.

Nový Přample Aplikace

• Bluetooth – NCP (s podporou Dynamic GATT): Doporučeno místo Bluetooth – NCP Empty, které bylo zastaralé.
• Bluetooth – RCP
• Bluetooth – SoC Blinky
• Bluetooth – SoC Light Standard DMP a Bluetooth – SoC Empty Standard DMP pro EFRG32[B|M]G21 \
• Bluetooth – propustnost SoC
• Bluetooth – Test interoperability SoC: Pouze demo binární, žádný zdroj

Záznam propustnosti

Hostitelské aplikace NCP podporují protokolování propustnosti aplikace. Chcete-li tuto funkci povolit, použijte volbu -l. Hodnota propustnosti je uložena ve formátu CSV. Záznam protokolu se zapisuje jednou za minutu.

pyBGAPI
Knihovna pyBGAPI implementující protokol BGAPI v Pythonu je vydána na pypi.org (https://pypi.org/project/pybgapi/).

Nové nástroje pro vývoj úhlu příjezdu (AoA).
AoA Analyzer: Nový 3D grafický nástroj integrovaný do aplikace Studio pro rychlé vyhodnocení výpočtu AoA pomocí jednoho lokátoru a více tags. Tento nástroj nahrazuje předchozí aplikaci AoA Compass Demo.
AoA Configurator: Nový 3D grafický nástroj, který zákazníkům pomůže vytvořit platnou konfiguraci více lokátorů file pro případy použití s ​​více lokátory.

Nová API
Další dokumentaci a popis příkazů najdete v odkazu Bluetooth API v instalaci SDK nebo v online odkazu na API specifické pro verzi SDK, kterou používáte. Nejaktuálnější verze je na https://docs.silabs.com/bluetooth/latest/.

Přidáno ve verzi 3.2.0.0

• Příkaz sl_bt_connection_read_remote_used_features: Čtení funkcí linkové vrstvy podporovaných vzdáleným zařízením.
• Událost sl_bt_evt_connection_remote_used_features: Označuje funkce linkové vrstvy podporované vzdáleným zařízením.
• Příkaz sl_bt_gatt_server_read_client_supported_features: Přečtěte si funkce podporované klientem GATT.
• Příkaz sl_bt_gattdb_new_session: Spusťte novou relaci aktualizace databáze GATT.
• Příkaz sl_bt_gattdb_add_service: Přidání služby do databáze GATT.
• Příkaz sl_bt_gattdb_remove_service: Odebere službu z databáze GATT.
• Příkaz sl_bt_gattdb_add_included_service: Přidejte atribut zahrnuté služby do služby.
• Příkaz sl_bt_gattdb_remove_included_service: Odebrání atributu zahrnuté služby ze služby.
• Příkaz sl_bt_gattdb_add_uuid16_characteristic: Přidejte do služby 16bitovou charakteristiku UUID.
• Příkaz sl_bt_gattdb_add_uuid128_characteristic: Přidejte do služby 128bitovou charakteristiku UUID.
• Příkaz sl_bt_gattdb_remove_characteristic: Odebere charakteristiku ze služby.
• Příkaz sl_bt_gattdb_add_uuid16_descriptor: Přidejte do charakteristiky 16bitový deskriptor UUID.
• Příkaz sl_bt_gattdb_add_uuid128_descriptor: Přidejte do charakteristiky 128bitový deskriptor UUID.
• Příkaz sl_bt_gattdb_remove_descriptor: Odebere deskriptor z charakteristiky.
• Příkaz sl_bt_gattdb_start_service: Spusťte službu tak, aby byla viditelná pro vzdálené klienty GATT.
• Příkaz sl_bt_gattdb_stop_service: Zastaví službu, aby se stala neviditelnou pro vzdálené klienty GATT.
• Příkaz sl_bt_gattdb_start_characteristic: Spustí charakteristiku tak, aby byla viditelná pro vzdálené klienty GATT.
• Příkaz sl_bt_gattdb_stop_characteristic: Zastaví charakteristiku, aby se stala neviditelnou pro vzdálené klienty GATT.
• Příkaz sl_bt_gattdb_commit: Uložte všechny změny provedené v aktuální relaci do databáze GATT a zavřete relaci. Příkaz sl_bt_gattdb_abort: Zruší všechny změny provedené v aktuální relaci GATT
• databázi a zavřete relaci.
• Příkaz sl_bt_sm_get_bonding_handles: Získejte úchyty v databázi spojení.
• Příkaz sl_bt_sm_get_bonding_details: Získejte podrobné informace o lepení.
• Příkaz sl_bt_sm_find_bonding_by_address: Najděte informace o spojení podle adresy zařízení Bluetooth.
• Příkaz sl_bt_sm_set_legacy_oob: Nastavte data OOB pro starší párování.
• Příkaz sl_bt_sm_set_oob: Povolí použití dat OOB pro párování zabezpečených připojení.
• Příkaz sl_bt_sm_set_remote_oob: Nastavte data OOB a potvrzovací hodnoty přijaté ze vzdáleného zařízení pro párování zabezpečeného připojení.
• Konfigurace SL_BT_COMPONENT_CONNECTIONS: může být použita komponentou ke konfiguraci množství připojení Bluetooth, které navíc potřebuje.

Vylepšení

Změněná API

Změněno ve verzi 3.2.2.0

• Příkaz sl_bt_gap_set_privacy_mode(): Když je tímto příkazem povolen režim soukromí, adresy inzerentů nastavené pomocí příkazu sl_bt_advertiser_set_random_address() již nejsou automaticky aktualizovány zásobníkem. Pro každého inzerenta, který používá identifikační adresu zařízení, zásobník pravidelně generuje novou řešitelnou nebo neřešitelnou soukromou adresu v režimu soukromí.
• Příkaz sl_bt_advertiser_set_configuration(): Byla přidána nová konfigurační položka (hodnota 16), která inzerentovi umožňuje používat adresu globální identity zařízení v režimu soukromí. Tato konfigurace nemá žádný vliv, pokud byla adresa inzerenta nastavena uživatelskou aplikací pomocí příkazu sl_bt_advertiser_set_random_address().
• Příkaz sl_bt_sm_configure(): Nová možnost výběru, zda má párování preferovat pouze funkční nebo ověřené párování, když jsou na základě nastavení možné obě možnosti.

Změněno ve verzi 3.2.1.0
Příkaz sl_bt_gattdb_commit(): Dříve zásobník odstraňoval konfigurace charakteristických vlastností všech klientů GATT kromě konfigurace změněné službou, když byla změněna místní databáze GATT. Toto chování bylo změněno tak, že pro připojené klienty GATT zásobník odstraňuje pouze konfigurace odebraných charakteristik.

Změněno ve verzi 3.2.0.0

• Konfigurace SL_BT_CONFIG_MAX_CONNECTIONS: Přesunuto do konfigurace komponenty bluetooth_feature_connection file sl_bluetooth_connection_config.h.
• Konfigurace SL_BT_CONFIG_USER_ADVERTISERS: Přesunuto do konfigurace komponenty bluetooth_feature_advertiser file sl_bluetooth_advertiser_config.h.
• Konfigurace SL_BT_CONFIG_MAX_PERIODIC_ADVERTISING_SYNC: Přesunuto do konfigurace komponenty bluetooth_feature_sync file sl_bluetooth_periodic_sync_config.h.
• UUID služby CTE: hodnoty jsou aktualizovány podle specifikace Bluetooth SIG.

Opravené problémy

Opraveno ve verzi 3.2.4.0

ID #	Popis
735638	Opravte narušení přístupu do paměti při zavírání připojení Bluetooth, pokud je Security Manager neinicializovaný (tj. komponenta bluetooth_feature_sm není používána). Porušení nezpůsobilo žádný známý problém s funkčností ve vydaných verzích SDK.
736501	Přidejte soubor app_properties.c file do RCP example projekty pro podporu aktualizací firmwaru.
737292	Opravte problém, který způsobuje selhání navazování připojení a skenování na LE Coded PHY na zařízeních EFR32[B|M]G21.
740185	Opravte narušení přístupu do paměti při ukončení připojení Bluetooth, u kterého se nezdařila operace propojení. Porušení nezpůsobilo žádný známý problém s funkčností ve vydaných verzích SDK.
740421	Ovladač Bluetooth nyní odesílá správný počet bajtů na paket pro všechny intervaly připojení.
741923	Opravte problém, který způsobuje selhání spouštění bootloaderu z rozhraní HCI pomocí příkazu 0xfc18 specifického pro dodavatele.

Opraveno ve verzi 3.2.3.0

ID #	Popis
738646	Opravte únik paměti, ke kterému dochází při otevření připojení Bluetooth. Problém byl poprvé představen v Bluetooth SDK 3.2.0.

Opraveno ve verzi 3.2.2.0

ID #	Popis
683223	Opravte problém, že hodnota výkonu TX předaná příkazu sl_bt_test_dtm_tx_v4() nemá žádný účinek při testování režimu nemodulované nosné.
708049	Opravte problém, že příkazy DTM pro přenos nemodulované nosné vlny nefungují před použitím příkazu DTM TX pro modulovaný signál.
714913	Opravte problém s plánováním úloh ovladače Bluetooth, který způsobuje odpojení Bluetooth během skenování.
725480	Opravte problém, že se aplikace aoa_locator bez připojení někdy nedaří synchronizovat s a tag.
728452	Opravte problém, že komponenta Bluetooth HCI nereaguje na příkaz HCI reset.
730386	Příkaz LE Read Maximum Data Length HCI nyní vrací správné maximální hodnoty, které řadič podporuje.
731566	Opravte problém se zavěšením úlohy RTOS při zahájení odpojení, když je připojení Bluetooth šifrované.
733857	Bluetooth HCI nyní správně hlásí dokončené pakety ACL hostiteli.

Opraveno ve verzi 3.2.1.0

ID #	Popis
707252	Vylepšení funkce LE Power Control.
712526	Opravte problém s CTE (AoA/AoD), kdy se zařízení může dostat do vážné chyby, pokud bylo před vytvořením připojení povoleno CTE bez připojení nebo Silicon Labs CTE.
714406	Oprava pro LL/DDI/SCN/BV-25-C.
715016	Opravena inicializace LE Power Control.
715286	Nyní se zobrazí chyba při přihlášení k odběru oznámení nebo selhání indikací u vlastností, které je nepodporují.
715414	Opravte problém v HCI, že inzerenty nelze zakázat s nastavením počtu sad na 0 v příkazu LE Set Extended Advertising Enable.
717381	Oprava pro propustnost example aplikace správně zpracovávat indikační data.
718466	Komponenta Bluetooth 'NCP Interface' nyní definuje makro SL_BT_API_FULL, které umožňuje propojení všech tabulek příkazů BGAPI. To potřebují cílové aplikace NCP.
718867	Znovu povolena podpora komponent pro zařazení na seznam povolených pro soc_empty exampaplikace.
723935	Zlepšení propustnosti SoC exampaplikace.

Opraveno ve verzi 3.2.0.0

ID #	Popis
649254	Dříve uživatelské aplikace mohly nastavit TX výkon vyšší než +10dBm, i když není povoleno AFH (Adaptive Frequency Hopping). Bylo opraveno, že maximální použitelná úroveň TX výkonu je správně nastavena a vrácena zpět do uživatelské aplikace, pokud nebylo povoleno AFH.
651247	Dříve zásobník Bluetooth na EFR32MG21 občas nerozpoznal odpojení. Toto je velmi vzácný případ a pravděpodobnost se může zvýšit s větším RF šumem v prostředí. Tento problém byl vyřešen.
679431	Dříve bylo tvrzení DEBUG_EFM spouštěno v zařízeních Series 2 při vytváření aplikace Bluetooth z prázdného projektu. Tento problém již v tomto vydání neexistuje.
686213	Dříve se zásobník Bluetooth občas mohl zaseknout ve věčné smyčce. Předpokládejme, že aplikace má více klientských připojení GATT provádějících simultánní procedury GATT jak z kontextu přerušení časovače spánku, tak z hlavní smyčky aplikace. V tomto případě může výjimečný spor způsobit poškození paměti zásobníku, což zase způsobí selhání spuštění procedury GATT. Problém neexistuje, pokud jsou rozhraní Bluetooth API volána pouze z hlavní smyčky (v režimu holého kovu) nebo úlohy operačního systému (v režimu RTOS). Problém poškození paměti ve výše uvedeném případě použití byl opraven. Příkazy rozhraní Bluetooth API však nelze volat z kontextů přerušení. To může mít za následek další neznámé problémy. Toto je popsáno v UG434: Silicon Labs Příručka vývojáře aplikací Bluetooth® C pro SDK v3.x.
696220	Opravte problém s inicializací, který může způsobit, že jiný protokol používá nesprávné konfigurace RAIL v dynamické aplikaci s více protokoly.
696283	Opravte problém s otevíráním připojení u rozšířeného inzerenta, když je povoleno skenování.
697200	Opravte chybu zápisu v konfiguraci RTOS zásobníku Bluetooth.
698227	Opravte problém, který při zablokování rádia nedokončí úkol v Link Layer. Tento problém se vyskytuje velmi zřídka a mohl by být reprodukovatelný v rušném prostředí s mnoha inzerenty, skenery a připojeními Bluetooth. Řešením problému je zavedení rádiového hlídacího psa (nová komponenta bluetooth_feature_radio_watchdog). Úloha bude přerušena, pokud hlídací pes zjistí, že se rádio zaseklo. Ve výchozím nastavení je tato funkce z důvodu úspory paměti zakázána.
700422	Opravte problém s otevíráním připojení v centrální roli při současném skenování na různých LE PHY.
703303	Opravte obraz firmwaru filepřípona názvu v dokumentaci Bluetooth API sl_bt_dfu_flash_upload.
703613	Opravte varování kompilace pomocí IAR, která souvisí s používáním komponenty mbedTLS v aplikacích Bluetooth.
705969	Nyní lze rádio inicializovat s povoleným VSCALE na zařízeních EFR32[B|M]G22.
708029	Opravte problém s připojením Bluetooth, který byl způsoben závadou na EFR32[B|M]G2[1|2], kdy se Power Manager v určitých situacích nedaří probudit z EM2.
714411	Opravte problém, kdy se CTE bez připojení přenášelo v paketech AUX_ADV_IND i AUX_SYNC_IND. Správné chování je přenášet jej pouze na paketech AUX_SYNC_IND.

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.si-labs.com/products/software.

ID #	Popis	Řešení
337467	MGM12P má slabou sílu signálu při provádění OTA s Apploaderem.	Žádný
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 ne pracovat s chytrými telefony využí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().
695148	Soft timer Bluetooth nefunguje, když je povolena funkce Bluetooth na vyžádání.	Použijte komponentu jednoduchého časovače v sadě Bluetooth SDK nebo službě platformy sleeptimer.
725498	Aplikace aoa_locator založená na připojení někdy selže s chybovou zprávou Selhalo povolení CTE.	Žádný
730692	Na zařízeních EFR4[B|M]G7 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ý

Zastaralé položky

Zastaralé ve verzi 3.2.1.0

• Výčet API sl_bt_gap_phy_type_t
  Tento typ výčtu je nahrazen sl_bt_gap_phy_t.
• Výčet API sl_bt_gap_phy_and_coding_type_t
  Tento typ výčtu je nahrazen sl_bt_gap_phy_coding_t.
  Staré typy jsou stále platné a lze je použít v aplikacích. Doporučuje se co nejdříve migrovat na nové typy. Staré typy budou odstraněny nejpozději do jednoho roku v budoucí hlavní verzi sady SDK.

Zastaralé ve verzi 3.2.0.0

• API příkaz sl_bt_sm_list_bonding_entry
  Tento příkaz je nahrazen příkazy sl_bt_sm_get_bonding_handles a sl_bt_sm_get_bonding_details.
• Příkaz API sl_bt_sm_set_oob_data
  Tento příkaz je nahrazen příkazem sl_bt_sm_set_legacy_oob.
• Příkaz API sl_bt_sm_use_sc_oob
  Tento příkaz je nahrazen příkazem sl_bt_sm_set_oob.
• Příkaz API sl_bt_sm_set_sc_remote_oob_data
  Tento příkaz je nahrazen příkazem sl_bt_sm_set_remote_oob.
• Příkazy API sl_bt_system_set_soft_timer a sl_bt_system_set_lazy_soft_timer
  Bluetooth API neposkytují náhradu. Pro časovače použijte jednoduchou komponentu časovače v sadě Bluetooth SDK nebo službu platformy sleeptimer.

Demo kompasu AoA
Bude odstraněn v budoucím vydání. Toto demo je nahrazeno AoA Analyzerem.

ncp_empty example aplikace
Bude odstraněn v budoucím vydání. Tento example je nahrazeno ncp example.

Odebrané položky

Odstraněno ve verzi 3.2.0.0
BGTool
BGTool je v této verzi odstraněn a nahrazen Bluetooth NCP Commander, který obsahuje moderní, intuitivní, webuživatelské rozhraní a také chytrou konzoli s IntelliSense a vestavěnou dokumentací API.

Použití této verze

Toto vydání obsahuje následující

• Silicon Labs Bluetooth stack knihovna
• Bluetooth sample aplikace

Další informace o Bluetooth SDK viz QSG169: Bluetooth® SDK v3.x Quick Start Guide. Pokud s Bluetooth začínáte, přečtěte si UG103.14: Bluetooth LE Fundamentals.

Instalace a použití
Ke stažení sady Silicon Labs Bluetooth SDK je vyžadován registrovaný účet u Silicon Labs. Registrovat se můžete na https://sili-conlabs.force.com/apex/SL_CommunitiesSelfReg?form=short.
Pokyny k instalaci balíčku jsou uvedeny v online uživatelské příručce Simplicity Studio 5.
Použijte Bluetooth SDK v3.x s vývojovou platformou Silicon Labs Simplicity Studio 5. Simplicity Studio zajišťuje, že většina kompatibility softwaru a nástrojů je spravována správně. Nainstalujte aktualizace softwaru a firmwaru desky ihned po upozornění. Používejte pouze Simplicity Studio 4 s Bluetooth SDK v2.13.xa nižší.
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/.

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 Secure Vault Key Management najdete v AN1271: Secure Key Storage.

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.

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!

• Portfolio IoT
  www.silabs.com/IoT
• SW/HW
  www.silabs.com/simplicity
• Kvalitní
  www.silabs.com/quality
• Podpora a komunita
  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 systémové a softwarové implementátory, 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ůvodu bezpečnosti nebo spolehlivosti. Tyto 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. Poznámka: Tento obsah může obsahovat urážlivou terminologii, která je nyní zastaralá. Silicon Labs nahrazuje tyto termíny inkluzivním jazykem, kdykoli je to možné. Pro více informací navštivte www.silabs.com/about-us/inclusive-lexicon-project

Informace o ochranné známce
Silicon Laboratories Inc.®, Silicon Laboratories®, Silicon Labs®, SiLabs® a logo Silicon Labs®, Bluegiga®, Bluegiga Logo®, EFM®, EFM32®, EFR, Ember®, Energy Micro, logo Energy Micro a jejich kombinace , „Energeticky nejšetrnější mikrokontroléry na světě“, Redpine Signals®, WiSeConnect, n-Link, ThreadArch®, EZLink®, EZRadio®, EZRadioPRO®, Gecko®, Gecko OS, Gecko OS Studio, Precision32®, Simplicity Studio®, Telegesis, Telegesis Logo®, USBXpress®, Zentri, logo Zentri a Zentri DMS, Z- Wave® a další jsou ochranné známky nebo registrované ochranné známky společnosti 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

Software SILICON LABS Bluetooth LE SDK [pdfUživatelská příručka Software Bluetooth LE SDK, Bluetooth LE, software SDK, software

Reference

• Uživatelská příručka