SILICON LABS Zigbee EmberZ Net SDK Mga Tagubilin

Ang Silicon Labs ay ang vendor na pinili para sa mga OEM na bumubuo ng Zigbee networking sa kanilang mga produkto. Ang Silicon Labs Zigbee platform ay ang pinaka-integrated, kumpleto, at mayaman sa feature na Zigbee solution na available. Ang Silicon Labs EmberZNet SDK ay naglalaman ng Silicon Labs ng pagpapatupad ng Zigbee stack specification.

MGA PANGUNAHING TAMPOK

Zigbee

-250+ entry sa APS link key table
Suporta sa ZigbeeD sa Android 12 (v21.0.6113669) at Tizen (v0.1-13.1)

Suporta sa xG26 Module

Multiprotocol

ZigbeeD at OTBR support sa OpenWRT – GA
DMP BLE + CMP ZB & Matter/OT na may Kasabay na Pakikinig sa MG26 para sa SoC – GA

802.15.4 Pinag-isang bahagi ng priority ng scheduler ng radyo
Suporta sa packaging ng Debian para sa mga application ng MP host - Alpha

Mga Bagong Item

Mahahalagang Pagbabago
Ang laki ng talahanayan ng APS link key (na-configure gamit ang SL_ZIGBEE_KEY_TABLE_SIZE) ay pinalawak mula 127 hanggang 254 na mga entry.

Ang suporta sa R23 ay idinagdag para sa pagpapagana ng pagkomisyon ng ZDD Network. Available ang pag-andar ng tunneling nang walang suporta para sa mga kaso ng paggamit ng Legacy Network.

Ang mga bahagi ng Network Steering at Network Creator ay na-update upang isama ang suporta para sa pagsali sa R23. Kabilang dito ang mga sumusunod na kaugnay na pagbabago.
- Ang default na patakaran sa kahilingan ng Trust Center Link Key (TCLK) ay na-update upang bumuo ng mga bagong key para sa bawat humihiling na device. Nabubuo ang isang bagong key sa tuwing sinusubukan ng mga humihiling na device na i-update ang kanilang Trust Center Link Key.
- Dahil sa nakaraang pagbabago sa patakaran ng TCLK, kailangan na ngayon ng bahagi ng Network Creator Security ang bahagi ng Security Link Keys. Ang pag-upgrade ng mga aplikasyon ay ia-update upang makasunod sa bagong kinakailangan na ito.
- Isang bagong configuration,
  Ang SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY ay idinagdag upang payagan ang pagsali gamit ang isang core, na-hash na key. Ang pagsasaayos na ito ay matatagpuan sa ilalim ng bahagi ng Network Creator Security. Ang paggamit ng patakarang ito ay nagbibigay-daan sa bawat pagsali sa device na makatanggap ng natatanging TCLK pagkatapos ng pagsali, ngunit ang paulit-ulit na pagtatangka na i-update ang TCLK ay hindi magreresulta sa isang bagong key para sa humihiling na device. Ang paggamit na ito ng mga na-hash na link key ay ang default na patakaran bago ang release na ito, at ang paggamit ng patakarang ito ay nagbibigay-daan sa Trust Center na iwasang dalhin ang bahagi ng Security Link Keys, na nagse-save ng mga key sa Flash.
  Tandaan: Hindi inirerekomenda ng Silicon Labs ang paggamit ng patakarang ito, dahil pinipigilan nito ang pagsali sa mga device mula sa pag-roll, o pag-update, ng kanilang mga TCLK.

Isang bagong set ng configuration ang idinaragdag sa component na zigbee_ezsp_spi upang payagan ang configuration ng host SPI device at ang mga pin interface nito.
Ang exampmga proyekto, kabilang ang proyekto files (.slcps) at folder ng proyekto, ay pinalitan ng pangalan sa mga alituntunin sa pagpapangalan ng Silicon Labs at inilipat sa ilalim ng direktoryo ng "mga proyekto."

Bagong Suporta sa Platform

Mga bagong module
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Mga bagong radio board
- MGM260P-RB4350A
- MGM260P-RB4351A
Bagong bahagi
- efr32xg27
Explorer Kit
- BRD2709A
- MGM260P-EK2713A

Bagong Dokumentasyon
Isang bagong user ng EZSP ang gumagabay sa UG600 para sa mga release na 8.1 at mas bago.

Mga pagpapabuti

Ang mga limitasyon ng SL_ZIGBEE_KEY_TABLE_SIZE ay pinalawak hanggang 254 na mga entry.
Nagdagdag ng zigbee_security_link_keys sa Z3Light.
Nagdagdag ng zigbee_security_link_keys sa zigbee_mp_z3_tc_z3_tc. Na-update din ang sukat ng key table nito.
Tinaasan ang laki ng Z3 Gateway key table (na itatakda sa ncp) sa 20.

Mga Naayos na Isyu

Mga Kilalang Isyu sa Kasalukuyang Pagpapalabas

Ang mga isyu sa bold ay idinagdag mula noong nakaraang release. Kung napalampas mo ang isang release, available ang mga kamakailang tala ng release sa https://www.silabs.com/developers/zigbee-emberznet sa tab na Tech Docs.

Mga Hindi Na Ginagamit na Item

Ang zigbee_watchdog_periodic_refresh component ay hindi na ginagamit sa Zigbee application framework at hindi na ginagamit sa release na ito. Ang watchdog timer ay hindi pinagana bilang default para sa lahat ng sampang mga aplikasyon. Magkakaroon ng pinahusay na bahagi ng watchdog na idaragdag sa SDK sa hinaharap.
Tandaan: Paganahin ang watchdog timer na may configuration item na SL_LEGACY_HAL_DISABLE_WATCHDOG na nakatakda sa 0 sa iyong application

Mga Limitasyon at Pagsasaalang-alang sa Network

Ang mga default na application ng Trust Center na ipinadala kasama nitong EmberZNet release ay may kakayahang suportahan ang ilang device sa network. Tinutukoy ang numerong ito batay sa ilang salik, kabilang ang mga naka-configure na laki ng talahanayan, paggamit ng NVM, at iba pang mga halaga ng oras ng pagbuo at run-time. Ang mga gumagamit na naghahanap upang lumikha ng malalaking network ay maaaring makaharap sa mga isyu sa mapagkukunan kapag pinalaki ang network na mas malaki kaysa sa suportado ng application. Para kay example, ang isang device na humihiling ng Trust Center Link Key mula sa Trust Center ay maaaring mag-trigger ng sl_zigbee_af_zigbee_key_establishment_cb callback sa Trust Center na may h status na nakatakda sa SL_ZIGBEE_KEY_TABLE_FULL, na nagpapahiwatig na ang key table ay walang puwang para magdagdag ng bagong key para sa humihiling na device o iyon. Ang NVM3 ay walang available na espasyo. Nagbibigay ang Silicon Labs ng mga sumusunod na rekomendasyon para sa mga user na naglalayong lumikha ng malalaking network. Para sa mga aplikasyon ng Trust Center, inirerekomenda ang mga sumusunod na configuration. Ang mga rekomendasyong ito ay hindi kumpleto, at ang mga ito ay nagsisilbing baseline para sa mga application na naglalayong palaguin ang malalaking network.

Pagsasama ng bahagi ng Talahanayan ng Address (zigbee_address_table), kasama ang
- nakatakda ang SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE configuration item sa laki ng gustong network
- ang SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE value na nakatakda sa maximum (4)

Pagsasama ng bahagi ng Security Link Keys (zigbee_security_link_keys), na may
- Ang SL_ZIGBEE_KEY_TABLE_SIZE value ay nakatakda sa laki ng network
Ang mga sumusunod na item sa pagsasaayos ay nakatakda sa laki ng nais na network
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, gaya ng makikita sa bahagi ng Zigbee Pro Stack
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, gaya ng makikita sa Source routing component, kung source routing ang ginamit
Pagsasaayos ng NVM3_DEFAULT_NVM_SIZE at NVM3_DEFAULT_CACHE_SIZE ayon sa paggamit ng NVM3
- Hal., ang mga laki ng network na higit sa 65 node ay malamang na nangangailangan ng laki ng NVM3 na 64K. Ang default na laki ng NVM3 sa Silicon Labs Zigbee sampAng mga aplikasyon ay 32K. Ang mga application na gumagamit ng NVM nang mas mabigat ay maaaring mangailangan ng pagsasaayos ng halagang ito nang mas mataas pa.
- Maaaring kailanganin ng malalaking network na hanggang 65 node ang laki ng cache ng NVM3 na 1200 bytes; lumalagong mga network na mas malaki kaysa doon ay maaaring mangailangan ng pagdoble sa halagang ito sa 2400 bytes.

Ang mga pagsasaayos na ito ay nalalapat lamang sa Trust Center

Multiprotocol Gateway at RCP

Mga Bagong Item
Pinagana ang suporta sa GA SoC para sa BLE DMP na may Zigbee + Openthread CMP na may sabay na pakikinig sa mga bahagi ng xG26. Ang suporta ng Debian alpha ay idinagdag para sa mga application ng Zigbeed, OTBR, at Z3Gateway. Ang Zigbeed at OTBR ay ibinibigay sa DEB package format para sa napiling reference platform (Raspberry PI 4) din. Tingnan ang Pagpapatakbo ng Zigbee, OpenThread, at Bluetooth nang Kasabay sa isang Linux Host na may Multiprotocol Co-Processor, na matatagpuan sa docs.silabs.com, para sa mga detalye. Nagdagdag ng suporta sa Zigbeed para sa Tizen-0.1-13.1 para sa arm32 at aarch64 pati na rin sa Android 12 para sa aarch64. Higit pang impormasyon sa Zigbeed ay matatagpuan sa docs.silabs.com. Idinagdag ang bagong bahagi ng "802.15.4 Unified radio scheduler priority". Ang bahaging ito ay ginagamit upang i-configure ang mga priyoridad sa radyo ng isang 15.4 stack. Kinakailangan din ng component ang bagong component na "radio_priority_configurator". Ang bahaging ito ay nagpapahintulot sa mga proyekto na gamitin ang Radio Priority Configurator tool sa Simplicity Studio upang i-configure ang mga antas ng priyoridad sa radyo ng mga stack na nangangailangan nito.

Mga pagpapabuti
Application note Ang Pagpapatakbo ng Zigbee, OpenThread, at Bluetooth na Kasabay sa isang Linux Host na may Multiprotocol Co-Processor (AN1333) ay inilipat sa docs.silabs.com. Ang suporta sa OpenWRT ay kalidad ng GA na ngayon. Ang suporta sa OpenWRT ay idinagdag para sa mga application ng Zigbee, OTBR, at Z3Gateway. Ang Zigbeed at OTBR ay ibinibigay sa IPK package format para sa reference platform (Raspberry PI 4) din. Tingnan ang Pagpapatakbo ng Zigbee, OpenThread, at Bluetooth nang Kasabay sa isang Linux Host na may Multiprotocol Co-Processor, na matatagpuan sa docs.silabs.com, para sa mga detalye.

Mga Naayos na Isyu

Mga Kilalang Isyu sa Kasalukuyang Pagpapalabas
Ang mga isyu sa bold ay idinagdag mula noong nakaraang release. Kung napalampas mo ang isang release, ang kamakailang mga tala sa paglabas ay available oathttps://www.silabs.com/developers/simplicity-software-development-kit.

Mga Hindi Na Ginagamit na Item
Ang "Multiprotocol Container" na kasalukuyang available sa DockerHub (siliconlabsinc/multiprotocol) ay hindi na gagamitin sa paparating na release. Ang container ay hindi na maa-update at makukuha mula sa DockerHub. Ang mga package na nakabatay sa Debian para sa cpcd, ZigBee, at ot-br-posix, kasama ng mga natively generated at compiled na proyekto, ay papalitan ang functionality na nawala sa pag-alis ng container.

Gamit ang Paglabas na Ito

Ang release na ito ay naglalaman ng mga sumusunod:

Zigbee stack
Framework ng Application ng Zigbee
Zigbee Sample Mga Aplikasyon

Para sa higit pang impormasyon tungkol sa Zigbee at ang EmberZNet SDK tingnan ang UG103.02: Zigbee Fundamentals. Kung ikaw ay isang unang beses na gumagamit, tingnan ang QSG180: Zigbee EmberZNet Quick-Start Guide para sa SDK 7.0 at Mas Mataas, para sa mga tagubilin sa pag-configure ng iyong development environment, pagbuo at pag-flash bilangample application, at mga sanggunian sa dokumentasyon na tumuturo sa mga karagdagang hakbang.

Pag-install at Paggamit
Ang Zigbee EmberZNet SDK ay ibinigay bilang bahagi ng Simplicity SDK, ang suite ng Silicon Labs SDKs. Upang mabilis na makapagsimula sa Simplicity SDK, i-install ang Simplicity Studio 5, na magse-set up sa iyong development environment at gagabay sa iyo sa pag-install ng Simplicity SDK. Kasama sa Simplicity Studio 5 ang lahat ng kailangan para sa pagbuo ng produkto ng IoT sa mga Silicon Labs na device, kabilang ang isang mapagkukunan at project launcher, mga tool sa pagsasaayos ng software, buong IDE na may GNU toolchain, at mga tool sa pagsusuri. Ang mga tagubilin sa pag-install ay ibinibigay sa online na Gabay sa Gumagamit ng Simplicity Studio 5. Bilang kahalili, ang Simplicity SDK ay maaaring manu-manong i-install sa pamamagitan ng pag-download o pag-clone ng pinakabago mula sa GitHub. Tingnan mo https://github.com/SiliconLabs/simplicity_sdk para sa karagdagang impormasyon. Ini-install ng Simplicity Studio ang Simplicity SDK bilang default sa:

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

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

Ang dokumentasyong partikular sa bersyon ng SDK ay naka-install sa SDK. Ang karagdagang impormasyon ay madalas na matatagpuan sa mga artikulo ng base ng kaalaman (KBA). Ang mga sanggunian ng API at iba pang impormasyon tungkol dito at ang mga naunang paglabas ay availableatn https://docs.silabs.com/.

Impormasyon sa Seguridad
Secure na Pagsasama ng Vault
Para sa mga application na pinipiling ligtas na mag-imbak ng mga susi gamit ang bahagi ng Secure Key Storage sa mga bahagi ng Secure Vault-High, ipinapakita ng sumusunod na talahanayan ang mga protektadong key at ang mga katangian ng proteksyon ng storage ng mga ito na pinamamahalaan ng bahagi ng Zigbee Security Manager.Ang mga nakabalot na key na minarkahan bilang "Non-Exportable" ay maaaring gamitin ngunit hindi maaaring gamitin viewed o ibinahagi sa runtime. Ang mga nakabalot na key na minarkahan bilang "Nai-export" ay maaaring gamitin o ibahagi sa runtime ngunit mananatiling naka-encrypt habang naka-imbak sa Flash. Ang mga application ng user ay hindi kailanman kailangang makipag-ugnayan sa karamihan ng mga key na ito. Ang mga umiiral nang API para pamahalaan ang mga key ng Link Key Table o Transient Keys ay available pa rin sa application ng user at na-route sa bahagi ng Zigbee Security Manager.

Mga Security Advisories
Para mag-subscribe sa Security Advisories, mag-log in sa Silicon Labs customer portal, pagkatapos ay piliin ang Account Home. I-click ang HOME upang pumunta sa home page ng portal at pagkatapos ay i-click ang tile na Pamahalaan ang Mga Notification. Siguraduhin na ang 'Software/Security Advisory Notice at Product Change Notice (PCNs)' ay naka-check, at ikaw ay naka-subscribe sa minimum para sa iyong platform at protocol. I-click ang I-save upang i-save ang anumang mga pagbabago.

Suporta
Ang mga customer ng Development Kit ay karapat-dapat para sa pagsasanay at teknikal na suporta. Gamitin ang Silicon Laboratories Zigbee web page upang makakuha ng impormasyon tungkol sa lahat ng produkto at serbisyo ng Silicon Labs Zigbee, at para mag-sign up para sa suporta sa produkto. Maaari kang makipag-ugnayan sa suporta ng Silicon Laboratories sa http://www.silabs.com/support.

Sertipikasyon ng Zigbee
Ang paglabas ng Ember ZNet 8.1 ay naging kwalipikado para sa Zigbee Compliant Platform para sa mga arkitektura ng SoC, NC, P, at RCP, mayroong ZCP certification ID na nakatali sa release na ito, pakitingnan ang CSA website dito:
https://csa-iot.org/csa-iot_products/.

Pakitandaan na ang ZCP certification ay filed i-post ang release, at tumatagal ng ilang linggo bago mapakita sa CSA website. Para sa anumang karagdagang katanungan, mangyaring makipag-ugnayan sa suporta ng Silicon Laboratories sa http://www.silabs.com/support.

Mga FAQ

T: Paano ko ia-update ang laki ng talahanayan ng APS link key sa SDK?
A: Maaaring i-configure ang laki ng talahanayan ng APS link key gamit ang SL_ZIGBEE_KEY_TABLE_SIZE parameter. Sa bersyon 8.1, pinalawak ito mula 127 hanggang 254 na mga entry.

Q: Ano ang mga pagpapahusay sa bersyon 8.1?
A: Ang Bersyon 8.1 ay nagdudulot ng mga pagpapahusay gaya ng pagpapalawak sa laki ng talahanayan ng key ng APS link, pagpapalit ng pangalan ng mga bahagi, pagdaragdag ng proteksyon ng mutex para sa queue ng event ng Athe pp Framework, at higit pa. Sumangguni sa mga tala sa paglabas para sa isang detalyadong listahan ng mga pagpapabuti.

T: Paano ko haharapin ang mga naayos na isyu sa SDK?
A: Inayos ang mga isyu sa SDK kabilang ang paglutas ng mga potensyal na problema sa configuration ng laki ng talahanayan ng kapitbahay, pagpapalit ng pangalan ng mga bahagi, pag-aayos ng overhead ng source na ruta, paghawak ng mga ZCL command, at higit pa. Tiyaking mag-a-update ka sa pinakabagong bersyon upang makinabang sa mga pag-aayos na ito.

Mga Dokumento / Mga Mapagkukunan

SILICON LABS Zigbee EmberZ Net SDK [pdf] Mga tagubilin
Zigbee EmberZ Net SDK, EmberZ Net SDK, Net SDK, SDK

Mga sanggunian

User Manual

SILICON LABS Zigbee EmberZ Net SDK

Mga pagtutukoy

Impormasyon ng Produkto