SILICON LABS Zigbee EmberZ Net SDK -ohjeet

Silicon Labs on ensisijainen toimittaja OEM-valmistajille, jotka kehittävät Zigbee-verkottumista tuotteisiinsa. Silicon Labs Zigbee -alusta on integroiduin, täydellisin ja monipuolisin saatavilla oleva Zigbee-ratkaisu. Silicon Labs EmberZNet SDK sisältää Silicon Labsin Zigbee-pinomäärittelyn toteutuksen.

KESKEISET OMINAISUUDET

Zigbee

-250+ merkintää APS-linkkiavaintaulukossa
ZigbeeD-tuki Android 12:ssa (v21.0.6113669) ja Tizenissä (v0.1-13.1)

xG26-moduulituki

Moniprotokolla

ZigbeeD- ja OTBR-tuki OpenWRT – GA:ssa
DMP BLE + CMP ZB & Matter/OT rinnakkaisella kuuntelulla MG26:lla SoC – GA:lle

802.15.4 Unified Radio Schedler prioriteettikomponentti
Debian-pakkaustuki MP-isäntäsovelluksille – Alpha

Uusia kohteita

Tärkeitä muutoksia
APS-linkkiavaintaulukon koko (määritetty käyttämällä SL_ZIGBEE_KEY_TABLE_SIZE) on laajennettu 127:stä 254:ään.

R23-tuki on lisätty ZDD Networkin käyttöönottotoimintoihin. Tunnelointitoiminto on saatavilla ilman tukea Legacy Network -käyttötapauksille.

Network Steering- ja Network Creator -komponentit on päivitetty sisältämään tuen R23-liittymiselle. Näitä ovat seuraavat asiaan liittyvät muutokset.
- Oletusarvoinen Trust Center Link Key (TCLK) -pyyntökäytäntö on päivitetty uusien avainten luomiseksi kullekin pyytävälle laitteelle. Uusi avain luodaan aina, kun pyytävät laitteet yrittävät päivittää Trust Center Link Key -avaimensa.
- Edellisen TCLK-käytäntömuutoksen vuoksi Network Creator Security -komponentti vaatii nyt Security Link Keys -komponentin. Sovellusten päivitys päivitetään tämän uuden vaatimuksen mukaisiksi.
- Uusi kokoonpano,
  SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY on lisätty mahdollistamaan liittyminen tiivistetyn ydinavaimen avulla. Tämä kokoonpano löytyy Network Creator Security -komponentista. Tämän käytännön avulla jokainen liittyvä laite voi vastaanottaa yksilöllisen TCLK:n liittymisen jälkeen, mutta toistuvat yritykset päivittää TCLK eivät johda uuteen avaimeen pyytävälle laitteelle. Tämä hajautettujen linkkiavainten käyttö oli oletuskäytäntö ennen tätä julkaisua, ja tämän käytännön käyttö mahdollistaa sen, että Trust Center ei tuo Security Link Keys -komponenttia, joka tallentaa avaimet Flashiin.
  Huom: Silicon Labs ei suosittele tämän käytännön käyttöä, koska se estää yhdistäviä laitteita rullaamasta tai päivittämästä TCLK-koodejaan.

Uusi kokoonpanojoukko lisätään komponenttiin zigbee_ezsp_spi, joka mahdollistaa isäntä-SPI-laitteen ja sen nastaliitäntöjen konfiguroinnin.
Examphankkeita, mukaan lukien hanke files (.slcps) ja projektikansio nimetään uudelleen Silicon Labsin nimeämisohjeiksi ja siirretään "projektit"-hakemistoon.

Uuden alustan tuki

Uudet moduulit
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Uudet radiotaulut
- MGM260P-RB4350A
- MGM260P-RB4351A
Uusi osa
- efr32xg27
Explorer Kit
- BRD2709A
- MGM260P-EK2713A

Uusi dokumentaatio
Uuden EZSP-käyttöoppaan UG600 versioille 8.1 ja uudemmat.

Parannuksia

SL_ZIGBEE_KEY_TABLE_SIZE-rajoitukset laajennettiin 254 merkintään.
Lisätty zigbee_security_link_keys Z3Lightiin.
Lisätty zigbee_security_link_keys kohteeseen zigbee_mp_z3_tc_z3_tc. Päivitti myös avainpöydän kokonsa.
Suuresti Z3 Gateway -avaintaulukon kokoa (joksi asetetaan ncp) 20:een.

Korjatut ongelmat

Tunnetut ongelmat nykyisessä julkaisussa

Lihavoidut ongelmat on lisätty edellisen julkaisun jälkeen. Jos olet unohtanut julkaisun, viimeisimmät julkaisutiedot ovat saatavilla osoitteessa https://www.silabs.com/developers/zigbee-emberznet Tech Docs -välilehdellä.

Käytöstä poistetut tuotteet

Zigbee_watchdog_periodic_refresh-komponenttia ei enää käytetä Zigbee-sovelluskehyksessä, ja se on vanhentunut tässä julkaisussa. Watchdog-ajastin on oletusarvoisesti poissa käytöstä kaikille sampsovelluksia. SDK:hon lisätään jatkossa parannettu vahtikoirakomponentti.
Huom: Ota vahtikoiran ajastin käyttöön, kun sovelluksesi konfigurointikohde SL_LEGACY_HAL_DISABLE_WATCHDOG on asetettu arvoon 0

Verkon rajoitukset ja huomiot

Tämän EmberZNet-julkaisun mukana tulevat oletusarvoiset Trust Center -sovellukset pystyvät tukemaan useita verkon laitteita. Tämä luku määräytyy useiden tekijöiden perusteella, mukaan lukien määritetyt taulukkokoot, NVM-käyttö ja muut luonti- ja ajonaikaiset arvot. Käyttäjät, jotka haluavat luoda suuria verkkoja, voivat kohdata resurssiongelmia, kun verkkoa kasvatetaan suuremmaksi kuin sovellus voi tukea. esimample, laite, joka pyytää Trust Centerin linkkiavainta Trust Centeristä, voi laukaista sl_zigbee_af_zigbee_key_establishment_cb-puhelun Trust Centerissä, kun h-tila on SL_ZIGBEE_KEY_TABLE_FULL, mikä osoittaa, että avaintaulukkoon ei ole tilaa lisätä uutta laitetta tai uutta avainta pyytävään laitteeseen. NVM3:ssa ei ole vapaata tilaa. Silicon Labs tarjoaa seuraavat suositukset käyttäjille, jotka haluavat luoda suuria verkkoja. Luottamuskeskuksen sovelluksille suositellaan seuraavia määrityksiä. Nämä suositukset eivät ole tyhjentäviä, ja ne toimivat lähtökohtana sovelluksille, jotka aikovat kasvattaa suuria verkkoja.

Osoitetaulukkokomponentin (zigbee_address_table) sisällyttäminen
- SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE-määrityskohde asetettu halutun verkon kokoiseksi
- SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE-arvo asetettu maksimiarvoon (4)

Suojauslinkkiavaimet-komponentin (zigbee_security_link_keys) sisällyttäminen
- SL_ZIGBEE_KEY_TABLE_SIZE-arvo on asetettu verkon koon mukaan
Seuraavat kokoonpanokohteet on asetettu halutun verkon koon mukaan
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, joka löytyy Zigbee Pro Stack -komponentista
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, joka löytyy lähdereitityskomponentista, jos lähdereititystä käytetään
NVM3_DEFAULT_NVM_SIZE ja NVM3_DEFAULT_CACHE_SIZE säätö NVM3:n käytön mukaan
- Esimerkiksi yli 65 solmun verkkokoot vaativat todennäköisesti 3 kt:n NVM64-koon. NVM3-oletuskoko Silicon Labs Zigbee s:ssäamphakemusten määrä on 32 XNUMX. Sovellukset, jotka käyttävät NVM:ää enemmän, saattavat vaatia tämän arvon säätämistä vielä korkeammaksi.
- Suuret verkot, joissa on enintään 65 solmua, saattavat tarvita NVM3-välimuistin koon 1200 tavua; tätä suurempien verkkojen kasvattaminen saattaa edellyttää tämän arvon kaksinkertaistamista 2400 tavuun.

Nämä muutokset koskevat vain Trust Centeriä

Multiprotocol Gateway ja RCP

Uusia kohteita
Käytössä oleva GA SoC -tuki BLE DMP:lle Zigbeen kanssa + Openthread CMP ja samanaikaisesti kuuntelu xG26-osissa. Debian alpha -tuki on lisätty Zigbeed-, OTBR- ja Z3Gateway-sovelluksiin. Zigbeed ja OTBR toimitetaan myös DEB-pakettimuodossa valitulle referenssialustalle (Raspberry PI 4). Katso Zigbeen, OpenThreadin ja Bluetoothin käyttäminen samanaikaisesti Linux-isännässä moniprotokolla-apuprosessorilla, löytyy osoitteesta docs.silabs.com, lisätietoja. Lisätty Zigbeed-tuki Tizen-0.1-13.1:lle arm32:lle ja aarch64:lle sekä Android 12:lle aarch64:lle. Lisätietoja Zigbeedistä löytyy osoitteesta docs.silabs.com. Lisätty uusi "802.15.4 Unified Radio Scheduler priority" -komponentti. Tätä komponenttia käytetään 15.4-pinon radioprioriteetin määrittämiseen. Komponentti vaatii myös uuden "radio_priority_configurator" -komponentin. Tämän komponentin avulla projektit voivat käyttää Simplicity Studion Radio Priority Configurator -työkalua sitä vaativien pinojen radioprioriteettitasojen määrittämiseen.

Parannuksia
Sovellushuomautus Zigbeen, OpenThreadin ja Bluetoothin käyttäminen samanaikaisesti Linux-isännällä, jossa on moniprotokolla-apuprosessori (AN1333) on siirretty docs.silabs.com. OpenWRT-tuki on nyt GA-laatua. OpenWRT-tuki on lisätty Zigbee-, OTBR- ja Z3Gateway-sovelluksiin. Zigbeed ja OTBR toimitetaan IPK-pakettimuodossa myös referenssialustaan (Raspberry PI 4). Katso Zigbeen, OpenThreadin ja Bluetoothin käyttäminen samanaikaisesti Linux-isännässä moniprotokolla-apuprosessorilla, löytyy osoitteesta docs.silabs.com, yksityiskohtia varten.

Korjatut ongelmat

Tunnetut ongelmat nykyisessä julkaisussa
Lihavoidut ongelmat on lisätty edellisen julkaisun jälkeen. Jos olet unohtanut julkaisun, viimeisimmät julkaisutiedot ovat saatavilla kaurahttps://www.silabs.com/developers/simplicity-software-development-kit.

Käytöstä poistetut tuotteet
"Multiprotocol Container", joka on tällä hetkellä saatavilla DockerHubissa (siliconlabsinc/multiprotocol), poistetaan käytöstä tulevassa julkaisussa. Säilöä ei enää päivitetä, ja se voidaan vetää DockerHubista. Debian-pohjaiset cpcd-, ZigBee- ja ot-br-posix-paketit sekä natiivisti luodut ja käännetyt projektit korvaavat kontin poistamisen yhteydessä menetetyn toiminnallisuuden.

Tämän julkaisun käyttäminen

Tämä julkaisu sisältää seuraavat tiedot:

Zigbee-pino
Zigbee-sovelluskehys
Zigbee Sample Sovellukset

Lisätietoja Zigbeestä ja EmberZNet SDK:sta on kohdassa UG103.02: Zigbee Fundamentals. Jos käytät ensimmäistä kertaa, katso QSG180: Zigbee EmberZNet Quick-Start Guide for SDK 7.0 ja uudemmat ohjeet kehitysympäristön määrittämiseen, rakentamiseen ja flash-käyttöön.ampsovellus ja dokumentaatioviitteet, jotka osoittavat myöhempään vaiheeseen.

Asennus ja käyttö
Zigbee EmberZNet SDK toimitetaan osana Simplicity SDK:ta, Silicon Labs SDK -pakettia. Aloita Simplicity SDK:n käyttö nopeasti asentamalla Simplicity Studio 5, joka määrittää kehitysympäristösi ja opastaa Simplicity SDK:n asennuksen läpi. Simplicity Studio 5 sisältää kaiken tarvittavan IoT-tuotekehitykseen Silicon Labs -laitteilla, mukaan lukien resurssien ja projektien käynnistysohjelman, ohjelmiston konfigurointityökalut, täyden IDE:n GNU-työkaluketjulla ja analyysityökalut. Asennusohjeet ovat Simplicity Studio 5:n online-käyttöoppaassa. Vaihtoehtoisesti Simplicity SDK voidaan asentaa manuaalisesti lataamalla tai kloonaamalla uusin GitHubista. Katso https://github.com/SiliconLabs/simplicity_sdk saadaksesi lisätietoja. Simplicity Studio asentaa Simplicity SDK:n oletuksena seuraaviin kohteisiin:

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

(MacOS): /Käyttäjät//SimplicityStudio/SDKs/simplicity_sdk

SDK-versiota koskevat asiakirjat asennetaan SDK:n mukana. Lisätietoja löytyy usein tietokannan artikkeleista (KBA). API-viitteet ja muut tiedot tästä ja aiemmista julkaisuista ovat saatavilla osoitteessa https://docs.silabs.com/.

Turvallisuustiedot
Suojattu holvin integrointi
Sovelluksissa, jotka päättävät tallentaa avaimet turvallisesti käyttämällä Secure Vault-High -osien Secure Key Storage -komponenttia, seuraavassa taulukossa näkyvät suojatut avaimet ja niiden tallennussuojausominaisuudet, joita Zigbee Security Manager -komponentti hallitsee.Käärittyjä avaimia, jotka on merkitty "Ei-vietäväksi", voidaan käyttää, mutta ei vieweditoitu tai jaettu ajon aikana. Käärittyjä avaimia, jotka on merkitty vietäväksi, voidaan käyttää tai jakaa suorituksen aikana, mutta ne pysyvät salattuina Flashiin tallennettuina. Käyttäjäsovellusten ei koskaan tarvitse olla vuorovaikutuksessa useimpien näiden avainten kanssa. Olemassa olevat sovellusliittymät Link Key Table -avaimien tai ohimenevien avainten hallintaan ovat edelleen käyttäjäsovelluksen käytettävissä, ja ne reititetään Zigbee Security Manager -komponentin kautta.

Tietoturvatiedotteet
Tilaa tietoturvatiedotteet kirjautumalla sisään Silicon Labsin asiakasportaaliin ja valitsemalla Tilin etusivu. Siirry portaalin kotisivulle napsauttamalla ETUSIVUA ja napsauta sitten Hallitse ilmoituksia -ruutua. Varmista, että "Ohjelmisto-/tietoturvailmoitukset ja tuotemuutosilmoitukset (PCN)" on valittuna ja että olet tilannut vähintään alustasi ja protokollasi. Tallenna muutokset napsauttamalla Tallenna.

Tukea
Development Kit -asiakkaat voivat saada koulutusta ja teknistä tukea. Käytä Silicon Laboratories Zigbeeä web -sivulta saadaksesi tietoa kaikista Silicon Labs Zigbee -tuotteista ja -palveluista sekä rekisteröityäksesi tuotetukeen. Voit ottaa yhteyttä Silicon Laboratories -tukeen osoitteessa http://www.silabs.com/support.

Zigbee sertifikaatti
Ember ZNet 8.1 -julkaisu on hyväksytty Zigbee-yhteensopivalle alustalle SoC-, NC-, P- ja RCP-arkkitehtuureille. Tähän julkaisuun on sidottu ZCP-sertifiointitunnus, tarkista CSA websivusto täällä:
https://csa-iot.org/csa-iot_products/.

Huomaa, että ZCP-sertifiointi on filed julkaisee julkaisun, ja kestää muutaman viikon ennen kuin se otetaan huomioon CSA:ssa websivusto. Jos sinulla on kysyttävää, ota yhteyttä Silicon Laboratories -tukeen osoitteessa http://www.silabs.com/support.

UKK

K: Kuinka päivitän APS-linkkiavaintaulukon koon SDK:ssa?
V: APS-linkkiavaintaulukon koko voidaan määrittää käyttämällä parametria SL_ZIGBEE_KEY_TABLE_SIZE. Versiossa 8.1 sitä on laajennettu 127:stä 254:ään.

K: Mitä parannuksia versiossa 8.1 on?
V: Versio 8.1 tuo parannuksia, kuten APS-linkkiavaintaulukon koon laajentamisen, komponenttien uudelleennimeämisen, mutex-suojauksen lisäämisen Athe pp Framework -tapahtumajonoon ja paljon muuta. Katso julkaisutiedoista yksityiskohtainen luettelo parannuksista.

K: Miten käsittelen SDK:n korjattuja ongelmia?
V: Korjatut ongelmat SDK:ssa, mukaan lukien mahdollisten naapuritaulukon koon määrityksiä koskevien ongelmien ratkaiseminen, komponenttien uudelleennimeäminen, lähdereitin yleiskulujen korjaaminen, ZCL-komentojen käsittely ja paljon muuta. Varmista, että päivität uusimpaan versioon hyötyäksesi näistä korjauksista.

Asiakirjat / Resurssit

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

Viitteet

Käyttöopas

SILICON LABS Zigbee EmberZ Net SDK

Tekniset tiedot

Tuotetiedot