SILICON LABS Bluetooth Mesh SDK Enigita Programaro

Specifoj de Produkto

• Produkta Nomo: Simplicity SDK Suite
• Versio: 2024.6.0
• Eldondato: la 5-an de junio 2024
• Versio de Bluetooth Mesh Specifo: 1.1

Produktaj Uzado-Instrukcioj

Bluetooth mesh estas nova topologio disponebla por Bluetooth Low Energy (LE) aparatoj kiuj ebligas mult-al-multaj (m:m) komunikadon. Ĝi estas optimumigita por krei grandskalajn aparatajn retojn kaj estas ideale taŭga por konstruado de aŭtomatigo, sensilretoj kaj spurado de valoraĵoj. Nia programaro kaj SDK por Bluetooth-disvolvado subtenas Bluetooth Mesh kaj Bluetooth-funkciecon. Programistoj povas aldoni retkonekton al LE-aparatoj kiel ekzemple konektitaj lumoj, hejma aŭtomatigo kaj sistemoj de spurado de aktivaĵoj. La softvaro ankaŭ subtenas Bludentan signostangon, signostango-skanadon, kaj GATT-konektojn tiel Bluetooth-reto povas konektiĝi al dolortelefonoj, tablojdoj kaj aliaj Bluetooth LE-aparatoj. Ĉi tiu eldono inkluzivas funkciojn subtenatajn de la Bluetooth-reto-specifa versio 1.1.

Ĉi tiuj eldonnotoj kovras SDK-versiojn:
7.0.0.0 liberigita la 5-an de junio 2024

Kongruo kaj Uzo Avizoj
Por pliaj informoj pri sekurecaj ĝisdatigoj kaj avizoj, vidu la Sekurecan ĉapitron de la Platformaj Eldonaj Notoj instalitaj kun ĉi tiu SDK aŭ sur la Silicon Labs Eldonaj Notoj-paĝo. Silicon Labs ankaŭ forte rekomendas, ke vi abonu Sekurecajn Konsilojn por ĝisdataj informoj. Por instrukcioj, aŭ se vi estas nova al la Silicon Labs Bluetooth mesh SDK, vidu Uzado de Ĉi tiu Eldono.

Kongruaj Kompililoj
IAR Embedded Workbench por ARM (IAR-EWARM) versio 9.40.1

• Uzi vinon por konstrui kun la komandlinia utileco IarBuild.exe aŭ IAR Embedded Workbench GUI en macOS aŭ Linukso povus rezultigi malĝustan files estanta uzata pro kolizioj en vino hashing algoritmo por generi mallonga file nomoj.
• Klientoj sur macOS aŭ Linukso estas konsilitaj ne konstrui kun IAR ekster Simplicity Studio. Klientoj kiuj faras devus zorge kontroli ke la ĝusta files estas uzataj.

GCC (The GNU Compiler Collection) versio 12.2.1, provizita per Simplicity Studio.

• Ligtempa optimumiga funkcio de GCC estis malŝaltita, rezultigante iomete pliigon de bildograndeco.

Novaj Eroj
Simplicity SDK estas enigita programaro-disvolva platformo por konstrui IoT-produktojn bazitajn sur niaj Serio 2 kaj Serio 3 sendrataj kaj MCU-aparatoj. Ĝi integras sendratajn protokolstakojn, mezvaron, ekstercentrajn ŝoforojn, ekŝargilon kaj aplikaĵon ekzamples - solida kadro por konstrui potencajn optimumigitajn kaj sekurajn IoT-aparatojn. Simplicity SDK ofertas potencajn funkciojn kiel ultra-malalta energikonsumo, forta reto fidindeco, subteno por granda nombro da nodoj kaj abstraktado de kompleksaj postuloj kiel multprotokolo kaj antaŭ-atestado. Aldone, Silicon Labs provizas trans-aerajn (OTA) programaron kaj sekurecajn ĝisdatigojn por malproksime ĝisdatigi aparatojn, minimumigi prizorgajn kostojn kaj plibonigi la sperton pri produkto de la finuzanto. Simplicity SDK estas sekvaĵo de nia populara Gecko SDK, kiu daŭre estos disponebla provizante longdaŭran subtenon por niaj Serio 0 kaj Serio 1 aparatoj.

Por pliaj informoj pri la Serio 0 kaj Serio 1 aparatoj bonvolu referenci: Serio 0 kaj Serio 1 EFM32/EZR32/EFR32 aparato (silabs.com).

Novaj Trajtoj

Aldonita en eldono 7.0.0.0
Subteno por Clock Manager estis aldonita. La stakaj komponantoj ne plu uzas device_init() por horloĝkomencigo. Anstataŭe, la aplika projekto nun devas inkluzivi la komponanton clock_manager, kiu faras la horloĝan inicialigon. Subteno por Common Memory Manager estis aldonita.

Novaj APIoj
Aldonita en eldono 7.0.0.0 Neniu.

Pliboniĝoj

• Noda BGAPI-klasa komando, sl_btmesh_node_test_identity, estis aldonita por kontroli reklamfontojn de nodaj identeco.
• Malalta Potenca Nodo-trajto aldonita al Sensila servilo ekzamples.
• Amiko trajto aldonita al la sensilo servilo kliento ekzample.

Ŝanĝita en eldono 7.0.0.0

• BGAPI-ŝanĝoj:
  Noda BGAPI klaskomando, sl_btmesh_node_test_identity, estis aldonita por kontroli ĉu ricevita noda identeco reklamo devenas de antaŭfiksita nodo aŭ ne.
• ExampŜanĝoj de la aplikaĵo:
  Malalta Potenca Nodo-funkcio estis aldonita al Sensila servilo ekzamples (btmesh_soc_sensor_thermometer, btmesh_soc_nlc_sensor_oc-cupancy btmesh_soc_nlc_sensor_ambient_light), kaj Friend-trajto estis aldonita al la sensila servila kliento eksample (btmesh_soc_sen-sor_client).

Fiksaj Problemoj
Riparita en eldono 7.0.0.0

• Evitu lanĉi reklamportilon se nodo estas provizita uzante nur PB-GATT.
• Plibonigita provizoraporto de eventoj sur troŝarĝita aparato.
• Plibonigita raportado pri evento de DFU sur troŝarĝita aparato.
• Erara raportado aldonita se Blob Transfer-agordo sur la nodo estas nesufiĉa por modeloj de DFU Distributor kaj Standalone Updater.
• Korektis konservadon de reludprotekto al NVM3 kiam vi uzas sl_btmesh_node_power_off() API.

ID #	Priskribo
356148	Evitas lanĉi reklamportilon se nodo estas provizita uzante nur PB-GATT.
1250461	Pli fortika raportado pri provizado de eventoj sur troŝarĝita aparato.
1258654	Pli fortika raportado pri evento de DFU sur troŝarĝita aparato.
1274632	Modeloj de DFU Distributor kaj Standalone Updater nun raportos eraron se Blob Transfer-agordo sur la nodo ne sufiĉas.
1284204	Korektis ŝparadon de reludprotekto al NVM3 kiam aplikaĵo uzas la API sl_btmesh_node_power_off().

Konataj Problemoj en la Nuna Eldono
Temoj en grasa skribo estis aldonitaj ekde la antaŭa eldono.

• Neniu BGAPI-okazaĵo por segmentita mesaĝo-traktado malsukceso.
• Ebla inundado de NCP-vico kun ŝlosilaj refreŝigaj ŝtatŝanĝaj eventoj.
• Malgranda rendimento-degenero en rondveturaj latentecaj testoj kompare kun versio 1.5.
• Problemoj kun reestablado de konektebla reklamado se ĉiuj ligoj estas aktivaj kaj GATT-prokurilo estas uzata.
• Malbona efikeco de segmentita mesaĝtransdono super GATT-portanto.

ID #	Priskribo	Solvaĵo
401550	Neniu BGAPI-okazaĵo por segmentita mesaĝo-traktado malsukceso.	Apliko bezonas dedukti malsukceson de tempoforigo / manko de aplika tavola respondo; por vendistaj modeloj API estis disponigita.
454059	Granda nombro da ŝlosilaj refreŝiga ŝtatŝanĝokazaĵoj estas generita ĉe la fino de KR-procezo, kaj tio povas inundi NCP-vicon.	Pliigu NCP-viclongon en la projekto.
454061	Malgranda rendimento degenero kompare kun 1.5 en rondveturaj latentecaj testoj estis observita.
624514	Problemo kun reestablado de konektebla reklamado se ĉiuj ligoj estis aktivaj kaj GATT-prokurilo estas uzata.	Asignu unu plian konekton ol necesas.
841360	Malbona efikeco de segmentita mesaĝtransdono super GATT-portanto.	Certigu, ke la Konekto-intervalo de la subesta BLE-konekto estas mallonga; certigu, ke ATT MTU estas sufiĉe granda por konveni plenan Mesh PDU; agordu la minimuman konektan okazaĵolongon por permesi al multoblaj LL-pakaĵetoj esti elsenditaj per ligkazaĵo.
1121605	Rondigaj eraroj povas kaŭzi planitajn eventojn ekfunkciigi en tre iomete malsamaj tempoj ol atendite.
1226127	Gastiganta provizanto ekzample povas esti blokita kiam ĝi komencas provizi duan nodon.	Rekomencu la gastigan provizantan apon antaŭ provizi la duan nodon.
1204017	Distribuisto ne kapablas pritrakti paralelan mem FW-Ĝisdatigon kaj FW-Alŝuton.	Ne rulu mem FW-ĝisdatigon kaj FW-alŝuton paralele.
1301325	Planilaj agoj ne estas ĝuste konservitaj en konstanta stokado.
1305041	NCP-komunikado de gastiganto al EFR32 eble eksvalidiĝas.	sl_simple_com_usart.c povas esti redaktata por korekti tempofinvaloron.
1305928	Agordo de 10 aŭ pli da ĝisdatigaj nodoj kiel DFU-riceviloj povas malsukcesi en la SoC-distribua programo.

Malrekomenditaj Eroj
Malrekomendita en eldono 7.0.0.0
La BGAPI-komando sl_btmesh_prov_test_identity estas malrekomendita. Uzu sl_btmesh_node_test_identity anstataŭe.

Forigitaj Eroj
Forigita en eldono 7.0.0.0
Subteno por Serio 1 aparataro (xG12 kaj xG13) estis forigita en ĉi tiu eldono.

Uzante Ĉi tiun Eldonon
Ĉi tiu eldono enhavas la jenon

• Silicon Labs Bluetooth retstako biblioteko
• Bluetooth mesh sample aplikoj

Se vi estas unuafoja uzanto, vidu QSG176: Silicon Labs Bluetooth Mesh SDK v2.x Quick-Start Guide.

Instalado kaj Uzo
La Bluetooth mesh SDK estas disponigita kiel parto de la Simplicity SDK (GSDK), la serio de Silicon Labs SDK-oj. Por rapide komenci kun Simplicity SDK, instalu Simplicity Studio 5, kiu starigos vian evolumedion kaj gvidos vin tra la instalado de Simplicity SDK. Simplicity Studio 5 inkluzivas ĉion bezonatan por IoT-produktevoluo per Silicon Labs-aparatoj, inkluzive de rimedo kaj projektlanĉilo, programaraj agordaj iloj, plena IDE kun GNU-ilĉeno kaj analizaj iloj. Instalaj instrukcioj estas provizitaj en la interreta Uzantgvidilo de Simplicity Studio 5. Alternative, Simplicity SDK povas esti instalita permane elŝutante aŭ klonante la plej novan de GitHub. Vidu https://github.com/Sili-conLabs/simplicity_sdk por pliaj informoj.

Simplicity Studio instalas la Simplicity SDK defaŭlte en:

• Vindozo:
  • C:\Uzantoj\ \SimplicityStudio\SDKs\simplicity_sdk
• MacOS: /Uzantoj/ /SimplicityStudio/SDKs/simplicity_sdk
  Dokumentaro specifa por la SDK-versio estas instalita kun la SDK. Pliaj informoj ofte troveblas en la sciobazaj artikoloj (KBAoj). API-referencoj kaj aliaj informoj pri ĉi tiu kaj pli fruaj eldonoj estas haveblaj sur https://docs.silabs.com/.

Sekurecaj Informoj

Ŝlosilo	Eksportebleco sur nodo	Eksportebleco sur Provizanto	Notoj
Reta ŝlosilo	Eksportebla	Eksportebla	Derivoj de la retoŝlosilo ekzistas nur en RAM dum retŝlosiloj estas stokitaj sur fulmo
Aplika ŝlosilo	Ne-ekportebla	Eksportebla
Aparato ŝlosilo	Ne-ekportebla	Eksportebla	En la kazo de Provisioner, aplikite al la propra aparato-ŝlosilo de Provisionerr same kiel al la ŝlosiloj de aliaj aparatoj

Sekura Vault-Integriĝo
Ĉi tiu versio de la stako estas integrita kun Secure Vault Key Management. Se deplojitaj al Secure Vault High-aparatoj, maŝ-ĉifradaj ŝlosiloj estas protektitaj per la funkcio de Secure Vault Key Management. La suba tabelo montras la protektitajn ŝlosilojn kaj iliajn konservadprotektajn trajtojn.

• Ŝlosiloj kiuj estas markitaj kiel "Ne-Ekporteblaj" povas esti uzataj sed ne povas esti viewred aŭ dividita ĉe rultempo.
• Ŝlosiloj kiuj estas markitaj kiel "Ekporteblaj" povas esti uzataj aŭ dividitaj dum rultempo, sed restas ĉifritaj dum ili konserviĝas en fulmo.
• Por pliaj informoj pri Secure Vault Key Management-funkcio, vidu AN1271: Sekura Ŝlosilo Stokado.

Konsiloj pri Sekureco
Por aboni Sekurecajn Konsilojn, ensalutu al la klientportalo de Silicon Labs, tiam elektu Konto-Hejmon. Alklaku HEJMO por iri al la portala ĉefpaĝo kaj poste alklaku la kahelon Administri Sciigojn. Certigu, ke 'Programaro/Sekurec-Avizoj kaj Produktaj Ŝanĝoj-Avizoj (PCN-oj)' estas kontrolita, kaj ke vi estas minimume abonita por via platformo kaj protokolo. Klaku Konservi por konservi ajnajn ŝanĝojn.

Subteno
La klientoj de Disvolva Kit estas elekteblaj por trejnado kaj teknika subteno. Uzu la Bluetooth-reŝon de Silicon Labs web paĝo por akiri informojn pri ĉiuj produktoj kaj servoj de Bluetooth de Silicon Labs, kaj por registriĝi por produktsubteno.
Kontaktu Silicon Laboratories-subtenon ĉe http://www.silabs.com/support.

Simpleco Studio
Unuklaka aliro al MCU kaj sendrataj iloj, dokumentaro, programaro, fontkodaj bibliotekoj kaj pli. Havebla por Vindozo, Mac kaj Linukso!

Malgarantio
Silicon Labs intencas provizi klientojn per la plej nova, preciza kaj profunda dokumentado de ĉiuj ekstercentraj kaj moduloj disponeblaj por sistemoj kaj programaroj uzantaj aŭ intencantaj uzi produktojn de Silicon Labs. Karakterizaj datumoj, disponeblaj moduloj kaj ekstercentraj, memorgrandecoj kaj memoradresoj rilatas al ĉiu specifa aparato, kaj "Tipaj" parametroj provizitaj povas kaj varias en malsamaj aplikoj. Apliko ekzampLa ĉi tie priskribitaj estas nur por ilustraj celoj. Silicon Labs rezervas la rajton fari ŝanĝojn sen plia avizo al la produktaj informoj, specifoj kaj priskriboj ĉi tie, kaj ne donas garantiojn pri la ĝusteco aŭ kompleteco de la inkluditaj informoj. Sen antaŭa sciigo, Silicon Labs povas ĝisdatigi produktofirmaron dum la produktada procezo pro sekurecaj aŭ fidindeckialoj. Tiaj ŝanĝoj ne ŝanĝos la specifojn aŭ la agadon de la produkto. Silicon Labs ne havas respondecon pri la sekvoj de uzo de la informoj provizitaj en ĉi tiu dokumento. Ĉi tiu dokumento ne implicas aŭ eksplicite donas ajnan permesilon por desegni aŭ fabriki iujn ajn integrajn cirkvitojn. La produktoj ne estas dezajnitaj aŭ rajtigitaj por esti uzataj en iuj aparatoj de FDA Class III, aplikoj por kiuj FDA antaŭmerkata aprobo estas postulata aŭ Vivsubtenaj Sistemoj sen la specifa skriba konsento de Silicon Labs. "Vivsubtena Sistemo" estas ajna produkto aŭ sistemo intencita por subteni aŭ subteni vivon kaj/aŭ sanon, kiu, se ĝi malsukcesas, povas esti racie atendita rezultigi gravan personan vundon aŭ morton. Silicon Labs-produktoj ne estas dezajnitaj aŭ rajtigitaj por militaj aplikoj. Silicon Labs-produktoj ne devas esti uzataj en amasdetruaj armiloj inkluzive (sed ne limigitaj al) nukleaj, biologiaj aŭ kemiaj armiloj, aŭ misiloj kapablaj liveri tiajn armilojn. Silicon Labs rifuzas ĉiujn eksplicitajn kaj implicitajn garantiojn kaj ne respondecos aŭ respondecas pri ajnaj vundoj aŭ damaĝoj rilate al uzo de produkto de Silicon Labs en tiaj neaŭtorizitaj aplikoj.

Notu: Ĉi tiu enhavo povas enhavi ofendan terminologion kiu nun estas malnoviĝinta. Silicon Labs anstataŭigas ĉi tiujn terminojn per inkluziva lingvo kie ajn eblas. Por pliaj informoj, vizitu www.silabs.com/about-us/inclusive-lexicon-project

Varmarkinformo
Silicon Laboratories Inc.®, Silicon Laboratories®, Silicon Labs®, SiLabs® kaj la emblemo de Silicon Labs®, Bluegiga®, Bluegiga Logo®, EFM®, EFM32®, EFR, Ember®, Energy Micro, Energy Micro-emblemo kaj ĉi tiuj kombinaĵoj , "la plej energiaj mikroregiloj de la mondo", Redpine Signals®, WiSeConnect, n-Link, EZLink®, EZRadio®, EZRadioPRO®, Gecko®, Gecko OS, Gecko OS Studio, Precision32®, Simplicity Studio®, Telegesis, la Telegesis Logo®, USBXpress®, Zentri, la Zentri-emblemo kaj Zentri DMS, Z-Wave®, kaj aliaj estas varmarkoj aŭ registritaj varmarkoj de Silicon Labs. ARM, CORTEX, Cortex-M3 kaj THUMB estas varmarkoj aŭ registritaj varmarkoj de ARM Holdings. Keil estas registrita varmarko de ARM Limited. Wi-Fi estas registrita varmarko de la Wi-Fi Alliance. Ĉiuj aliaj produktoj aŭ markonomoj menciitaj ĉi tie estas varmarkoj de siaj respektivaj posedantoj.

Oftaj Demandoj (FAQ)

Q: Kie mi povas trovi pliajn informojn pri sekurecaj ĝisdatigoj?
R: Vidu al la Sekurecĉapitro de la Platformaj Eldonaj Notoj aŭ vizitu la paĝon de Silicon Labs Eldonaj Notoj por detalaj sekurecaj ĝisdatigoj.

Q: Kiel mi inkluzivas la komponanton clock_manager por horloĝkomencigo?
R: Por inkluzivi la komponanton clock_manager por horloĝkomencigo, nepre ĝisdatigi vian aplikaĵan projekton laŭ la provizitaj instrukcioj en la uzantmanlibro.

Silicon Laboratories Inc.
400 Okcidenta Cesar Chavez
Aŭstino, TX 78701
Usono
www.silabs.com

IoT Portfolio
www.silabs.com/IoT

SW/HW
www.silabs.com/simplicity

Kvalito
www.silabs.com/quality

Subteno & Komunumo
www.silabs.com/community

Dokumentoj/Rimedoj

SILICON LABS Bluetooth Mesh SDK Enigita Programaro [pdf] Uzantogvidilo Bluetooth Mesh SDK Enigita Programaro, Mesh SDK Enigita Programaro, SDK Enigita Programaro, Enigita Programaro, Programaro

Referencoj

• Uzanto Manlibro