Инструкции за SILICON LABS Zigbee EmberZ Net SDK

Silicon Labs е продавач на избор за OEM кои развиваат Zigbee вмрежување во нивните производи. Платформата на Silicon Labs Zigbee е најинтегрираното, најкомплетното и најбогатото Zigbee решение достапно. Silicon Labs EmberZNet SDK содржи имплементација на Silicon Labs на спецификацијата за стек Zigbee.

КЛУЧНИ КАРАКТЕРИСТИКИ

Зигби

-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 – Алфа

Нови артикли

Важни промени
Големината на табелата со клучот за поврзување APS (конфигурирана со SL_ZIGBEE_KEY_TABLE_SIZE) е проширена од 127 на 254 записи.

Поддршката за R23 е додадена за функционалноста за пуштање во работа на мрежата ZDD. Функционалноста за тунелирање е достапна без поддршка за случаи на употреба на Legacy Network.

Компонентите Network Steering и Network Creator се ажурирани за да вклучуваат поддршка за R23 приклучување. Тие ги вклучуваат следните поврзани промени.
- Стандардната политика за барање за клуч на доверлив центар (TCLK) е ажурирана за да генерира нови клучеви за секој уред што бара. Нов клуч се генерира секој пат кога уредите што бараат ќе се обидат да го ажурираат својот клуч за врска на Центарот за доверба.
- Поради претходната промена на политиката на TCLK, компонентата за безбедност на создавачот на мрежата сега бара компонента за клучеви за безбедносна врска. Надградбата на апликациите ќе се ажурира за да се усогласи со ова ново барање.
- Нова конфигурација,
  SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY е додаден за да се овозможи спојување со помош на јадро, хаширан клуч. Оваа конфигурација е пронајдена под компонентата Network Creator Security. Употребата на оваа политика му дозволува на секој уред што се приклучува да добие единствен TCLK по приклучувањето, но повторените обиди за ажурирање на TCLK нема да резултираат со нов клуч за уредот што бара. Ова користење на хаширани клучеви за врски беше стандардна политика пред ова издание, а употребата на оваа политика му дозволува на Центарот за доверба да избегне внесување на компонентата за безбедносни врски клучеви, која ги зачувува клучевите во 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
- BRD2709A
- MGM260P-EK2713A

Нова документација
Новите EZSP кориснички водичи UG600 за изданија 8.1 и погоре.

Подобрувања

Ограничувањата SL_ZIGBEE_KEY_TABLE_SIZE се проширија до 254 записи.
Додадени zigbee_security_link_keys на Z3Light.
Додадени zigbee_security_link_keys на zigbee_mp_z3_tc_z3_tc. Ја ажурираше и нејзината големина на клучната табела.
Ја зголеми големината на табелата со клучеви Z3 Gateway (која ќе биде поставена на ncp) на 20.

Поправени проблеми

Познати проблеми во тековното издание

Проблемите со задебелени букви беа додадени од претходното издание. Ако сте пропуштиле издание, белешките за неодамнешното издание се достапни на https://www.silabs.com/developers/zigbee-emberznet во табот Технички документи.

Застарени ставки

Компонентата zigbee_watchdog_periodic_refresh повеќе не се користи во рамката на апликацијата Zigbee и е застарена во ова издание. Тајмерот за набљудување е стандардно оневозможен за сите сampле апликации. Во иднина ќе биде додадена подобрена чуварска компонента на SDK.
Забелешка: Овозможете го тајмерот за набљудување со конфигурациската ставка SL_LEGACY_HAL_DISABLE_WATCHDOG поставена на 0 во вашата апликација

Мрежни ограничувања и размислувања

Стандардните апликации на Trust Center што се испорачуваат со ова издание на EmberZNet се способни да поддржуваат неколку уреди на мрежата. Овој број се одредува врз основа на неколку фактори, вклучувајќи ги конфигурираните големини на табелите, употребата на NVM и други вредности за времето на генерирање и времетраење. Корисниците кои сакаат да создадат големи мрежи може да се соочат со проблеми со ресурсите кога ќе ја зголемат мрежата поголема отколку што може да поддржи апликацијата. За прampле, уред кој бара клуч за врска на Центарот за доверба од Центарот за доверба може да активира sl_zigbee_af_zigbee_key_establishment_cb повратен повик на Центарот за доверба со h статус поставен на SL_ZIGBEE_KEY_TABLE_FULL, што покажува дека табелата со клучеви нема простор за барање на нов уред или тој клуч за NVM3 нема достапен простор. Silicon Labs ги дава следните препораки за корисниците кои сакаат да создадат големи мрежи. За апликациите на Trust Center, се препорачуваат следните конфигурации. Овие препораки не се исцрпни и служат како основа за апликации кои имаат намера да развијат големи мрежи.

Вклучување на компонентата Табела со адреси (zigbee_address_table), со
- ставката за конфигурација SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE е поставена на големината на саканата мрежа
- вредноста SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE е поставена на максимум (4)

Вклучување на компонентата Security Link Keys (zigbee_security_link_keys), со
- Вредноста SL_ZIGBEE_KEY_TABLE_SIZE е поставена на големината на мрежата
Следниве ставки за конфигурација се поставени на големината на саканата мрежа
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, како што се наоѓа во компонентата Zigbee Pro Stack
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, како што се наоѓа во компонентата за рутирање извор, доколку се користи рутирање на изворот
Приспособување на NVM3_DEFAULT_NVM_SIZE и NVM3_DEFAULT_CACHE_SIZE според употребата на NVM3
- На пр., големини на мрежа поголеми од 65 јазли веројатно бараат NVM3 големина од 64K. Стандардната големина на NVM3 во Silicon Labs Zigbee sampле апликации е 32K. Апликациите што користат NVM посилно може да бараат прилагодување на оваа вредност уште повисоко.
- На големи мрежи до 65 јазли може да им треба големина на кешот NVM3 од 1200 бајти; растечките мрежи поголеми од тоа може да бараат удвојување на оваа вредност до 2400 бајти.

Овие прилагодувања се однесуваат само на Центарот за доверба

Мултипротокол Gateway и RCP

Нови артикли
Овозможена поддршка за GA SoC за BLE DMP со Zigbee + Openthread CMP со истовремено слушање на делови од xG26. Поддршката за алфа на Debian е додадена за апликациите Zigbeed, OTBR и Z3Gateway. Zigbeed и OTBR се обезбедени во формат на DEB пакет и за избраната референтна платформа (Raspberry PI 4). Видете истовремено извршување на Zigbee, 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). Видете истовремено извршување на Zigbee, OpenThread и Bluetooth на домаќин на Linux со мултипротоколен копроцесор, пронајден на docs.silabs.com, за детали.

Поправени проблеми

Познати проблеми во тековното издание
Проблемите со задебелени букви беа додадени од претходното издание. Ако сте пропуштиле издание, достапни се белешките за неодамнешното изданиеhttps://www.silabs.com/developers/simplicity-software-development-kit.

Застарени ставки
„Мултипротоколниот контејнер“ кој моментално е достапен на DockerHub (siliconlabsinc/multiprotocol) ќе биде застарен во претстојното издание. Контејнерот веќе нема да се ажурира и ќе може да се повлече од DockerHub. Пакетите базирани на Debian за cpcd, ZigBee и ot-br-posix, заедно со природно генерирани и компајлирани проекти, ќе ја заменат изгубената функционалност со отстранување на контејнерот.

Користење на ова издание

Ова издание го содржи следново:

Зигби магацинот
Рамка за апликација Zigbee
Зигби Сample Апликации

За повеќе информации за Zigbee и EmberZNet SDK, видете UG103.02: Zigbee Fundamentals. Ако сте корисник за прв пат, видете QSG180: Zigbee EmberZNet Водич за брз почеток за SDK 7.0 и повисоки, за инструкции за конфигурирање на вашата развојна околина, градење и трепкање какоampле апликација и референци за документација кои укажуваат на следните чекори.

Инсталација и употреба
Zigbee EmberZNet SDK е обезбедена како дел од Simplicity SDK, пакетот на Silicon Labs SDK. За брзо да започнете со Simplicity SDK, инсталирајте го Simplicity Studio 5, кој ќе ја постави вашата развојна околина и ќе ве води низ инсталацијата на Simplicity SDK. Simplicity Studio 5 вклучува сè што е потребно за развој на IoT производи со уредите на Silicon Labs, вклучително и фрлач на ресурси и проекти, алатки за конфигурација на софтвер, целосен 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): /Корисници//SimplicityStudio/SDKs/simplicity_sdk

Документацијата специфична за верзијата SDK е инсталирана со SDK. Дополнителни информации често може да се најдат во статиите на базата на знаење (KBAs). Референци за API и други информации за ова и претходните изданија се достапни https://docs.silabs.com/.

Безбедносни информации
Безбедна интеграција на трезорот
За апликации кои избираат безбедно да ги складираат клучевите со помош на компонентата за складирање на безбедни клучеви на делови од Secure Vault-High, следната табела ги прикажува заштитените клучеви и нивните карактеристики за заштита на складирањето со кои управува компонентата Zigbee Security Manager.Завитканите клучеви што се означени како „Неизвезливи“ може да се користат, но не можат да се користат viewизменето или споделено при извршување. Завитканите клучеви кои се означени како „Извезливи“ може да се користат или споделуваат при извршување, но остануваат шифрирани додека се складирани во Flash. Корисничките апликации никогаш не треба да комуницираат со повеќето од овие клучеви. Постоечките API за управување со клучевите на Табелата со клучеви за врски или клучевите за преодни сè уште се достапни за корисничката апликација и се насочуваат преку компонентата Zigbee Security Manager.

Совети за безбедност
За да се претплатите на Security Advisories, најавете се на порталот за клиенти на Silicon Labs, а потоа изберете Account Home. Кликнете HOME за да отидете на почетната страница на порталот и потоа кликнете на плочката Управување со известувања. Осигурајте се дека е означено „Софтверски/безбедносни советодавни известувања и известувања за промена на производи (PCN)“ и дека сте претплатени најмалку за вашата платформа и протокол. Кликнете Зачувај за да ги зачувате сите промени.

Поддршка
Клиентите на пакетот за развој се подобни за обука и техничка поддршка. Користете ги Silicon Laboratories Zigbee web страница за да добиете информации за сите производи и услуги на Silicon Labs Zigbee и да се регистрирате за поддршка на производите. Можете да ја контактирате поддршката на Silicon Laboratories на http://www.silabs.com/support.

Zigbee сертификација
Изданието Ember ZNet 8.1 е квалификувано за Zigbee Compliant Platform за архитектури SoC, NC, P и RCP. webсајт тука:
https://csa-iot.org/csa-iot_products/.

Ве молиме имајте предвид дека сертификатот ZCP е fileда го објавите објавувањето и потребни се неколку недели пред да се рефлектираат за АДС webсајт. За какви било дополнителни прашања, ве молиме контактирајте со поддршката на Silicon Laboratories на http://www.silabs.com/support.

Најчесто поставувани прашања

П: Како да ја ажурирам големината на табелата со клучот за поврзување APS во SDK?
О: Големината на табелата со клучот за поврзување APS може да се конфигурира со помош на параметарот SL_ZIGBEE_KEY_TABLE_SIZE. Во верзијата 8.1, таа е проширена од 127 на 254 записи.

П: Кои се подобрувањата во верзијата 8.1?
О: Верзијата 8.1 носи подобрувања како што се проширување на големината на табелата со копчињата за поврзување APS, преименување на компонентите, додавање mutex заштита за редот за настани на Athe pp Framework и многу повеќе. Погледнете ги белешките за издавање за детален список на подобрувања.

П: Како да се справам со поправените проблеми во SDK?
О: Поправени проблеми во SDK, вклучително и решавање на потенцијални проблеми со конфигурацијата на големината на табелите на соседите, преименување на компонентите, поправање на изворната маршрута, ракување со командите на ZCL и многу повеќе. Погрижете се да се ажурирате на најновата верзија за да имате корист од овие поправки.

Документи / ресурси

SILICON LABS Zigbee EmberZ Net SDK [pdf] Инструкции
Zigbee EmberZ Net SDK, EmberZ Net SDK, Net SDK, SDK

Референци

Упатство за употреба

SILICON LABS Zigbee EmberZ Net SDK

Спецификации

Информации за производот