Udhëzime për SILICON LABS Zigbee EmberZ Net SDK

Silicon Labs është shitësi i zgjedhur për OEM që zhvillojnë rrjetëzimin Zigbee në produktet e tyre. Platforma Zigbee e Silicon Labs është zgjidhja Zigbee më e integruar, e plotë dhe e pasur me veçori të disponueshme. Silicon Labs EmberZNet SDK përmban zbatimin nga Silicon Labs të specifikimit Zigbee stack.

TIPARET KRYESORE

Zigbee

-250+ hyrje në tabelën e çelësit të lidhjes APS
Mbështetje ZigbeeD në Android 12 (v21.0.6113669) dhe Tizen (v0.1-13.1)

Mbështetja e modulit xG26

Multiprotokolli

Mbështetje ZigbeeD dhe OTBR në OpenWRT – GA
DMP BLE + CMP ZB & Matter/OT me dëgjim të njëkohshëm në MG26 për SoC – GA

802.15.4 Komponenti prioritar i programuesit të unifikuar të radios
Mbështetje për paketimin e Debian për aplikacionet pritës MP – Alpha

Artikuj të rinj

Ndryshime të rëndësishme
Madhësia e tabelës së çelësit të lidhjes APS (e konfiguruar duke përdorur SL_ZIGBEE_KEY_TABLE_SIZE) është zgjeruar nga 127 në 254 hyrje.

Mbështetja R23 është shtuar për funksionalitetin e vënies në punë të Rrjetit ZDD. Funksionaliteti i tunelit është i disponueshëm pa mbështetje për rastet e përdorimit të rrjetit të trashëguar.

Komponentët Drejtues i Rrjetit dhe Krijuesi i Rrjetit janë përditësuar për të përfshirë mbështetjen për bashkimin R23. Këto përfshijnë ndryshimet e mëposhtme të lidhura.
- Politika e parazgjedhur e kërkesës për "Çelësin e lidhjes së qendrës së besimit" (TCLK) është përditësuar për të gjeneruar çelësa të rinj për secilën pajisje kërkuese. Një çelës i ri gjenerohet sa herë që pajisjet kërkuese përpiqen të përditësojnë çelësin e tyre të lidhjes së Qendrës së Mirëbesimit.
- Për shkak të ndryshimit të mëparshëm të politikës TCLK, komponenti i Sigurisë së Krijuesit të Rrjetit tani kërkon komponentin "Çelësat e lidhjes së sigurisë". Përmirësimi i aplikacioneve do të përditësohet në përputhje me këtë kërkesë të re.
- Një konfigurim i ri,
  SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY është shtuar për të lejuar bashkimin duke përdorur një çelës thelbësor, hash. Ky konfigurim gjendet nën komponentin e Sigurisë së Krijuesit të Rrjetit. Përdorimi i kësaj politike lejon çdo pajisje që bashkohet të marrë një TCLK unike pas bashkimit, por përpjekjet e përsëritura për të përditësuar TCLK nuk do të rezultojnë në një çelës të ri për pajisjen kërkuese. Ky përdorim i çelësave të lidhjeve të hashuara ishte politika e paracaktuar përpara këtij publikimi dhe përdorimi i kësaj politike i lejon Qendrës së Mirëbesimit të shmangë futjen e komponentit "Çelësat e lidhjes së sigurisë", i cili ruan çelësat në Flash.
  Shënim: Silicon Labs nuk rekomandon përdorimin e kësaj politike, pasi kjo parandalon bashkimin e pajisjeve nga rrotullimi ose përditësimi i TCLK-ve të tyre.

Një grup i ri konfigurimi i shtohet komponentit zigbee_ezsp_spi për të lejuar konfigurimin e pajisjes SPI pritës dhe ndërfaqet e saj pine.
Ishampprojektet, duke përfshirë projektin files (.slcps) dhe dosja e projektit, janë riemërtuar në udhëzimet e emërtimit të Silicon Labs dhe zhvendosen nën direktorinë "projects".

Mbështetja e platformës së re

Modulet e reja
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Pllakat e reja të radios
- MGM260P-RB4350A
- MGM260P-RB4351A
Pjesa e re
- efr32xg27
Kit Explorer
- BRD2709A
- MGM260P-EK2713A

Dokumentacion i ri
Një udhëzues i ri përdoruesi EZSP UG600 për versionet 8.1 e lart.

Përmirësimet

Kufijtë SL_ZIGBEE_KEY_TABLE_SIZE u zgjeruan deri në 254 hyrje.
U shtuan zigbee_security_link_keys në Z3Light.
U shtuan zigbee_security_link_keys te zigbee_mp_z3_tc_z3_tc. Përditësoi gjithashtu madhësinë e saj kryesore të tabelës.
Rriti madhësinë e tabelës së tastit Z3 Gateway (që do të vendoset në ncp) në 20.

Çështje të Rregulluara

Çështjet e njohura në publikimin aktual

Çështjet me shkronja të zeza janë shtuar që nga publikimi i mëparshëm. Nëse keni humbur një version, shënimet e lëshimit të fundit janë në dispozicion në https://www.silabs.com/developers/zigbee-emberznet në skedën Dokumentet Teknike.

Artikuj të vjetëruar

Komponenti zigbee_watchdog_periodic_refresh nuk përdoret më në kuadrin e aplikacionit Zigbee dhe është i vjetëruar në këtë version. Kohëmatësi i rojes është i çaktivizuar si parazgjedhje për të gjitha sampaplikacionet. Në të ardhmen do të shtohet një komponent mbikëqyrës i përmirësuar në SDK.
Shënim: Aktivizo kohëmatësin e rojes me artikullin e konfigurimit SL_LEGACY_HAL_DISABLE_WATCHDOG të caktuar në 0 në aplikacionin tuaj

Kufizimet dhe konsideratat e rrjetit

Aplikacionet e paracaktuara të Qendrës së Mirëbesimit që vijnë me këtë version të EmberZNet janë në gjendje të mbështesin disa pajisje në rrjet. Ky numër përcaktohet bazuar në disa faktorë, duke përfshirë madhësitë e konfiguruara të tabelës, përdorimin e NVM dhe vlerat e tjera të kohës së gjenerimit dhe kohës së ekzekutimit. Përdoruesit që kërkojnë të krijojnë rrjete të mëdha mund të përballen me probleme me burimet kur e rritin rrjetin më të madh se sa mund të mbështesë aplikacioni. Për shembullampLe, një pajisje që kërkon një çelës lidhjeje të Qendrës së Mirëbesimit nga Qendra e Mirëbesimit mund të shkaktojë një kthim sl_zigbee_af_zigbee_key_establishment_cb në Qendrën e Mirëbesimit me statusin h të vendosur në SL_ZIGBEE_KEY_TABLE_FULL, duke treguar që tabela e çelësit nuk ka vend për të shtuar një pajisje të re3 ose nuk ka hapësirë të disponueshme në tabelën e çelësit. Silicon Labs ofron rekomandimet e mëposhtme për përdoruesit që kërkojnë të krijojnë rrjete të mëdha. Për aplikacionet e Qendrës së Mirëbesimit, rekomandohen konfigurimet e mëposhtme. Këto rekomandime nuk janë shteruese dhe shërbejnë si bazë për aplikacionet që synojnë të rrisin rrjete të mëdha.

Përfshirja e komponentit Address Table (zigbee_address_table), me
- artikulli i konfigurimit SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE u vendos në madhësinë e rrjetit të dëshiruar
- vlera SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE është vendosur në maksimum (4)

Përfshirja e komponentit "Çelësat e lidhjes së sigurisë" (çelësat e lidhjes_zigbee_security), me
- Vlera SL_ZIGBEE_KEY_TABLE_SIZE është vendosur në madhësinë e rrjetit
Artikujt e mëposhtëm të konfigurimit janë caktuar në madhësinë e rrjetit të dëshiruar
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, siç gjendet në komponentin Zigbee Pro Stack
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, siç gjendet në komponentin e rrugëtimit të burimit, nëse përdoret drejtimi i burimit
Rregullimi i NVM3_DEFAULT_NVM_SIZE dhe NVM3_DEFAULT_CACHE_SIZE sipas përdorimit të NVM3
- Për shembull, madhësitë e rrjetit më të mëdha se 65 nyje ka të ngjarë të kërkojnë një madhësi NVM3 prej 64K. Madhësia e parazgjedhur NVM3 në Silicon Labs Zigbee sampaplikacionet janë 32 mijë. Aplikacionet që përdorin më shumë NVM mund të kërkojnë rregullimin e kësaj vlere edhe më të lartë.
- Rrjetet e mëdha deri në 65 nyje mund të kenë nevojë për një madhësi cache NVM3 prej 1200 bajt; Rrjetet në rritje më të mëdha se kaq mund të kërkojnë dyfishimin e kësaj vlere në 2400 byte.

Këto rregullime zbatohen vetëm për Qendrën e Mirëbesimit

Porta Multiprotokolare dhe RCP

Artikuj të rinj
Mbështetja GA SoC e aktivizuar për BLE DMP me Zigbee + Openthread CMP me dëgjim të njëkohshëm në pjesët xG26. Mbështetja alfa e Debian është shtuar për aplikacionet Zigbeed, OTBR dhe Z3Gateway. Zigbeed dhe OTBR ofrohen gjithashtu në formatin e paketës DEB për platformën e zgjedhur të referencës (Raspberry PI 4). Shihni ekzekutimin e Zigbee, OpenThread dhe Bluetooth në të njëjtën kohë në një host Linux me një bashkëprocesor multiprotokolli, që gjendet në docs.silabs.com, per detaje. U shtua mbështetje Zigbeed për Tizen-0.1-13.1 për arm32 dhe aarch64 si dhe Android 12 për aarch64. Më shumë informacion mbi Zigbeed mund të gjeni në docs.silabs.com. U shtua komponenti i ri "802.15.4 Prioriteti i programuesit të unifikuar të radios". Ky komponent përdoret për të konfiguruar prioritetet e radios të një pirg 15.4. Komponenti kërkon gjithashtu komponentin e ri "radio_priority_configurator". Ky komponent i lejon projektet të përdorin veglën Radio Priority Configurator në Simplicity Studio për të konfiguruar nivelet e prioritetit të radios të stivave që e kërkojnë atë.

Përmirësimet
Shënimi i aplikacionit Ekzekutimi i Zigbee, OpenThread dhe Bluetooth njëkohësisht në një host Linux me një bashkëprocesor multiprotokolli (AN1333) është zhvendosur në docs.silabs.com. Mbështetja e OpenWRT tani është me cilësi GA. Mbështetja e OpenWRT është shtuar për aplikacionet Zigbee, OTBR dhe Z3Gateway. Zigbeed dhe OTBR ofrohen në formatin e paketës IPK edhe për platformën e referencës (Raspberry PI 4). Shihni ekzekutimin e Zigbee, OpenThread dhe Bluetooth në të njëjtën kohë në një host Linux me një bashkëprocesor multiprotokolli, që gjendet në docs.silabs.com, per detaje.

Çështje të Rregulluara

Çështjet e njohura në publikimin aktual
Çështjet me shkronja të zeza janë shtuar që nga publikimi i mëparshëm. Nëse keni humbur një version, shënimet e lëshimit të fundit janë të disponueshme tërshërëhttps://www.silabs.com/developers/simplicity-software-development-kit.

Artikuj të vjetëruar
"Multiprotocol Container" i cili është aktualisht i disponueshëm në DockerHub (siliconlabsinc/multiprotocol) do të zhvlerësohet në një version të ardhshëm. Kontejneri nuk do të përditësohet më dhe nuk do të mund të tërhiqet nga DockerHub. Paketat e bazuara në Debian për cpcd, ZigBee dhe ot-br-posix, së bashku me projektet e krijuara dhe të përpiluara në mënyrë vendase, do të zëvendësojnë funksionalitetin e humbur me heqjen e kontejnerit.

Duke përdorur këtë version

Ky lëshim përmban sa vijon:

Stack Zigbee
Korniza e Aplikimit Zigbee
Zigbee Sample Aplikacionet

Për më shumë informacion rreth Zigbee dhe EmberZNet SDK, shihni UG103.02: Zigbee Fundamentals. Nëse jeni përdorues për herë të parë, shihni QSG180: Zigbee EmberZNet-Start Guide për SDK 7.0 dhe më të lartë, për udhëzime mbi konfigurimin e mjedisit tuaj të zhvillimit, ndërtimin dhe ndezjen siampaplikimi, dhe referencat e dokumentacionit që tregojnë hapat vijues.

Instalimi dhe përdorimi
Zigbee EmberZNet SDK ofrohet si pjesë e Simplicity SDK, paketa e SDK-ve të Silicon Labs. Për të filluar shpejt me Simplicity SDK, instaloni Simplicity Studio 5, i cili do të konfigurojë mjedisin tuaj të zhvillimit dhe do t'ju udhëheqë me instalimin e Simplicity SDK. Simplicity Studio 5 përfshin gjithçka që nevojitet për zhvillimin e produktit të IoT me pajisjet Silicon Labs, duke përfshirë një burim dhe lëshues projekti, mjete të konfigurimit të softuerit, IDE të plotë me zinxhirin e veglave GNU dhe mjete analize. Udhëzimet e instalimit jepen në Udhëzuesin e Përdoruesit në internet Simplicity Studio 5. Përndryshe, Simplicity SDK mund të instalohet manualisht duke shkarkuar ose klonuar më të fundit nga GitHub. Shihni https://github.com/SiliconLabs/simplicity_sdk për më shumë informacion. Simplicity Studio instalon Simplicity SDK si parazgjedhje në:

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

(MacOS): /Përdoruesit//SimplicityStudio/SDKs/simplicity_sdk

Dokumentacioni specifik për versionin SDK instalohet me SDK. Informacione shtesë shpesh mund të gjenden në artikujt e bazës së njohurive (KBA). Referencat e API dhe informacione të tjera në lidhje me këtë dhe versionet e mëparshme janë të disponueshme https://docs.silabs.com/.

Informacioni i Sigurisë
Integrimi i sigurt i kasafortës
Për aplikacionet që zgjedhin të ruajnë çelësat në mënyrë të sigurt duke përdorur komponentin Secure Key Storage në pjesët Secure Vault-High, tabela e mëposhtme tregon çelësat e mbrojtur dhe karakteristikat e tyre të mbrojtjes së ruajtjes që menaxhon komponenti Zigbee Security Manager.Çelësat e mbështjellë që janë shënuar si "Jo-Eksportueshëm" mund të përdoren, por nuk mund të përdoren viewmodifikuar ose ndarë në kohën e ekzekutimit. Çelësat e mbështjellë që janë shënuar si "Eksportueshëm" mund të përdoren ose të ndahen në kohën e ekzekutimit, por mbeten të koduar ndërsa ruhen në Flash. Aplikacionet e përdoruesve kurrë nuk kanë nevojë të ndërveprojnë me shumicën e këtyre çelësave. API-të ekzistuese për të menaxhuar çelësat e tabelës së kyçit të lidhjes ose çelësat kalimtarë janë ende të disponueshëm për aplikacionin e përdoruesit dhe mund të kalohen përmes komponentit Zigbee Security Manager.

Këshilla për Sigurinë
Për t'u abonuar te Security Advisories, identifikohuni në portalin e klientëve të Silicon Labs, më pas zgjidhni Account Home. Kliko HOME për të shkuar në faqen kryesore të portalit dhe më pas kliko pllakën Menaxho njoftimet. Sigurohuni që "Njoftimet Këshillimore të Softuerit/Sigurisë dhe Njoftimet për ndryshimin e produktit (PCN)" të jenë të kontrolluara dhe që të jeni të abonuar të paktën për platformën dhe protokollin tuaj. Klikoni Save për të ruajtur çdo ndryshim.

Mbështetje
Klientët e Kit të Zhvillimit kanë të drejtë për trajnim dhe mbështetje teknike. Përdorni Silicon Laboratories Zigbee web faqe për të marrë informacion në lidhje me të gjitha produktet dhe shërbimet e Silicon Labs Zigbee dhe për t'u regjistruar për mbështetjen e produktit. Mund të kontaktoni mbështetjen e Silicon Laboratories në http://www.silabs.com/support.

Certifikimi Zigbee
Publikimi i Ember ZNet 8.1 është kualifikuar për platformën e përputhshme Zigbee për arkitekturat SoC, NC, P dhe RCP, ka një ID certifikimi ZCP të lidhur me këtë version, ju lutemi kontrolloni CSA webfaqe këtu:
https://csa-iot.org/csa-iot_products/.

Ju lutemi vini re se certifikimi ZCP është filed postoni publikimin dhe duhen disa javë përpara se të reflektohet në CSA webfaqe. Për çdo pyetje të mëtejshme, ju lutemi kontaktoni mbështetjen e Silicon Laboratories në http://www.silabs.com/support.

Pyetjet e shpeshta

Pyetje: Si mund ta përditësoj madhësinë e tabelës së çelësit të lidhjes APS në SDK?
Përgjigje: Madhësia e tabelës së çelësit të lidhjes APS mund të konfigurohet duke përdorur parametrin SL_ZIGBEE_KEY_TABLE_SIZE. Në versionin 8.1, ai është zgjeruar nga 127 në 254 hyrje.

Pyetje: Cilat janë përmirësimet në versionin 8.1?
Përgjigje: Versioni 8.1 sjell përmirësime të tilla si zgjerimi i madhësisë së tabelës së kyçit të lidhjes APS, riemërtimi i komponentëve, shtimi i mbrojtjes mutex për radhën e ngjarjeve Athe pp Framework dhe më shumë. Referojuni shënimeve të lëshimit për një listë të detajuar të përmirësimeve.

Pyetje: Si t'i trajtoj problemet fikse në SDK?
Përgjigje: Probleme të rregulluara në SDK duke përfshirë zgjidhjen e problemeve të mundshme me konfigurimin e madhësisë së tabelës fqinje, riemërtimin e komponentëve, rregullimin e sipërm të rrugës së burimit, trajtimin e komandave ZCL dhe më shumë. Sigurohuni që të përditësoni në versionin më të fundit për të përfituar nga këto rregullime.

Dokumentet / Burimet

SILICON LABS Zigbee EmberZ Net SDK [pdfUdhëzime
Zigbee EmberZ Net SDK, EmberZ Net SDK, Net SDK, SDK

Referencat

Manuali i Përdoruesit

SILICON LABS Zigbee EmberZ Net SDK

Specifikimet

Informacioni i produktit