SILICON LABS Zigbee EmberZ Net SDK
Manylebau
- Zigbee EmberZNet SDK Fersiwn: 8.1 GA
- Symlrwydd SDK Fersiwn Suite: 2024.12.0
- Dyddiad cyhoeddi: 16 Rhagfyr, 2024
- Casglwyr Cydnaws: Fersiwn GCC 12.2.1
- Fersiwn Protocol EZSP: 0x10
Gwybodaeth Cynnyrch
Silicon Labs yw'r gwerthwr o ddewis i OEMs sy'n datblygu rhwydweithio Zigbee yn eu cynhyrchion. Llwyfan Zigbee Silicon Labs yw'r datrysiad Zigbee mwyaf integredig, cyflawn a chyfoethog o nodweddion sydd ar gael. Mae'r EmberZNet SDK Silicon Labs yn cynnwys gweithrediad Silicon Labs o'r fanyleb stack Zigbee.
NODWEDDION ALLWEDDOL
Zigbee
- -250+ o gofnodion yn nhabl allwedd cyswllt yr APS
- Cefnogaeth ZigbeeD ar Android 12 (v21.0.6113669) a Tizen (v0.1-13.1)
- xG26 cefnogaeth Modiwl
Amlbrotocol
- Cefnogaeth ZigbeeD ac OTBR ar OpenWRT - GA
- DMP BLE + CMP ZB & Mater / OT gyda Gwrando Cydamserol ar MG26 ar gyfer SoC - GA
- 802.15.4 Elfen flaenoriaeth amserlennwyr radio unedig
- Cefnogaeth pecynnu Debian ar gyfer cymwysiadau gwesteiwr AS - Alpha
Eitemau Newydd
Newidiadau Pwysig
Mae maint tabl allwedd cyswllt APS (wedi'i ffurfweddu gan ddefnyddio SL_ZIGBEE_KEY_TABLE_SIZE) wedi'i ehangu o 127 i 254 o gofnodion.
- Ychwanegir cefnogaeth R23 ar gyfer ymarferoldeb comisiynu Rhwydwaith ZDD. Mae swyddogaeth twnelu ar gael heb gefnogaeth ar gyfer achosion defnydd Rhwydwaith Etifeddiaeth.
- Mae'r cydrannau Rhwydwaith Llywio a Chrëwr Rhwydwaith wedi'u diweddaru i gynnwys cefnogaeth ar gyfer ymuno â R23. Mae'r rhain yn cynnwys y newidiadau cysylltiedig a ganlyn.
- Mae polisi cais diofyn yr Allwedd Cyswllt Canolfan Ymddiriedolaeth (TCLK) wedi'i ddiweddaru i gynhyrchu allweddi newydd ar gyfer pob dyfais sy'n gwneud cais. Cynhyrchir allwedd newydd bob tro y bydd y dyfeisiau sy'n gwneud cais yn ceisio diweddaru eu Allwedd Cyswllt Canolfan Ymddiriedolaeth.
- Oherwydd y newid polisi TCLK blaenorol, mae'r elfen Diogelwch Crëwr Rhwydwaith bellach yn gofyn am yr elfen Allweddi Cyswllt Diogelwch. Bydd ceisiadau uwchraddio yn cael eu diweddaru i gydymffurfio â'r gofyniad newydd hwn.
- Cyfluniad newydd,
SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY yn cael ei ychwanegu i ganiatáu ymuno gan ddefnyddio allwedd graidd, stwnsh. Mae'r ffurfweddiad hwn i'w gael o dan yr elfen Diogelwch Crëwr Rhwydwaith. Mae defnyddio'r polisi hwn yn caniatáu i bob dyfais ymuno dderbyn ôl-ymuno TCLK unigryw, ond ni fydd ymdrechion ailadroddus i ddiweddaru'r TCLK yn arwain at allwedd newydd ar gyfer y ddyfais sy'n gwneud cais. Y defnydd hwn o allweddi dolen stwnsh oedd y polisi rhagosodedig cyn y datganiad hwn, ac mae defnyddio'r polisi hwn yn galluogi Canolfan yr Ymddiriedolaeth i osgoi dod â'r gydran Allweddi Cyswllt Diogelwch i mewn, sy'n arbed allweddi yn Flash.
Nodyn: Nid yw Silicon Labs yn argymell defnyddio'r polisi hwn, gan fod hyn yn atal dyfeisiau ymuno rhag rholio, neu ddiweddaru, eu TCLKs.
- Mae set cyfluniad newydd yn cael ei ychwanegu at y gydran zigbee_ezsp_spi i ganiatáu cyfluniad y ddyfais SPI gwesteiwr a'i ryngwynebau pin.
- Mae'r cynampprosiectau, gan gynnwys y prosiect files (.slcps) a ffolder prosiect, yn cael eu hail-enwi i ganllawiau enwi Silicon Labs a'u symud o dan y cyfeiriadur “prosiectau”.
Cefnogaeth Llwyfan Newydd
- Modiwlau newydd
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Byrddau radio newydd
- MGM260P-RB4350A
- MGM260P-RB4351A
- Rhan newydd
- efr32xg27
- Cit Archwiliwr
- BRD2709A
- MGM260P-EK2713A
Dogfennaeth Newydd
Mae canllaw defnyddiwr EZSP newydd UG600 ar gyfer datganiadau 8.1 ac uwch.
Gwelliannau
- SL_ZIGBEE_KEY_TABLE_SIZE terfynau wedi'u hymestyn hyd at 254 o gofnodion.
- Wedi ychwanegu zigbee_security_link_keys i Z3Light.
- Ychwanegwyd zigbee_security_link_keys at zigbee_mp_z3_tc_z3_tc. Wedi diweddaru ei faint tabl allweddol hefyd.
- Wedi cynyddu maint tabl bysell Z3 Gateway (a fydd yn cael ei osod i ncp) i 20.
Materion Sefydlog
Materion Hysbys yn y Datganiad Presennol
Ychwanegwyd materion mewn print trwm ers y datganiad blaenorol. Os ydych wedi methu datganiad, mae nodiadau rhyddhau diweddar ar gael yn https://www.silabs.com/developers/zigbee-emberznet yn y tab Tech Docs.
Eitemau Anghymeradwy
- Nid yw'r gydran zigbee_watchdog_periodic_refresh bellach yn cael ei defnyddio yn fframwaith cymhwysiad Zigbee ac mae'n anghymeradwy yn y datganiad hwn. Mae amserydd y corff gwarchod wedi'i analluogi yn ddiofyn ar gyfer yr holl sampceisiadau. Bydd elfen well o gorff gwarchod yn cael ei hychwanegu at y SDK yn y dyfodol.
- Nodyn: Galluogi amserydd y corff gwarchod gydag eitem ffurfweddu SL_LEGACY_HAL_DISABLE_WATCHDOG wedi'i osod i 0 yn eich rhaglen
Cyfyngiadau ac Ystyriaethau Rhwydwaith
Mae'r cymwysiadau Canolfan Ymddiriedolaeth rhagosodedig sy'n cael eu cludo gyda'r datganiad EmberZNet hwn yn gallu cefnogi sawl dyfais ar y rhwydwaith. Pennir y nifer hwn yn seiliedig ar sawl ffactor, gan gynnwys meintiau tabl wedi'u ffurfweddu, defnydd NVM, a gwerthoedd amser cenhedlaeth ac amser rhedeg eraill. Gall defnyddwyr sy'n ceisio creu rhwydweithiau mawr wynebu problemau adnoddau wrth dyfu'r rhwydwaith yn fwy nag y gall y rhaglen ei gefnogi. Am gynample, gall dyfais sy'n gofyn am Allwedd Cyswllt Canolfan Ymddiriedolaeth o Ganolfan yr Ymddiriedolaeth sbarduno galwad yn ôl sl_zigbee_af_zigbee_key_establishment_cb ar y Ganolfan Ymddiriedolaeth gyda statws h wedi'i osod i SL_ZIGBEE_KEY_TABLE_FULL, gan nodi nad oes gan y tabl allweddi le i ychwanegu allwedd newydd ar gyfer y ddyfais sy'n gwneud cais neu Nid oes lle ar gael i NVM3. Mae Silicon Labs yn darparu'r argymhellion canlynol ar gyfer defnyddwyr sy'n ceisio creu rhwydweithiau mawr. Ar gyfer cymwysiadau Trust Center, argymhellir y ffurfweddiadau canlynol. Nid yw'r argymhellion hyn yn hollgynhwysfawr, ac maent yn gweithredu fel llinell sylfaen ar gyfer ceisiadau sy'n bwriadu tyfu rhwydweithiau mawr.
- Cynnwys y gydran Tabl Cyfeiriadau (zigbee_address_table), gyda
- yr eitem ffurfweddu SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE wedi'i gosod i faint y rhwydwaith dymunol
- y gwerth SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE gosod i'r uchafswm (4)
- Cynnwys y gydran Allweddi Cyswllt Diogelwch (zigbee_security_link_keys), gyda
- Mae'r gwerth SL_ZIGBEE_KEY_TABLE_SIZE wedi'i osod i faint y rhwydwaith
- Mae'r eitemau cyfluniad canlynol wedi'u gosod i faint y rhwydwaith a ddymunir
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, fel y canfuwyd yng nghydran Zigbee Pro Stack
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, fel y canfuwyd yn y gydran llwybro Ffynhonnell, os defnyddir llwybro ffynhonnell
- Addasiad NVM3_DEFAULT_NVM_SIZE a NVM3_DEFAULT_CACHE_SIZE yn ôl defnydd NVM3
- Ee mae'n debygol y bydd angen maint NVM65 o 3K ar gyfer meintiau rhwydwaith mwy na 64 nod. Y maint NVM3 rhagosodedig yn Silicon Labs Zigbee sampLe ceisiadau yn 32K. Efallai y bydd angen addasu'r gwerth hwn hyd yn oed yn uwch ar gyfer cymwysiadau sy'n defnyddio NVM yn drymach.
- Efallai y bydd angen maint storfa NVM65 o 3 beit ar rwydweithiau mawr hyd at 1200 nod; efallai y bydd angen dyblu'r gwerth hwn i 2400 beit er mwyn tyfu rhwydweithiau mwy na hynny.
Mae'r addasiadau hyn yn berthnasol i Ganolfan yr Ymddiriedolaeth yn unig
Porth Amlbrotocol a RCP
Eitemau Newydd
Wedi galluogi cefnogaeth GA SoC ar gyfer BLE DMP gyda Zigbee + Openthread CMP gyda gwrando cydamserol ar rannau xG26. Mae cefnogaeth alffa Debian wedi'i ychwanegu ar gyfer cymwysiadauZigbeed, OTBR, a Z3Gateway. Darperir Zigbeed ac OTBR mewn fformat pecyn DEB ar gyfer y llwyfan cyfeirio a ddewiswyd (Raspberry PI 4) hefyd. Gweler Rhedeg Zigbee, OpenThread, a Bluetooth ar yr un pryd ar Linux Host gyda Chyd-brosesydd Amlbrotocol, a geir yn docs.silabs.com, am fanylion. Ychwanegwyd cefnogaeth Zigbeed ar gyfer Tizen-0.1-13.1 ar gyfer arm32 ac aarch64 yn ogystal ag Android 12 ar gyfer aarch64. Mae rhagor o wybodaeth am Zigbeed ar gael yn docs.silabs.com. Ychwanegwyd y gydran newydd “802.15.4 Unified radio scheduler priority”. Defnyddir y gydran hon i ffurfweddu blaenoriaethau radio pentwr 15.4. Mae'r gydran hefyd yn gofyn am y gydran “radio_priority_configurator” newydd. Mae'r gydran hon yn caniatáu i brosiectau ddefnyddio'r offeryn Cyflunydd Blaenoriaeth Radio yn Simplicity Studio i ffurfweddu lefelau blaenoriaeth radio y pentyrrau sydd eu hangen.
Gwelliannau
Nodyn cais Mae Rhedeg Zigbee, OpenThread, a Bluetooth ar yr un pryd ar Linux Host gyda Chydbrosesydd Amlbrotocol (AN1333) wedi'i symud i docs.silabs.com. Mae cefnogaeth OpenWRT bellach o ansawdd GA. Mae cefnogaeth OpenWRT wedi'i ychwanegu ar gyfer cymwysiadau Zigbee, OTBR, a Z3Gateway. Darperir Zigbeed ac OTBR mewn fformat pecyn IPK ar gyfer y llwyfan cyfeirio (Raspberry PI 4) hefyd. Gweler Rhedeg Zigbee, OpenThread, a Bluetooth ar yr un pryd ar Linux Host gyda Chyd-brosesydd Amlbrotocol, a geir yn docs.silabs.com, am fanylion.
Materion Sefydlog
Materion Hysbys yn y Datganiad Presennol
Ychwanegwyd materion mewn print trwm ers y datganiad blaenorol. Os ydych wedi methu datganiad, mae nodiadau rhyddhau diweddar ar gael ceirchhttps://www.silabs.com/developers/simplicity-software-development-kit.
Eitemau Anghymeradwy
Bydd y “Cynhwysydd Multiprotocol” sydd ar gael ar hyn o bryd ar DockerHub (siliconlabsinc / multiprotocol) yn cael ei anghymeradwyo mewn datganiad sydd i ddod. Ni fydd y cynhwysydd yn cael ei ddiweddaru mwyach a bydd modd ei dynnu o DockerHub. Bydd y pecynnau seiliedig ar Debian ar gyfer cpcd, ZigBee, ac ot-br-posix, ynghyd â phrosiectau a gynhyrchir ac a luniwyd yn frodorol, yn disodli'r swyddogaeth a gollwyd trwy gael gwared ar y cynhwysydd.
Defnyddio'r Datganiad hwn
Mae'r datganiad hwn yn cynnwys y canlynol:
- Pentwr Zigbee
- Fframwaith Cais Zigbee
- Zigbee Sample Ceisiadau
I gael rhagor o wybodaeth am Zigbee a'r EmberZNet SDK gweler UG103.02: Zigbee Fundamentals. Os ydych yn ddefnyddiwr tro cyntaf, gweler QSG180: Canllaw Cychwyn Cyflym Zigbee EmberZNet ar gyfer SDK 7.0 ac Uwch, am gyfarwyddiadau ar ffurfweddu eich amgylchedd datblygu, adeiladu a fflachio felampcais, a chyfeiriadau dogfennaeth yn cyfeirio at y camau est.
Gosod a Defnyddio
Darperir y Zigbee EmberZNet SDK fel rhan o'r Simplicity SDK, y gyfres o SDKs Silicon Labs. I ddechrau'n gyflym gyda'r Simplicity SDK, gosodwch Simplicity Studio 5, a fydd yn sefydlu'ch amgylchedd datblygu ac yn eich arwain trwy osodiad Simplicity SDK. Mae Simplicity Studio 5 yn cynnwys popeth sydd ei angen ar gyfer datblygu cynnyrch IoT gyda dyfeisiau Silicon Labs, gan gynnwys lansiwr adnoddau a phrosiect, offer ffurfweddu meddalwedd, IDE llawn gyda cadwyn offer GNU, ac offer dadansoddi. Darperir cyfarwyddiadau gosod yn y Canllaw Defnyddiwr Simplicity Studio 5 ar-lein. Fel arall, gellir gosod Simplicity SDK â llaw trwy lawrlwytho neu glonio'r diweddaraf o GitHub. Gwel https://github.com/SiliconLabs/simplicity_sdk am fwy o wybodaeth. Mae Simplicity Studio yn gosod y Simplicity SDK yn ddiofyn yn:
- (Windows): C:\Users\SimplicityStudio\SDKs\simplicity_sdk
- (MacOS): /Users//SimplicityStudio/SDKs/simplicity_sdk
Mae dogfennaeth sy'n benodol i'r fersiwn SDK wedi'i gosod gyda'r SDK. Gellir dod o hyd i wybodaeth ychwanegol yn aml yn yr erthyglau sylfaen wybodaeth (KBAs). Mae cyfeiriadau API a gwybodaeth arall am hyn a datganiadau cynharach ar gael https://docs.silabs.com/.
Gwybodaeth Ddiogelwch
Integreiddio Vault Diogel
Ar gyfer cymwysiadau sy'n dewis storio allweddi'n ddiogel gan ddefnyddio'r gydran Storio Allwedd Ddiogel ar rannau Diogel Vault-Uchel, mae'r tabl canlynol yn dangos yr allweddi gwarchodedig a'u nodweddion amddiffyn storio y mae cydran Rheolwr Diogelwch Zigbee yn eu rheoli.Gellir defnyddio allweddi wedi'u lapio sydd wedi'u marcio fel "Anallforiadwy" ond ni allant fod vieweu golygu neu eu rhannu ar amser rhedeg. Gellir defnyddio neu rannu allweddi wedi'u lapio sydd wedi'u nodi fel “Allforiadwy” ar amser rhedeg ond maent yn parhau i gael eu hamgryptio wrth eu storio yn Flash. Nid oes angen i gymwysiadau defnyddwyr ryngweithio â mwyafrif yr allweddi hyn byth. Mae APIs presennol i reoli bysellau Tabl Allweddi Cyswllt neu Allweddi Dros Dro yn dal ar gael i raglen y defnyddiwr ac nid ydynt yn cael eu cyfeirio trwy gydran Rheolwr Diogelwch Zigbee.
Cynghorion Diogelwch
I danysgrifio i Security Advisories, mewngofnodwch i borth cwsmeriaid Silicon Labs, yna dewiswch Account Home. Cliciwch CARTREF i fynd i dudalen gartref y porth ac yna cliciwch ar y deilsen Rheoli Hysbysiadau. Sicrhewch fod 'Hysbysiadau Cynghori Meddalwedd/Diogelwch a Hysbysiadau Newid Cynnyrch (PCNs)' yn cael eu gwirio, a'ch bod wedi'ch tanysgrifio o leiaf ar gyfer eich platfform a'ch protocol. Cliciwch Cadw i arbed unrhyw newidiadau.
Cefnogaeth
Mae cwsmeriaid Pecyn Datblygu yn gymwys ar gyfer hyfforddiant a chymorth technegol. Defnyddiwch y Zigbee Labordai Silicon web tudalen i gael gwybodaeth am holl gynhyrchion a gwasanaethau Silicon Labs Zigbee, ac i gofrestru ar gyfer cymorth cynnyrch. Gallwch gysylltu â chymorth Silicon Laboratories yn http://www.silabs.com/support.
Ardystiad Zigbee
Mae datganiad Ember ZNet 8.1 wedi'i gymhwyso ar gyfer Platfform Cydymffurfio Zigbee ar gyfer pensaernïaeth SoC, NC, P, ac RCP mae ID ardystio ZCP ynghlwm wrth y datganiad hwn, gwiriwch y CSA websafle yma:
https://csa-iot.org/csa-iot_products/.
Sylwch fod yr ardystiad ZCP yn filech ar ôl y datganiad, ac mae'n cymryd ychydig wythnosau cyn cael ei adlewyrchu ar y CSA websafle. Am unrhyw ymholiadau pellach, cysylltwch â chymorth Silicon Laboratories yn http://www.silabs.com/support.
Cwestiynau Cyffredin
A: Gellir ffurfweddu maint tabl allwedd cyswllt APS gan ddefnyddio'r paramedr SL_ZIGBEE_KEY_TABLE_SIZE. Yn fersiwn 8.1, mae wedi'i ehangu o 127 i 254 o gofnodion.
C: Beth yw'r gwelliannau yn fersiwn 8.1?
A: Mae fersiwn 8.1 yn dod â gwelliannau megis ehangu maint tabl allweddol cyswllt APS, ailenwi cydrannau, ychwanegu amddiffyniad mutex ar gyfer ciw digwyddiad Fframwaith Athe pp, a mwy. Cyfeiriwch at y nodiadau rhyddhau am restr fanwl o welliannau.
C: Sut mae trin materion sefydlog yn y SDK?
A: Materion sefydlog yn y SDK gan gynnwys datrys problemau posibl gyda chyfluniad maint bwrdd cymydog, ailenwi cydrannau, gosod llwybr ffynhonnell uwchben, trin gorchmynion ZCL, a mwy. Sicrhewch eich bod yn diweddaru i'r fersiwn ddiweddaraf i elwa o'r atebion hyn.
Dogfennau / Adnoddau
![]() |
SILICON LABS Zigbee EmberZ Net SDK [pdfCyfarwyddiadau Zigbee EmberZ Net SDK, EmberZ Net SDK, Net SDK, SDK |