SILICON LABS Zigbee EmberZ Net SDK utasítások

A Silicon Labs a Zigbee hálózatot termékeikbe fejlesztő OEM gyártók által választott szállító. A Silicon Labs Zigbee platform a leginkább integrált, legteljesebb és funkciókban gazdag Zigbee megoldás. A Silicon Labs EmberZNet SDK tartalmazza a Silicon Labs Zigbee veremspecifikációjának megvalósítását.

FŐBB JELLEMZŐK

Zigbee

-250+ bejegyzés az APS hivatkozási kulcstáblázatában
ZigbeeD támogatás Android 12 (v21.0.6113669) és Tizen (v0.1-13.1) rendszeren

xG26 Modul támogatás

Multiprotokoll

ZigbeeD és OTBR támogatás az OpenWRT – GA-n
DMP BLE + CMP ZB & Matter/OT párhuzamos hallgatással MG26-on SoC – GA-hoz

802.15.4 Egységes rádióütemező prioritású összetevő
Debian csomagolás támogatása MP gazdagép alkalmazásokhoz – Alpha

Új elemek

Fontos változások
Az APS hivatkozáskulcs táblázat mérete (az SL_ZIGBEE_KEY_TABLE_SIZE használatával konfigurálva) 127-ről 254 bejegyzésre bővült.

R23 támogatást adunk a ZDD Network üzembe helyezési funkcióhoz. Az alagútkezelési funkciók a Legacy Network használati eseteinek támogatása nélkül is elérhetők.

A Network Steering és Network Creator összetevőket frissítettük, hogy az R23 csatlakozás támogatása is szerepeljen. Ezek a következő kapcsolódó változásokat tartalmazzák.
- Az alapértelmezett Trust Center Link Key (TCLK) kérési házirendet frissítettük, hogy minden egyes kérelmező eszköz számára új kulcsokat generáljon. A rendszer minden alkalommal új kulcsot generál, amikor a kérelmező eszközök megpróbálják frissíteni a Trust Center hivatkozási kulcsukat.
- A korábbi TCLK-házirend-módosítás miatt a Network Creator Security összetevőhöz mostantól szükség van a Security Link Keys összetevőre. Az alkalmazások frissítése frissítve lesz, hogy megfeleljen ennek az új követelménynek.
- Új konfiguráció,
  A SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY hozzá lett adva, hogy lehetővé tegye a csatlakozást egy alapkulcs használatával. Ez a konfiguráció a Network Creator Security összetevő alatt található. Ennek a házirendnek a használata lehetővé teszi, hogy minden egyes csatlakozó eszköz egyedi TCLK-t kapjon a csatlakozás után, de a TCLK ismételt frissítése nem eredményez új kulcsot a kérelmező eszközhöz. A kivonatolt hivatkozási kulcsok használata volt az alapértelmezett házirend a jelen kiadás előtt, és ennek a házirendnek a használata lehetővé teszi, hogy a Bizalmi központ elkerülje a kulcsokat Flash-be mentő Biztonsági hivatkozási kulcsok összetevő bejuttatását.
  Jegyzet: A Silicon Labs nem javasolja ennek a házirendnek a használatát, mivel ez megakadályozza, hogy a csatlakozó eszközök gördüljenek, vagy frissítsék TCLK-jaikat.

A zigbee_ezsp_spi komponenshez egy új konfigurációs készlet került hozzáadásra, amely lehetővé teszi a gazdagép SPI-eszköz és pin-interfészeinek konfigurálását.
Az example projekteket, beleértve a projektet is files (.slcps) és projektmappa átnevezzük a Silicon Labs elnevezési irányelvekre, és átkerül a „projektek” könyvtárba.

Új platform támogatás

Új modulok
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Új rádió táblák
- MGM260P-RB4350A
- MGM260P-RB4351A
Új rész
- efr32xg27
Explorer Kit
- BRD2709A
- MGM260P-EK2713A

Új dokumentáció
Egy új EZSP felhasználói útmutatója az UG600 8.1-es és újabb verzióihoz.

Fejlesztések

Az SL_ZIGBEE_KEY_TABLE_SIZE korlát 254 bejegyzésre bővült.
A zigbee_security_link_keys hozzáadva a Z3Lighthoz.
A zigbee_security_link_keys hozzáadva a zigbee_mp_z3_tc_z3_tc fájlhoz. A kulcstáblázat méretét is frissítette.
A Z3 Gateway kulcstáblázat méretét (amely ncp-re lesz állítva) 20-ra növelte.

Javított problémák

Ismert problémák a jelenlegi kiadásban

A félkövérrel szedett problémák az előző kiadás óta szerepelnek. Ha lemaradt egy kiadásról, a legutóbbi kiadási megjegyzések itt érhetők el https://www.silabs.com/developers/zigbee-emberznet a Tech Docs lapon.

Elavult elemek

A zigbee_watchdog_periodic_refresh összetevő már nem használatos a Zigbee alkalmazáskeretrendszerében, és ebben a kiadásban elavult. A watchdog időzítő alapértelmezés szerint az összes s esetében le van tiltvaample alkalmazások. A jövőben egy továbbfejlesztett watchdog komponens kerül majd az SDK-ba.
Jegyzet: Engedélyezze a watchdog időzítőt úgy, hogy a SL_LEGACY_HAL_DISABLE_WATCHDOG konfigurációs elem 0-ra van állítva az alkalmazásban

Hálózati korlátozások és szempontok

Az ehhez az EmberZNet-kiadáshoz mellékelt alapértelmezett Trust Center-alkalmazások több eszközt is támogathatnak a hálózaton. Ezt a számot számos tényező határozza meg, beleértve a konfigurált táblaméreteket, az NVM-használatot, valamint az egyéb generálási idő és futási értékek alapján. A nagy hálózatokat létrehozni kívánó felhasználók erőforrás-problémákkal szembesülhetnek, amikor a hálózatot az alkalmazás által támogatottnál nagyobbra bővítik. Plample, a Trust Center Link kulcsot kérő eszköz az sl_zigbee_af_zigbee_key_establishment_cb visszahívást indíthat el a Bizalmi központban, a h állapot SL_ZIGBEE_KEY_TABLE_FULL értékre van állítva, jelezve, hogy a kulcstáblázatnak nincs helye új eszköz vagy új kulcs hozzáadásához a kérelmezőhöz. Az NVM3-ban nincs szabad hely. A Silicon Labs a következő ajánlásokat nyújtja azoknak a felhasználóknak, akik nagy hálózatokat szeretnének létrehozni. A Trust Center alkalmazásokhoz a következő konfigurációk javasoltak. Ezek az ajánlások nem teljes körűek, és kiindulási alapként szolgálnak a nagy hálózatokat bővíteni szándékozó alkalmazások számára.

Az Address Table komponens (zigbee_address_table) felvétele a
- az SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE konfigurációs elem a kívánt hálózat méretére állítva
- az SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE érték a maximumra van állítva (4)

A Biztonsági hivatkozási kulcsok összetevő (zigbee_security_link_keys) felvétele a következővel
- Az SL_ZIGBEE_KEY_TABLE_SIZE érték a hálózat méretére van állítva
A következő konfigurációs elemek a kívánt hálózat méretére vannak beállítva
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, a Zigbee Pro Stack komponensben található
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, amint az a Source routing komponensben található, ha forrásútválasztást használnak
Az NVM3_DEFAULT_NVM_SIZE és NVM3_DEFAULT_CACHE_SIZE beállítása az NVM3 használatának megfelelően
- Például a 65 csomópontnál nagyobb hálózatmérethez valószínűleg 3K NVM64-méretre van szükség. A Silicon Labs Zigbee s alapértelmezett NVM3 méreteampAz alkalmazások száma 32 ezer. Az NVM-et erősebben használó alkalmazások esetében előfordulhat, hogy ezt az értéket még magasabbra kell módosítani.
- A 65 csomópontig terjedő nagy hálózatoknak 3 bájtos NVM1200 gyorsítótárra lehet szükségük; az ennél nagyobb hálózatok növekedéséhez szükség lehet ennek az értéknek a megduplázására, 2400 bájtra.

Ezek a módosítások csak a Bizalmi Központra vonatkoznak

Multiprotocol Gateway és RCP

Új elemek
Engedélyezett GA SoC támogatás a BLE DMP-hez Zigbee + Openthread CMP-vel, párhuzamos hallgatással xG26 részeken. A Debian alfa támogatás hozzáadásra került a Zigbeed, OTBR és Z3Gateway alkalmazásokhoz. A Zigbeed és az OTBR DEB csomag formátumban is elérhető a választott referenciaplatformhoz (Raspberry PI 4). Lásd: Zigbee, OpenThread és Bluetooth egyidejű futtatása Linux gazdagépen többprotokollos társprocesszorral, a következő helyen: docs.silabs.com, részletekért. Hozzáadott Zigbeed támogatás a Tizen-0.1-13.1-hez az arm32-hez és az aarch64-hez, valamint az Android 12-höz az aarch64-hez. További információ a Zigbeedről a következő címen található: docs.silabs.com. Hozzáadtuk az új „802.15.4 Egységes rádióütemező prioritás” komponenst. Ez az összetevő egy 15.4-es verem rádiós prioritásainak konfigurálására szolgál. Az összetevőhöz az új „radio_priority_configurator” összetevő is szükséges. Ez az összetevő lehetővé teszi a projektek számára, hogy a Simplicity Studio Radio Priority Configurator eszközét használják az azt igénylő verem rádiós prioritási szintjeinek konfigurálására.

Fejlesztések
Alkalmazási megjegyzés A Zigbee, az OpenThread és a Bluetooth egyidejű futtatása többprotokollos társprocesszorral (AN1333) rendelkező Linux gazdagépen a következő helyre került: docs.silabs.com. Az OpenWRT támogatás mostantól GA-minőségű. OpenWRT támogatást adtunk a Zigbee, OTBR és Z3Gateway alkalmazásokhoz. A Zigbeed és az OTBR IPK csomagformátumban is elérhető a referenciaplatformhoz (Raspberry PI 4). Lásd: Zigbee, OpenThread és Bluetooth egyidejű futtatása Linux gazdagépen többprotokollos társprocesszorral, a következő helyen: docs.silabs.com, a részletekért.

Javított problémák

Ismert problémák a jelenlegi kiadásban
A félkövérrel szedett problémák az előző kiadás óta szerepelnek. Ha lemaradt egy kiadásról, a legújabb kiadási megjegyzések elérhetőkhttps://www.silabs.com/developers/simplicity-software-development-kit.

Elavult elemek
A DockerHubon jelenleg elérhető „Multiprotocol Container” (siliconlabsinc/multiprotocol) egy közelgő kiadásban megszűnik. A tároló a továbbiakban nem frissül, és lehívható a DockerHubról. A Debian-alapú cpcd, ZigBee és ot-br-posix csomagok, valamint a natívan generált és lefordított projektek pótolják a tároló eltávolításával elveszett funkciókat.

A kiadás használata

Ez a kiadás a következőket tartalmazza:

Zigbee verem
Zigbee alkalmazási keretrendszer
Zigbee Sample Alkalmazások

A Zigbee-vel és az EmberZNet SDK-val kapcsolatos további információkért lásd: UG103.02: Zigbee Fundamentals. Ha Ön először használ, olvassa el a QSG180: Zigbee EmberZNet gyorsindítási útmutatót az SDK 7.0-s és újabb verzióihoz, ahol a fejlesztői környezet konfigurálására, valamint a fejlesztői környezet konfigurálására, valamint a mintaként való frissítésre vonatkozó utasításokat talál.ampalkalmazást, és az ext lépésekre mutató dokumentációs hivatkozásokat.

Telepítés és használat
A Zigbee EmberZNet SDK a Simplicity SDK, a Silicon Labs SDK csomag részeként érhető el. A Simplicity SDK gyors használatának megkezdéséhez telepítse a Simplicity Studio 5-öt, amely beállítja a fejlesztői környezetet, és végigvezeti a Simplicity SDK telepítésén. A Simplicity Studio 5 mindent tartalmaz, ami az IoT termékfejlesztéshez szükséges a Silicon Labs eszközökkel, beleértve az erőforrás- és projektindítót, a szoftverkonfigurációs eszközöket, a teljes IDE-t GNU eszközlánccal és az elemző eszközöket. A telepítési utasításokat a Simplicity Studio 5 online felhasználói kézikönyve tartalmazza. Alternatív megoldásként a Simplicity SDK manuálisan is telepíthető a GitHub legújabb verziójának letöltésével vagy klónozásával. Lásd https://github.com/SiliconLabs/simplicity_sdk további információkért. A Simplicity Studio alapértelmezés szerint telepíti a Simplicity SDK-t:

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

(MacOS): /Felhasználók//SimplicityStudio/SDKs/simplicity_sdk

Az SDK-verzióhoz tartozó dokumentáció az SDK-val együtt telepítve van. További információk gyakran találhatók a tudásbázis cikkeiben (KBA-k). Az API hivatkozások és egyéb információk erről és a korábbi kiadásokról elérhetők https://docs.silabs.com/.

Biztonsági információk
Biztonságos Vault integráció
Azon alkalmazások esetében, amelyek a kulcsok biztonságos tárolását választják a Secure Vault-High részeken található Secure Key Storage összetevő használatával, a következő táblázat a Zigbee Security Manager összetevő által kezelt védett kulcsokat és tárolásvédelmi jellemzőit mutatja be.A „Nem exportálható” jelzéssel ellátott becsomagolt kulcsok használhatók, de nem viewszerkesztve vagy futásidőben megosztva. Az „Exportálható”-ként megjelölt becsomagolt kulcsok használhatók vagy megoszthatók futás közben, de titkosítva maradnak a Flash-ben tárolva. A felhasználói alkalmazásoknak soha nem kell kölcsönhatásba lépniük a kulcsok többségével. A Link Key Table kulcsok vagy átmeneti kulcsok kezelésére szolgáló meglévő API-k továbbra is elérhetők a felhasználói alkalmazás számára, és csak a Zigbee Security Manager összetevőn keresztül továbbíthatók.

Biztonsági tanácsok
A biztonsági tanácsokra való feliratkozáshoz jelentkezzen be a Silicon Labs ügyfélportáljára, majd válassza a Fiók főoldala lehetőséget. Kattintson a KEZDŐLAP gombra a portál kezdőlapjának megnyitásához, majd kattintson az Értesítések kezelése csempére. Győződjön meg arról, hogy a „Szoftver/biztonsági figyelmeztetések és termékváltoztatási értesítések (PCN-ek)” be van jelölve, és legalább előfizetett a platformjára és a protokolljára. A módosítások mentéséhez kattintson a Mentés gombra.

Támogatás
A Development Kit ügyfelei képzésre és technikai támogatásra jogosultak. Használja a Silicon Laboratories Zigbee-t web oldalon tájékozódhat az összes Silicon Labs Zigbee termékről és szolgáltatásról, és feliratkozhat a terméktámogatásra. Felveheti a kapcsolatot a Silicon Laboratories ügyfélszolgálatával a következő címen http://www.silabs.com/support.

Zigbee minősítés
Az Ember ZNet 8.1 kiadás minősítést kapott a Zigbee-kompatibilis platformhoz SoC, NC, P és RCP architektúrákhoz, ehhez a kiadáshoz ZCP tanúsítási azonosító kapcsolódik. Kérjük, ellenőrizze a CSA-t weboldal itt:
https://csa-iot.org/csa-iot_products/.

Felhívjuk figyelmét, hogy a ZCP tanúsítvány az filed közzéteszi a kiadást, és néhány hétbe telhet, mire megjelenik a CSA webtelek. További kérdéseivel forduljon a Silicon Laboratories ügyfélszolgálatához a következő telefonszámon http://www.silabs.com/support.

GYIK

K: Hogyan frissíthetem az APS linkkulcs táblázat méretét az SDK-ban?
V: Az APS linkkulcs táblázat mérete az SL_ZIGBEE_KEY_TABLE_SIZE paraméterrel konfigurálható. A 8.1-es verzióban 127-ről 254-re bővült.

K: Milyen fejlesztések vannak a 8.1-es verzióban?
V: A 8.1-es verzió olyan fejlesztéseket tartalmaz, mint például az APS linkkulcs-tábla méretének bővítése, az összetevők átnevezése, az Athe pp-keretrendszer eseménysorának mutex védelme és még sok más. A fejlesztések részletes listáját a kiadási megjegyzésekben találja.

K: Hogyan kezelhetem az SDK javított problémáit?
V: Kijavítottuk az SDK problémáit, beleértve a szomszédos táblaméret konfigurációjával kapcsolatos lehetséges problémák megoldását, az összetevők átnevezését, a forrásútvonal többletterhelésének javítását, a ZCL-parancsok kezelését stb. A javítások előnyeinek kihasználása érdekében frissítsen a legújabb verzióra.

Dokumentumok / Források

SILICON LABS Zigbee EmberZ Net SDK [pdfUtasítások
Zigbee EmberZ Net SDK, EmberZ Net SDK, Net SDK, SDK

Hivatkozások

Felhasználói kézikönyv

SILICON LABS Zigbee EmberZ Net SDK

Műszaki adatok

Termékinformáció