SILICON LABS SDK 7.4.1.0 GA Zigbee протокол стек софтуер
Информация за продукта
Спецификации
- Zigbee EmberZNet SDK версия: 7.4.1.0
- Версия на Gecko SDK Suite: 4.4 – 14 февруари 2024 г
- Доставчик: Силиконови лаборатории
- Ключови характеристики: Многопротоколна поддръжка на Zigbee и OpenThread на SoC
- Съвместими компилатори: GCC версия 12.2.1
- Версия на протокола EZSP: 0x0D
Инструкции за употреба на продукта
Уведомления за съвместимост и употреба
- За актуализации и бележки за сигурността вижте главата за сигурност на бележките за изданието на Gecko Platform, инсталирани с този SDK, или посетете раздела TECH DOCS на Silicon Labs webсайт.
- Бъдете в течение, като се абонирате за Съвети за сигурност.
ЧЗВ
- Въпрос: Как да проверя правилността files се използват със съвместимите компилатори?
- отговор: Можете да проверите дали е правилно files се използват чрез проверка на GCC версия 12.2.1, предоставена със Simplicity Studio.
- Въпрос: Къде мога да намеря информация за актуализации и бележки за защита?
- отговор: За актуализации и забележки за сигурността вижте главата за сигурност на бележките по изданието на Gecko Platform или посетете раздела TECH DOCS на Silicon Labs' webсайт.
Silicon Labs е предпочитаният доставчик за OEM производителите, които разработват Zigbee мрежи в своите продукти. Платформата Zigbee на Silicon Labs е най-интегрираното, завършено и богато на функции Zigbee решение на разположение.
EmberZNet SDK на Silicon Labs съдържа изпълнението на спецификацията на стека Zigbee от Silicon Labs.
- Тези бележки по изданието обхващат версия(и) на SDK:
- 7.4.1.0 издаден на 14 февруари 2024 г
- 7.4.0.0 издаден на 13 декември 2023 г
ОСНОВНИ ХАРАКТЕРИСТИКИ
Зигби
- Zigbee R23 съответствие
- Zigbee Smart Energy 1.4a съответствие – производство
- Съвместимост с Zigbee GP 1.1.2 – Alpha
- Поддръжка на MG27 – производство
- Подобрена поддръжка за части на Secure Vault
- Sleepy поддръжка на NCP SPI (не-CPC) приложения – Alpha
Мултипротокол
- Поддръжка за едновременно слушане (RCP) – MG21 и MG24
- Едновременен мултипротокол (CMP) Zigbee NCP + OpenThread RCP – производство
- Dynamic Multiprotocol Bluetooth + Concurrent Multiprotocol (CMP) Zigbee и OpenThread поддръжка на SoC
Уведомления за съвместимост и употреба
За информация относно актуализации на защитата и бележки, вижте главата за сигурност на бележките за изданието на Gecko Platform, инсталирани с този SDK, или в раздела TECH DOCS на https://www.silabs.com/developers/zigbee-emberznet. Silicon Labs също силно препоръчва да се абонирате за Съвети за сигурност за актуална информация. За инструкции или ако сте нов в Zigbee EmberZNet SDK, вижте Използване на тази версия.
Съвместими компилатори
- IAR Embedded Workbench за ARM (IAR-EWARM) версия 9.40.1.
- Използването на Wine за изграждане с помощната програма за команден ред IarBuild.exe или IAR Embedded Workbench GUI на macOS или Linux може да доведе до неправилно files се използва поради сблъсъци в алгоритъма за хеширане на Wine за генериране на short file имена.
- Клиентите на macOS или Linux се съветват да не създават с IAR извън Simplicity Studio. Клиентите, които го правят, трябва внимателно да проверят дали е правилно files се използват.
GCC (The GNU Compiler Collection) версия 12.2.1, предоставена със Simplicity Studio.
Версията на протокола EZSP за тази версия е 0x0D.
Нови артикули
Тази версия на Gecko SDK (GSDK) ще бъде последната с комбинирана поддръжка за всички EFM и EFR устройства, с изключение на корекциите към тази версия, ако е необходимо. От средата на 2024 г. ще въведем отделни SDK:
- Съществуващият Gecko SDK ще продължи да поддържа устройства от серия 0 и 1.
- Нов комплект за разработване на софтуер (SDK) ще се грижи специално за устройства от серия 2 и 3.
Gecko SDK ще продължи да поддържа всички устройства от серия 0 и 1 без промяна в дългосрочната поддръжка, поддръжка, качество и отзивчивост, предоставени съгласно нашата софтуерна политика.
Новият SDK ще се разклони от Gecko SDK и ще започне да предлага нови функции, които помагат на разработчиците да напреднатtage от разширените възможности на нашите продукти от Серия 2 и 3.
Това решение е в съответствие с отзивите на клиентите, отразявайки нашия ангажимент да повишим качеството, да гарантираме стабилност и да подобрим производителността за изключително потребителско изживяване в нашите софтуерни SDK.
Нови компоненти
Ново в изданието
- Компонентите „zigbee_direct_security_p256“ и „zigbee_direct_security_curve25519“ са добавени, така че потребителите да могат да конфигурират конкретна опция за сигурност на Zigbee Direct.
- На потребителите е разрешено да имат активирани множество компоненти „zigbee_direct_security“ в приложение за директно устройство Zigbee (ZDD). В този случай действителната опция за сигурност зависи от конфигурацията на Zigbee Virtual Device (ZVD).
Нови API
Ново в изданието
- Добавен е нов API sl_zigbee_token_factory_reset за нулиране на токените Zigbee NVM3 до стойността им по подразбиране.
- Добавен е API bool sl_zigbee_sec_man_link_key_slot_available(EmberEUI64 eui), който връща true, ако таблицата с ключове за връзка може да добави или актуализира запис с този адрес (таблицата не е пълна).
- Добавен е нов API bool sl_zb_sec_man_compare_key_to_value (sl_zb_sec_man_context_t* контекст, sl_zb_sec_man_key_t* ключ), който връща true, ако ключът е посочен от контекста, има същата стойност като ключа, предоставен в аргумента.
Поддръжка на нова платформа
Ново в изданието
- Поддръжката на Zigbee стек за следните нови части е добавена в тази версия: EFR32MG24A010F768IM40 и EFR32MG24A020F768IM40.
Нова документация
Ново във версия 7.4.0.0
- Актуализирано е описанието за компонента Zigbee Secure Key Storage, за да отрази добавянето на Zigbee Secure Key Storage Upgrade (което добавя обратна съвместимост със съществуващи проекти).
- Добавена е нова бележка за приложението за взаимодействие с групата компоненти на Zigbee Security Manager (AN1412: Zigbee Security Manager).
Предвидено поведение
Напомняме на потребителите, че Zigbee несинхронизираните CSL предавания подлежат на изпреварване на протокола в радио планировчика. В приложенията SleepyToSleepy BLE може и ще изпревари Zigbee CSL предаване, което ще прекрати предаването. Изпреварването на планировчика е по-често срещано за несинхронизиран CSL, като се има предвид, че може да се използва потенциално дълга последователност от кадри за събуждане. Потребителите, които желаят да коригират приоритетите на предаване, могат да използват компонента за настройка и тестване на DMP, за да направят това. Потребителите могат също така да се консултират с UG305: Ръководство на потребителя за динамичен многопротокол за повече информация.
Подобрения
Променен в изданието
Промени в документа за API на emberCounterHandler
В предишни версии обратното извикване на Counter Handler за MAC и APS слой EmberCounterTypes по отношение на пакета RX и TX не се предаваше на правилния идентификатор на целеви възел или аргументи на данни, а API документацията относно поведението на определени броячи, които използваха тези параметри, беше неясна или подвеждаща.
Въпреки че подписът на emberCounterHandler() не се е променил, начинът, по който параметрите му се попълват, се е променил леко.
- Коментарите около преброяванията EmberCounterType в ember-types.h са разширени за яснота.
- Параметърът Node ID към Counter Handler за броячи, свързани с TX, сега проверява дали режимът на адрес на местоназначение показва валиден кратък ID, преди да го използва. (Ако не, не се попълва адрес на местоназначение и вместо това се използва стойност на контейнер EMBER_UNKNOWN_NODE_ID.)
- Параметърът за ИД на възел към манипулатора на брояча за броячи, свързани с RX, сега отразява ИД на възела източник, а не ИД на възела местоназначение.
- Броят на повторните опити *не* се предава като параметър за данни за EMBER_COUNTER_MAC_TX_UNICAST_ SUCCESS/FAILED броячи, както е описано в ember-types. h в предишни версии, но това никога не е било правилно попълвано в предишни версии, така че стойността му в предишни версии винаги е била 0. Това поведение е изяснено в описанието на тези EmberCounterTypes. Обаче броят на повторните опити за повторни опити на APS слой продължава да се попълва в параметъра за данни за типове броячи EMBER_COUNTER_APS_TX_UNICAST_SUCCESS/FAILED, за да бъде в съответствие с предишни версии.
- Всички броячи, които попълват ИД на възел или параметър на данни за обратното извикване, са одитирани, за да се гарантира, че предават очакваните данни, адрес или EMBER_UNKNOWN_NODE_ID, ако се очаква ИД на възел, но не може да бъде получен от пакета, както е описано в ревизирания ember- типовете.h документация.
- Обработчикът на брояча за EMBER_COUNTER_MAC_TX_UNICAST_RETRY вече отразява правилно идентификатора на целевия възел на MAC слоя и няколко повторни опита в неговия идентификатор на целевия възел и параметрите на данните.
- Обработчикът на брояча за EMBER_COUNTER_PHY_CCA_FAIL_COUNT вече предоставя информация за идентификатора на дестинационния възел чрез параметъра за идентификатор на възел относно предвидената цел на MAC слоя на съобщението, което е неуспешно предаване.
Актуализиран код за зелено захранване
Кодът на Green Power Server е актуализиран с различни подобрения, включително:
- Добавен е още код за валидиране за входящи команди с невалидна крайна точка при получаване на GP сървъра.
- Добавен код за справяне със случая, когато няма повече място за изграждане на съобщения за зелена мощност.
- Мивката вече премахва конфигурацията на сдвояване с действие за премахване на сдвояването в някои случаи съгласно раздел A.3.5.2.4.1 на спецификацията.
- Мивката вече запазва съществуващия групов списък на запис, преди да го премахне, когато обработва Конфигурация за сдвояване с действие разширение.
- Командата за заявка за превод връща „НЕ НАМЕРЕНО“ като код за грешка, когато таблицата за превод е празна или индексът е по-голям от няколко записа в таблицата.
- Променена е версията на крайната точка на GP в някои приложения от 1 на 0.
Използването на CSMA във функцията за изпращане на GPDF е ограничено, тъй като Green Power Devices са устройства с минимална енергия и не използват CSMA в повечето дизайни. Вместо това, предпочитаният дизайн е да се изпращат множество пакети, използвайки един и същ енергиен бюджет.
Премахнато е използването на скрита крайна точка в опцията за плъгин Green Power Server. Вместо това използвайте една от крайните точки на приложението.
Подобрения в кода на приставката за актуализиране на мрежов ключ
- Периодът за периодична актуализация на мрежовия ключ е променен до 1 година.
Преструктурирани някои API, за да се избегне ненужно експортиране на ключове
Направени са промени в полза на използването на ключови контексти пред ключови данни в обикновен текст.
- sl_zigbee_send_security_challenge_request вече приема аргумент sl_zb_sec_man_context_t вместо EmberKeyData.
- Стойностите на enum на sl_zb_sec_man_derived_key_type вече са 16-битова битова маска за директно поддържане на определени производни ключове, които комбинират множество производни типове.
Фиксирани проблеми
Фиксиран в изданието
| ДОКУМЕНТ ЗА САМОЛИЧНОСТ # | Описание |
| 1036893 | Коригиран проблем, който накара компонента на OTA клъстера да инсталира наследения компонент на интерфейса на зареждащото устройство като зависимост. |
| 1114905 | Zigbee Direct: Подобрена обработка на характеристиката за напускане на мрежата. |
| 1180937 | Коригирано нулиране на WDT при свързване на Zigbee Direct ZDD към ZVD на трета страна. |
| 1223904 | Коригиран проблем, който караше крайното устройство да работи неправилно в много натоварена среда. |
| 1224393 | Актуализиран е кодът на манипулатора на заявките за таблицата за поглъщане на Green Power, за да актуализира адреса на местоназначението на отговора. |
| 1228808 | Коригиран е проблемът с дисплея с дефиниции на макроси в документацията на gp-types.h. |
| 1232297 | Коригиран проблем, при който emberSetOutgoingNwkFrameCounter и emberSetOutgoingApsFrameCounter не работят на 64-битови хост приложения (връщат EMBER_BAD_ARGUMENT). |
| 1232359 | Коригирано е изчислението на параметъра gppTunnelingDelay при обработка на команди на клиент за зелена мощност. |
|
1240392 |
ZDO Bind/Unbind Requests, отказани поради причини за достъп/разрешение, трябва да връщат статус EMBER_ZDP_NOT_AUTHORIZED, а не статус EMBER_ZDP_NOT_PERMITTED според спецификациите на Zigbee. |
| 1243523 | Zigbee Direct: Подобрена стабилност на BLE връзката към ZVD. |
| 1249455 | Коригиран проблем, който караше заспиващо крайно устройство да влиза в режим на заспиване при получаване на излъчване, преди да получи ack. |
| 1252295 | Коригирайте печатна грешка в макроса на каталога на компонентите SL_CATALOG_ZIGBEE_OTA_STORAGE_COMMON_PRESENT. |
Фиксиран в изданието
| ДОКУМЕНТ ЗА САМОЛИЧНОСТ # | Описание |
| 1019348 | Коригирани са изискванията за зависимост за компонента Zigbee ZCL Cli, така че да може да бъде премахнат, когато не е необходим. |
| 1024246 | Актуализира описанието на функцията за emberHaveLinkKey() и sl_zb_sec_man_have_link_key(). |
| 1036503 | Добавено е описание, за да се препоръча използването на ядрото Micrium за DMP sample приложения. |
| 1037661 | Отстранен е проблем, който пречеше на приложението да инсталира професионален или листов стек. |
| 1078136 | Коригиран периодичен срив при модифициране на събития от контекста на прекъсване |
|
1081548 |
Напомняме на потребителите, че Zigbee несинхронизираните CSL предавания подлежат на изпреварване на протокола в радио планировчика. В приложенията SleepyToSleepy BLE може и ще изпревари Zigbee CSL предаване, което ще прекрати предаването. Изпреварването на планировчика е по-често срещано за несинхронизиран CSL, като се има предвид, че може да се използва потенциално дълга последователност от кадри за събуждане. Потребителите, които желаят да коригират приоритетите на предаване, могат да използват компонента за настройка и тестване на DMP, за да направят това. Потребителите могат също така да се консултират с UG305: Ръководство на потребителя за динамичен многопротокол за повече информация.
Коригиран е проблем в CSL, при който нова последователност от кадри за събуждане, която е получена непосредствено след предишен кадър с полезен товар, няма да бъде записана правилно. Това би довело до пропуснат полезен кадър. |
| 1084111 | Първоначалната поддръжка на сънлив SPI-NCP за базирани на MG24 платки се актуализира като част от тази версия. |
| 1104056 | Добавена е поддръжка за управление на мрежата за работа във вторична мрежа в случай на мулти-мрежа |
| 1120515 | Коригиран проблем, при който каналът не се променя при използване на командата mfglib set-channel. |
| 1141109 | Коригиран проблем, който причиняваше генерираните sample приложение ncp-uart-gp-multi-rail, за да пропуснете някои заглавки files, когато използвате компонента на адаптера Green Power с опцията -cp. |
| 1144316 | Актуализира описанието на някои типове структура на данни в документацията на gp-types.h. |
| 1144884 | Коригиран бит за чакащ фалшив кадър, зададен, когато няма чакащи данни. |
| 1152512 | Поправен е потенциален срив в low-mac-rail при модифициране на събитието в ISR контекст. |
| ДОКУМЕНТ ЗА САМОЛИЧНОСТ # | Описание |
| 1154616 | Добавено е изключение за условието за инициализиране на мрежата със случая „Превключване на роля от крайно устройство със спящ режим към крайно устройство без спящ режим“. |
| 1157289 | Коригиран проблем, който може да причини неуспешен тест на BDB DN-TLM-TC-02B. |
| 1157426 | Коригиран проблем с изграждането при изграждане на zigbee_simple_app с компонента green_power_adapter. |
| 1157932 | Добавено е условие за проверка дали полето „преходно време“ липсва и задаване на стойност по подразбиране 0xFFFF за това липсващо поле. |
| 1166340 | Коригиран проблем, който пречеше на emberAfGpdfSend да изпрати предвидения брой повтарящи се предавания. |
| 1167807 | Коригиран проблем, при който устройства, действащи като центрове за доверие в разпределени мрежи, изчистваха неправилно своите преходни ключове за връзка всеки път, когато се присъедини ново устройство. |
| 1169504 | Коригиран проблем, който причинява нулиране на заспиващо устройство при принудително събуждане. |
| 1169966 | Коригирано липсващо валидиране на върната стойност в кода за разпределение на буфера. |
| 1171477,
172270 |
С mfglib start 1 не се предават, а се получават съобщения, така че показаното терминално съобщение „mfglib изпращането е завършено“ е грешно и е променено на „RXed %d packets in the last %d ms“. |
| 1171935 | Периодът за периодична актуализация на мрежовия ключ е променен до 1 година. |
| 1172778 | Добавено е липсващото извикване на emberAfPluginGreenPowerServerUpdateAliasCallback към сървъра Green Power. |
| 1174288 | Коригиран проблем, който кара процеса на управление на мрежата да потвърди, ако се извика повикване за спиране на текущо сканиране. |
| 1178393 | Актуализира грешка в документацията. |
| 1180445 | В Smart Energy OTA вече продължава да се изтегля, ако координаторът достигне ограничения работен цикъл. |
| 1185509 | Коригиран проблем в CSL, при който нова последователност от кадри за събуждане, която е получена непосредствено след предишен кадър с полезен товар, няма да бъде записана правилно. Това би довело до пропуснат полезен кадър. |
| 1186107 | Коригиран проблем, който причиняваше неуспешно декриптиране на получени GPDF, за да замени входящия GPDF в известието за въвеждане в експлоатация на gp. |
| 1188397 | Поправен е проблем, който причинява грешка при компилиране при активиране на разширен размер на таблицата на отчета. |
| 1194090 | Коригиран е статусът на повреда в отговора по подразбиране за командата за режим на въвеждане в експлоатация на мивка – след раздел 3.3.4.8.2 |
| 1194963 | Коригиран проблем, който memset структурата на CommissioningGpd преди извикване на обратно извикване на потребителя emberAfGreenPowerServerPairingStatusCallback. |
| 1194966 | Коригиран проблем, при който полетата за крайна точка и proxiesInvolved не бяха зададени с действието Изход от въвеждане в експлоатация. |
| 1196698 | Поправен е зададен бит за чакащ фалшив кадър, когато няма чакащи данни. |
| 1199958 | Добавен код за справяне със случая, когато няма повече място за изграждане на съобщения за зелена мощност. |
| 1202034 | Коригиран проблем, при който променливата на стека sl_zb_sec_man_context_t не е инициализирана правилно, причинявайки неуспешно присъединяване с код за инсталиране. |
|
1206040 |
Извикването на emberRemoveChild() по време на сигурен опит за повторно присъединяване от крайно устройство може потенциално да доведе до допълнително намаляване на Child Count, потенциално водещо до Child Count от -1 (255), възпрепятствайки присъединяването/повторното присъединяване на крайните устройства поради посочена липса от капацитета в Beacon. |
|
1207580 |
Функциите за търсене на дъщерна таблица в стека са непоследователни при използването на 0x0000 спрямо 0xFFFF за върната стойност на ID на възел, представляваща невалидни/празни записи, което води до проблеми при проверката за неизползвани записи в API като emberRemoveChild(). |
| 1210706 | Дестинацията и PHY индексът, предоставени в структурата EmberExtraCounterInfo като част от emberCounterHandler(), може да са били неправилни за типовете MAC TX Unicast броячи. |
| 1211610
1212525 |
Коригиран проблем, при който Dynamic Multiprotocol приложенията се сриват след активиране на компонента Secure Key Storage Upgrade. |
| 1211847 | Въпреки че подписът на emberCounterHandler() не се е променил, начинът, по който параметрите му се попълват, се е променил леко. Промените около този API са обяснени в раздел 2 по-горе. |
|
1212449 |
Изходящите маяци бяха неправилно категоризирани от MAC слоя, което доведе до неуспех на emberCounterHandler() да улови тези пакети с типа на брояча EMBER_COUNTER_MAC_TX_BROADCAST и вместо това преброи маяците с типа на брояча EMBER_COUNTER_MAC_TX_UNICAST_SUCCESS. Това потенциално доведе до ненадеждни стойности за параметъра dest EmberNodeId, предаден на структурата EmberCounterInfo |
| ДОКУМЕНТ ЗА САМОЛИЧНОСТ # | Описание |
| 1214866 | Изпращането на пакети за анкета с данни в определени конфигурации с висок трафик може да доведе до повреда на шината. |
| 1216552 | Коригиран е проблем, който причинява твърдение при условия на натоварен трафик. |
| 1216613 | Коригиран проблем, който доведе до неправилна стойност на радиуса на прехвърляне на групата в прокси таблицата. |
| 1222509 | Рутерът/координаторът изпраща заявка за напускане и повторно присъединяване към крайно устройство за избиране, което не е дъщерно, но MAC дестинацията е 0xFFFF вместо да съответства на адреса на дестинация NWK. |
| 1223842 | Коригиран проблем с генерирането на sl_component_catalog.h, който оставяше нежелан код в него, причинявайки неуспех на компилацията. |
| 756628 | Променено е извикването на обратно извикване на приложението emberAfMacFilterMatchMessageCallback, за да се извиква само за ZLL съобщенията, които са валидирани от стека. |
| 816088 | Преместена конфигурация на EMBER от zigbeed_configuration.h към zigbeed. slcp. |
| 829508 | За да се избегне състояние на състезание, беше добавено допълнително валидиране в emberSetLogicalAndRadioChannel, за да се върне неуспешно, ако долните слоеве са заети или не са в състояние за промяна на канала. |
Известни проблеми в текущата версия
Проблеми с удебелен шрифт са добавени след предишното издание. Ако сте пропуснали издание, последните бележки за изданието са налични на https://www.si-labs.com/developers/zigbee-emberznet в раздела Технически документи.
| ДОКУМЕНТ ЗА САМОЛИЧНОСТ # | Описание | Заобиколно решение |
| N/A | · Следните приложения/компоненти не се поддържат в тази версия: Поддръжка на EM4 | Функцията ще бъде активирана в следващите версии. |
|
193492 |
Макросът за пренасяне на emberAfFillCommandGlobalServerToClientConfigureRe е повреден. Запълването на буфера създава неправилен команден пакет. | Използвайте CLI командата „zcl global send-me-a-report“ вместо API. |
| 278063 | Интелигентно енергийно тунелиране plugins имат противоречиво третиране/използване на индекса на адресната таблица. | Не е известно заобиколно решение |
|
289569 |
Списъкът за избор на ниво на мощност на компонента за създаване на мрежа не предлага пълен набор от поддържани стойности за EFR32 |
Редактирайте диапазона <-8..20>, посочен в коментара на CMSIS за EMBER_AF_PLUGIN_NETWORK_CREATOR_RADIO_P
OWER в /protocol/ZigBee/app/framework/plugin/network-creator/config/network-creator-config.h file. Напримерample, променете на <-26..20>. |
| 295498 | Приемането на UART понякога изпуска байтове при голямо натоварване в случая на динамично многопротоколно използване на Zigbee+BLE. | Използвайте хардуерен контрол на потока или намалете скоростта на предаване. |
|
312291 |
EMHAL: Функциите halCommonGetIntxxMillisecondTick на Linux хостове в момента използват функцията get meofday, която не е гарантирана, че е монотонна. Ако системното време се промени, това може да причини проблеми с времето на стека. |
Променете тези функции, за да използвате вместо това clock_gettime с източника CLOCK_MONOTONIC. |
| 338151 | Инициализирането на NCP с ниска стойност на броя на буфера на пакетите може да причини повредени пакети. | Използвайте запазената стойност 0xFF за броя на буфера на пакетите, за да избегнете твърде ниската стойност по подразбиране |
| 387750 | Проблемът с форматите на заявка за таблица на маршрута на крайното устройство. | В процес на разследване |
| 400418 | Инициаторът на touchlink не може да се свърже с фабрично ново крайно устройство. | Не е известно заобиколно решение. |
|
424355 |
Нефабричен нов сънлив край на устройството, инициатор с възможност за насочване към контактна линия, не е в състояние да получи отговор с информация за устройството при определени обстоятелства. |
В процес на разследване |
|
465180 |
Елементът за оптимизация на съвместното блокиране на радиото „Активиране на контрола по време на изпълнение“ може да блокира правилната работа на Zigbee. | Опционалният „Wi-Fi Select“ контрол на оптимизацията на блокера трябва да бъде оставен „Деактивиран“. |
|
480550 |
OTA клъстерът има вграден метод за фрагментиране, следователно не трябва да използва APS фрагментация. Въпреки че, в случай че APS криптирането е активирано, то увеличава полезния товар на ImageBlockResponses до размер, при който APS фрагментацията е активирана. Това може да доведе до отказ на OTA процеса. |
Не е известно заобиколно решение |
|
481128 |
Подробните подробности за причината за нулиране и срива трябва да са налични по подразбиране чрез виртуалния UART (сериен 0) на NCP платформи, когато приставката за диагностика и периферното устройство за виртуален UART са активирани. | Тъй като Serial 0 вече е инициализиран в NCP, клиентите могат да активират emberAfNcpInitCallback в Zigbee NCP Framework и да извикат съответните диагностични функции (halGetExtendedResetInfo, halGetExtendedResetString, halPrintCrashSummary, halPrintCrashDetails и halPrintCrashData) в това обратно извикване, за да отпечатат тези данни на Serial 0 за viewв регистрационния файл за улавяне на Network Analyzer.
За бившampза това как да използвате тези функции, вижте кода, включен в emberAfMainInit() на a-main-soc.c, когато е дефиниран EXTENDED_RESET_INFO. |
| ДОКУМЕНТ ЗА САМОЛИЧНОСТ # | Описание | Заобиколно решение |
|
486369 |
Ако DynamicMultiProtocolLightSoc, формиращ нова мрежа, има дъщерни възли, останали от мрежа, която е напуснал, emberAfGetChildTableSize връща ненулева стойност в startIdentifyOnAllChildNodes, причинявайки съобщения за грешка Tx 66 при адресиране на децата „призрак“. | Масово изтрийте частта, ако е възможно, преди да създадете нова мрежа или програмно проверете дъщерната таблица след напускане на мрежата и изтрийте всички дъщерни елементи с помощта на emberRemoveChild, преди да формирате нова мрежа. |
|
495563 |
Присъединяване към SPI NCP Sleepy End Device Sample Приложението не извършва кратко запитване, следователно опитът за присъединяване е неуспешен при състояние Актуализиране на ключ за връзка на TC. | Устройството, което желае да се присъедини, трябва да е в режим на кратка анкета, преди да се опита да се присъедини. Този режим може да бъде принуден от приставката за поддръжка на крайни устройства. |
|
497832 |
В мрежовия анализатор разбивката на командата за поддръжка на приложения Zigbee за рамката за заявка за проверка на ключ погрешно препраща към частта от полезния товар, която указва адреса на източника на рамката като адрес на местоназначение. |
Не е известно заобиколно решение |
| 519905
521782 |
Spi-NCP може много рядко да не успее да стартира комуникацията на буутлоудъра, използвайки CLI командата 'bootload' на приставката ota-client. |
Рестартирайте процеса на зареждане |
|
620596 |
NCP SPI Example за BRD4181A (EFR32xGMG21)
Дефинираният ПИН по подразбиране на nWake не може да се използва като ПИН за събуждане. |
Променете щифта по подразбиране за nWake от PD03 на EM2/3 щифт с активирано събуждане в приставката NCP-SPI. |
|
631713 |
Крайното Zigbee устройство ще докладва многократно за конфликти на адреси, ако се използва плъгинът „Zigbee PRO Stack Library“ вместо „Zigbee PRO Leaf Library“. | Използвайте „Zigbee PRO Leaf Library“ вместо плъгина „Zigbee PRO Stack Library“. |
|
670702 |
Неефективността в плъгина за отчитане може да доведе до значително забавяне въз основа на честотата на запис на данни и размера на таблицата, което може да попречи на кода на клиентското приложение, включително времето на събитието. | Ако правите чести записи, помислете за проверка на условията за отчитане и изпращане на отчети ръчно, вместо да използвате приставката. |
|
708258 |
Неинициализираната стойност в groups-server.c чрез addEntryToGroupTable() може да създаде фалшиво свързване и да доведе до изпращане на съобщения за отчитане на групово предаване. | Добавете „binding.clusterId = EMBER_AF_INVALID_CLUSTER_ID;“ след “binding.type
= EMBER_MULTICAST_BINDING;” |
|
757775 |
Всички части на EFR32 имат уникален RSSI офсет. Освен това дизайнът на платката, антените и корпусът могат да повлияят на RSSI. |
Когато създавате нов проект, инсталирайте компонента RAIL Utility, RSSI. Тази функция включва RSSI Offset Silabs по подразбиране, измерен за всяка част. Това отместване може да бъде променено, ако е необходимо, след RF тестване на вашия пълен продукт. |
|
758965 |
ZCL компонентите на клъстера и ZCL таблицата за откриване на команди не са синхронизирани. Следователно, когато активирате или деактивирате компонент на ZCL клъстер, внедрените команди няма да бъдат активирани/деактивирани в съответния команден раздел на ZCL Advanced Configurator. | Ръчно активирайте/деактивирайте откриването за желаните ZCL команди в ZCL Advanced Configurator. |
| 765735 | OTA актуализацията е неуспешна на Sleepy End Device с активирана заявка за страница. | Използвайте Block Request вместо Page Request. |
|
845649 |
Премахване на CLI: Основният компонент не елиминира EEPROM cli извиквания към sl_cli.h. |
Изтрийте eeprom-cli.c file който извиква sl_cli.h. Освен това извикванията към sl_cli.h, както и sl_cli_command_arg_t в ota-storage-simple-eeprom могат да бъдат коментирани. |
|
857200 |
ias-зона-сървър. c позволява да се създаде обвързване с „0000000000000000“ CIE адрес и отзад не позволява допълнителни обвързвания. | Не е известно заобиколно решение |
| 1019961 | Генериран Z3Gateway makefile твърди кодове „gcc“ като CC | Не е известно заобиколно решение |
| ДОКУМЕНТ ЗА САМОЛИЧНОСТ # | Описание | Заобиколно решение |
|
1039767 |
Проблем с препълване на опашката при повторен опит на мрежата на рутер Zigbee в случай на използване на многопоточна RTOS. |
Zigbee Stack не е безопасен за нишки. В резултат на това извикването на API на стека на Zigbee от друга задача не се поддържа в средата на ОС и може да постави стека в „неработещо“ състояние. Обърнете се към следната бележка за приложението за повече информация и заобиколно решение с помощта на манипулатора на събития.
https://www.silabs.com/documents/public/application- бележки/an1322-dynamic-multiprotocol-bluetooth-zigbee-sdk- 7x.pdf . |
| 1064370 | Z3Switch sampФайловото приложение активира само един бутон (инстанция: btn1) по подразбиране, което води до несъответствие в описанието на бутона в проекта file. | Заобиколно решение: Инсталирайте екземпляра btn0 ръчно по време на създаването на Z3Switch проект. |
| 1161063 | Z3Light и потенциално други приложения съобщават за неправилни стойности на ревизия на клъстера. | Ръчно актуализирайте атрибута на ревизията на клъстера до съответната им ревизия. |
| 1164768,
1171478, 1171479 |
ГРЕШКА: ezspErrorHandler 0x34 докладван многократно по време на режим на получаване на mfglib | За да намалите отпечатаните съобщения за грешка, конфигурирайте EMBER_AF_PLUGIN_GATEWAY_MAX_WAIT_FOR_EV
ENT_TIMEOUT_MS на хост приложението до 100, така че опашката за обратно извикване се освобождава по-бързо. |
| 1252460 | Процедурите за възстановяване на SimEEPROM (както за v1, така и за v2), изпълнявани при стартиране, могат да изпълнят извиквания за изтриване на флаш страници, което води до твърдения по време на em_msc. рутина MSC_ErasePage на c. | Заобиколно решение: Поставете следния ред код в горната част на функцията MSC_ErasePage() в em_msc.c: начален адрес = (uint32_t*)((uint32_t)startAddress &
~(FLASH_PAGE_SIZE-1)); |
Оттеглени артикули
Отхвърлено в изданието
В GSDK 7.4.0.0 нататък, включително тази корекция, опцията „-v“ в Z3Gateway за хост приложение на linux за създаване на telnet интерфейс с порт 4900 или 4901 е отхвърлена. Алтернативният препоръчителен начин за създаване на telnet интерфейс е използването на помощни програми на linux като „socat“.
Отхвърлено в изданието
Премахнати са следните остарели API за сигурност:
- emberGetKey()
- emberGetKeyTableEntry()
- emberSetKeyTableEntry()
- emberHaveLinkKey()
- emberAddOrUpdateKeyTableEntry()
- emberAddTransientLinkKey()
- emberGetTransientKeyTableEntry()
- emberGetTransientLinkKey()
- emberHmacAesHash()
Използвайте API, предоставени от Zigbee Security Manager за достъп до съхранение на ключове и HMAC хеширане.
Премахнати елементи
Премахнато в изданието
- Премахнати дублиращи се публични API в публичната заглавка file gp-types.h.
- Компонентът zigbee_end_device_bind е премахнат. Този компонент беше използван за координатора за посредничество при заявки за обвързване за крайни устройства. Тази незадължителна функционалност беше премахната от R22 на основната спецификация на Zigbee.
- Премахнат setPacketBufferCount() в af-host.c и безполезна проверка EZSP_CONFIG_PACKET_BUFFER_COUNT: в command-handlers.c.
- Премахнат аргумент за разпределение на паметта, защото няма нужда да се разделя на две фази при инициализиране на NCP.
- Премахнато е emberAfNcpInitCallback() в se14-comms-hub, se14-ihd и se14-meter-gas app.c.
- Премахната стойност на настройката EZSP_CONFIG_RETRY_QUEUE_SIZE по време на инициализация на ncp в ncp-configuration.c
Многопротоколен шлюз и RCP
Нови артикули
Добавен в изданието
- Пуснато е едновременно слушане, възможността стековете Zigbee и OpenThread да работят на независими 802.15.4 канали при използване на EFR32xG24 или xG21 RCP.
- Едновременното слушане не е налично за комбинацията 802.15.4 RCP/Bluetooth RCP, комбинацията Zigbee NCP/OpenThread RCP или за Zigbee/OpenThread система върху чип (SoC). Той ще бъде добавен към тези продукти в бъдеща версия.
- Разширението OpenThread CLI на доставчика е добавено към хост приложенията OpenThread на многопротоколни контейнери. Това включва командите coex cli.
Подобрения
Променен в изданието
- Мултипротоколната комбинация Zigbee NCP/OpenThread RCP вече е производствено качество.
Фиксирани проблеми
Фиксиран в изданието
| ДОКУМЕНТ ЗА САМОЛИЧНОСТ # | Описание |
|
1213701 |
zigbeed не позволи да се създаде запис в таблица за съвпадение на източник за дете, ако индиректната опашка на MAC има данни, които вече са чакащи за това дете. Това поведение може да доведе до отказ на транзакции на приложния слой между дъщерното и някое друго устройство поради липса на APS Ack или отговор на приложния слой, най-вече прекъсване и неочаквано прекратяване на ZCL OTA надстройки, насочени към дъщерното устройство. |
| 1244461 | Записът в таблицата за съвпадение на източник за дъщерно същество може да бъде премахнат въпреки чакащите съобщения. |
Фиксиран в изданието
| ДОКУМЕНТ ЗА САМОЛИЧНОСТ # | Описание |
| 1081828 | Проблем с пропускателната способност при базирани на FreeRTOS Zigbee/BLE DMP sample приложения. |
| 1090921 | Z3GatewayCpc имаше проблем с формирането на мрежа в шумна среда. |
| 1153055 | Утвърждение на хоста беше причинено, когато имаше грешка в комуникацията при четене на NCP версията от zigbee_ncp-ble_ncp-uart sample app. |
| 1155676 | 802.15.4 RCP отхвърля всички получени едноадресни пакети (след MAC acking), ако множество 15.4 интерфейси споделят един и същ 16-битов ID на възел. |
| 1173178 | Хостът фалшиво докладва стотици пакети, получени с mfglib в настройката на Host-RCP. |
| 1190859 | EZSP грешка при изпращане на mfglib произволни пакети в настройката на Host-RCP. |
| 1199706 | Проучванията на данни от забравени дъщерни крайни устройства не задаваха правилно чакащ кадър на RCP, за да постави в опашката команда за напускане и присъединяване към предишното дъщерно устройство. |
| 1207967 | Командата „mfglib send random“ изпращаше допълнителни пакети на Zigbeed. |
| 1208012 | Режимът mfglib rx не актуализира информацията за пакета правилно при получаване на RCP. |
| 1214359 | Координаторният възел се срина, когато 80 или повече рутера се опитаха да се присъединят едновременно в настройката Host-RCP. |
|
1216470 |
След препредаване на излъчване за адресна маска 0xFFFF, Zigbee RCP, действащ като родителско устройство, ще остави флага за чакащи данни, зададен за всяко дете. Това доведе до това, че всяко дете остава будно, очаквайки данни след всяка анкета, и изискваше някаква друга чакаща транзакция с данни към всяко крайно устройство, за да изчисти евентуално това състояние. |
Известни проблеми в текущата версия
Проблеми с удебелен шрифт бяха добавени след предишната версия. Ако сте пропуснали версия, бележките за скорошни версии са налични на https://www.si-labs.com/developers/gecko-software-development-kit.
| ДОКУМЕНТ ЗА САМОЛИЧНОСТ # | Описание | Заобиколно решение |
| 811732 | Поддръжката на персонализирани токени не е налична при използване на Zigbeed. | Поддръжката е планирана в бъдещо издание. |
| 937562 | Командата Bluetoothctl 'advertise on' се проваля с приложението rcp-uart-802154-blehci на Raspberry Pi OS 11. | Използвайте приложението btmgmt вместо bluetoothctl. |
| 1022972 | Coex не работи на ZB NCP + OT RCP. | Поддръжката е планирана за бъдеща версия. |
| 1074205 | CMP RCP не поддържа две мрежи на един и същи PAN id. | Използвайте различни PAN идентификатори за всяка мрежа. Поддръжката е планирана в бъдещо издание. |
| 1122723 | В натоварена среда CLI може да спре да реагира в приложението z3-light_ot-ftd_soc. | Не е известно заобиколно решение. |
| 1124140 | z3-light_ot-ftd_soc sample app не може да формира мрежата Zigbee, ако OT мрежата вече работи. | Първо стартирайте мрежата Zigbee и след това OT мрежата. |
|
1170052 |
CMP Zigbee NCP + OT RCP и DMP Zigbee NCP + BLE NCP може да не пасват на 64KB и по-ниски RAM части в тази текуща версия. |
Частите от 64 KB в момента не се поддържат за тези приложения. |
|
1209958 |
ZB/OT/BLE RCP на Bobcat и Bobcat Lite може да спре да работи след няколко минути, когато изпълнява и трите протокола |
Ще бъде разгледано в бъдещо издание |
| 1221299 | Mfglib RSSI показанията се различават между RCP и NCP. | Ще бъде разгледано в бъдещо издание. |
| 1231021 | OTBR може да потвърди, когато 80+ zigbee устройства се присъединят едновременно. | Добавена е корекция, която може да заобиколи проблема. Ще бъде разгледано изцяло в бъдещо издание. |
Оттеглени артикули
- Няма
Премахнати елементи
Премахнато в изданието
- Макросът „NONCOMPLIANT_ACK_TIMING_WORKAROUND“ е премахнат. Всички RCP приложения сега по подразбиране поддържат 192 μsec време за изпълнение за неусъвършенствани потвърждения, докато все още използват 256 μsec време за изпълнение за подобрени потвърждения, изисквани от CSL.
Използване на това издание
Тази версия съдържа следното:
- Zigbee стек
- Zigbee Application Framework
- Зигби Сample Приложения
За повече информация относно Zigbee и EmberZNet SDK вижте UG103.02: Zigbee Fundamentals.
Ако сте потребител за първи път, вижте QSG180: Ръководство за бързо стартиране на Zigbee EmberZNet за SDK 7.0 и по-високи, за инструкции относно конфигурирането на вашата среда за разработка, изграждане и флашване катоampфайл и препратки към документация, сочещи към следващите стъпки.
Инсталиране и използване
Zigbee EmberZNet SDK се предоставя като част от Gecko SDK (GSDK), пакета от SDK на Silicon Labs. За да започнете бързо с GSDK, инсталирайте Simplicity Studio 5, което ще настрои вашата среда за разработка и ще ви преведе през инсталацията на GSDK. Simplicity Studio 5 включва всичко необходимо за разработване на IoT продукти с устройства на Silicon Labs, включително средство за стартиране на ресурси и проекти, инструменти за конфигуриране на софтуер, пълна IDE с верига от инструменти GNU и инструменти за анализ. Инструкциите за инсталиране са предоставени в онлайн ръководството за потребителя на Simplicity Studio 5.
Като алтернатива Gecko SDK може да се инсталира ръчно чрез изтегляне или клониране на най-новата версия от GitHub. Вижте https://github.com/Sili-conLabs/gecko_sdk за повече информация.
Simplicity Studio инсталира GSDK по подразбиране в:
- (Windows): C:\Потребители\ \SimplicityStudio\SDKs\gecko_sdk
- (MacOS): /Потребители/ /SimplicityStudio/SDKs/gecko_sdk
Документацията, специфична за версията на SDK, се инсталира с SDK. Допълнителна информация често може да бъде намерена в статиите в базата знания (KBA). Препратките към API и друга информация за тази и по-ранни версии са налични на https://docs.silabs.com/.
Информация за сигурност
Сигурна интеграция на Vault
За приложения, които избират да съхраняват ключове сигурно с помощта на компонента Secure Key Storage на частите Secure Vault-High, следващата таблица показва защитените ключове и техните характеристики за защита на съхранението, които компонентът Zigbee Security Manager управлява.
| Опакован ключ | Подлежащи на износ/неподлежащи на износ | Бележки |
| Мрежов ключ | Изнася се | |
| Ключ за връзка към центъра за доверие | Изнася се | |
| Ключ за преходна връзка | Изнася се | Таблица с индексирани ключове, съхранена като променлив ключ |
| Ключ за връзка към приложението | Изнася се | Индексирана ключова таблица |
| Сигурен EZSP ключ | Изнася се | |
| Ключ за криптиране на ZLL | Изнася се | |
| ZLL предварително конфигуриран ключ | Изнася се | |
| GPD прокси ключ | Изнася се | Индексирана ключова таблица |
| GPD ключ за мивка | Изнася се | Индексирана ключова таблица |
| Вътрешен/заместващ ключ | Изнася се | Вътрешен ключ за използване от Zigbee Security Manager |
- Опакованите ключове, които са маркирани като „Неподлежащи на експортиране“, могат да се използват, но не могат viewредактиран или споделен по време на изпълнение.
- Опакованите ключове, които са маркирани като „Експортируеми“, могат да се използват или споделят по време на изпълнение, но остават криптирани, докато се съхраняват във флаш.
- Потребителските приложения никога не трябва да взаимодействат с повечето от тези ключове. Съществуващите приложни програмни интерфейси (API) за управление на ключовете на таблицата с ключове на връзката или преходните ключове все още са достъпни за потребителското приложение и сега преминават през компонента Zigbee Security Manager.
- Някои от тези ключове може да не могат да бъдат експортирани към потребителското приложение в бъдеще. Потребителските приложения се насърчават да не разчитат на експортирането на ключове, освен ако не е абсолютно необходимо.
- За повече информация относно функционалността на Secure Vault Key Management вижте AN1271: Secure Key Storage.
Съвети за сигурност
За да се абонирате за Съвети за сигурност, влезте в портала за клиенти на Silicon Labs, след което изберете Начало на акаунта. Щракнете върху НАЧАЛО, за да отидете на началната страница на портала и след това щракнете върху плочката Управление на известията. Уверете се, че „Софтуер/Съветни бележки за сигурност и Известия за промяна на продукта (PCNs)“ е отметнато и че сте абонирани поне за вашата платформа и протокол. Щракнете върху Запазване, за да запазите промените.
поддръжка
Клиентите на комплекта за разработка отговарят на условията за обучение и техническа поддръжка. Използвайте Zigbee на Silicon Laboratories web страница, за да получите информация за всички продукти и услуги на Silicon Labs Zigbee и да се регистрирате за поддръжка на продукта.
Можете да се свържете с поддръжката на Silicon Laboratories на http://www.silabs.com/support.
Студио за простота
Достъп с едно щракване до MCU и безжични инструменти, документация, софтуер, библиотеки с изходен код и други. Предлага се за Windows, Mac и Linux!
Отказ от отговорност
Silicon Labs възнамерява да предостави на клиентите най-новата, точна и задълбочена документация за всички периферни устройства и модули, налични за системни и софтуерни внедрители, използващи или възнамеряващи да използват продуктите на Silicon Labs. Данните за характеристиките, наличните модули и периферни устройства, размерите на паметта и адресите на паметта се отнасят за всяко конкретно устройство, а предоставените „типични“ параметри могат и варират в различните приложения. Приложение прampописаните тук са само за илюстративни цели. Silicon Labs си запазва правото да прави промени без допълнително известие в информацията за продукта, спецификациите и описанията тук и не дава гаранции по отношение на точността или пълнотата на включената информация. Без предварително уведомление Silicon Labs може да актуализира фърмуера на продукта по време на производствения процес от съображения за сигурност или надеждност. Такива промени няма да променят спецификациите или работата на продукта. Silicon Labs не носи отговорност за последствията от използването на информацията, предоставена в този документ. Този документ не предполага, нито изрично предоставя лиценз за проектиране или производство на интегрални схеми. Продуктите не са проектирани или разрешени за използване в устройства от клас III на FDA, приложения, за които се изисква одобрение от FDA преди пускане на пазара или системи за поддържане на живота без специалното писмено съгласие на Silicon Labs. „Животоподдържаща система“ е всеки продукт или система, предназначена да поддържа или поддържа живота и/или здравето, която, ако не успее, може разумно да се очаква да доведе до значителни лични наранявания или смърт. Продуктите на Silicon Labs не са проектирани или разрешени за военни приложения. Продуктите на Silicon Labs при никакви обстоятелства не трябва да се използват в оръжия за масово унищожение, включително (но не само) ядрени, биологични или химически оръжия или ракети, способни да доставят такива оръжия. Silicon Labs се отказва от всякакви изрични и подразбиращи се гаранции и не носи отговорност за наранявания или щети, свързани с използването на продукт на Silicon Labs в такива неоторизирани приложения.
Забележка: Това съдържание може да съдържа обидна терминология, която вече е остаряла. Silicon Labs заменя тези термини с приобщаващ език, когато е възможно. За повече информация посетете www.silabs.com/about-us/inclusive-lexicon-project.
Информация за търговската марка
Silicon Laboratories Inc.®, Silicon Laboratories®, Silicon Labs®, SiLabs® и логото на Silicon Labs®, Bluegiga®, Bluegiga Logo®, EFM®, EFM32®, EFR, Ember®, Energy Micro, логото на Energy Micro и комбинации от тях , „най-щадящите енергия микроконтролери в света“, Redpine Signals®, WiSeConnect, n-Link, ThreadArch®, EZLink®, EZRadio®, EZRadioPRO®, Gecko®, Gecko OS, Gecko OS Studio, Precision32®, Simplicity Studio®, Telegesis, Telegesis Logo®, USBXpress®, Zentri, логото на Zentri и Zentri DMS, Z-Wave® и други са търговски марки или регистрирани търговски марки на Silicon Labs. ARM, CORTEX, Cortex-M3 и THUMB са търговски марки или регистрирани търговски марки на ARM Holdings. Keil е регистрирана търговска марка на ARM Limited. Wi-Fi е регистрирана търговска марка на Wi-Fi Alliance. Всички останали продукти или марки, споменати тук, са търговски марки на съответните им притежатели.
КОНТАКТ
- Silicon Laboratories Inc.
- 400 Запад Сезар Чавес
- Остин, Тексас 78701
- САЩ
- www.silabs.com
Документи / Ресурси
 |
SILICON LABS SDK 7.4.1.0 GA Zigbee протокол стек софтуер [pdf] Ръководство за потребителя SDK 7.4.1.0 GA Zigbee Protocol Stack Software, SDK 7.4.1.0 GA, Zigbee Protocol Stack Software, Protocol Stack Software, Stack Software |