SILICON LABS Zigbee EmberZ Net SDK Instruktioner

Silicon Labs er den foretrukne leverandør for OEM'er, der udvikler Zigbee-netværk i deres produkter. Silicon Labs Zigbee-platformen er den mest integrerede, komplette og funktionsrige Zigbee-løsning, der findes. Silicon Labs EmberZNet SDK indeholder Silicon Labs' implementering af Zigbee stack-specifikationen.

NØGLEFUNKTIONER

Zigbee

-250+ poster i APS-linknøgletabellen
ZigbeeD-understøttelse på Android 12 (v21.0.6113669) og Tizen (v0.1-13.1)

xG26 modulunderstøttelse

Multiprotokol

ZigbeeD- og OTBR-understøttelse på OpenWRT – GA
DMP BLE + CMP ZB & Matter/OT med samtidig lytning på MG26 til SoC – GA

802.15.4 Unified radio scheduler prioritetskomponent
Debian-pakkeunderstøttelse til MP-værtsapplikationer – Alpha

Nye varer

Vigtige ændringer
APS-linknøgletabelstørrelsen (konfigureret ved hjælp af SL_ZIGBEE_KEY_TABLE_SIZE) er udvidet fra 127 til 254 poster.

R23-understøttelse er tilføjet til ZDD Network idriftsættelsesfunktionalitet. Tunneling-funktionalitet er tilgængelig uden understøttelse af Legacy Network-brugssager.

Komponenterne Network Steering og Network Creator er blevet opdateret til at inkludere understøttelse af R23-tilmelding. Disse omfatter følgende relaterede ændringer.
- Standardanmodningspolitikken for Trust Center Link Key (TCLK) er blevet opdateret for at generere nye nøgler for hver anmodende enhed. En ny nøgle genereres, hver gang de anmodende enheder forsøger at opdatere deres Trust Center-linknøgle.
- På grund af den tidligere TCLK-politikændring kræver Network Creator Security-komponenten nu Security Link Keys-komponenten. Opgradering af applikationer vil blive opdateret for at overholde dette nye krav.
- En ny konfiguration,
  SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY er tilføjet for at tillade deltagelse ved hjælp af en kerne, hashed nøgle. Denne konfiguration findes under Network Creator Security-komponenten. Brug af denne politik gør det muligt for hver enhed, der tilslutter sig, at modtage en unik TCLK post-join, men gentagne forsøg på at opdatere TCLK vil ikke resultere i en ny nøgle til den anmodende enhed. Denne brug af hashed linknøgler var standardpolitikken før denne udgivelse, og brugen af denne politik gør det muligt for Trust Center at undgå at indsætte komponenten Security Link Keys, som gemmer nøgler i Flash.
  Note: Silicon Labs anbefaler ikke brugen af denne politik, da dette forhindrer, at tilsluttede enheder ruller eller opdaterer deres TCLK'er.

Et nyt konfigurationssæt tilføjes til komponenten zigbee_ezsp_spi for at tillade konfigurationen af værts-SPI-enheden og dens pin-grænseflader.
Eksample projekter, herunder projektet files (.slcps) og projektmappe, omdøbes til Silicon Labs navngivningsretningslinjer og flyttes under mappen "projekter".

Ny platformsupport

Nye moduler
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Nye radiotavler
- MGM260P-RB4350A
- MGM260P-RB4351A
Ny del
- efr32xg27
Explorer sæt
- BRD2709A
- MGM260P-EK2713A

Ny dokumentation
En ny EZSP brugervejledning UG600 til udgivelser 8.1 og nyere.

Forbedringer

SL_ZIGBEE_KEY_TABLE_SIZE grænser udvidet til 254 poster.
Tilføjede zigbee_security_link_keys til Z3Light.
Tilføjet zigbee_security_link_keys til zigbee_mp_z3_tc_z3_tc. Opdaterede også dens nøglebordstørrelse.
Forøgede Z3 Gateway-nøgletabelstørrelsen (der indstilles til ncp) til 20.

Faste problemer

Kendte problemer i den aktuelle udgivelse

Udgaver med fed er tilføjet siden den forrige udgivelse. Hvis du er gået glip af en udgivelse, er de seneste udgivelsesbemærkninger tilgængelige på https://www.silabs.com/developers/zigbee-emberznet på fanen Tekniske dokumenter.

Forældede varer

zigbee_watchdog_periodic_refresh-komponenten bruges ikke længere i Zigbee-applikationsrammen og er forældet i denne udgivelse. Watchdog-timeren er som standard deaktiveret for alle sample applikationer. Der vil blive tilføjet en forbedret vagthund-komponent til SDK i fremtiden.
Note: Aktiver watchdog-timeren med konfigurationselementet SL_LEGACY_HAL_DISABLE_WATCHDOG sat til 0 i din applikation

Netværksbegrænsninger og -overvejelser

Standard Trust Center-applikationerne, der leveres med denne EmberZNet-udgivelse, er i stand til at understøtte flere enheder på netværket. Dette tal bestemmes baseret på flere faktorer, herunder konfigurerede tabelstørrelser, NVM-brug og andre værdier for genereringstid og kørselstid. Brugere, der søger at skabe store netværk, kan få ressourceproblemer, når de udvider netværket, end applikationen kan understøtte. F.eksample, kan en enhed, der anmoder om en Trust Center-linknøgle fra Trust Center, udløse et sl_zigbee_af_zigbee_key_establishment_cb tilbagekald på Trust Center med h-status sat til SL_ZIGBEE_KEY_TABLE_FULL, hvilket indikerer, at nøgletabellen ikke har plads til at tilføje en ny nøgle til den anmodende enhed, eller at NVM3 ikke har nogen ledig plads. Silicon Labs giver følgende anbefalinger til brugere, der ønsker at oprette store netværk. Til Trust Center-applikationer anbefales følgende konfigurationer. Disse anbefalinger er ikke udtømmende, og de tjener som udgangspunkt for applikationer, der har til hensigt at udvide store netværk.

Inkludering af Adressetabel-komponenten (zigbee_address_table), med
- SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE konfigurationselementet indstillet til størrelsen af det ønskede netværk
- værdien SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE sat til maksimum (4)

Inkludering af Security Link Keys-komponenten (zigbee_security_link_keys), med
- Værdien SL_ZIGBEE_KEY_TABLE_SIZE er indstillet til netværkets størrelse
Følgende konfigurationselementer er indstillet til størrelsen på det ønskede netværk
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, som findes i Zigbee Pro Stack-komponenten
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, som findes i kilderoutingkomponenten, hvis kilderuting bruges
Justering af NVM3_DEFAULT_NVM_SIZE og NVM3_DEFAULT_CACHE_SIZE i henhold til NVM3-brug
- F.eks. kræver netværksstørrelser større end 65 noder sandsynligvis en NVM3-størrelse på 64K. Standard NVM3-størrelsen i Silicon Labs Zigbee sample applikationer er 32K. Programmer, der bruger NVM mere tungt, kan kræve at justere denne værdi endnu højere.
- Store netværk op til 65 noder kan have brug for en NVM3-cachestørrelse på 1200 bytes; at vokse netværk større end det kan kræve en fordobling af denne værdi til 2400 bytes.

Disse justeringer gælder kun for Trust Center

Multiprotokol Gateway og RCP

Nye varer
Aktiveret GA SoC-understøttelse for BLE DMP med Zigbee + Openthread CMP med samtidig lytning på xG26-dele. Debian alpha-understøttelse er blevet tilføjet til Zigbeed-, OTBR- og Z3Gateway-applikationer. Zigbeed og OTBR leveres også i DEB-pakkeformat til den valgte referenceplatform (Raspberry PI 4). Se Kørsel af Zigbee, OpenThread og Bluetooth samtidigt på en Linux-vært med en multiprotokol-co-processor, fundet på docs.silabs.com, for detaljer. Tilføjet Zigbeed-understøttelse til Tizen-0.1-13.1 til arm32 og aarch64 samt Android 12 til aarch64. Mere information om Zigbeed kan findes på docs.silabs.com. Tilføjet den nye "802.15.4 Unified radio scheduler priority"-komponent. Denne komponent bruges til at konfigurere radioprioriteterne for en 15.4 stack. Komponenten kræver også den nye "radio_priority_configurator"-komponent. Denne komponent giver projekter mulighed for at bruge Radio Priority Configurator-værktøjet i Simplicity Studio til at konfigurere radioprioritetsniveauerne for de stakke, der kræver det.

Forbedringer
Applikationsnote, der kører Zigbee, OpenThread og Bluetooth samtidigt på en Linux-vært med en multiprotokol-co-processor (AN1333) er blevet flyttet til docs.silabs.com. OpenWRT-understøttelse er nu GA-kvalitet. OpenWRT-understøttelse er blevet tilføjet til Zigbee-, OTBR- og Z3Gateway-applikationer. Zigbeed og OTBR leveres også i IPK-pakkeformat til referenceplatformen (Raspberry PI 4). Se Kørsel af Zigbee, OpenThread og Bluetooth samtidigt på en Linux-vært med en multiprotokol-co-processor, fundet på docs.silabs.com, for detaljer.

Faste problemer

Kendte problemer i den aktuelle udgivelse
Udgaver med fed er tilføjet siden den forrige udgivelse. Hvis du er gået glip af en udgivelse, er de seneste udgivelsesnoter tilgængelige oathttps://www.silabs.com/developers/simplicity-software-development-kit.

Forældede varer
"Multiprotocol Container", som i øjeblikket er tilgængelig på DockerHub (siliconlabsinc/multiprotocol), vil blive forældet i en kommende udgivelse. Containeren vil ikke længere blive opdateret og kunne trækkes fra DockerHub. De Debian-baserede pakker til cpcd, ZigBee og ot-br-posix, sammen med native genererede og kompilerede projekter, vil erstatte den funktionalitet, der gik tabt med fjernelsen af containeren.

Brug af denne udgivelse

Denne udgivelse indeholder følgende:

Zigbee stak
Zigbee Application Framework
Zigbee Sample Applikationer

For mere information om Zigbee og EmberZNet SDK se UG103.02: Zigbee Fundamentals. Hvis du er en førstegangsbruger, se QSG180: Zigbee EmberZNet Quick-Start Guide til SDK 7.0 og højere, for instruktioner om konfiguration af dit udviklingsmiljø, opbygning og flashing somampapplikationen og dokumentationsreferencer, der peger på de næste trin.

Installation og brug
Zigbee EmberZNet SDK leveres som en del af Simplicity SDK, 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/SiliconLabs/simplicity_sdk for mere information. Simplicity Studio installerer Simplicity SDK som standard i:

(Windows): C:\Users\\SimplicityStudio\SDKs\simplicity_sdk

(MacOS): /Users//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ængelige pån https://docs.silabs.com/.

Sikkerhedsoplysninger
Sikker Vault-integration
For programmer, der vælger at gemme nøgler sikkert ved hjælp af Secure Key Storage-komponenten på Secure Vault-High-dele, viser følgende tabel de beskyttede nøgler og deres lagerbeskyttelsesegenskaber, som Zigbee Security Manager-komponenten administrerer.Indpakkede nøgler, der er markeret som "Ikke-eksporterbare", kan bruges, men kan ikke være det viewredigeres eller deles under kørsel. Indpakkede nøgler, der er markeret som "Eksporterbare", kan bruges eller deles under kørsel, men forbliver krypterede, mens de opbevares i Flash. Brugerapplikationer behøver aldrig at interagere med størstedelen af disse nøgler. Eksisterende API'er til at administrere Link Key Table-nøgler eller Transient Keys er stadig tilgængelige for brugerapplikationen og rutes nærmest gennem Zigbee Security Manager-komponenten.

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.

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

Zigbee certificering
Ember ZNet 8.1-udgivelsen er blevet kvalificeret til Zigbee-kompatibel platform for SoC-, NC-, P- og RCP-arkitekturer. Der er et ZCP-certificerings-id knyttet til denne udgivelse. Tjek venligst CSA website her:
https://csa-iot.org/csa-iot_products/.

Bemærk venligst, at ZCP-certificeringen er filed post udgivelsen, og det tager et par uger, før det bliver reflekteret over CSA webwebsted. For yderligere spørgsmål, kontakt venligst Silicon Laboratories support på http://www.silabs.com/support.

Ofte stillede spørgsmål

Spørgsmål: Hvordan opdaterer jeg størrelsen på APS-linknøgletabellen i SDK'et?
A: APS-linknøgletabelstørrelsen kan konfigureres ved hjælp af parameteren SL_ZIGBEE_KEY_TABLE_SIZE. I version 8.1 er det blevet udvidet fra 127 til 254 poster.

Q: Hvad er forbedringerne i version 8.1?
A: Version 8.1 bringer forbedringer såsom udvidelse af APS-linknøgletabelstørrelsen, omdøbning af komponenter, tilføjelse af mutex-beskyttelse til Athe pp Framework-hændelseskøen og mere. Se udgivelsesbemærkningerne for en detaljeret liste over forbedringer.

Q: Hvordan håndterer jeg løste problemer i SDK'et?
A: Rettede problemer i SDK'et, herunder løsning af potentielle problemer med konfiguration af nabotabelstørrelse, omdøbning af komponenter, rettelse af kilderuteoverhead, håndtering af ZCL-kommandoer og mere. Sørg for at opdatere til den nyeste version for at drage fordel af disse rettelser.

Dokumenter/ressourcer

SILICON LABS Zigbee EmberZ Net SDK [pdf] Instruktioner
Zigbee EmberZ Net SDK, EmberZ Net SDK, Net SDK, SDK

Referencer

Brugermanual

SILICON LABS Zigbee EmberZ Net SDK

Specifikationer

Produktinformation