SILICON LABS Zigbee EmberZ Net SDK uputstva

Silicon Labs je dobavljač izbora za OEM proizvođače koji razvijaju Zigbee umrežavanje u svoje proizvode. Silicon Labs Zigbee platforma je najintegrisanije, najkompletnije i najbogatije Zigbee rešenje dostupno. Silicon Labs EmberZNet SDK sadrži implementaciju Zigbee stack specifikacije od strane Silicon Labs.

KLJUČNE KARAKTERISTIKE

Zigbee

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

Podrška za modul xG26

Multiprotocol

ZigbeeD i OTBR podrška na OpenWRT – GA
DMP BLE + CMP ZB & Matter/OT s istovremenim 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ča APS veze (konfigurirana korištenjem SL_ZIGBEE_KEY_TABLE_SIZE) je proširena sa 127 na 254 unosa.

Dodata je R23 podrška za funkciju puštanja u rad ZDD mreže. Funkcionalnost tuneliranja dostupna je bez podrške za slučajeve upotrebe naslijeđene mreže.

Komponente Network Steering i Network Creator su ažurirane kako bi uključile podršku za R23 spajanje. To uključuje sljedeće povezane promjene.
- Zadana politika zahtjeva za vezu centra za pouzdanost (TCLK) je ažurirana kako bi se generirali novi ključevi za svaki uređaj koji traži. Novi ključ se generira svaki put kada uređaji koji traže da pokušaju ažurirati svoj ključ veze centra za pouzdanost.
- Zbog prethodne promjene TCLK politike, 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,
  SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY je dodan kako bi se omogućilo spajanje pomoću jezgrenog, heširanog ključa. Ova konfiguracija se nalazi pod komponentom Network Creator Security. Upotreba ove politike omogućava svakom uređaju koji se pridružuje da dobije jedinstveni TCLK nakon pridruživanja, ali ponovljeni pokušaji ažuriranja TCLK-a neće rezultirati novim ključem za uređaj koji je zatražio. Ova upotreba heširanih ključeva veze bila je zadana politika prije ovog izdanja, a korištenje ove politike omogućava Centru za povjerenje da izbjegne unošenje komponente Sigurnosne veze koja čuva ključeve u Flash-u.
  Napomena: Silicon Labs ne preporučuje korištenje ove politike, jer to sprječava da uređaji koji se spajaju pokreću ili ažuriraju svoje TCLK-ove.

Novi set konfiguracije je dodan komponenti zigbee_ezsp_spi kako bi se omogućila konfiguracija glavnog SPI uređaja i njegovih pin interfejsa.
Bivšiample projekte, uključujući i projekat files (.slcps) i folder projekta, preimenovani su u smjernice za imenovanje Silicon Labsa i premeš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
Explorer Kit
- BRD2709A
- MGM260P-EK2713A

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

Poboljšanja

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

Fiksni problemi

Poznati problemi u trenutnom izdanju

Problemi koji su 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.

Zastarjeli predmeti

Komponenta zigbee_watchdog_periodic_refresh se više ne koristi u Zigbee aplikacijskom okviru i zastarjela je u ovom izdanju. Watchdog timer je po defaultu onemogućen za sve sample applications. U budućnosti će se u SDK dodati poboljšana komponenta čuvara.
Napomena: Omogućite watchdog tajmer 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 povjerenje koje se isporučuju s ovim izdanjem EmberZNet mogu podržavati nekoliko uređaja na mreži. Ovaj broj se određuje na osnovu nekoliko faktora, uključujući konfigurisane veličine tabele, upotrebu NVM-a i druge vrednosti vremena generisanja i vremena izvođenja. Korisnici koji žele da stvore velike mreže mogu se suočiti sa problemima resursa kada rastu mrežu veću nego što aplikacija može da podrži. Za nprampDakle, uređaj koji traži ključ za vezu centra za povjerenje od centra za povjerenje može pokrenuti povratni poziv sl_zigbee_af_zigbee_key_establishment_cb u centru za povjerenje sa h statusom postavljenim na SL_ZIGBEE_KEY_TABLE_FULL, što ukazuje da tabela ključeva nema prostora za dodavanje novog ključa za uređaj koji zahtijeva NVM3 nema slobodnog prostora. Silicon Labs pruža 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 da rastu velike mreže.

Uključivanje komponente Address Table (zigbee_address_table), sa
- stavka konfiguracije 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 je postavljena na veličinu mreže
Sljedeće konfiguracijske stavke su postavljene na veličinu željene mreže
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, kako se nalazi u Zigbee Pro Stack komponenti
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, kao što se nalazi u komponenti Izvorno rutiranje, ako se koristi izvorno rutiranje
Podešavanje NVM3_DEFAULT_NVM_SIZE i NVM3_DEFAULT_CACHE_SIZE prema upotrebi NVM3
- Na primjer, veličine mreže veće od 65 čvorova vjerovatno zahtijevaju NVM3 veličinu od 64K. Zadana veličina NVM3 u Silicon Labs Zigbee sampbroj aplikacija je 32K. Aplikacije koje više koriste NVM mogu zahtijevati podešavanje ove vrijednosti još više.
- Velikim mrežama do 65 čvorova može biti potrebna veličina NVM3 keša od 1200 bajtova; rastuće mreže veće od toga može zahtijevati udvostručenje ove vrijednosti na 2400 bajtova.

Ova podešavanja se odnose samo na Centar za poverenje

Multiprotocol Gateway i RCP

Nove stavke
Omogućena GA SoC podrška za BLE DMP sa Zigbee + Openthread CMP sa istovremenim slušanjem na xG26 delovima. Debian alpha podrška je dodana za aplikacije Zigbeed, OTBR i Z3Gateway. Zigbeed i OTBR su takođe obezbeđeni u DEB formatu paketa za odabranu referentnu platformu (Raspberry PI 4). Pogledajte istovremeno pokretanje Zigbee-a, OpenThread-a i Bluetooth-a na Linux hostu sa višeprotokolskim koprocesorom, koji se nalazi na docs.silabs.com, za detalje. Dodata Zigbeed podrška za Tizen-0.1-13.1 za arm32 i aarch64, kao i za Android 12 za aarch64. Više informacija o Zigbeedu možete pronaći na docs.silabs.com. Dodata nova komponenta „802.15.4 Unified radio Scheduler prioritet“. Ova komponenta se koristi za konfigurisanje radio prioriteta 15.4 steka. Komponenta također zahtijeva novu komponentu “radio_priority_configurator”. Ova komponenta omogućava projektima da koriste alat Radio Priority Configurator u Simplicity Studio za konfigurisanje nivoa radio prioriteta stekova koji to zahtevaju.

Poboljšanja
Napomena o aplikaciji Pokretanje Zigbee, OpenThread i Bluetooth istovremeno na Linux hostu sa višeprotokolskim koprocesorom (AN1333) je premješteno na docs.silabs.com. OpenWRT podrška je sada GA kvaliteta. Dodata je OpenWRT podrška za Zigbee, OTBR i Z3Gateway aplikacije. Zigbeed i OTBR su takođe obezbeđeni u IPK formatu paketa za referentnu platformu (Raspberry PI 4). Pogledajte istovremeno pokretanje Zigbee-a, OpenThread-a i Bluetooth-a na Linux hostu sa višeprotokolskim koprocesorom, koji se nalazi na docs.silabs.com, za detalje.

Fiksni problemi

Poznati problemi u trenutnom izdanju
Problemi koji su podebljani dodani su od prethodnog izdanja. Ako ste propustili izdanje, napomene o nedavnom izdanju dostupne su oathttps://www.silabs.com/developers/simplicity-software-development-kit.

Zastarjeli predmeti
“Multiprotocol Container” koji je trenutno dostupan na DockerHubu (siliconlabsinc/multiprotocol) bit će zastario u nadolazećem izdanju. Kontejner se više neće ažurirati i moći će ga povući iz DockerHuba. Paketi bazirani na Debianu za cpcd, ZigBee i ot-br-posix, zajedno s izvorno generiranim i kompajliranim projektima, zamijenit će funkcionalnost izgubljenu uklanjanjem kontejnera.

Korištenje ovog izdanja

Ovo izdanje sadrži sljedeće:

Zigbee stack
Zigbee Application Framework
Zigbee Sample Applications

Za više informacija o Zigbee-u i EmberZNet SDK-u pogledajte UG103.02: Zigbee osnove. Ako ste prvi put korisnik, pogledajte QSG180: Zigbee EmberZNet Quick-Start Guide za SDK 7.0 i novije, za upute o konfiguriranju vašeg razvojnog okruženja, izgradnji i flešovanju kaoample aplikacija i reference dokumentacije koje upućuju na dalje korake.

Instalacija i upotreba
Zigbee EmberZNet SDK je dostupan kao dio Simplicity SDK-a, paketa Silicon Labs SDK-ova. Da biste brzo počeli sa Simplicity SDK, 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 sa Silicon Labs uređajima, uključujući pokretač resursa i projekata, alate za konfiguraciju softvera, puni IDE sa GNU alatima i alate za analizu. Uputstva za instalaciju nalaze se u Simplicity Studio 5 korisničkom vodiču na mreži. Alternativno, Simplicity SDK se može instalirati ručno preuzimanjem ili kloniranjem najnovijeg sa GitHuba. Vidi https://github.com/SiliconLabs/simplicity_sdk za više informacija. Simplicity Studio podrazumevano instalira Simplicity SDK u:

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

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

Dokumentacija specifična za verziju SDK-a se instalira sa SDK-om. Dodatne informacije se često 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 da bezbedno skladište ključeve koristeći komponentu Secure Key Storage na Secure Vault-High delovima, sledeća tabela prikazuje zaštićene ključeve i njihove karakteristike zaštite skladištenja kojima upravlja komponenta Zigbee Security Manager.Umotani ključevi koji su označeni kao “Non-Exportable” mogu se koristiti, ali ne mogu viewuređivati ili dijeliti u vrijeme izvođenja. Umotani ključevi koji su označeni kao "Izvozni" mogu se koristiti ili dijeliti u vrijeme izvođenja, ali ostaju šifrirani dok su pohranjeni u Flash-u. Korisničke aplikacije nikada ne moraju komunicirati s većinom ovih ključeva. Postojeći API-ji za upravljanje ključevima tablice ključeva veza ili prijelaznim ključevima i dalje su dostupni korisničkoj aplikaciji i ne usmjeravaju se kroz komponentu Zigbee Security Manager.

Sigurnosni savjeti
Da biste se pretplatili na Security Advisories, prijavite se na korisnički portal Silicon Labs, a zatim odaberite Account Home. Kliknite HOME da biste otišli na početnu stranicu portala, a zatim kliknite pločicu Upravljanje obavijestima. Uvjerite se da je označeno 'Software/Security Advisory Notices & Product Change Notices (PCNs)' i da ste pretplaćeni na minimum za svoju platformu i protokol. Kliknite Spremi da sačuvate sve promjene.

Podrška
Korisnici Development Kita imaju pravo na obuku i tehničku podršku. Koristite Zigbee Silicon Laboratories web stranicu da biste dobili informacije o svim Silicon Labs Zigbee proizvodima i uslugama i da biste se prijavili za podršku za proizvode. Možete kontaktirati podršku Silicon Laboratories na http://www.silabs.com/support.

Zigbee Certification
Izdanje Ember ZNet 8.1 je kvalificirano za Zigbee kompatibilnu platformu za SoC, NC, P i RCP arhitekture postoji ZCP ID certifikata vezan za ovo izdanje, molimo provjerite CSA webstranica ovdje:
https://csa-iot.org/csa-iot_products/.

Imajte na umu da je ZCP certifikat filed nakon objavljivanja, i potrebno je nekoliko sedmica prije nego što se odrazi na CSA website. Za sva dodatna pitanja kontaktirajte podršku Silicon Laboratories na http://www.silabs.com/support.

FAQs

P: Kako da ažuriram veličinu tablice ključeva APS veze u SDK-u?
O: Veličina tablice ključa APS veze može se konfigurirati korištenjem 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 su proširenje veličine tablice ključeva APS veze, preimenovanje komponenti, dodavanje mutex zaštite za Athe pp Framework red događaja i još mnogo toga. Pogledajte napomene o izdanju za detaljnu listu poboljšanja.

P: Kako mogu riješiti riješene 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 izvornih ruta, rukovanje ZCL komandama i još mnogo toga. 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

Uputstvo za upotrebu

SILICON LABS Zigbee EmberZ Net SDK

Specifikacije

Informacije o proizvodu