SILICON LABS Zigbee EmberZ Net SDK Istruzzjonijiet

Silicon Labs huwa l-bejjiegħ tal-għażla għall-OEMs li qed jiżviluppaw in-netwerking Zigbee fil-prodotti tagħhom. Il-pjattaforma Zigbee ta 'Silicon Labs hija l-aktar soluzzjoni Zigbee integrata, kompluta u b'ħafna karatteristiċi disponibbli. L-SDK ta' Silicon Labs EmberZNet fih l-implimentazzjoni ta' Silicon Labs tal-ispeċifikazzjoni tal-munzell Zigbee.

KARATTERISTIĊI EWLENIN

Zigbee

-250+ daħliet fit-tabella taċ-ċavetta tal-link tal-APS
Appoġġ ZigbeeD fuq Android 12 (v21.0.6113669) u Tizen (v0.1-13.1)

Appoġġ tal-modulu xG26

Multiprotokoll

Appoġġ għal ZigbeeD u OTBR fuq OpenWRT - GA
DMP BLE + CMP ZB & Matter/OT b'Smigħ Konkorrenti fuq MG26 għal SoC - GA

802.15.4 Komponent prijoritarju tal-iskedar tar-radju unifikat
Appoġġ għall-ippakkjar Debian għal applikazzjonijiet ospitanti MP - Alpha

Oġġetti ġodda

Bidliet Importanti
Id-daqs tat-tabella taċ-ċavetta tal-link APS (ikkonfigurat bl-użu SL_ZIGBEE_KEY_TABLE_SIZE) huwa estiż minn 127 għal 254 entrati.

L-appoġġ R23 huwa miżjud għall-funzjonalità tal-kummissjonar tan-Netwerk ZDD. Il-funzjonalità tal-tunneling hija disponibbli mingħajr appoġġ għal każijiet ta' użu ta' Legacy Network.

Il-komponenti tat-Tmexxija tan-Netwerk u tal-Ħallieq tan-Netwerk ġew aġġornati biex jinkludu appoġġ għat-tgħaqqid tal-R23. Dawn jinkludu l-bidliet relatati li ġejjin.
- Il-politika ta’ rikjesta default Trust Center Link Key (TCLK) ġiet aġġornata biex tiġġenera ċwievet ġodda għal kull apparat li jagħmel it-talba. Ċavetta ġdida tiġi ġġenerata kull darba li l-apparati li jagħmlu t-talba jippruvaw jaġġornaw iċ-Ċavetta tal-Link taċ-Ċentru ta' Fiduċja tagħhom.
- Minħabba l-bidla preċedenti fil-politika TCLK, il-komponent tas-Sigurtà tal-Ħallieq tan-Netwerk issa jeħtieġ il-komponent tas-Sigurtà Link Keys. L-aġġornament tal-applikazzjonijiet se jiġi aġġornat biex jikkonforma ma' dan ir-rekwiżit il-ġdid.
- Konfigurazzjoni ġdida,
  SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY huwa miżjud biex jippermetti t-tgħaqqid bl-użu ta' ċavetta hashed tal-qalba. Din il-konfigurazzjoni tinsab taħt il-komponent tas-Sigurtà tal-Ħallieq tan-Netwerk. L-użu ta' din il-politika jippermetti li kull apparat li jingħaqad jirċievi TCLK uniku wara li jingħaqad, iżda tentattivi ripetuti biex taġġorna t-TCLK ma jirriżultawx f'ċavetta ġdida għall-apparat li jagħmel it-talba. Dan l-użu ta' ċwievet tal-link hashed kien il-politika default qabel dan ir-rilaxx, u l-użu ta' din il-politika jippermetti liċ-Ċentru ta' Fiduċja biex jevita li jdaħħal il-komponent Ċwievet Link tas-Sigurtà, li jiffranka ċ-ċwievet fi Flash.
  Nota: Silicon Labs ma jirrakkomandax l-użu ta' din il-politika, peress li dan jipprevjeni l-apparati li jgħaqqdu milli jirrumblaw, jew jaġġornaw, it-TCLKs tagħhom.

Sett ta 'konfigurazzjoni ġdid huwa miżjud mal-komponent zigbee_ezsp_spi biex jippermetti l-konfigurazzjoni tal-apparat SPI ospitanti u l-interfaces tal-pin tiegħu.
L-example proġetti, inkluż il-proġett files (.slcps) u l-folder tal-proġett, jingħataw isem ġdid għal Silicon Labs linji gwida tal-ismijiet u mċaqalqa taħt id-direttorju "proġetti".

Appoġġ għall-Pjattaforma Ġdida

Moduli ġodda
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Bords tar-radju ġodda
- MGM260P-RB4350A
- MGM260P-RB4351A
Parti ġdida
- efr32xg27
Explorer Kit
- BRD2709A
- MGM260P-EK2713A

Dokumentazzjoni Ġdida
Utent ġdid EZSP jiggwida UG600 għal rilaxxi 8.1 u ogħla.

Titjib

SL_ZIGBEE_KEY_TABLE_SIZE limiti estiżi sa 254 daħla.
Żieda zigbee_security_link_keys ma' Z3Light.
Żieda zigbee_security_link_keys ma' zigbee_mp_z3_tc_z3_tc. Aġġorna wkoll id-daqs tal-mejda ewlenija tagħha.
Żied id-daqs tat-tabella taċ-ċavetta Z3 Gateway (li se jkun issettjat għal ncp) għal 20.

Kwistjonijiet Fissi

Kwistjonijiet Magħrufa fir-Rilaxx Kurrenti

Kwistjonijiet b'tipa grassa ġew miżjuda mir-rilaxx preċedenti. Jekk tlift xi rilaxx, in-noti ta' rilaxx riċenti huma disponibbli fuq https://www.silabs.com/developers/zigbee-emberznet fit-tab Tech Docs.

Oġġetti deprecati

Il-komponent zigbee_watchdog_periodic_refresh m'għadux jintuża fil-qafas tal-applikazzjoni Zigbee u huwa deprecated f'dan ir-rilaxx. Il-watchdog timer huwa diżattivat awtomatikament għas-s kollhaample applikazzjonijiet. Fil-ġejjieni se jkun hemm komponent ta 'watchdog imtejjeb miżjud mal-SDK.
Nota: Ippermetti l-arloġġ tal-għassa bl-oġġett tal-konfigurazzjoni SL_LEGACY_HAL_DISABLE_WATCHDOG issettjat għal 0 fl-applikazzjoni tiegħek

Limitazzjonijiet u Konsiderazzjonijiet tan-Netwerk

L-applikazzjonijiet default taċ-Ċentru ta’ Fiduċja li jiġu mibgħuta ma’ dan ir-rilaxx ta’ EmberZNet huma kapaċi jappoġġaw diversi apparati fin-netwerk. Dan in-numru huwa ddeterminat abbażi ta' diversi fatturi, inklużi d-daqsijiet tal-mejda kkonfigurati, l-użu tal-NVM, u valuri oħra tal-ħin tal-ġenerazzjoni u tal-run-time. Utenti li qed ifittxu li joħolqu netwerks kbar jistgħu jiffaċċjaw kwistjonijiet ta 'riżorsi meta jikbru n-netwerk akbar milli l-applikazzjoni tista' tappoġġja. Per example, apparat li jitlob Ċavetta ta' Link taċ-Ċentru ta' Fiduċja miċ-Ċentru ta' Fiduċja jista' jwassal għal callback sl_zigbee_af_zigbee_key_establishment_cb fuq iċ-Ċentru ta' Fiduċja bi status h issettjat għal SL_ZIGBEE_KEY_TABLE_FULL, li jindika li t-tabella taċ-ċavetta m'għandhiex spazju biex iżżid ċavetta ġdida għall-apparat li jagħmel it-talba jew li NVM3 m'għandux spazju disponibbli. Silicon Labs jipprovdi r-rakkomandazzjonijiet li ġejjin għall-utenti li qed ifittxu li joħolqu netwerks kbar. Għall-applikazzjonijiet Trust Center, il-konfigurazzjonijiet li ġejjin huma rakkomandati. Dawn ir-rakkomandazzjonijiet mhumiex eżawrjenti, u jservu bħala linja bażi għal applikazzjonijiet li għandhom l-intenzjoni li jkabbru netwerks kbar.

Inklużjoni tal-komponent Tabella tal-Indirizzi (zigbee_address_table), bil
- l-oġġett tal-konfigurazzjoni SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE stabbilit għad-daqs tan-netwerk mixtieq
- il-valur SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE stabbilit għall-massimu (4)

Inklużjoni tal-komponent Ċwievet Link tas-Sigurtà (zigbee_security_link_keys), bil
- Il-valur SL_ZIGBEE_KEY_TABLE_SIZE huwa ssettjat għad-daqs tan-netwerk
L-oġġetti tal-konfigurazzjoni li ġejjin huma ssettjati għad-daqs tan-netwerk mixtieq
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, kif misjub fil-komponent Zigbee Pro Stack
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, kif misjub fil-komponent tar-rotta tas-sors, jekk jintuża r-rotot tas-sors
Aġġustament ta' NVM3_DEFAULT_NVM_SIZE u NVM3_DEFAULT_CACHE_SIZE skont l-użu ta' NVM3
- Eż. daqsijiet tan-netwerk akbar minn 65 node x'aktarx jeħtieġu daqs NVM3 ta' 64K. Id-daqs default NVM3 f'Silicon Labs Zigbee sample applikazzjonijiet huwa 32K. Applikazzjonijiet li jużaw NVM b'mod aktar qawwi jistgħu jeħtieġu aġġustament ta' dan il-valur saħansitra ogħla.
- Netwerks kbar sa 65 node jistgħu jeħtieġu daqs ta 'cache NVM3 ta' 1200 bytes; netwerks li qed jikbru akbar minn dak jistgħu jeħtieġu l-irduppjar ta 'dan il-valur għal 2400 bytes.

Dawn l-aġġustamenti japplikaw għaċ-Ċentru ta' Fiduċja biss

Multiprotocol Gateway u RCP

Oġġetti ġodda
Ippermettiet appoġġ GA SoC għal BLE DMP b'Zigbee + Openthread CMP b'smigħ konkorrenti fuq partijiet xG26. L-appoġġ Debian alpha ġie miżjud għall-applikazzjonijiet Zigbeed, OTBR, u Z3Gateway. Zigbeed u OTBR huma pprovduti f'format ta 'pakkett DEB għall-pjattaforma ta' referenza magħżula (Raspberry PI 4) ukoll. Ara Tmexxi Zigbee, OpenThread, u Bluetooth fl-istess ħin fuq Linux Host b'Koproċessur Multiprotokoll, misjub fuq docs.silabs.com, għad-dettalji. Żid l-appoġġ Zigbeed għal Tizen-0.1-13.1 għal arm32 u aarch64 kif ukoll Android 12 għal aarch64. Aktar informazzjoni dwar Zigbeed tista 'tinstab fuq docs.silabs.com. Żid il-komponent ġdid "802.15.4 Unified radju Scheduler prijorità". Dan il-komponent jintuża biex jiġi kkonfigurat il-prijoritajiet tar-radju ta 'munzell 15.4. Il-komponent jeħtieġ ukoll il-komponent ġdid "radio_priority_configurator". Dan il-komponent jippermetti lill-proġetti li jużaw l-għodda tal-Konfiguratur tal-Prijorità tar-Radju fi Simplicity Studio biex jikkonfiguraw il-livelli ta 'prijorità tar-radju tal-munzelli li jeħtieġuha.

Titjib
Nota tal-applikazzjoni It-tħaddim ta' Zigbee, OpenThread, u Bluetooth fl-istess ħin fuq Linux Host b'Ko-Proċessur Multiprotokoll (AN1333) ġie mċaqlaq għal docs.silabs.com. L-appoġġ OpenWRT issa huwa ta 'kwalità GA. L-appoġġ OpenWRT ġie miżjud għall-applikazzjonijiet Zigbee, OTBR, u Z3Gateway. Zigbeed u OTBR huma pprovduti f'format ta 'pakkett IPK għall-pjattaforma ta' referenza (Raspberry PI 4) ukoll. Ara Tmexxi Zigbee, OpenThread, u Bluetooth fl-istess ħin fuq Linux Host b'Koproċessur Multiprotokoll, misjub fuq docs.silabs.com, għad-dettalji.

Kwistjonijiet Fissi

Kwistjonijiet Magħrufa fir-Rilaxx Kurrenti
Kwistjonijiet b'tipa grassa ġew miżjuda mir-rilaxx preċedenti. Jekk tlift rilaxx, noti ta 'rilaxx riċenti huma disponibbli ħafurhttps://www.silabs.com/developers/simplicity-software-development-kit.

Oġġetti deprecati
Il-"Kontenitur Multiprotokoll" li bħalissa huwa disponibbli fuq DockerHub (siliconlabsinc/multiprotocol) se jkun deprecated f'rilaxx li ġej. Il-kontenitur mhux se jibqa' aġġornat u jkun jista' jinġibed minn DockerHub. Il-pakketti bbażati fuq Debian għal cpcd, ZigBee, u ot-br-posix, flimkien ma 'proġetti ġġenerati u kkumpilati b'mod nattiv, se jissostitwixxu l-funzjonalità mitlufa bit-tneħħija tal-kontenitur.

Bl-użu ta' dan ir-rilaxx

Din ir-rilaxx fiha dan li ġej:

Munzell Zigbee
Qafas ta 'Applikazzjoni Zigbee
Zigbee Sampl-Applikazzjonijiet

Għal aktar informazzjoni dwar Zigbee u l-EmberZNet SDK ara UG103.02: Zigbee Fundamentals. Jekk int utent għall-ewwel darba, ara QSG180: Zigbee EmberZNet Quick-Start Guide għal SDK 7.0 u Ogħla, għal struzzjonijiet dwar il-konfigurazzjoni tal-ambjent tal-iżvilupp tiegħek, il-bini u t-teptep bħalaample applikazzjoni, u dokumentazzjoni referenzi li jindikaw il-passi ext.

Installazzjoni u Użu
Iż-Zigbee EmberZNet SDK huwa pprovdut bħala parti mis-Simplicity SDK, il-ġabra ta' Silicon Labs SDKs. Biex tibda malajr bis-Simplicity SDK, installa Simplicity Studio 5, li se jwaqqaf l-ambjent ta 'żvilupp tiegħek u jimxik permezz tal-installazzjoni ta' Simplicity SDK. Simplicity Studio 5 jinkludi dak kollu meħtieġ għall-iżvilupp tal-prodott IoT b'apparat ta 'Silicon Labs, inkluż riżorsa u lanċjar tal-proġetti, għodod ta' konfigurazzjoni tas-softwer, IDE sħiħ b'katina ta 'għodda GNU, u għodod ta' analiżi. L-istruzzjonijiet tal-installazzjoni huma pprovduti fil-Gwida tal-Utent ta' Simplicity Studio 5 onlajn. Inkella, Simplicity SDK jista' jiġi installat manwalment billi tniżżel jew tikklona l-aħħar minn GitHub. Ara https://github.com/SiliconLabs/simplicity_sdk għal aktar informazzjoni. Simplicity Studio jinstalla s-Simplicity SDK b'mod awtomatiku fi:

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

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

Dokumentazzjoni speċifika għall-verżjoni SDK hija installata mal-SDK. Tagħrif addizzjonali spiss jista' jinstab fl-artikoli tal-bażi tal-għarfien (KBAs). Referenzi API u informazzjoni oħra dwar dan u rilaxxi preċedenti huma disponibbli fuq https://docs.silabs.com/.

Informazzjoni dwar is-Sigurtà
Integrazzjoni Sikura tal-Vault
Għal applikazzjonijiet li jagħżlu li jaħżnu ċwievet b'mod sigur bl-użu tal-komponent Ħażna Sikura taċ-Ċavetta fuq partijiet Secure Vault-High, it-tabella li ġejja turi ċ-ċwievet protetti u l-karatteristiċi tal-protezzjoni tal-ħażna tagħhom li jimmaniġġja l-komponent Zigbee Security Manager.Ċwievet imgeżwer li huma mmarkati bħala "Mhux Esportabbli" jistgħu jintużaw iżda ma jistgħux ikunu viewed jew maqsuma waqt ir-runtime. Ċwievet imgeżwer li huma mmarkati bħala "Esportabbli" jistgħu jintużaw jew kondiviżi waqt ir-runtime iżda jibqgħu kriptati waqt li jkunu maħżuna fil-Flash. L-applikazzjonijiet tal-utent qatt ma għandhom bżonn jinteraġixxu mal-maġġoranza ta 'dawn iċ-ċwievet. APIs eżistenti għall-ġestjoni taċ-ċwievet tal-Link Key Table jew taċ-Ċwievet Transitorji għadhom disponibbli għall-applikazzjoni tal-utent u nare ow jiġu mgħoddija permezz tal-komponent Zigbee Security Manager.

Konsulenzi dwar is-Sigurtà
Biex tabbona għal Pariri dwar is-Sigurtà, idħol fil-portal tal-klijenti ta' Silicon Labs, imbagħad agħżel Home Account. Ikklikkja HOME biex tmur fil-paġna ewlenija tal-portal u mbagħad ikklikkja l-maduma Immaniġġja Notifiki. Kun żgur li 'Software/Security Advisory Notices & Product Change Notices (PCNs)' huwa ċċekkjat, u li inti abbonat għall-minimu għall-pjattaforma u l-protokoll tiegħek. Ikklikkja Save biex issalva kwalunkwe tibdil.

Appoġġ
Il-klijenti tal-Kit tal-Iżvilupp huma eliġibbli għal taħriġ u appoġġ tekniku. Uża s-Silicon Laboratories Zigbee web paġna biex tikseb informazzjoni dwar il-prodotti u s-servizzi kollha ta’ Silicon Labs Zigbee, u biex tiffirma għall-appoġġ tal-prodott. Tista' tikkuntattja l-appoġġ ta' Silicon Laboratories fuq http://www.silabs.com/support.

Ċertifikazzjoni Zigbee
Ir-rilaxx Ember ZNet 8.1 ġie kkwalifikat għal Pjattaforma Konformi Zigbee għal arkitetturi SoC, NC, P, u RCP hemm ID ta 'ċertifikazzjoni ZCP marbuta ma' din ir-rilaxx, jekk jogħġbok iċċekkja s-CSA websit hawn:
https://csa-iot.org/csa-iot_products/.

Jekk jogħġbok innota li ċ-ċertifikazzjoni ZCP hija filed wara r-rilaxx, u jieħu ftit ġimgħat qabel ma tiġi riflessa fuq is-CSA websit. Għal kwalunkwe mistoqsija oħra, jekk jogħġbok ikkuntattja l-appoġġ ta' Silicon Laboratories fuq http://www.silabs.com/support.

FAQs

Q: Kif naġġorna d-daqs tat-tabella taċ-ċavetta tal-link APS fl-SDK?
A: Id-daqs tat-tabella taċ-ċavetta tal-link APS jista 'jiġi kkonfigurat bl-użu tal-parametru SL_ZIGBEE_KEY_TABLE_SIZE. Fil-verżjoni 8.1, ġiet estiża minn 127 għal 254 entrati.

Q: X'inhu t-titjib fil-verżjoni 8.1?
A: Il-verżjoni 8.1 ġġib titjib bħall-espansjoni tad-daqs tal-mejda taċ-ċavetta tal-link APS, tibdil tal-isem tal-komponenti, iż-żieda tal-protezzjoni mutex għall-kju tal-avvenimenti tal-Qafas Athe pp, u aktar. Irreferi għan-noti tar-rilaxx għal lista dettaljata ta 'titjib.

Q: Kif nittratta kwistjonijiet fissi fl-SDK?
A: Kwistjonijiet fissi fl-SDK inkluż is-soluzzjoni ta 'problemi potenzjali bil-konfigurazzjoni tad-daqs tal-mejda tal-ġirien, tibdil tal-isem tal-komponenti, l-iffissar ta' overhead tar-rotta tas-sors, l-immaniġġjar tal-kmandi ZCL, u aktar. Kun żgur li taġġorna għall-aħħar verżjoni biex tibbenefika minn dawn it-tiswija.

Dokumenti / Riżorsi

SILICON LABS Zigbee EmberZ Net SDK [pdf] Istruzzjonijiet
Zigbee EmberZ Net SDK, EmberZ Net SDK, Net SDK, SDK

Referenzi

Manwal għall-Utent

SILICON LABS Zigbee EmberZ Net SDK

Speċifikazzjonijiet

Informazzjoni dwar il-Prodott