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 host – Alpha

Новыя прадметы

Важныя змены
Памер табліцы ключоў спасылак APS (канфігуруецца з дапамогай SL_ZIGBEE_KEY_TABLE_SIZE) пашыраны са 127 да 254 запісаў.

Для функцыі ўводу ў эксплуатацыю сеткі ZDD дададзена падтрымка R23. Функцыянальнасць тунэлявання даступная без падтрымкі варыянтаў выкарыстання састарэлай сеткі.

Кампаненты Network Steering і Network Creator былі абноўлены, каб уключыць падтрымку далучэння R23. Яны ўключаюць наступныя звязаныя змены.
- Палітыка запыту ключа спасылкі цэнтра даверу (TCLK) па змаўчанні была абноўлена для стварэння новых ключоў для кожнай прылады, якая запытвае. Новы ключ ствараецца кожны раз, калі прылады, якія запытваюць, спрабуюць абнавіць ключ спасылкі цэнтра даверу.
- У сувязі з папярэдняй зменай палітыкі TCLK для кампанента Security Creator Security цяпер патрабуецца кампанент Security Link Keys. Абнаўленне прыкладанняў будзе абноўлена ў адпаведнасці з гэтым новым патрабаваннем.
- Новая канфігурацыя,
  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 і перамешчаны ў каталог «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 у вашым дадатку

Сеткавыя абмежаванні і меркаванні

Праграмы Цэнтра даверу па змаўчанні, якія пастаўляюцца з гэтым выпускам 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. Для прыкладанняў 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 Unified Radio Planner 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
Зігбі С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.Ключы ў абгортцы, пазначаныя як «Неэкспартаваныя», можна выкарыстоўваць, але нельга viewрэд або агульны доступ падчас выканання. Запакаваныя ключы, пазначаныя як «Экспартабельныя», можна выкарыстоўваць або абагульваць падчас выканання, але застаюцца зашыфраванымі падчас захоўвання ў 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.

FAQ

Пытанне: Як абнавіць памер табліцы ключоў спасылак APS у SDK?
A: Памер табліцы ключоў спасылак APS можна наладзіць з дапамогай параметра SL_ZIGBEE_KEY_TABLE_SIZE. У версіі 8.1 ён быў пашыраны са 127 да 254 запісаў.

Q: Якія паляпшэнні ў версіі 8.1?
A: Версія 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

Тэхнічныя характарыстыкі

Інфармацыя аб прадукце