SILICON LABS Zigbee EmberZ Net SDK нұсқаулары

Silicon Labs - Zigbee желісін өз өнімдерінде дамытатын OEM үшін таңдаулы жеткізуші. Silicon Labs Zigbee платформасы қол жетімді ең интеграцияланған, толық және мүмкіндіктері мол Zigbee шешімі болып табылады. Silicon Labs EmberZNet SDK Silicon Labs компаниясының Zigbee стек спецификациясын іске асыруды қамтиды.

НЕГІЗГІ МҮМКІНДІКТЕР

Зигби

APS сілтеме кілті кестесіндегі -250+ жазба
Android 12 (v21.0.6113669) және Tizen (v0.1-13.1) жүйелерінде ZigbeeD қолдауы

xG26 модулін қолдау

Көппротокол

OpenWRT – GA жүйесінде ZigbeeD және OTBR қолдауы
DMP BLE + CMP ZB & Matter/OT SoC – GA үшін MG26 бір мезгілде тыңдау

802.15.4 Бірыңғай радио жоспарлаушы басымдық құрамдас бөлігі
MP хост қосымшалары үшін Debian бумасын қолдау – Альфа

Жаңа элементтер

Маңызды өзгерістер
APS сілтеме кілті кестесінің өлшемі (SL_ZIGBEE_KEY_TABLE_SIZE көмегімен конфигурацияланған) 127-ден 254 жазбаға дейін кеңейтілген.

R23 қолдауы ZDD желісін іске қосу функционалдығы үшін қосылған. Tunneling функциясы Legacy Network пайдалану жағдайларын қолдаусыз қол жетімді.

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 жаңарту әрекетін қайталау сұраушы құрылғы үшін жаңа кілтке әкелмейді. Бұл шығарылымға дейін хэштелген сілтеме кілттерін пайдалану әдепкі саясат болды және бұл саясатты пайдалану Сенім орталығына Flash бағдарламасында кілттерді сақтайтын Security Link Keys құрамдас бөлігін әкелмеуге мүмкіндік береді.
  Ескерту: 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 жазбаға дейін кеңейтілді.
Z3Light жүйесіне zigbee_security_link_keys қосылды.
zigbee_security_link_keys zigbee_mp_z3_tc_z3_tc қосылды. Оның негізгі кесте өлшемі де жаңартылды.
Z3 Gateway кілті кестесінің өлшемі (ол ncp мәніне орнатылады) 20-ға дейін ұлғайтылды.

Түзетілген мәселелер

Ағымдағы шығарылымдағы белгілі мәселелер

Алдыңғы шығарылымнан бастап қалың қаріппен жазылған мәселелер қосылды. Егер сіз шығарылымды өткізіп алсаңыз, соңғы шығарылым ескертпелерін мына жерден алуға болады https://www.silabs.com/developers/zigbee-emberznet Tech Docs қойындысында.

Ескірген элементтер

zigbee_watchdog_periodic_refresh компоненті бұдан былай Zigbee қолданбасы шеңберінде пайдаланылмайды және бұл шығарылымда ескірген. Күзет таймері барлық с үшін әдепкі бойынша өшірілгенampқолданбалар. Болашақта SDK-ға жақсартылған бақылаушы компоненті қосылады.
Ескерту: Қолданбаңызда SL_LEGACY_HAL_DISABLE_WATCHDOG конфигурация элементі 0-ге орнатылған бақылаушы таймерін қосыңыз

Желілік шектеулер мен қарастырулар

Осы EmberZNet шығарылымымен бірге жеткізілетін әдепкі Trust Center қолданбалары желідегі бірнеше құрылғыларға қолдау көрсете алады. Бұл сан конфигурацияланған кесте өлшемдерін, NVM пайдалануын және басқа генерациялау уақыты мен орындалу уақытының мәндерін қоса алғанда, бірнеше факторлар негізінде анықталады. Үлкен желілерді жасағысы келетін пайдаланушылар желіні қолданба қолдайтыннан үлкенірек ұлғайту кезінде ресурс мәселелеріне тап болуы мүмкін. Мысалыample, Сенім орталығынан Сенім орталығының сілтеме кілтін сұрайтын құрылғы сенім орталығында h күйі SL_ZIGBEE_KEY_TABLE_FULL күйіне орнатылған sl_zigbee_af_zigbee_key_establishment_cb кері қоңырауды іске қосуы мүмкін, бұл кілттер кестесінде жаңа кілтті қосуға немесе жаңа кілт қосуға арналған орын жоқ екенін көрсетеді. NVM3 жүйесінде бос орын жоқ. Silicon Labs үлкен желілерді құрғысы келетін пайдаланушылар үшін келесі ұсыныстарды ұсынады. Сенім орталығының қолданбалары үшін келесі конфигурациялар ұсынылады. Бұл ұсыныстар толық емес және олар үлкен желілерді өсіруді көздейтін қолданбалар үшін негіз болады.

Мекенжай кестесі компонентін қосу (zigbee_address_table), бар
- SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE конфигурация элементі қалаған желінің өлшеміне орнатылған
- SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE мәні максимумға орнатылған (4)

Қауіпсіздік сілтеме кілттері құрамдас бөлігі (zigbee_security_link_keys), бар
- SL_ZIGBEE_KEY_TABLE_SIZE мәні желі өлшеміне орнатылған
Келесі конфигурация элементтері қалаған желінің өлшеміне орнатылған
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, Zigbee Pro Stack компонентінде табылғандай
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, егер бастапқы бағыттау пайдаланылса, Source router компонентінде табылған
NVM3 пайдалануына сәйкес NVM3_DEFAULT_NVM_SIZE және NVM3_DEFAULT_CACHE_SIZE реттеу
- Мысалы, 65 түйіннен асатын желі өлшемдері 3K NVM64 өлшемін қажет етеді. Silicon Labs Zigbee s жүйесіндегі әдепкі NVM3 өлшеміampқолданбалар саны 32 мың. NVM-ді көбірек пайдаланатын қолданбалар бұл мәнді одан да жоғары реттеуді қажет етуі мүмкін.
- 65 түйінге дейінгі үлкен желілер үшін 3 байттық NVM1200 кэш өлшемі қажет болуы мүмкін; одан үлкен желілерді өсіру үшін бұл мәнді 2400 байтқа дейін екі еселеу қажет болуы мүмкін.

Бұл түзетулер тек Сенім орталығына қолданылады

Көппротоколды шлюз және RCP

Жаңа элементтер
xG26 бөліктерін бір мезгілде тыңдау арқылы Zigbee + Openthread CMP бар BLE DMP үшін GA SoC қолдауы қосылған. Zigbeed, OTBR және Z3Gateway қолданбалары үшін Debian альфа қолдауы қосылды. Zigbeed және OTBR таңдалған анықтамалық платформа (Raspberry PI 4) үшін де DEB пакет пішімінде берілген. Көппротоколды қосалқы процессоры бар Linux хостында Zigbee, OpenThread және Bluetooth бір мезгілде іске қосу бөлімін қараңыз. docs.silabs.com, мәліметтер үшін. arm0.1 және aarch13.1 үшін Tizen-32-64, сондай-ақ aarch12 үшін Android 64 үшін Zigbeed қолдауы қосылды. Zigbeed туралы қосымша ақпаратты мына жерден табуға болады docs.silabs.com. Жаңа «802.15.4 Бірыңғай радио жоспарлаушының басымдығы» құрамдас бөлігі қосылды. Бұл компонент 15.4 стекінің радио басымдықтарын конфигурациялау үшін пайдаланылады. Құрамдас жаңа “radio_priority_configurator” компонентін де қажет етеді. Бұл құрамдас жобаларға Simplicity Studio бағдарламасындағы Радио басымдылығын конфигурациялау құралын оны қажет ететін стектердің радио басымдылық деңгейлерін конфигурациялау үшін пайдалануға мүмкіндік береді.

Жақсартулар
Қолданба жазбасы Zigbee, OpenThread және Bluetooth жүйелерін бір уақытта Linux хостында мультипротоколды бірлескен процессормен (AN1333) іске қосу келесіге жылжытылды docs.silabs.com. OpenWRT қолдауы енді GA сапасы. Zigbee, OTBR және Z3Gateway қолданбалары үшін OpenWRT қолдауы қосылды. Zigbeed және OTBR анықтамалық платформа (Raspberry PI 4) үшін де IPK пакет пішімінде берілген. Көппротоколды қосалқы процессоры бар Linux хостында Zigbee, OpenThread және Bluetooth бір мезгілде іске қосу бөлімін қараңыз. docs.silabs.com, мәліметтер үшін.

Түзетілген мәселелер

Ағымдағы шығарылымдағы белгілі мәселелер
Алдыңғы шығарылымнан бастап қалың қаріппен жазылған мәселелер қосылды. Егер сіз шығарылымды өткізіп алсаңыз, соңғы шығарылым ескертпелері қол жетімдіhttps://www.silabs.com/developers/simplicity-software-development-kit.

Ескірген элементтер
Қазіргі уақытта DockerHub жүйесінде (siliconlabsinc/multiprotocol) қолжетімді «Көп хаттамалық контейнер» алдағы шығарылымда ескіреді. Контейнер енді жаңартылмайды және оны DockerHub жүйесінен шығару мүмкін болмайды. cpcd, ZigBee және ot-br-posix үшін Debian негізіндегі бумалар, жергілікті түрде жасалған және құрастырылған жобалармен бірге контейнерді жою арқылы жоғалған функционалдылықты ауыстырады.

Осы шығарылымды пайдалану

Бұл шығарылым мыналарды қамтиды:

Зигби стек
Zigbee қолданбалы құрылымы
Зигби Сample Қолданбалар

Zigbee және EmberZNet SDK туралы қосымша ақпаратты UG103.02: Zigbee негіздері бөлімінен қараңыз. Егер сіз бірінші рет пайдаланушы болсаңыз, әзірлеу ортасын конфигурациялау, құру және келесідей жыпылықтау туралы нұсқауларды QSG180: Zigbee EmberZNet SDK 7.0 және одан жоғары нұсқаларына арналған жылдам іске қосу нұсқаулығын қараңыз.ample қолданбасы және қосымша қадамдарды көрсететін құжаттама сілтемелері.

Орнату және пайдалану
Zigbee EmberZNet SDK Simplicity SDK бөлігі, Silicon Labs SDK жиынтығы ретінде қамтамасыз етілген. Simplicity SDK-мен жылдам бастау үшін Simplicity Studio 5 бағдарламасын орнатыңыз, ол әзірлеу ортаңызды орнатады және Simplicity SDK орнатуы арқылы сізді көрсетеді. Simplicity Studio 5 IoT өнімдерін Silicon Labs құрылғыларымен әзірлеуге қажеттінің барлығын қамтиды, соның ішінде ресурс пен жобаны іске қосу құралы, бағдарламалық құрал конфигурациялау құралдары, GNU құралдар тізбегі бар толық IDE және талдау құралдары. Орнату нұсқаулары онлайн 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 көмегімен орнатылады. Қосымша ақпаратты жиі білім қоры мақалаларынан (КБА) табуға болады. API сілтемелері және осы және бұрынғы шығарылымдар туралы басқа ақпарат қол жетімді https://docs.silabs.com/.

Қауіпсіздік туралы ақпарат
Қауіпсіз қойма интеграциясы
Secure Vault-High бөліктерінде Secure Key Storage компонентін пайдаланып кілттерді қауіпсіз сақтауды таңдайтын қолданбалар үшін келесі кесте Zigbee Security Manager құрамдас бөлігі басқаратын қорғалған кілттер мен олардың сақтауды қорғау сипаттамаларын көрсетеді.«Экспортталмайтын» деп белгіленген оралған кілттерді пайдалануға болады, бірақ мүмкін емес viewed немесе орындау уақытында ортақ. «Экспортталатын» деп белгіленген оралған кілттерді орындау уақытында пайдалануға немесе ортақ пайдалануға болады, бірақ Flash ішінде сақталған кезде шифрланған күйде қалады. Пайдаланушы қолданбалары ешқашан осы кілттердің көпшілігімен өзара әрекеттесудің қажеті жоқ. Сілтеме кілті кестесінің кілттерін немесе өтпелі кілттерді басқаруға арналған бар API интерфейстері әлі де пайдаланушы қолданбасында қолжетімді және Zigbee қауіпсіздік реттеушісі құрамдас бөлігі арқылы бағытталады.

Қауіпсіздік кеңестері
Қауіпсіздік кеңестеріне жазылу үшін Silicon Labs тұтынушы порталына кіріңіз, содан кейін Есептік жазбаның негізгі бетін таңдаңыз. Порталдың басты бетіне өту үшін HOME түймесін басыңыз, содан кейін Хабарландыруларды басқару тақтасын басыңыз. "Бағдарламалық қамтамасыз ету/қауіпсіздік бойынша кеңестік ескертулер және өнімді өзгерту туралы ескертулер (PCNs)" тексерілгеніне және платформаңыз бен протоколыңызға кемінде жазылғаныңызды тексеріңіз. Кез келген өзгертулерді сақтау үшін Сақтау түймесін басыңыз.

Қолдау
Development Kit тұтынушылары оқытуға және техникалық қолдауға құқылы. Silicon Laboratories Zigbee пайдаланыңыз web барлық Silicon Labs Zigbee өнімдері мен қызметтері туралы ақпаратты алу және өнімді қолдау қызметіне жазылу үшін бет. Silicon Laboratories қолдау көрсету орталығына хабарласуға болады http://www.silabs.com/support.

Zigbee сертификаты
Ember ZNet 8.1 шығарылымы SoC, NC, P және RCP архитектуралары үшін Zigbee үйлесімді платформасы үшін жарамды, осы шығарылымға байланысты ZCP сертификаттау идентификаторы бар, CSA тексеріңіз. webмына сайт:
https://csa-iot.org/csa-iot_products/.

ZCP сертификаты екенін ескеріңіз filed шығарылымды жариялайды және CSA-да көрініс табу үшін бірнеше апта қажет webсайт. Қосымша сұрақтар бойынша Silicon Laboratories қолдау қызметіне хабарласыңыз http://www.silabs.com/support.

Жиі қойылатын сұрақтар

С: SDK ішіндегі APS сілтеме кілті кестесінің өлшемін қалай жаңартуға болады?
A: APS сілтеме кілті кестесінің өлшемін SL_ZIGBEE_KEY_TABLE_SIZE параметрі арқылы конфигурациялауға болады. 8.1 нұсқасында ол 127-ден 254 жазбаға дейін кеңейтілді.

С: 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

Техникалық сипаттамалар

Өнім туралы ақпарат