SILICON LABS Zigbee EmberZ Net SDK ko'rsatmalari

Silicon Labs o'z mahsulotlariga Zigbee tarmog'ini ishlab chiquvchi OEMlar uchun tanlagan sotuvchi hisoblanadi. Silicon Labs Zigbee platformasi mavjud boʻlgan eng integratsiyalashgan, toʻliq va xususiyatlarga boy Zigbee yechimidir. Silicon Labs EmberZNet SDK Silicon Labs tomonidan Zigbee stek spetsifikatsiyasini amalga oshirishni o'z ichiga oladi.

ASOSIY XUSUSIYATLAR

Zigbi

APS havolasi kalit jadvalida -250+ yozuv
Android 12 (v21.0.6113669) va Tizen (v0.1-13.1) da ZigbeeD-ni qo'llab-quvvatlash

xG26 modulini qo'llab-quvvatlash

Ko'p protokol

OpenWRT – GA-da ZigbeeD va OTBR-ni qo'llab-quvvatlash
SoC – GA uchun MG26 da bir vaqtda tinglash bilan DMP BLE + CMP ZB & Matter/OT

802.15.4 Yagona radio rejalashtiruvchining ustuvor komponenti
MP xost ilovalari uchun Debian paketlarini qo'llab-quvvatlash - Alpha

Yangi elementlar

Muhim o'zgarishlar
APS havolasi kaliti jadvali hajmi (SL_ZIGBEE_KEY_TABLE_SIZE yordamida sozlangan) 127 dan 254 tagacha kengaytirilgan.

ZDD Tarmoqni ishga tushirish funksiyasi uchun R23 qo'llab-quvvatlanadi. Tunnellash funksiyasi Legacy Network foydalanish holatlari uchun yordamisiz mavjud.

Tarmoqni boshqarish va tarmoq yaratuvchisi komponentlari R23 ulanishini qo'llab-quvvatlash uchun yangilandi. Bularga quyidagi tegishli o'zgarishlar kiradi.
- Standart Ishonch markazi havola kaliti (TCLK) soʻrov siyosati har bir soʻrovchi qurilma uchun yangi kalitlarni yaratish uchun yangilandi. Har safar soʻralayotgan qurilmalar Ishonch markazi havolasi kalitini yangilashga uringanda yangi kalit yaratiladi.
- Oldingi TCLK siyosati oʻzgarishi sababli, Network Creator Security komponenti endi Security Link Keys komponentini talab qiladi. Ilovalarni yangilash ushbu yangi talabga muvofiq yangilanadi.
- Yangi konfiguratsiya,
  SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY asosiy, xeshlangan kalit yordamida ulanishga ruxsat berish uchun qo‘shilgan. Ushbu konfiguratsiya Network Creator Security komponenti ostida joylashgan. Ushbu siyosatdan foydalanish har bir qo‘shilgan qurilmaga yagona TCLK post-qo‘shilishni olish imkonini beradi, lekin TCLKni yangilashga takroriy urinishlar so‘ralayotgan qurilma uchun yangi kalitga olib kelmaydi. Xeshlangan havola kalitlaridan foydalanish ushbu nashrdan oldin standart siyosat edi va bu siyosatdan foydalanish Ishonch markaziga kalitlarni Flashda saqlaydigan Security Link Keys komponentini olib kelmaslik imkonini beradi.
  Eslatma: Silicon Labs ushbu siyosatdan foydalanishni tavsiya etmaydi, chunki bu birlashish qurilmalarini TCLK-larini aylantirish yoki yangilashdan saqlaydi.

zigbee_ezsp_spi komponentiga yangi konfiguratsiya to‘plami xost SPI qurilmasi va uning pin interfeyslarini sozlash imkonini berish uchun qo‘shilgan.
sobiqample loyihalar, shu jumladan loyiha files (.slcps) va loyiha papkasining nomi Silicon Labs nomlash ko'rsatmalariga o'zgartiriladi va "loyihalar" katalogiga ko'chiriladi.

Yangi platformani qo'llab-quvvatlash

Yangi modullar
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Yangi radio platalar
- MGM260P-RB4350A
- MGM260P-RB4351A
Yangi qism
- efr32xg27
Explorer to'plami
- BRD2709A
- MGM260P-EK2713A

Yangi Hujjatlar
Yangi EZSP foydalanuvchi qo'llanmasi UG600 8.1 va undan yuqori versiyalar uchun.

Yaxshilanishlar

SL_ZIGBEE_KEY_TABLE_SIZE cheklovlari 254 ta yozuvgacha kengaytirildi.
Z3Light-ga zigbee_security_link_keys qo'shildi.
Zigbee_mp_z3_tc_z3_tc ga zigbee_security_link_keys qo‘shildi. Uning asosiy jadval hajmi ham yangilandi.
Z3 Gateway kalit jadvali hajmi (ncp ga o'rnatiladi) 20 ga oshirildi.

Tugallangan muammolar

Joriy nashrdagi ma'lum muammolar

Oldingi nashrdan beri qalin harflar bilan yozilgan masalalar qo'shilgan. Agar siz nashrni o'tkazib yuborgan bo'lsangiz, so'nggi relizlar haqida eslatmalarni quyidagi manzilda olishingiz mumkin https://www.silabs.com/developers/zigbee-emberznet Tech Docs ilovasida.

Eskirgan elementlar

Zigbee_watchdog_periodic_refresh komponenti endi Zigbee ilovalari doirasida ishlatilmaydi va ushbu nashrda eskirgan. Kuzatuv taymeri barcha s uchun sukut bo'yicha o'chirilganampilovalar. Kelajakda SDK ga yaxshilangan kuzatuv komponenti qo'shiladi.
Eslatma: Ilovangizda SL_LEGACY_HAL_DISABLE_WATCHDOG konfiguratsiya elementi 0 ga sozlangan holda kuzatuv taymerini yoqing

Tarmoq cheklovlari va mulohazalar

Ushbu EmberZNet versiyasi bilan birga kelgan standart Ishonch markazi ilovalari tarmoqdagi bir nechta qurilmalarni qo'llab-quvvatlashga qodir. Bu raqam bir nechta omillar, jumladan, tuzilgan jadval o'lchamlari, NVM-dan foydalanish va boshqa ishlab chiqarish vaqti va ish vaqti qiymatlari asosida aniqlanadi. Katta tarmoqlarni yaratmoqchi bo'lgan foydalanuvchilar tarmoqni dastur qo'llab-quvvatlaydiganidan kattaroq o'stirishda resurs muammolariga duch kelishlari mumkin. Misol uchunample, Ishonch markazidan Ishonch markaziga havola kalitini so‘ragan qurilma Ishonch markazida h holati SL_ZIGBEE_KEY_TABLE_FULL ga o‘rnatilgan sl_zigbee_af_zigbee_key_establishment_cb qayta qo‘ng‘iroqni ishga tushirishi mumkin, bu kalitlar jadvalida yangi kalit so‘rash uchun joy yo‘qligini ko‘rsatadi. NVM3-da bo'sh joy yo'q. Silicon Labs yirik tarmoqlarni yaratishga intilayotgan foydalanuvchilar uchun quyidagi tavsiyalarni beradi. Ishonch markazi ilovalari uchun quyidagi konfiguratsiyalar tavsiya etiladi. Ushbu tavsiyalar to'liq emas va ular katta tarmoqlarni rivojlantirishni maqsad qilgan ilovalar uchun asos bo'lib xizmat qiladi.

Manzillar jadvali komponentining kiritilishi (zigbee_address_table), bilan
- SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE konfiguratsiya elementi kerakli tarmoq hajmiga o'rnatilgan
- SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE qiymati maksimal (4)

Xavfsizlik havolasi kalitlari komponentini kiritish (zigbee_security_link_keys), bilan
- SL_ZIGBEE_KEY_TABLE_SIZE qiymati tarmoq o'lchamiga o'rnatiladi
Quyidagi konfiguratsiya elementlari kerakli tarmoq hajmiga o'rnatiladi
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, Zigbee Pro Stack komponentida topilgan
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, agar manba marshrutlash ishlatilsa, Manba marshrutlash komponentida topilgan
NVM3_DEFAULT_NVM_SIZE va NVM3_DEFAULT_CACHE_SIZE oʻlchamlarini NVM3-dan foydalanishga qarab sozlash
- Masalan, 65 tugundan ortiq tarmoq oʻlchamlari uchun NVM3 oʻlchami 64K boʻlishi mumkin. Silicon Labs Zigbee s da standart NVM3 o'lchamiampilovalar soni 32K. NVM-dan ko'proq foydalanadigan ilovalar ushbu qiymatni yanada yuqoriroq sozlashni talab qilishi mumkin.
- 65 tugungacha bo'lgan yirik tarmoqlar uchun NVM3 kesh hajmi 1200 bayt kerak bo'lishi mumkin; undan kattaroq tarmoqlarni o'stirish bu qiymatni 2400 baytgacha ikki baravar oshirishni talab qilishi mumkin.

Ushbu tuzatishlar faqat Ishonch markaziga tegishli

Multiprotocol Gateway va RCP

Yangi elementlar
Zigbee + Openthread CMP bilan BLE DMP uchun xG26 qismlarida bir vaqtda tinglash bilan GA SoC qo‘llab-quvvatlashi yoqildi. Zigbeed, OTBR va Z3Gateway ilovalari uchun Debian alfa qo'llab-quvvatlashi qo'shildi. Zigbeed va OTBR tanlangan mos yozuvlar platformasi (Raspberry PI 4) uchun ham DEB paket formatida taqdim etiladi. Zigbee, OpenThread va Bluetooth-ni bir vaqtning o'zida ko'p protokolli protsessor bilan Linux hostida ishga tushirish bo'limiga qarang. docs.silabs.com, tafsilotlar uchun. Arm0.1 va aarch13.1 uchun Tizen-32-64 hamda aarch12 uchun Android 64 uchun Zigbeed qoʻllab-quvvatlashi qoʻshildi. Zigbeed haqida qo'shimcha ma'lumotni quyidagi manzilda topishingiz mumkin docs.silabs.com. Yangi "802.15.4 Yagona radio rejalashtirish ustuvorligi" komponenti qo'shildi. Ushbu komponent 15.4 stekning radio ustuvorliklarini sozlash uchun ishlatiladi. Komponent yangi “radio_priority_configurator” komponentini ham talab qiladi. Ushbu komponent loyihalarga Simplicity Studio'da Radio Priority Configurator vositasidan foydalanishga imkon beradi va uni talab qiladigan steklarning radio ustuvorlik darajasini sozlash imkonini beradi.

Yaxshilanishlar
Ilova eslatmasi Zigbee, OpenThread va Bluetooth-ni bir vaqtning o'zida Linux hostida ko'p protokolli protsessorga (AN1333) ko'chirish docs.silabs.com. OpenWRT-ni qo'llab-quvvatlash endi GA sifati. Zigbee, OTBR va Z3Gateway ilovalari uchun OpenWRT yordami qo'shildi. Zigbeed va OTBR mos yozuvlar platformasi (Raspberry PI 4) uchun ham IPK paket formatida taqdim etilgan. Zigbee, OpenThread va Bluetooth-ni bir vaqtning o'zida ko'p protokolli protsessor bilan Linux hostida ishga tushirish bo'limiga qarang. docs.silabs.com, tafsilotlar uchun.

Tugallangan muammolar

Joriy nashrdagi ma'lum muammolar
Oldingi nashrdan beri qalin harflar bilan yozilgan masalalar qo'shilgan. Agar siz nashrni o'tkazib yuborgan bo'lsangiz, so'nggi reliz yozuvlari mavjudhttps://www.silabs.com/developers/simplicity-software-development-kit.

Eskirgan elementlar
Hozirda DockerHub-da (siliconlabsinc/multiprotocol) mavjud bo‘lgan “Ko‘p protokolli konteyner” kelgusi nashrda eskiradi. Konteyner endi yangilanmaydi va uni DockerHub’dan tortib bo‘lmaydi. Cpcd, ZigBee va ot-br-posix uchun Debian-ga asoslangan paketlar mahalliy ishlab chiqarilgan va kompilyatsiya qilingan loyihalar bilan birga konteynerni olib tashlash bilan yo'qolgan funksionallikni almashtiradi.

Ushbu nashrdan foydalanish

Ushbu nashr quyidagilarni o'z ichiga oladi:

Zigbee to'plami
Zigbee dastur ramkasi
Zigbi SampIlovalar

Zigbee va EmberZNet SDK haqida qoʻshimcha maʼlumot olish uchun qarang: UG103.02: Zigbee asoslari. Agar siz birinchi marta foydalanuvchi bo'lsangiz, ishlab chiqish muhitini sozlash, yaratish va o'chirish bo'yicha ko'rsatmalar uchun QSG180: Zigbee EmberZNet SDK 7.0 va undan yuqori versiyalar uchun tezkor ishga tushirish qo'llanmasiga qarang.ample ilovasi va keyingi bosqichlarga ishora qiluvchi hujjatlar havolalari.

O'rnatish va foydalanish
Zigbee EmberZNet SDK Simplicity SDK, Silicon Labs SDK to'plamining bir qismi sifatida taqdim etilgan. Simplicity SDK-dan tezda foydalanishni boshlash uchun Simplicity Studio 5-ni o'rnating, u sizning ishlab chiqish muhitingizni o'rnatadi va Simplicity SDK o'rnatilishi bo'yicha sizga yordam beradi. Simplicity Studio 5 Silicon Labs qurilmalari bilan IoT mahsulotlarini ishlab chiqish uchun zarur bo‘lgan hamma narsani o‘z ichiga oladi, jumladan, resurs va loyiha ishga tushirgich, dasturiy ta’minotni sozlash vositalari, GNU asboblar zanjiri bilan to‘liq IDE va tahlil vositalari. O'rnatish bo'yicha ko'rsatmalar Simplicity Studio 5 foydalanuvchi qo'llanmasida keltirilgan. Shu bilan bir qatorda Simplicity SDK GitHub’dan eng so‘nggisini yuklab olish yoki klonlash orqali qo‘lda o‘rnatilishi mumkin. Qarang https://github.com/SiliconLabs/simplicity_sdk qo'shimcha ma'lumot uchun. Simplicity Studio Simplicity SDK-ni sukut bo'yicha o'rnatadi:

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

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

SDK versiyasiga xos hujjatlar SDK bilan o'rnatiladi. Qo'shimcha ma'lumotni ko'pincha bilimlar bazasi maqolalarida (KBA) topish mumkin. API havolalari va ushbu va oldingi versiyalar haqidagi boshqa ma'lumotlar mavjud https://docs.silabs.com/.

Xavfsizlik ma'lumotlari
Xavfsiz Vault integratsiyasi
Secure Vault-High qismlarida Secure Key Storage komponenti yordamida kalitlarni xavfsiz saqlashni tanlagan ilovalar uchun quyidagi jadvalda Zigbee Security Manager komponenti boshqaradigan himoyalangan kalitlar va ularning saqlashni himoyalash xususiyatlari ko‘rsatilgan.“Eksport qilinmaydigan” deb belgilangan oʻralgan kalitlardan foydalanish mumkin, lekin foydalanish mumkin emas viewed yoki ish vaqtida ulashilgan. “Eksport qilinadigan” deb belgilangan oʻralgan kalitlar ish vaqtida ishlatilishi yoki baham koʻrilishi mumkin, lekin Flashda saqlanganida shifrlangan holda qoladi. Foydalanuvchi ilovalari hech qachon ushbu kalitlarning aksariyati bilan o'zaro aloqada bo'lishi shart emas. Mavjud API-lar havolalar jadvali kalitlarini yoki vaqtinchalik kalitlarni boshqarish uchun hali ham foydalanuvchi ilovasida mavjud va ular Zigbee Security Manager komponenti orqali yo'naltiriladi.

Xavfsizlik bo'yicha maslahatlar
Xavfsizlik boʻyicha maslahatlarga obuna boʻlish uchun Silicon Labs mijozlar portaliga kiring, soʻng “Hisob uyi” ni tanlang. Portalning bosh sahifasiga o‘tish uchun HOME tugmasini bosing va keyin Bildirishnomalarni boshqarish katakchasini bosing. “Dasturiy taʼminot/Xavfsizlik boʻyicha maslahat xabarlari va Mahsulot oʻzgarishi boʻyicha bildirishnomalar (PCNs)” belgilanganligiga va platformangiz va protokolingizga kamida obuna boʻlganingizga ishonch hosil qiling. Har qanday o'zgarishlarni saqlash uchun Saqlash tugmasini bosing.

Qo'llab-quvvatlash
Development Kit mijozlari o'qitish va texnik yordam olishlari mumkin. Silicon Laboratories Zigbee dan foydalaning web barcha Silicon Labs Zigbee mahsulotlari va xizmatlari haqida ma'lumot olish va mahsulotni qo'llab-quvvatlash uchun ro'yxatdan o'tish uchun sahifa. Silicon Laboratories qo'llab-quvvatlash bo'limiga murojaat qilishingiz mumkin http://www.silabs.com/support.

Zigbee sertifikati
Ember ZNet 8.1 versiyasi SoC, NC, P va RCP arxitekturalari uchun Zigbee muvofiq platformasi uchun malakali bo'lgan, bu nashrga ZCP sertifikati identifikatori bog'langan, iltimos CSA ni tekshiring. websayt bu yerda:
https://csa-iot.org/csa-iot_products/.

E'tibor bering, ZCP sertifikati filed relizni joylashtiring va CSAda aks ettirishdan oldin bir necha hafta davom etadi websayt. Qo'shimcha savollar uchun Silicon Laboratories qo'llab-quvvatlash xizmatiga murojaat qiling http://www.silabs.com/support.

Tez-tez so'raladigan savollar

Savol: SDK da APS havolasi kaliti jadvali hajmini qanday yangilashim mumkin?
Javob: APS havolasi kaliti jadvali hajmini SL_ZIGBEE_KEY_TABLE_SIZE parametri yordamida sozlash mumkin. 8.1 versiyasida u 127 tadan 254 tagacha kengaytirildi.

Savol: 8.1 versiyasida qanday yaxshilanishlar bor?
Javob: 8.1 versiyasida APS havolasi kalit jadvali hajmini kengaytirish, komponentlar nomini o‘zgartirish, Athe pp Framework voqea navbati uchun mutex himoyasini qo‘shish va boshqalar kabi yaxshilanishlar mavjud. Yaxshilashlarning batafsil ro'yxatini chiqarish eslatmalariga qarang.

Savol: SDKdagi aniqlangan muammolarni qanday hal qilishim mumkin?
Javob: SDKda tuzatilgan muammolar, jumladan, qoʻshni jadval oʻlchami konfiguratsiyasi bilan bogʻliq potentsial muammolarni hal qilish, komponentlar nomini oʻzgartirish, manba marshrutini toʻgʻirlash, ZCL buyruqlarini boshqarish va boshqalar. Ushbu tuzatishlardan foydalanish uchun oxirgi versiyaga yangilaganingizga ishonch hosil qiling.

Hujjatlar / manbalar

SILICON LABS Zigbee EmberZ Net SDK [pdf] Ko'rsatmalar
Zigbee EmberZ Net SDK, EmberZ Net SDK, Net SDK, SDK

Ma'lumotnomalar

Foydalanuvchi uchun qo'llanma

SILICON LABS Zigbee EmberZ Net SDK

Texnik xususiyatlari

Mahsulot haqida ma'lumot