SILICON LABS Zigbee EmberZ Net SDK Інструкції

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

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

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. Функція тунелювання доступна без підтримки сценаріїв використання застарілої мережі.

Компоненти 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 не призведуть до нового ключа для пристрою, який запитує. Таке використання хешованих ключів посилань було політикою за замовчуванням до цього випуску, і використання цієї політики дозволяє Центру довіри уникнути залучення компонента Security Link Keys, який зберігає ключі у Flash.
  Примітка: Silicon Labs не рекомендує використовувати цю політику, оскільки це запобігає згортанню або оновленню TCLK приєднаних пристроїв.

Новий набір конфігурацій додається до компонента zigbee_ezsp_spi, щоб дозволити конфігурацію хост-пристрою SPI та його контактних інтерфейсів.
Колишнійampле проекти, в тому числі проект 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 і в цьому випуску не підтримується. Сторожовий таймер за замовчуванням вимкнено для всіх sampпрограми le. У майбутньому до 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 надає наступні рекомендації для користувачів, які прагнуть створити великі мережі. Для програм 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 64 КБ. Розмір NVM3 за замовчуванням у Silicon Labs Zigbee sampдодатків становить 32 тис. Програми, які інтенсивніше використовують NVM, можуть потребувати ще більшого налаштування цього значення.
- Для великих мереж до 65 вузлів може знадобитися розмір кешу NVM3 1200 байт; зростаючі мережі, більші за це, можуть вимагати подвоєння цього значення до 2400 байт.

Ці налаштування застосовуються лише до Центру безпеки та безпеки

Багатопротокольний шлюз і RCP

Нові предмети
Увімкнено підтримку GA SoC для BLE DMP із Zigbee + Openthread CMP із одночасним прослуховуванням частин xG26. Для програм Zigbeed, OTBR і Z3Gateway додано підтримку Debian alpha. 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
Фреймворк додатків Zigbee
Зігбі Сample Додатки

Для отримання додаткової інформації про Zigbee та EmberZNet SDK див. UG103.02: Основи Zigbee. Якщо ви користуєтеся вперше, перегляньте QSG180: Короткий посібник Zigbee EmberZNet для SDK 7.0 і новіших версій, щоб отримати інструкції щодо налаштування середовища розробки, створення та перепрошивки якampпрограму та посилання на документацію, що вказують на додаткові кроки.

Встановлення та використання
Zigbee EmberZNet SDK надається як частина Simplicity SDK, набору SDK Silicon Labs. Щоб швидко розпочати роботу з 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): /Users//SimplicityStudio/SDKs/simplicity_sdk

Документація, що стосується версії SDK, інсталюється разом із SDK. Додаткову інформацію часто можна знайти в статтях бази знань (KBA). Посилання на API та іншу інформацію про цей і попередні випуски доступні за адресою https://docs.silabs.com/.

Інформація про безпеку
Безпечна інтеграція сховища
Для програм, які вирішили безпечно зберігати ключі за допомогою компонента Secure Key Storage на частинах Secure Vault-High, у наступній таблиці показано захищені ключі та їхні характеристики захисту зберігання, якими керує компонент Zigbee Security Manager.Запаковані ключі, позначені як «Не експортовані», можна використовувати, але не можна viewed або спільний доступ під час виконання. Запаковані ключі, позначені як «Експортовані», можна використовувати або надавати спільний доступ під час виконання, але залишаються зашифрованими під час зберігання у Flash. Додаткам користувача ніколи не потрібно взаємодіяти з більшістю цих ключів. Існуючі API для керування ключами таблиці ключів посилань або тимчасовими ключами все ще доступні для користувальницьких програм і не передаються через компонент Zigbee Security Manager.

Консультації з питань безпеки
Щоб підписатися на рекомендації щодо безпеки, увійдіть на портал для клієнтів Silicon Labs і виберіть Головна сторінка облікового запису. Клацніть ДОМОВИЙ, щоб перейти на домашню сторінку порталу, а потім клацніть плитку Керування сповіщеннями. Переконайтеся, що позначено «Повідомлення про програмне забезпечення/безпеку та повідомлення про зміну продукту (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, перевірте 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, перейменування компонентів, додавання захисту від м’ютексу для черги подій Athe 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

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

Інформація про продукт