SILICON-LABS-logo

SILICON LABS Zigbee EmberZ Net SDK

SILICON-LABS-Zigbee-EmberZ-Net-SDK-oloa

Fa'amatalaga

  • Zigbee EmberZNet SDK Version: 8.1 GA
  • Faigofie SDK Suite Version: 2024.12.0
  • Aso Fa'asalalau: Tesema 16, 2024
  • Fa'aopoopo Fa'atasi: GCC version 12.2.1
  • EZSP Protocol Version: 0x10

Fa'amatalaga o oloa

Silicon Labs o le tagata faʻatau filifiliga mo OEM e atiaʻe fesoʻotaiga Zigbee i totonu oa latou oloa. O le Silicon Labs Zigbee platform o le fofo sili ona tu'ufa'atasia, atoatoa, ma fa'atama'ia Zigbee avanoa. O le Silicon Labs EmberZNet SDK o lo'o iai le fa'atinoga a le Silicon Labs o le fa'asologa o fa'aputuga Zigbee.

UIGA AUTU

Zigbee

  • -250+ fa'amaumauga i le laulau ki feso'ota'iga APS
  • Lagolago ZigbeeD ile Android 12 (v21.0.6113669) ma Tizen (v0.1-13.1)
  • xG26 Module lagolago

Teleprotocol

  • ZigbeeD ma le OTBR lagolago ile OpenWRT - GA
  • DMP BLE + CMP ZB & Matter/OT ma Fa'alogo Fa'atasi ile MG26 mo SoC - GA
  • 802.15.4 Tu'ufa'atasi fa'asologa o leitio vaega fa'amuamua
  • Debian afifiina lagolago mo MP talimalo talosaga - Alpha

Mea fou

Suiga Taua
Ole lapo'a ole laulau ki feso'ota'iga APS (fa'atonu ile SL_ZIGBEE_KEY_TABLE_SIZE) ua fa'alautele mai le 127 i le 254 fa'amaumauga.

  • O lo'o fa'aopoopoina le lagolago R23 mo galuega fa'atino a le ZDD Network. O lo'o avanoa le tunele e aunoa ma se lagolago mo le Legacy Network fa'aoga mataupu.
  • Ua toe fa'afou vaega o le Network Steering ma Network Creator e aofia ai le lagolago mo le tu'ufa'atasia o le R23. E aofia ai suiga fa'atatau nei.
    • Ua toe faafou le tulafono ole talosaga ole Trust Center Link Key (TCLK) e maua ai ni ki fou mo masini talosaga taitasi. E fau se ki fou i taimi uma e taumafai ai masini talosaga e fa'afou a latou Trust Center Link Key.
    • Ona o le suiga o faiga faavae a le TCLK talu ai, o le vaega o le Network Creator Security ua manaʻomia nei le vaega Security Link Keys. O le a fa'afou le fa'aleleia o talosaga ina ia fa'amalieina i lenei mana'oga fou.
    • O se faatulagaga fou,
      SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY ua fa'aopoopoina e fa'ataga ai le fa'aogaina e fa'aaoga ai se ki fa'aulu. O lenei fa'atulagaga o lo'o maua i lalo ole vaega ole Network Creator Security. O le fa'aogaina o lenei faiga fa'avae e mafai ai e masini fa'apipi'i ta'itasi ona maua se TCLK tu'ufa'atasi pe a uma ona tu'ufa'atasia, ae o taumafaiga fa'aauau e fa'afou le TCLK e le maua ai se ki fou mo le masini talosaga. O le fa'aogaina o ki so'otaga fa'asao o le faiga fa'aletonu lea a'o le'i fa'amatu'u, ma o le fa'aogaina o lenei faiga fa'avae e mafai ai e le Trust Center ona 'alofia le aumaia o le vaega Security Link Keys, lea e fa'asaoina ai ki i le Flash.
      Manatua: Silicon Labs e le fautuaina le faʻaogaina o lenei faiga faʻavae, aua e taofia ai le tuʻufaʻatasia o masini mai le taʻavale, poʻo le faʻafouina, a latou TCLKs.
  • Ua fa'aopoopoina se seti fa'aopoopo fou i le vaega zigbee_ezsp_spi e fa'ataga ai le fa'atulagaina o le masini SPI talimalo ma ona fa'aoga pine.
  • O le example poloketi, e aofia ai le poloketi files (.slcps) ma le faila o le poloketi, ua toe faʻaigoaina i Silicon Labs faʻaigoaina taʻiala ma faʻagasolo i lalo o le "poloketi" directory.

Fesoasoani Fou Platform

  • Module fou
    • MGM260PD32VNA2
    • MGM260PD32VNN2
    • MGM260PD22VNA2
    • MGM260PB32VNA5
    • MGM260PB32VNN5
    • MGM260PB22VNA5
    • BGM260PB22VNA2
    • BGM260PB32VNA2
    • Leitio laupapa fou
    • MGM260P-RB4350A
    • MGM260P-RB4351A
  • Vaega fou
    • efr32xg27
  • Taga su'esu'e
    • BRD2709A
    • MGM260P-EK2713A

Fa'amaumauga Fou
E ta'ita'ia e se tagata fou EZSP le UG600 mo fa'asalalauga 8.1 ma luga atu.

Fa'aleleia

  • SL_ZIGBEE_KEY_TABLE_SIZE tapula'a fa'alautele i le 254 fa'amaumauga.
  • Fa'aopoopo zigbee_security_link_keys i le Z3Light.
  • Fa'aopoopo zigbee_security_link_keys i le zigbee_mp_z3_tc_z3_tc. Fa'afou fo'i lona lapo'a laulau autu.
  • Faʻateleina le laulau ki Z3 Gateway (o le a seti i le ncp) i le 20.

Mataupu Fa'amau

SILICON-LABS-Zigbee-EmberZ-Net-SDK-fig- (1)SILICON-LABS-Zigbee-EmberZ-Net-SDK-fig- (2)SILICON-LABS-Zigbee-EmberZ-Net-SDK-fig- (3)SILICON-LABS-Zigbee-EmberZ-Net-SDK-fig- (4)SILICON-LABS-Zigbee-EmberZ-Net-SDK-fig- (5)SILICON-LABS-Zigbee-EmberZ-Net-SDK-fig- (6)SILICON-LABS-Zigbee-EmberZ-Net-SDK-fig- (7)SILICON-LABS-Zigbee-EmberZ-Net-SDK-fig- (8)SILICON-LABS-Zigbee-EmberZ-Net-SDK-fig- (9)

Fa'afitauli Ta'uta'ua i le Fa'asalalauga i le taimi nei

O fa'afitauli i le mata'utia na fa'aopoopoina talu mai le fa'asalalauga muamua. Afai ua e misia se fa'asalalauga, fa'amatalaga fa'amatalaga lata mai o lo'o avanoa ile https://www.silabs.com/developers/zigbee-emberznet i le Tech Docs tab.SILICON-LABS-Zigbee-EmberZ-Net-SDK-fig- (10)SILICON-LABS-Zigbee-EmberZ-Net-SDK-fig- (11)SILICON-LABS-Zigbee-EmberZ-Net-SDK-fig- (12)SILICON-LABS-Zigbee-EmberZ-Net-SDK-fig- (13)SILICON-LABS-Zigbee-EmberZ-Net-SDK-fig- (14)SILICON-LABS-Zigbee-EmberZ-Net-SDK-fig- (15)SILICON-LABS-Zigbee-EmberZ-Net-SDK-fig- (16)

Mea ua le toe faaaogaina

  • O le vaega o le zigbee_watchdog_periodic_refresh ua le o toe fa'aogaina i totonu o le fa'atulagaga o talosaga a le Zigbee ma ua le toe fa'aaogaina i lenei fa'asalalauga. Ua fa'aletonu le taimi o le watchdog ona o le faaletonu mo s umaample talosaga. O le a iai se vaega e fa'aleleia atili ai le leoleo e fa'aopoopo i le SDK i le lumana'i.
  • Manatua: Fa'afeso'ota'i le taimi e va'ava'ai ai ma mea fa'atulaga SL_LEGACY_HAL_DISABLE_WATCHDOG seti i le 0 i lau talosaga.

Tapulaa ma Manatuga o Fesootaiga

O talosaga a le Trust Center e le mafai ona fa'aulu mai ma lenei fa'asalalauga EmberZNet e mafai ona lagolagoina le tele o masini i luga o feso'otaiga. O lenei numera e faʻamoemoeina e faʻavae i luga o le tele o mea, e aofia ai le faʻatulagaina o laulau, faʻaogaina o le NVM, ma isi faʻasologa o taimi ma taimi taʻavale. O tagata fa'aoga o lo'o taumafai e fa'atupu feso'otaiga tetele e ono feagai ma fa'afitauli o puna'oa pe a fa'atuputeleina le feso'ota'iga lapo'a nai lo le mea e mafai ona lagolagoina e le talosaga. Mo example, o se masini e talosagaina se Trust Center Link Key mai le Trust Center e ono fa'aosoina se sl_zigbee_af_zigbee_key_establishment_cb callback i luga o le Trust Center ma le h tulaga ua seti i le SL_ZIGBEE_KEY_TABLE_FULL, e fa'aalia ai e leai se avanoa o le laulau ki e fa'aopoopo ai se ki fou mo le masini talosaga po'o lena. NVM3 e leai se avanoa avanoa. Silicon Labs o loʻo tuʻuina atu fautuaga nei mo tagata faʻaoga e saili e fausia ni fesoʻotaʻiga tetele. Mo talosaga a le Trust Center, o fa'atonuga nei e fautuaina. O nei fautuaga e le'o atoatoa, ma e fai ma fa'avae mo talosaga e fa'amoemoe e fa'atupuina feso'otaiga tetele.

  • Fa'aaofia ai le vaega o le Laulautusi Tuatusi (zigbee_address_table), ma
    • le SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE mea fa'atulagaina seti i le tele o feso'otaiga mana'omia
    • o le SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE tau ua seti i le maualuga (4)
  • Fa'aofiina o le vaega Security Link Keys (zigbee_security_link_keys), ma
    • Ole tau ole SL_ZIGBEE_KEY_TABLE_SIZE ua seti ile tele ole feso'ota'iga
  • O mea fa'atulagaina o lo'o i lalo o lo'o fa'atulaga i le tele o feso'ota'iga mana'omia
    • SL_ZIGBEE_BROADCAST_TABLE_SIZE, e pei ona maua i le vaega Zigbee Pro Stack
    • SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, e pei ona maua i le vaega Fa'aalaala Puna, pe a fa'aogaina le fa'aala ala
  • Fetuuna'iga o le NVM3_DEFAULT_NVM_SIZE ma le NVM3_DEFAULT_CACHE_SIZE e tusa ai ma le NVM3 fa'aoga
    • Fa'ata'ita'iga, o lapopoa o feso'ota'iga e sili atu i le 65 pona e ono mana'omia se NVM3 tele ole 64K. Ole tele ole NVM3 ile Silicon Labs Zigbee sampO talosaga e 32K. O talosaga e fa'aoga tele le NVM e ono mana'omia le fetu'una'i o lenei tau e sili atu.
    • O fesoʻotaʻiga tetele e oʻo atu i le 65 nodes atonu e manaʻomia se NVM3 cache tele o 1200 bytes; fa'ateleina feso'ota'iga lapo'a nai lo lena e ono mana'omia le fa'aluaina o lenei tau i le 2400 paita.

O nei suiga e fa'atatau ile Trust Center

Multiprotocol Gateway ma RCP

Mea fou
Fa'ataga GA SoC lagolago mo le BLE DMP fa'atasi ma le Zigbee + Openthread CMP fa'atasi ma le fa'alogo fa'atasi i vaega xG26. Debian alpha support ua faʻaopoopoina mo Zigbeed, OTBR, ma Z3Gateway talosaga. Zigbeed ma le OTBR o loʻo tuʻuina atu i le DEB package format mo le faʻailoga filifilia (Raspberry PI 4) faʻapea foʻi. Va'ai Fa'agaoioi le Zigbee, OpenThread, ma le Bluetooth Fa'atasi ile Linux Host ma se Multiprotocol Co-Processor, maua ile docs.silabs.com, mo fa'amatalaga. Faʻaopoopo le lagolago a Zigbeed mo Tizen-0.1-13.1 mo le arm32 ma le aarch64 faʻapea foʻi ma le Android 12 mo le aarch64. E mafai ona maua nisi fa'amatalaga ile Zigbeed ile docs.silabs.com. Fa'aopoopoina le vaega fou "802.15.4 Fa'amuamua le fa'atulagaina o leitio fa'atasi". O lenei vaega e faʻaaogaina e faʻapipiʻi ai le leitio faʻamuamua o le 15.4 stack. E mana'omia fo'i e le vaega le vaega fou "radio_priority_configurator". O lenei vaega e mafai ai e galuega faatino ona fa'aogaina le Radio Priority Configurator tool i le Simplicity Studio e fa'atulaga ai tulaga fa'amuamua leitio o fa'aputuga e mana'omia.

Fa'aleleia
Fa'amatalaga Fa'amatalaga Fa'agaoioi le Zigbee, OpenThread, ma le Bluetooth Fa'atasi i luga o se Linux Host ma se Multiprotocol Co-Processor (AN1333) ua siitia i le docs.silabs.com. Ole lagolago OpenWRT ole GA lelei. Ua faaopoopo le lagolago OpenWRT mo talosaga Zigbee, OTBR, ma Z3Gateway. Zigbeed ma le OTBR o loʻo tuʻuina atu i le IPK faʻapipiʻi faʻapipiʻi mo le faʻamatalaga faʻavae (Raspberry PI 4) faʻapea foʻi. Va'ai le Fa'agaoioi ole Zigbee, OpenThread, ma le Bluetooth Fa'atasi ile Linux Host ma se Multiprotocol Co-Processor, maua ile docs.silabs.com, mo fa'amatalaga.

Mataupu Fa'amauSILICON-LABS-Zigbee-EmberZ-Net-SDK-fig- (17)

Fa'afitauli Ta'uta'ua i le Fa'asalalauga i le taimi nei
O fa'afitauli i le mata'utia na fa'aopoopoina talu mai le fa'asalalauga muamua. Afai ua e misia se fa'asalalauga, o fa'amatalaga lata mai o lo'o maua oathttps://www.silabs.com/developers/simplicity-software-development-kit.SILICON-LABS-Zigbee-EmberZ-Net-SDK-fig- (18)

Mea ua le toe faaaogaina
O le "Multiprotocol Container" lea o loʻo avanoa nei i luga o DockerHub (siliconlabsinc/multiprotocol) o le a faʻaumatia i se faʻasalalauga lata mai. O le atigipusa o le a le toe faʻafouina ma mafai ona toso mai DockerHub. O afifi fa'avae Debian mo cpcd, ZigBee, ma ot-br-posix, fa'atasi ai ma galuega fa'atupuina ma tu'ufa'atasia, o le a suia ai galuega na leiloa i le aveeseina o le koneteina.

Fa'aaogaina Lenei Fa'asalalauga

O lenei fa'asalalauga e iai mea nei:

  • Zigbee faaputuga
  • Ta'iala Talosaga Zigbee
  • Zigbee Sample Talosaga

Mo nisi fa'amatalaga e uiga i le Zigbee ma le EmberZNet SDK va'ai UG103.02: Zigbee Fundamentals. Afai o oe o se tagata fa'aoga muamua, va'ai QSG180: Zigbee EmberZNet Quick-Start Guide mo SDK 7.0 ma Higher, mo fa'atonuga i le fa'atulagaina o lou si'osi'omaga atina'e, fau ma emoample talosaga, ma fa'amaumauga fa'amaumauga e fa'asino i la'asaga fa'aopoopo.

Fa'apipi'i ma Fa'aoga
O le Zigbee EmberZNet SDK o loʻo tuʻuina atu o se vaega o le Simplicity SDK, o le seti o Silicon Labs SDKs. Ina ia vave amata i le Simplicity SDK, faʻapipiʻi le Simplicity Studio 5, lea o le a faʻatutuina lau siosiomaga atinaʻe ma savali oe ile Simplicity SDK installation. Simplicity Studio 5 e aofia ai mea uma e manaʻomia mo le atinaʻeina o oloa a le IoT ma masini Silicon Labs, e aofia ai se punaoa ma le faʻalauiloaina o galuega, meafaigaluega faʻapipiʻi polokalame, IDE atoa ma le GNU toolchain, ma meafaigaluega auʻiliʻili. O faʻatonuga faʻapipiʻi o loʻo tuʻuina atu i luga ole initaneti Simplicity Studio 5 User's Guide. I le isi itu, o le Simplicity SDK e mafai ona faʻapipiʻiina ma le lima e ala i le laʻuina pe faʻapipiʻi le mea fou mai GitHub. Vaai https://github.com/SiliconLabs/simplicity_sdk mo nisi faamatalaga. Simplicity Studio fa'apipi'i le Simplicity SDK e ala i le faaletonu ile:

  • (Pupuni): C:\Users\\SimplicityStudio\SDKs\simplicity_sdk
  • (MacOS): /Users//SimplicityStudio/SDKs/simplicity_sdk

O fa'amaumauga fa'apitoa i le SDK version o lo'o fa'apipi'iina i le SDK. O fa'amatalaga fa'aopoopo e masani ona maua i tusitusiga fa'avae malamalama (KBAs). O fa'amatalaga API ma isi fa'amatalaga e uiga i lenei ma fa'asalalauga muamua o lo'o avanoa i https://docs.silabs.com/.

Fa'amatalaga Puipuiga
Puipuiga Vault Integration
Mo talosaga e filifili e teu lelei ki e fa'aaoga ai le vaega Secure Key Storage i vaega Secure Vault-High, o le siata o lo'o i lalo o lo'o fa'aalia ai ki puipuia ma latou uiga puipuia o le teuina o lo'o pulea e le vaega o le Zigbee Security Manager.SILICON-LABS-Zigbee-EmberZ-Net-SDK-fig- (19)O ki afifi ua faailogaina o le "E le mafai ona auina atu i fafo" e mafai ona faaaoga ae le mafai viewed po'o fa'asoa ile taimi fa'agaoioiga. O ki afifi o lo'o fa'ailogaina o le "Exportable" e mafai ona fa'aoga pe fa'asoa ile taimi fa'agasolo ae tumau fa'ailoga a'o teuina ile Flash. E le mana'omia lava ona fegalegaleai le tele o nei ki. O lo'o avanoa pea API o lo'o iai nei e fa'atautaia ai Ki Laulau Laulau Feso'ota'i po'o Ki Transient i le fa'aoga o lo'o fa'aogaina ma e seasea fa'asolo atu ile vaega ole Zigbee Security Manager.

Faufautua mo Saogalemu
Ina ia lesitala i Fautuaga Puipuiga, ulufale i totonu o le Silicon Labs tagata faʻatau faitotoa, ona filifili lea o le Account Home. Kiliki le HOME e alu i le faitotoa o le itulau autu ona kiliki lea o le Manage Notifications tile. Ia mautinoa o 'Software/Security Advisory Notice & Product Change Notice (PCNs)' ua siaki, ma o lo'o e lesitala i lalo mo lau faʻasalalauga ma faʻasalalauga. Kiliki Save e teu ai so'o se suiga.SILICON-LABS-Zigbee-EmberZ-Net-SDK-fig- (20)

Lagolago
O tagata fa'atau Atina'e Kit e agava'a mo a'oa'oga ma fesoasoani fa'apitoa. Fa'aaoga le Silicon Laboratories Zigbee web itulau e maua ai fa'amatalaga e uiga i oloa ma auaunaga uma a Silicon Labs Zigbee, ma ia sainia mo le lagolago o oloa. E mafai ona e fa'afeso'ota'i le lagolago a Silicon Laboratories ile http://www.silabs.com/support.

Zigbee Tusipasi
O le Ember ZNet 8.1 faʻasalalauga ua agavaa mo Zigbee Compliant Platform mo SoC, NC, P, ma RCP architectures o loʻo i ai se ID faʻamaonia ZCP e fesoʻotaʻi ma lenei faʻasalalauga, faʻamolemole siaki le CSA webnofoaga iinei:
https://csa-iot.org/csa-iot_products/.

Faamolemole ia matau o le ZCP tusipasi o filed fa'asalalauina le fa'asalalauga, ma fa'aalu ni nai vaiaso a'o le'i fa'aalia ile CSA webnofoaga. Mo nisi fesili, fa'amolemole fa'afeso'ota'i le lagolago a Silicon Laboratories ile http://www.silabs.com/support.

FAQs

F: E fa'afefea ona ou fa'afou le tele o le laulau ki feso'ota'iga APS i le SDK?
A: E mafai ona fetu'una'i le lapo'a o le laulau ki feso'ota'i APS e fa'aoga ai le fa'ailoga SL_ZIGBEE_KEY_TABLE_SIZE. I le version 8.1, ua faʻalauteleina mai le 127 i le 254 faʻamaumauga.

Q: O a faʻaleleia i le version 8.1?
A: Fa'aliliuga 8.1 e aumaia fa'alelei e pei o le fa'alauteleina o le tele o le laulau ki feso'ota'iga APS, toe fa'aigoaina o vaega, fa'aopoopo le puipuiga mutex mo Athe pp Framework event queue, ma isi mea. Va'ai i fa'amatalaga fa'asalalauga mo se lisi auiliili o fa'aleleia.

F: E fa'afefea ona ou taulimaina fa'afitauli tumau ile SDK?
A: Fa'amautu fa'afitauli i le SDK e aofia ai le fo'ia o fa'afitauli e ono tula'i mai i le lapopo'a o laulau tuaoi, toe fa'aigoaina o vaega, fa'apipi'i ala ala i luga, fa'afoeina o tulafono a le ZCL, ma isi mea. Ia mautinoa e te fa'afou i le lomiga lata mai e manuia ai mai nei fa'aleleia.

Pepa / Punaoa

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

Fa'asinomaga

Tuu se faamatalaga

E le fa'asalalauina lau tuatusi imeli. Fa'ailogaina fanua mana'omia *