Navodila SILICON LABS Zigbee EmberZ Net SDK

Silicon Labs je izbrani ponudnik za proizvajalce originalne opreme, ki v svoje izdelke razvijajo omrežje Zigbee. Platforma Silicon Labs Zigbee je najbolj integrirana, popolna in s funkcijami bogata rešitev Zigbee, ki je na voljo. Silicon Labs EmberZNet SDK vsebuje Silicon Labs implementacijo specifikacije sklada Zigbee.

KLJUČNE LASTNOSTI

Zigbee

-250+ vnosov v tabeli ključev povezave APS
Podpora za ZigbeeD v sistemih Android 12 (v21.0.6113669) in Tizen (v0.1–13.1)

Podpora za modul xG26

Multiprotokol

Podpora ZigbeeD in OTBR na OpenWRT – GA
DMP BLE + CMP ZB & Matter/OT s sočasnim poslušanjem na MG26 za SoC – GA

802.15.4 Prednostna komponenta poenotenega radijskega razporejevalnika
Podpora za pakiranje Debian za gostiteljske aplikacije MP – Alpha

Novi predmeti

Pomembne spremembe
Velikost tabele ključev povezave APS (konfigurirana z uporabo SL_ZIGBEE_KEY_TABLE_SIZE) je razširjena s 127 na 254 vnosov.

Podpora R23 je dodana za funkcijo zagona omrežja ZDD. Funkcionalnost tuneliranja je na voljo brez podpore za primere uporabe starega omrežja.

Komponenti Network Steering in Network Creator sta bili posodobljeni tako, da vključujeta podporo za pridružitev R23. Te vključujejo naslednje povezane spremembe.
- Privzeti pravilnik o zahtevah ključa povezave centra zaupanja (TCLK) je bil posodobljen za ustvarjanje novih ključev za vsako napravo, ki zahteva. Nov ključ se ustvari vsakič, ko naprave, ki zahtevajo, poskušajo posodobiti svoj ključ povezave centra zaupanja.
- Zaradi prejšnje spremembe pravilnika TCLK komponenta Network Creator Security zdaj zahteva komponento Security Link Keys. Nadgradnja aplikacij bo posodobljena v skladu s to novo zahtevo.
- Nova konfiguracija,
  Dodan je SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY, ki omogoča pridružitev z uporabo jedrnega zgoščenega ključa. To konfiguracijo najdete pod komponento Network Creator Security. Uporaba tega pravilnika omogoča, da vsaka naprava, ki se pridruži, prejme edinstven TCLK po pridružitvi, vendar ponavljajoči se poskusi posodobitve TCLK ne bodo povzročili novega ključa za napravo, ki zahteva. Ta uporaba zgoščenih povezovalnih ključev je bila privzeta politika pred to izdajo in uporaba tega pravilnika omogoča centru zaupanja, da se izogne vključitvi komponente varnostnih povezovalnih ključev, ki ključe shrani v Flash.
  Opomba: Silicon Labs ne priporoča uporabe tega pravilnika, saj to preprečuje, da bi pridružene naprave predvajale ali posodabljale svoje TCLK.

Komponenti zigbee_ezsp_spi je dodan nov konfiguracijski niz, ki omogoča konfiguracijo gostiteljske naprave SPI in njenih pin vmesnikov.
Bivšiample projekti, vključno s projektom files (.slcps) in mapa projekta, se preimenuje v smernice za poimenovanje Silicon Labs in premakne v imenik »projects«.

Podpora za novo platformo

Novi moduli
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Nove radijske plošče
- MGM260P-RB4350A
- MGM260P-RB4351A
Nov del
- efr32xg27
Raziskovalni komplet
- BRD2709A
- MGM260P-EK2713A

Nova dokumentacija
Nova uporabniška navodila EZSP UG600 za izdaje 8.1 in novejše.

Izboljšave

Omejitve SL_ZIGBEE_KEY_TABLE_SIZE so razširjene na 254 vnosov.
Dodan zigbee_security_link_keys v Z3Light.
V zigbee_mp_z3_tc_z3_tc dodani zigbee_security_link_keys. Posodobila je tudi velikost tabele ključev.
Povečana je velikost tabele ključev Z3 Gateway (ki bo nastavljena na ncp) na 20.

Odpravljene težave

Znane težave v trenutni izdaji

Težave s krepkim tiskom so bile dodane od prejšnje izdaje. Če ste zamudili izdajo, so najnovejše opombe ob izdaji na voljo na https://www.silabs.com/developers/zigbee-emberznet v zavihku Tehnični dokumenti.

Zastareli predmeti

Komponenta zigbee_watchdog_periodic_refresh se ne uporablja več v ogrodju aplikacije Zigbee in je v tej izdaji opuščena. Nadzorni časovnik je privzeto onemogočen za vse sample aplikacije. V prihodnosti bo SDK-ju dodana izboljšana komponenta čuvaja.
Opomba: Omogočite nadzorni časovnik s konfiguracijskim elementom SL_LEGACY_HAL_DISABLE_WATCHDOG, nastavljenim na 0 v vaši aplikaciji

Omrežne omejitve in premisleki

Privzete aplikacije Trust Center, ki so priložene tej izdaji EmberZNet, lahko podpirajo več naprav v omrežju. To število je določeno na podlagi več dejavnikov, vključno s konfiguriranimi velikostmi tabel, uporabo NVM in drugimi vrednostmi časa generiranja in časa izvajanja. Uporabniki, ki želijo ustvariti velika omrežja, se lahko soočijo s težavami z viri, ko povečajo omrežje, ki je večje, kot ga lahko podpira aplikacija. Na primerample lahko naprava, ki od središča zaupanja zahteva ključ povezave centra zaupanja, sproži povratni klic sl_zigbee_af_zigbee_key_establishment_cb v središču zaupanja s statusom h, nastavljenim na SL_ZIGBEE_KEY_TABLE_FULL, kar kaže, da v tabeli ključev ni prostora za dodajanje novega ključa za napravo, ki zahteva, ali da NVM3 nima razpoložljivega prostora. Silicon Labs ponuja naslednja priporočila za uporabnike, ki želijo ustvariti velika omrežja. Za aplikacije Središča zaupanja so priporočene naslednje konfiguracije. Ta priporočila niso izčrpna in služijo kot osnova za aplikacije, ki nameravajo razviti velika omrežja.

Vključitev komponente Address Table (zigbee_address_table), z
- konfiguracijski element SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE nastavljen na velikost želenega omrežja
- vrednost SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE nastavljena na največjo (4)

Vključitev komponente ključev varnostne povezave (zigbee_security_link_keys), z
- Vrednost SL_ZIGBEE_KEY_TABLE_SIZE je nastavljena na velikost omrežja
Naslednji elementi konfiguracije so nastavljeni na velikost želenega omrežja
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, kot ga najdete v komponenti Zigbee Pro Stack
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, kot se nahaja v komponenti izvornega usmerjanja, če je uporabljeno izvorno usmerjanje
Prilagoditev NVM3_DEFAULT_NVM_SIZE in NVM3_DEFAULT_CACHE_SIZE glede na uporabo NVM3
- Na primer, velikosti omrežij, večjih od 65 vozlišč, verjetno zahtevajo velikost NVM3 64K. Privzeta velikost NVM3 v Silicon Labs Zigbee sample aplikacij je 32K. Aplikacije, ki intenzivneje uporabljajo NVM, bodo morda zahtevale še višjo prilagoditev te vrednosti.
- Velika omrežja do 65 vozlišč bodo morda potrebovala velikost predpomnilnika NVM3 1200 bajtov; rastoča omrežja, večja od tega, lahko zahtevajo podvojitev te vrednosti na 2400 bajtov.

Te prilagoditve veljajo samo za središče zaupanja

Večprotokolni prehod in RCP

Novi predmeti
Omogočena podpora GA SoC za BLE DMP z Zigbee + Openthread CMP s sočasnim poslušanjem delov xG26. Podpora za alfa različico Debiana je bila dodana za aplikacije Zigbeed, OTBR in Z3Gateway. Zigbeed in OTBR sta na voljo tudi v obliki paketa DEB za izbrano referenčno platformo (Raspberry PI 4). Glejte Sočasno izvajanje Zigbee, OpenThread in Bluetooth na gostitelju Linux z večprotokolnim soprocesorjem, ki ga najdete na docs.silabs.com, za podrobnosti. Dodana podpora Zigbeed za Tizen-0.1-13.1 za arm32 in aarch64 ter Android 12 za aarch64. Več informacij o Zigbeedu najdete na docs.silabs.com. Dodana nova komponenta »802.15.4 Unified radio scheduler priority«. Ta komponenta se uporablja za konfiguracijo radijskih prioritet sklada 15.4. Komponenta zahteva tudi novo komponento »radio_priority_configurator«. Ta komponenta omogoča projektom uporabo orodja Radio Priority Configurator v Simplicity Studio za konfiguracijo ravni radijske prioritete skladov, ki to zahtevajo.

Izboljšave
Opomba o aplikaciji Sočasno izvajanje Zigbee, OpenThread in Bluetooth na gostitelju Linux z večprotokolnim soprocesorjem (AN1333) je bilo premaknjeno na docs.silabs.com. Podpora za OpenWRT je zdaj kakovosti GA. Podpora za OpenWRT je bila dodana za aplikacije Zigbee, OTBR in Z3Gateway. Zigbeed in OTBR sta na voljo v obliki paketa IPK tudi za referenčno platformo (Raspberry PI 4). Glejte Sočasno izvajanje Zigbee, OpenThread in Bluetooth na gostitelju Linux z večprotokolnim soprocesorjem, ki ga najdete na docs.silabs.com, za podrobnosti.

Odpravljene težave

Znane težave v trenutni izdaji
Težave s krepkim tiskom so bile dodane od prejšnje izdaje. Če ste zamudili izdajo, so na voljo nedavne opombe ob izdajihttps://www.silabs.com/developers/simplicity-software-development-kit.

Zastareli predmeti
»Multiprotocol Container«, ki je trenutno na voljo na DockerHub (siliconlabsinc/multiprotocol), bo v prihajajoči izdaji opuščen. Vsebnik ne bo več posodobljen in ga ne bo mogoče potegniti iz DockerHub. Paketi za cpcd, ZigBee in ot-br-posix, ki temeljijo na Debianu, bodo skupaj z izvorno ustvarjenimi in prevedenimi projekti nadomestili funkcionalnost, izgubljeno z odstranitvijo vsebnika.

Uporaba te izdaje

Ta izdaja vsebuje naslednje:

Zigbee sklad
Aplikacijsko ogrodje Zigbee
Zigbee Sample Aplikacije

Za več informacij o Zigbee in EmberZNet SDK glejte UG103.02: Zigbee Fundamentals. Če ste prvi uporabnik, glejte QSG180: Zigbee EmberZNet Quick Start Guide for SDK 7.0 and Higher, za navodila o konfiguraciji vašega razvojnega okolja, gradnji in utripanju kotampdatotečne aplikacije in reference dokumentacije, ki kažejo na dodatne korake.

Namestitev in uporaba
Zigbee EmberZNet SDK je na voljo kot del Simplicity SDK, zbirke SDK-jev Silicon Labs. Če želite hitro začeti uporabljati Simplicity SDK, namestite Simplicity Studio 5, ki bo nastavil vaše razvojno okolje in vas popeljal skozi namestitev Simplicity SDK. Simplicity Studio 5 vključuje vse, kar je potrebno za razvoj izdelkov IoT z napravami Silicon Labs, vključno z zaganjalnikom virov in projektov, orodji za konfiguracijo programske opreme, popolnim IDE z verigo orodij GNU in orodji za analizo. Navodila za namestitev so na voljo v spletnem uporabniškem priročniku Simplicity Studio 5. Namesto tega lahko Simplicity SDK namestite ročno tako, da prenesete ali klonirate najnovejšo različico iz GitHuba. glej https://github.com/SiliconLabs/simplicity_sdk za več informacij. Simplicity Studio privzeto namesti Simplicity SDK v:

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

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

Dokumentacija, specifična za različico SDK, je nameščena skupaj s SDK. Dodatne informacije je pogosto mogoče najti v člankih baze znanja (KBA). Reference API-jev in druge informacije o tej in prejšnjih izdajah so na voljo na https://docs.silabs.com/.

Varnostne informacije
Integracija varnega trezorja
Za aplikacije, ki se odločijo za varno shranjevanje ključev s komponento Secure Key Storage na delih Secure Vault-High, naslednja tabela prikazuje zaščitene ključe in njihove značilnosti zaščite shranjevanja, ki jih upravlja komponenta Zigbee Security Manager.Zavite ključe, ki so označeni kot »neizvozni«, je mogoče uporabiti, vendar ne viewed ali v skupni rabi med izvajanjem. Zavite ključe, ki so označeni kot »Izvozni«, je mogoče uporabiti ali deliti med izvajanjem, vendar ostanejo šifrirani, medtem ko so shranjeni v Flashu. Uporabniškim aplikacijam nikoli ni treba komunicirati z večino teh ključev. Obstoječi API-ji za upravljanje ključev tabele ključev povezav ali prehodnih ključev so še vedno na voljo uporabniški aplikaciji in se usmerjajo prek komponente Zigbee Security Manager.

Varnostni nasveti
Če se želite naročiti na varnostne nasvete, se prijavite na portal za stranke Silicon Labs in izberite Domov računa. Kliknite DOMOV, da odprete domačo stran portala, in nato kliknite ploščico Upravljanje obvestil. Prepričajte se, da je označena možnost »Obvestila o programski opremi/varnosti in obvestila o spremembah izdelkov (PCN)« in da ste naročeni vsaj na svojo platformo in protokol. Kliknite Shrani, da shranite morebitne spremembe.

Podpora
Stranke razvojnega kompleta so upravičene do usposabljanja in tehnične podpore. Uporabite Silicon Laboratories Zigbee web strani za pridobitev informacij o vseh izdelkih in storitvah Silicon Labs Zigbee ter za prijavo na podporo za izdelke. Podporo Silicon Laboratories lahko kontaktirate na http://www.silabs.com/support.

Zigbee certifikat
Izdaja Ember ZNet 8.1 je bila kvalificirana za platformo, združljivo z Zigbee za arhitekture SoC, NC, P in RCP, s to izdajo je povezan certifikacijski ID ZCP, preverite CSA webspletno mesto tukaj:
https://csa-iot.org/csa-iot_products/.

Upoštevajte, da je certifikat ZCP filed objavi izdajo in traja nekaj tednov, preden se odrazi v CSA webmesto. Za vsa dodatna vprašanja se obrnite na podporo Silicon Laboratories na http://www.silabs.com/support.

pogosta vprašanja

V: Kako posodobim velikost tabele ključev povezave APS v SDK?
O: Velikost tabele ključev povezave APS je mogoče konfigurirati s parametrom SL_ZIGBEE_KEY_TABLE_SIZE. V različici 8.1 je bil razširjen s 127 na 254 vnosov.

V: Kakšne so izboljšave v različici 8.1?
O: Različica 8.1 prinaša izboljšave, kot je razširitev velikosti tabele ključev povezave APS, preimenovanje komponent, dodajanje zaščite mutex za čakalno vrsto dogodkov Athe pp Framework in več. Za podroben seznam izboljšav glejte opombe ob izdaji.

V: Kako obravnavam odpravljene težave v SDK?
O: Odpravljene težave v SDK-ju, vključno z reševanjem morebitnih težav s konfiguracijo velikosti sosednje tabele, preimenovanjem komponent, popravljanjem dodatnih stroškov izvorne poti, obravnavanjem ukazov ZCL in več. Če želite izkoristiti prednosti teh popravkov, poskrbite, da boste posodobili na najnovejšo različico.

Dokumenti / Viri

SILICON LABS Zigbee EmberZ Net SDK [pdfNavodila
Zigbee EmberZ Net SDK, EmberZ Net SDK, Net SDK, SDK

Reference

Uporabniški priročnik

SILICON LABS Zigbee EmberZ Net SDK

Specifikacije

Informacije o izdelku