SILICON LABS Zigbee EmberZ Net SDK Instrukcioj

Silicon Labs estas la elekta vendisto por OEM-oj evoluantaj Zigbee-reton en siajn produktojn. La platformo Zigbee de Silicon Labs estas la plej integra, kompleta kaj riĉa Zigbee-solvo disponebla. La Silicon Labs EmberZNet SDK enhavas la efektivigon de Silicon Labs de la Zigbee-stakospecifo.

Ŝlosilaj Trajtoj

Zigbee

-250+ enskriboj en la APS-liga ŝlosiltabelo
ZigbeeD-subteno en Android 12 (v21.0.6113669) kaj Tizen (v0.1-13.1)

Subteno de modulo xG26

Multprotokolo

ZigbeeD kaj OTBR-subteno sur OpenWRT - GA
DMP BLE + CMP ZB & Matter/OT kun Samtempa Aŭskultado sur MG26 por SoC - GA

802.15.4 Unuigita radioplanisto prioritata komponento
Debian-pakaĵsubteno por MP gastigaj aplikoj - Alpha

Novaj Eroj

Gravaj Ŝanĝoj
La grandeco de APS-ligo-ŝlosila tabelo (agordita per SL_ZIGBEE_KEY_TABLE_SIZE) estas vastigita de 127 ĝis 254 enskriboj.

R23-subteno estas aldonita por ZDD Network-komisionfunkcio. Tunela funkcieco estas havebla sen subteno por Legacy Network uzkazoj.

La komponantoj de Network Steering kaj Network Creator estis ĝisdatigitaj por inkluzivi subtenon por aliĝo al R23. Ĉi tiuj inkluzivas la jenajn rilatajn ŝanĝojn.
- La defaŭlta petopolitiko de Trust Center Link Key (TCLK) estis ĝisdatigita por generi novajn ŝlosilojn por ĉiu petanta aparato. Nova ŝlosilo estas generita ĉiufoje kiam la petantaj aparatoj provas ĝisdatigi sian Fidocentron-Linkŝlosilon.
- Pro la antaŭa TCLK-politika ŝanĝo, la komponanto de Sekureco de Reto Kreinto nun postulas la komponanton de Sekurec-Ligaj Ŝlosiloj. La ĝisdatigo de aplikaĵoj estos ĝisdatigitaj por konformiĝi al ĉi tiu nova postulo.
- Nova agordo,
  SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY estas aldonita por permesi aliĝon per kerna, hakita ŝlosilo. Ĉi tiu agordo troviĝas sub la komponanto Network Creator Security. Uzo de ĉi tiu politiko permesas al ĉiu aliĝa aparato ricevi unikan TCLK-post-kuniĝon, sed ripetaj provoj ĝisdatigi la TCLK ne rezultigos novan ŝlosilon por la petanta aparato. Ĉi tiu uzado de hakitaj ligŝlosiloj estis la defaŭlta politiko antaŭ ĉi tiu eldono, kaj la uzo de ĉi tiu politiko permesas al la Fidocentro eviti enporti la komponanton de Sekurecligo-Ŝlosiloj, kiu konservas ŝlosilojn en Flash.
  Notu: Silicon Labs ne rekomendas la uzon de ĉi tiu politiko, ĉar tio malhelpas aliĝaj aparatoj ruliĝi aŭ ĝisdatigi siajn TCLK-ojn.

Nova agordo estas aldonita al la komponento zigbee_ezsp_spi por permesi la agordon de la gastiganta SPI-aparato kaj ĝiaj pininterfacoj.
La eksample projektoj, inkluzive de la projekto files (.slcps) kaj projektdosierujo, estas renomitaj al Silicon Labs nomadgvidlinioj kaj movitaj sub la "projektoj" dosierujo.

Nova Platforma Subteno

Novaj moduloj
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Novaj radiotabuloj
- MGM260P-RB4350A
- MGM260P-RB4351A
Nova parto
- efr32xg27
Esplorilo Kit
- BRD2709A
- MGM260P-EK2713A

Nova Dokumentado
Nova EZSP-uzanto gvidas UG600 por eldonoj 8.1 kaj pli.

Pliboniĝoj

SL_ZIGBEE_KEY_TABLE_SIZE limoj pligrandiĝis ĝis 254 enskriboj.
Aldonita zigbee_security_link_keys al Z3Light.
Aldonita zigbee_security_link_keys al zigbee_mp_z3_tc_z3_tc. Ĝisdatigis ĝian ŝlosilan tabelgrandecon ankaŭ.
Plialtigis la grandecon de la ŝlosila tablo de Z3 Gateway (kiu estos agordita al ncp) al 20.

Fiksaj Problemoj

Konataj Problemoj en la Nuna Eldono

Temoj en grasa skribo estis aldonitaj ekde la antaŭa eldono. Se vi maltrafis eldonon, lastatempaj eldonnotoj haveblas ĉe https://www.silabs.com/developers/zigbee-emberznet en la langeto Tech Docs.

Malrekomenditaj Eroj

La komponanto zigbee_watchdog_periodic_refresh ne plu estas uzata en la aplikaĵkadro de Zigbee kaj estas malrekomendita en ĉi tiu eldono. La gardohundo tempigilo estas malŝaltita defaŭlte por ĉiuj sample aplikoj. Estos plibonigita gardhundo-komponento aldonita al la SDK estonte.
Notu: Ebligu la gardan tempigilon kun agorda ero SL_LEGACY_HAL_DISABLE_WATCHDOG agordita al 0 en via aplikaĵo

Retaj Limigoj kaj Konsideroj

La defaŭltaj Trust Center-aplikaĵoj, kiuj venas kun ĉi tiu eldono de EmberZNet, kapablas subteni plurajn aparatojn en la reto. Ĉi tiu nombro estas determinita surbaze de pluraj faktoroj, inkluzive de agorditaj tablograndecoj, NVM-uzado, kaj aliaj generaciaj tempoj kaj rultempaj valoroj. Uzantoj serĉantaj krei grandajn retojn povas renkonti rimedproblemojn kiam kreskigas la reton pli granda ol la aplikaĵo povas subteni. Por ekzample, aparato petante Trust Center Link Key de la Trust Center povas ekigi sl_zigbee_af_zigbee_key_establishment_cb-revokon sur la Trust Center kun h statuso agordita al SL_ZIGBEE_KEY_TABLE_FULL, indikante ke la ŝlosiltabelo ne havas lokon por aldoni novan ŝlosilon por la petanta aparato aŭ ke NVM3 ne havas disponeblan spacon. Silicon Labs disponigas la sekvajn rekomendojn por uzantoj serĉantaj krei grandajn retojn. Por Trust Center-aplikoj, la sekvaj agordoj estas rekomenditaj. Ĉi tiuj rekomendoj ne estas ĝisfundaj, kaj ili funkcias kiel bazlinio por aplikoj intencantaj kreskigi grandajn retojn.

Inkludo de la komponanto de Adrestabelo (zigbee_address_table), kun
- la agorda ero SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE agordita al la grandeco de la dezirata reto
- la SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE valoro fiksita al la maksimumo (4)

Inkludo de la Sekurecligo Ŝlosiloj komponento (zigbee_security_link_keys), kun
- La SL_ZIGBEE_KEY_TABLE_SIZE valoro estas agordita al la grandeco de la reto
La sekvaj agordaj eroj estas agordita al la grandeco de la dezirata reto
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, kiel troviĝas en la komponanto Zigbee Pro Stack
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, kiel trovite en la Fonta vojigo, se fonta vojigo estas uzata
Alĝustigo de NVM3_DEFAULT_NVM_SIZE kaj NVM3_DEFAULT_CACHE_SIZE laŭ uzado de NVM3
- Ekz. retaj grandecoj pli grandaj ol 65 nodoj verŝajne postulas NVM3-grandecon de 64K. La defaŭlta NVM3 grandeco en Silicon Labs Zigbee sampla aplikoj estas 32K. Aplikoj kiuj uzas NVM pli peze povas postuli alĝustigi ĉi tiun valoron eĉ pli alta.
- Grandaj retoj ĝis 65 nodoj eble bezonas NVM3-kaŝmemorgrandecon de 1200 bajtoj; kreskantaj retoj pli grandaj ol tio povas postuli duobligi ĉi tiun valoron al 2400 bajtoj.

Ĉi tiuj alĝustigoj validas nur por la Fidocentro

Multiprotokola Enirejo kaj RCP

Novaj Eroj
Ebligita GA SoC-subteno por BLE DMP kun Zigbee + Openthread CMP kun samtempa aŭskultado sur xG26-partoj. Debian-alfa-subteno estis aldonita por Zigbeed, OTBR, kaj Z3Gateway-aplikoj. Zigbeed kaj OTBR estas disponigitaj en DEB pakformato por la elektita referencplatformo (Raspberry PI 4) ankaŭ. Vidu Running Zigbee, OpenThread, kaj Bluetooth Samtempe sur Linuksa Gastiganto kun Multprotokola Kunprocesoro, trovita ĉe docs.silabs.com, por detaloj. Aldonita Zigbeed-subteno por Tizen-0.1-13.1 por arm32 kaj aarch64 kaj Android 12 por aarch64. Pliaj informoj pri Zigbeed troveblas ĉe docs.silabs.com. Aldonis la novan komponanton "802.15.4 Unified radio scheduler priority". Ĉi tiu komponanto estas uzata por agordi la radioprioritatojn de 15.4 stako. La komponanto ankaŭ postulas la novan komponanton "radio_priority_configurator". Ĉi tiu komponanto permesas al projektoj uzi la ilon de Radio Priority Configurator en Simplicity Studio por agordi la radioprioritatajn nivelojn de la stakoj kiuj postulas ĝin.

Pliboniĝoj
Noto pri aplikaĵo Kuranta Zigbee, OpenThread kaj Bluetooth Samtempe sur Linuksa Gastiganto kun Multprotokola Kunprocesoro (AN1333) estis movita al docs.silabs.com. OpenWRT-subteno nun estas GA-kvalito. OpenWRT-subteno estis aldonita por Zigbee, OTBR, kaj Z3Gateway-aplikoj. Zigbeed kaj OTBR estas provizitaj en IPK-pakaĵformato por la referenca platformo (Raspberry PI 4) ankaŭ. Vidu Running Zigbee, OpenThread, kaj Bluetooth Samtempe sur Linuksa Gastiganto kun Multprotokola Kunprocesoro, trovita ĉe docs.silabs.com, por detaloj.

Fiksaj Problemoj

Konataj Problemoj en la Nuna Eldono
Temoj en grasa skribo estis aldonitaj ekde la antaŭa eldono. Se vi maltrafis eldonon, lastatempaj eldonnotoj haveblas avenohttps://www.silabs.com/developers/simplicity-software-development-kit.

Malrekomenditaj Eroj
La "Multiprotokola Ujo" kiu estas nuntempe havebla sur DockerHub (siliconlabsinc/multiprotokola) estos malrekomendita en venonta eldono. La ujo ne plu estos ĝisdatigita kaj povas esti eltirita de DockerHub. La Debian-bazitaj pakaĵoj por cpcd, ZigBee, kaj ot-br-posix, kune kun denaske generitaj kaj kompilitaj projektoj, anstataŭigos la funkciecon perditan kun la forigo de la ujo.

Uzante Ĉi tiun Eldonon

Ĉi tiu eldono enhavas la jenon:

Zigbee stako
Zigbee Aplika Kadro
Zigbee Sample Aplikoj

Por pliaj informoj pri Zigbee kaj la EmberZNet SDK vidu UG103.02: Zigbee Fundamentals. Se vi estas unuafoja uzanto, vidu QSG180: Zigbee EmberZNet Quick-Start Guide for SDK 7.0 and Higher, por instrukcioj pri agordo de via evolumedio, konstruado kaj ekbrilado kielample aplikaĵo, kaj dokumentaj referencoj montrantaj al la ekst paŝoj.

Instalado kaj Uzo
La Zigbee EmberZNet SDK estas disponigita kiel parto de la Simplicity SDK, la serio de Silicon Labs SDK-oj. Por rapide komenci kun Simplicity SDK, instalu Simplicity Studio 5, kiu starigos vian evolumedion kaj gvidos vin tra la instalado de Simplicity SDK. Simplicity Studio 5 inkluzivas ĉion bezonatan por IoT-produktevoluo per Silicon Labs-aparatoj, inkluzive de rimedo kaj projektlanĉilo, programaraj agordaj iloj, plena IDE kun GNU-ilĉeno kaj analizaj iloj. Instalaj instrukcioj estas provizitaj en la interreta Uzantgvidilo de Simplicity Studio 5. Alternative, Simplicity SDK povas esti instalita permane elŝutante aŭ klonante la plej novan de GitHub. Vidu https://github.com/SiliconLabs/simplicity_sdk por pliaj informoj. Simplicity Studio instalas la Simplicity SDK defaŭlte en:

(Vindozo): C:\Uzantoj\\SimplicityStudio\SDKs\simplicity_sdk

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

Dokumentaro specifa por la SDK-versio estas instalita kun la SDK. Pliaj informoj ofte troveblas en la sciobazaj artikoloj (KBAoj). API-referencoj kaj aliaj informoj pri ĉi tiu kaj pli fruaj eldonoj estas haveblaj ĉe https://docs.silabs.com/.

Sekurecaj Informoj
Sekura Vault-Integriĝo
Por aplikaĵoj, kiuj elektas konservi ŝlosilojn sekure uzante la komponanton Secure Key Storage sur Secure Vault-High-partoj, la sekva tabelo montras la protektitajn ŝlosilojn kaj iliajn konservadprotektajn trajtojn, kiujn administras la komponanto Zigbee Security Manager.Envolvitaj ŝlosiloj kiuj estas markitaj kiel "Ne-Ekporteblaj" povas esti uzataj sed ne povas esti viewred aŭ dividita ĉe rultempo. Envolvitaj ŝlosiloj kiuj estas markitaj kiel "Ekporteblaj" povas esti uzataj aŭ dividitaj dum rultempo, sed restas ĉifritaj dum ili konserviĝas en Flash. Uzantaplikoj neniam bezonas interagi kun la plimulto de ĉi tiuj ŝlosiloj. Ekzistantaj APIoj por administri Link Key Table-ŝlosilojn aŭ Transient Keys daŭre estas haveblaj al la uzantaplikaĵo kaj ne estas direktitaj tra la Zigbee Security Manager-komponento.

Konsiloj pri Sekureco
Por aboni Sekurecajn Konsilojn, ensalutu al la klientportalo de Silicon Labs, tiam elektu Konto-Hejmon. Alklaku HEJMO por iri al la portala ĉefpaĝo kaj poste alklaku la kahelon Administri Sciigojn. Certigu, ke 'Programaro/Sekurec-Avizoj kaj Produktaj Ŝanĝoj-Avizoj (PCN-oj)' estas kontrolita, kaj ke vi estas minimume abonita por via platformo kaj protokolo. Klaku Konservi por konservi ajnajn ŝanĝojn.

Subteno
La klientoj de Disvolva Kit estas elekteblaj por trejnado kaj teknika subteno. Uzu la Silicon Laboratories Zigbee web paĝo por akiri informojn pri ĉiuj produktoj kaj servoj de Silicon Labs Zigbee, kaj por registriĝi por produktsubteno. Vi povas kontakti Silicon Laboratories-subtenon ĉe http://www.silabs.com/support.

Zigbee-Atestado
La eldono de Ember ZNet 8.1 estis kvalifikita por Zigbee Compliant Platform por SoC, NC, P, kaj RCP-arkitekturoj ekzistas ZCP-atestidentigilo ligita al ĉi tiu eldono, bonvolu kontroli la CSA. webretejo ĉi tie:
https://csa-iot.org/csa-iot_products/.

Bonvolu noti, ke la ZCP-atestilo estas filed afiŝu la liberigon, kaj prenas kelkajn semajnojn antaŭ ol pripensi la CSA webretejo. Por pliaj demandoj, bonvolu kontakti la subtenon de Silicon Laboratories ĉe http://www.silabs.com/support.

Oftaj Demandoj

Q: Kiel mi ĝisdatigas la grandecon de la ŝlosila tabelo de APS-ligo en la SDK?
R: La grandeco de la klavtabelo de APS-ligo povas esti agordita per la parametro SL_ZIGBEE_KEY_TABLE_SIZE. En versio 8.1, ĝi estis vastigita de 127 ĝis 254 enskriboj.

Q: Kio estas la plibonigoj en versio 8.1?
R: Versio 8.1 alportas plibonigojn kiel vastigi la grandecon de la ŝlosila tabelo de APS-ligilo, renomi komponantojn, aldonante mutex-protekton por la atendovico de Athe pp Framework kaj pli. Riferu al la eldonnotoj por detala listo de plibonigoj.

Q: Kiel mi traktas fiksajn problemojn en la SDK?
R: Korektis problemojn en la SDK inkluzive de solvado de eblaj problemoj kun najbara tabelgranda agordo, renomado de komponentoj, fiksado de fontitinero, pritraktado de ZCL-komandoj kaj pli. Certigu, ke vi ĝisdatigas al la plej nova versio por profiti de ĉi tiuj korektoj.

Dokumentoj/Rimedoj

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

Referencoj

Uzanto Manlibro

SILICON LABS Zigbee EmberZ Net SDK

Specifoj

Produktaj Informoj