SILICON LABS Zigbee EmberZ Net SDK Instruksyon

Ang Silicon Labs mao ang tigbaligya sa kapilian alang sa mga OEM nga nagpalambo sa Zigbee networking sa ilang mga produkto. Ang Silicon Labs Zigbee nga plataporma mao ang pinaka-integrated, kompleto, ug adunahan sa feature nga Zigbee nga solusyon nga anaa. Ang Silicon Labs EmberZNet SDK naglangkob sa pagpatuman sa Silicon Labs sa espesipikasyon sa Zigbee stack.

HINUNGDANONG MGA KINAHANGLAN

Zigbee

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

Suporta sa xG26 Module

Multiprotocol

ZigbeeD ug OTBR suporta sa OpenWRT - GA
DMP BLE + CMP ZB & Matter/OT nga adunay Kadungan nga Pagpamati sa MG26 para sa SoC - GA

802.15.4 Nahiusa nga radio scheduler priority component
Suporta sa packaging sa Debian alang sa mga aplikasyon sa host sa MP - Alpha

Bag-ong mga butang

Importante nga mga Pagbag-o
Ang gidak-on sa lamesa sa APS link key (gi-configure gamit ang SL_ZIGBEE_KEY_TABLE_SIZE) gipalapdan gikan sa 127 ngadto sa 254 ka mga entry.

Gidugang ang suporta sa R23 alang sa pag-andar sa pag-komisyon sa ZDD Network. Anaa ang pagpaandar sa tunneling nga walay suporta para sa mga kaso sa paggamit sa Legacy Network.

Ang mga sangkap sa Network Steering ug Network Creator gi-update aron maapil ang suporta sa pag-apil sa R23. Kini naglakip sa mosunod nga may kalabutan nga mga kausaban.
- Ang default nga Trust Center Link Key (TCLK) nga palisiya sa hangyo gi-update aron makamugna og bag-ong mga yawe alang sa matag naghangyo nga device. Usa ka bag-ong yawe ang mamugna sa matag higayon nga ang nangayo nga mga aparato mosulay sa pag-update sa ilang Trust Center Link Key.
- Tungod sa miaging pagbag-o sa palisiya sa TCLK, ang sangkap sa Network Creator Security karon nanginahanglan sa sangkap sa Security Link Keys. Ang pag-upgrade sa mga aplikasyon i-update aron masunod kining bag-ong kinahanglanon.
- Bag-ong configuration,
  Ang SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY gidugang aron tugotan ang pag-apil gamit ang usa ka kinauyokan, hash nga yawe. Kini nga configuration makita ubos sa Network Creator Security component. Ang paggamit niini nga polisiya nagtugot sa matag apil nga device nga makadawat og talagsaon nga TCLK post-join, apan ang balik-balik nga pagsulay sa pag-update sa TCLK dili moresulta sa bag-ong yawe alang sa naghangyo nga device. Kini nga paggamit sa mga hash nga link nga mga yawe mao ang default nga palisiya sa wala pa kini nga pagpagawas, ug ang paggamit niini nga palisiya nagtugot sa Trust Center sa paglikay sa pagdala sa Security Link Keys component, nga nagtipig sa mga yawe sa Flash.
  Nota: Wala girekomenda sa Silicon Labs ang paggamit niini nga polisiya, tungod kay kini nagpugong sa pag-apil sa mga himan gikan sa pagligid, o pag-update, sa ilang mga TCLK.

Usa ka bag-ong set sa configuration ang gidugang sa component nga zigbee_ezsp_spi aron tugotan ang configuration sa host SPI device ug ang mga pin interface niini.
Ang exampmga proyekto, lakip ang proyekto files (.slcps) ug folder sa proyekto, giilisan sa ngalan sa Silicon Labs nga mga giya sa pagngalan ug gibalhin ubos sa direktoryo nga "mga proyekto".

Bag-ong Platform nga Suporta

Bag-ong mga modyul
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Bag-ong mga radio board
- MGM260P-RB4350A
- MGM260P-RB4351A
Bag-ong bahin
- efr32xg27
Explorer Kit
- BRD2709A
- MGM260P-EK2713A

Bag-ong Dokumentasyon
Usa ka bag-o nga EZSP user giya UG600 alang sa pagpagawas 8.1 ug sa ibabaw.

Mga kalamboan

Ang mga limitasyon sa SL_ZIGBEE_KEY_TABLE_SIZE gipalapdan hangtod sa 254 ka mga entry.
Gidugang ang zigbee_security_link_keys sa Z3Light.
Gidugang ang zigbee_security_link_keys sa zigbee_mp_z3_tc_z3_tc. Gi-update usab ang gidak-on sa key table niini.
Gidugangan ang gidak-on sa lamesa sa Z3 Gateway key (nga itakda sa ncp) ngadto sa 20.

Giayo nga mga Isyu

Nailhan nga mga Isyu sa Kasamtangang Pagpagawas

Ang mga isyu sa bold gidugang sukad sa miaging pagpagawas. Kung nasipyat ka sa usa ka pagpagawas, ang bag-o nga mga nota sa pagpagawas anaa sa https://www.silabs.com/developers/zigbee-emberznet sa tab nga Tech Docs.

Wala na gamita nga mga Butang

Ang zigbee_watchdog_periodic_refresh component wala na gigamit sa Zigbee application framework ug wala na gamita niini nga release. Ang watchdog timer gi-disable pinaagi sa default alang sa tanan nga sampmga aplikasyon. Adunay usa ka gipaayo nga sangkap sa pagbantay nga idugang sa SDK sa umaabot.
Nota: I-enable ang watchdog timer nga adunay configuration item SL_LEGACY_HAL_DISABLE_WATCHDOG set sa 0 sa imong aplikasyon

Mga Limitasyon ug Mga Konsiderasyon sa Network

Ang default nga Trust Center nga mga aplikasyon nga gipadala uban niining pagpagawas sa EmberZNet makahimo sa pagsuporta sa daghang mga himan sa network. Kini nga numero gitino base sa daghang mga hinungdan, lakip ang gi-configure nga mga gidak-on sa lamesa, paggamit sa NVM, ug uban pang mga kantidad sa oras sa henerasyon ug oras sa pagdagan. Ang mga tiggamit nga nagtinguha sa paghimo og dagkong mga network mahimong mag-atubang sa mga isyu sa kahinguhaan kung modako ang network nga mas dako kaysa masuportahan sa aplikasyon. Kay example, usa ka device nga nangayo og Trust Center Link Key gikan sa Trust Center mahimong mag-trigger og sl_zigbee_af_zigbee_key_establishment_cb callback sa Trust Center nga adunay h status nga gitakda sa SL_ZIGBEE_KEY_TABLE_FULL, nga nagpakita nga ang key table walay luna aron makadugang ug bag-ong yawe para sa nangayo nga device o kanang NVM3. Ang Silicon Labs naghatag sa mosunod nga mga rekomendasyon alang sa mga tiggamit nga nagtinguha sa paghimo og dagkong mga network. Para sa mga aplikasyon sa Trust Center, girekomendar ang mosunod nga mga configuration. Kini nga mga rekomendasyon dili kompleto, ug kini nagsilbi nga baseline alang sa mga aplikasyon nga nagtinguha nga motubo ang dagkong mga network.

Paglakip sa bahin sa Address Table (zigbee_address_table), uban sa
- ang SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE configuration item nga gitakda sa gidak-on sa gusto nga network
- ang SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE nga bili gitakda sa pinakataas (4)

Paglakip sa bahin sa Security Link Keys (zigbee_security_link_keys), uban sa
- Ang SL_ZIGBEE_KEY_TABLE_SIZE nga kantidad gitakda sa gidak-on sa network
Ang mosunod nga mga butang sa pag-configure gitakda sa gidak-on sa gusto nga network
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, nga makita sa Zigbee Pro Stack component
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, nga makita sa Source routing component, kung gigamit ang source routing
Pag-adjust sa NVM3_DEFAULT_NVM_SIZE ug NVM3_DEFAULT_CACHE_SIZE sumala sa paggamit sa NVM3
- Eg network gidak-on labaw pa kay sa 65 nodes lagmit nagkinahanglan sa usa ka NVM3 gidak-on sa 64K. Ang default nga gidak-on sa NVM3 sa Silicon Labs Zigbee sampAng mga aplikasyon kay 32K. Ang mga aplikasyon nga naggamit sa NVM nga mas bug-at mahimong magkinahanglan og pag-adjust niini nga kantidad nga mas taas pa.
- Ang dagkong mga network hangtod sa 65 ka node mahimong magkinahanglan ug NVM3 nga gidak-on sa cache nga 1200 bytes; Ang nagtubo nga mga network nga mas dako kaysa niana mahimong magkinahanglan pagdoble niini nga kantidad sa 2400 bytes.

Kini nga mga kausaban magamit lamang sa Trust Center

Multiprotocol Gateway ug RCP

Bag-ong mga butang
Gipaandar ang suporta sa GA SoC alang sa BLE DMP nga adunay Zigbee + Openthread CMP nga adunay dungan nga pagpaminaw sa xG26 nga mga bahin. Ang suporta sa Debian alpha gidugang alang sa mga aplikasyon sa Zigbeed, OTBR, ug Z3Gateway. Ang Zigbeed ug OTBR gihatag sa DEB package format alang sa pinili nga reference platform (Raspberry PI 4) usab. Tan-awa ang Nagdagan nga Zigbee, OpenThread, ug Bluetooth nga Duyog sa Linux Host nga adunay Multiprotocol Co-Processor, makita sa docs.silabs.com, para sa mga detalye. Gidugang ang suporta sa Zigbeed alang sa Tizen-0.1-13.1 alang sa arm32 ug aarch64 ingon man ang Android 12 alang sa aarch64. Dugang nga impormasyon sa Zigbeed makita sa docs.silabs.com. Gidugang ang bag-ong "802.15.4 Unified radio scheduler priority" component. Kini nga sangkap gigamit sa pag-configure sa mga prayoridad sa radyo sa usa ka 15.4 stack. Ang component nagkinahanglan usab sa bag-ong "radio_priority_configurator" component. Kini nga sangkap nagtugot sa mga proyekto sa paggamit sa Radio Priority Configurator nga himan sa Simplicity Studio aron ma-configure ang mga lebel sa prayoridad sa radyo sa mga stack nga nagkinahanglan niini.

Mga kalamboan
Nota sa aplikasyon Ang Pagdagan sa Zigbee, OpenThread, ug Bluetooth nga Duyog sa Linux Host nga adunay Multiprotocol Co-Processor (AN1333) gibalhin sa docs.silabs.com. Ang suporta sa OpenWRT kay kalidad na sa GA. Gidugang ang suporta sa OpenWRT alang sa mga aplikasyon sa Zigbee, OTBR, ug Z3Gateway. Gihatag ang Zigbeed ug OTBR sa format nga pakete sa IPK alang sa reference platform (Raspberry PI 4) usab. Tan-awa ang Nagdagan nga Zigbee, OpenThread, ug Bluetooth nga Duyog sa Linux Host nga adunay Multiprotocol Co-Processor, makita sa docs.silabs.com, para sa mga detalye.

Giayo nga mga Isyu

Nailhan nga mga Isyu sa Kasamtangang Pagpagawas
Ang mga isyu sa bold gidugang sukad sa miaging pagpagawas. Kung nasipyat ka sa usa ka pagpagawas, ang bag-o nga mga nota sa pagpagawas anaa oathttps://www.silabs.com/developers/simplicity-software-development-kit.

Wala na gamita nga mga Butang
Ang "Multiprotocol Container" nga anaa karon sa DockerHub (siliconlabsinc/multiprotocol) dili na magamit sa umaabot nga pagpagawas. Ang sudlanan dili na ma-update ug makuha gikan sa DockerHub. Ang mga pakete nga nakabase sa Debian alang sa cpcd, ZigBee, ug ot-br-posix, kauban ang mga lumad nga namugna ug gihugpong nga mga proyekto, mopuli sa nawala nga gamit sa pagtangtang sa sudlanan.

Gigamit Kini nga Pagpagawas

Kini nga pagpagawas naglangkob sa mosunod:

Zigbee stack
Framework sa Aplikasyon sa Zigbee
Zigbee Sample Mga Aplikasyon

Para sa dugang nga impormasyon bahin sa Zigbee ug sa EmberZNet SDK tan-awa ang UG103.02: Zigbee Fundamentals. Kung first-time user ka, tan-awa ang QSG180: Zigbee EmberZNet Quick-Start Guide para sa SDK 7.0 ug Higher, para sa mga instruksyon sa pag-configure sa imong development environment, building ug flashing asampaplikasyon, ug mga pakisayran sa dokumentasyon nga nagpunting sa mga dugang nga lakang.

Pag-instalar ug Paggamit
Ang Zigbee EmberZNet SDK gihatag isip kabahin sa Simplicity SDK, ang suite sa Silicon Labs SDKs. Aron dali nga makasugod sa Simplicity SDK, i-install ang Simplicity Studio 5, nga mag-set up sa imong development environment ug mogiya kanimo pinaagi sa Simplicity SDK installation. Ang Simplicity Studio 5 naglakip sa tanan nga gikinahanglan alang sa IoT product development uban sa Silicon Labs device, lakip ang usa ka resource ug project launcher, software configuration tools, full IDE uban sa GNU toolchain, ug analysis tools. Ang mga panudlo sa pag-install gihatag sa online nga Giya sa Gumagamit sa Simplicity Studio 5. Sa laing bahin, ang Simplicity SDK mahimong i-install sa mano-mano pinaagi sa pag-download o pag-clone sa pinakabag-o gikan sa GitHub. Tan-awa https://github.com/SiliconLabs/simplicity_sdk para sa dugang impormasyon. Ang Simplicity Studio nag-install sa Simplicity SDK pinaagi sa default sa:

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

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

Ang dokumentasyon nga espesipiko sa SDK nga bersyon gi-install sa SDK. Ang dugang nga impormasyon sagad makita sa mga artikulo sa base sa kahibalo (KBAs). Ang mga reperensiya sa API ug uban pang impormasyon bahin niini ug ang naunang mga pagpagawas anaa sa https://docs.silabs.com/.

Impormasyon sa Seguridad
Luwas nga Vault Integration
Para sa mga aplikasyon nga mopili sa pagtipig sa mga yawe nga luwas gamit ang Secure Key Storage component sa Secure Vault-High nga mga bahin, ang mosunod nga talaan nagpakita sa giprotektahan nga mga yawe ug sa ilang storage protection nga mga kinaiya nga gidumala sa Zigbee Security Manager component.Ang giputos nga mga yawe nga gimarkahan nga "Non-Exportable" mahimong magamit apan dili mahimo viewed o gipaambit sa runtime. Ang giputos nga mga yawe nga gimarkahan nga "Ma-export" mahimong gamiton o ipaambit sa runtime apan magpabilin nga naka-encrypt samtang gitipigan sa Flash. Ang mga aplikasyon sa tiggamit dili kinahanglan nga makig-uban sa kadaghanan niini nga mga yawe. Ang kasamtangan nga mga API aron sa pagdumala sa Link Key Table nga mga yawe o Transient Keys anaa gihapon sa aplikasyon sa user ug hapit na madala pinaagi sa Zigbee Security Manager component.

Mga Security Advisories
Para mag-subscribe sa Security Advisories, log in sa Silicon Labs customer portal, unya pilia ang Account Home. I-klik ang HOME aron makaadto sa portal home page ug dayon i-klik ang Manage Notifications tile. Siguruha nga ang 'Software/Security Advisory Notice ug Product Change Notice (PCNs)' gisusi, ug nga ikaw naka-subscribe sa minimum para sa imong plataporma ug protocol. I-klik ang Save aron i-save ang bisan unsang mga pagbag-o.

Suporta
Ang mga kostumer sa Development Kit angayan alang sa pagbansay ug teknikal nga suporta. Gamita ang Silicon Laboratories Zigbee web panid aron makakuha og impormasyon bahin sa tanang produkto ug serbisyo sa Silicon Labs Zigbee, ug para magpalista para sa suporta sa produkto. Mahimo nimong kontakon ang suporta sa Silicon Laboratories sa http://www.silabs.com/support.

Sertipikasyon sa Zigbee
Ang Ember ZNet 8.1 nga pagpagawas nahimong kwalipikado alang sa Zigbee Compliant Platform para sa SoC, NC, P, ug RCP nga mga arkitektura adunay ZCP certification ID nga nahigot niini nga pagpagawas, palihug susiha ang CSA website dinhi:
https://csa-iot.org/csa-iot_products/.

Palihug timan-i nga ang ZCP certification kay filed i-post ang pagpagawas, ug molungtad og pipila ka semana sa dili pa mapakita sa CSA website. Alang sa bisan unsang dugang nga mga pangutana, palihug kontaka ang suporta sa Silicon Laboratories sa http://www.silabs.com/support.

Mga FAQ

P: Unsaon nako pag-update sa gidak-on sa lamesa sa APS link key sa SDK?
A: Ang APS link key nga gidak-on sa lamesa mahimong ma-configure gamit ang SL_ZIGBEE_KEY_TABLE_SIZE parameter. Sa bersyon 8.1, gipalapdan kini gikan sa 127 ngadto sa 254 ka mga entry.

Q: Unsa ang mga kalamboan sa bersyon 8.1?
A: Ang Bersyon 8.1 nagdala og mga pag-uswag sama sa pagpalapad sa gidak-on sa lamesa sa APS link key, pag-ilis sa ngalan sa mga component, pagdugang og proteksyon sa mutex alang sa Athe pp Framework event queue, ug uban pa. Tan-awa ang mga nota sa pagpagawas alang sa usa ka detalyado nga lista sa mga pagpaayo.

P: Unsaon nako pagdumala ang mga fixed nga isyu sa SDK?
A: Giayo nga mga isyu sa SDK lakip na ang pagsulbad sa mga potensyal nga problema sa pag-configure sa gidak-on sa lamesa sa silingan, pagbag-o sa ngalan sa mga sangkap, pag-ayo sa gigikanan nga ruta sa ibabaw, pagdumala sa mga mando sa ZCL, ug uban pa. Siguruha nga mag-update ka sa labing bag-ong bersyon aron makabenepisyo gikan sa kini nga mga pag-ayo.

Mga Dokumento / Mga Kapanguhaan

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

Mga pakisayran

Manwal sa Gumagamit

SILICON LABS Zigbee EmberZ Net SDK

Mga detalye

Impormasyon sa Produkto