SILICON LABS Zigbee EmberZ Net SDK
Տեխնիկական պայմաններ
- Zigbee EmberZNet SDK տարբերակ՝ 8.1 GA
- Simplicity SDK Suite տարբերակը՝ 2024.12.0
- Թողարկման ամսաթիվ՝ 16 դեկտեմբերի, 2024թ
- Համատեղելի Կազմողներ՝ GCC տարբերակ 12.2.1
- EZSP արձանագրության տարբերակը՝ 0x10
Ապրանքի մասին տեղեկատվություն
Silicon Labs-ը OEM-ի նախընտրելի վաճառողն է, որոնք զարգացնում են Zigbee ցանցն իրենց արտադրանքներում: Silicon Labs Zigbee հարթակը ամենաինտեգրված, ամբողջական և հնարավորություններով հարուստ Zigbee լուծումն է: Silicon Labs EmberZNet SDK-ն պարունակում է Silicon Labs-ի կողմից Zigbee stack-ի հստակեցման իրականացումը:
ՀԻՄՆԱԿԱՆ ԱՌԱՆՁՆԱՀԱՏԿՈՒԹՅՈՒՆՆԵՐ
Զիգբի
- -250+ գրառում APS հղման բանալի աղյուսակում
- ZigbeeD-ի աջակցություն Android 12-ում (v21.0.6113669) և Tizen-ում (v0.1-13.1)
- xG26 մոդուլի աջակցություն
Բազմաարձանագրություն
- ZigbeeD և OTBR աջակցություն OpenWRT – GA-ում
- DMP BLE + CMP ZB & Matter/OT միաժամանակյա լսումով MG26-ում SoC-ի համար – GA
- 802.15.4 Միասնական ռադիո ժամանակացույցի առաջնահերթ բաղադրիչ
- Debian փաթեթավորման աջակցություն MP host հավելվածների համար – Alpha
Նոր Նյութեր
Կարևոր Փոփոխություններ
APS հղման բանալի աղյուսակի չափը (կազմաձևված է SL_ZIGBEE_KEY_TABLE_SIZE-ի միջոցով) ընդլայնվել է 127-ից մինչև 254 գրառում:
- R23 աջակցությունն ավելացվել է ZDD ցանցի գործարկման գործառույթի համար: Թունելավորման գործառույթը հասանելի է առանց Legacy Network-ի օգտագործման դեպքերի աջակցության:
- Network Steering և Network Creator բաղադրիչները թարմացվել են՝ ներառելու աջակցություն R23-ին միանալու համար: Դրանք ներառում են հետևյալ հարակից փոփոխությունները.
- Վստահության կենտրոնի հղման բանալի (TCLK) լռելյայն հարցման քաղաքականությունը թարմացվել է՝ յուրաքանչյուր հայցող սարքի համար նոր բանալիներ ստեղծելու համար: Նոր բանալի է ստեղծվում ամեն անգամ, երբ հայցող սարքերը փորձում են թարմացնել իրենց վստահության կենտրոնի հղման բանալին:
- Նախորդ TCLK քաղաքականության փոփոխության պատճառով Network Creator Security բաղադրիչն այժմ պահանջում է Security Link Keys բաղադրիչը: Հավելվածների թարմացումը կթարմացվի՝ այս նոր պահանջին համապատասխանելու համար:
- Նոր կոնֆիգուրացիա,
SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY-ն ավելացվել է՝ առանցքային, հեշացված բանալիով միանալը թույլ տալու համար: Այս կոնֆիգուրացիան գտնվում է Network Creator Security բաղադրիչի տակ: Այս քաղաքականության օգտագործումը թույլ է տալիս յուրաքանչյուր միացող սարք ստանալ եզակի TCLK հետմիանալուց հետո, սակայն TCLK-ի թարմացման կրկնվող փորձերը չեն հանգեցնի նոր բանալի հայցող սարքի համար: Հիշեցված հղման ստեղների օգտագործումը լռելյայն քաղաքականությունն էր մինչ այս թողարկումը, և այս քաղաքականության օգտագործումը թույլ է տալիս Trust Center-ին խուսափել անվտանգության կապի բանալիների բաղադրիչի ներմուծումից, որը պահում է բանալիները Flash-ում:
ՆշումSilicon Labs-ը խորհուրդ չի տալիս օգտագործել այս քաղաքականությունը, քանի որ դա թույլ չի տալիս միացող սարքերը գլորվել կամ թարմացնել իրենց TCLK-ները:
- Կազմաձևերի նոր հավաքածու է ավելացվել zigbee_ezsp_spi բաղադրիչին, որը թույլ կտա կարգավորել հյուրընկալող SPI սարքը և դրա փին միջերեսները:
- Նախկինampնախագծերը, ներառյալ նախագիծը files (.slcps) և նախագծի թղթապանակը վերանվանվել են Silicon Labs անվանման ուղեցույցների և տեղափոխվել «նախագծեր» գրացուցակի տակ:
Նոր հարթակի աջակցություն
- Նոր մոդուլներ
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Նոր ռադիո տախտակներ
- MGM260P-RB4350A
- MGM260P-RB4351A
- Նոր մաս
- efr32xg27
- Explorer Kit
- BRD2709A
- MGM260P-EK2713A
Նոր Փաստաթղթեր
Նոր EZSP օգտվողի ուղեցույցներ UG600 8.1 և ավելի բարձր թողարկումների համար:
Բարելավումներ
- SL_ZIGBEE_KEY_TABLE_SIZE սահմանաչափերն ընդլայնվել են մինչև 254 գրառում:
- Z3Light-ին ավելացվել են zigbee_security_link_keys:
- zigbee_mp_z3_tc_z3_tc-ին ավելացվել է zigbee_security_link_keys: Թարմացվել է նաև իր հիմնական աղյուսակի չափը:
- Z3 Gateway բանալի աղյուսակի չափը (որը կսահմանվի ncp) ավելացրել է 20-ի:
Ամրագրված խնդիրներ
Ընթացիկ թողարկման հայտնի խնդիրներ
Նախորդ թողարկումից հետո թավատառով խնդիրներ են ավելացվել: Եթե դուք բաց եք թողել թողարկում, վերջին թողարկման նշումները հասանելի են այստեղ https://www.silabs.com/developers/zigbee-emberznet Tech Docs ներդիրում:
Հնացած իրեր
- Zigbee_watchdog_periodic_refresh բաղադրիչն այլևս չի օգտագործվում Zigbee հավելվածի շրջանակում և հնացած է այս թողարկումում: Watchdog timer-ը լռելյայն անջատված է բոլոր sampհայտերը։ Ապագայում SDK-ին կավելացվի բարելավված հսկիչ բաղադրիչ:
- ՆշումՄիացրեք հսկիչի ժմչփը ձեր հավելվածում SL_LEGACY_HAL_DISABLE_WATCHDOG-ի կազմաձևման տարրով 0-ով:
Ցանցի սահմանափակումներ և նկատառումներ
Վստահության կենտրոնի կանխադրված հավելվածները, որոնք առաքվում են EmberZNet-ի այս թողարկումով, կարող են աջակցել ցանցի մի քանի սարքերի: Այս թիվը որոշվում է մի քանի գործոնների հիման վրա, ներառյալ կազմաձևված աղյուսակի չափերը, NVM-ի օգտագործումը և գեներացման ժամանակի և գործարկման ժամանակի այլ արժեքները: Խոշոր ցանցեր ստեղծելու ձգտող օգտատերերը կարող են բախվել ռեսուրսների հետ կապված խնդիրների հետ, երբ ցանցն ավելի մեծացնեն, քան հավելվածը կարող է աջակցել: ՆախampՎստահության կենտրոնից վստահության կենտրոնի հղման բանալի հայցող սարքը կարող է sl_zigbee_af_zigbee_key_establishment_cb հետ կանչել Trust Center-ում h կարգավիճակով սահմանված է SL_ZIGBEE_KEY_TABLE_FULL, ինչը ցույց է տալիս, որ բանալիների աղյուսակը տեղ չունի նոր սարք կամ այդ բանալի ավելացնելու համար: NVM3-ը հասանելի տարածք չունի: Silicon Labs-ը տալիս է հետևյալ առաջարկությունները մեծ ցանցեր ստեղծելու ձգտող օգտատերերի համար. Վստահության կենտրոնի հավելվածների համար առաջարկվում են հետևյալ կազմաձևերը. Այս առաջարկությունները սպառիչ չեն, և դրանք հիմք են հանդիսանում այն հավելվածների համար, որոնք մտադիր են մեծ ցանցեր զարգացնել:
- Հասցեների աղյուսակի բաղադրիչի ընդգրկում (zigbee_address_table), հետ
- SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE կազմաձևման տարրը սահմանված է ցանկալի ցանցի չափի
- SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE արժեքը սահմանվել է առավելագույնի (4)
- Անվտանգության կապի բանալիների բաղադրիչի (zigbee_security_link_keys) ընդգրկում
- SL_ZIGBEE_KEY_TABLE_SIZE արժեքը սահմանվում է ցանցի չափին
- Հետևյալ կազմաձևման տարրերը սահմանվում են ցանկալի ցանցի չափին
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, ինչպես հայտնաբերվել է Zigbee Pro Stack բաղադրիչում
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, ինչպես հայտնաբերված է Source Routing բաղադրիչում, եթե օգտագործվում է աղբյուրի երթուղիչ
- NVM3_DEFAULT_NVM_SIZE և NVM3_DEFAULT_CACHE_SIZE-ի ճշգրտում ըստ NVM3-ի օգտագործման
- Օրինակ, 65 հանգույցից ավելի ցանցի չափերը, հավանաբար, պահանջում են 3K NVM64 չափս: Նախնական NVM3 չափը Silicon Labs Zigbee-ումampհայտերի քանակը 32K է: Այն հավելվածները, որոնք ավելի շատ օգտագործում են NVM-ը, կարող են պահանջել ավելի բարձր կարգավորել այս արժեքը:
- Խոշոր ցանցերին մինչև 65 հանգույց կարող է անհրաժեշտ լինել NVM3 քեշի չափը 1200 բայթ; դրանից ավելի մեծ ցանցերի աճը կարող է պահանջել կրկնապատկել այս արժեքը մինչև 2400 բայթ:
Այս ճշգրտումները վերաբերում են միայն վստահության կենտրոնին
Multiprotocol Gateway և RCP
Նոր Նյութեր
Միացված է GA SoC-ի աջակցությունը BLE DMP-ի համար Zigbee + Openthread CMP-ի հետ xG26 մասերի միաժամանակյա լսմամբ: Debian alpha աջակցությունն ավելացվել է Zigbeed, OTBR և Z3Gateway հավելվածների համար: Zigbeed-ը և OTBR-ը տրամադրվում են DEB փաթեթի ձևաչափով՝ ընտրված տեղեկատու հարթակի համար (Raspberry PI 4): Տեսեք Զիգբիի, OpenThread-ի և Bluetooth-ի միաժամանակ գործարկումը Linux հոսթի վրա բազմապրոտոկոլով համապրոցեսորով, որը գտնվում է այստեղ docs.silabs.com, մանրամասների համար։ Ավելացվեց Zigbeed-ի աջակցությունը Tizen-0.1-13.1-ի համար arm32-ի և aarch64-ի համար, ինչպես նաև Android 12-ի համար aarch64-ի համար: Zigbeed-ի մասին լրացուցիչ տեղեկություններ կարելի է գտնել այստեղ docs.silabs.com. Ավելացվեց նոր «802.15.4 ռադիո ժամանակացույցի միասնական առաջնահերթություն» բաղադրիչը: Այս բաղադրիչն օգտագործվում է 15.4 կույտի ռադիո առաջնահերթությունները կարգավորելու համար: Բաղադրիչը նաև պահանջում է նոր «radio_priority_configurator» բաղադրիչը: Այս բաղադրիչը թույլ է տալիս նախագծերին օգտագործել «Radio Priority Configurator» գործիքը Simplicity Studio-ում, որպեսզի կազմաձևեն դա պահանջող կույտերի ռադիո առաջնահերթության մակարդակները:
Բարելավումներ
Հավելվածի նշումը, որը միաժամանակ աշխատում է Zigbee-ի, OpenThread-ի և Bluetooth-ի վրա Linux հոսթում՝ բազմապրոտոկոլի համամշակող պրոցեսորով (AN1333) տեղափոխվել է։ docs.silabs.com. OpenWRT-ի աջակցությունն այժմ GA որակ է: OpenWRT-ի աջակցությունն ավելացվել է Zigbee, OTBR և Z3Gateway հավելվածների համար: Zigbeed-ը և OTBR-ը տրամադրվում են IPK փաթեթի ձևաչափով՝ հղումային հարթակի համար (Raspberry PI 4): Տեսեք Զիգբիի, OpenThread-ի և Bluetooth-ի միաժամանակ գործարկումը Linux հոսթի վրա բազմապրոտոկոլով համապրոցեսորով, որը գտնվում է այստեղ docs.silabs.com, մանրամասների համար։
Ամրագրված խնդիրներ
Ընթացիկ թողարկման հայտնի խնդիրներ
Նախորդ թողարկումից հետո թավատառով խնդիրներ են ավելացվել: Եթե դուք բաց եք թողել թողարկումը, վերջին թողարկման նշումները հասանելի են վարսակի տեսքովhttps://www.silabs.com/developers/simplicity-software-development-kit.
Հնացած իրեր
«Multiprotocol Container»-ը, որն այժմ հասանելի է DockerHub-ում (siliconlabsinc/multiprotocol) առաջիկա թողարկումում հնացած կլինի: Կոնտեյները այլևս չի թարմացվի և հնարավոր կլինի դուրս բերել DockerHub-ից: Debian-ի վրա հիմնված փաթեթները cpcd-ի, ZigBee-ի և ot-br-posix-ի համար, ինչպես նաև բնօրինակ ձևավորված և կազմված նախագծերի հետ միասին, կփոխարինեն բեռնարկղի հեռացմամբ կորցրած ֆունկցիոնալությունը:
Օգտագործելով այս թողարկումը
Այս թողարկումը պարունակում է հետևյալը.
- Zigbee բուրգ
- Zigbee հավելվածի շրջանակ
- Զիգբի Սample ationsրագրեր
Zigbee-ի և EmberZNet SDK-ի մասին լրացուցիչ տեղեկությունների համար տե՛ս UG103.02. Zigbee Fundamentals: Եթե դուք առաջին անգամ օգտագործող եք, տես QSG180. Zigbee EmberZNet Quick-Start Guide for SDK 7.0 և ավելի բարձր, ձեր զարգացման միջավայրը կարգավորելու, կառուցելու և թարթելու հրահանգների համարampհայտը և փաստաթղթերի հղումները, որոնք մատնանշում են հետագա քայլերը:
Տեղադրում և օգտագործում
Zigbee EmberZNet SDK-ն տրամադրվում է որպես Simplicity SDK-ի՝ Silicon Labs SDK-ների փաթեթի մաս: Simplicity SDK-ի հետ արագ սկսելու համար տեղադրեք Simplicity Studio 5-ը, որը կստեղծի ձեր զարգացման միջավայրը և կուղեկցի ձեզ Simplicity SDK-ի տեղադրման ընթացքում: Simplicity Studio 5-ը ներառում է այն ամենը, ինչ անհրաժեշտ է Silicon Labs սարքերի հետ IoT արտադրանքի մշակման համար, ներառյալ ռեսուրսները և նախագծերի գործարկիչը, ծրագրաշարի կազմաձևման գործիքները, ամբողջական IDE-ն GNU գործիքների շղթայով և վերլուծության գործիքներ: Տեղադրման հրահանգները ներկայացված են առցանց Simplicity Studio 5 Օգտագործողի ուղեցույցում: Որպես այլընտրանք, Simplicity SDK-ն կարող է ձեռքով տեղադրվել՝ ներբեռնելով կամ կլոնավորելով վերջինը GitHub-ից: Տես https://github.com/SiliconLabs/simplicity_sdk լրացուցիչ տեղեկությունների համար: Simplicity Studio-ն լռելյայն տեղադրում է Simplicity SDK-ն՝
- (Windows): C:\Users\\SimplicityStudio\SDKs\simplicity_sdk
- (MacOS): /Users//SimplicityStudio/SDKs/simplicity_sdk
SDK տարբերակին հատուկ փաստաթղթերը տեղադրվում են SDK-ով: Լրացուցիչ տեղեկություններ հաճախ կարելի է գտնել գիտելիքների բազայի հոդվածներում (KBAs): API-ի հղումները և այս և ավելի վաղ թողարկումների մասին այլ տեղեկություններ հասանելի են https://docs.silabs.com/.
Անվտանգության տեղեկատվություն
Անվտանգ պահոց ինտեգրում
Հավելվածների համար, որոնք ընտրում են անվտանգ պահել բանալիները՝ օգտագործելով «Secure Key Storage» բաղադրիչը «Secure Vault-High» մասերում, հետևյալ աղյուսակը ցույց է տալիս պաշտպանված բանալիները և դրանց պահեստավորման պաշտպանության բնութագրերը, որոնք կառավարում է Zigbee Security Manager բաղադրիչը:Փաթաթված բանալիները, որոնք նշված են որպես «Ոչ արտահանելի» կարող են օգտագործվել, բայց չեն կարող լինել viewխմբագրվել կամ համօգտագործվել է գործարկման ժամանակ: Փաթաթված ստեղները, որոնք նշված են որպես «Արտահանելի», կարող են օգտագործվել կամ համօգտագործվել գործարկման ժամանակ, սակայն գաղտնագրված են մնում Flash-ում պահվելիս: Օգտագործողի հավելվածները երբեք կարիք չունեն փոխազդելու այս բանալիների մեծամասնության հետ: Գործող API-ները՝ Link Key Table ստեղները կամ անցողիկ ստեղները կառավարելու համար, դեռ հասանելի են օգտատիրոջ հավելվածին և դրանք ուղղորդվում են Zigbee Security Manager բաղադրիչի միջոցով:
Անվտանգության խորհրդատվություն
Անվտանգության խորհուրդներին բաժանորդագրվելու համար մուտք գործեք Silicon Labs հաճախորդների պորտալ, այնուհետև ընտրեք «Հաշվի տուն»: Սեղմեք HOME՝ պորտալի գլխավոր էջ գնալու համար, այնուհետև կտտացրեք «Կառավարել ծանուցումների» սալիկը: Համոզվեք, որ «Ծրագրային/անվտանգության խորհրդատվական ծանուցումներ և արտադրանքի փոփոխության ծանուցումներ (PCN)» ստուգված է, և որ դուք նվազագույնը բաժանորդագրված եք ձեր հարթակին և արձանագրությանը: Կտտացրեք Պահպանել ցանկացած փոփոխություն պահելու համար:
Աջակցություն
Development Kit-ի հաճախորդները կարող են վերապատրաստման և տեխնիկական աջակցության համար: Օգտագործեք Silicon Laboratories Zigbee-ը web էջ՝ Silicon Labs Zigbee-ի բոլոր ապրանքների և ծառայությունների մասին տեղեկատվություն ստանալու և արտադրանքի աջակցության համար գրանցվելու համար: Դուք կարող եք կապվել Silicon Laboratories-ի աջակցման հասցեով՝ http://www.silabs.com/support.
Zigbee սերտիֆիկացում
Ember ZNet 8.1 թողարկումը որակավորվել է Zigbee-ի համապատասխան պլատֆորմի համար SoC, NC, P և RCP ճարտարապետությունների համար: Այս թողարկմանը կապված է ZCP հավաստագրման ID-ն, խնդրում ենք ստուգել CSA-ն: webկայքը այստեղ՝
https://csa-iot.org/csa-iot_products/.
Խնդրում ենք նկատի ունենալ, որ ZCP սերտիֆիկացումն է fileդ տեղադրեք թողարկումը և մի քանի շաբաթ է տևում մինչև CSA-ի վերաբերյալ արտացոլումը webկայք։ Ցանկացած լրացուցիչ հարցումների համար խնդրում ենք կապվել Silicon Laboratories-ի աջակցման հասցեով՝ http://www.silabs.com/support.
ՀՏՀ-ներ
A: APS հղման բանալի աղյուսակի չափը կարող է կազմաձևվել՝ օգտագործելով SL_ZIGBEE_KEY_TABLE_SIZE պարամետրը: 8.1 տարբերակում այն ընդլայնվել է 127-ից մինչև 254 գրառում:
Հարց: Որո՞նք են բարելավումները 8.1 տարբերակում:
A. 8.1 տարբերակը բերում է բարելավումներ, ինչպիսիք են APS հղման ստեղնաշարի աղյուսակի չափի ընդլայնումը, բաղադրիչների վերանվանումը, Athe pp Framework իրադարձությունների հերթի համար mutex պաշտպանությունը ավելացնելը և այլն: Բարելավումների մանրամասն ցանկի համար տես թողարկման նշումները:
Հարց. Ինչպե՞ս կարող եմ կարգավորել SDK-ի ֆիքսված խնդիրները:
Ա․ SDK-ում շտկված խնդիրները, ներառյալ հարևան աղյուսակի չափի կազմաձևման հետ կապված հնարավոր խնդիրների լուծումը, բաղադրիչների վերանվանումը, սկզբնաղբյուրի երթուղու շտկումը, ZCL հրամանների մշակումը և այլն: Համոզվեք, որ թարմացվում եք վերջին տարբերակին, որպեսզի օգտվեք այս ուղղումներից:
Փաստաթղթեր / ռեսուրսներ
![]() |
SILICON LABS Zigbee EmberZ Net SDK [pdfՀրահանգներ Zigbee EmberZ Net SDK, EmberZ Net SDK, Net SDK, SDK |