SILICON LABS Zigbee EmberZ Net SDK-instruksjoner

Silicon Labs er den foretrukne leverandøren for OEM-er som utvikler Zigbee-nettverk i produktene deres. Silicon Labs Zigbee-plattformen er den mest integrerte, komplette og funksjonsrike Zigbee-løsningen som er tilgjengelig. Silicon Labs EmberZNet SDK inneholder Silicon Labs' implementering av Zigbee stack-spesifikasjonen.

NØKKELFUNKSJONER

Zigbee

-250+ oppføringer i APS-lenketabellen
ZigbeeD-støtte på Android 12 (v21.0.6113669) og Tizen (v0.1-13.1)

xG26-modulstøtte

Multi

ZigbeeD og OTBR-støtte på OpenWRT – GA
DMP BLE + CMP ZB & Matter/OT med samtidig lytting på MG26 for SoC – GA

802.15.4 Unified radio scheduler prioritetskomponent
Debian-pakkestøtte for MP-vertsapplikasjoner – Alpha

Nye varer

Viktige endringer
APS-koblingsnøkkeltabellstørrelsen (konfigurert med SL_ZIGBEE_KEY_TABLE_SIZE) utvides fra 127 til 254 oppføringer.

R23-støtte er lagt til for ZDD Network igangkjøringsfunksjonalitet. Tunnelfunksjonalitet er tilgjengelig uten støtte for brukstilfeller for Legacy Network.

Komponentene Network Steering og Network Creator har blitt oppdatert for å inkludere støtte for R23-tilknytning. Disse inkluderer følgende relaterte endringer.
- Standard forespørselspolicy for Trust Center Link Key (TCLK) har blitt oppdatert for å generere nye nøkler for hver forespørende enhet. En ny nøkkel genereres hver gang de forespørrende enhetene prøver å oppdatere Trust Center Link Key.
- På grunn av den forrige TCLK-policyendringen krever Network Creator Security-komponenten nå Security Link Keys-komponenten. Oppgradering av applikasjoner vil bli oppdatert for å samsvare med dette nye kravet.
- En ny konfigurasjon,
  SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY er lagt til for å tillate sammenføyning ved hjelp av en kjernenøkkel. Denne konfigurasjonen finnes under Network Creator Security-komponenten. Bruk av denne policyen gjør at hver enkelt enhet kan motta en unik TCLK etter tilkobling, men gjentatte forsøk på å oppdatere TCLK vil ikke resultere i en ny nøkkel for enheten som ber om. Denne bruken av hash-lenkenøkler var standardpolicyen før denne utgivelsen, og bruken av denne policyen lar Trust Center unngå å ta inn sikkerhetslenkenøkler-komponenten, som lagrer nøkler i Flash.
  Note: Silicon Labs anbefaler ikke bruk av denne policyen, da dette hindrer sammenføyde enheter fra å rulle, eller oppdatere, deres TCLK-er.

Et nytt konfigurasjonssett legges til komponenten zigbee_ezsp_spi for å tillate konfigurasjon av verts-SPI-enheten og dens pin-grensesnitt.
Eksample prosjekter, inkludert prosjektet files (.slcps) og prosjektmappen, blir omdøpt til Silicon Labs navneretningslinjer og flyttet under «projects»-katalogen.

Ny plattformstøtte

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

Ny dokumentasjon
En ny EZSP brukerveiledning UG600 for utgivelser 8.1 og nyere.

Forbedringer

SL_ZIGBEE_KEY_TABLE_SIZE grenser utvidet til 254 oppføringer.
Lagt til zigbee_security_link_keys til Z3Light.
Lagt til zigbee_security_link_keys til zigbee_mp_z3_tc_z3_tc. Oppdaterte også nøkkeltabellstørrelsen.
Økte Z3 Gateway-nøkkeltabellstørrelsen (som vil bli satt til ncp) til 20.

Faste problemer

Kjente problemer i gjeldende utgivelse

Utgaver i fet skrift er lagt til siden forrige utgivelse. Hvis du har gått glipp av en utgivelse, er nylige utgivelsesnotater tilgjengelig på https://www.silabs.com/developers/zigbee-emberznet i fanen Tekniske dokumenter.

Utdaterte varer

zigbee_watchdog_periodic_refresh-komponenten brukes ikke lenger i Zigbee-applikasjonsrammeverket og er avviklet i denne utgivelsen. Watchdog-timeren er deaktivert som standard for alle sample applikasjoner. Det vil bli lagt til en forbedret vakthund-komponent til SDK i fremtiden.
Note: Aktiver watchdog-timeren med konfigurasjonselementet SL_LEGACY_HAL_DISABLE_WATCHDOG satt til 0 i applikasjonen din

Nettverksbegrensninger og -hensyn

Standard Trust Center-applikasjoner som leveres med denne EmberZNet-utgivelsen er i stand til å støtte flere enheter på nettverket. Dette tallet bestemmes basert på flere faktorer, inkludert konfigurerte tabellstørrelser, NVM-bruk og andre generasjonstids- og kjøretidsverdier. Brukere som ønsker å opprette store nettverk kan møte ressursproblemer når de utvider nettverket større enn applikasjonen kan støtte. For eksample, kan en enhet som ber om en Trust Center Link Key fra Trust Center utløse et sl_zigbee_af_zigbee_key_establishment_cb tilbakeringing på Trust Center med h status satt til SL_ZIGBEE_KEY_TABLE_FULL, noe som indikerer at nøkkeltabellen ikke har plass til å legge til en ny nøkkel for den forespørende enheten eller at NVM3 har ingen ledig plass. Silicon Labs gir følgende anbefalinger for brukere som ønsker å opprette store nettverk. For Trust Center-applikasjoner anbefales følgende konfigurasjoner. Disse anbefalingene er ikke uttømmende, og de fungerer som en baseline for applikasjoner som har til hensikt å utvide store nettverk.

Inkludering av Adressetabell-komponenten (zigbee_address_table), med
- SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE konfigurasjonselementet satt til størrelsen på ønsket nettverk
- SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE-verdien satt til maksimum (4)

Inkludering av Security Link Keys-komponenten (zigbee_security_link_keys), med
- SL_ZIGBEE_KEY_TABLE_SIZE-verdien er satt til størrelsen på nettverket
Følgende konfigurasjonselementer er satt til størrelsen på ønsket nettverk
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, som funnet i Zigbee Pro Stack-komponenten
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, som funnet i kilderutingskomponenten, hvis kilderuting brukes
Justering av NVM3_DEFAULT_NVM_SIZE og NVM3_DEFAULT_CACHE_SIZE i henhold til NVM3-bruk
- For eksempel krever nettverksstørrelser større enn 65 noder sannsynligvis en NVM3-størrelse på 64K. Standard NVM3-størrelse i Silicon Labs Zigbee sample-applikasjonene er 32K. Applikasjoner som bruker NVM mer, kan kreve å justere denne verdien enda høyere.
- Store nettverk opptil 65 noder kan trenge en NVM3-bufferstørrelse på 1200 byte; å vokse nettverk større enn det kan kreve å doble denne verdien til 2400 byte.

Disse justeringene gjelder kun for Trust Center

Multiprotokoll Gateway og RCP

Nye varer
Aktivert GA SoC-støtte for BLE DMP med Zigbee + Openthread CMP med samtidig lytting på xG26-deler. Debian alpha-støtte er lagt til for Zigbeed-, OTBR- og Z3Gateway-applikasjoner. Zigbeed og OTBR leveres også i DEB-pakkeformat for den valgte referanseplattformen (Raspberry PI 4). Se Kjøre Zigbee, OpenThread og Bluetooth samtidig på en Linux-vert med en multiprotokoll-co-prosessor, funnet på docs.silabs.com, for detaljer. Lagt til Zigbeed-støtte for Tizen-0.1-13.1 for arm32 og aarch64 samt Android 12 for aarch64. Mer informasjon om Zigbeed finner du på docs.silabs.com. Lagt til den nye "802.15.4 Unified radio scheduler priority"-komponenten. Denne komponenten brukes til å konfigurere radioprioritetene til en 15.4 stack. Komponenten krever også den nye "radio_priority_configurator"-komponenten. Denne komponenten lar prosjekter bruke Radio Priority Configurator-verktøyet i Simplicity Studio for å konfigurere radioprioritetsnivåene til stablene som krever det.

Forbedringer
Applikasjonsmerknad Å kjøre Zigbee, OpenThread og Bluetooth samtidig på en Linux-vert med en multiprotokoll-co-prosessor (AN1333) er flyttet til docs.silabs.com. OpenWRT-støtte er nå GA-kvalitet. OpenWRT-støtte er lagt til for Zigbee-, OTBR- og Z3Gateway-applikasjoner. Zigbeed og OTBR leveres også i IPK-pakkeformat for referanseplattformen (Raspberry PI 4). Se Kjøre Zigbee, OpenThread og Bluetooth samtidig på en Linux-vert med en multiprotokoll-co-prosessor, funnet på docs.silabs.com, for detaljer.

Faste problemer

Kjente problemer i gjeldende utgivelse
Utgaver i fet skrift er lagt til siden forrige utgivelse. Hvis du har gått glipp av en utgivelse, er nyere utgivelsesnotater tilgjengeligehttps://www.silabs.com/developers/simplicity-software-development-kit.

Utdaterte varer
"Multiprotocol Container" som for øyeblikket er tilgjengelig på DockerHub (siliconlabsinc/multiprotocol) vil bli avviklet i en kommende utgivelse. Beholderen vil ikke lenger oppdateres og kan hentes fra DockerHub. De Debian-baserte pakkene for cpcd, ZigBee og ot-br-posix, sammen med naturlig genererte og kompilerte prosjekter, vil erstatte funksjonaliteten som gikk tapt med fjerningen av beholderen.

Bruker denne utgivelsen

Denne utgivelsen inneholder følgende:

Zigbee stabel
Zigbee Application Framework
Zigbee Sample Applikasjoner

For mer informasjon om Zigbee og EmberZNet SDK, se UG103.02: Zigbee Fundamentals. Hvis du er en førstegangsbruker, se QSG180: Zigbee EmberZNet Quick-Start Guide for SDK 7.0 and Higher, for instruksjoner om hvordan du konfigurerer utviklingsmiljøet, bygger og blinker somampapplikasjonen og dokumentasjonsreferanser som peker til de utvendige trinnene.

Installasjon og bruk
Zigbee EmberZNet SDK leveres som en del av Simplicity SDK, pakken med Silicon Labs SDK-er. For raskt å komme i gang med Simplicity SDK, installer Simplicity Studio 5, som vil sette opp utviklingsmiljøet ditt og lede deg gjennom Simplicity SDK-installasjonen. Simplicity Studio 5 inkluderer alt som trengs for IoT-produktutvikling med Silicon Labs-enheter, inkludert en ressurs- og prosjektstarter, programvarekonfigurasjonsverktøy, full IDE med GNU-verktøykjede og analyseverktøy. Installasjonsinstruksjoner finnes i den elektroniske brukerveiledningen for Simplicity Studio 5. Alternativt kan Simplicity SDK installeres manuelt ved å laste ned eller klone det siste fra GitHub. Se https://github.com/SiliconLabs/simplicity_sdk for mer informasjon. Simplicity Studio installerer Simplicity SDK som standard i:

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

(MacOS): /Users//SimplicityStudio/SDKs/simplicity_sdk

Dokumentasjon spesifikk for SDK-versjonen er installert med SDK. Ytterligere informasjon kan ofte finnes i kunnskapsbaseartiklene (KBA). API-referanser og annen informasjon om denne og tidligere utgivelser er tilgjengelig https://docs.silabs.com/.

Sikkerhetsinformasjon
Sikker Vault-integrasjon
For programmer som velger å lagre nøkler sikkert ved å bruke Secure Key Storage-komponenten på Secure Vault-High-deler, viser følgende tabell de beskyttede nøklene og deres lagringsbeskyttelsesegenskaper som Zigbee Security Manager-komponenten administrerer.Innpakkede nøkler som er merket som "Ikke-eksporterbare" kan brukes, men kan ikke være det viewed eller delt under kjøring. Innpakkede nøkler som er merket som "Eksporterbare" kan brukes eller deles under kjøring, men forblir krypterte mens de lagres i Flash. Brukerapplikasjoner trenger aldri å samhandle med de fleste av disse tastene. Eksisterende APIer for å administrere Link Key Table-nøkler eller Transient Keys er fortsatt tilgjengelige for brukerapplikasjonen og rutes nesten gjennom Zigbee Security Manager-komponenten.

Sikkerhetsråd
For å abonnere på Security Advisories, logg inn på Silicon Labs kundeportal, og velg deretter Kontohjem. Klikk HJEM for å gå til portalens hjemmeside, og klikk deretter på Administrer varsler-flisen. Sørg for at 'Software/Security Advisory Notices & Product Change Notices (PCNs)' er merket av, og at du som minimum abonnerer på din plattform og protokoll. Klikk Lagre for å lagre eventuelle endringer.

Støtte
Development Kit-kunder er kvalifisert for opplæring og teknisk støtte. Bruk Silicon Laboratories Zigbee web siden for å få informasjon om alle Silicon Labs Zigbee-produkter og -tjenester, og for å registrere deg for produktstøtte. Du kan kontakte Silicon Laboratories support på http://www.silabs.com/support.

Zigbee sertifisering
Ember ZNet 8.1-utgivelsen er kvalifisert for Zigbee-kompatibel plattform for SoC-, NC-, P- og RCP-arkitekturer. Det er en ZCP-sertifiserings-ID knyttet til denne utgivelsen, vennligst sjekk CSA websiden her:
https://csa-iot.org/csa-iot_products/.

Vær oppmerksom på at ZCP-sertifiseringen er filed legge ut utgivelsen, og det tar noen uker før du blir reflektert over CSA webnettstedet. For ytterligere spørsmål, vennligst kontakt Silicon Laboratories support på http://www.silabs.com/support.

Vanlige spørsmål

Spørsmål: Hvordan oppdaterer jeg størrelsen på APS-koblingsnøkkeltabellen i SDK?
A: APS-koblingsnøkkeltabellstørrelsen kan konfigureres ved hjelp av parameteren SL_ZIGBEE_KEY_TABLE_SIZE. I versjon 8.1 er den utvidet fra 127 til 254 oppføringer.

Spørsmål: Hva er forbedringene i versjon 8.1?
A: Versjon 8.1 gir forbedringer som utvidelse av APS-lenketabellstørrelsen, gi nytt navn til komponenter, legge til mutex-beskyttelse for Athe pp Framework-hendelseskøen og mer. Se versjonsmerknadene for en detaljert liste over forbedringer.

Spørsmål: Hvordan håndterer jeg løste problemer i SDK?
A: Løste problemer i SDK, inkludert å løse potensielle problemer med konfigurasjon av nabotabellstørrelse, gi nytt navn til komponenter, fikse kilderuteoverhead, håndtering av ZCL-kommandoer og mer. Sørg for at du oppdaterer til den nyeste versjonen for å dra nytte av disse rettelsene.

Dokumenter / Ressurser

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

Referanser

Brukerhåndbok

SILICON LABS Zigbee EmberZ Net SDK

Spesifikasjoner

Produktinformasjon