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

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

ОСНОВНИ ХАРАКТЕРИСТИКИ

Зигби

-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 хост приложения – Alpha

Нови артикули

Важни промени
Размерът на таблицата с ключове за APS връзка (конфигуриран с помощта на SL_ZIGBEE_KEY_TABLE_SIZE) е разширен от 127 на 254 записа.

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

Компонентите Network Steering и Network Creator са актуализирани, за да включват поддръжка за R23 присъединяване. Те включват следните свързани промени.
- Правилата за заявка на ключ за свързване на центъра за сигурност (TCLK) по подразбиране са актуализирани, за да генерират нови ключове за всяко заявено устройство. Нов ключ се генерира всеки път, когато искащите устройства се опитат да актуализират своя ключ за връзка на центъра за сигурност.
- Поради предишната промяна на правилата на TCLK, компонентът за сигурност на Network Creator вече изисква компонента за ключове за връзка за сигурност. Надграждането на приложения ще бъде актуализирано, за да отговаря на това ново изискване.
- Нова конфигурация,
  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 устройството и неговите пин интерфейси.
Бившиятample проекти, включително проекта files (.slcps) и папката на проекта, се преименуват на указания за именуване на Silicon Labs и се преместват в директорията „projects“.

Поддръжка на нова платформа

Нови модули
- 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 и е остарял в тази версия. Таймерът за наблюдение е деактивиран по подразбиране за всички sample приложения. В бъдеще към SDK ще бъде добавен подобрен компонент за наблюдение.
Забележка: Активирайте таймера за наблюдение с конфигурационен елемент SL_LEGACY_HAL_DISABLE_WATCHDOG, зададен на 0 във вашето приложение

Мрежови ограничения и съображения

Приложенията по подразбиране на Trust Center, които се доставят с тази версия на EmberZNet, могат да поддържат няколко устройства в мрежата. Този брой се определя въз основа на няколко фактора, включително конфигурирани размери на таблици, използване на NVM и други стойности за време на генериране и време на изпълнение. Потребителите, които искат да създадат големи мрежи, могат да се сблъскат с проблеми с ресурсите, когато разрастват мрежата, по-голяма от тази, която приложението може да поддържа. Напримерample, устройство, изискващо ключ за свързване на център за сигурност от центъра за сигурност, може да задейства обратно извикване sl_zigbee_af_zigbee_key_establishment_cb в центъра за сигурност със статус 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)

Включване на компонента 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 sample приложения е 32K. Приложенията, които използват NVM по-интензивно, може да изискват още по-висока настройка на тази стойност.
- Големите мрежи с до 65 възела може да се нуждаят от размер на NVM3 кеша от 1200 байта; нарастващите мрежи, по-големи от това, може да изискват удвояване на тази стойност до 2400 байта.

Тези корекции се отнасят само за центъра за сигурност

Многопротоколен шлюз и 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 Unified radio scheduler priority“. Този компонент се използва за конфигуриране на радио приоритетите на стека 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 стек
Zigbee Application Framework
Зигби С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. Допълнителна информация често може да бъде намерена в статиите в базата знания (KBA). API препратки и друга информация за това и по-ранни издания са достъпни на https://docs.silabs.com/.

Информация за сигурност
Сигурна интеграция на Vault
За приложения, които избират да съхраняват ключове сигурно с помощта на компонента Secure Key Storage на частите Secure Vault-High, следващата таблица показва защитените ключове и техните характеристики за защита на съхранението, които компонентът Zigbee Security Manager управлява.Опакованите ключове, които са маркирани като „Неподлежащи на експортиране“, могат да се използват, но не могат viewредактиран или споделен по време на изпълнение. Опакованите ключове, които са маркирани като „Експортируеми“, могат да се използват или споделят по време на изпълнение, но остават криптирани, докато се съхраняват във Flash. Потребителските приложения никога не трябва да взаимодействат с повечето от тези ключове. Съществуващите приложни програмни интерфейси (API) за управление на ключовете на таблицата с ключове на връзката или преходните ключове все още са достъпни за потребителското приложение и се пренасочват през компонента Zigbee Security Manager.

Съвети за сигурност
За да се абонирате за Съвети за сигурност, влезте в портала за клиенти на Silicon Labs, след което изберете Начало на акаунта. Щракнете върху НАЧАЛО, за да отидете на началната страница на портала и след това щракнете върху плочката Управление на известията. Уверете се, че „Софтуер/Съветни бележки за сигурност и Известия за промяна на продукта (PCNs)“ е отметнато и че сте абонирани поне за вашата платформа и протокол. Щракнете върху Запазване, за да запазите промените.

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

Сертификация Zigbee
Изданието Ember ZNet 8.1 е квалифицирано за Zigbee съвместима платформа за SoC, NC, P и RCP архитектури, има ZCP сертификационен идентификатор, свързан с това издание, моля, проверете CSA webсайт тук:
https://csa-iot.org/csa-iot_products/.

Моля, имайте предвид, че ZCP сертифицирането е filed публикува изданието и отнема няколко седмици, преди да бъде отразено в CSA 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

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

Информация за продукта