Инструкции по использованию SDK Zigbee EmberZ Net от SILICON LABS

Silicon Labs — поставщик, которого выбирают OEM-производители, внедряющие сетевое оборудование Zigbee в свои продукты. Платформа Silicon Labs Zigbee — это наиболее интегрированное, полное и многофункциональное решение Zigbee из доступных. Silicon Labs EmberZNet SDK содержит реализацию спецификации стека 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. Они включают следующие связанные изменения.
- Политика запроса Trust Center Link Key (TCLK) по умолчанию была обновлена для генерации новых ключей для каждого запрашивающего устройства. Новый ключ генерируется каждый раз, когда запрашивающие устройства пытаются обновить свой Trust Center Link Key.
- Из-за предыдущего изменения политики 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 не приведут к созданию нового ключа для запрашивающего устройства. Такое использование хэшированных ключей ссылок было политикой по умолчанию до этого выпуска, и использование этой политики позволяет Центру управления безопасностью избегать использования компонента Security Link Keys, который сохраняет ключи во 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
Комплект исследователя
- БРД2709А
- 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 (которая будет установлена на ncp) до 20.

Исправленные проблемы

Известные проблемы в текущей версии

Проблемы, выделенные жирным шрифтом, были добавлены с момента предыдущего выпуска. Если вы пропустили какой-либо выпуск, последние примечания к выпуску доступны по адресу https://www.silabs.com/developers/zigbee-emberznet во вкладке Техническая документация.

Устаревшие элементы

Компонент zigbee_watchdog_periodic_refresh больше не используется в фреймворке приложений Zigbee и устарел в этом выпуске. Таймер сторожевого таймера отключен по умолчанию для всех sample applications. В будущем в SDK будет добавлен улучшенный компонент watchdog.
Примечание: Включите сторожевой таймер, установив в своем приложении значение 0 для элемента конфигурации SL_LEGACY_HAL_DISABLE_WATCHDOG

Ограничения и соображения по сети

Приложения Trust Center по умолчанию, которые поставляются с этим выпуском EmberZNet, способны поддерживать несколько устройств в сети. Это число определяется на основе нескольких факторов, включая настроенные размеры таблиц, использование NVM и другие значения времени генерации и времени выполнения. Пользователи, стремящиеся создать большие сети, могут столкнуться с проблемами ресурсов при увеличении сети больше, чем может поддерживать приложение. НапримерampНапример, устройство, запрашивающее ключ ссылки центра доверия из центра доверия, может инициировать обратный вызов 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 applications составляет 32K. Приложения, которые используют NVM более интенсивно, могут потребовать еще большей настройки этого значения.
- Для больших сетей, насчитывающих до 65 узлов, может потребоваться кэш NVM3 размером 1200 байт; для сетей большего размера может потребоваться удвоение этого значения до 2400 байт.

Эти корректировки применяются только к Центру доверия.

Многопротокольный шлюз и RCP

Новые товары
Включена поддержка GA SoC для BLE DMP с Zigbee + Openthread CMP с одновременным прослушиванием на частях xG26. Добавлена поддержка Debian alpha для приложений 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, подробнее.

Исправленные проблемы

Известные проблемы в текущей версии
Выделенные жирным шрифтом проблемы были добавлены после предыдущего выпуска. Если вы пропустили выпуск, последние заметки о выпуске доступны oathttps://www.silabs.com/developers/simplicity-software-development-kit.

Устаревшие элементы
«Multiprotocol Container», который в настоящее время доступен на DockerHub (siliconlabsinc/multiprotocol), будет объявлен устаревшим в предстоящем выпуске. Контейнер больше не будет обновляться и не сможет быть извлечен из DockerHub. Пакеты на основе Debian для cpcd, ZigBee и ot-br-posix, а также изначально сгенерированные и скомпилированные проекты заменят функциональность, утраченную с удалением контейнера.

Использование этого выпуска

Этот выпуск содержит следующее:

Зигби-стек
Платформа приложений Zigbee
Зигби Сampле Приложения

Дополнительные сведения о Zigbee и EmberZNet SDK см. в разделе UG103.02: Основы Zigbee. Если вы впервые пользуетесь им, см. QSG180: Краткое руководство Zigbee EmberZNet для SDK 7.0 и выше, где приведены инструкции по настройке среды разработки, сборке и обновлению какampприложение le и ссылки на документацию, указывающие на дополнительные шаги.

Установка и использование
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/.

Информация о безопасности
Безопасная интеграция с хранилищем
Для приложений, которые предпочитают безопасно хранить ключи с помощью компонента Secure Key Storage в частях Secure Vault-High, в следующей таблице показаны защищенные ключи и характеристики защиты их хранилища, которыми управляет компонент Zigbee Security Manager.Завернутые ключи, помеченные как «Неэкспортируемые», можно использовать, но нельзя viewредактируются или передаются во время выполнения. Запакованные ключи, помеченные как «Экспортируемые», могут использоваться или передаваться во время выполнения, но остаются зашифрованными при хранении во Flash. Пользовательским приложениям никогда не нужно взаимодействовать с большинством этих ключей. Существующие API для управления ключами Link Key Table или Transient Keys по-прежнему доступны пользовательскому приложению и только направляются через компонент Zigbee Security Manager.

Советы по безопасности
Чтобы подписаться на советы по безопасности, войдите на клиентский портал Silicon Labs и выберите «Домашняя страница учетной записи». Щелкните ГЛАВНАЯ, чтобы перейти на домашнюю страницу портала, а затем щелкните плитку Управление уведомлениями. Убедитесь, что установлен флажок «Уведомления о программном обеспечении/рекомендациях по безопасности и уведомления об изменении продукта (PCN)» и что вы подписаны как минимум на свою платформу и протокол. Нажмите Сохранить, чтобы сохранить изменения.

Поддерживать
Клиенты Development Kit имеют право на обучение и техническую поддержку. Используйте кремниевые лаборатории Zigbee 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?
A: Размер таблицы ключей ссылок APS можно настроить с помощью параметра SL_ZIGBEE_KEY_TABLE_SIZE. В версии 8.1 он был расширен со 127 до 254 записей.

В: Какие улучшения в версии 8.1?
A: Версия 8.1 приносит улучшения, такие как расширение размера таблицы ключей ссылок APS, переименование компонентов, добавление защиты мьютекса для очереди событий pp Framework и многое другое. Подробный список улучшений см. в примечаниях к выпуску.

В: Как мне устранить исправленные проблемы в SDK?
A: Исправлены проблемы в 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

Технические характеристики

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