SILICON-LABS-Blog

SILICON LABS Bluetooth Mesh SDK Embedded Software

SILICON-LABS-Bluetooth-Mesh-SDK-Embedded-Software-User-Guide-product

Produktspecifikationer

  • Produktnavn: Simplicity SDK Suite
  • Version: 2024.6.0
  • Udgivelsesdato: 5. juni 2024
  • Bluetooth Mesh-specifikationsversion: 1.1

Produktbrugsvejledning

Bluetooth mesh er en ny topologi tilgængelig for Bluetooth Low Energy (LE) enheder, der muliggør mange-til-mange (m:m) kommunikation. Den er optimeret til at skabe større enhedsnetværk og er ideel til bygningsautomatisering, sensornetværk og aktivsporing. Vores software og SDK til Bluetooth-udvikling understøtter Bluetooth Mesh- og Bluetooth-funktionalitet. Udviklere kan tilføje mesh-netværkskommunikation til LE-enheder såsom tilsluttede lys, hjemmeautomatisering og systemer til sporing af aktiver. Softwaren understøtter også Bluetooth-beaconing, beacon-scanning og GATT-forbindelser, så Bluetooth-mesh kan oprette forbindelse til smartphones, tablets og andre Bluetooth LE-enheder. Denne udgivelse indeholder funktioner, der understøttes af Bluetooth-mesh-specifikationen version 1.1.

Disse udgivelsesbemærkninger dækker SDK-versioner:
7.0.0.0 udgivet 5. juni 2024

Kompatibilitet og brugsmeddelelser
For flere oplysninger om sikkerhedsopdateringer og meddelelser, se kapitlet Sikkerhed i Platform Release Notes installeret med denne SDK eller på Silicon Labs Release Notes-siden. Silicon Labs anbefaler også kraftigt, at du abonnerer på Security Advisories for at få opdateret information. For instruktioner, eller hvis du er ny til Silicon Labs Bluetooth mesh SDK, se Brug af denne udgivelse.

Kompatible compilere
IAR Embedded Workbench til ARM (IAR-EWARM) version 9.40.1

  • Brug af vin til at bygge med kommandolinjeværktøjet IarBuild.exe eller IAR Embedded Workbench GUI på macOS eller Linux kan resultere i forkerte files bliver brugt på grund af kollisioner i vins hashing-algoritme til at generere short file navne.
  • Kunder på macOS eller Linux frarådes at bygge med IAR uden for Simplicity Studio. Kunder, der gør, bør omhyggeligt verificere, at det er korrekt files bliver brugt.

GCC (The GNU Compiler Collection) version 12.2.1, forsynet med Simplicity Studio.

  • Link-tidsoptimeringsfunktionen i GCC er blevet deaktiveret, hvilket resulterer i en lille stigning i billedstørrelsen.

Nye varer
Simplicity SDK er en indlejret softwareudviklingsplatform til at bygge IoT-produkter baseret på vores Series 2 og Series 3 trådløse og MCU-enheder. Den integrerer trådløse protokolstakke, middleware, perifere drivere, en bootloader og applikationseks.amples – en solid ramme til at bygge strømoptimerede og sikre IoT-enheder. Simplicity SDK tilbyder kraftfulde funktioner såsom ultralavt strømforbrug, stærk netværkspålidelighed, understøttelse af et stort antal noder og abstraktion af komplekse krav som multiprotokol og præcertificering. Derudover leverer Silicon Labs over-the-air (OTA) software og sikkerhedsopdateringer til fjernopdatering af enheder, minimerer vedligeholdelsesomkostninger og forbedrer slutbrugerens produktoplevelse. Simplicity SDK er en opfølgning af vores populære Gecko SDK, som fortsat vil være tilgængelig og yde langsigtet support til vores serie 0- og serie 1-enheder.

For yderligere information om serie 0- og serie 1-enhederne henvises til: Serie 0 og Serie 1 EFM32/EZR32/EFR32 enhed (silabs.com).

Nye funktioner

Tilføjet i udgivelse 7.0.0.0
Understøttelse af Clock Manager er blevet tilføjet. Stakkomponenterne bruger ikke længere device_init() til urinitialisering. I stedet skal applikationsprojektet nu inkludere clock_manager-komponenten, som udfører urinitialiseringen. Understøttelse af Common Memory Manager er blevet tilføjet.

Nye API'er
Tilføjet i udgivelse 7.0.0.0 Ingen.

Forbedringer

  • En node BGAPI-klassekommando, sl_btmesh_node_test_identity, er blevet tilføjet til kontrol af node-identitetsannoncekilder.
  • Low Power Node-funktion tilføjet til sensorserver f.eksamples.
  • Ven-funktion tilføjet til sensorserverklienten f.eksample.

Ændret i udgivelse 7.0.0.0

  • BGAPI ændringer:
    En node BGAPI-klassekommando, sl_btmesh_node_test_identity, er blevet tilføjet for at kontrollere, om en modtaget node-identitetsannonce stammer fra en given node eller ej.
  • Exampapplikationsændringer:
    Low Power Node-funktion er blevet tilføjet til sensorserver f.eksamples (btmesh_soc_sensor_thermometer, btmesh_soc_nlc_sensor_oc-cupancy btmesh_soc_nlc_sensor_ambient_light), og Friend-funktionen blev tilføjet til sensorserverklienten ex.ample (btmesh_soc_sen-sor_client).

Faste problemer
Rettet i udgivelse 7.0.0.0

  • Undgå at starte annoncebærer, hvis noden klargøres ved kun at bruge PB-GATT.
  • Forbedret rapportering af provisioneringshændelser på en overbelastet enhed.
  • Forbedret DFU-hændelsesrapportering på en overbelastet enhed.
  • Fejlrapportering tilføjet, hvis Blob Transfer-konfigurationen på noden er utilstrækkelig for DFU Distributor- og Standalone Updater-modeller.
  • Rettet lagring af afspilningsbeskyttelse til NVM3 ved brug af sl_btmesh_node_power_off() API.
ID # Beskrivelse
356148 Undgår at starte reklamebærer, hvis noden klargøres ved kun at bruge PB-GATT.
1250461 Gjorde rapportering af provisioneringshændelser mere robust på en overbelastet enhed.
1258654 Gjorde DFU-hændelsesrapportering mere robust på en overbelastet enhed.
1274632 DFU Distributor og Standalone Updater-modeller vil nu rapportere en fejl, hvis Blob Transfer-konfigurationen på noden ikke er tilstrækkelig.
1284204 Rettet lagring af genafspilningsbeskyttelse til NVM3, når applikationen bruger sl_btmesh_node_power_off() API.

Kendte problemer i den aktuelle udgivelse
Udgaver med fed er tilføjet siden den forrige udgivelse.

  • Ingen BGAPI-hændelse for segmenteret meddelelseshåndteringsfejl.
  • Potentiel oversvømmelse af NCP-kø med ændringshændelser for nøgleopdateringstilstand.
  • Let forringelse af ydeevnen i round-trip latency tests sammenlignet med version 1.5.
  • Problemer med at genetablere tilslutningsbar annoncering, hvis alle forbindelser er aktive, og GATT-proxy er i brug.
  • Dårlig ydeevne af segmenteret meddelelsestransmission over GATT-bærer.
ID # Beskrivelse Løsning
401550 Ingen BGAPI-hændelse for segmenteret meddelelseshåndteringsfejl. Applikationen skal udlede fejl fra timeout/manglende applikationslagsrespons; for leverandørmodeller er der leveret en API.
454059 Et stort antal nøgleopdateringstilstandsændringshændelser genereres i slutningen af ​​KR-processen, og det kan oversvømme NCP-køen. Øg NCP-kølængden i projektet.
454061 Der blev observeret en let ydeevneforringelse sammenlignet med 1.5 i round-trip latenstest.
624514 Problem med at genetablere tilslutningsbar annoncering, hvis alle forbindelser har været aktive, og GATT-proxy er i brug. Tildel en forbindelse mere end nødvendigt.
841360 Dårlig ydeevne af segmenteret meddelelsestransmission over GATT-bærer. Sørg for, at den underliggende BLE-forbindelses forbindelsesinterval er kort; sikre, at ATT MTU er stor nok til at passe til en fuld mesh PDU; tuner minimumslængden af ​​forbindelsesbegivenheden for at tillade, at flere LL-pakker kan transmitteres pr. forbindelseshændelse.
1121605 Afrundingsfejl kan forårsage, at planlagte hændelser udløses på meget lidt anderledes tidspunkter end forventet.
1226127 Værtsformidler example kan sidde fast, når den begynder at klargøre en anden node. Genstart værtsprovisioneringsappen før klargøring af den anden node.
1204017 Distributøren er ikke i stand til at håndtere parallel selv FW Update og FW Upload. Kør ikke selv FW-opdatering og FW-upload parallelt.
1301325 Planlægningshandlinger gemmes ikke korrekt til vedvarende lagring.
1305041 NCP-kommunikation fra vært til EFR32 kan timeout. sl_simple_com_usart.c kan redigeres for at rette en timeoutværdi.
1305928 Opsætning af 10 eller flere opdateringsknuder som DFU-modtagere kan mislykkes på SoC-distributørappen.

Forældede varer
Forældet i udgivelse 7.0.0.0
BGAPI-kommandoen sl_btmesh_prov_test_identity er blevet forældet. Brug sl_btmesh_node_test_identity i stedet.

Fjernede elementer
Fjernet i release 7.0.0.0
Understøttelse af serie 1-hardware (xG12 og xG13) er blevet fjernet i denne udgivelse.

Brug af denne udgivelse
Denne udgivelse indeholder følgende

  • Silicon Labs Bluetooth mesh stack bibliotek
  • Bluetooth mesh sample applikationer

Hvis du er en førstegangsbruger, se QSG176: Silicon Labs Bluetooth Mesh SDK v2.x Quick-Start Guide.

Installation og brug
Bluetooth-mesh-SDK'et leveres som en del af Simplicity SDK (GSDK), pakken af ​​Silicon Labs SDK'er. For hurtigt at komme i gang med Simplicity SDK, skal du installere Simplicity Studio 5, som opsætter dit udviklingsmiljø og leder dig gennem Simplicity SDK installationen. Simplicity Studio 5 inkluderer alt det nødvendige til IoT-produktudvikling med Silicon Labs-enheder, inklusive en ressource- og projektstarter, softwarekonfigurationsværktøjer, fuld IDE med GNU-værktøjskæde og analyseværktøjer. Installationsvejledningen findes i online Simplicity Studio 5-brugervejledningen. Alternativt kan Simplicity SDK installeres manuelt ved at downloade eller klone det seneste fra GitHub. Se https://github.com/Sili-conLabs/simplicity_sdk for mere information.

Simplicity Studio installerer Simplicity SDK som standard i:

  • Windows:
    • C:\Brugere\ \SimplicityStudio\SDKs\simplicity_sdk
  • MacOS: /Brugere/ /SimplicityStudio/SDKs/simplicity_sdk
    Dokumentation, der er specifik for SDK-versionen, er installeret med SDK. Yderligere information kan ofte findes i videnbaseartiklerne (KBA'er). API-referencer og anden information om denne og tidligere udgivelser er tilgængelig på https://docs.silabs.com/.

Sikkerhedsoplysninger

Nøgle Eksporterbarhed på en node Eksporterbarhed på Provisioner Noter
Netværksnøgle Kan eksporteres Kan eksporteres Afledninger af netværksnøglen findes kun i RAM, mens netværksnøgler er gemt på flash
Applikationsnøgle Ikke-eksporterbar Kan eksporteres
Enhedsnøgle Ikke-eksporterbar Kan eksporteres I Provisioners tilfælde anvendt på Provisionerrs egen enhedsnøgle samt andre enheders nøgler

Sikker Vault-integration
Denne version af stakken er integreret med Secure Vault Key Management. Når de implementeres på Secure Vault High-enheder, er mesh-krypteringsnøgler beskyttet ved hjælp af Secure Vault Key Management-funktionaliteten. Tabellen nedenfor viser de beskyttede nøgler og deres opbevaringsbeskyttelsesegenskaber.

  • Nøgler, der er markeret som "Ikke-eksporterbare", kan bruges, men kan ikke være det viewredigeres eller deles under kørsel.
  • Nøgler, der er markeret som "Eksporterbare", kan bruges eller deles under kørsel, men forbliver krypterede, mens de opbevares i flash.
  • For mere information om Secure Vault Key Management-funktionalitet, se AN1271: Sikker nøgleopbevaring.

Sikkerhedsadvarsler
For at abonnere på Security Advisories skal du logge ind på Silicon Labs kundeportal og derefter vælge Konto Hjem. Klik på HJEM for at gå til portalens startside, og klik derefter på feltet Administrer meddelelser. Sørg for, at 'Software/sikkerhedsrådgivningsmeddelelser og produktændringsmeddelelser (PCN'er)' er markeret, og at du som minimum er tilmeldt din platform og protokol. Klik på Gem for at gemme eventuelle ændringer.

SILICON-LABS-Bluetooth-Mesh-SDK-Embedded-Software-User-Guide-fig-1

Støtte
Development Kit-kunder er berettiget til træning og teknisk support. Brug Silicon Labs Bluetooth-mesh web side for at få oplysninger om alle Silicon Labs Bluetooth-produkter og -tjenester og for at tilmelde dig produktsupport.
Kontakt Silicon Laboratories support på http://www.silabs.com/support.

Simplicity Studio
Et-klik adgang til MCU og trådløse værktøjer, dokumentation, software, kildekodebiblioteker og mere. Tilgængelig til Windows, Mac og Linux!

Ansvarsfraskrivelse
Silicon Labs har til hensigt at give kunderne den nyeste, nøjagtige og dybdegående dokumentation af alle perifere enheder og moduler, der er tilgængelige for system- og softwareimplementere, der bruger eller har til hensigt at bruge Silicon Labs-produkter. Karakteriseringsdata, tilgængelige moduler og ydre enheder, hukommelsesstørrelser og hukommelsesadresser refererer til hver specifik enhed, og de "typiske" parametre, der leveres, kan og varierer i forskellige applikationer. Ansøgning exampDe heri beskrevne er kun til illustrative formål. Silicon Labs forbeholder sig retten til uden yderligere varsel at foretage ændringer af produktinformationen, specifikationer og beskrivelser heri, og giver ingen garantier for nøjagtigheden eller fuldstændigheden af ​​den inkluderede information. Uden forudgående meddelelse kan Silicon Labs opdatere produktfirmware under fremstillingsprocessen af ​​sikkerheds- eller pålidelighedsgrunde. Sådanne ændringer vil ikke ændre produktets specifikationer eller ydeevne. Silicon Labs påtager sig intet ansvar for konsekvenserne af brugen af ​​oplysningerne i dette dokument. Dette dokument antyder eller giver ikke udtrykkeligt nogen licens til at designe eller fremstille integrerede kredsløb. Produkterne er ikke designet eller godkendt til at blive brugt i nogen FDA Klasse III-enheder, applikationer, hvortil FDA-godkendelse på forhånd er påkrævet, eller Life Support Systems uden specifikt skriftligt samtykke fra Silicon Labs. Et "Livsstøttesystem" er ethvert produkt eller system beregnet til at understøtte eller opretholde liv og/eller sundhed, som, hvis det fejler, med rimelighed kan forventes at resultere i betydelig personskade eller død. Silicon Labs produkter er ikke designet eller godkendt til militære applikationer. Silicon Labs produkter må under ingen omstændigheder bruges i masseødelæggelsesvåben, herunder (men ikke begrænset til) nukleare, biologiske eller kemiske våben eller missiler, der er i stand til at levere sådanne våben. Silicon Labs fraskriver sig alle udtrykkelige og underforståede garantier og er ikke ansvarlig for skader eller skader relateret til brug af et Silicon Labs-produkt i sådanne uautoriserede applikationer.

Note: Dette indhold kan indeholde stødende terminologi, som nu er forældet. Silicon Labs erstatter disse vilkår med inkluderende sprog, hvor det er muligt. For mere information, besøg www.silabs.com/about-us/inclusive-lexicon-project

Varemærkeoplysninger
Silicon Laboratories Inc.®, Silicon Laboratories®, Silicon Labs®, SiLabs® og Silicon Labs logoet®, Bluegiga®, Bluegiga Logo®, EFM®, EFM32®, EFR, Ember®, Energy Micro, Energy Micro-logoet og kombinationer deraf , "verdens mest energivenlige mikrocontrollere", Redpine Signals®, WiSeConnect, n-Link, EZLink®, EZRadio®, EZRadioPRO®, Gecko®, Gecko OS, Gecko OS Studio, Precision32®, Simplicity Studio®, Telegesis, Telegesis Logo®, USBXpress®, Zentri, Zentri-logoet og Zentri DMS, Z-Wave® og andre er varemærker eller registrerede varemærker tilhørende Silicon Labs. ARM, CORTEX, Cortex-M3 og THUMB er varemærker eller registrerede varemærker tilhørende ARM Holdings. Keil er et registreret varemærke tilhørende ARM Limited. Wi-Fi er et registreret varemærke tilhørende Wi-Fi Alliance. Alle andre produkter eller mærkenavne nævnt heri er varemærker tilhørende deres respektive indehavere.

Ofte stillede spørgsmål (FAQ)

Q: Hvor kan jeg finde flere oplysninger om sikkerhedsopdateringer?
Sv: Se kapitlet Sikkerhed i Platform Release Notes eller besøg Silicon Labs Release Notes-siden for detaljerede sikkerhedsopdateringer.

Q: Hvordan inkluderer jeg clock_manager-komponenten til urinitialisering?
A: For at inkludere clock_manager-komponenten til urinitialisering skal du sørge for at opdatere dit applikationsprojekt i overensstemmelse hermed i henhold til de medfølgende instruktioner i brugervejledningen.

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

IoT-portefølje
www.silabs.com/IoT

SW/HW
www.silabs.com/simplicity

Kvalitet
www.silabs.com/quality

Support og fællesskab
www.silabs.com/community

Dokumenter/ressourcer

SILICON LABS Bluetooth Mesh SDK Embedded Software [pdfBrugervejledning
Bluetooth Mesh SDK Embedded Software, Mesh SDK Embedded Software, SDK Embedded Software, Embedded Software, Software

Referencer

Efterlad en kommentar

Din e-mailadresse vil ikke blive offentliggjort. Påkrævede felter er markeret *