SILICON LABS Bluetooth SDK võrk
Bluetooth mesh on uus topoloogia, mis on saadaval Bluetoothi madala energiatarbega (LE) seadmetele, mis võimaldavad mitut-mitmele (m:m) sidet. See on optimeeritud suuremahuliste seadmevõrkude loomiseks ja sobib ideaalselt hoonete automatiseerimiseks, andurivõrkudeks ja varade jälgimiseks. Meie tarkvara ja SDK Bluetoothi arendamiseks toetab Bluetooth Meshi ja Bluetooth 5.2 funktsioone. Arendajad saavad LE-seadmetele (nt ühendatud tuled, koduautomaatika ja varade jälgimissüsteemid) lisada võrgusilma. Tarkvara toetab ka Bluetoothi majakaid, majakade skannimist ja GATT-ühendusi, et Bluetooth-võrk saaks ühendada nutitelefonide, tahvelarvutite ja muude Bluetooth LE-seadmetega.
Need väljalaskemärkmed hõlmavad SDK versioone:
- 2.1.10.0, välja antud 25. oktoobril 2023 (EFR32xG22 tugi, versioon D)
- 2.1.9.0, välja antud 5. septembril 2023 (ainult aluseks oleva platvormi muudatused)
- 2.1.8.0, välja antud 13. juulil 2023 (EFR32xG21, versiooni C ja uuemate versioonide tugi)
- 2.1.6.0, välja antud 29. märtsil 2023 (varajase juurdepääsu osa tugi)
- 2.1.5.0, välja antud 11. jaanuaril 2023 (ainult aluseks oleva platvormi muudatused)
- 2.1.4.0, välja antud 13. oktoobril 2021
- 2.1.3.0, välja antud 24. septembril 2021 (ainult Bluetoothi muudatused)
- 2.1.2.0, välja antud 8. septembril 2021
- 2.1.1.0, välja antud 21. juulil 2021
- 2.1.0.0, välja antud 16. juunil 2021
Ühilduvuse ja kasutamise teatised
Turvavärskenduste ja -teadete kohta lisateabe saamiseks vaadake selle SDK-ga installitud Gecko platvormi väljalaskemärkmete peatükki Turvalisus või Silicon Labsi väljalaskemärkmete lehelt. Samuti soovitab Silicon Labs tungivalt tellida ajakohase teabe saamiseks turvanõuanded. Juhiste saamiseks või kui olete Silicon Labsi Bluetoothi võrgusilma SDK uus kasutaja, vaadake jaotist Selle väljalase kasutamine.
Ühilduvad kompilaatorid
IAR Embedded Workbench for ARM (IAR-EWARM) versioon 8.50.9
- Winni kasutamine koostamiseks IarBuild.exe käsurea utiliidi või IAR Embedded Workbenchi GUI-ga MacOS-is või Linuxis võib põhjustada valesid files kasutatakse kokkupõrgete tõttu veini räsimisalgoritmis lühikeste genereerimiseks file nimed.
- MacOS-i või Linuxi klientidel ei soovitata luua IAR-iga väljaspool Simplicity Studio. Kliendid, kes seda teevad, peaksid hoolikalt kontrollima, kas see on õige files on kasutusel.GCC (The GNU Compiler Collection) versioon 10.2.0, mis on varustatud Simplicity Studioga. GCC lingiaja optimeerimise funktsioon on keelatud, mille tulemusena on pildi suurus veidi suurenenud
Uued esemed
Uued funktsioonid
Lisatud versioonis 2.1.0.0 Secure Vault Integration
Alates versioonist 2.1.0.0 kasutab Bluetooth Mesh SDK Secure Vault Key Management funktsiooni Secure Vault High seadmete kasutamisel võrgusilma krüptograafiliste võtmete salvestamiseks. Secure Vault integratsioon on Series 2 seadmetes kliendile nähtav mitmel viisil.
- Krüptograafiliste võtmete NVM3 andmete paigutus ja nendega seotud metaandmed muutuvad. Võtmemigratsioonifunktsioonid on ette nähtud projektidele, mis on loodud SDK versiooni 2.0 või varasemaga. Seadme püsivara värskendamisel tuleb teha ühekordne võtmemigratsioon.
- Põhiandmete nähtavus on tavalistes võrgusõlmedes tahtlikult piiratud. Tavalisel võrgusõlmel pole rakendust lubatud view rakenduse või seadme võtmeandmed kasutades sl_btmesh_node_get_key() BGAPI käsku, samas kui manustatud Provisioneri sõlme rakendusel on see lubatud.
Lisateavet võtmehoidmise kohta Secure Vaultis leiate dokumendist AN1271: Secure Key Storage.
Kompilaatori tugi
Toetatud kompilaatorid on värskendatud GCC versioonile 10.2.0 ja IAR versioonile 8.50.9.
Uus Example Rakendused
HSL valgustus example (Bluetooth Mesh – SoC HSL Light) lisati, et demonstreerida valgussõlme, mida saab juhtida üle HSL-i serverimudelite. Pro arenduskomplektides (SLWRB4104A, SLWRB4181A, SLWRB4181B, SLWRB4182A) olevatele raadioplaatidele lisati IOP demod (Bluetooth Mesh – IOP Test – *). Demod võimaldavad testida koostalitlusvõimet mobiiltelefonidega. Test nõuab nelja endistamples, iga eksample esindab üht võrgusilma funktsiooni: puhverserver, relee, sõber ja LPN.
Uued komponendid
- Lisati HSL-i serverikomponent.
- Lisati dünaamilise GATT-i andmebaasi tugi (Bluetooth LE funktsioon).
Versioonis 2.1.4.0 on lisatud uued API-d
Ajaserveri mudeli API-le lisati selgesõnalise ajaoleku sõnumi saatmise funktsioon sl_btmesh_time_server_status() ja vastav selgesõnaline avaldamisfunktsioon sl_btmesh_time_server_publish().
Lisatud versioonis 2.1.2.0
Vaikimisi ei saa tavaline Meshi seade, mis ei ole teenusepakkuja, turvavõtmeandmeid BGAPI kaudu eksportida. Kui sellises seadmes on vaja võtme eksportimist, peaks see enne võtmete loomist sõlmes kasutama uut BGAPI käsku sl_btmesh_node_set_exportable_keys(). See hõlmab võtmeid, mis on loodud seadme ettevalmistamise ajal. Lisatud on diagnostiline sündmus, mis teavitab rakendust ajastatud stseenimuudatusest, sl_btmesh_scheduler_server_scene_changed().
Lisatud versioonis 2.1.1.0
Stseenimudelite puhvrikasutuse optimeerimiseks on lisatud valikuline API, mis võimaldab tihendatud stseeni tagasikutsumise sündmusi (viide väljaande ID 706555). Soovitatav on kasutada uut API-d, kui sõlmel on palju mudeleid või kui võrguliikluse hulk, mida sõlm eeldatavasti kuuleb, on suur. Uue API aktiveerimiseks kasutage BGAPI käsku sl_btmesh_scene_server_enable_compact_recall_events(). Seejärel annab sl_btmesh_evt_scene_server_compact_recall_events stseeni tagasikutsumise taotlustest märku. Vahemällu salvestatud mudeli olekute toomiseks pärast stseeni tagasikutsumise taotlust kasutage käsku sl_btmesh_generic_server_get_cached_state().
Lisatud versioonis 2.1.0.0
Secure Vault integratsiooni tõttu on krüpteerimisvõtmete ja nendega seotud metaandmete salvestamise üksikasjad Series 2 seadmetes muutunud. Seetõttu on lisatud uus BGAPI klass krüpteerimisvõtmete ja sisseehitatud teenusepakkuja seadmete andmebaasi migreerimiseks pärast seeria 2 seadmete püsivara värskendust. Sellel on järgmised käsud:
- sl_btmesh_migration_migrate_keys
- sl_btmesh_migration_migrate_ddb
Täiustused
Muudetud API-sid
Muudetud versioonis 2.1.2.0
Ajavööndi parameeter failis sl_btmesh_time_server_get_datetime() on parandatud märgiga 16-bitiseks täisarvuks. Kella täpsuse parameeter sl_btmesh_lpn_clock_accuracy on lisatud LPN-i konfiguratsiooni. Seda parameetrit saab kasutada LPN-i unerežiimi häälestamiseks, kui seadme kella triivi tõttu ei jäta LPN küsitluse ajalõpu vahele.
Muudetud versioonis 2.1.1.0
Sündmus sl_btmesh_evt_friend_friendship_terminated genereeritakse nüüd, kui Configuration Client keelab sõlme sõbra funktsiooni, kui sõprus on aktiivne. Varem andis sellises olukorras sõpruse lõppemisest kaudselt märku sündmus sl_btmesh_evt_node_config_set. (Viitenumbri iD 627811)
Muudetud versioonis 2.1.0.0
Järgmised prov-klassi BGAPI-käsud naasevad nüüd pärast parameetrite valideerimist ja tegelik nõutud toiming toimub pärast BGAPI-vastuse andmist. Nõutud toimingu lõpetamisest annab märku vastav BGAPI sündmus:
- sl_btmesh_prov_add_ddb_entry() – lisamise lõpetamisest annab märku sl_btmesh_evt_prov_add_ddb_entry_complete
- sl_btmesh_prov_delete_ddb_entry() – kustutamise lõpetamisest annab märku sl_btmesh_evt_prov_delete_ddb_entry_complete Järgmisel prov-klassi BGAPI käsul on lisasündmus, mis võidakse genereerida pärast selle väljakutsumist:
- sl_btmesh_prov_init – lisaks sl_btmesh_evt_prov_initializedile võidakse genereerida ka sl_btmesh_evt_prov_initialization_failed. BGAPI-käsk on lisatud üldisele kliendimudelile BGAPI:
mesh_generic_client_init_hsl()
BGAPI-käsk on lisatud üldisele serverimudelile BGAPI:
mesh_generic_server_init_hsl()
Parandatud probleemid
Parandatud versioonis 2.1.4.0
| ID nr | Kirjeldus |
| 729116 | Parandatud on Time Serveri mudeli tahtmatu korrutamise probleem projekti uute elementide lisamisel |
| 735569 | Segmenteeritud multiedastussõnumite fikseeritud käsitlemine, mida sõbersõlm edastab väikese võimsusega sõlmele |
Parandatud versioonis 2.1.2.0
| ID nr | Kirjeldus |
| 627811 | Looge sõpruse lõpetamise sündmus, kui lõpetamist taotletakse kohapeal |
| 676798 | Võtke LPN-i küsitluse äratuse ajastusel arvesse kella ebatäpsust |
| 683518 | Looge sõpruse lõpetamise sündmus kohe, kui saate Sõbra tühjendamise sõnumi |
| 703974 | Parandatud on südamelöökidega seotud kvalifikatsioonitesti probleem |
| 709948 | Pakkus API turvavõtmete eksporditavuse kontrollimiseks võrgusõlmes |
| 724511 | Lahendatud on probleem 0x1F-i ületavate tarnija opkoodide registreerimisel |
| 730273 | Lahendatud on negatiivse ajavööndi nihke käsitlemisega seotud probleem |
| 731713 | Parandatud potentsiaalne mäluleke segmenteeritud sõnumite saatmisega, kui seadmel on vähe mälu |
| 734034 | Fikseeritud side sõbralt LPN-iga, kui TTL on null |
| 734858 | Parandasime võimaliku virnamuutuja probleemi PSA struktuuri käsitlemisel |
| 736054 | Lahendatud on mudeli-rakenduse võtme sidumisega seotud kvalifikatsioonitesti probleem |
Parandatud versioonis 2.1.1.0
| ID nr | Kirjeldus |
| 692961 | Parandatud, kui sõlm ei reageeri, kui relee kordusedastused olid suure koormuse korral lubatud |
| 713152 | Lahendatud on probleem, kus arvutuse piiratud täpsus põhjustas ümardamisvigu tegeliku valguse heleduse ja lineaarse valguse heleduse sidumisel |
Parandatud versioonis 2.1.0.0
| ID nr | Kirjeldus |
| 3878 | Rakendus peaks võrguomaduste puhul ignoreerima GATT-i sündmusi |
| 342521 | Matemaatika teek ei suurenda asjatult pildi suurust |
| 358019 | Parandatud tulemuse kood, mis antakse, kui taotletakse mudeli avaldamist koos sõpruse mandaadiga, kuid sõprust ei toetata |
| 404070 | Parandatud tulemuse kood, mis antakse siis, kui võrguvõtme loomiseks ettekandja käsk kutsutakse välja mitte-varustaja seadmes |
| 454332 | Seadme kohaliku nime reklaamimiseks tuleks kasutada LE GAP API-t |
| 464907 | Eemaldatud tarbetu "südamelöögi alustatud" BGAPI sündmus, kui konfiguratsiooniklient keelab sõlmes südamelöögi |
| 653405 | Karbist välja võetud lüliti samprakenduse voolutarve on nüüd oodatud tasemel |
| 654477 | Network Analyzeri poolt õigesti dekodeeritud DCD |
| 660048 | Nupuvajutuse UC komponent ei vaja asjatult IO Streami komponenti |
| 687105 | BT võrgukäsud töötavad koos NCP Target example ja NCP ülem |
| 690803 | Koodigeneraatoris on parandatud dubleerivad hankija mudeli ID-d |
| 690862 | SoC tühi example hakkab nüüd xG22 riistvaral majakama |
| 707497 | Parandatud PSA krüptograafilise konteksti jaotus |
| 707524 | Parandatud regressioon IV taastumiskaitse taimeriga, mis ei lubanud liiga vara uut taastumist |
| ID nr | Kirjeldus |
| 710381 | Parandatud valgustuse vaikeseisundi käsitlemine, kui vastava mudeli jaoks oli määratud mittevaikevahemik |
| 711359 | Parandatud parameetrite kontrollimine seansi loomise BGAPI-kõne jaoks |
Teadaolevad probleemid praeguses väljaandes
Paksus kirjas olevad probleemid on lisatud alates eelmisest väljaandest.
| ID nr | Kirjeldus | Lahendus |
| 401550 | BGAPI sündmus puudub segmenteeritud sõnumite töötlemise tõrke korral | Rakendus peab tuletama ebaõnnestumise ajalõpu / rakenduskihi vastuse puudumise põhjal |
| 418636 | Probleemid mesh_test kohaliku konfiguratsiooni oleku API-ga (sõlme identiteet, relee, võrgu taasedastus) | |
| 454059 | KR-protsessi lõpus genereeritakse suur hulk võtme värskendusoleku muutmise sündmusi ja see võib NCP järjekorra üle ujutada | Suurendage projektis NCP järjekorra pikkust |
| 454061 | Täheldati jõudluse kerget halvenemist võrreldes 1.5-ga edasi-tagasi latentsustestides | |
| 624514 | Probleem ühendatava reklaami taastamisega, kui kõik ühendused on olnud aktiivsed ja GATT-i puhverserver on kasutusel | Eraldage üks ühendus rohkem kui vaja |
| 650825 | Probleem kordusedastusega, kui mudel avaldatakse perioodiliselt | Seadistage kordusedastused mudeli olekus ja käivitage perioodiline avaldamine rakenduse taimeri abil |
Aegunud üksused
Järgmine BGAPI käsk sõlmeklassis on aegunud: sl_btmesh_node_erase_mesh_nvm() – kasutage selle asemel käsku sl_btmesh_node_reset().
Eemaldatud üksused
- Mitte ühtegi
Selle väljalase kasutamine
See väljaanne sisaldab järgmist
- Silicon Labsi Bluetoothi võrgu virnade raamatukogu
- Bluetooth sample rakendusi
Kui kasutate esimest korda, vaadake QSG176: Silicon Labs Bluetooth Mesh SDK v2.x kiirjuhendit.
Paigaldamine ja kasutamine
Silicon Labsi Bluetoothi SDK allalaadimiseks on vaja Silicon Labsi registreeritud kontot. Registreerida saab aadressil https://sili-conlabs.force.com/apex/SL_CommunitiesSelfReg?form=short. Virna paigaldamise juhised on esitatud QSG176: Silicon Labs Bluetooth Mesh SDK v2.x kiirjuhendis. Kasutage Bluetooth mesh SDK-d koos Silicon Labs Simplicity Studio V4 arendusplatvormiga. Simplicity Studio tagab, et enamikku tarkvara ja tööriistade ühilduvusi hallatakse õigesti. Installige tarkvara ja plaadi püsivara värskendused kohe, kui teid teavitatakse. SDK-ga installitakse koos SDK versiooniga seotud dokumentatsioon. Lisateavet leiate sageli teadmistebaasi artiklitest (KBA). API viited ja muu teave selle ja varasemate versioonide kohta on saadaval aadressil https://docs.silabs.com/.
Turvateave Secure Vault Integration
See virna versioon on integreeritud Secure Vault Key Managementiga. Secure Vault High seadmetes juurutamisel kaitstakse võrgusilma krüpteerimisvõtmeid Secure Vault Key Management funktsiooni abil. Allolevas tabelis on näidatud kaitstud võtmed ja nende salvestuskaitse omadused.
| Võti | Eksporditavus sõlmes | Eksporditavus Provisioneril | Märkmed |
| Võrguvõti | Eksporditav | Eksporditav | Võrguvõtme tuletised eksisteerivad ainult RAM-is, samas kui võrguvõtmed on salvestatud välkmällu |
| Rakenduse võti | Mitteeksporditav | Eksporditav | |
| Seadme võti | Mitteeksporditav | Eksporditav | Provisioneri puhul rakendatakse nii Provisionerri enda seadme võtmele kui ka teiste seadmete võtmetele |
Klahve, mis on märgistatud kui „Ei eksporditav”, saab kasutada, kuid mitte viewredigeeritud või käitusajal jagatud. Võtmeid, mis on märgitud kui „Eksporditav”, saab kasutada või jagada käitusajal, kuid need jäävad krüpteerituks, kui neid salvestatakse välkmälu. Lisateavet Secure Vault Key Management funktsioonide kohta leiate artiklist AN1271: Secure Key Storage
Turvameetmed
Turvanõuannete tellimiseks logige sisse Silicon Labsi kliendiportaali ja valige seejärel Konto avaleht. Portaali avalehele minemiseks klõpsake AVALEHT ja seejärel paani Märguannete haldamine. Veenduge, et valik „Tarkvara/turvalisuse teatised ja tootemuudatuste teatised (PCN-id)” on märgitud ning et olete oma platvormi ja protokolli jaoks vähemalt tellinud. Muudatuste salvestamiseks klõpsake nuppu Salvesta.
Toetus
Arenduskomplekti klientidel on õigus saada koolitust ja tehnilist tuge. Kasutage Silicon Labsi Bluetoothi võrku web lehel, et saada teavet kõigi Silicon Labsi Bluetoothi toodete ja teenuste kohta ning registreeruda tootetoe saamiseks. Võtke ühendust Silicon Laboratories toega aadressil http://www.silabs.com/support.
Lihtsuse stuudio
Ühe klõpsuga juurdepääs MCU-le ja juhtmevabadele tööriistadele, dokumentatsioonile, tarkvarale, lähtekooditeekidele ja muule. Saadaval Windowsi, Maci ja Linuxi jaoks!
- IoT portfell
- SW/HW
- Kvaliteet
- Tugi ja kogukond
Vastutusest loobumine
Silicon Labs kavatseb pakkuda klientidele uusimat, täpset ja põhjalikku dokumentatsiooni kõigi Silicon Labsi tooteid kasutavate või kasutada kavatsevate süsteemi- ja tarkvararakendajate jaoks saadaolevate välisseadmete ja moodulite kohta. Iseloomustusandmed, saadaolevad moodulid ja välisseadmed, mälumahud ja mäluaadressid viitavad igale konkreetsele seadmele ning pakutavad "tüüpilised" parameetrid võivad erinevates rakendustes erineda. Rakendus ntampsiin kirjeldatud on ainult illustratiivsel eesmärgil. Silicon Labs jätab endale õiguse teha siin esitatud tooteteavet, spetsifikatsioone ja kirjeldusi ilma täiendava etteteatamata muudatusi ega anna garantiid lisatud teabe täpsuse või täielikkuse kohta. Ilma eelneva teavituseta võib Silicon Labs turvalisuse või töökindluse huvides tootmisprotsessi käigus toote püsivara värskendada. Sellised muudatused ei muuda toote tehnilisi andmeid ega toimivust. Silicon Labs ei vastuta selles dokumendis esitatud teabe kasutamise tagajärgede eest. See dokument ei viita ega anna selgesõnaliselt litsentsi mis tahes integraallülituste projekteerimiseks või valmistamiseks. Tooted ei ole ette nähtud ega lubatud kasutamiseks FDA III klassi seadmetes, rakendustes, mille jaoks on nõutav FDA eelmüügiluba, ega elu toetavates süsteemides ilma Silicon Labsi konkreetse kirjaliku nõusolekuta. "Elu toetav süsteem" on mis tahes toode või süsteem, mis on mõeldud elu ja/või tervise toetamiseks või säilitamiseks, mille ebaõnnestumise korral võib mõistlikult eeldada, et see toob kaasa märkimisväärse kehavigastuse või surma. Silicon Labsi tooted ei ole loodud ega lubatud sõjaliseks kasutamiseks. Silicon Labsi tooteid ei tohi mingil juhul kasutada massihävitusrelvades, sealhulgas (kuid mitte ainult) tuuma-, bioloogilistes või keemiarelvades ega rakettides, mis on võimelised selliseid relvi kohale toimetama. Silicon Labs loobub kõigist otsestest ja kaudsetest garantiidest ega vastuta vigastuste või kahjude eest, mis on seotud Silicon Labsi toote kasutamisega sellistes volitamata rakendustes.
Märkus. See sisu võib sisaldada solvavat terminoloogiat, mis on nüüdseks aegunud. Silicon Labs asendab need terminid võimaluse korral kaasava keelega. Lisateabe saamiseks külastage www.silabs.com/about-us/inclusive-lexicon-project
Kaubamärgi teave
Silicon Laboratories Inc.®, Silicon Laboratories®, Silicon Labs®, SiLabs® ja Silicon Labsi logo®, Bluegiga®, Bluegiga Logo®, EFM®, EFM32®, EFR, Ember®, Energy Micro, Energy Micro logo ja nende kombinatsioonid , "maailma kõige energiasäästlikumad mikrokontrollerid", Redpine Signals®, WiSeConnect, n-Link, ThreadArch®, EZLink®, EZRadio®, EZRadioPRO®, Gecko®, Gecko OS, Gecko OS Studio, Precision32®, Simplicity Studio®, Telegesis, Telegesise logo®, USBXpress®, Zentri, Zentri logo ja Zentri DMS, Z-Wave® ja teised on Siliconi kaubamärgid või registreeritud kaubamärgid Laborid. ARM, CORTEX, Cortex-M3 ja THUMB on ettevõtte ARM Holdings kaubamärgid või registreeritud kaubamärgid. Keil on ettevõtte ARM Limited registreeritud kaubamärk. Wi-Fi on Wi-Fi Alliance'i registreeritud kaubamärk. Kõik muud siin mainitud tooted või kaubamärgid on nende vastavate omanike kaubamärgid.
Silicon Laboratories Inc. 400 West Cesar Chavez Austin, TX 78701 USA
Dokumendid / Ressursid
 |
SILICON LABS Bluetooth SDK võrk [pdfJuhised Bluetooth SDK Mesh, SDK Mesh, Mesh |
