SILICON LABS Zigbee EmberZ Net SDK juhised

Silicon Labs on originaalseadmete tootjate valikmüüja, kes arendavad oma toodeteks Zigbee võrku. Silicon Labs Zigbee platvorm on kõige integreeritum, terviklikum ja funktsioonirikkaim Zigbee lahendus. Silicon Labsi EmberZNet SDK sisaldab Silicon Labsi Zigbee virna spetsifikatsiooni rakendamist.

PÕHIOMADUSED

Zigbee

-250+ kirjet APS-i lingivõtmete tabelis
ZigbeeD tugi operatsioonisüsteemides Android 12 (v21.0.6113669) ja Tizen (v0.1–13.1)

xG26 mooduli tugi

Multiprotokoll

ZigbeeD ja OTBR tugi OpenWRT – GA-s
DMP BLE + CMP ZB & Matter/OT koos samaaegse kuulamisega MG26-l SoC – GA jaoks

802.15.4 Ühtne raadioplaneerija prioriteetkomponent
Debiani pakkimise tugi MP hostirakendustele – Alpha

Uued esemed

Olulised muudatused
APS-i lingivõtme tabeli suurust (konfigureeritud SL_ZIGBEE_KEY_TABLE_SIZE abil) suurendatakse 127-lt 254-le.

R23 tugi on lisatud ZDD võrgu kasutuselevõtu funktsioonidele. Tunneldamisfunktsioonid on saadaval ilma pärandvõrgu kasutusjuhtude toetamiseta.

Võrgujuhtimise ja võrgulooja komponente on värskendatud, et lisada R23-ga liitumise tugi. Nende hulka kuuluvad järgmised seotud muudatused.
- Usalduskeskuse lingivõtme (TCLK) vaikepäringupoliitikat on värskendatud, et luua iga taotleva seadme jaoks uued võtmed. Uus võti genereeritakse iga kord, kui taotlevad seadmed üritavad oma usalduskeskuse lingivõtit värskendada.
- Eelmise TCLK poliitika muudatuse tõttu vajab Network Creator Security komponent nüüd komponenti Turvalingi võtmed. Rakenduste täiendamist värskendatakse, et see vastaks sellele uuele nõudele.
- Uus konfiguratsioon,
  SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY on lisatud, et võimaldada räsivõtmega liitumist. Selle konfiguratsiooni leiate komponendi Network Creator Security alt. Selle reegli kasutamine võimaldab igal liituval seadmel saada kordumatu TCLK pärast liitumist, kuid korduvad katsed TCLK-d värskendada ei too taotleva seadme jaoks uut võtit. See räsitud lingivõtmete kasutamine oli vaikepoliitika enne seda väljaannet ja selle reegli kasutamine võimaldab usalduskeskusel vältida turvalingivõtmete komponendi toomist, mis salvestab võtmed Flashi.
  Märkus: Silicon Labs ei soovita seda poliitikat kasutada, kuna see takistab seadmete ühendamist või nende TCLK-de värskendamist.

Komponendile zigbee_ezsp_spi lisatakse uus konfiguratsioonikomplekt, mis võimaldab konfigureerida hosti SPI-seadet ja selle pin-liideseid.
Endineample projektid, sealhulgas projekt files (.slcps) ja projektikaust nimetatakse ümber Silicon Labsi nimetamisjuhisteks ja teisaldatakse kataloogi "projektid".

Uue platvormi tugi

Uued moodulid
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Uued raadioplaadid
- MGM260P-RB4350A
- MGM260P-RB4351A
Uus osa
- efr32xg27
Exploreri komplekt
- BRD2709A
- MGM260P-EK2713A

Uus dokumentatsioon
Uus EZSP kasutajajuhend UG600 versioonide 8.1 ja uuemate versioonide jaoks.

Täiustused

SL_ZIGBEE_KEY_TABLE_SIZE limiiti laiendati kuni 254 kirjeni.
Lisati Z3Lightile zigbee_security_link_keys.
zigbee_security_link_keys lisati failile zigbee_mp_z3_tc_z3_tc. Uuendati ka võtmetabeli suurust.
Suurendati Z3 Gateway võtmetabeli suurust (selleks määratakse ncp) 20-ni.

Parandatud probleemid

Teadaolevad probleemid praeguses väljaandes

Paksus kirjas olevad probleemid on lisatud alates eelmisest väljaandest. Kui teil on mõni väljalase vahele jäänud, on hiljutised väljalaskemärkmed saadaval aadressil https://www.silabs.com/developers/zigbee-emberznet vahekaardil Tech Docs.

Aegunud üksused

Komponenti zigbee_watchdog_periodic_refresh Zigbee rakendusraamistikus enam ei kasutata ja see on selles versioonis aegunud. Valvekoera taimer on vaikimisi kõigi s-ide jaoks keelatudample rakendusi. Tulevikus lisatakse SDK-le täiustatud valvekoera komponent.
Märkus: lubage valvekoera taimer, kui konfiguratsiooniüksus SL_LEGACY_HAL_DISABLE_WATCHDOG on teie rakenduses seatud väärtusele 0

Võrgupiirangud ja kaalutlused

Selle EmberZNeti väljalaskega kaasas olevad usalduskeskuse vaikerakendused on võimelised toetama mitut võrgus olevat seadet. See arv määratakse mitme teguri, sealhulgas konfigureeritud tabeli suuruse, NVM-i kasutuse ja muude genereerimisaja ja käitusaja väärtuste põhjal. Kasutajad, kes soovivad luua suuri võrke, võivad silmitsi seista ressursiprobleemidega, kui suurendate võrku suuremaks, kui rakendus suudab toetada. NäiteksampKui seade, mis taotleb usalduskeskuselt usalduskeskuse lingi võtit, võib käivitada usalduskeskuses sl_zigbee_af_zigbee_key_establishment_cb tagasihelistamise, mille h olek on seatud SL_ZIGBEE_KEY_TABLE_FULL, mis näitab, et võtmetabelil ei ole ruumi taotleva seadme või uue võtme lisamiseks. NVM3-l pole vaba ruumi. Silicon Labs pakub järgmisi soovitusi kasutajatele, kes soovivad luua suuri võrke. Usalduskeskuse rakenduste jaoks on soovitatavad järgmised konfiguratsioonid. Need soovitused ei ole ammendavad ja need on aluseks rakendustele, mis kavatsevad suuri võrke kasvatada.

Aadressite tabeli komponendi (zigbee_address_table) kaasamine koos
- konfiguratsiooniüksus SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE on seatud soovitud võrgu suurusele
- SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE väärtus on seatud maksimumile (4)

Turvalingi võtmete komponendi (zigbee_security_link_keys) kaasamine koos
- SL_ZIGBEE_KEY_TABLE_SIZE väärtus on seatud võrgu suurusele
Järgmised konfiguratsioonielemendid on seatud soovitud võrgu suurusele
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, nagu leiti Zigbee Pro Stacki komponendist
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, nagu on leitud allika marsruutimise komponendist, kui kasutatakse allika marsruutimist
NVM3_DEFAULT_NVM_SIZE ja NVM3_DEFAULT_CACHE_SIZE kohandamine vastavalt NVM3 kasutamisele
- Näiteks võrgud, mis on suuremad kui 65 sõlme, nõuavad tõenäoliselt NVM3 suurust 64K. Vaikimisi NVM3 suurus rakenduses Silicon Labs Zigbee samptaotluste arv on 32 XNUMX. Rakendused, mis kasutavad rohkem NVM-i, võivad vajada selle väärtuse veelgi suuremaks muutmist.
- Suured kuni 65 sõlmega võrgud võivad vajada NVM3 vahemälu suurust 1200 baiti; sellest suuremate võrkude puhul võib olla vaja selle väärtuse kahekordistamist 2400 baidini.

Need kohandused kehtivad ainult usalduskeskusele

Multiprotocol Gateway ja RCP

Uued esemed
Lubatud GA SoC tugi BLE DMP jaoks koos Zigbee + Openthread CMP-ga koos xG26 osade samaaegse kuulamisega. Zigbeedi, OTBR-i ja Z3Gateway rakenduste jaoks on lisatud Debiani alfa tugi. Zigbeed ja OTBR on saadaval ka valitud võrdlusplatvormi (Raspberry PI 4) jaoks DEB-paketi vormingus. Vaadake jaotist Zigbee, OpenThreadi ja Bluetoothi samaaegne käitamine Linuxi hostil koos mitmeprotokollilise kaasprotsessoriga, mille leiate aadressilt docs.silabs.com, üksikasju. Lisatud on Zigbeedi tugi Tizen-0.1-13.1 jaoks arm32 ja aarch64 jaoks ning Android 12 jaoks aarch64 jaoks. Lisateavet Zigbeedi kohta leiate aadressilt docs.silabs.com. Lisati uus komponent "802.15.4 Unified Radio Scheder priority". Seda komponenti kasutatakse 15.4 virna raadio prioriteetide konfigureerimiseks. Komponent nõuab ka uut "radio_priority_configurator" komponenti. See komponent võimaldab projektidel kasutada Simplicity Studio tööriista Radio Priority Configurator, et konfigureerida seda vajavate virnade raadio prioriteeditasemeid.

Täiustused
Rakenduse märkus Zigbee, OpenThreadi ja Bluetoothi samaaegne käitamine mitmeprotokollilise kaasprotsessoriga Linuxi hostil (AN1333) on teisaldatud asukohta docs.silabs.com. OpenWRT tugi on nüüd GA kvaliteediga. OpenWRT tugi on lisatud Zigbee, OTBR ja Z3Gateway rakendustele. Zigbeed ja OTBR on saadaval ka IPK paketivormingus võrdlusplatvormi (Raspberry PI 4) jaoks. Vaadake jaotist Zigbee, OpenThreadi ja Bluetoothi samaaegne käitamine Linuxi hostil koos mitmeprotokollilise kaasprotsessoriga, mille leiate aadressilt docs.silabs.com, üksikasju.

Parandatud probleemid

Teadaolevad probleemid praeguses väljaandes
Paksus kirjas olevad probleemid on lisatud alates eelmisest väljaandest. Kui teil on mõni väljalase vahele jäänud, on värsked väljalaskemärkmed saadavalhttps://www.silabs.com/developers/simplicity-software-development-kit.

Aegunud üksused
"Multiprotocol Container", mis on praegu DockerHubis saadaval (siliconlabsinc/multiprotocol), kaotatakse eelseisvas versioonis. Konteinerit enam ei värskendata ja seda saab DockerHubist tõmmata. Debianil põhinevad paketid cpcd, ZigBee ja ot-br-posix jaoks koos algselt loodud ja kompileeritud projektidega asendavad konteineri eemaldamisega kaotatud funktsioonid.

Selle väljalase kasutamine

See väljaanne sisaldab järgmist:

Zigbee virn
Zigbee rakendusraamistik
Zigbee Sample Rakendused

Zigbee ja EmberZNet SDK kohta lisateabe saamiseks vaadake UG103.02: Zigbee Fundamentals. Kui kasutate esimest korda, vaadake jaotist QSG180: Zigbee EmberZNet Quick-Start Guide for SDK 7.0 ja uuemad versioonid, et saada juhiseid arenduskeskkonna konfigureerimiseks, loomiseks ja välgutamiseksamprakendus ja viited dokumentatsioonile, mis osutavad edasistele sammudele.

Paigaldamine ja kasutamine
Zigbee EmberZNet SDK on saadaval Silicon Labsi SDK-de komplekti Simplicity SDK osana. Simplicity SDK-ga kiireks alustamiseks installige Simplicity Studio 5, mis seadistab teie arenduskeskkonna ja juhendab teid Simplicity SDK installimisel. Simplicity Studio 5 sisaldab kõike, mida Silicon Labsi seadmetega IoT tootearenduseks vaja, sealhulgas ressursside ja projekti käivitajat, tarkvara konfiguratsioonitööriistu, täielikku IDE-d koos GNU tööriistaahelaga ja analüüsitööriistu. Paigaldusjuhised leiate veebipõhisest Simplicity Studio 5 kasutusjuhendist. Teise võimalusena võib Simplicity SDK installida käsitsi, laadides alla või kloonides GitHubist uusima versiooni. Vaata https://github.com/SiliconLabs/simplicity_sdk lisateabe saamiseks. Simplicity Studio installib Simplicity SDK vaikimisi järgmistesse kohtadesse:

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

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

SDK versioonile spetsiaalne dokumentatsioon installitakse koos SDK-ga. Lisateavet leiate sageli teadmistebaasi artiklitest (KBA). API viited ja muu teave selle ja varasemate versioonide kohta on saadaval https://docs.silabs.com/.

Turvateave
Turvaline võlvi integreerimine
Rakenduste puhul, mis otsustavad võtmeid turvaliselt salvestada, kasutades Secure Vault-High osade komponenti Secure Key Storage, on järgmises tabelis näidatud kaitstud võtmed ja nende salvestuskaitse omadused, mida Zigbee Security Manageri komponent haldab.Pakitud võtmeid, mis on märgistatud kui „Ei eksporditav”, saab kasutada, kuid mitte viewredigeeritud või käitusajal jagatud. Pakitud võtmeid, mis on märgistatud kui „Eksporditav”, saab käitamise ajal kasutada või jagada, kuid need jäävad Flashi salvestamise ajal krüpteerituks. Kasutajarakendused ei pea enamuse nende võtmetega kunagi suhtlema. Olemasolevad API-liidesed lingivõtmetabeli võtmete või ajutiste võtmete haldamiseks on endiselt kasutajarakendusele saadaval ja neid saab suunata läbi Zigbee Security Manageri komponendi.

Turvameetmed
Turvanõuannete tellimiseks logige sisse Silicon Labsi kliendiportaali ja valige seejärel Konto avaleht. Portaali avalehele minemiseks klõpsake AVALEHT ja seejärel paani Märguannete haldamine. Veenduge, et valik „Tarkvara/turvalisuse teatised ja tootemuudatuste teatised (PCN-id)” on märgitud ning et olete oma platvormi ja protokolli jaoks vähemalt tellinud. Muudatuste salvestamiseks klõpsake nuppu Salvesta.

Toetus
Arenduskomplekti klientidel on õigus saada koolitust ja tehnilist tuge. Kasutage Silicon Laboratories Zigbee web lehel, et saada teavet kõigi Silicon Labs Zigbee toodete ja teenuste kohta ning registreeruda tootetoe saamiseks. Silicon Laboratoriesi toega saate ühendust võtta aadressil http://www.silabs.com/support.

Zigbee sertifikaat
Ember ZNet 8.1 väljalase on kvalifitseeritud Zigbee ühilduva platvormi jaoks SoC-, NC-, P- ja RCP-arhitektuuride jaoks, selle versiooniga on seotud ZCP sertifitseerimise ID. Kontrollige CSA-d websait siin:
https://csa-iot.org/csa-iot_products/.

Pange tähele, et ZCP sertifikaat on filed postitada väljalase ja kulub paar nädalat, enne kui CSA-s kajastatakse websaidile. Täiendavate küsimuste korral võtke ühendust Silicon Laboratoriesi toega aadressil http://www.silabs.com/support.

KKK-d

K: Kuidas värskendada SDK-s APS-i lingivõtme tabeli suurust?
V: APS-i lingivõtme tabeli suurust saab konfigureerida parameetri SL_ZIGBEE_KEY_TABLE_SIZE abil. Versioonis 8.1 on seda laiendatud 127-lt 254-le.

K: Millised on versiooni 8.1 täiustused?
V: Versioon 8.1 sisaldab täiustusi, nagu APS-i lingivõtmete tabeli suuruse suurendamine, komponentide ümbernimetamine, Athe pp Frameworki sündmuste järjekorrale mutex-kaitse lisamine ja palju muud. Täiustuste üksikasjaliku loendi leiate väljalaskemärkmetest.

K: Kuidas käsitleda SDK-s fikseeritud probleeme?
V: Parandatud probleemid SDK-s, sealhulgas võimalike probleemide lahendamine naabertabeli suuruse konfigureerimisega, komponentide ümbernimetamine, lähtemarsruudi üldkulude parandamine, ZCL-käskude käsitlemine ja palju muud. Nendest parandustest kasu saamiseks värskendage kindlasti uusimale versioonile.

Dokumendid / Ressursid

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

Viited

Kasutusjuhend

SILICON LABS Zigbee EmberZ Net SDK

Tehnilised andmed

Tooteteave