SILICON-LABS-LOGO

SILICON LABS Bluetooth SDK may

SILICON-LABS-Bluetooth-SDK-Mesh-PRODUCT

Bluetooth may se yon nouvo topoloji ki disponib pou aparèy Bluetooth Low Energy (LE) ki pèmèt kominikasyon anpil-a-anpil (m:m). Li optimize pou kreye rezo aparèy gwo echèl epi li se ideyal pou automatisation bilding, rezo detèktè, ak swiv byen yo. Lojisyèl nou yo ak SDK pou devlopman Bluetooth sipòte Bluetooth Mesh ak Bluetooth 5.2 fonctionnalités. Devlopè yo ka ajoute kominikasyon rezo may nan aparèy LE tankou limyè ki konekte, automatisation lakay yo, ak sistèm swiv byen yo. Lojisyèl la sipòte tou Bluetooth beaconing, beacon analysis, ak koneksyon GATT pou may Bluetooth ka konekte ak smartphones, tablèt, ak lòt aparèy Bluetooth LE.

Nòt lage sa yo kouvri vèsyon SDK:

  • 2.1.10.0 pibliye 25 oktòb 2023 (sipò pou EFR32xG22, Revizyon D)
  • 2.1.9.0 te pibliye 5 septanm 2023 (chanjman platfòm ki kache sèlman)
  • 2.1.8.0 pibliye 13 jiyè 2023 (sipò pou EFR32xG21, Revizyon C ak pita)
  • 2.1.6.0 pibliye 29 mas 2023 (sipò pou aksè bonè)
  • 2.1.5.0 pibliye 11 janvye 2023 (chanjman platfòm ki kache sèlman)
  • 2.1.4.0 pibliye 13 oktòb 2021
  • 2.1.3.0 pibliye 24 septanm 2021 (chanjman Bluetooth ki kache sèlman)
  • 2.1.2.0 pibliye 8 septanm 2021
  • 2.1.1.0 pibliye 21 jiyè 2021
  • 2.1.0.0 te pibliye 16 jen 2021

Avi sou konpatibilite ak itilizasyon

Pou plis enfòmasyon sou mizajou ak avi sekirite yo, gade chapit Sekirite nan nòt lage platfòm Gecko ki enstale ak SDK sa a oswa sou paj nòt lage Silicon Labs. Silicon Labs rekòmande tou pou w abònman nan Konsèy Sekirite pou jwenn enfòmasyon ajou. Pou jwenn enstriksyon, oswa si w nouvo nan Silicon Labs Bluetooth mesh SDK, gade Sèvi ak Release sa a.

Konpilateur konpatib
IAR Embedded Workbench pou ARM (IAR-EWARM) vèsyon 8.50.9

  • Sèvi ak diven pou konstwi ak sèvis piblik liy kòmand IarBuild.exe oswa IAR Embedded Workbench GUI sou macOS oswa Linux ta ka lakòz kòrèk. files ke yo te itilize akòz kolizyon nan algorithm hashing diven pou génération kout file non.
  • Yo konseye kliyan ki sou macOS oswa Linux pou yo pa konstwi ak IAR deyò Simplicity Studio. Kliyan ki fè sa ta dwe ak anpil atansyon verifye ki kòrèk la fileyo ap itilize yo.GCC (The GNU Compiler Collection) vèsyon 10.2.0, bay Simplicity Studio. Karakteristik optimize lyen-tan nan GCC te enfim, sa ki lakòz yon ti ogmantasyon nan gwosè imaj

Nouvo Atik

Nouvo Karakteristik

Te ajoute nan lage 2.1.0.0 Secure Vault Integration
Kòmanse ak lage 2.1.0.0, Bluetooth Mesh SDK itilize fonksyonalite Secure Vault Key Management pou estoke kle kriptografik may lè yo itilize aparèy Secure Vault High. Entegrasyon Secure Vault la vizib pou kliyan an nan plizyè fason sou aparèy Seri 2:

  • Layout done NVM3 pou kle kriptografik ak chanjman metadata ki gen rapò ak yo. Fonksyonalite kle migrasyon yo bay pou pwojè ki te kreye lè l sèvi avèk vèsyon SDK 2.0 oswa pi bonè. Yon migrasyon kle yon sèl-fwa bezwen fè lè firmwèr la sou yon aparèy mete ajou.
  • Vizibilite done kle yo entansyonèlman limite sou nœuds may regilye yo. Yon aplikasyon sou yon ne may regilye pa pèmèt view aplikasyon oswa done kle aparèy lè l sèvi avèk kòmandman sl_btmesh_node_get_key() BGAPI, pandan y ap gen dwa yon aplikasyon sou yon nœud Provisioner entegre pou fè sa.

Pou plis enfòmasyon sou depo kle nan Secure Vault tanpri al gade AN1271: Secure Key Storage.

Sipò pou konpilatè
Konpilateur sipòte yo te mete ajou nan GCC vèsyon 10.2.0 ak IAR vèsyon 8.50.9.

Nouvo Egzample Aplikasyon
HSL Lighting example (Bluetooth Mesh - SoC HSL Light) te ajoute pou demontre yon ne limyè ki kontwole sou modèl sèvè HSL. Yo te ajoute demonstrasyon IOP (Bluetooth Mesh – Tès IOP – *) pou tablo Radyo yo nan Twous Devlopman Pro (SLWRB4104A, SLWRB4181A, SLWRB4181B, SLWRB4182A). Demo yo pèmèt tès entèoperabilite ak telefòn mobil yo. Tès la mande pou kat ansyenamples, chak ansyenample ki reprezante youn nan karakteristik yo Mesh: proxy, relè, zanmi, ak LPN.

Nouvo konpozan

  • Yo te ajoute eleman sèvè HSL.
  • Sipò pou baz done GATT dinamik (yon karakteristik Bluetooth LE) te ajoute.

Nouvo API te ajoute nan lage 2.1.4.0

Mesaj eksplisit Estati tan voye fonksyon sl_btmesh_time_server_status() ak fonksyon piblikasyon korespondan sl_btmesh_time_server_publish() yo te ajoute nan API modèl Time Server.

Te ajoute nan lage 2.1.2.0
Pa default yon aparèy Mesh nòmal ki pa yon Pwovizyonè pa kapab ekspòte done kle sekirite sou BGAPI la. Si yo bezwen ekspòtasyon kle sou yon aparèy konsa li ta dwe sèvi ak yon nouvo lòd BGAPI, sl_btmesh_node_set_exportable_keys(), anvan nenpòt kle yo kreye sou ne la. Sa a gen ladan kle ki te kreye pandan pwovizyon aparèy la. Yo te ajoute yon evènman dyagnostik ki fè aplikasyon yon chanjman sèn pwograme, sl_btmesh_scheduler_server_scene_changed().

Te ajoute nan lage 2.1.1.0
Pou optimize itilizasyon tanpon ak modèl Scene, yo te ajoute yon API opsyonèl pou pèmèt evènman rapèl sèn konpakte (ref. ID nimewo 706555). Li rekòmande yo sèvi ak nouvo API a lè yon ne gen yon gwo kantite modèl, oswa kantite trafik rezo a ne espere tande a wo. Pou aktive nouvo API a, sèvi ak lòd BGAPI sl_btmesh_scene_server_enable_compact_recall_events(). Apre sa, sl_btmesh_evt_scene_server_compact_recall_events pral siyal demann rapèl sèn yo. Pou rekipere eta modèl yo nan kachèt apre yon demann rapèl sèn, sèvi ak lòd sl_btmesh_generic_server_get_cached_state().

Te ajoute nan lage 2.1.0.0
Akòz entegrasyon Secure Vault, detay yo sou estoke kle chifreman ak metadata ki gen rapò yo chanje sou aparèy Seri 2 yo. Se poutèt sa, yo te ajoute yon nouvo klas BGAPI pou migrasyon kle chifreman ak baz done aparèy Founisè a entegre apre yon aktyalizasyon firmwèr sou aparèy Seri 2 yo. Li gen kòmandman sa yo:

  • sl_btmesh_migration_migrate_keys
  • sl_btmesh_migration_migrate_ddb

Amelyorasyon

Chanje API yo

Chanje nan lage 2.1.2.0
Paramèt timezone nan sl_btmesh_time_server_get_datetime() te korije yo dwe yon nonb antye relatif 16-bit siyen. Paramèt presizyon revèy, sl_btmesh_lpn_clock_accuracy, te ajoute nan konfigirasyon LPN. Yo ka itilize paramèt sa a pou ajiste konpòtman dòmi LPN lè revèy la sou aparèy la ta ka lakòz LPN rate delè biwo vòt li a.

Chanje nan lage 2.1.1.0
Evènman an sl_btmesh_evt_friend_friendship_terminated pral kounye a dwe pwodwi lè yon Kliyan Konfigirasyon enfim karakteristik Zanmi node la lè yon amitye aktif. Anvan sa, revokasyon amitye a nan sitiyasyon sa a te siyal siyal pa evènman an sl_btmesh_evt_node_config_set. (Ref. nimewo ID 627811)

Chanje nan lage 2.1.0.0
Kòmandman BGAPI sa yo nan klas prov la kounye a retounen apre validation paramèt, epi operasyon aktyèl la mande a pran plas apre yo fin bay yon repons BGAPI. Se yon evènman BGAPI ki koresponn siyal fini operasyon yo mande a:

  • sl_btmesh_prov_add_ddb_entry () - se sl_btmesh_evt_prov_add_ddb_entry_complete siyal pou konplete adisyon a
  • sl_btmesh_prov_delete_ddb_entry() – se sl_btmesh_evt_prov_delete_ddb_entry_complete ki siyal fini efase kòmandman BGAPI sa a nan klas prov la gen yon evènman adisyonèl ki ka pwodwi apre yo fin rele l:
  • sl_btmesh_prov_init - Anplis sl_btmesh_evt_prov_initialized, sl_btmesh_evt_prov_initialization_failed ka pwodwi. Yon lòd BGAPI te ajoute nan modèl kliyan jenerik BGAPI:

mesh_generic_client_init_hsl ()
Yo te ajoute yon lòd BGAPI nan modèl sèvè jenerik BGAPI:

mesh_generic_server_init_hsl ()

Pwoblèm fiks yo

Fiks nan lage 2.1.4.0

ID # Deskripsyon
729116 Pwoblèm fiks ak miltiplikasyon modèl Time Server envolontè lè w ajoute nouvo eleman nan yon pwojè
735569 Fiks manyen mesaj multicast segmenté ke yon ne zanmi ap delivre nan yon ne pouvwa ki ba

Fiks nan lage 2.1.2.0 

ID # Deskripsyon
627811 Jenere yon evènman amitye sispann lè revokasyon lokalman mande
676798 Konsidere erè revèy la ak lè reveye biwo vòt LPN
683518 Jenere evènman revokasyon amitye imedyatman nan moman ou resevwa yon mesaj zanmi klè
703974 Fiks yon pwoblèm tès kalifikasyon ak batman kè
709948 Bay yon API pou kontwole ekspòtabilite kle sekirite sou yon ne may
724511 Fikse yon pwoblèm ak enskri opcodes vandè sou 0x1F
730273 Fiks yon pwoblèm ak manyen konpanse lè zòn negatif
731713 Fiks yon potansyèl fuit memwa ak voye mesaj segmenté lè aparèy la pa gen anpil memwa
734034 Fiks kominikasyon zanmi-a-LPN lè TTL se zewo
734858 Korije yon potansyèl pwoblèm varyab pil ak manyen estrikti PSA
736054 Te fikse yon pwoblèm tès kalifikasyon ak modèl-aplikasyon kle obligatwa

Fiks nan lage 2.1.1.0 

ID # Deskripsyon
692961 Fiks ne la vin pa reponn lè retransmisyon relè yo te pèmèt lè anba chaj lou
713152 Fikse yon pwoblèm kote presizyon limite nan kalkil ki te lakòz erè awondi nan obligatwa ki genyen ant Lightness Actual ak Lightness Lineary.

Fiks nan lage 2.1.0.0 

ID # Deskripsyon
3878 Aplikasyon ta dwe inyore evènman GATT pou karakteristik may
342521 Bibliyotèk matematik pa ogmante gwosè imaj la san nesesite
358019 Kòd rezilta korije yo bay lè yo mande piblikasyon modèl ak kalifikasyon amitye men amitye pa sipòte
404070 Kòd rezilta korije yo bay lè yo rele lòd pwovizyon pou kreye yon kle rezo sou yon aparèy ki pa pwovizyon
454332 Yo ta dwe itilize API LE GAP la pou piblisite non lokal aparèy
464907 Retire evènman BGAPI ki pa nesesè 'batman kè te kòmanse' lè kliyan konfigirasyon enfim batman kè sou yon ne
653405 Out-of-the-box switch sample aplikasyon aktyèl konsomasyon se kounye a nan nivo espere
654477 DCD kòrèkteman dekode pa Network Analyzer
660048 Bouton Press UC eleman pa mande pou eleman IO Stream san nesesè
687105 BT Mesh Commands travay ak NCP Target example ak kòmandan NCP
690803 Fiks idantite modèl vandè kopi nan dèlko kòd
690862 SoC vid example kounye a kòmanse baliz sou pyès ki nan konpitè xG22
707497 Korije alokasyon kontèks kriptografik PSA
707524 Fiks yon regresion ak revèy gad IV rekiperasyon, pa pèmèt yon lòt rekiperasyon twò bonè
ID # Deskripsyon
710381 Fiks ekleraj eta manyen default lè yo te mete yon seri ki pa defo pou modèl ki koresponn lan
711359 Fiks paramèt tcheke pou pwovizyon sesyon kreyasyon apèl BGAPI

Pwoblèm li te ye nan Liberasyon aktyèl la

Pwoblèm an fonse yo te ajoute depi lage anvan an.

ID # Deskripsyon solisyon
401550 Pa gen evènman BGAPI pou echèk jere mesaj segmenté Aplikasyon bezwen dedwi echèk soti nan timeout / mank de repons kouch aplikasyon an
418636 Pwoblèm ak mesh_test konfigirasyon lokal API eta (idantite ne, relè, retransmisyon rezo)  
454059 Yon gwo kantite evènman kle rafrechisman chanjman eta yo pwodwi nan fen pwosesis KR, epi ki ka inonde keu NCP. Ogmante longè keu NCP nan pwojè a
454061 Yo te obsève yon ti kras degradasyon pèfòmans konpare ak 1.5 nan tès latansi ale-an  
624514 Pwoblèm ak re-etabli piblisite konekte si tout koneksyon yo te aktif epi GATT proxy se nan itilize Bay yon lòt koneksyon plis pase sa nesesè
650825 Pwoblèm ak retransmisyon lè yon modèl ap pibliye detanzantan Mete kanpe retransmisyon nan eta modèl la epi deklanche piblikasyon peryodik pa yon revèy aplikasyon

Atik depreche

Kòmandman BGAPI sa a nan klas ne yo te obsolète: sl_btmesh_node_erase_mesh_nvm () - sèvi ak sl_btmesh_node_reset () pito.

Retire atik yo

  • Okenn

Sèvi ak Liberasyon sa a

Version sa a gen bagay sa yo

  • Silicon Labs Bluetooth may bibliyotèk pile
  • Bluetooth sample aplikasyon yo

Si ou se yon premye fwa itilizatè, gade QSG176: Silicon Labs Bluetooth Mesh SDK v2.x Quick-Start Guide.

Enstalasyon ak itilizasyon
Yon kont ki anrejistre nan Silicon Labs nesesè pou telechaje Silicon Labs Bluetooth SDK. Ou ka enskri nan https://sili-conlabs.force.com/apex/SL_CommunitiesSelfReg?form=short. Enstriksyon enstalasyon Stack yo kouvri nan QSG176: Silicon Labs Bluetooth Mesh SDK v2.x Quick-Start Guide. Sèvi ak Bluetooth may SDK ak platfòm devlopman Silicon Labs Simplicity Studio V4. Simplicity Studio asire ke pifò konpatibilite soft-ware ak zouti yo jere kòrèkteman. Enstale lojisyèl ak mizajou firmwèr tablo san pèdi tan lè w ap fè w konnen.Dokimantasyon espesifik nan vèsyon SDK la enstale ak SDK la. Ou ka jwenn plis enfòmasyon souvan nan atik baz konesans (KBAs). Referans API ak lòt enfòmasyon sou sa a ak degaje anvan yo disponib sou https://docs.silabs.com/.

Enfòmasyon Sekirite Entegrasyon Vault Sekirite
Vèsyon sa a nan pil la entegre ak Secure Vault Key Management.Lè deplwaye nan aparèy Secure Vault High, kle chifreman may yo pwoteje lè l sèvi avèk fonksyonalite Secure Vault Key Management. Tablo ki anba a montre kle ki pwoteje yo ak karakteristik pwoteksyon depo yo.

Kle Ekspòtabilite sou yon ne Ekspòtabilite sou Pwovizyonè Nòt
Rezo kle Ekspòtab Ekspòtab Derivasyon nan kle rezo a egziste sèlman nan RAM pandan y ap kle rezo yo estoke sou flash
Kle aplikasyon an Ki pa-ekspòtab Ekspòtab  
Kle aparèy Ki pa-ekspòtab Ekspòtab Nan ka Provisioner a, aplike nan pwòp kle aparèy Provisionerr a ansanm ak kle lòt aparèy.

Kle ki make kòm "Ki pa ekspòtab" ka itilize men yo pa kapab viewed oswa pataje nan kouri. Kle ki make kòm "Ekspòtab" yo ka itilize oswa pataje pandan y ap kouri men yo rete ankripte pandan y ap estoke nan flash. Pou plis enfòmasyon sou fonksyonalite Secure Vault Key Management, gade AN1271: Secure Key Storage.

Konsèy Sekirite Sosyal
Pou abònman ak Konsèy Sekirite, konekte sou Portal kliyan Silicon Labs, epi chwazi Kont Kay. Klike sou HOME pou ale nan paj lakay pòtal la epi klike sou mozayik Jere Notifikasyon yo. Asire w ke 'Software/Security Advisory Notices & Product Change Notices (PCNs)' yo tcheke, epi ke ou abònman nan yon minimòm pou platfòm ou ak pwotokòl. Klike sou Save pou sove nenpòt chanjman.SILICON-LABS-Bluetooth-SDK-Mesh-FIG-1

Sipò
Kliyan Twous Devlopman yo kalifye pou fòmasyon ak sipò teknik. Sèvi ak Silicon Labs Bluetooth may la web paj pou jwenn enfòmasyon sou tout pwodwi ak sèvis Bluetooth Silicon Labs, epi pou w ka enskri pou sipò pou pwodwi. Kontakte Silicon Laboratories sipò nan http://www.silabs.com/support.

Senplisite Studio
Aksè yon sèl klike sou MCU ak zouti san fil, dokimantasyon, lojisyèl, bibliyotèk kòd sous ak plis ankò. Disponib pou Windows, Mac ak Linux!

SILICON-LABS-Bluetooth-SDK-Mesh-FIG-2

Limit responsabilite nou
Silicon Labs gen entansyon bay kliyan dènye, egzat, ak apwofondi dokiman sou tout periferik ak modil ki disponib pou aplikasyon sistèm ak lojisyèl lè l sèvi avèk oswa ki gen entansyon itilize pwodwi yo Silicon Labs. Done karakterizasyon, modil ki disponib ak periferik, gwosè memwa ak adrès memwa yo refere a chak aparèy espesifik, ak paramèt "Tipik" yo bay yo ka varye nan aplikasyon diferan. Aplikasyon ekzamples ki dekri isit la yo se pou rezon ilistrasyon sèlman. Silicon Labs rezève dwa pou fè chanjman nan enfòmasyon sou pwodwi, espesifikasyon, ak deskripsyon yo san avètisman, epi li pa bay garanti sou presizyon oswa konplè enfòmasyon ki enkli yo. San notifikasyon alavans, Silicon Labs ka mete ajou firmwèr pwodwi pandan pwosesis fabrikasyon an pou rezon sekirite oswa fyab. Chanjman sa yo pa pral chanje espesifikasyon yo oswa pèfòmans nan pwodwi a. Silicon Labs pa dwe gen okenn responsablite pou konsekans itilizasyon enfòmasyon yo bay nan dokiman sa a. Dokiman sa a pa vle di oswa ekspreseman akòde okenn lisans pou konsepsyon oswa fabrike nenpòt sikwi entegre. Pwodwi yo pa fèt oswa otorize pou yo itilize nan nenpòt aparèy FDA Klas III, aplikasyon pou ki gen apwobasyon FDA anvan mache oswa Sistèm Sipò Viv san konsantman espesifik alekri Silicon Labs. Yon "Sistèm Sipò pou Vi" se nenpòt pwodwi oswa sistèm ki gen entansyon sipòte oswa kenbe lavi ak/oswa sante, ki, si li echwe, yo ka rezonab espere lakòz blesi pèsonèl enpòtan oswa lanmò. Pwodwi Silicon Labs yo pa fèt oswa otorize pou aplikasyon militè yo. Pwodwi Silicon Labs pa dwe itilize nan okenn sikonstans nan zam destriksyon mas ki gen ladan (men pa limite a) zam nikleyè, byolojik oswa chimik, oswa misil ki kapab delivre zam sa yo. Silicon Labs rejte tout garanti eksprime ak enplik epi yo pa dwe responsab oswa responsab pou okenn blesi oswa domaj ki gen rapò ak itilizasyon yon pwodwi Silicon Labs nan aplikasyon sa yo san otorizasyon.

Nòt: Kontni sa a ka genyen tèminoloji ofansif ki kounye a demode. Silicon Labs ap ranplase tèm sa yo ak langaj enklizif tout kote sa posib. Pou plis enfòmasyon, vizite www.silabs.com/about-us/inclusive-lexicon-project

Enfòmasyon sou mak komèsyal yo
Silicon Laboratories Inc.®, Silicon Laboratories®, Silicon Labs®, SiLabs® ak logo Silicon Labs®, Bluegiga®, Bluegiga Logo®, EFM®, EFM32®, EFR, Ember®, Energy Micro, Energy Micro logo ak konbinezon ladan yo , "mikwokontwolè ki pi zanmitay enèji nan mond lan", Redpine Signals®, WiSeConnect, n-Link, ThreadArch®, EZLink®, EZRadio®, EZRadioPRO®, Gecko®, Gecko OS, Gecko OS Studio, Precision32®, Simplicity Studio®, Telegesis, Telegesis Logo®, USBXpress® , Zentri, Zentri logo ak Zentri DMS, Z-Wave®, ak lòt moun se mak komèsyal oswa mak anrejistre nan Silicon Labs. ARM, CORTEX, Cortex-M3 ak THUMB se mak oswa mak ki anrejistre nan ARM Holdings. Keil se yon mak ki anrejistre nan ARM Limited. Wi-Fi se yon mak ki anrejistre nan Wi-Fi Alliance. Tout lòt pwodwi oswa non mak ki mansyone isit la se mak komèsyal moun ki gen respektif yo.

Silicon Laboratories Inc. 400 West Cesar Chavez Austin, TX 78701 USA

Dokiman / Resous

SILICON LABS Bluetooth SDK may [pdfEnstriksyon yo
Bluetooth SDK may, SDK may, may

Referans

Kite yon kòmantè

Adrès imel ou p ap pibliye. Jaden obligatwa yo make *