SILICON LABS SDK 7.4.1.0 GA Zigbee Protocol Stack Software User Guide

За безбедносни ажурирања и известувања, погледнете го поглавјето за безбедност на белешките за издавање на платформата Gecko инсталирани со оваа SDK или посетете ја картичката TECH DOCS на Silicon Labs webсајт.
Останете ажурирани со претплата на безбедносни совети.

Најчесто поставувани прашања

Прашање: Како да го потврдам точното fileДали се користат со компатибилните компајлери?
Одговор: Можете да потврдите дека е точно files се користат со проверка на GCC верзијата 12.2.1 обезбедена со Simplicity Studio.

Прашање: Каде можам да најдам информации за безбедносни ажурирања и известувања?
Одговор: За безбедносни ажурирања и известувања, погледнете го поглавјето за безбедност на белешките за издавање на платформата Gecko или посетете ја картичката TECH DOCS на Silicon Labs. webсајт.

Silicon Labs е продавач на избор за OEM кои развиваат Zigbee вмрежување во нивните производи. Платформата на Silicon Labs Zigbee е најинтегрираното, најкомплетното и најбогатото Zigbee решение достапно.
Silicon Labs EmberZNet SDK содржи имплементација на Silicon Labs на спецификацијата за стек Zigbee.

Овие белешки за издавање ги покриваат верзиите на 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 – Алфа

Поддршка на MG27 – производство
Подобрена поддршка за делови од Secure Vault

Заспана поддршка за апликациите NCP SPI (не-CPC) – Алфа

Мултипротокол

Поддршка за истовремено слушање (RCP) - MG21 и MG24
Истовремен мултипротокол (CMP) Zigbee NCP + OpenThread RCP – производство

Dynamic Multiprotocol Bluetooth + Concurrent Multiprotocol (CMP) Zigbee and OpenThread поддршка на SoC

Известувања за компатибилност и употреба

За информации за безбедносните ажурирања и известувања, видете го поглавјето за безбедност на белешките за издавање на платформата Gecko инсталирани со оваа SDK или на картичката TECH DOCS на https://www.silabs.com/developers/zigbee-emberznet. Silicon Labs, исто така, силно препорачува да се претплатите на безбедносните совети за ажурирани информации. За инструкции или ако сте нови во Zigbee EmberZNet SDK, видете Користење на ова издание.

Компатибилни компајлери

IAR Embedded Workbench for ARM (IAR-EWARM) верзија 9.40.1.
Користењето Wine за градење со алатката за командна линија IarBuild.exe или GUI со вградена работна маса на IAR на macOS или Linux може да резултира со неточни files се користи поради судири во алгоритмот за хеширање на Wine за генерирање кратки file имиња.
На клиентите на macOS или Linux им се препорачува да не градат со IAR надвор од Simplicity Studio. Клиентите кои го прават тоа треба внимателно да проверат дали е точно fileсе користат.

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 и ќе започне да нуди нови функции кои им помагаат на програмерите да напредуваатtagе од напредните способности на нашите производи од Серии 2 и 3.
Оваа одлука се усогласува со повратните информации од клиентите, што ја одразува нашата посветеност да го подигнеме квалитетот, да обезбедиме стабилност и да ги подобриме перформансите за исклучително корисничко искуство во нашите софтверски SDK-и.

Нови компоненти

Ново во издание

Компонентите „zigbee_direct_security_p256“ и „zigbee_direct_security_curve25519“ се додадени за корисниците да можат да конфигурираат одредена безбедносна опција Zigbee Direct.
На корисниците им е дозволено да имаат повеќе компоненти „zigbee_direct_security“ овозможени на апликацијата Zigbee direct device (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), што се враќа точно ако табелата со копчиња за врски може да додаде или ажурира запис со оваа адреса (табелата не е полна).

Додадено е ново API bool sl_zb_sec_man_compare_key_to_value (sl_zb_sec_man_context_t* контекст, sl_zb_sec_man_key_t* клуч), кој се враќа точно ако клучот е референциран по контекст ја има истата вредност како клучот што е даден во аргументот.

Поддршка за нова платформа
Ново во издание

Поддршката за стек Zigbee за следните нови делови е додадена во ова издание: EFR32MG24A010F768IM40 и EFR32MG24A020F768IM40.

Нова документација
Ново во издание 7.4.0.0

Го ажурираше описот за компонентата Zigbee Secure Storage за да го одрази додавањето на Zigbee Secure Storage Upgrade (што додава наназад компатибилност со постоечките проекти).
Додадена е нова белешка за апликација за интеракција со групата компоненти на Zigbee Security Manager (AN1412: Zigbee Security Manager).

Наменето однесување

Корисниците се потсетуваат дека несинхронизираните CSL преноси на Zigbee подлежат на претпочитање протокол кај распоредувачот на радио. Во апликациите SleepyToSleepy, BLE може и ќе спречи пренос на Zigbee CSL, што ќе го прекине преносот. Претпоставката на распоредувачот е почеста за несинхронизирана CSL, имајќи предвид дека може да се користи потенцијално долга низа на рамки за будење. Корисниците кои сакаат да ги приспособат приоритетите на преносот може да ја користат компонентата DMP Tuning and Testing за да го направат тоа. Корисниците може да се консултираат и со UG305: Dynamic Multiprotocol User's Guide за повеќе информации.

Подобрувања

Променет во ослободување
emberCounterHandler API промени во документот

Во претходните верзии, на повратен повик на Counter Handler за MAC и APS слој EmberCounterTypes во врска со пакетите RX и TX не се пренесуваше соодветниот ID на целниот јазол или аргументите за податоци, а документацијата API во врска со однесувањето на одредени бројачи што ги користеа овие параметри беше нејасна или погрешна.
Додека потписот на emberCounterHandler() не е променет, начинот на пополнување на неговите параметри е малку променет.

Коментарите околу EmberCounterType збирките во ember-types.h се проширени за јасност.
Параметарот Node ID на управувачот со бројачи за бројачи поврзани со TX сега проверува дали режимот на дестинационата адреса означува валиден краток ID пред да го користи. (Ако не, ниедна адреса на дестинација не е пополнета и наместо тоа се користи вредност на заштитник на место од EMBER_UNKNOWN_NODE_ID.)
Параметарот Node ID на управувачот со бројачи за бројачи поврзани со RX сега го одразува ID на изворниот јазол, а не ID на дестинацијата на јазолот.

Бројот на повторен обид *не* е предаден како податочен параметар за EMBER_COUNTER_MAC_TX_UNICAST_ SUCCESS/FAILED бројачи како што е опишано во жар-типови. h во претходните верзии, но ова никогаш не било правилно пополнето во претходно објавените верзии, така што неговата вредност во претходните изданија секогаш би била 0. Ова однесување е разјаснето во описот на тие EmberCounterTypes. Сепак, бројот на „Обиди се повторно“ за повторувања на APS слојот продолжува да се пополнува во параметарот за податоци за типови бројачи EMBER_COUNTER_APS_TX_UNICAST_SUCCESS/FAILED, за да биде конзистентен со претходните изданија.
Сите бројачи што го пополнуваат ID на јазол или параметарот на податоци за повратен повик се ревидирани за да се осигура дека ги пренесуваат очекуваните податоци, адреса или EMBER_UNKNOWN_NODE_ID ако се очекуваше ID на јазол, но не може да се добие од пакетот, како што е опишано во ревидираниот ember- видови.ж документација.
Управувачот со бројачи за EMBER_COUNTER_MAC_TX_UNICAST_RETRY сега правилно го рефлектира ID на дестинација на јазолот на слојот MAC и неколку повторувања во неговиот ID на јазол на дестинација и параметрите за податоци.

Управувачот со бројачи за EMBER_COUNTER_PHY_CCA_FAIL_COUNT сега обезбедува информации за ID на дестинацијата преку параметарот Node ID за целта на MAC слојот на пораката што не успеа да се пренесе.

Ажуриран Green Power Code
Кодот на серверот за зелена моќност се ажурира со различни подобрувања, вклучувајќи:

Додаден е повеќе код за валидација за дојдовни команди со неважечка крајна точка при примање на GP серверот.

Додаден е код за справување со случај кога нема повеќе простор за создавање пораки за зелена моќ.
Мијалникот сега ја намалува конфигурацијата за спарување со спарувањето за отстранување акција во некои случаи според делот за спецификации А.3.5.2.4.1.
Мијалникот сега ја зачувува постоечката групна листа на запис пред да ја отстрани кога се обработува Конфигурацијата за спарување со проширување на дејството.

Командата за пребарување за превод враќа „НЕ НАЈДЕНО“ како код за грешка кога табелата за превод е празна или индексот е поголем од неколку записи во табелата.
Ја смени верзијата на крајната точка на GP во некои апликации од 1 на 0.

Користењето CSMA во функцијата GPDF Send е ограничено бидејќи Green Power Devices се уреди со минимална енергија и не користат CSMA во повеќето дизајни. Наместо тоа, претпочитаниот дизајн е да се испратат повеќе пакети користејќи ист енергетски буџет.
Отстранета употреба на скриена крајна точка во опцијата за приклучок за Green Power Server. Наместо тоа, користете една од крајните точки на апликацијата.
Подобрување на кодот на приклучокот за ажурирање на мрежниот клуч

Периодот на периодично ажурирање на мрежниот клуч го смени да трае 1 година.

Реструктуирани некои API за да се избегне непотребен извоз на клучеви
Направени се промени за да ја фаворизираат употребата на клучните контексти пред податоците од клучот со обичен текст.

sl_zigbee_send_security_challenge_request сега зема аргумент sl_zb_sec_man_context_t наместо EmberKeyData.

Вредностите на sl_zb_sec_man_derived_key_type enum сега се 16-битна битмаска за директно поддршка на одредени деривации на клучеви кои комбинираат повеќе изведени типови.

Поправени проблеми

Поправено во ослободување

ID #	Опис
1036893	Поправен проблем поради кој компонентата на кластерот OTA ја инсталираше наследената компонента на интерфејсот на подигачот како зависност.
1114905	Zigbee Direct: Подобрено ракување со Карактеристика на Leave Network.
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 Барањата одбиени поради причини за пристап/дозвола треба да го вратат статусот EMBER_ZDP_NOT_AUTHORIZED наместо статусот EMBER_ZDP_NOT_PERMITTED според спецификациите на Zigbee.
1243523	Zigbee Direct: Подобрена стабилност на BLE поврзувањето со ZVD.
1249455	Поправен е проблем поради кој заспаниот крај уред влезе во мирување кога прима емитување пред да прими ак.
1252295	Поправете печатна грешка во макрото од каталогот на компонентите SL_CATALOG_ZIGBEE_OTA_STORAGE_COMMON_PRESENT.

Поправено во ослободување

ID #	Опис
1019348	Ги поправи барањата за зависност за компонентата Zigbee ZCL Cli за да може да се отстрани кога не е потребна.
1024246	Го ажурираше описот на функцијата за emberHaveLinkKey() и sl_zb_sec_man_have_link_key().
1036503	Додаден опис за да препорача употреба на Micrium Kernel за DMP sampле апликации.
1037661	Поправен е проблемот што ја спречуваше апликацијата да инсталира простик или стек со листови.
1078136	Поправен е интермитентен пад при менување настани од контекст на прекини
1081548	Корисниците се потсетуваат дека несинхронизираните CSL преноси на Zigbee подлежат на претпочитање протокол кај распоредувачот на радио. Во апликациите SleepyToSleepy, BLE може и ќе спречи пренос на Zigbee CSL, што ќе го прекине преносот. Претпоставката на распоредувачот е почеста за несинхронизирана CSL, имајќи предвид дека може да се користи потенцијално долга низа на рамки за будење. Корисниците кои сакаат да ги приспособат приоритетите на преносот може да ја користат компонентата DMP Tuning and Testing за да го направат тоа. Корисниците може да се консултираат и со UG305: Dynamic Multiprotocol User's Guide за повеќе информации. Поправен е проблем во CSL каде што новата низа на рамки за будење што се прима веднаш по претходната рамка за оптоварување нема да биде правилно снимена. Ова би резултирало со пропуштена рамка за носивост.
1084111	Почетната заспана поддршка за SPI-NCP за плочите базирани на MG24 се ажурира како дел од ова издание.
1104056	Додадена е поддршка за мрежно управување за работа на секундарна мрежа во случај на повеќемрежа
1120515	Поправен е проблем каде што каналот не се променил при користење на командата mfglib set-channel.
1141109	Поправен проблем што предизвика генерирана сampЛе апликацијата ncp-uart-gp-multi-rail да пропушти некое заглавие files кога ја користите компонентата за адаптер за Green Power со опцијата -cp.
1144316	Ажуриран е описот на некои типови на структури на податоци во документацијата gp-types.h.
1144884	Поставен бит на чекање за лажна рамка кога не чекаат податоци.
1152512	Поправен е потенцијален пад во low-mac-rail кога се менува настанот во контекст на ISR.

ID #	Опис
1154616	Додаден е исклучок за условот за иницијализирање на мрежата со случајот „Префрлување улога од Sleepy End уред на Non-Sleepy End уред“.
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 send full“ е погрешна и е сменета во „RXed %d пакети во последните %d ms“.
1171935	Периодот на периодично ажурирање на мрежниот клуч го смени да трае 1 година.
1172778	Додадено е повик што недостасува на emberAfPluginGreenPowerServerUpdateAliasCallback на серверот Green Power.
1174288	Поправен е проблем што предизвикува мрежното управување да потврди дали е повикан повик за запирање на тековното скенирање.
1178393	Ажурираше грешка во документацијата.
1180445	Во Smart Energy, OTA сега продолжува да презема ако Координаторот го достигне циклусот на ограничена должност.
1185509	Поправен е проблем во CSL каде што новата низа на кадри за будење што се прима веднаш по претходната рамка за оптоварување нема да биде правилно снимена. Ова би резултирало со пропуштена рамка за носивост.
1186107	Поправен е проблем што предизвика неуспешното дешифрирање на примените GPDF да го замени дојдовниот GPDF во известувањето за пуштање во работа на gp.
1188397	Поправен е проблем што предизвика грешка при компилацијата при овозможување на големината на табелата за продолжен извештај.
1194090	Го коригира статусот на неуспех во стандардниот одговор за командата Sink launching Mode – следен дел 3.3.4.8.2
1194963	Поправен е проблем што ја мемсетираше структурата на CommissioningGpd пред да се повика корисникот за повратен повик emberAfGreenPowerServerPairingStatusCallback.
1194966	Поправен е проблем каде што полињата за крајна точка и вклучени прокси не беа поставени со акцијата Exit Pushing.
1196698	Поправено е поставено лажна рамка во чекање кога не чекаат податоци.
1199958	Додаден е код за справување со случај кога нема повеќе простор за создавање пораки за зелена моќ.
1202034	Поправен проблем каде што променливата на стек sl_zb_sec_man_context_t не беше правилно иницијализирана, што предизвика неуспех на спојувањето со кодот за инсталирање.
1206040	Повикувањето на emberRemoveChild() за време на безбеден обид за повторно приклучување од страна на краен уред потенцијално може да доведе до дополнително намалување на бројот на деца, што потенцијално ќе доведе до број на деца од -1 (255), спречувајќи ги крајните уреди да се приклучат/повторат поради назначен недостаток на капацитет во Beacon.
1207580	Функциите за пребарување на детска табела во оџакот се неконзистентни во употребата на 0x0000 наспроти 0xFFFF за повратната вредност на ID на јазол што претставува неважечки/празни записи, што доведува до проблеми при проверка на неискористени записи во API-та како emberRemoveChild().
1210706	Дестинацијата и индексот PHY дадени во структурата EmberExtraCounterInfo како дел од emberCounterHandler() можеби биле неточни за типовите бројачи MAC TX Unicast.
1211610 1212525	Поправен е проблемот кога апликациите за динамички мултипротокол паднаа откако ја овозможија компонентата за надградба на безбедно складирање клучеви.
1211847	Додека потписот на emberCounterHandler() не е променет, начинот на пополнување на неговите параметри е малку променет. Промените околу ова API се објаснети во делот 2 погоре.
1212449	Појдовните Beacon беа неправилно категоризирани од слојот MAC, што доведе до тоа emberCounterHandler() да не ги фати овие пакети со типот на бројач EMBER_COUNTER_MAC_TX_BROADCAST и наместо тоа да ги брои Beacons со типот EMBER_COUNTER_MAC_TXCC_UNICAST_. Тоа потенцијално резултираше со несигурни вредности за параметарот dest EmberNodeId предаден на структурата EmberCounterInfo

ID #	Опис
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 во табот Технички документи.

ID #	Опис	Заобиколување
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 на хостовите на Линукс моментално ја користат функцијата за добивање meofday, за која не се гарантира дека е монотона. Ако времето на системот се промени, тоа може да предизвика проблеми со времето на оџакот.	Изменете ги овие функции за да го користите clock_gettime со изворот CLOCK_MONOTONIC наместо тоа.
338151	Иницијализирањето на NCP со ниска вредност на броење бафер на пакети може да предизвика корумпирани пакети.	Користете ја резервираната вредност 0xFF за број на бафери на пакети за да ја избегнете прениската стандардна вредност
387750	Проблемот со форматите за барање табела за маршрута на крајниот уред.	Под истрага
400418	Иницијаторот на допир линк не може да се поврзе со цел на краен уред кој не е фабрички нов.	Не е познато решение.
424355	Иницијатор на допирна линија на допир, кој не е фабрички нов заспан, не може да прими одговор на информации за уредот во одредени околности.	Под истрага
465180	Ставката за оптимизација на радио блокатор на коегзистенција „Овозможи контрола на времетраење“ може да ја блокира правилната работа на Zigbee.	Изборен „Изберете Wi-Fi“ Контролата на оптимизацијата на блокаторите треба да се остави „Оневозможена“.
480550	Кластерот OTA има свој вграден метод на фрагментација, затоа не треба да користи APS фрагментација. Иако, во случај да е овозможено шифрирањето на APS, товарот на ImageBlockResponses го зголемува до големина каде што се активира фрагментацијата на APS. Ова може да доведе до неуспех на ОТА процесот.	Не е познато решение
481128	Деталните причини за ресетирање и деталите за падот треба да бидат стандардно достапни преку Virtual UART (Serial 0) на NCP платформите кога се овозможени приклучокот Diagnostics и Virtual UART периферниот уред.	Бидејќи серијата 0 е веќе иницијализирана во NCP, клиентите можат да го овозможат emberAfNcpInitCallback во Zigbee NCP Framework и да ги повикаат соодветните дијагностички функции (halGetExtendedResetInfo, halGetExtendedResetString, halPrintCrashSummary, и печатење на CrashSummary, thisrashhalDetailrint податоци за сериски 0 за viewвнесете во дневникот за снимање на Network Analyzer. За поранешенampЗа тоа како да ги користите овие функции, погледнете го кодот вклучен во emberAfMainInit() на a-main-soc.c кога е дефинирано EXTENDED_RESET_INFO.

ID #	Опис	Заобиколување
486369	Ако на DynamicMultiProtocolLightSoc што формира нова мрежа има детски јазли од мрежата што ја напуштила, emberAfGetChildTableSize враќа вредност која не е нула во startIdentifyOnAllChildNodes, предизвикувајќи Tx 66 пораки за грешка при обраќањето до децата „дух“.	Масовно избришете го делот ако е можно пред да креирате нова мрежа или програмски проверете ја детската табела откако ќе ја напуштите мрежата и избришете ги сите деца што користат emberRemoveChild пред да формирате нова мрежа.
495563	Приклучување на SPI NCP Sleepy End Device SampАпликацијата не скратува анкета, затоа обидот за приклучување не успева во состојба на Ажурирање TC Link Key.	Уредот што сака да се приклучи треба да биде во режим на кратка анкета пред да се обиде да се придружи. Овој режим може да биде принуден од приклучокот за поддршка на крајот на уредот.
497832	Во Network Analyzer, Zigbee Application Support Command Breakdown for Verify Key Request Frame погрешно го упатува делот од товарот што ја означува изворната адреса на рамката како адреса на дестинацијата.	Не е познато решение
519905 521782	Spi-NCP може многу ретко да не успее да ја стартува комуникацијата со подигнувачот користејќи ја командата „bootload“ CLI на приклучокот ota-client.	Рестартирајте го процесот на подигање
620596	NCP SPI Прample за BRD4181A (EFR32xGMG21) nДефинираниот стандарден пин за будење не може да се користи како пин за будење.	Променете ја стандардната игла за nWake од PD03 на игла EM2/3 за будење во приклучокот NCP-SPI.
631713	Уредот Zigbee End постојано ќе известува за конфликти на адреси ако се користи приклучокот „Zigbee PRO Stack Library“ наместо „Zigbee PRO Leaf Library“.	Користете ја „Zigbee PRO Leaf Library“ наместо приклучокот „Zigbee PRO Stack Library“.
670702	Неефикасноста во приклучокот за известување може да доведе до значително доцнење врз основа на фреквенцијата на пишување податоци и големината на табелата, што може да се меша со кодот на апликацијата на клиентите, вклучувајќи го и времето на настанот.	Ако често пишувате, размислете да ги проверите условите за известување и рачно да испраќате извештаи наместо да го користите приклучокот.
708258	Неиницијализирана вредност во group-server.c преку addEntryToGroupTable() може да создаде лажно врзување и да предизвика испраќање на пораки за известување за групни cast.	Додајте „binding.clusterId = EMBER_AF_INVALID_CLUSTER_ID;“ по „врзување.тип = 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 со овозможено барање за страница.	Користете Барање за блокирање наместо Барање страница.
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-zone-сервер. c дозволува креирање на врзување со „0000000000000000“ CIE адреса и подоцна не дозволува понатамошни врзувања.	Не е познато решение
1019961	Генериран Z3Gateway направиfile тврди кодови „gcc“ како CC	Не е познато решение

ID #	Опис	Заобиколување
1039767	Проблем со прелевање на редица на мрежата на Zigbee повторно во случај на употреба на RTOS со повеќе нишки.	Zigbee Stack не е безбеден за нишки. Како резултат на тоа, повикувањето Zigbee Stack API од друга задача не е поддржано во опкружувањето на ОС и може да го стави стекот во „неработна“ состојба. Погледнете ја следната белешка за апликација за повеќе информации и решение со користење на управувачот за настани. https://www.silabs.com/documents/public/application- notes/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. c's MSC_ErasePage рутина.	Решение: поставете ја следната линија код на врвот на функцијата MSC_ErasePage() во em_msc.c: почетна адреса = (uint32_t)((uint32_t)startAddress & ~(FLASH_PAGE_SIZE-1));*

Застарени ставки

Застарен во пуштањето
Во GSDK 7.4.0.0 наваму, вклучително и оваа закрпа, опцијата „-v“ во Z3Gateway за апликација домаќин на Linux за создавање телнет интерфејс со портата 4900 или 4901 е застарена. Алтернативниот препорачан начин за креирање на телнет интерфејс е да се користат услуги за 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's app.c.
Отстранета поставка EZSP_CONFIG_RETRY_QUEUE_SIZE за време на иницијализацијата ncp во ncp-configuration.c

Мултипротокол Gateway и 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 сега е квалитетна на производство.

Поправени проблеми
Поправено во ослободување

ID #	Опис
1213701	zigbeed не дозволи да се создаде изворен запис во табелата за совпаѓање за дете ако индиректната редица на MAC има податоци што веќе чекаат за тоа дете. Ова однесување може да доведе до откажување на трансакциите на слојот на апликацијата помеѓу детето и некој друг уред поради недостаток на APS Ack или одговор на слојот на апликацијата, особено прекинот и неочекуваното прекинување на надградбите на ZCL OTA насочени кон детскиот уред.
1244461	Записот од табелата за совпаѓање на изворот за дете може да се отстрани и покрај пораките што се чекаат.

Поправено во ослободување

ID #	Опис
1081828	Проблем со пропусната моќ со Zigbee/BLE DMP базирани на FreeRTOSampле апликации.
1090921	Z3GatewayCpc имаше проблем да формира мрежа во бучна средина.
1153055	Потврда за домаќинот беше предизвикана кога имаше неуспех во комуникацијата при читање на верзијата NCP од zigbee_ncp-ble_ncp-uart sampле апликација.
1155676	802.15.4 RCP ги отфрли сите примени unicast пакети (по 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 кој дејствува како родителски уред ќе го остави сетот на знаменце за податоци што чекаат за секое дете. Ова резултираше со секое дете да остане будно очекувајќи податоци по секоја анкета и бараше некоја друга трансакција на податоци што чекаат на секој краен уред за на крајот да ја исчисти оваа состојба.

Познати проблеми во тековното издание

ID #	Опис	Заобиколување
811732	Прилагодената поддршка за токени не е достапна кога се користи Zigbeed.	Поддршката е планирана во идното издание.
937562	Командата „advertise on“ Bluetoothctl не успева со апликацијата rcp-uart- 802154-blehci на Raspberry Pi OS 11.	Користете ја апликацијата btmgmt наместо bluetoothctl.
1022972	Coex не работи на ZB NCP + OT RCP.	Се планира поддршка за идното издание.
1074205	CMP RCP не поддржува две мрежи на истиот PAN ID.	Користете различни PAN ID за секоја мрежа. Поддршката е планирана во идното издание.
1122723	Во зафатена средина, CLI може да не реагира во апликацијата z3-light_ot-ftd_soc.	Не е познато решение.
1124140	z3-light_ot-ftd_soc sampLe апликацијата не може да ја формира мрежата Zigbee ако мрежата OT е веќе отворена.	Прво стартувајте ја мрежата Zigbee, а потоа мрежата ОТ.
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+ зигби уреди се спојуваат истовремено.	Додадено е поправка што може да го реши проблемот. Целосно ќе биде опфатено во идното издание.

Застарени ставки

Никој

Отстранети ставки
Отстранет во ослободување

Макрото „NONCOMPLIANT_ACK_TIMING_WORKAROUND“ е отстрането. Сите RCP апликации сега стандардно поддржуваат време на пресврт од 192 μсек. за не-подобрени актови додека сè уште користат 256 μсек. време на пресврт за подобрените актови што ги бара CSL.

Користење на ова издание
Ова издание го содржи следново:

Зигби магацинот

Рамка за апликација Zigbee
Зигби Сample Апликации

За повеќе информации за Zigbee и EmberZNet SDK, видете UG103.02: Zigbee Fundamentals.
Ако сте корисник за прв пат, видете QSG180: Zigbee EmberZNet Водич за брз почеток за SDK 7.0 и повисоки, за инструкции за конфигурирање на вашата развојна околина, градење и трепкање какоampле апликација и референци за документација кои укажуваат на следните чекори.

Инсталација и употреба

Zigbee EmberZNet SDK е обезбедена како дел од Gecko SDK (GSDK), пакетот на Silicon Labs SDK. За брзо да започнете со 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:\Users\ \SimplicityStudio\SDKs\gecko_sdk

(MacOS): /Корисници/ /SimplicityStudio/SDKs/gecko_sdk

Документацијата специфична за верзијата SDK е инсталирана со SDK. Дополнителни информации често може да се најдат во статиите на базата на знаење (KBAs). Референци за API и други информации за ова и претходните изданија се достапни на https://docs.silabs.com/.

Безбедносни информации

Безбедна интеграција на трезорот
За апликации кои избираат безбедно да ги складираат клучевите со помош на компонентата за складирање на безбедни клучеви на делови од Secure Vault-High, следната табела ги прикажува заштитените клучеви и нивните карактеристики за заштита на складирањето со кои управува компонентата Zigbee Security Manager.

Завиткан клуч	Извозно / неизвозно	Белешки
Мрежен клуч	Може да се извезува
Клуч за врска на Центарот за доверба	Може да се извезува
Клуч за минливи врски	Може да се извезува	Табела со индексирани клучеви, зачувана како испарлив клуч
Клучот за врска на апликацијата	Може да се извезува	Табела со индексирани клучеви
Обезбедете го клучот EZSP	Може да се извезува
ZLL клуч за шифрирање	Може да се извезува
ZLL претходно конфигуриран клуч	Може да се извезува
GPD прокси клуч	Може да се извезува	Табела со индексирани клучеви
Клуч за мијалник GPD	Може да се извезува	Табела со индексирани клучеви
Внатрешен/Клуч за место	Може да се извезува	Внатрешен клуч за употреба од Zigbee Security Manager

Завитканите клучеви што се означени како „Неизвезливи“ може да се користат, но не можат да се користат viewизменето или споделено при извршување.
Завитканите клучеви кои се означени како „Извезливи“ може да се користат или споделуваат при извршување, но остануваат шифрирани додека се складираат во блиц.
Корисничките апликации никогаш не треба да комуницираат со повеќето од овие клучеви. Постоечките API за управување со клучевите на Табелата со клучеви за врски или клучевите за преодни сè уште се достапни за корисничката апликација и сега се насочуваат низ компонентата Zigbee Security Manager.

Некои од овие клучеви може да станат неизвезливи за корисничката апликација во иднина. Корисничките апликации се охрабруваат да не се потпираат на извоз на клучеви освен ако е апсолутно неопходно.
За повеќе информации за функционалноста за управување со клучеви за безбедно сеф, видете AN1271: Безбедно складирање на клучеви.

Совети за безбедност
За да се претплатите на Security Advisories, најавете се на порталот за клиенти на Silicon Labs, а потоа изберете Account Home. Кликнете HOME за да отидете на почетната страница на порталот и потоа кликнете на плочката Управување со известувања. Осигурајте се дека е означено „Софтверски/безбедносни советодавни известувања и известувања за промена на производи (PCN)“ и дека сте претплатени најмалку за вашата платформа и протокол. Кликнете Зачувај за да ги зачувате сите промени.

Поддршка
Клиентите на пакетот за развој се подобни за обука и техничка поддршка. Користете ги Silicon Laboratories Zigbee 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 нема да има одговорност за последиците од употребата на информациите дадени во овој документ. Овој документ не имплицира или изрично дава никаква лиценца за дизајнирање или производство на какви било интегрирани кола. Производите не се дизајнирани или овластени да се користат во уреди од FDA класа III, апликации за кои е потребно одобрение од 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®, 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 Запад Цезар Чавез
Остин, TX 78701
САД

www.silabs.com

Документи / ресурси

SILICON LABS SDK 7.4.1.0 GA Zigbee Protocol Stack Software [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

Референци

Упатство за употреба

SILICON LABS SDK 7.4.1.0 GA Zigbee Protocol Stack Software

Информации за производот

Упатство за употреба на производот

Најчесто поставувани прашања

КЛУЧНИ КАРАКТЕРИСТИКИ

Нови компоненти

Наменето однесување

Подобрувања

Поправени проблеми

Познати проблеми во тековното издание

Застарени ставки

Отстранети ставки

Мултипротокол Gateway и RCP

Инсталација и употреба

Безбедносни информации

КОНТАКТ

Документи / ресурси

Референци

Оставете коментар

Откажете го одговорот