SILICON LABS Zigbee EmberZ Net SDK Leiðbeiningar

Silicon Labs er valinn söluaðili fyrir OEM sem þróa Zigbee net í vörur sínar. Silicon Labs Zigbee vettvangurinn er samþættasta, fullkomnasta og eiginleikaríkasta Zigbee lausnin sem völ er á. Silicon Labs EmberZNet SDK inniheldur útfærslu Silicon Labs á Zigbee stafla forskriftinni.

LYKILEIGNIR

Zigbee

-250+ færslur í APS tenglalyklatöflunni
ZigbeeD stuðningur á Android 12 (v21.0.6113669) og Tizen (v0.1-13.1)

xG26 Module stuðningur

Fjölsamskiptareglur

ZigbeeD og OTBR stuðningur á OpenWRT – GA
DMP BLE + CMP ZB & Matter/OT með samhliða hlustun á MG26 fyrir SoC – GA

802.15.4 Sameinað útvarpsáætlunarforgangsþáttur
Debian pökkunarstuðningur fyrir MP hýsingarforrit – Alpha

Nýir hlutir

Mikilvægar breytingar
Stærð APS tengilykilstöflunnar (stillt með SL_ZIGBEE_KEY_TABLE_SIZE) er stækkuð úr 127 í 254 færslur.

R23 stuðningur er bætt við fyrir ZDD Network gangsetningu virkni. Jarðgangavirkni er fáanleg án stuðnings fyrir Legacy Network notkunartilvik.

Netstýringin og Network Creator íhlutirnir hafa verið uppfærðir til að fela í sér stuðning við R23 tengingu. Þar á meðal eru eftirfarandi tengdar breytingar.
- Sjálfgefin Trust Center Link Key (TCLK) beiðnistefna hefur verið uppfærð til að búa til nýja lykla fyrir hvert tæki sem biður um. Nýr lykill er búinn til í hvert sinn sem tækin sem biðja um að reyna að uppfæra Trust Center Link Key þeirra.
- Vegna fyrri TCLK stefnubreytingar, þarf Network Creator öryggishlutinn núna öryggistengillykla íhlutinn. Uppfærsla forrita verður uppfærð til að vera í samræmi við þessa nýju kröfu.
- Ný uppsetning,
  SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY er bætt við til að leyfa tengingu með því að nota kjarna, kjötkátta lykil. Þessa stillingu er að finna undir Network Creator Security hluti. Notkun þessarar stefnu gerir hverju tæki sem tengist tengingu til að fá einstakt TCLK eftir tengingu, en endurteknar tilraunir til að uppfæra TCLK munu ekki leiða til nýs lykils fyrir tækið sem biður um. Þessi notkun á hashed hlekkjalykla var sjálfgefin regla fyrir þessa útgáfu og notkun þessarar stefnu gerir Trust Center kleift að forðast að koma með öryggistengillykla íhlutinn, sem vistar lykla í Flash.
  Athugið: Silicon Labs mælir ekki með notkun þessarar stefnu, þar sem þetta kemur í veg fyrir að tengitæki geti rúllað eða uppfært TCLKs þeirra.

Nýju stillingarsetti er bætt við íhlutinn zigbee_ezsp_spi til að leyfa stillingu á SPI vélbúnaðinum og pinnaviðmótum þess.
FyrrverandiampLe verkefni, þar á meðal verkefnið files (.slcps) og verkefnamöppu, eru endurnefnd í Silicon Labs nafnaleiðbeiningar og færðar undir „verkefni“ möppuna.

Stuðningur við nýjan vettvang

Nýjar einingar
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Nýjar útvarpstöflur
- MGM260P-RB4350A
- MGM260P-RB4351A
Nýr hluti
- efr32xg27
Explorer Kit
- BRD2709A
- MGM260P-EK2713A

Ný skjöl
Ný EZSP notendahandbók UG600 fyrir útgáfur 8.1 og nýrri.

Umbætur

SL_ZIGBEE_KEY_TABLE_SIZE takmörk stækkuð upp í 254 færslur.
Bætti zigbee_security_link_keys við Z3Light.
Bætti zigbee_security_link_keys við zigbee_mp_z3_tc_z3_tc. Uppfærði einnig stærð lykilborðsins.
Hækkaði stærð Z3 Gateway lyklaborðsins (sem verður stillt á ncp) í 20.

Föst mál

Þekkt vandamál í núverandi útgáfu

Feitletruð tölublöð voru bætt við frá fyrri útgáfu. Ef þú hefur misst af útgáfu eru nýlegar útgáfuskýringar aðgengilegar á https://www.silabs.com/developers/zigbee-emberznet í Tækniskjölum flipanum.

Úreltir hlutir

zigbee_watchdog_periodic_refresh íhluturinn er ekki lengur notaður í Zigbee forritsrammanum og er úreltur í þessari útgáfu. Varðhundatímamælirinn er sjálfgefið óvirkur fyrir allar sample umsóknir. Það verður bættur varðhundahluti bætt við SDK í framtíðinni.
Athugið: Virkjaðu varðhundatímamæli með stillingaratriði SL_LEGACY_HAL_DISABLE_WATCHDOG stillt á 0 í forritinu þínu

Nettakmarkanir og sjónarmið

Sjálfgefna Trust Center forritin sem fylgja með þessari EmberZNet útgáfu eru fær um að styðja nokkur tæki á netinu. Þessi tala er ákvörðuð út frá nokkrum þáttum, þar á meðal stilltum töflustærðum, NVM notkun og öðrum kynslóðartíma og keyrslutímagildum. Notendur sem leitast við að búa til stór netkerfi geta átt í vandræðum með auðlindir þegar þeir stækka netið stærra en forritið getur stutt. Til dæmisample, tæki sem biður um Trust Center tengilykil frá Trust Center gæti kallað sl_zigbee_af_zigbee_key_establishment_cb afturhringingu á Trust Center með h stöðu stillt á SL_ZIGBEE_KEY_TABLE_FULL, sem gefur til kynna að lyklaborðið hafi ekki pláss til að bæta við nýjum lykli fyrir tækið sem biður um eða að NVM3 hefur ekkert laust pláss. Silicon Labs veitir eftirfarandi ráðleggingar fyrir notendur sem vilja búa til stór net. Fyrir Trust Center forrit er mælt með eftirfarandi stillingum. Þessar ráðleggingar eru ekki tæmandi og þær þjóna sem grunnlína fyrir forrit sem ætla að stækka stór net.

Innifalið á aðfangatöfluhlutanum (zigbee_address_table), með
- SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE stillingaratriðið stillt á stærð viðkomandi netkerfis
- gildið SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE stillt á hámarkið (4)

Innifalið öryggistengillykla íhlutinn (zigbee_security_link_keys), með
- Gildið SL_ZIGBEE_KEY_TABLE_SIZE er stillt á stærð netsins
Eftirfarandi stillingaratriði eru stillt á stærð viðkomandi netkerfis
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, eins og er að finna í Zigbee Pro Stack íhlutnum
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, eins og er að finna í frumleiðarhlutanum, ef frumleiðin er notuð
Aðlögun á NVM3_DEFAULT_NVM_SIZE og NVM3_DEFAULT_CACHE_SIZE í samræmi við NVM3 notkun
- Td netstærðir stærri en 65 hnútar þurfa líklega NVM3 stærð upp á 64K. Sjálfgefin NVM3 stærð í Silicon Labs Zigbee sampLe umsóknir eru 32K. Forrit sem nota NVM meira gætu þurft að breyta þessu gildi enn hærra.
- Stór net allt að 65 hnútar gætu þurft NVM3 skyndiminni stærð 1200 bæti; að stækka net sem eru stærri en það gæti þurft að tvöfalda þetta gildi í 2400 bæti.

Þessar breytingar eiga aðeins við um traustsmiðstöðina

Multiprotocol Gateway og RCP

Nýir hlutir
Virkjað GA SoC stuðning fyrir BLE DMP með Zigbee + Openthread CMP með samhliða hlustun á xG26 hlutum. Debian alfa stuðningi hefur verið bætt við fyrir Zigbeed, OTBR og Z3Gateway forrit. Zigbeed og OTBR eru einnig í DEB pakkasniði fyrir valinn viðmiðunarvettvang (Raspberry PI 4). Sjáðu að keyra Zigbee, OpenThread og Bluetooth samtímis á Linux Host með Multiprotocol Co-processor, að finna á docs.silabs.com, fyrir nánari upplýsingar. Bætti við Zigbeed stuðningi fyrir Tizen-0.1-13.1 fyrir arm32 og aarch64 sem og Android 12 fyrir aarch64. Frekari upplýsingar um Zigbeed má finna á docs.silabs.com. Bætti við nýjum „802.15.4 Sameinað útvarpsáætlunarforgangi“ íhlutinn. Þessi hluti er notaður til að stilla útvarpsforgangsröðun 15.4 stafla. Íhluturinn þarf einnig nýja „radio_priority_configurator“ íhlutinn. Þessi hluti gerir verkefnum kleift að nota Radio Priority Configurator tólið í Simplicity Studio til að stilla útvarpsforgangsstig þeirra stafla sem krefjast þess.

Umbætur
Athugasemd um forrit Að keyra Zigbee, OpenThread og Bluetooth samtímis á Linux Host með Multiprotocol Co-Processor (AN1333) hefur verið flutt í docs.silabs.com. OpenWRT stuðningur er nú GA gæði. OpenWRT stuðningi hefur verið bætt við fyrir Zigbee, OTBR og Z3Gateway forrit. Zigbeed og OTBR eru einnig í IPK pakkasniði fyrir viðmiðunarvettvanginn (Raspberry PI 4). Sjáðu að keyra Zigbee, OpenThread og Bluetooth samtímis á Linux Host með Multiprotocol Co-processor, að finna á docs.silabs.com, fyrir nánari upplýsingar.

Föst mál

Þekkt vandamál í núverandi útgáfu
Feitletruð tölublöð voru bætt við frá fyrri útgáfu. Ef þú hefur misst af útgáfu eru nýlegar útgáfuskýringar fáanlegarhttps://www.silabs.com/developers/simplicity-software-development-kit.

Úreltir hlutir
„Multiprotocol Container“ sem er nú fáanlegur á DockerHub (siliconlabsinc/multiprotocol) verður úreltur í væntanlegri útgáfu. Gámurinn verður ekki lengur uppfærður og hægt að draga hann úr DockerHub. Debian-undirstaða pakkanna fyrir cpcd, ZigBee og ot-br-posix, ásamt innfæddum mynduðum og samsettum verkefnum, munu koma í stað virkni sem glataðist með því að fjarlægja ílátið.

Að nota þessa útgáfu

Þessi útgáfa inniheldur eftirfarandi:

Zigbee stafla
Zigbee umsóknarrammi
Zigbee Sample Forrit

Fyrir frekari upplýsingar um Zigbee og EmberZNet SDK sjá UG103.02: Zigbee Fundamentals. Ef þú ert í fyrsta skipti, sjá QSG180: Zigbee EmberZNet Quick-Start Guide fyrir SDK 7.0 og hærra, fyrir leiðbeiningar um að stilla þróunarumhverfið þitt, byggja og blikka semampumsókn, og tilvísanir í skjöl sem benda á næstu skref.

Uppsetning og notkun
Zigbee EmberZNet SDK er veitt sem hluti af Simplicity SDK, föruneyti Silicon Labs SDK. Til að byrja fljótt með Simplicity SDK skaltu setja upp Simplicity Studio 5, sem mun setja upp þróunarumhverfið þitt og leiða þig í gegnum Simplicity SDK uppsetninguna. Simplicity Studio 5 inniheldur allt sem þarf fyrir IoT vöruþróun með Silicon Labs tækjum, þar á meðal auðlinda- og verkefnaræsi, hugbúnaðarstillingarverkfæri, fullan IDE með GNU verkfærakeðju og greiningarverkfæri. Uppsetningarleiðbeiningar eru í nethandbók Simplicity Studio 5. Að öðrum kosti er hægt að setja Simplicity SDK upp handvirkt með því að hlaða niður eða klóna það nýjasta frá GitHub. Sjáðu https://github.com/SiliconLabs/simplicity_sdk fyrir frekari upplýsingar. Simplicity Studio setur upp Simplicity SDK sjálfgefið í:

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

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

Skjöl sem eru sértæk fyrir SDK útgáfuna eru sett upp með SDK. Viðbótarupplýsingar má oft finna í þekkingargrunnsgreinum (KBA). API tilvísanir og aðrar upplýsingar um þessa og fyrri útgáfur eru fáanlegar https://docs.silabs.com/.

Öryggisupplýsingar
Örugg Vault samþætting
Fyrir forrit sem velja að geyma lykla á öruggan hátt með því að nota Secure Key Storage íhlutinn á Secure Vault-High hlutum, sýnir eftirfarandi tafla vernduðu lyklana og geymsluverndareiginleika þeirra sem Zigbee Security Manager íhluturinn stjórnar.Vafðir lyklar sem eru merktir sem „Non-Exportable“ er hægt að nota en ekki viewed eða deilt á keyrslutíma. Vafðir lyklar sem eru merktir sem „Exportable“ er hægt að nota eða deila á keyrslutíma en haldast dulkóðaðir meðan þeir eru geymdir í Flash. Notendaforrit þurfa aldrei að hafa samskipti við meirihluta þessara lykla. Núverandi API til að stjórna Link Key Table lyklum eða tímabundnum lyklum eru enn tiltækar fyrir notendaforritið og eru nánast beint í gegnum Zigbee Security Manager íhlutinn.

Öryggisráðgjöf
Til að gerast áskrifandi að öryggisráðgjöf, skráðu þig inn á Silicon Labs viðskiptavinagáttina og veldu síðan Account Home. Smelltu á HEIM til að fara á heimasíðu gáttarinnar og smelltu síðan á Stjórna tilkynningar reitnum. Gakktu úr skugga um að hakað sé við „Hugbúnaðar-/öryggisráðgjafar og tilkynningar um vörubreytingar (PCN)“ og að þú sért að lágmarki áskrifandi að vettvangi þínum og samskiptareglum. Smelltu á Vista til að vista allar breytingar.

Stuðningur
Viðskiptavinir Þróunarsetts eiga rétt á þjálfun og tækniaðstoð. Notaðu Silicon Laboratories Zigbee web síðu til að fá upplýsingar um allar Silicon Labs Zigbee vörur og þjónustu, og til að skrá þig fyrir vöruaðstoð. Þú getur haft samband við þjónustudeild Silicon Laboratories á http://www.silabs.com/support.

Zigbee vottun
Ember ZNet 8.1 útgáfan hefur verið hæf fyrir Zigbee samhæfðan vettvang fyrir SoC, NC, P og RCP arkitektúr, það er ZCP vottunarauðkenni tengt þessari útgáfu, vinsamlegast athugaðu CSA websíða hér:
https://csa-iot.org/csa-iot_products/.

Vinsamlegast athugaðu að ZCP vottunin er filed birta útgáfuna og það tekur nokkrar vikur áður en það endurspeglast í CSA websíða. Fyrir frekari fyrirspurnir, vinsamlegast hafðu samband við þjónustudeild Silicon Laboratories á http://www.silabs.com/support.

Algengar spurningar

Sp.: Hvernig uppfæri ég stærð APS tengilykilstöflunnar í SDK?
A: Hægt er að stilla stærð APS tengilykilstöflunnar með því að nota SL_ZIGBEE_KEY_TABLE_SIZE færibreytuna. Í útgáfu 8.1 hefur það verið stækkað úr 127 í 254 færslur.

Sp.: Hverjar eru endurbæturnar í útgáfu 8.1?
Svar: Útgáfa 8.1 kemur með endurbætur eins og að stækka stærð APS tenglalyklatöflunnar, endurnefna íhluti, bæta við mutex vernd fyrir Athe pp Framework atburðarröð og fleira. Sjá útgáfuskýringar til að fá nákvæma lista yfir endurbætur.

Sp.: Hvernig á ég að höndla fast mál í SDK?
A: Lagaði vandamál í SDK, þar á meðal að leysa hugsanleg vandamál með stærð nágrannatöflustærðarstillingar, endurnefna íhluti, laga uppspretta leiðarkostnaðar, meðhöndla ZCL skipanir og fleira. Gakktu úr skugga um að þú uppfærir í nýjustu útgáfuna til að njóta góðs af þessum lagfæringum.

Skjöl / auðlindir

SILICON LABS Zigbee EmberZ Net SDK [pdfLeiðbeiningar
Zigbee EmberZ Net SDK, EmberZ Net SDK, Net SDK, SDK

Heimildir

Notendahandbók

SILICON LABS Zigbee EmberZ Net SDK

Tæknilýsing

Upplýsingar um vöru