SILICON LABS 7.4.0.0 Zigbee EmberZNet SDK ソフトウェアユーザーガイド

同時リスニングのサポート (RCP) – MG21 および MG24
同時マルチプロトコル (CMP) Zigbee NCP + OpenThread RCP – 本番環境
SoC でのダイナミックマルチプロトコル Bluetooth + コンカレントマルチプロトコル (CMP) Zigbee および OpenThread のサポート

互換性と使用上の注意

セキュリティの更新と通知については、この SDK とともにインストールされる Gecko プラットフォームのリリースノートのセキュリティの章、または Web サイトの 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 を使用して、macOS または Linux 上で IarBuild.exe コマンドラインユーティリティまたは IAR Embedded Workbench GUI でビルドすると、正しくない結果が生じる可能性があります fileショートを生成するためのワインのハッシュアルゴリズムでの衝突のために使用されています file 名前。

macOS または Linux のお客様は、Simplicity Studio 以外で IAR を使用してビルドしないことをお勧めします。そうする顧客は、正しいことを慎重に確認する必要があります fileが使用されています。

GCC (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 全体で優れたユーザーエクスペリエンスを実現するために、品質を向上させ、安定性を確保し、パフォーマンスを強化するという当社の取り組みを反映しています。

新しいコンポーネント

リリース 7.4.0.0 の新機能

ユーザーが特定の Zigbee Direct セキュリティオプションを設定できるように、「zigbee_direct_security_p256」および「zigbee_direct_security_curve25519」コンポーネントが追加されました。

ユーザーは、Zigbee ダイレクトデバイス (ZDD) アプリケーションで複数の「zigbee_direct_security」コンポーネントを有効にすることができます。この場合、実際のセキュリティオプションは Zigbee 仮想デバイス (ZVD) 構成によって異なります。

新しいAPI

リリース 7.4.0.0 の新機能

新しい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 を返します。

新しいプラットフォームのサポート

リリース 7.4.0.0 の新機能

このリリースでは、EFR32MG24A010F768IM40 および EFR32MG24A020F768IM40 の新しいパーツに対する Zigbee スタックのサポートが追加されました。

新しいドキュメント

リリース 7.4.0.0 の新機能

Zigbee Secure Key Storage Upgrade (既存のプロジェクトとの下位互換性を追加) の追加を反映するために、Zigbee Secure Key Storage コンポーネントの説明を更新しました。

Zigbee Security Manager コンポーネントグループと対話するための新しいアプリケーションノートを追加しました (AN1412: Zigbee Security Manager)。

意図された動作

ユーザーは、Zigbee の非同期 CSL 送信は、無線スケジューラでのプロトコルプリエンプションの対象となることに注意してください。 SleepyToSleepy アプリケーションでは、BLE は Zigbee CSL 送信をプリエンプトすることができ、送信を終了します。スケジューラのプリエンプションは、潜在的に長いウェイクアップフレームシーケンスが使用される可能性があるため、非同期 CSL でより一般的です。送信優先度を調整したいユーザーは、DMP チューニングおよびテストコンポーネントを使用して調整できます。ユーザーからの相談も可能 UG305: ダイナミックマルチプロトコルユーザーガイド 詳細についてはこちらをご覧ください。

改善点

リリース 7.4.0.0 で変更されました

emberCounterHandler API ドキュメントの変更

以前のバージョンでは、パケット RX および TX に関する MAC 層および APS 層の EmberCounterTypes のカウンターハンドラーコールバックに、適切なターゲットノード ID またはデータ引数が渡されておらず、これらのパラメーターを使用する特定のカウンターの動作に関する API ドキュメントが不明瞭または誤解を招くものでした。

emberCounterHandler() のシグネチャは変更されていませんが、パラメータが設定される方法は若干変更されています。

ember-types.h の EmberCounterType 列挙型に関するコメントは、わかりやすくするために拡張されています。

TX 関連のカウンタのカウンタハンドラに対するノード ID パラメータは、使用前に宛先アドレスモードが有効な短縮 ID を示しているかどうかをチェックするようになりました。 (そうでない場合、宛先アドレスは入力されず、代わりに EMBER_UNKNOWN_NODE_ID のプレースホルダー値が使用されます。)
RX 関連カウンタのカウンタハンドラのノード ID パラメータには、宛先ノード ID ではなく送信元ノード ID が反映されるようになりました。

以前のバージョンの ember-types.h で説明されているように、再試行回数は EMBER_COUNTER_MAC_TX_UNICAST_SUCCESS/FAILED カウンターのデータパラメーターとして渡されません*。ただし、以前のリリースのバージョンではこれが適切に設定されなかったため、以前のリリースの値は常に 0 でした。この動作は、これらの EmberCounterType の説明で明確にされています。ただし、以前のリリースとの一貫性を保つために、APS 層の再試行の再試行回数は EMBER_COUNTER_APS_TX_UNICAST_SUCCESS/FAILED カウンタータイプのデータパラメーターに引き続き入力されます。
コールバックのノード ID またはデータパラメーターを設定するすべてのカウンターは監査され、ノード ID が予期されていたがパケットから取得できなかった場合、予期されたデータ、アドレス、または EMBER_UNKNOWN_NODE_ID が確実に渡されるようになりました。これについては、改訂版の Ember で説明されています。 -types.h ドキュメント。

EMBER_COUNTER_MAC_TX_UNICAST_RETRY の Counter ハンドラーは、MAC 層の宛先ノード ID と宛先ノード ID およびデータパラメーターの再試行回数を正しく反映するようになりました。
EMBER_COUNTER_PHY_CCA_FAIL_COUNT の Counter ハンドラーは、送信に失敗したメッセージの対象となる MAC 層ターゲットに関する宛先ノード ID 情報を、Node ID パラメーターを通じて提供するようになりました。

グリーン電力コードを更新

Green Power サーバーコードが更新され、次のようなさまざまな改善が加えられています。

GP サーバーで受信するときに無効なエンドポイントを持つ受信コマンドに対する検証コードを追加しました。
グリーン電力メッセージを作成するスペースがなくなった場合に処理するコードを追加しました。
仕様セクション A.3.5.2.4.1 に従って、シンクは場合によってはペアリングを削除するアクションを使用してペアリング構成を削除するようになりました。
シンクは、アクション拡張を使用してペアリング構成を処理するときに、エントリの既存のグループリストを削除する前に保存するようになりました。
変換テーブルが空の場合、またはインデックスがテーブル内のエントリ数より大きい場合、変換クエリコマンドはエラーコードとして「NOT FOUND」を返します。
一部のアプリの GP エンドポイントのバージョンを 1 から 0 に変更しました。

グリーンパワーデバイスは最小限のエネルギーデバイスであり、ほとんどの設計で CSMA を使用しないため、GPDF 送信機能での CSMA の使用は制限されています。代わりに、同じエネルギーバジェットを使用して複数のパケットを送信する設計が推奨されます。

Green Power Server プラグインオプションでの非表示エンドポイントの使用を削除しました。代わりにアプリケーションエンドポイントの 1 つを使用してください。

ネットワークキー更新プラグインコードの改善

ネットワークキーの定期更新期間を最長1年に変更しました。

不必要なキーのエクスポートを回避するために一部の API を再構築しました

プレーンテキストのキーデータよりもキーコンテキストの使用を優先するように変更を加えました。

sl_zigbee_send_security_challenge_request は、EmberKeyData の代わりに sl_zb_sec_man_context_t 引数を受け取るようになりました。
sl_zb_sec_man_derived_key_type 列挙型の値は、複数の派生型を組み合わせる特定のキー派生を直接サポートする 16 ビットビットマスクになりました。

修正された問題

リリース 7.4.0.0 で修正済み

ID＃	説明
1019348	Zigbee ZCL Cli コンポーネントの依存関係要件を修正し、不要なときに削除できるようにしました。
1024246	emberHaveLinkKey() および sl_zb_sec_man_have_link_key() の関数の説明を更新しました。
1036503	DMP に Micrium カーネルの使用を推奨する説明を追加しました。ampルアプリ。
1037661	アプリケーションがプロスタックまたはリーフスタックをインストールするのを妨げていた問題が修正されました。
1078136	割り込みコンテキストからイベントを変更するときの断続的なクラッシュを修正しました
1081548	ユーザーは、Zigbee の非同期 CSL 送信は、無線スケジューラでのプロトコルプリエンプションの対象となることに注意してください。 SleepyToSleepy アプリケーションでは、BLE は Zigbee CSL 送信をプリエンプトすることができ、送信を終了します。スケジューラのプリエンプションは、潜在的に長いウェイクアップフレームシーケンスが使用される可能性があるため、非同期 CSL でより一般的です。送信優先度を調整したいユーザーは、DMP チューニングおよびテストコンポーネントを使用して調整できます。詳細については、「UG305: Dynamic Multiprotocol User's Guide」を参照してください。 CSL では、前のペイロードフレームの直後に受信される新しいウェイクアップフレームシーケンスが正しく記録されない問題が修正されました。これにより、ペイロードフレームが失われる可能性があります。
1084111	MG24 ベースのボードに対する初期のスリーピー SPI-NCP サポートは、このリリースの一部として更新されます。
1104056	マルチネットワークの場合にセカンダリネットワークで実行するネットワークステアリングのサポートを追加しました。
1120515	mfglib set-channel コマンドを使用するときにチャネルが変更されない問題を修正しました。
1141109	が生成される原因となった問題を修正しました。ampファイルアプリケーション ncp-uart-gp-multi-rail でヘッダーが欠落する file■ -cp オプションを指定して Green Power アダプタコンポーネントを使用する場合。
1144316	gp-types.h ドキュメント内の一部のデータ構造タイプの説明を更新しました。
1144884	保留中のデータがない場合に設定されるスプリアスフレーム保留ビットを修正しました。
1152512	isr コンテキストでイベントを変更するときに low-mac-rail で発生する可能性のあるクラッシュを修正しました。
1154616	「スリーピーエンドデバイスから非スリーピーエンドデバイスへの役割の切り替え」の場合にネットワークを初期化する条件の例外を追加しました。
1157289	BDB テストの失敗を引き起こす可能性がある問題を修正しました DN-TLM-TC-02B。
1157426	green_power_adapter コンポーネントを使用して zigbee_simple_app をビルドするときのビルドの問題を修正しました。
1157932	「遷移時間」フィールドが欠落しているかどうかを確認し、この欠落フィールドにデフォルト値 0xFFFF を設定する条件を追加しました。
1166340	emberAfGpdfSend が意図した回数の繰り返し送信を妨げていた問題を修正しました。
1167807	分散ネットワークでトラストセンターとして機能するデバイスが、新しいデバイスが参加するたびに一時リンクキーを誤ってクリアしてしまう問題を修正しました。
1169504	強制ウェイクアップ時にスリープ状態のデバイスがリセットされる問題を修正しました。
1169966	バッファ割り当てコードで欠落していた戻り値の検証を修正しました。
1171477, 172270	mfglib start 1 ではメッセージは送信されず受信されるため、表示される端末メッセージ「mfglib send complete」は間違っており、「最後の %d ms で %d パケットを受信しました」に変更されました。
1171935	ネットワークキーの定期更新期間を最長1年に変更しました。
1172778	不足していた emberAfPluginGreenPowerServerUpdateAliasCallback の呼び出しを Green Power サーバーに追加しました。
1174288	進行中のスキャンを停止する呼び出しが呼び出された場合に、ネットワークステアリングプロセスがアサートされる問題を修正しました。
1178393	ドキュメントのエラーを更新しました。
1180445	スマートエネルギーでは、コーディネーターが制限されたデューティサイクルに達した場合、f OTA はダウンロードを継続するようになりました。
1185509	前のペイロードフレームの直後に受信される新しいウェイクアップフレームシーケンスが正しく記録されないという CSL の問題を修正しました。これにより、ペイロードフレームが失われる可能性があります。

ID＃	説明
1186107	受信した GPDF の復号化に失敗すると、GP コミッショニング通知内の受信 GPDF が置き換えられる問題を修正しました。
1188397	拡張レポートテーブルサイズを有効にするとコンパイルエラーが発生する問題を修正しました。
1194090	セクション 3.3.4.8.2 に従って、シンクコミッショニングモードコマンドのデフォルト応答の失敗ステータスを修正しました。
1194963	ユーザーコールバック emberAfGreenPowerServerPairingStatusCallback を呼び出す前に、commissioningGpd 構造体を memset する問題を修正しました。
1194966	エンドポイントおよび proxiesInvolved フィールドがコミッショニングの終了アクションで設定されなかった問題を修正しました。
1196698	保留中のデータがない場合に設定される偽のフレーム保留ビットを修正しました。
1199958	グリーン電力メッセージを作成するスペースがなくなった場合に処理するコードを追加しました。
1202034	sl_zb_sec_man_context_t スタック変数が正しく初期化されず、インストールコードとの結合が失敗する問題を修正しました。
1206040	エンドデバイスによる安全な再参加の試行中に emberRemoveChild() を呼び出すと、子カウントがさらに減らされる可能性があり、子カウントが -1 (255) になり、示された欠如によりエンドデバイスの参加/再参加が阻害される可能性があります。ビーコンの容量。
1207580	スタック内の子テーブル検索関数は、無効/空のエントリを表すノード ID 戻り値に 0x0000 と 0xFFFF を使用する点で一貫性がなく、emberRemoveChild() などの API で未使用のエントリをチェックする際に問題が発生します。
1210706	emberCounterHandler() の一部として EmberExtraCounterInfo 構造体で提供される宛先と PHY インデックスが、MAC TX ユニキャストカウンタタイプに対して正しくない可能性があります。
1211610 1212525	Secure Key Storage Upgrade コンポーネントを有効にした後にダイナミックマルチプロトコルアプリケーションがクラッシュする問題を修正しました。
1211847	emberCounterHandler() のシグネチャは変更されていませんが、パラメータが設定される方法は若干変更されています。この API に関する変更については、上記のセクション 2 で説明しています。
1212449	発信ビーコンが MAC 層によって誤って分類されていたため、emberCounterHandler() は EMBER_COUNTER_MAC_TX_BROADCAST カウンタータイプでこれらのパケットをキャッチできず、代わりに EMBER_COUNTER_MAC_TX_UNICAST_SUCCESS カウンタータイプでビーコンをカウントしていました。その結果、EMberCounterInfo 構造体に渡される dest EmberNodeId パラメータの信頼性の低い値が発生する可能性がありました。
1214866	特定の高トラフィック構成でデータポーリングパケットを送信すると、バス障害が発生する可能性があります。
1216552	混雑したトラフィック状況でアサーションが発生する問題が修正されました。
1216613	プロキシテーブルのグループキャスト半径の値が正しくなくなる問題を修正しました。
1222509	ルーター/コーディネーターが離脱と再参加要求を子以外のポーリングエンドデバイスに送信しますが、MAC 宛先は NWK 宛先アドレスと一致せずに 0xFFFF です。
1223842	sl_component_catalog.h の生成時に不要なコードが残されてコンパイルの失敗を引き起こす問題を修正しました。
756628	アプリケーションコールバック emberAfMacFilterMatchMessageCallback の呼び出しを、スタックによって検証された ZLL メッセージに対してのみ呼び出されるように変更しました。
816088	EMBER 設定を zigbeed_configuration.h から zigbeed.slcp に移動しました。
829508	競合状態を回避するために、下位層がビジーであるかチャネルを変更できる状態にない場合に失敗を返す追加の検証が emberSetLogicalAndRadioChannel に追加されました。

現在のリリースの既知の問題

太字の問題は、前回のリリース以降に追加されました。リリースを見逃した場合は、最新のリリースノートを入手できます。 https://www.silabs.com/developers/zigbee-emberznet Tech Docs タブで。

ID＃	説明	回避策
該当なし	• 次のアプリ/コンポーネントはこのリリースではサポートされていません: EM4 サポート	この機能は後続のリリースで有効になる予定です。
193492	emberAfFillCommandGlobalServerToClientConfigureReporting マクロが壊れています。バッファがいっぱいになると、不正なコマンドパケットが作成されます。	API の代わりに「zcl global send-me-a-report」CLI コマンドを使用します。
278063	スマートエネルギートンネリング plugins アドレステーブルインデックスの処理/使用法が矛盾しています。	既知の回避策はありません
289569	Network Creator コンポーネントの電力レベルの選択リストでは、EFR32 でサポートされている値の全範囲が提供されていません	CMSIS コメントで指定された範囲 <-8..20> を編集します。の EMBER_AF_PLUGIN_NETWORK_CREATOR_RADIO_P OWER /protocol/zigbee/app/framework/plugin/ネットワーククリエーター/config/network-creator-config.h file例えばamp<-26..20> に変更します。
295498	Zigbee+BLE ダイナミックマルチプロトコルの使用例では、高負荷時に UART 受信がバイトをドロップすることがあります。	ハードウェアフロー制御を使用するか、ボーレートを下げてください。
312291	EMHAL: Linux ホスト上の halCommonGetIntxxMillisecondTick 関数は現在、単調であることが保証されていない gettimeofday 関数を使用しています。システム時間が変更されると、スタックタイミングに問題が発生する可能性があります。	代わりに CLOCK_MONOTONIC ソースで Clock_gettime を使用するようにこれらの関数を変更します。
338151	低いパケットバッファカウント値で NCP を初期化すると、パケットが破損する可能性があります。	デフォルト値が低すぎることを避けるために、パケットバッファ数に 0xFF の予約値を使用します。
387750	エンドデバイスのルートテーブルリクエストの形式に問題があります。	調査中で
400418	タッチリンクイニシエータは、工場出荷時に新品ではないエンドデバイスターゲットにリンクできません。	既知の回避策はありません。
424355	工場出荷時に新品ではないスリーピーエンドデバイスのタッチリンクターゲット対応イニシエータは、特定の状況ではデバイス情報応答を受信できません。	調査中で
465180	共存無線ブロッカーの最適化項目「ランタイム制御を有効にする」により、Zigbee の適切な動作がブロックされる場合があります。	ブロッカー最適化のオプションの「Wi-Fi 選択」コントロールは「無効」のままにする必要があります。
480550	OTA クラスターには独自のフラグメンテーション方式が組み込まれているため、APS フラグメンテーションを使用すべきではありません。ただし、APS 暗号化が有効になっている場合、ImageBlockResponse のペイロードは、APS フラグメンテーションがアクティブになるサイズまで増加します。これにより、OTA プロセスが失敗する可能性があります。	既知の回避策はありません
481128	詳細なリセット原因とクラッシュの詳細は、診断プラグインと仮想 UART ペリフェラルが有効になっている場合、NCP プラットフォーム上の仮想 UART (シリアル 0) 経由でデフォルトで利用可能になります。	シリアル 0 は NCP ですでに初期化されているため、顧客は Zigbee NCP フレームワークで emberAfNcpInitCallback を有効にし、このコールバックで適切な診断関数 (halGetExtendedResetInfo、halGetExtendedResetString、halPrintCrashsummary、halPrintCrashDetails、および halPrintCrashData) を呼び出して、このデータをシリアル 0 に出力できます。 viewネットワークアナライザのキャプチャログに記録されます。元彼にとってampこれらの関数の使用方法については、EXTENDED_RESET_INFO が定義されている場合の af-main-soc.c の emberAfMainInit() に含まれるコードを参照してください。

ID＃	説明	回避策
486369	新しいネットワークを形成する DynamicMultiProtocolLightSoc に、離脱したネットワークの子ノードが残っている場合、emberAfGetChildTableSize は startIdentifyOnAllChildNodes にゼロ以外の値を返し、「ゴースト」の子をアドレス指定するときに Tx 66 エラーメッセージを引き起こします。	可能であれば、新しいネットワークを作成する前にパーツを一括消去するか、ネットワークを離れた後にプログラムで子テーブルを確認し、新しいネットワークを形成する前に emberRemoveChild を使用してすべての子を削除します。
495563	SPI NCP スリーピーエンドデバイス S への参加ampファイルアプリはショートポーリングを行わないため、TC リンクキーの更新の状態で参加の試行は失敗します。	参加を希望するデバイスは、参加を試みる前にショートポーリングモードになっている必要があります。このモードは、End Device Support プラグインによって強制できます。
497832	ネットワークアナライザーでは、検証キー要求フレームの Zigbee アプリケーションサポートコマンドブレークダウンが、フレームの送信元アドレスを宛先アドレスとして示すペイロードの部分を誤って参照します。	既知の回避策はありません
519905 521782	Spi-NCP は、ota クライアントプラグインの「bootload」CLI コマンドを使用したブートローダー通信の開始にごくまれに失敗することがあります。	ブートロードプロセスを再起動します
620596	NCP SPI ExampBRD4181A (EFR32xGMG21) 用のファイル定義された nWake デフォルトピンはウェイクアップピンとして使用できません。	NCP-SPI プラグインで、nWake のデフォルトのピンを PD03 から EM2/3 ウェイクアップが有効なピンに変更します。
631713	「Zigbee PRO Leaf Library」の代わりにプラグイン「Zigbee PRO Stack Library」が使用されている場合、Zigbee エンドデバイスはアドレス競合を繰り返し報告します。	「Zigbee PRO Stack Library」プラグインの代わりに「Zigbee PRO Leaf Library」を使用してください。
670702	Reporting プラグイン内の非効率性により、データの書き込み頻度とテーブルサイズに基づいて大幅な遅延が発生する可能性があり、イベントタイミングを含む顧客のアプリケーションコードに干渉する可能性があります。	頻繁に書き込みを行う場合は、プラグインを使用するのではなく、レポート条件を確認し、手動でレポートを送信することを検討してください。
708258	groups-server.c 内の初期化されていない値 addEntryToGroupTable() は偽のバインディングを作成し、グループキャストレポートメッセージが送信される可能性があります。	「binding.clusterId =」を追加します。 EMBER_AF_INVALID_CLUSTER_ID;” 「binding.type = EMBER_MULTICAST_BINDING;」の後
757775	すべての EFR32 パーツには固有の RSSI オフセットがあります。さらに、ボードの設計、アンテナ、エンクロージャが RSSI に影響を与える可能性があります。	新しいプロジェクトを作成するときに、RAIL ユーティリティ、RSSI コンポーネントをインストールします。この機能には、Silabs が各部品に対して測定したデフォルトの RSSI オフセットが含まれています。このオフセットは、完成した製品の RF テスト後に必要に応じて変更できます。
758965	ZCL クラスターコンポーネントと ZCL コマンド検出テーブルは同期されていません。したがって、ZCL クラスターコンポーネントを有効または無効にしても、実装されたコマンドは、対応する ZCL Advanced Configurator コマンドタブで有効または無効になりません。	ZCL Advanced Configurator で必要な ZCL コマンドの検出を手動で有効/無効にします。
765735	ページ要求が有効になっているスリーピーエンドデバイスでは、OTA アップデートが失敗します。	ページリクエストの代わりにブロックリクエストを使用してください。
845649	CLI:Core コンポーネントを削除しても、sl_cli.h への EEPROM cli 呼び出しは排除されません。	eeprom-cli.c を削除します。 file これは sl_cli.h を呼び出します。さらに、sl_cli.h への呼び出しと ota-storage-simple-eeprom の sl_cli_command_arg_t はコメントアウトできます。
857200	ias-zone-server.c では、「0000000000000000」CIE アドレスを使用してバインディングを作成できますが、それ以降のバインディングは許可されません。	既知の回避策はありません
1019961	生成された Z3Gateway makefile 「gcc」を CC としてハードコードします	既知の回避策はありません

ID＃	説明	回避策
1039767	マルチスレッド RTOS 使用例における Zigbee ルーターのネットワーク再試行キューのオーバーフローの問題。	Zigbee スタックはスレッドセーフではありません。その結果、別のタスクからの Zigbee スタック API の呼び出しは OS 環境ではサポートされず、スタックが「非動作」状態になる可能性があります。イベントハンドラーを使用した詳細と回避策については、次のアプリケーションノートを参照してください。 https://www.silabs.com/documents/public/application notes/an1322-dynamic-multiprotocol-bluetooth-zigbee-sdk 7x.pdf .
1064370	Z3Switch のampファイルアプリケーションはデフォルトで 1 つのボタン (インスタンス : btnXNUMX) のみを有効にしているため、プロジェクト内のボタンの説明が不一致になります。file.	回避策: Z0Switch プロジェクトの作成中に btn3 インスタンスを手動でインストールします。
1161063	Z3Light および他の可能性のあるアプリケーションは、誤ったクラスターリビジョン値を報告します。	クラスターのリビジョン属性を適切なリビジョンに手動で更新します。
1164768, 1171478, 1171479	エラー: mfglib 受信モード中に ezspErrorHandler s0x34 が繰り返し報告されました	出力されるエラーメッセージを減らすには、ホストアプリの EMBER_AF_PLUGIN_GATEWAY_MAX_WAIT_FOR_EV ENT_TIMEOUT_MS を 100 に構成して、コールバックキューがより早く解放されるようにします。

非推奨のアイテム

リリース 7.4.0.0 で非推奨

次の非推奨のセキュリティ API を削除しました。

emberGetKey()

emberGetKeyTableEntry()

emberSetKeyTableEntry()

emberHaveLinkKey()

emberAddOrUpdateKeyTableEntry()

emberAddTransientLinkKey()

emberGetTransientKeyTableEntry()

emberGetTransientLinkKey()

emberHmacAesHash()

キーストレージと HMAC ハッシュへのアクセスには、Zigbee Security Manager が提供する API を使用します。

削除されたアイテム

リリース 7.4.0.0 で削除されました

パブリックヘッダー内の重複したパブリック API を削除しました file gp-types.h。
zigbee_end_device_bind コンポーネントは削除されました。このコンポーネントは、コーディネーターがエンドデバイスのバインディング要求を仲介するために使用されました。このオプション機能は、Zigbee コア仕様の R22 から削除されました。
af-host.c の setPacketBufferCount() とコマンド handlers.c の不要なチェックケース EZSP_CONFIG_PACKET_BUFFER_COUNT: を削除しました。
NCP の初期化時に 2 つのフェーズに分割する必要がないため、memoryAllocation 引数を削除しました。

se14-comms-hub、se14-ihd、se14-meter-gas の app.c の emberAfNcpInitCallback() を削除しました。
ncp-configuration.c の ncp 初期化中の EZSP_CONFIG_RETRY_QUEUE_SIZE 値の設定を削除しました。

マルチプロトコルゲートウェイと RCP

新商品

リリース 7.4.0.0 で追加

同時リスニング、EFR802.15.4xG32 または xG24 RCP の使用時に Zigbee および OpenThread スタックが独立した 21 チャネルで動作する機能がリリースされました。同時リスニングは、802.15.4 RCP/Bluetooth RCP の組み合わせ、Zigbee NCP/OpenThread RCP の組み合わせ、または Zigbee/OpenThread システムオンチップ (SoC) では利用できません。将来のリリースでこれらの製品に追加される予定です。

OpenThread CLI ベンダー拡張機能が、マルチプロトコルコンテナーの OpenThread ホストアプリに追加されました。これには、coex cli コマンドが含まれます。

改善点

リリース 7.4.0.0 で変更されました

Zigbee NCP/OpenThread RCP マルチプロトコルの組み合わせは、実稼働品質になりました。

修正された問題

リリース 7.4.0.0 で修正済み

ID＃	説明
1081828	FreeRTOS ベースの Zigbee/BLE DMP のスループットの問題ampファイルアプリケーション。
1090921	Z3GatewayCpc は、ノイズの多い環境でネットワークを形成するのに問題がありました。
1153055	zigbee_ncp-ble_ncp-uart から NCP バージョンを読み取るときに通信障害が発生すると、ホスト上でアサートが発生しました。ampルアプリ。
1155676	複数の 802.15.4 インターフェイスが同じ 15.4 ビットノード ID を共有している場合、16 RCP は受信したすべてのユニキャストパケットを (MAC ACK 後) 破棄しました。
1173178	ホストは、Host-RCP セットアップの mfglib で受信した数百のパケットを誤って報告しました。
1190859	Host-RCP セットアップで mfglib ランダムパケットを送信すると、EZSP エラーが発生します。
1199706	忘れられたエンドデバイスの子からのデータポーリングは、元の子への脱退と再参加コマンドをキューに入れるための保留中のフレームを RCP に適切に設定していませんでした。
1207967	「mfglib send random」コマンドが Zigbeed 上で余分なパケットを送信していました。
1208012	mfglib rx モードは、RCP で受信するときにパケット情報を正しく更新しませんでした。
1214359	80 台以上のルーターがホストと RCP のセットアップに同時に参加しようとすると、コーディネーターノードがクラッシュしました。
1216470	アドレスマスク 0xFFFF のブロードキャストを中継した後、親デバイスとして機能する Zigbee RCP は、各子に設定された保留データフラグを残します。その結果、各子は各ポーリング後にデータを期待して起きたままになり、最終的にこの状態をクリアするには、各エンドデバイスに対する他の保留中のデータトランザクションが必要になりました。

現在のリリースの既知の問題

太字の問題は、前回のリリース以降に追加されました。リリースを見逃した場合は、最新のリリースノートを入手できます。 https://www.silabs.com/developers/gecko-software-development-kit.

ID＃	説明	回避策
811732	Zigbeed を使用する場合、カスタムトークンのサポートは利用できません。	サポートは将来のリリースで予定されています。
937562	Raspberry Pi OS 802154 上の rcp-uart 11-blehci アプリで Bluetoothctl の「advertise on」コマンドが失敗します。	bluetoothctl の代わりに btmgmt アプリを使用します。

ID＃	説明	回避策
1022972	ZB NCP + OT RCP では Coex が機能しません。	将来のリリースではサポートが予定されています。
1074205	CMP RCP は、同じ PAN ID 上の 2 つのネットワークをサポートしません。	ネットワークごとに異なる PAN ID を使用します。将来のリリースではサポートが予定されています。
1122723	混雑した環境では、z3-light_ot-ftd_soc アプリで CLI が応答しなくなる場合があります。	既知の回避策はありません。
1170052	CMP Zigbee NCP + OT RCP および DMP Zigbee NCP + BLE NCP は、この現在のリリースの 64KB 以下の RAM パーツに適合しない可能性があります。	64KB パーツは現在、これらのアプリではサポートされていません。
1213701	騒がしい環境で子への OTA アップグレード中に、RCP が眠そうな子に対して保留中のデータを示すことができず、更新プロセスが予期せず終了する場合があります。	将来のリリースで対応される予定です。
1221299	Mfglib RSSI 読み取り値は、RCP と NCP で異なります。	将来のリリースで対応される予定です。

非推奨のアイテム

なし

削除されたアイテム

リリース 7.4.0.0 で削除されました

「NONCOMPLIANT_ACK_TIMING_WORKAROUND」マクロは削除されました。すべての RCP アプリは現在、デフォルトで非拡張 ACK のターンアラウンドタイム 192 マイクロ秒をサポートしていますが、CSL で必要な拡張 ACK のターンアラウンドタイムは引き続き 256 マイクロ秒です。

このリリースの使用

このリリースには次の内容が含まれています。

ジグビースタック
Zigbee アプリケーションフレームワーク
ジグビーSampファイルアプリケーション

Zigbee と EmberZNet SDK の詳細については、「」を参照してください。 UG103.02: Zigbee の基礎.

初めての方はこちらをご覧ください QSG180: SDK 7.0 以降の Z Zigbee EmberZNet クイックスタートガイド、開発環境の構成、ビルドとフラッシュの手順については、ampファイルアプリケーション、および次のステップを示すドキュメント参照。

インストールと使用

Zigbee EmberZNet SDK は、Silicon Labs SDK スイートである Gecko SDK (GSDK) の一部として提供されます。 GSDK をすぐに使い始めるには、次の手順を実行します。シンプリシティスタジオ 5これにより、開発環境がセットアップされ、GSDK のインストールが完了します。 Simplicity Studio 5 には、リソースおよびプロジェクトランチャー、ソフトウェア構成ツール、GNU ツールチェーンを備えた完全な IDE、分析ツールなど、Silicon Labs デバイスを使用した IoT 製品開発に必要なすべてが含まれています。インストール手順はオンラインで提供されます Simplicity Studio 5 ユーザーガイド.

または、Gecko SDK は、GitHub から最新のものをダウンロードまたは複製して、手動でインストールすることもできます。見る https://github.com/SiliconLabs/gecko_sdk 詳細についてはこちらをご覧ください。

Simplicity Studio は、デフォルトで GSDK を次の場所にインストールします。

(Windows): C:\Users\ \SimplicityStudio\SDKs\gecko_sdk
(MacOS): /Users/ /SimplicityStudio/SDKs/gecko_sdk

SDK バージョンに固有のドキュメントは SDK とともにインストールされます。追加情報は、多くの場合、ナレッジベース記事 (KBA)。このリリースおよび以前のリリースに関する API リファレンスおよびその他の情報は、次の場所で入手できます。 https://docs.silabs.com/.

セキュリティ情報

安全なボールト統合

Secure Vault-High パーツ上の Secure Key Storage コンポーネントを使用してキーを安全に保存することを選択したアプリケーションの場合、次の表に、Zigbee Security Manager コンポーネントが管理する保護されたキーとそのストレージ保護特性を示します。

ラップされたキー	輸出可能/輸出不可	注記
ネットワークキー	エクスポート可能
トラストセンターリンクキー	エクスポート可能
一時的なリンクキー	エクスポート可能	インデックス付きキーテーブル、揮発性キーとして保存
アプリケーションリンクキー	エクスポート可能	インデックス付きキーテーブル
安全なEZSPキー	エクスポート可能
ZLL暗号化キー	エクスポート可能
ZLL 事前構成キー	エクスポート可能
GPD プロキシキー	エクスポート可能	インデックス付きキーテーブル
GPDシンクキー	エクスポート可能	インデックス付きキーテーブル
内部/プレースホルダーキー	エクスポート可能	Zigbee Security Manager が使用する内部キー

「Non-Exportable」とマークされたラップされた鍵は使用できますが、 view実行時に編集または共有されます。

「エクスポート可能」とマークされたラップされた鍵は、実行時に使用または共有できますが、フラッシュに保存されている間は暗号化されたままです。

ユーザーアプリケーションは、これらのキーの大部分を操作する必要はありません。リンクキーテーブルキーまたは一時キーを管理するための既存の API は引き続きユーザーアプリケーションで使用でき、Zigbee セキュリティマネージャーコンポーネントを通じてルーティングされるようになりました。

これらのキーの一部は、将来ユーザーアプリケーションにエクスポートできなくなる可能性があります。ユーザーアプリケーションは、絶対に必要な場合を除き、キーのエクスポートに依存しないことが推奨されます。

Secure Vault キー管理機能の詳細については、次を参照してください。 AN1271: 安全なキーの保管.

セキュリティ勧告

セキュリティアドバイザリを購読するには、Silicon Labs カスタマーポータルにログインし、 アカウントホーム。クリック家ポータルのホームページに移動し、 通知を管理する タイル。「ソフトウェア/セキュリティ勧告通知および製品変更通知 (PCN)」がチェックされていること、および使用しているプラットフォームとプロトコルに対して少なくともサブスクライブしていることを確認してください。クリック保存変更を保存します。

サポート

Development Kit の顧客はトレーニングとテクニカルサポートを受けることができます。使用シリコンラボラトリー Zigbee web ページ Silicon Labs Zigbee のすべての製品とサービスに関する情報を入手し、製品サポートにサインアップします。

Silicon Laboratories のサポートに連絡できます。 http://www.silabs.com/support.

免責事項

Silicon Labs は、Silicon Labs 製品を使用している、または使用しようとしているシステムおよびソフトウェア実装者が利用できるすべての周辺機器およびモジュールに関する最新かつ正確かつ詳細なドキュメントを顧客に提供する予定です。特性データ、利用可能なモジュールと周辺機器、メモリサイズとメモリアドレスはそれぞれの特定のデバイスを指し、提供される「標準」パラメータはアプリケーションによって異なる場合があり、実際に異なります。アプリケーションexampここで説明するファイルは、説明のみを目的としています。 Silicon Labs は、本書の製品情報、仕様、および説明を予告なく変更する権利を留保し、含まれる情報の正確性または完全性については保証しません。 Silicon Labs は、セキュリティまたは信頼性の理由から、事前の通知なく、製造プロセス中に製品ファームウェアを更新する場合があります。このような変更によって製品の仕様や性能が変わることはありません。 Silicon Labs は、このドキュメントで提供される情報の使用による結果に対して責任を負いません。この文書は、集積回路を設計または製造するライセンスを暗示または明示的に付与するものではありません。これらの製品は、Silicon Labs の書面による特別な同意がない限り、FDA クラス III デバイス、FDA の市販前承認が必要なアプリケーション、またはライフサポートシステム内で使用するように設計または認可されていません。「生命維持システム」とは、生命および/または健康をサポートまたは維持することを目的とした製品またはシステムであり、故障した場合、重大な人身傷害または死亡につながることが合理的に予想されます。 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 ロゴ®、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 の登録商標です。ここで言及されている他のすべての製品またはブランド名は、それぞれの所有者の商標です。

シリコンラボラトリーズ株式会社
400西シーザーチャベス
オースティン、テキサス州 78701
アメリカ合衆国

www.silabs.com

ドキュメント / リソース

SILICON LABS 7.4.0.0 Zigbee EmberZNet SDK ソフトウェア [pdf] ユーザーガイド
7.4.0.0 Zigbee EmberZNet SDK ソフトウェア, 7.4.0.0, Zigbee EmberZNet SDK ソフトウェア, EmberZNet SDK ソフトウェア, SDK ソフトウェア, ソフトウェア

参考文献

ユーザーマニュアル