SILICON LABS Bluetooth SDK Mesh

Bluetooth möskva er ný svæðisfræði í boði fyrir Bluetooth Low Energy (LE) tæki sem gera mörg-til-marga (m:m) samskipti. Það er fínstillt til að búa til stórtæk tækjakerfi og hentar vel til að byggja upp sjálfvirkni, skynjaranet og rekja eignir. Hugbúnaðurinn okkar og SDK fyrir Bluetooth þróun styður Bluetooth Mesh og Bluetooth 5.2 virkni. Hönnuðir geta bætt netsamskiptum við LE tæki eins og tengd ljós, sjálfvirkni heima og eignarakningarkerfi. Hugbúnaðurinn styður einnig Bluetooth beaconing, beacon skönnun og GATT tengingar svo Bluetooth möskva getur tengst snjallsímum, spjaldtölvum og öðrum Bluetooth LE tækjum.

Þessar útgáfuskýringar ná yfir SDK útgáfur:

• 2.1.10.0 gefin út 25. október 2023 (stuðningur við EFR32xG22, endurskoðun D)
• 2.1.9.0 gefin út 5. september 2023 (aðeins undirliggjandi vettvangsbreytingar)
• 2.1.8.0 gefin út 13. júlí 2023 (stuðningur við EFR32xG21, Revision C og síðar)
• 2.1.6.0 gefin út 29. mars 2023 (stuðningur við snemmbúinn aðgangshluta)
• 2.1.5.0 gefin út 11. janúar 2023 (aðeins undirliggjandi vettvangsbreytingar)
• 2.1.4.0 gefin út 13. október 2021
• 2.1.3.0 gefin út 24. september 2021 (aðeins undirliggjandi Bluetooth breytingar)
• 2.1.2.0 gefin út 8. september 2021
• 2.1.1.0 gefin út 21. júlí 2021
• 2.1.0.0 gefin út 16. júní 2021

Samhæfi og notkunartilkynningar

Fyrir frekari upplýsingar um öryggisuppfærslur og tilkynningar, sjá öryggiskafla Gecko Platform Release Notes uppsettar með þessu SDK eða á Silicon Labs Release Notes síðunni. Silicon Labs mælir einnig eindregið með því að þú gerist áskrifandi að öryggisráðgjöfum til að fá uppfærðar upplýsingar. Fyrir leiðbeiningar, eða ef þú ert nýr í Silicon Labs Bluetooth möskva SDK, sjá Notkun þessa útgáfu.

Samhæfðir þýðendur
IAR Embedded Workbekk fyrir ARM (IAR-EWARM) útgáfu 8.50.9

• Notkun vín til að byggja með IarBuild.exe skipanalínuforritinu eða IAR Embedded Workbench GUI á macOS eða Linux gæti leitt til rangra files verið notað vegna árekstra í kjötkássa reiknirit víns til að mynda stutt file nöfnum.
• Viðskiptavinum á macOS eða Linux er ráðlagt að byggja ekki með IAR utan Simplicity Studio. Viðskiptavinir sem gera ættu að sannreyna vandlega að rétt files eru notuð.GCC (The GNU Compiler Collection) útgáfa 10.2.0, fylgir Simplicity Studio. Fínstillingareiginleiki GCC hefur verið gerður óvirkur, sem leiðir til smávægilegrar aukningar á myndstærð

Nýir hlutir

Nýir eiginleikar

Bætt við útgáfu 2.1.0.0 Secure Vault Integration
Frá og með útgáfu 2.1.0.0 notar Bluetooth Mesh SDK Secure Vault Key Management virknina til að geyma möskva dulmálslykla þegar Secure Vault High tæki eru notuð. Secure Vault samþættingin er sýnileg viðskiptavinum á ýmsa vegu á 2. röð tækjum:

• Útlit NVM3 gagna fyrir dulmálslykla og tengd lýsigögn þeirra breytist. Lyklaflutningsvirkni er veitt fyrir verkefni sem hafa verið búin til með SDK útgáfum 2.0 eða eldri. Flytja þarf lykla í eitt skipti þegar fastbúnaður tækis er uppfærður.
• Sýnileiki lykilgagna er viljandi takmarkaður á venjulegum möskvahnútum. Umsókn á venjulegum möskvahnút er ekki heimilt view lykilgögn forrits eða tækis með því að nota sl_btmesh_node_get_key() BGAPI skipunina, en forrit á innbyggðum Provisioner hnút er heimilt að gera það.

Fyrir frekari upplýsingar um lyklageymslu í Secure Vault vinsamlegast vísa til AN1271: Secure Key Storage.

Stuðningur við þýðanda
Stuðlar þýðendur hafa verið uppfærðir í GCC útgáfu 10.2.0 og IAR útgáfu 8.50.9.

Nýtt Example Forrit
HSL lýsing fyrrvample (Bluetooth Mesh – SoC HSL Light) var bætt við til að sýna ljósan hnút sem er stjórnanlegt yfir HSL netþjónalíkön. IOP kynningu (Bluetooth Mesh – IOP Test – *) var bætt við fyrir útvarpstöflurnar í Pro Development Kits (SLWRB4104A, SLWRB4181A, SLWRB4181B, SLWRB4182A). Sýningarnar leyfa prófun á samvirkni við farsíma. Prófið krefst fjögurra fyrrverandiamples, hvert fyrrvample sem táknar einn af Mesh eiginleikum: proxy, relay, friend og LPN.

Nýir íhlutir

• HSL Server Component var bætt við.
• Stuðningur fyrir kraftmikinn GATT gagnagrunn (Bluetooth LE eiginleiki) var bætt við.

Nýjum API bætt við í útgáfu 2.1.4.0

Skýr tímastilling skilaboðasending sl_btmesh_time_server_status() og samsvarandi skýr birtingaraðgerð sl_btmesh_time_server_publish() var bætt við Time Server líkan API.

Bætt við útgáfu 2.1.2.0
Sjálfgefið er að venjulegt möskvatæki sem er ekki veitandi getur ekki flutt út öryggislyklagögn yfir BGAPI. Ef lykilútflutnings er þörf á slíku tæki ætti það að nota nýja BGAPI skipun, sl_btmesh_node_set_exportable_keys(), áður en einhverjir lyklar eru búnir til á hnútnum. Þetta felur í sér lykla sem eru búnir til við útvegun tækisins. Greiningartilviki sem tilkynnir beitingu um áætlaða senubreytingu, sl_btmesh_scheduler_server_scene_changed(), hefur verið bætt við.

Bætt við útgáfu 2.1.1.0
Til að hámarka notkun biðminni með senulíkönum hefur valfrjálsu API til að virkja samþjappaðan senuinnkallaviðburði verið bætt við (tilvísun útgáfuauðkenni 706555). Mælt er með því að nota nýja API þegar hnútur hefur mikið magn af gerðum, eða magn netumferðar sem búist er við að hnúturinn heyri er mikil. Til að virkja nýja API, notaðu BGAPI skipunina sl_btmesh_scene_server_enable_compact_recall_events(). Síðan munu sl_btmesh_evt_scene_server_compact_recall_events gefa merki um innkallabeiðnir um senu. Til að sækja skyndiminni líkanið eftir beiðni um innköllun senu, notaðu skipunina sl_btmesh_generic_server_get_cached_state().

Bætt við útgáfu 2.1.0.0
Vegna Secure Vault samþættingar hafa upplýsingar um geymslu dulkóðunarlykla og tengd lýsigögn þeirra breyst á 2. röð tækjum. Því hefur verið bætt við nýjum BGAPI flokki til að flytja dulkóðunarlykla og innbyggða tækjagagnagrunni Provisioner eftir fastbúnaðaruppfærslu á Series 2 tækjum. Það hefur eftirfarandi skipanir:

• sl_btmesh_migration_migrate_keys
• sl_btmesh_migration_migrate_ddb

Umbætur

Breytt API

Breytt í útgáfu 2.1.2.0
Tímabeltifæribreytan í sl_btmesh_time_server_get_datetime() hefur verið leiðrétt þannig að hún er undirrituð 16 bita heiltala. Klukku nákvæmni færibreyta, sl_btmesh_lpn_clock_accuracy, hefur verið bætt við LPN uppsetningu. Þessa færibreytu er hægt að nota til að stilla LPN svefnhegðun þegar klukkuflakk á tækinu myndi annars valda því að LPN missi af könnunartíma.

Breytt í útgáfu 2.1.1.0
Atburðurinn sl_btmesh_evt_friend_friendship_terminated verður nú búinn til þegar stillingarviðskiptavinur slekkur á vinaeiginleika hnútsins þegar vinátta er virk. Áður var uppsögn vináttunnar í þessum aðstæðum óbeint gefið til kynna með sl_btmesh_evt_node_config_set atburðinum. (Tilvísun útgáfa id 627811)

Breytt í útgáfu 2.1.0.0
Eftirfarandi BGAPI skipanir í prov bekknum skila nú eftir löggildingu breytu og raunveruleg umbeðin aðgerð fer fram eftir að BGAPI svar hefur verið gefið. Að umbeðinni aðgerð sé lokið er gefið til kynna með samsvarandi BGAPI atburði:

• sl_btmesh_prov_add_ddb_entry() – að samlagningu sé lokið er gefið til kynna með sl_btmesh_evt_prov_add_ddb_entry_complete
• sl_btmesh_prov_delete_ddb_entry() – lokið eyðingu er gefið til kynna með sl_btmesh_evt_prov_delete_ddb_entry_complete Eftirfarandi BGAPI skipun í prov bekknum hefur viðbótartilvik sem gæti myndast eftir að það er kallað:
• sl_btmesh_prov_init – auk sl_btmesh_evt_prov_initialized, gæti sl_btmesh_evt_prov_initialization_failed verið búið til. BGAPI skipun hefur verið bætt við almenna biðlaralíkanið BGAPI:

mesh_generic_client_init_hsl()
BGAPI skipun hefur verið bætt við almenna netþjónslíkanið BGAPI:

mesh_generic_server_init_hsl()

Föst mál

Lagað í útgáfu 2.1.4.0

auðkenni #	Lýsing
729116	Lagað vandamál með óviljandi tímaþjónslíkan margföldun þegar nýjum þáttum var bætt við verkefni
735569	Föst meðhöndlun á sundurliðuðum fjölvarpsskilaboðum sem vinahnútur er að afhenda á hnút með litlum krafti

Lagað í útgáfu 2.1.2.0 

auðkenni #	Lýsing
627811	Búðu til atburði sem hætt er við vináttu þegar beðið er um uppsögn á staðnum
676798	Taktu tillit til ónákvæmni klukku með LPN könnun vakningartíma
683518	Búðu til uppsögn vináttu strax á þeim tíma sem þú færð Friend Clear skilaboð
703974	Lagaði hæfnisprófsvandamál með hjartslætti
709948	Útvegaði API til að stjórna útflutningsgetu öryggislykla á möskvahnút
724511	Lagaði vandamál með að skrá opkóða söluaðila yfir 0x1F
730273	Lagaði vandamál með meðhöndlun neikvæðrar tímabeltisjöfnunar
731713	Lagaði hugsanlegan minnisleka með því að senda sundurliðuð skilaboð þegar minnið er lítið í tækinu
734034	Föst samskipti frá vini til LPN þegar TTL er núll
734858	Leiðrétti hugsanlegt vandamál með staflabreytu með PSA uppbyggingu meðhöndlun
736054	Lagaði hæfnisprófsvandamál með lyklabindingu líkana og umsóknar

Lagað í útgáfu 2.1.1.0 

auðkenni #	Lýsing
692961	Lagaði að hnúturinn varð ósvörun þegar endursendingar gengis voru virkjaðar í miklu álagi
713152	Lagaði vandamál þar sem takmörkuð útreikningsnákvæmni olli námundunarvillum í tengingu milli ljóss léttleika raun og ljóss léttleika línulegs

Lagað í útgáfu 2.1.0.0 

auðkenni #	Lýsing
3878	Umsókn ætti að hunsa GATT atburði fyrir Mesh eiginleika
342521	Stærðfræðisafnið stækkar ekki stærð myndarinnar að óþörfu
358019	Leiðréttur niðurstöðukóði gefinn upp þegar beðið er um birtingu líkana með vináttuskilríkjum en vinátta er ekki studd
404070	Leiðréttur niðurstöðukóði sem gefinn er upp þegar úthlutunarskipun til að búa til netlykil er kölluð á tæki sem ekki veitir afgreiðslu
454332	LE GAP API ætti að nota fyrir staðbundin nafnauglýsingar tækis
464907	Fjarlægði óþarfa „hjartsláttur byrjaður“ BGAPI atburður þegar stillingarbiðlari slekkur á hjartslætti á hnút
653405	Rofi úr kassanum sampstraumnotkun le umsókn er nú á væntanlegu stigi
654477	DCD rétt afkóðað af Network Analyzer
660048	Hnappur Ýttu á UC hluti þarf ekki IO Stream hluti að óþörfu
687105	BT Mesh skipanir vinna með NCP Target tdampLe og NCP yfirmaður
690803	Lagaði tvöfalt auðkenni seljanda líkana í kóðarafalli
690862	SoC tóm tdample byrjar nú að senda leiðarljós á xG22 vélbúnaði
707497	Leiðrétt PSA dulritunarsamhengisúthlutun
707524	Lagaði aðhvarf með IV bata guard tímamæli, ekki leyfa aðra bata of fljótt

auðkenni #	Lýsing
710381	Fast meðhöndlun á sjálfgefna lýsingu þegar ekki var sjálfgefið svið fyrir samsvarandi gerð var stillt
711359	Lagað athugun á færibreytum fyrir BGAPI símtal til að búa til setu

Þekkt vandamál í núverandi útgáfu

Feitletruð tölublöð voru bætt við frá fyrri útgáfu.

auðkenni #	Lýsing	Lausn
401550	Enginn BGAPI atburður fyrir misskilning í meðhöndlun skilaboða	Forrit þarf að leiða bilun frá tímamörkum / skorti á svörun forritslags
418636	Vandamál með mesh_test staðbundinni stillingarstöðu API (hnútauðkenni, gengi, endursending nets)
454059	Mikill fjöldi lykiluppfærsluástandsbreytinga er myndaður í lok KR ferlisins og það gæti flætt yfir NCP biðröð	Auka lengd NCP biðraðar í verkefninu
454061	Lítilsháttar skerðing á frammistöðu samanborið við 1.5 í biðtímaprófum fram og til baka
624514	Vandamál með að koma aftur upp tengdum auglýsingum ef allar tengingar hafa verið virkar og GATT proxy er í notkun	Úthlutaðu einni tengingu í viðbót en þörf er á
650825	Vandamál með endursendingar þegar líkan er að birta reglulega	Settu upp endursendingar í fyrirmyndarstöðu og kveiktu á reglubundinni birtingu með tímamæli forrita

Úreltir hlutir

Eftirfarandi BGAPI skipun í hnútaflokknum hefur verið úrelt: sl_btmesh_node_erase_mesh_nvm() – notaðu sl_btmesh_node_reset() í staðinn.

Fjarlægðir hlutir

• Engin

Að nota þessa útgáfu

Þessi útgáfa inniheldur eftirfarandi

• Silicon Labs Bluetooth möskva stafla bókasafn
• Bluetooth sample umsóknir

Ef þú ert í fyrsta skipti, sjáðu QSG176: Silicon Labs Bluetooth Mesh SDK v2.x Quick-Start Guide.

Uppsetning og notkun
Skráður reikningur hjá Silicon Labs er nauðsynlegur til að hlaða niður Silicon Labs Bluetooth SDK. Hægt er að skrá sig á https://sili-conlabs.force.com/apex/SL_CommunitiesSelfReg?form=short. Fjallað er um uppsetningarleiðbeiningar í QSG176: Silicon Labs Bluetooth Mesh SDK v2.x Quick-Start Guide. Notaðu Bluetooth-mesh SDK með Silicon Labs Simplicity Studio V4 þróunarvettvangi. Simplicity Studio tryggir að flestum hugbúnaðar- og verkfærum sé stjórnað á réttan hátt. Settu upp hugbúnað og vélbúnaðaruppfærslur á borði tafarlaust þegar þú færð tilkynningu.Skjölun sem er sérstaklega fyrir SDK útgáfuna er sett upp með SDK. Viðbótarupplýsingar má oft finna í þekkingargrunnsgreinum (KBA). API tilvísanir og aðrar upplýsingar um þessa og fyrri útgáfur eru fáanlegar á https://docs.silabs.com/.

Öryggisupplýsingar Örugg Vault Sameining
Þessi útgáfa af staflanum er samþætt með Secure Vault Key Management. Þegar þau eru notuð í Secure Vault High tæki eru dulkóðunarlyklar fyrir möskva verndaðir með því að nota Secure Vault Key Management virknina. Taflan hér að neðan sýnir vernduðu lyklana og geymsluverndareiginleika þeirra.

Lykill	Útflutningshæfni á hnút	Útflutningshæfni á Provisioner	Skýringar
Netlykill	Útflutningshæft	Útflutningshæft	Afleiður netlykilsins eru aðeins til í vinnsluminni á meðan netlyklar eru geymdir á flash
Umsóknarlykill	Óútflutningshæft	Útflutningshæft
Tækjalykill	Óútflutningshæft	Útflutningshæft	Í tilviki Provisioner, notað á eigin tækjalykil Provisionerr sem og lykla annarra tækja

Lykla sem eru merktir sem „Non-Exportable“ er hægt að nota en ekki viewed eða deilt á keyrslutíma. Lykla sem eru merktir sem „Exportable“ er hægt að nota eða deila á keyrslutíma en haldast dulkóðaðir meðan þeir eru geymdir í flash. Nánari upplýsingar um Secure Vault Key Management virkni er að finna í AN1271: Secure Key Storage

Öryggisráðgjöf
Til að gerast áskrifandi að öryggisráðgjöf, skráðu þig inn á Silicon Labs viðskiptavinagáttina og veldu síðan Account Home. Smelltu á HEIM til að fara á heimasíðu gáttarinnar og smelltu síðan á Stjórna tilkynningar reitnum. Gakktu úr skugga um að hakað sé við „Hugbúnaðar-/öryggisráðgjafar og tilkynningar um vörubreytingar (PCN)“ og að þú sért að lágmarki áskrifandi að vettvangi þínum og samskiptareglum. Smelltu á Vista til að vista allar breytingar.

Stuðningur
Viðskiptavinir Þróunarsetts eiga rétt á þjálfun og tækniaðstoð. Notaðu Silicon Labs Bluetooth netið web síðu til að fá upplýsingar um allar Silicon Labs Bluetooth vörur og þjónustu, og til að skrá þig fyrir vöruaðstoð. Hafðu samband við stuðning Silicon Laboratories á http://www.silabs.com/support.

Simplicity stúdíó
Aðgangur með einum smelli að MCU og þráðlausum verkfærum, skjölum, hugbúnaði, frumkóðasöfnum og fleira. Í boði fyrir Windows, Mac og Linux!

• IoT safn
  • www.silabs.com/IoT
• SV/HW
  • www.silabs.com/Simplicity
• Gæði
  • www.silabs.com/quality
• Stuðningur og samfélag
  • www.silabs.com/community

Fyrirvari
Silicon Labs ætlar að veita viðskiptavinum nýjustu, nákvæma og ítarlega skjölin um öll jaðartæki og einingar sem eru tiltækar fyrir kerfis- og hugbúnaðarframleiðendur sem nota eða ætla að nota Silicon Labs vörurnar. Einkennisgögn, tiltækar einingar og jaðartæki, minnisstærðir og minnisföng vísa til hvers tiltekins tækis og „Dæmigerðar“ færibreytur geta verið mismunandi eftir mismunandi forritum. Umsókn tdampLesið sem lýst er hér er eingöngu til lýsingar. Silicon Labs áskilur sér rétt til að gera breytingar án frekari fyrirvara á vöruupplýsingum, forskriftum og lýsingum hér, og gefur enga ábyrgð á nákvæmni eða heilleika meðfylgjandi upplýsinga. Án fyrirvara getur Silicon Labs uppfært fastbúnað vörunnar meðan á framleiðsluferlinu stendur af öryggis- eða áreiðanleikaástæðum. Slíkar breytingar munu ekki breyta forskriftum eða frammistöðu vörunnar. Silicon Labs ber enga ábyrgð á afleiðingum notkunar upplýsinganna sem gefnar eru upp í þessu skjali. Þetta skjal felur ekki í sér eða gefur beinlínis leyfi til að hanna eða búa til samþættar rafrásir. Vörurnar eru ekki hannaðar eða heimilaðar til notkunar í neinum FDA Class III tækjum, forritum þar sem FDA formarkaðssamþykki er krafist eða lífsstuðningskerfum án sérstaks skriflegs samþykkis Silicon Labs. „Lífsstuðningskerfi“ er hvers kyns vara eða kerfi sem ætlað er að styðja við eða viðhalda lífi og/eða heilsu, sem, ef það mistekst, má með sanngirni búast við að muni leiða til verulegs líkamstjóns eða dauða. Silicon Labs vörur eru ekki hannaðar eða heimilaðar fyrir hernaðarlega notkun. Silicon Labs vörur skulu undir engum kringumstæðum notuð í gereyðingarvopnum, þar með talið (en ekki takmarkað við) kjarnorku-, sýkla- eða efnavopn, eða eldflaugar sem geta flutt slík vopn. Silicon Labs afsalar sér allri óbeinum og óbeinum ábyrgðum og ber ekki ábyrgð á meiðslum eða skemmdum sem tengjast notkun Silicon Labs vöru í slíkum óviðkomandi forritum.

Athugið: Þetta efni gæti innihaldið móðgandi hugtök sem eru nú úrelt. Silicon Labs er að skipta út þessum skilmálum fyrir innifalið tungumál þar sem hægt er. Fyrir frekari upplýsingar, heimsækja www.silabs.com/about-us/inclusive-lexicon-project

Upplýsingar um vörumerki
Silicon Laboratories Inc.®, Silicon Laboratories®, Silicon Labs®, SiLabs® og Silicon Labs logo®, Bluegiga®, Bluegiga Logo®, EFM®, EFM32®, EFR, Ember®, Energy Micro, Energy Micro lógó og samsetningar þeirra , „orkuvænustu örstýringar í heimi“, Redpine Signals®, WiSeConnect , n-Link, ThreadArch®, EZLink®, EZRadio®, EZRadioPRO®, Gecko®, Gecko OS, Gecko OS Studio, Precision32®, Simplicity Studio®, Telegesis, Telegesis Logo®, USBXpress®, Zentri, Zentri lógóið og Zentri DMS, Z- Wave® og fleiri eru vörumerki eða skráð vörumerki Silicon Labs. ARM, CORTEX, Cortex-M3 og THUMB eru vörumerki eða skráð vörumerki ARM Holdings. Keil er skráð vörumerki ARM Limited. Wi-Fi er skráð vörumerki Wi-Fi Alliance. Allar aðrar vörur eða vörumerki sem nefnd eru hér eru vörumerki viðkomandi eigenda.

Silicon Laboratories Inc. 400 West Cesar Chavez Austin, TX 78701 Bandaríkin

• www.silabs.com

Skjöl / auðlindir

SILICON LABS Bluetooth SDK Mesh [pdfLeiðbeiningar Bluetooth SDK Mesh, SDK Mesh, Mesh

Heimildir

• Notendahandbók