SILICON LABS Zigbee EmberZ Net SDK Ynstruksjes

Silicon Labs is de ferkeaper fan kar foar OEM's dy't Zigbee-netwurk ûntwikkelje yn har produkten. It Silicon Labs Zigbee-platfoarm is de meast yntegreare, folsleine en funksje-rike Zigbee-oplossing beskikber. De Silicon Labs EmberZNet SDK befettet de ymplemintaasje fan Silicon Labs fan 'e Zigbee stack-spesifikaasje.

KEY FEATURES

Zigbee

-250+ yngongen yn 'e APS-keppelingskaaitabel
ZigbeeD-stipe op Android 12 (v21.0.6113669) en Tizen (v0.1-13.1)

xG26 Module stipe

Multiprotokol

ZigbeeD en OTBR-stipe op OpenWRT - GA
DMP BLE + CMP ZB & Matter / OT mei tagelyk harkjen op MG26 foar SoC - GA

802.15.4 Unified radio scheduler prioriteit komponint
Debian-ferpakkingstipe foar MP-hostapplikaasjes - Alpha

Nije items

Wichtige Feroarings
De grutte fan 'e APS-keppelingsnokkeltabel (konfigureare mei SL_ZIGBEE_KEY_TABLE_SIZE) wurdt útwreide fan 127 nei 254 yngongen.

R23-stipe wurdt tafoege foar ZDD-netwurk-opdrachtfunksjonaliteit. Tunneling funksjonaliteit is beskikber sûnder stipe foar Legacy Network gebrûk gefallen.

De komponinten Network Steering en Network Creator binne bywurke om stipe op te nimmen foar R23-meidwaan. Dizze omfetsje de folgjende relatearre feroaringen.
- It standert fersykbelied fan Trust Center Link Key (TCLK) is bywurke om nije kaaien te generearjen foar elk oanfreegjende apparaat. In nije kaai wurdt oanmakke elke kear as de oanfreegjende apparaten besykje harren Trust Center Link Key te aktualisearjen.
- Fanwegen de foarige TCLK-beliedswiziging fereasket de Network Creator Security-komponint no de komponint Security Link Keys. It opwurdearjen fan applikaasjes sil wurde bywurke om te foldwaan oan dizze nije eask.
- In nije konfiguraasje,
  SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY wurdt tafoege om mei te dwaan mei in kearn, hashed kaai. Dizze konfiguraasje is te finen ûnder it komponint Network Creator Security. Gebrûk fan dit belied lit elk oanslutend apparaat in unike TCLK post-join ûntfange, mar werhelle besykjen om de TCLK te aktualisearjen sille net resultearje yn in nije kaai foar it oanfreegjende apparaat. Dit gebrûk fan hashed-keppelingskaaien wie it standertbelied foar dizze frijlitting, en it brûken fan dit belied lit it Trust Center foarkomme om de komponint Security Link Keys yn te bringen, dy't kaaien opslaat yn Flash.
  Noat: Silicon Labs advisearret it gebrûk fan dit belied net, om't dit foarkomt dat oanslutende apparaten har TCLK's rôlje of bywurkje.

In nije konfiguraasje set wurdt tafoege oan de komponint zigbee_ezsp_spi te tastean de konfiguraasje fan de host SPI apparaat en syn pin ynterfaces.
De eksample projekten, ynklusyf it projekt files (.slcps) en projekt map, wurde omneamd ta Silicon Labs nammejouwing rjochtlinen en ferpleatst ûnder de "projekten" triemtafel.

Nije platfoarmstipe

Nije modules
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Nije radio boards
- MGM260P-RB4350A
- MGM260P-RB4351A
Nij diel
- efr32xg27
Explorer Kit
- BRD2709A
- MGM260P-EK2713A

Nije dokumintaasje
In nije EZSP-brûkersgids UG600 foar releases 8.1 en heger.

Ferbetterings

SL_ZIGBEE_KEY_TABLE_SIZE grinzen útwreide oant 254 yngongen.
Added zigbee_security_link_keys oan Z3Light.
zigbee_security_link_keys tafoege oan zigbee_mp_z3_tc_z3_tc. De grutte fan 'e kaaitafel hat ek bywurke.
Fergrutte de grutte fan 'e Z3 Gateway-kaaitafel (dat sil wurde ynsteld op ncp) nei 20.

Fêste problemen

Bekende problemen yn 'e hjoeddeistige release

Kwestjes yn fet binne tafoege sûnt de foarige release. As jo hawwe mist in release, resinte release notysjes binne beskikber op https://www.silabs.com/developers/zigbee-emberznet yn it ljepblêd Tech Docs.

Ferâldere items

De komponint zigbee_watchdog_periodic_refresh wurdt net mear brûkt yn it Zigbee-applikaasjekader en wurdt yn dizze útjefte ôfkard. De watchdog timer is standert útskeakele foar alle sample applikaasjes. D'r sil yn 'e takomst in ferbettere watchdog-komponint wurde tafoege oan' e SDK.
Noat: Aktivearje de watchdog-timer mei konfiguraasjeitem SL_LEGACY_HAL_DISABLE_WATCHDOG ynsteld op 0 yn jo applikaasje

Netwurk beheinings en ôfwagings

De standert Trust Center-applikaasjes dy't wurde ferstjoerd mei dizze EmberZNet-release binne yn steat om ferskate apparaten op it netwurk te stypjen. Dit oantal wurdt bepaald op basis fan ferskate faktoaren, ynklusyf ynstelde tabelgrutte, NVM-gebrûk, en oare generaasjetiid en run-timewearden. Brûkers dy't sykje om grutte netwurken te meitsjen kinne problemen mei boarnen krije by it groeien fan it netwurk grutter dan de applikaasje kin stypje. Bygelyksample, in apparaat dat in Trust Center Link Key freget fan it Trust Center kin in sl_zigbee_af_zigbee_key_establishment_cb werombelje op it Trust Center mei h status ynsteld op SL_ZIGBEE_KEY_TABLE_FULL, wat oanjout dat de kaaitabel gjin romte hat om in nije kaai ta te foegjen foar it oanfreegjende apparaat of dat NVM3 hat gjin beskikbere romte. Silicon Labs jout de folgjende oanbefellings foar brûkers dy't sykje om grutte netwurken te meitsjen. Foar Trust Center-applikaasjes wurde de folgjende konfiguraasjes oanrikkemandearre. Dizze oanbefellings binne net útputtend, en se tsjinje as basisline foar applikaasjes dy't fan doel binne grutte netwurken te groeien.

Opnimming fan de adres tabel komponint (zigbee_address_table), mei
- it SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE konfiguraasje item ynsteld op de grutte fan it winske netwurk
- de SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE wearde ynsteld op it maksimum (4)

Opnimming fan de Feiligens Link Keys komponint (zigbee_security_link_keys), mei
- De SL_ZIGBEE_KEY_TABLE_SIZE wearde is ynsteld op de grutte fan it netwurk
De folgjende konfiguraasje-items binne ynsteld op de grutte fan it winske netwurk
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, lykas fûn yn 'e Zigbee Pro Stack-komponint
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, lykas fûn yn 'e boarne routing komponint, as boarne routing wurdt brûkt
Oanpassing fan NVM3_DEFAULT_NVM_SIZE en NVM3_DEFAULT_CACHE_SIZE neffens NVM3-gebrûk
- Bygelyks netwurkgrutte grutter dan 65 knooppunten fereaskje wierskynlik in NVM3-grutte fan 64K. De standert NVM3 grutte yn Silicon Labs Zigbee sample applikaasjes is 32K. Applikaasjes dy't NVM mear brûke, kinne fereaskje dat dizze wearde noch heger oanpast wurde.
- Grutte netwurken oant 65 knopen kinne in NVM3-cache-grutte fan 1200 bytes nedich wêze; groeiende netwurken grutter dan dat kin fereaskje ferdûbeling fan dizze wearde nei 2400 bytes.

Dizze oanpassingen jilde allinich foar it Trust Center

Multiprotocol Gateway en RCP

Nije items
Ynskeakele GA SoC-stipe foar BLE DMP mei Zigbee + Openthread CMP mei tagelyk harkjen op xG26-dielen. Debian alpha-stipe is tafoege foar Zigbeed-, OTBR- en Z3Gateway-applikaasjes. Zigbeed en OTBR wurde ek levere yn DEB-pakketformaat foar it keazen referinsjeplatfoarm (Raspberry PI 4). Sjoch Zigbee, OpenThread en Bluetooth tagelyk útfiere op in Linux-host mei in Multiprotocol Co-Processor, fûn op docs.silabs.com, foar details. Zigbeed-stipe tafoege foar Tizen-0.1-13.1 foar arm32 en aarch64, lykas Android 12 foar aarch64. Mear ynformaasje oer Zigbeed is te finen op docs.silabs.com. De nije komponint "802.15.4 Unified radio scheduler priority" tafoege. Dizze komponint wurdt brûkt om de radioprioriteiten fan in 15.4-stapel te konfigurearjen. De komponint fereasket ek de nije komponint "radio_priority_configurator". Dizze komponint lit projekten it Radio Priority Configurator-ark yn Simplicity Studio brûke om de radioprioriteitsnivo's fan 'e stapels te konfigurearjen dy't it nedich binne.

Ferbetterings
Applikaasjenotysje Zigbee, OpenThread en Bluetooth tagelyk útfiere op in Linux-host mei in Multiprotocol Co-Processor (AN1333) is ferpleatst nei docs.silabs.com. OpenWRT-stipe is no GA-kwaliteit. OpenWRT-stipe is tafoege foar Zigbee-, OTBR- en Z3Gateway-applikaasjes. Zigbeed en OTBR wurde ek levere yn IPK-pakketformaat foar it referinsjeplatfoarm (Raspberry PI 4). Sjoch Zigbee, OpenThread en Bluetooth tagelyk útfiere op in Linux-host mei in Multiprotocol Co-Processor, fûn op docs.silabs.com, foar details.

Fêste problemen

Bekende problemen yn 'e hjoeddeistige release
Kwestjes yn fet binne tafoege sûnt de foarige release. As jo hawwe mist in release, resinte release notysjes binne beskikber oathttps://www.silabs.com/developers/simplicity-software-development-kit.

Ferâldere items
De "Multiprotocol Container" dy't op it stuit beskikber is op DockerHub (siliconlabsinc / multiprotocol) sil wurde ôfret yn in kommende release. De kontener sil net mear bywurke wurde en kin wurde lutsen fan DockerHub. De Debian-basearre pakketten foar cpcd, ZigBee en ot-br-posix, tegearre mei natuerlik oanmakke en kompilearre projekten, sille de funksjonaliteit ferfange dy't ferlern gien is mei it fuortheljen fan 'e kontener.

Mei help fan dizze release

Dizze útjefte befettet it folgjende:

Zigbee stack
Zigbee Application Framework
Zigbee Sample Applikaasjes

Foar mear ynformaasje oer Zigbee en de EmberZNet SDK sjoch UG103.02: Zigbee Fundamentals. As jo in earste kear brûker binne, sjoch QSG180: Zigbee EmberZNet Quick-Start Guide foar SDK 7.0 en heger, foar ynstruksjes oer it konfigurearjen fan jo ûntwikkelingsomjouwing, bouwen en bliksem asample applikaasje, en dokumintaasje ferwizings dy't wize op de ext stappen.

Ynstallaasje en gebrûk
De Zigbee EmberZNet SDK wurdt levere as ûnderdiel fan 'e Simplicity SDK, de suite fan Silicon Labs SDK's. Om fluch te begjinnen mei de Simplicity SDK, ynstallearje Simplicity Studio 5, dy't jo ûntwikkelingsomjouwing sil ynstelle en jo troch Simplicity SDK-ynstallaasje sil liede. Simplicity Studio 5 omfettet alles dat nedich is foar IoT-produktûntwikkeling mei Silicon Labs-apparaten, ynklusyf in boarne- en projektstarter, softwarekonfiguraasje-ark, folsleine IDE mei GNU-arkketen, en analyse-ark. Ynstallaasje-ynstruksjes wurde levere yn 'e online Simplicity Studio 5 User's Guide. As alternatyf kin Simplicity SDK mei de hân ynstalleare wurde troch it lêste te downloaden of te klonen fan GitHub. Sjen https://github.com/SiliconLabs/simplicity_sdk foar mear ynformaasje. Simplicity Studio ynstallearret de Simplicity SDK standert yn:

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

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

Dokumintaasje spesifyk foar de SDK ferzje wurdt ynstallearre mei de SDK. Oanfoljende ynformaasje is faaks te finen yn 'e kennisbasisartikelen (KBA's). API-ferwizings en oare ynformaasje oer dizze en eardere releases binne beskikber https://docs.silabs.com/.

Feiligens ynformaasje
Feilige Vault Yntegraasje
Foar applikaasjes dy't der foar kieze om kaaien feilich op te slaan mei de komponint Secure Key Storage op Secure Vault-High-dielen, toant de folgjende tabel de beskerme kaaien en har skaaimerken foar opslachbeskerming dy't de komponint Zigbee Security Manager beheart.Ynpakt kaaien dy't markearre binne as "Net-eksportabel" kinne brûkt wurde, mar kinne net wêze viewed of dield by runtime. Ynpakt kaaien dy't markearre binne as "Eksportabel" kinne brûkt wurde of dield by runtime, mar bliuwe fersifere wylst opslein yn Flash. Brûkersapplikaasjes hoege noait te ynteraksje mei de mearderheid fan dizze kaaien. Besteande API's foar it behearen fan Link Key Table-kaaien as Transient Keys binne noch beskikber foar de brûkersapplikaasje en wurde nare troch de Zigbee Security Manager-komponint stjoerd.

Feiligens Advys
Om yn te abonnearjen op Security Advisories, meld jo oan by it Silicon Labs klantportaal, selektearje dan Account Thús. Klikje HOME om nei de thússide fan it portaal te gean en klik dan op de tegel Notifikaasjes beheare. Soargje derfoar dat 'Software/Security Advisory Notices & Product Change Notices (PCN's)' is kontrolearre, en dat jo op syn minst ynskreaun binne foar jo platfoarm en protokol. Klik op Bewarje om alle wizigingen op te slaan.

Stypje
Development Kit-klanten komme yn oanmerking foar training en technyske stipe. Brûk de Silicon Laboratories Zigbee web side om ynformaasje te krijen oer alle Silicon Labs Zigbee produkten en tsjinsten, en om oan te melden foar produktstipe. Jo kinne kontakt opnimme mei Silicon Laboratories-stipe by http://www.silabs.com/support.

Zigbee sertifisearring
De Ember ZNet 8.1-release is kwalifisearre foar Zigbee Compliant Platform foar SoC, NC, P, en RCP-arsjitektuer, d'r is in ZCP-sertifikaasje-ID ferbûn oan dizze release, kontrolearje asjebleaft de CSA website hjir:
https://csa-iot.org/csa-iot_products/.

Tink derom dat de ZCP-sertifikaasje is filed post de frijlitting, en duorret in pear wiken foardat it reflektearre wurdt oer de CSA website. Foar fierdere fragen, nim dan kontakt op mei Silicon Laboratories-stipe op http://www.silabs.com/support.

FAQs

F: Hoe bywurkje ik de grutte fan 'e APS-keppelingskaaitabel yn' e SDK?
A: De grutte fan 'e APS-keppelingskaaitabel kin konfigureare wurde mei de parameter SL_ZIGBEE_KEY_TABLE_SIZE. Yn ferzje 8.1 is it útwreide fan 127 nei 254 yngongen.

F: Wat binne de ferbetteringen yn ferzje 8.1?
A: Ferzje 8.1 bringt ferbetterings lykas it útwreidzjen fan de grutte fan 'e APS-keppelingskaaitafel, omneaming fan komponinten, tafoegjen fan mutex-beskerming foar Athe pp Framework-evenemintwachtrige, en mear. Ferwize nei de release notysjes foar in detaillearre list fan ferbetterings.

F: Hoe behannelje ik fêste problemen yn 'e SDK?
A: Fêste problemen yn 'e SDK ynklusyf it oplossen fan potinsjele problemen mei konfiguraasje fan buortafelgrutte, omneaming fan komponinten, reparearje boarnerûte-overhead, behannelje ZCL-kommando's, en mear. Soargje derfoar dat jo bywurkje nei de lêste ferzje om te profitearjen fan dizze reparaasjes.

Dokuminten / Resources

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

Referinsjes

User Manual

SILICON LABS Zigbee EmberZ Net SDK

Spesifikaasjes

Produkt ynformaasje