SILICON LABS Zigbee EmberZ Net SDK Instrucțiuni

Silicon Labs este furnizorul de alegere pentru OEM care dezvoltă rețele Zigbee în produsele lor. Platforma Silicon Labs Zigbee este cea mai integrată, completă și mai bogată soluție Zigbee disponibilă. Silicon Labs EmberZNet SDK conține implementarea de către Silicon Labs a specificației stivei Zigbee.

CARACTERISTICI CHEIE

Zigbee

-250+ intrări în tabelul de chei de legătură APS
Suport ZigbeeD pe Android 12 (v21.0.6113669) și Tizen (v0.1-13.1)

Suport pentru modul xG26

multiprotocol

Suport ZigbeeD și OTBR pe OpenWRT – GA
DMP BLE + CMP ZB și Matter/OT cu ascultare simultană pe MG26 pentru SoC – GA

802.15.4 Componentă prioritară a planificatorului radio unificat
Suport de ambalare Debian pentru aplicațiile gazdă MP – Alpha

Articole noi

Schimbări importante
Dimensiunea tabelului de chei de legătură APS (configurată folosind SL_ZIGBEE_KEY_TABLE_SIZE) este extinsă de la 127 la 254 de intrări.

Suportul R23 este adăugat pentru funcționalitatea de punere în funcțiune a rețelei ZDD. Funcționalitatea de tunel este disponibilă fără suport pentru cazurile de utilizare Legacy Network.

Componentele Network Steering și Network Creator au fost actualizate pentru a include suport pentru aderarea la R23. Acestea includ următoarele modificări asociate.
- Politica implicită de solicitare a cheii de legătură a centrului de încredere (TCLK) a fost actualizată pentru a genera chei noi pentru fiecare dispozitiv solicitant. O nouă cheie este generată de fiecare dată când dispozitivele solicitante încearcă să-și actualizeze cheia de legătură din Centrul de încredere.
- Datorită modificării anterioare a politicii TCLK, componenta Network Creator Security necesită acum componenta Security Link Keys. Actualizarea aplicațiilor va fi actualizată pentru a se conforma acestei noi cerințe.
- O nouă configurație,
  SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY este adăugat pentru a permite alăturarea utilizând o cheie hashed de bază. Această configurație se găsește sub componenta Network Creator Security. Utilizarea acestei politici permite fiecărui dispozitiv care se alătură să primească un TCLK unic după alăturare, dar încercările repetate de a actualiza TCLK nu vor avea ca rezultat o nouă cheie pentru dispozitivul solicitant. Această utilizare a cheilor de legătură cu hash era politica implicită înainte de această lansare, iar utilizarea acestei politici permite Centrului de încredere să evite introducerea componentei Chei de legătură de securitate, care salvează cheile în Flash.
  Nota: Silicon Labs nu recomandă utilizarea acestei politici, deoarece aceasta împiedică dispozitivele conectate să ruleze sau să își actualizeze TCLK-urile.

Un nou set de configurare este adăugat la componenta zigbee_ezsp_spi pentru a permite configurarea dispozitivului SPI gazdă și a interfețelor pin ale acestuia.
Example proiecte, inclusiv proiectul files (.slcps) și folderul de proiect, sunt redenumite în ghidurile de denumire Silicon Labs și mutate în directorul „proiecte”.

Suport pentru platformă nouă

Module noi
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Placi radio noi
- MGM260P-RB4350A
- MGM260P-RB4351A
Piesa noua
- efr32xg27
Kit de explorator
- BRD2709A
- MGM260P-EK2713A

Documentație nouă
Un nou ghid de utilizare EZSP UG600 pentru versiunile 8.1 și versiunile ulterioare.

Îmbunătățiri

Limitele SL_ZIGBEE_KEY_TABLE_SIZE au fost extinse până la 254 de intrări.
S-au adăugat zigbee_security_link_keys la Z3Light.
S-au adăugat zigbee_security_link_keys la zigbee_mp_z3_tc_z3_tc. Și-a actualizat și dimensiunea tabelului cheie.
S-a mărit dimensiunea tabelului de chei Z3 Gateway (care va fi setată la ncp) la 20.

Probleme remediate

Probleme cunoscute în versiunea curentă

Problemele cu caractere aldine au fost adăugate de la versiunea anterioară. Dacă ați ratat o lansare, notele de lansare recente sunt disponibile la https://www.silabs.com/developers/zigbee-emberznet în fila Tech Docs.

Articole depreciate

Componenta zigbee_watchdog_periodic_refresh nu mai este utilizată în cadrul aplicației Zigbee și este depreciată în această ediție. Timer-ul watchdog este dezactivat implicit pentru toate sample aplicații. În viitor, se va adăuga o componentă de supraveghere îmbunătățită la SDK.
Nota: Activați temporizatorul watchdog cu elementul de configurare SL_LEGACY_HAL_DISABLE_WATCHDOG setat la 0 în aplicația dvs.

Limitări și considerații ale rețelei

Aplicațiile implicite Trust Center care sunt livrate cu această versiune EmberZNet sunt capabile să accepte mai multe dispozitive din rețea. Acest număr este determinat pe baza mai multor factori, inclusiv dimensiunile tabelelor configurate, utilizarea NVM-ului și alte valori ale timpului de generare și ale timpului de execuție. Utilizatorii care doresc să creeze rețele mari se pot confrunta cu probleme de resurse atunci când cresc rețeaua mai mare decât poate suporta aplicația. De exampun dispozitiv care solicită o cheie de legătură Centrul de încredere de la Centrul de încredere poate declanșa un apel invers sl_zigbee_af_zigbee_key_establishment_cb în Centrul de încredere cu starea h setată la SL_ZIGBEE_KEY_TABLE_FULL, indicând că tabelul de chei nu are spațiu pentru a adăuga o nouă cheie pentru dispozitivul solicitant sau că NVM3 nu are spațiu disponibil. Silicon Labs oferă următoarele recomandări pentru utilizatorii care doresc să creeze rețele mari. Pentru aplicațiile Trust Center, sunt recomandate următoarele configurații. Aceste recomandări nu sunt exhaustive și servesc drept bază pentru aplicațiile care intenționează să crească rețele mari.

Includerea componentei Tabel de adrese (zigbee_address_table), cu
- elementul de configurare SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE setat la dimensiunea rețelei dorite
- valoarea SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE setată la maximum (4)

Includerea componentei Security Link Keys (zigbee_security_link_keys), cu
- Valoarea SL_ZIGBEE_KEY_TABLE_SIZE este setată la dimensiunea rețelei
Următoarele elemente de configurare sunt setate la dimensiunea rețelei dorite
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, așa cum se găsește în componenta Zigbee Pro Stack
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, așa cum se găsește în componenta de rutare sursă, dacă este utilizată rutarea sursă
Ajustarea NVM3_DEFAULT_NVM_SIZE și NVM3_DEFAULT_CACHE_SIZE în funcție de utilizarea NVM3
- De exemplu, dimensiunile rețelei mai mari de 65 de noduri necesită probabil o dimensiune NVM3 de 64K. Dimensiunea implicită NVM3 în Silicon Labs Zigbee sampaplicațiile este de 32K. Aplicațiile care folosesc NVM mai intens pot necesita ajustarea acestei valori și mai mare.
- Rețelele mari de până la 65 de noduri pot avea nevoie de o dimensiune cache NVM3 de 1200 de octeți; creșterea rețelelor mai mari decât aceasta poate necesita dublarea acestei valori la 2400 de octeți.

Aceste ajustări se aplică numai Centrului de încredere

Gateway multiprotocol și RCP

Articole noi
Compatibilitate GA SoC activată pentru BLE DMP cu Zigbee + Openthread CMP cu ascultare simultană pe părți xG26. A fost adăugat suport Debian alpha pentru aplicațiile Zigbeed, OTBR și Z3Gateway. Zigbeed și OTBR sunt furnizate în format de pachet DEB și pentru platforma de referință aleasă (Raspberry PI 4). Consultați Rularea Zigbee, OpenThread și Bluetooth simultan pe o gazdă Linux cu un co-procesor multiprotocol, găsit la docs.silabs.com, pentru detalii. S-a adăugat suport Zigbeed pentru Tizen-0.1-13.1 pentru arm32 și aarch64, precum și Android 12 pentru aarch64. Mai multe informații despre Zigbeed pot fi găsite la docs.silabs.com. A fost adăugată noua componentă „802.15.4 Unified radio scheduler priority”. Această componentă este utilizată pentru a configura prioritățile radio ale unei stive 15.4. Componenta necesită, de asemenea, noua componentă „radio_priority_configurator”. Această componentă permite proiectelor să utilizeze instrumentul Radio Priority Configurator din Simplicity Studio pentru a configura nivelurile de prioritate radio ale stivelor care necesită acest lucru.

Îmbunătățiri
Notă de aplicație Rularea Zigbee, OpenThread și Bluetooth simultan pe o gazdă Linux cu un co-procesor multiprotocol (AN1333) a fost mutată în docs.silabs.com. Suportul OpenWRT este acum calitate GA. Suportul OpenWRT a fost adăugat pentru aplicațiile Zigbee, OTBR și Z3Gateway. Zigbeed și OTBR sunt furnizate în format de pachet IPK și pentru platforma de referință (Raspberry PI 4). Consultați Rularea Zigbee, OpenThread și Bluetooth simultan pe o gazdă Linux cu un co-procesor multiprotocol, găsit la docs.silabs.com, pentru detalii.

Probleme remediate

Probleme cunoscute în versiunea curentă
Problemele cu caractere aldine au fost adăugate de la versiunea anterioară. Dacă ați ratat o lansare, notele de lansare recente sunt disponibilehttps://www.silabs.com/developers/simplicity-software-development-kit.

Articole depreciate
„Containerul multiprotocol”, care este disponibil în prezent pe DockerHub (siliconlabsinc/multiprotocol) va fi depreciat într-o versiune viitoare. Containerul nu va mai fi actualizat și nu va mai putea fi extras din DockerHub. Pachetele bazate pe Debian pentru cpcd, ZigBee și ot-br-posix, împreună cu proiectele generate și compilate nativ, vor înlocui funcționalitatea pierdută odată cu eliminarea containerului.

Folosind această versiune

Această versiune conține următoarele:

Stivă Zigbee
Cadrul de aplicații Zigbee
Zigbee SampAplicațiile

Pentru mai multe informații despre Zigbee și EmberZNet SDK, consultați UG103.02: Zigbee Fundamentals. Dacă sunteți un utilizator pentru prima dată, consultați QSG180: Ghid de pornire rapidă Zigbee EmberZNet pentru SDK 7.0 și versiuni ulterioare, pentru instrucțiuni despre configurarea mediului de dezvoltare, crearea și intermiterea caampaplicația și documentația referințe care indică pașii ext.

Instalare și utilizare
Zigbee EmberZNet SDK este furnizat ca parte a Simplicity SDK, suita de SDK-uri Silicon Labs. Pentru a începe rapid cu Simplicity SDK, instalați Simplicity Studio 5, care vă va configura mediul de dezvoltare și vă va ghida prin instalarea Simplicity SDK. Simplicity Studio 5 include tot ceea ce este necesar pentru dezvoltarea de produse IoT cu dispozitivele Silicon Labs, inclusiv un lansator de resurse și proiecte, instrumente de configurare software, IDE complet cu lanț de instrumente GNU și instrumente de analiză. Instrucțiunile de instalare sunt furnizate în Ghidul utilizatorului online Simplicity Studio 5. Alternativ, Simplicity SDK poate fi instalat manual prin descărcarea sau clonarea celui mai recent din GitHub. Vedea https://github.com/SiliconLabs/simplicity_sdk pentru mai multe informații. Simplicity Studio instalează Simplicity SDK în mod implicit în:

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

(MacOS): /Utilizatori//SimplicityStudio/SDK-uri/simplicity_sdk

Documentația specifică versiunii SDK este instalată împreună cu SDK. Informații suplimentare pot fi găsite adesea în articolele din baza de cunoștințe (KBA). Referințele API și alte informații despre aceasta și versiunile anterioare sunt disponibile pe site https://docs.silabs.com/.

Informații de securitate
Integrare sigură a seifului
Pentru aplicațiile care aleg să stocheze cheile în siguranță utilizând componenta Secure Key Storage pe componentele Secure Vault-High, următorul tabel arată cheile protejate și caracteristicile de protecție a stocării acestora pe care le gestionează componenta Zigbee Security Manager.Cheile împachetate care sunt marcate ca „Neexportabile” pot fi folosite, dar nu pot fi vieweditat sau partajat în timpul execuției. Cheile împachetate care sunt marcate ca „Exportabile” pot fi folosite sau partajate în timpul execuției, dar rămân criptate în timp ce sunt stocate în Flash. Aplicațiile utilizator nu trebuie să interacționeze cu majoritatea acestor chei. API-urile existente pentru a gestiona cheile din tabelul cheilor de legătură sau cheile tranzitorii sunt încă disponibile pentru aplicația utilizator și nu sunt direcționate prin componenta Zigbee Security Manager.

Recomandări de securitate
Pentru a vă abona la Security Advisories, conectați-vă la portalul pentru clienți Silicon Labs, apoi selectați Account Home. Faceți clic pe HOME pentru a accesa pagina de pornire a portalului, apoi faceți clic pe tigla Gestionați notificările. Asigurați-vă că este bifată „Notice de consiliere pentru software/securitate și notificări de schimbare a produsului (PCN)” și că sunteți abonat minim pentru platforma și protocolul dvs. Faceți clic pe Salvare pentru a salva orice modificări.

Sprijin
Clienții Kitului de dezvoltare sunt eligibili pentru instruire și asistență tehnică. Utilizați Silicon Laboratories Zigbee web pagina pentru a obține informații despre toate produsele și serviciile Silicon Labs Zigbee și pentru a vă înscrie pentru asistență pentru produse. Puteți contacta asistența Silicon Laboratories la http://www.silabs.com/support.

Certificare Zigbee
Versiunea Ember ZNet 8.1 a fost calificată pentru platforma compatibilă Zigbee pentru arhitecturi SoC, NC, P și RCP, există un ID de certificare ZCP legat de această ediție, vă rugăm să verificați CSA website aici:
https://csa-iot.org/csa-iot_products/.

Vă rugăm să rețineți că certificarea ZCP este filed postați lansarea și durează câteva săptămâni înainte de a se reflecta asupra CSA website-ul. Pentru orice întrebări suplimentare, vă rugăm să contactați asistența Silicon Laboratories la http://www.silabs.com/support.

Întrebări frecvente

Î: Cum actualizez dimensiunea tabelului de chei de link APS în SDK?
R: Dimensiunea tabelului de chei de legătură APS poate fi configurată utilizând parametrul SL_ZIGBEE_KEY_TABLE_SIZE. În versiunea 8.1, a fost extins de la 127 la 254 de intrări.

Î: Care sunt îmbunătățirile din versiunea 8.1?
R: Versiunea 8.1 aduce îmbunătățiri, cum ar fi extinderea dimensiunii tabelului de chei de legătură APS, redenumirea componentelor, adăugarea protecției mutex pentru coada de evenimente Athe pp Framework și multe altele. Consultați notele de lansare pentru o listă detaliată a îmbunătățirilor.

Î: Cum gestionez problemele remediate în SDK-ul?
R: S-au rezolvat probleme în SDK, inclusiv rezolvarea problemelor potențiale cu configurarea dimensiunii tabelului vecin, redenumirea componentelor, repararea supraîncărcării rutei sursă, gestionarea comenzilor ZCL și multe altele. Asigurați-vă că actualizați la cea mai recentă versiune pentru a beneficia de aceste remedieri.

Documente/Resurse

SILICON LABS Zigbee EmberZ Net SDK [pdfInstrucțiuni
Zigbee EmberZ Net SDK, EmberZ Net SDK, Net SDK, SDK

Referințe

Manual de utilizare

SILICON LABS Zigbee EmberZ Net SDK

Specificații

Informații despre produs