SILICON LABS Zigbee EmberZ Net SDK instrukcijos

„Silicon Labs“ yra originalios įrangos gamintojų, kuriančių „Zigbee“ tinklus savo gaminiuose, pasirinkimo pardavėjas. Silicon Labs Zigbee platforma yra labiausiai integruotas, išsamiausias ir daug funkcijų turintis Zigbee sprendimas. „Silicon Labs EmberZNet“ SDK yra „Silicon Labs“ įdiegta „Zigbee“ kamino specifikacija.

PAGRINDINĖS SAVYBĖS

Zigbee

-250+ įrašų APS nuorodos raktų lentelėje
„ZigbeeD“ palaikymas „Android 12“ (v21.0.6113669) ir „Tizen“ (v0.1–13.1)

xG26 modulio palaikymas

Daugiaprotokolis

ZigbeeD ir OTBR palaikymas OpenWRT – GA
DMP BLE + CMP ZB & Matter/OT su lygiagrečiu klausymu MG26, skirta SoC – GA

802.15.4 Vieningo radijo planuotojo prioriteto komponentas
Debian pakuotės palaikymas MP prieglobos programoms – Alpha

Nauji daiktai

Svarbūs pakeitimai
APS nuorodos rakto lentelės dydis (sukonfigūruotas naudojant SL_ZIGBEE_KEY_TABLE_SIZE) padidintas nuo 127 iki 254 įrašų.

Pridėtas R23 palaikymas ZDD tinklo paleidimo funkcijai. Tuneliavimo funkcija pasiekiama nepalaikant senojo tinklo naudojimo atvejų.

Tinklo valdymo ir tinklo kūrėjo komponentai buvo atnaujinti, siekiant įtraukti R23 prisijungimo palaikymą. Tai apima šiuos susijusius pakeitimus.
- Numatytoji patikimumo centro nuorodos rakto (TCLK) užklausos politika buvo atnaujinta, kad būtų generuojami nauji raktai kiekvienam užklausą pateikusiam įrenginiui. Naujas raktas generuojamas kiekvieną kartą, kai užklausą pateikę įrenginiai bando atnaujinti savo patikimumo centro nuorodos raktą.
- Dėl ankstesnio TCLK politikos pakeitimo, Network Creator Security komponentui dabar reikalingas saugos nuorodos raktų komponentas. Programų atnaujinimas bus atnaujintas, kad atitiktų šį naują reikalavimą.
- Nauja konfigūracija,
  SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY pridėtas, kad būtų galima prisijungti naudojant pagrindinį, maišos raktą. Šią konfigūraciją rasite „Network Creator Security“ komponente. Naudodami šią politiką kiekvienas prisijungęs įrenginys gali gauti unikalų TCLK po prisijungimo, tačiau pakartotiniai bandymai atnaujinti TCLK nesukels naujo užklausos įrenginio rakto. Šis maišos nuorodų raktų naudojimas buvo numatytoji politika prieš šį leidimą, o šios strategijos naudojimas leidžia patikimumo centrui neįtraukti saugos nuorodų raktų komponento, kuris išsaugo raktus „Flash“.
  Pastaba: „Silicon Labs“ nerekomenduoja naudoti šios politikos, nes tai neleidžia jungiamiems įrenginiams paleisti arba atnaujinti savo TCLK.

Prie komponento zigbee_ezsp_spi pridedamas naujas konfigūracijos rinkinys, leidžiantis konfigūruoti pagrindinio SPI įrenginį ir jo kaiščių sąsajas.
Buvęsample projektus, įskaitant projektą files (.slcps) ir projekto aplankas pervadinami į „Silicon Labs“ pavadinimo gaires ir perkeliami į „projektų“ katalogą.

Naujos platformos palaikymas

Nauji moduliai
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Naujos radijo plokštės
- MGM260P-RB4350A
- MGM260P-RB4351A
Nauja dalis
- efr32xg27
Explorer rinkinys
- BRD2709A
- MGM260P-EK2713A

Nauja dokumentacija
Nauji EZSP vartotojo vadovai UG600, skirti 8.1 ir naujesnėms versijoms.

Patobulinimai

SL_ZIGBEE_KEY_TABLE_SIZE apribojimai išplėsti iki 254 įrašų.
Prie Z3Light pridėtas zigbee_security_link_keys.
Pridėta zigbee_security_link_keys prie zigbee_mp_z3_tc_z3_tc. Taip pat atnaujintas raktų lentelės dydis.
Z3 Gateway raktų lentelės dydis (kuris bus nustatytas į ncp) padidintas iki 20.

Išspręstos problemos

Žinomos problemos dabartiniame leidime

Paryškintu šriftu pažymėtos problemos buvo pridėtos nuo ankstesnio leidimo. Jei praleidote leidimą, naujausios leidimo pastabos pasiekiamos adresu https://www.silabs.com/developers/zigbee-emberznet skirtuke Tech Docs.

Nebenaudojami elementai

Komponentas „zigbee_watchdog_periodic_refresh“ nebenaudojamas „Zigbee“ programos sistemoje ir yra nebenaudojamas šiame leidime. Pagal numatytuosius nustatymus stebėjimo laikmatis yra išjungtas visoms sample paraiškas. Ateityje prie SDK bus pridėtas patobulintas stebėjimo komponentas.
Pastaba: įgalinkite stebėjimo laikmatį, kai jūsų programoje konfigūracijos elementas SL_LEGACY_HAL_DISABLE_WATCHDOG nustatytas į 0

Tinklo apribojimai ir svarstymai

Numatytosios patikimumo centro programos, pateiktos kartu su šiuo EmberZNet leidimu, gali palaikyti kelis tinklo įrenginius. Šis skaičius nustatomas atsižvelgiant į kelis veiksnius, įskaitant sukonfigūruotus lentelės dydžius, NVM naudojimą ir kitas generavimo laiko bei vykdymo laiko vertes. Vartotojai, norintys sukurti didelius tinklus, gali susidurti su išteklių problemomis, kai tinklas yra didesnis, nei gali palaikyti programa. Pavyzdžiui,ampĮrenginys, kuris iš patikimumo centro prašo patikimumo centro nuorodos rakto, gali suaktyvinti sl_zigbee_af_zigbee_key_establishment_cb atgalinį skambutį patikimumo centre, kai h būsena nustatyta į SL_ZIGBEE_KEY_TABLE_FULL, o tai rodo, kad raktų lentelėje nėra vietos pridėti prašymą pateikusio įrenginio arba naujo rakto. NVM3 nėra laisvos vietos. „Silicon Labs“ teikia šias rekomendacijas vartotojams, norintiems sukurti didelius tinklus. Patikimumo centro programoms rekomenduojamos šios konfigūracijos. Šios rekomendacijos nėra išsamios ir yra pagrindas programoms, kurios ketina plėsti didelius tinklus.

Adresų lentelės komponento (zigbee_address_table) įtraukimas su
- SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE konfigūracijos elementas nustatytas pagal norimo tinklo dydį
- SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE vertė nustatyta į maksimalią (4)

Saugos nuorodų raktų komponento (zigbee_security_link_keys) įtraukimas su
- SL_ZIGBEE_KEY_TABLE_SIZE reikšmė nustatyta pagal tinklo dydį
Šie konfigūracijos elementai nustatyti pagal norimo tinklo dydį
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, kaip rasta „Zigbee Pro Stack“ komponente
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, kaip rasta šaltinio maršruto parinkimo komponente, jei naudojamas šaltinio maršrutas
NVM3_DEFAULT_NVM_SIZE ir NVM3_DEFAULT_CACHE_SIZE koregavimas pagal NVM3 naudojimą
- Pavyzdžiui, didesniems nei 65 mazgų tinklo dydžiams greičiausiai reikalingas 3 KB NVM64 dydis. Numatytasis NVM3 dydis Silicon Labs Zigbee sampparaiškų skaičius yra 32 tūkst. Programoms, kurios naudoja NVM intensyviau, gali reikėti koreguoti šią vertę dar didesnę.
- Dideliems tinklams iki 65 mazgų gali prireikti 3 baitų NVM1200 talpyklos dydžio; augant tinklams, didesniems nei ši, gali reikėti padvigubinti šią vertę iki 2400 baitų.

Šie pakeitimai taikomi tik pasitikėjimo centrui

Kelių protokolų šliuzas ir RCP

Nauji daiktai
Įgalintas GA SoC palaikymas, skirtas BLE DMP su Zigbee + Openthread CMP kartu su xG26 dalių klausymu. Debian alfa palaikymas buvo pridėtas Zigbeed, OTBR ir Z3Gateway programoms. Zigbeed ir OTBR taip pat pateikiami DEB paketo formatu pasirinktai atskaitos platformai (Raspberry PI 4). Žr. „Zigbee“, „OpenThread“ ir „Bluetooth“ paleidimas vienu metu „Linux“ pagrindiniame kompiuteryje su kelių protokolų koprocesoriumi, kurį rasite adresu docs.silabs.com, norėdami sužinoti daugiau. Pridėtas Zigbeed palaikymas Tizen-0.1-13.1, skirtas arm32 ir aarch64, taip pat Android 12, skirtas aarch64. Daugiau informacijos apie Zigbeed galite rasti adresu docs.silabs.com. Pridėtas naujas komponentas „802.15.4 Unified Radio Planer priority“. Šis komponentas naudojamas 15.4 kamino radijo prioritetams konfigūruoti. Komponentui taip pat reikalingas naujas „radio_priority_configurator“ komponentas. Šis komponentas leidžia projektams naudoti „Simplicity Studio“ įrankį „Radio Priority Configurator“, kad būtų galima sukonfigūruoti krūvų, kuriems to reikia, radijo prioritetų lygius.

Patobulinimai
Programos pastaba „Zigbee“, „OpenThread“ ir „Bluetooth“ veikimas vienu metu „Linux“ pagrindiniame kompiuteryje su kelių protokolų koprocesoriumi (AN1333) buvo perkeltas į docs.silabs.com. OpenWRT palaikymas dabar yra GA kokybės. „Zigbee“, „OTBR“ ir „Z3Gateway“ programoms buvo pridėtas „OpenWRT“ palaikymas. Zigbeed ir OTBR taip pat pateikiami IPK paketo formatu etaloninei platformai (Raspberry PI 4). Žr. „Zigbee“, „OpenThread“ ir „Bluetooth“ paleidimas vienu metu „Linux“ pagrindiniame kompiuteryje su kelių protokolų koprocesoriumi, kurį rasite adresu docs.silabs.com, norėdami sužinoti daugiau.

Išspręstos problemos

Žinomos problemos dabartiniame leidime
Paryškintu šriftu pažymėtos problemos buvo pridėtos nuo ankstesnio leidimo. Jei praleidote leidimą, pateikiamos naujausios leidimo pastaboshttps://www.silabs.com/developers/simplicity-software-development-kit.

Nebenaudojami elementai
„Multiprotocol Container“, kuris šiuo metu pasiekiamas „DockerHub“ („siliconlabsinc“ / „multiprotocol“), bus nebenaudojamas būsimame leidime. Sudėtinis rodinys nebebus atnaujinamas ir gali būti paimtas iš „DockerHub“. „Debian“ pagrindu sukurti paketai, skirti cpcd, ZigBee ir ot-br-posix, kartu su savaime sugeneruotais ir sudarytais projektais pakeis funkcionalumą, prarastą pašalinus konteinerį.

Naudojant šį leidimą

Šiame leidime yra:

„Zigbee“ krūva
„Zigbee“ taikomųjų programų sistema
Zigbee Sample Programos

Daugiau informacijos apie Zigbee ir EmberZNet SDK rasite UG103.02: Zigbee Fundamentals. Jei naudojate pirmą kartą, žr. QSG180: „Zigbee EmberZNet“ greitos pradžios vadovas, skirtas SDK 7.0 ir naujesnėms versijoms, kur rasite instrukcijų, kaip konfigūruoti kūrimo aplinką, kurti ir atnaujinti kaipampprograma ir dokumentacijos nuorodos, nurodančios tolesnius veiksmus.

Įdiegimas ir naudojimas
„Zigbee EmberZNet SDK“ yra „Silicon Labs“ SDK rinkinio „Silicon Labs“ SDK dalis. Norėdami greitai pradėti naudotis Simplicity SDK, įdiekite Simplicity Studio 5, kuri nustatys jūsų kūrimo aplinką ir padės įdiegti Simplicity SDK. „Simplicity Studio 5“ apima viską, ko reikia IoT produktų kūrimui naudojant „Silicon Labs“ įrenginius, įskaitant išteklių ir projektų paleidimo priemonę, programinės įrangos konfigūravimo įrankius, visą IDE su GNU įrankių grandine ir analizės įrankius. Diegimo instrukcijos pateikiamos internetiniame Simplicity Studio 5 vartotojo vadove. Arba Simplicity SDK gali būti įdiegtas rankiniu būdu, atsisiunčiant arba klonuojant naujausią versiją iš GitHub. Žr https://github.com/SiliconLabs/simplicity_sdk Norėdami gauti daugiau informacijos. Simplicity Studio pagal numatytuosius nustatymus įdiegia Simplicity SDK:

(„Windows“): C:\Users\\SimplicityStudio\SDK\simplicity_sdk

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

SDK versijai būdinga dokumentacija įdiegiama kartu su SDK. Papildomos informacijos dažnai galima rasti žinių bazės straipsniuose (KBA). API nuorodos ir kita informacija apie šią ir ankstesnes versijas yra prieinama https://docs.silabs.com/.

Saugumo informacija
Saugus saugyklos integravimas
Programoms, kurios pasirenka saugiai saugoti raktus naudojant Secure Key Storage komponentą Secure Vault-High dalyse, šioje lentelėje rodomi apsaugoti raktai ir jų saugojimo apsaugos charakteristikos, kurias valdo Zigbee Security Manager komponentas.Supakuoti raktai, pažymėti kaip „Neeksportuojami“, gali būti naudojami, bet negali būti viewredaguojama arba bendrinama vykdymo metu. Supakuoti raktai, pažymėti kaip „Eksportuotini“, gali būti naudojami arba bendrinami vykdymo metu, tačiau jie lieka užšifruoti, kol saugomi „Flash“. Vartotojo programoms niekada nereikia sąveikauti su dauguma šių raktų. Esamos API, skirtos tvarkyti nuorodų raktų lentelės raktus arba pereinamuosius raktus, vis dar yra pasiekiamos vartotojo programai, o per „Zigbee Security Manager“ komponentą gali būti nukreipta nedaug.

Saugos patarimai
Norėdami užsiprenumeruoti saugos patarimus, prisijunkite prie „Silicon Labs“ klientų portalo, tada pasirinkite „Paskyros puslapis“. Spustelėkite PAGRINDINIS, kad eitumėte į portalo pagrindinį puslapį, tada spustelėkite plytelę Tvarkyti pranešimus. Įsitikinkite, kad pažymėta parinktis „Programinės įrangos / saugos įspėjamieji pranešimai ir produkto keitimo pranešimai (PCN)“ ir kad esate užsiprenumeravę bent savo platformą ir protokolą. Spustelėkite Išsaugoti, kad išsaugotumėte pakeitimus.

Palaikymas
„Development Kit“ klientai turi teisę į mokymus ir techninę pagalbą. Naudokite Silicon Laboratories Zigbee web puslapį, kad gautumėte informacijos apie visus „Silicon Labs Zigbee“ produktus ir paslaugas bei prisiregistruotumėte dėl produktų palaikymo. Galite susisiekti su Silicon Laboratories palaikymo tarnyba adresu http://www.silabs.com/support.

Zigbee sertifikatas
„Ember ZNet 8.1“ leidimas atitinka „Zigbee“ suderinamumo platformą, skirtą SoC, NC, P ir RCP architektūroms, su šia versija susietas ZCP sertifikavimo ID, patikrinkite CSA websvetainė čia:
https://csa-iot.org/csa-iot_products/.

Atkreipkite dėmesį, kad ZCP sertifikatas yra filed paskelbti leidimą ir užtrunka kelias savaites, kol bus atsižvelgta į CSA websvetainę. Jei turite daugiau klausimų, susisiekite su „Silicon Laboratories“ palaikymo komanda adresu http://www.silabs.com/support.

DUK

K: Kaip atnaujinti APS nuorodos rakto lentelės dydį SDK?
A: APS nuorodos rakto lentelės dydį galima konfigūruoti naudojant parametrą SL_ZIGBEE_KEY_TABLE_SIZE. 8.1 versijoje ji buvo išplėsta nuo 127 iki 254 įrašų.

K: Kokie yra 8.1 versijos patobulinimai?
A: 8.1 versijoje yra patobulinimų, pvz., APS nuorodos raktų lentelės dydžio išplėtimas, komponentų pervadinimas, Athe pp Framework įvykių eilės mutex apsauga ir kt. Išsamų patobulinimų sąrašą rasite leidimo pastabose.

Kl.: Kaip spręsti ištaisytas SDK problemas?
A: Ištaisytos SDK problemos, įskaitant galimų problemų, susijusių su kaimyninės lentelės dydžio konfigūracijos, sprendimą, komponentų pervadinimą, šaltinio maršruto papildomų išlaidų taisymą, ZCL komandų tvarkymą ir kt. Įsitikinkite, kad atnaujinote į naujausią versiją, kad gautumėte naudos iš šių pataisymų.

Dokumentai / Ištekliai

SILICON LABS Zigbee EmberZ Net SDK [pdfInstrukcijos
Zigbee EmberZ Net SDK, EmberZ Net SDK, Net SDK, SDK

Nuorodos

Vartotojo vadovas

SILICON LABS Zigbee EmberZ Net SDK

Specifikacijos

Informacija apie produktą