SILICON LABS Zigbee EmberZ Net SDK Upute

Silicon Labs je dobavljač po izboru za OEM proizvođače koji razvijaju Zigbee umrežavanje u svoje proizvode. Silicon Labs Zigbee platforma je najintegriranije, potpunije i značajkama bogato dostupno Zigbee rješenje. Silicon Labs EmberZNet SDK sadrži implementaciju Silicon Labs specifikacije Zigbee stack-a.

KLJUČNE ZNAČAJKE

Zigbee

-250+ unosa u tablici ključeva veze APS
ZigbeeD podrška na Androidu 12 (v21.0.6113669) i Tizen (v0.1-13.1)

Podrška za xG26 modul

Multiprotokol

Podrška za ZigbeeD i OTBR na OpenWRT – GA
DMP BLE + CMP ZB & Matter/OT s istodobnim slušanjem na MG26 za SoC – GA

802.15.4 Prioritetna komponenta objedinjenog radio rasporeda
Debian podrška za pakiranje za MP host aplikacije – Alpha

Nove stavke

Važne promjene
Veličina tablice ključeva APS veze (konfigurirana pomoću SL_ZIGBEE_KEY_TABLE_SIZE) je proširena sa 127 na 254 unosa.

Dodana je podrška za R23 za funkcionalnost puštanja u rad ZDD mreže. Funkcionalnost tuneliranja dostupna je bez podrške za slučajeve korištenja naslijeđene mreže.

Komponente Network Steering i Network Creator su ažurirane kako bi uključile podršku za R23 pridruživanje. To uključuje sljedeće povezane promjene.
- Zadana politika zahtjeva za ključ veze centra za pouzdanost (TCLK) ažurirana je za generiranje novih ključeva za svaki uređaj koji zahtijeva. Novi ključ se generira svaki put kada uređaji koji zahtijevaju pokušaju ažurirati svoj ključ veze centra za pouzdanost.
- Zbog prethodne promjene TCLK pravila, komponenta Network Creator Security sada zahtijeva komponentu Security Link Keys. Nadogradnja aplikacija bit će ažurirana kako bi bila u skladu s ovim novim zahtjevom.
- Nova konfiguracija,
  Dodan je SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY kako bi se omogućilo pridruživanje pomoću osnovnog, raspršenog ključa. Ova se konfiguracija nalazi pod komponentom Network Creator Security. Korištenje ovog pravila omogućuje svakom uređaju koji se pridružuje da primi jedinstveni TCLK naknadni spoj, ali opetovani pokušaji ažuriranja TCLK-a neće rezultirati novim ključem za uređaj koji zahtijeva. Ovo korištenje raspršenih ključeva veze bilo je zadano pravilo prije ovog izdanja, a korištenje ovog pravila omogućuje Centru za pouzdanost da izbjegne uvođenje komponente Sigurnosni ključevi veze, koja ključeve sprema u Flash.
  Bilješka: Silicon Labs ne preporuča korištenje ovog pravila jer ono sprječava da uređaji koji se pridružuju pokreću ili ažuriraju svoje TCLK-ove.

Novi konfiguracijski skup dodan je komponenti zigbee_ezsp_spi kako bi se omogućila konfiguracija glavnog SPI uređaja i njegovih pin sučelja.
Bivšiample projekti, uključujući projekt files (.slcps) i mapa projekta, preimenovani su u smjernice za imenovanje Silicon Labsa i premješteni u direktorij "projekti".

Podrška za novu platformu

Novi moduli
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Nove radio ploče
- MGM260P-RB4350A
- MGM260P-RB4351A
Novi dio
- efr32xg27
Komplet Explorer
- BRD2709A
- MGM260P-EK2713A

Nova dokumentacija
Novi EZSP korisnički vodič UG600 za izdanja 8.1 i novije.

Poboljšanja

Ograničenja SL_ZIGBEE_KEY_TABLE_SIZE proširena su na 254 unosa.
Dodan zigbee_security_link_keys u Z3Light.
Dodan zigbee_security_link_keys u zigbee_mp_z3_tc_z3_tc. Ažurirana je i veličina tablice ključeva.
Povećana je veličina tablice ključeva Z3 Gateway (koja će biti postavljena na ncp) na 20.

Riješeni problemi

Poznati problemi u trenutnom izdanju

Problemi podebljani dodani su od prethodnog izdanja. Ako ste propustili izdanje, najnovije bilješke o izdanju dostupne su na https://www.silabs.com/developers/zigbee-emberznet na kartici Tehnički dokumenti.

Zastarjele stavke

Komponenta zigbee_watchdog_periodic_refresh više se ne koristi u okviru aplikacije Zigbee i u ovom je izdanju zastarjela. Watchdog timer je prema zadanim postavkama onemogućen za sve sample aplikacije. U budućnosti će SDK-u biti dodana poboljšana komponenta čuvara.
Bilješka: Omogućite mjerač vremena sa konfiguracijskom stavkom SL_LEGACY_HAL_DISABLE_WATCHDOG postavljenom na 0 u vašoj aplikaciji

Mrežna ograničenja i razmatranja

Zadane aplikacije Centra za pouzdanost koje se isporučuju s ovim izdanjem EmberZNet-a mogu podržati nekoliko uređaja na mreži. Taj se broj određuje na temelju nekoliko čimbenika, uključujući konfigurirane veličine tablice, upotrebu NVM-a i druge vrijednosti vremena generiranja i vremena izvođenja. Korisnici koji žele stvoriti velike mreže mogu se suočiti s problemima s resursima kada povećaju mrežu veću nego što aplikacija može podržati. Na primjerample, uređaj koji traži ključ veze centra za pouzdanost od centra za pouzdanost može pokrenuti sl_zigbee_af_zigbee_key_establishment_cb povratni poziv u centru za pouzdanost sa statusom h postavljenim na SL_ZIGBEE_KEY_TABLE_FULL, što pokazuje da tablica ključeva nema mjesta za dodavanje novog ključa za uređaj koji zahtijeva ili da NVM3 nema slobodnog prostora. Silicon Labs daje sljedeće preporuke za korisnike koji žele stvoriti velike mreže. Za aplikacije Centra za pouzdanost preporučuju se sljedeće konfiguracije. Ove preporuke nisu iscrpne i služe kao osnova za aplikacije koje namjeravaju razviti velike mreže.

Uključivanje komponente tablice adresa (zigbee_address_table), sa
- konfiguracijska stavka SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE postavljena na veličinu željene mreže
- vrijednost SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE postavljena na maksimum (4)

Uključivanje komponente Security Link Keys (zigbee_security_link_keys), sa
- Vrijednost SL_ZIGBEE_KEY_TABLE_SIZE postavljena je na veličinu mreže
Sljedeće konfiguracijske stavke postavljene su na veličinu željene mreže
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, kako se nalazi u komponenti Zigbee Pro Stack
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, kako se nalazi u komponenti izvornog usmjeravanja, ako se koristi izvorno usmjeravanje
Prilagodba NVM3_DEFAULT_NVM_SIZE i NVM3_DEFAULT_CACHE_SIZE prema upotrebi NVM3
- Npr. mreže veće od 65 čvorova vjerojatno zahtijevaju NVM3 veličinu od 64K. Zadana veličina NVM3 u Silicon Labs Zigbee sample aplikacija je 32K. Aplikacije koje jače koriste NVM mogu zahtijevati još veću prilagodbu ove vrijednosti.
- Velike mreže do 65 čvorova mogu trebati veličinu NVM3 predmemorije od 1200 bajtova; rastuće mreže veće od toga mogu zahtijevati udvostručenje ove vrijednosti na 2400 bajtova.

Ove se prilagodbe odnose samo na centar za pouzdanost

Višeprotokolni pristupnik i RCP

Nove stavke
Omogućena GA SoC podrška za BLE DMP sa Zigbee + Openthread CMP s istodobnim slušanjem na xG26 dijelovima. Dodana je podrška za Debian alpha za aplikacije Zigbeed, OTBR i Z3Gateway. Zigbeed i OTBR dostupni su i u DEB formatu paketa za odabranu referentnu platformu (Raspberry PI 4). Pogledajte Istodobno pokretanje Zigbeea, OpenThreada i Bluetootha na Linux hostu s višeprotokolnim koprocesorom, koji se nalazi na docs.silabs.com, za detalje. Dodana Zigbeed podrška za Tizen-0.1-13.1 za arm32 i aarch64 kao i Android 12 za aarch64. Više informacija o Zigbeedu možete pronaći na docs.silabs.com. Dodana je nova komponenta "802.15.4 Unified radio scheduler priority". Ova se komponenta koristi za konfiguriranje radio prioriteta 15.4 steka. Komponenta također zahtijeva novu komponentu "radio_priority_configurator". Ova komponenta omogućuje projektima korištenje alata Radio Priority Configurator u Simplicity Studio za konfiguriranje razina radijskog prioriteta skupova koji to zahtijevaju.

Poboljšanja
Napomena o aplikaciji Istodobno pokretanje Zigbeea, OpenThreada i Bluetootha na Linux hostu s višeprotokolnim koprocesorom (AN1333) premješteno je na docs.silabs.com. Podrška za OpenWRT sada je GA kvalitete. Dodana je podrška za OpenWRT za aplikacije Zigbee, OTBR i Z3Gateway. Zigbeed i OTBR dostupni su u IPK formatu paketa i za referentnu platformu (Raspberry PI 4). Pogledajte Istodobno pokretanje Zigbeea, OpenThreada i Bluetootha na Linux hostu s višeprotokolnim koprocesorom, koji se nalazi na docs.silabs.com, za detalje.

Riješeni problemi

Poznati problemi u trenutnom izdanju
Problemi podebljani dodani su od prethodnog izdanja. Ako ste propustili izdanje, najnovije bilješke o izdanju su dostupnehttps://www.silabs.com/developers/simplicity-software-development-kit.

Zastarjele stavke
"Multiprotocol Container" koji je trenutno dostupan na DockerHubu (siliconlabsinc/multiprotocol) bit će obustavljen u nadolazećem izdanju. Spremnik se više neće ažurirati i moći će se povući iz DockerHuba. Paketi temeljeni na Debianu za cpcd, ZigBee i ot-br-posix, zajedno s nativno generiranim i prevedenim projektima, zamijenit će funkcionalnost izgubljenu uklanjanjem spremnika.

Korištenje ovog izdanja

Ovo izdanje sadrži sljedeće:

Zigbee stog
Zigbee aplikacijski okvir
Zigbee Sample Aplikacije

Za više informacija o Zigbee i EmberZNet SDK pogledajte UG103.02: Zigbee Fundamentals. Ako ste prvi korisnik, pogledajte QSG180: Zigbee EmberZNet Quick Start Guide za SDK 7.0 i novije verzije, za upute o konfiguriranju vašeg razvojnog okruženja, izgradnji i flashanju kaoampaplikaciju i reference dokumentacije koje upućuju na daljnje korake.

Instalacija i korištenje
Zigbee EmberZNet SDK dostupan je kao dio Simplicity SDK-a, paketa Silicon Labs SDK-ova. Kako biste brzo započeli s Simplicity SDK-om, instalirajte Simplicity Studio 5, koji će postaviti vaše razvojno okruženje i provesti vas kroz instalaciju Simplicity SDK-a. Simplicity Studio 5 uključuje sve što je potrebno za razvoj IoT proizvoda s uređajima Silicon Labsa, uključujući pokretač resursa i projekata, alate za konfiguraciju softvera, puni IDE s lancem alata GNU i alate za analizu. Upute za instalaciju nalaze se u mrežnom korisničkom priručniku za Simplicity Studio 5. Alternativno, Simplicity SDK može se instalirati ručno preuzimanjem ili kloniranjem najnovijeg s GitHuba. Vidjeti https://github.com/SiliconLabs/simplicity_sdk za više informacija. Simplicity Studio prema zadanim postavkama instalira Simplicity SDK u:

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

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

Dokumentacija specifična za verziju SDK-a instalirana je uz SDK. Dodatne informacije često se mogu pronaći u člancima baze znanja (KBA). API reference i druge informacije o ovom i ranijim izdanjima dostupne su na https://docs.silabs.com/.

Sigurnosne informacije
Sigurna integracija trezora
Za aplikacije koje odluče sigurno pohraniti ključeve pomoću komponente Secure Key Storage na dijelovima Secure Vault-High, sljedeća tablica prikazuje zaštićene ključeve i njihove karakteristike zaštite pohrane kojima upravlja komponenta Zigbee Security Manager.Zamotani ključevi koji su označeni kao "Non-Exportable" mogu se koristiti, ali ne mogu viewizdani ili podijeljeni tijekom izvođenja. Zamotani ključevi koji su označeni kao "Izvozni" mogu se koristiti ili dijeliti tijekom izvođenja, ali ostaju šifrirani dok su pohranjeni u Flashu. Korisničke aplikacije nikad ne moraju komunicirati s većinom ovih tipki. Postojeći API-ji za upravljanje ključevima tablice ključeva veze ili prijelaznim ključevima i dalje su dostupni korisničkoj aplikaciji i ne usmjeravaju se putem komponente Zigbee Security Manager.

Sigurnosni savjeti
Da biste se pretplatili na sigurnosne savjete, prijavite se na korisnički portal Silicon Labs, a zatim odaberite Početna stranica računa. Kliknite POČETNA stranica za odlazak na početnu stranicu portala, a zatim kliknite pločicu Upravljanje obavijestima. Provjerite je li označeno "Software/Security Advisory Notices & Product Change Notices (PCN)" i jeste li pretplaćeni barem na svoju platformu i protokol. Pritisnite Spremi za spremanje promjena.

podrška
Kupci Development Kita ispunjavaju uvjete za obuku i tehničku podršku. Koristite Zigbee Silicon Laboratories web stranici za dobivanje informacija o svim proizvodima i uslugama Silicon Labs Zigbee te za prijavu za podršku proizvoda. Podršku Silicon Laboratories možete kontaktirati na http://www.silabs.com/support.

Zigbee certifikat
Izdanje Ember ZNet 8.1 kvalificirano je za Zigbee kompatibilnu platformu za SoC, NC, P i RCP arhitekture, postoji ZCP certifikacijski ID povezan s ovim izdanjem, provjerite CSA webmjesto ovdje:
https://csa-iot.org/csa-iot_products/.

Imajte na umu da je ZCP certifikat filed objaviti izdanje i potrebno je nekoliko tjedana prije nego što se odrazi na CSA webmjesto. Za sva daljnja pitanja obratite se podršci Silicon Laboratories na http://www.silabs.com/support.

FAQ

P: Kako mogu ažurirati veličinu tablice ključeva veze APS u SDK-u?
O: Veličina tablice ključeva APS veze može se konfigurirati pomoću parametra SL_ZIGBEE_KEY_TABLE_SIZE. U verziji 8.1 proširen je sa 127 na 254 unosa.

P: Koja su poboljšanja u verziji 8.1?
O: Verzija 8.1 donosi poboljšanja kao što je proširenje veličine tablice ključeva veze APS, preimenovanje komponenti, dodavanje mutex zaštite za red čekanja događaja Athe pp Framework i više. Za detaljan popis poboljšanja pogledajte napomene o izdanju.

P: Kako rješavam popravljene probleme u SDK-u?
O: Popravljeni problemi u SDK-u uključujući rješavanje potencijalnih problema s konfiguracijom veličine susjedne tablice, preimenovanje komponenti, popravljanje troškova izvorne rute, rukovanje ZCL naredbama i više. Obavezno ažurirajte na najnoviju verziju kako biste imali koristi od ovih popravaka.

Dokumenti / Resursi

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

Reference

korisnički priručnik

SILICON LABS Zigbee EmberZ Net SDK

Tehnički podaci

Informacije o proizvodu