SILICON LABS SDK 7.4.1.0 GA Zigbee プロトコル スタック ソフトウェア
製品情報
仕様
- Zigbee EmberZNet SDK バージョン: 7.4.1.0
- Gecko SDK スイートのバージョン: 4.4 – 14年2024月XNUMX日
- ベンダー： シリコンラボ
- 主な特徴: SoC でのマルチプロトコル Zigbee および OpenThread のサポート
- 互換性のあるコンパイラ: GCC バージョン 12.2.1
- EZSP プロトコルのバージョン: 0x0D
製品使用説明書
互換性と使用上の注意
- セキュリティの更新と通知については、この SDK とともにインストールされる Gecko プラットフォーム リリース ノートのセキュリティの章を参照するか、Silicon Labs の TECH DOCS タブにアクセスしてください。 webサイト。
- セキュリティ アドバイザリを購読して最新情報を入手してください。
よくある質問
- 質問： 正しいことを確認するにはどうすればよいですか fileは互換性のあるコンパイラで使用されていますか?
- 答え： 正しいことを確認できます fileは、Simplicity Studio に付属の GCC バージョン 12.2.1 を確認して使用されています。
- 質問： セキュリティアップデートや通知に関する情報はどこで入手できますか?
- 答え： セキュリティの更新と通知については、Gecko プラットフォーム リリース ノートのセキュリティの章を参照するか、Silicon Labs の TECH DOCS タブにアクセスしてください。 webサイト。
Silicon Labs は、Zigbee ネットワークを自社製品に開発する OEM にとって最適なベンダーです。 Silicon Labs Zigbee プラットフォームは、利用可能な中で最も統合され、完全で、機能が豊富な Zigbee ソリューションです。
Silicon Labs EmberZNet SDK には、Silicon Labs による Zigbee スタック仕様の実装が含まれています。
- これらのリリースノートは、SDKバージョンを対象としています。
- 7.4.1.0 14 年 2024 月 XNUMX 日リリース
- 7.4.0.0 13 年 2023 月 XNUMX 日リリース
主な特徴
ジグビー
- Zigbee R23 準拠
- Zigbee スマート エネルギー 1.4a 準拠 - 本番環境
- Zigbee GP 1.1.2 準拠 – アルファ版
- MG27 サポート – 実稼働
- Secure Vault パーツのサポートの改善
- NCP SPI (非 CPC) アプリケーションでの Sleepy サポート – アルファ版
マルチプロトコル
- 同時リスニングのサポート (RCP) – MG21 および MG24
- 同時マルチプロトコル (CMP) Zigbee NCP + OpenThread RCP – 本番環境
- SoC でのダイナミック マルチプロトコル Bluetooth + コンカレント マルチプロトコル (CMP) Zigbee および OpenThread のサポート
互換性と使用上の注意
セキュリティ更新と通知の詳細については、この SDK とともにインストールされる Gecko プラットフォーム リリース ノートのセキュリティの章、または次の [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短いファイルを生成するための Wine のハッシュ アルゴリズムでの衝突により、 が使用されています。 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 全体で優れたユーザー エクスペリエンスを実現するために、品質を向上させ、安定性を確保し、パフォーマンスを強化するという当社の取り組みを反映しています。
新しいコンポーネント
新リリース
- ユーザーが特定の Zigbee Direct セキュリティ オプションを設定できるように、「zigbee_direct_security_p256」および「zigbee_direct_security_curve25519」コンポーネントが追加されました。
- ユーザーは、Zigbee ダイレクト デバイス (ZDD) アプリケーションで複数の「zigbee_direct_security」コンポーネントを有効にすることができます。この場合、実際のセキュリティ オプションは Zigbee 仮想デバイス (ZVD) 構成によって異なります。
新しいAPI
新リリース
- Zigbee NVM3 トークンをデフォルト値にリセットするための新しい API sl_zigbee_token_factory_reset を追加しました。
- 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* context, sl_zb_sec_man_key_t* key) を追加しました。これは、コンテキストによって参照されるキーが引数で指定されたキーと同じ値を持つ場合に true を返します。
新しいプラットフォームのサポート
新リリース
- このリリースでは、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: Dynamic Multiprotocol User's Guide」を参照してください。
改善点
リリース時に変更されました
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 で説明されているように、EMBER_COUNTER_MAC_TX_UNICAST_SUCCESS/FAILED カウンターのデータ パラメーターとして渡されません。以前のバージョンでは h でしたが、これは以前のリリース バージョンでは適切に設定されなかったため、以前のリリースではその値は常に 0 でした。この動作は、これらの EmberCounterTypes の説明で明確にされています。ただし、以前のリリースとの一貫性を保つために、APS レイヤーの再試行の再試行回数は EMBER_COUNTER_APS_TX_UNICAST_SUCCESS/FAILED カウンター タイプのデータ パラメーターに引き続き入力されます。
- コールバックのノード ID またはデータ パラメータを設定するすべてのカウンタは監査され、ノード ID が予期されていたがパケットから取得できなかった場合は、予期されたデータ、アドレス、または EMBER_UNKNOWN_NODE_ID を確実に渡すようになりました。これは改訂版で説明されています。 types.h のドキュメント。
- EMBER_COUNTER_MAC_TX_UNICAST_RETRY のカウンター ハンドラーは、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 ビット ビットマスクになりました。
修正された問題
リリースで修正されました
| ID＃ | 説明 |
| 1036893 | OTA クラスター コンポーネントがレガシー ブートローダー インターフェイス コンポーネントを依存関係としてインストールする原因となった問題を修正しました。 |
| 1114905 | Zigbee Direct: Leave Network Characteristic の処理が改善されました。 |
| 1180937 | Zigbee Direct ZDD をサードパーティ ZVD に接続するときの WDT リセットを修正しました。 |
| 1223904 | 非常に混雑した環境でエンドデバイスが誤って動作する原因となる問題を修正しました。 |
| 1224393 | Green Power シンク テーブル要求ハンドラー コードを更新して、応答宛先アドレスを更新しました。 |
| 1228808 | gp-types.h ドキュメントのマクロ定義の表示の問題を修正しました。 |
| 1232297 | emberSetOutcomingNwkFrameCounter および emberSetOutcomingApsFrameCounter が 64 ビット ホスト アプリケーションで機能しない (EMBER_BAD_ARGUMENT を返す) 問題を修正しました。 |
| 1232359 | Green Power クライアントのコマンド処理における gppTunnelingDelay パラメーターの計算を修正しました。 |
|
1240392 |
アクセス/許可の理由で拒否された ZDO バインド/バインド解除リクエストは、Zigbee 仕様に従って EMBER_ZDP_NOT_PERMITTED ステータスではなく、EMBER_ZDP_NOT_AUTHORIZED ステータスを返す必要があります。 |
| 1243523 | Zigbee Direct: ZVD への BLE 接続の安定性が向上しました。 |
| 1249455 | ACK を受信する前にブロードキャストを受信すると、スリープ状態のエンドデバイスがスリープ状態になる問題を修正しました。 |
| 1252295 | コンポーネント カタログ マクロ SL_CATALOG_ZIGBEE_OTA_STORAGE_COMMON_PRESENT のタイプミスを修正しました。 |
リリースで修正されました
| 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 で発生する可能性のあるクラッシュを修正しました。 |
| ID＃ | 説明 |
| 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 送信完了」は間違っており、「最後の %d ミリ秒で %d パケットを受信しました」に変更されました。 |
| 1171935 | ネットワークキーの定期更新期間を最長1年に変更しました。 |
| 1172778 | 不足していた emberAfPluginGreenPowerServerUpdateAliasCallback の呼び出しを Green Power サーバーに追加しました。 |
| 1174288 | 進行中のスキャンを停止する呼び出しが呼び出された場合に、ネットワーク ステアリング プロセスがアサートされる問題を修正しました。 |
| 1178393 | ドキュメントのエラーを更新しました。 |
| 1180445 | スマート エネルギーでは、コーディネーターが制限されたデューティ サイクルに達した場合、OTA はダウンロードを継続するようになりました。 |
| 1185509 | 前のペイロード フレームの直後に受信される新しいウェイクアップ フレーム シーケンスが正しく記録されないという CSL の問題を修正しました。これにより、ペイロード フレームが失われる可能性があります。 |
| 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 パラメータの信頼性の低い値が発生する可能性がありました。 |
| ID＃ | 説明 |
| 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.si-labs.com/developers/zigbee-emberznet Tech Docs タブで。
| ID＃ | 説明 | 回避策 |
| 該当なし | ·次のアプリ/コンポーネントはこのリリースではサポートされていません: EM4 サポート | この機能は後続のリリースで有効になる予定です。 |
|
193492 |
emberAfFillCommandGlobalServerToClientConfigureReporting マクロが壊れています。バッファがいっぱいになると、不正なコマンド パケットが作成されます。 | API の代わりに「zcl global send-me-a-report」CLI コマンドを使用します。 |
| 278063 | スマートエネルギートンネリング plugins アドレス テーブル インデックスの処理/使用法が矛盾しています。 | 既知の回避策はありません |
|
289569 |
ネットワーク クリエーター コンポーネントの電力レベルの選択リストでは、EFR32 でサポートされる値の全範囲が提供されていません。 |
EMBER_AF_PLUGIN_NETWORK_CREATOR_RADIO_P の CMSIS コメントで指定された範囲 <-8..20> を編集します
でワーワー /protocol/ZigBee/app/framework/plugin/network-creator/config/network-creator-config.h file例えばamp に変更します。 |
| 295498 | Zigbee+BLE ダイナミック マルチプロトコルの使用例では、高負荷時に UART 受信でバイトがドロップされることがあります。 | ハードウェア フロー制御を使用するか、ボー レートを下げてください。 |
|
312291 |
EMHAL: Linux ホスト上の halCommonGetIntxxMillisecondTick 関数は現在、meofday の取得関数を使用していますが、これは単調であることが保証されていません。システム時間が変更されると、スタック タイミングに問題が発生する可能性があります。 |
代わりに 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 が定義されている場合の a-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 |
addEntryToGroupTable() を介した groups-server.c の初期化されていない値により、偽のバインディングが作成され、グループ キャスト レポート メッセージが送信される可能性があります。 | 「binding.clusterId = EMBER_AF_INVALID_CLUSTER_ID;」を追加します。 「binding.type」の後
= EMBER_MULTICAST_BINDING;” |
|
757775 |
すべての EFR32 パーツには固有の RSSI オフセットがあります。さらに、ボードの設計、アンテナ、エンクロージャが RSSI に影響を与える可能性があります。 |
新しいプロジェクトを作成するときに、RAIL ユーティリティ、RSSI コンポーネントをインストールします。この機能には、各部品に対して測定されたデフォルトの RSSI オフセット Silabs が含まれています。このオフセットは、完成した製品の RF テスト後に必要に応じて変更できます。 |
|
758965 |
ZCL クラスター コンポーネントと ZCL コマンド検出テーブルは同期されていません。したがって、ZCL クラスター コンポーネントを有効または無効にしても、実装されたコマンドは、対応する ZCL Advanced Configurator コマンド タブで有効または無効になりません。 | ZCL Advanced Configurator で必要な ZCL コマンドの検出を手動で有効/無効にします。 |
| 765735 | ページ要求が有効になっているスリーピー エンド デバイスでは、OTA アップデートが失敗します。 | ページリクエストの代わりにブロックリクエストを使用してください。 |
|
845649 |
CLI の削除: コア コンポーネントは、sl_cli.h への EEPROM cli 呼び出しを排除しません。 |
eeprom-cli.c を削除します。 file これは sl_cli.h を呼び出します。さらに、ota-storage-simple-eeprom 内の sl_cli.h および sl_cli_command_arg_t の呼び出しはコメントアウトできます。 |
|
857200 |
ias ゾーンサーバー。 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 0x34 が繰り返し報告されました | 出力されるエラー メッセージを減らすには、EMBER_AF_PLUGIN_GATEWAY_MAX_WAIT_FOR_EV を構成します。
ホスト アプリの ENT_TIMEOUT_MS を 100 に設定すると、コールバック キューがより早く解放されます。 |
| 1252460 | 起動時に実行される SimEEPROM リカバリ ルーチン (v1 と v2 の両方) は、em_msc 中にアサーションを引き起こす不整合なフラッシュ ページ消去呼び出しを実行する場合があります。 c の MSC_ErasePage ルーチン。 | 回避策: 次のコード行を em_msc.c の MSC_ErasePage() 関数の先頭に配置します。 start address = (uint32_t*)((uint32_t)startAddress &
~(FLASH_PAGE_SIZE-1)); |
非推奨のアイテム
リリースでは非推奨になりました
このパッチを含む GSDK 7.4.0.0 以降では、Linux ホスト アプリケーションがポート 3 または 4900 で Telnet インターフェイスを作成するための Z4901Gateway の「-v」オプションは非推奨になりました。 Telnet インターフェイスを作成する別の推奨方法は、「socat」などの Linux ユーティリティを使用することです。
リリースでは非推奨になりました
次の非推奨のセキュリティ API を削除しました。
- emberGetKey()
- emberGetKeyTableEntry()
- emberSetKeyTableEntry()
- emberHaveLinkKey()
- emberAddOrUpdateKeyTableEntry()
- emberAddTransientLinkKey()
- emberGetTransientKeyTableEntry()
- emberGetTransientLinkKey()
- emberHmacAesHash()
キー ストレージと HMAC ハッシュへのアクセスには、Zigbee Security Manager が提供する API を使用します。
削除されたアイテム
リリース時に削除されました
- パブリックヘッダー内の重複したパブリック API を削除しました file gp-types.h。
- zigbee_end_device_bind コンポーネントは削除されました。このコンポーネントは、コーディネーターがエンド デバイスのバインディング要求を仲介するために使用されました。このオプション機能は、Zigbee コア仕様の R22 から削除されました。
- af-host.c の setPacketBufferCount() と、command-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
新商品
リリースで追加されました
- 同時リスニング、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 コマンドが含まれます。
改善点
リリース時に変更されました
- Zigbee NCP/OpenThread RCP マルチプロトコルの組み合わせは、実稼働品質になりました。
修正された問題
リリースで修正されました
| ID＃ | 説明 |
|
1213701 |
zigbeed では、MAC 間接キューにその子に対してすでに保留中のデータがある場合、その子に対してソース マッチ テーブル エントリを作成することができませんでした。この動作により、APS Ack またはアプリ層の応答がないために、子と他のデバイスの間のアプリケーション層トランザクションが失敗する可能性があります。最も顕著なのは、子デバイスを対象とした ZCL OTA アップグレードの中断と予期せぬ終了です。 |
| 1244461 | メッセージが保留されているにもかかわらず、子のソース一致テーブル エントリが削除される可能性があります。 |
リリースで修正されました
| 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.si-labs.com/developers/gecko-software-development-kit.
| ID＃ | 説明 | 回避策 |
| 811732 | Zigbeed を使用する場合、カスタム トークンのサポートは利用できません。 | サポートは将来のリリースで予定されています。 |
| 937562 | Bluetoothctl 'advertise on' コマンドは、Raspberry Pi OS 802154 の rcp-uart-11-blehci アプリで失敗します。 | bluetoothctl の代わりに btmgmt アプリを使用します。 |
| 1022972 | ZB NCP + OT RCP では Coex が機能しません。 | 将来のリリースではサポートが予定されています。 |
| 1074205 | CMP RCP は、同じ PAN ID 上の XNUMX つのネットワークをサポートしません。 | ネットワークごとに異なる PAN ID を使用します。 サポートは将来のリリースで予定されています。 |
| 1122723 | 混雑した環境では、z3-light_ot-ftd_soc アプリで CLI が応答しなくなる場合があります。 | 既知の回避策はありません。 |
| 1124140 | z3-light_ot-ftd_socampOT ネットワークがすでに起動している場合、le アプリは Zigbee ネットワークを形成できません。 | 最初に Zigbee ネットワークを開始し、その後で OT ネットワークを開始します。 |
|
1170052 |
CMP Zigbee NCP + OT RCP および DMP Zigbee NCP + BLE NCP は、この現在のリリースの 64KB 以下の RAM パーツに適合しない可能性があります。 |
64KB パーツは現在、これらのアプリではサポートされていません。 |
|
1209958 |
Bobcat および Bobcat Lite 上の ZB/OT/BLE RCP は、3 つのプロトコルすべてを実行すると数分後に動作を停止する場合があります |
将来のリリースで対応される予定です |
| 1221299 | Mfglib RSSI 読み取り値は、RCP と NCP で異なります。 | 将来のリリースで対応される予定です。 |
| 1231021 | OTBR は、80 を超える zigbee デバイスが同時に参加しているときにアサートできます。 | 問題を回避する可能性のある修正を追加しました。将来のリリースで完全に対処される予定です。 |
非推奨のアイテム
- なし
削除されたアイテム
リリース時に削除されました
- 「NONCOMPLIANT_ACK_TIMING_WORKAROUND」マクロは削除されました。すべての RCP アプリは現在、デフォルトで非拡張 ACK のターンアラウンド タイム 192 μ秒をサポートしていますが、CSL で必要な拡張 ACK のターンアラウンド タイムは引き続き 256 μ秒です。
このリリースの使用
このリリースには次の内容が含まれています。
- ジグビースタック
- Zigbee アプリケーション フレームワーク
- ジグビーSampファイルアプリケーション
Zigbee と EmberZNet SDK の詳細については、「UG103.02: Zigbee Fundamentals」を参照してください。
初めてのユーザーの場合は、開発環境の構成、ビルドとフラッシュの手順については、「QSG180: Zigbee EmberZNet Quick-Start Guide for SDK 7.0 and Higher」を参照してください。ampファイル アプリケーション、および次のステップを示すドキュメント参照。
インストールと使用
Zigbee EmberZNet SDK は、Silicon Labs SDK スイートである Gecko SDK (GSDK) の一部として提供されます。 GSDK をすぐに使い始めるには、Simplicity Studio 5 をインストールします。これにより、開発環境がセットアップされ、GSDK のインストール手順が説明されます。 Simplicity Studio 5 には、リソースおよびプロジェクト ランチャー、ソフトウェア構成ツール、GNU ツールチェーンを備えた完全な IDE、分析ツールなど、Silicon Labs デバイスを使用した IoT 製品開発に必要なすべてが含まれています。インストール手順は、オンラインの Simplicity Studio 5 ユーザー ガイドに記載されています。
または、Gecko SDK は、GitHub から最新のものをダウンロードまたは複製して、手動でインストールすることもできます。 見る https://github.com/Sili-conLabs/gecko_sdk 詳細についてはこちらをご覧ください。
Simplicity Studio は、デフォルトで GSDK を次の場所にインストールします。
- (Windows): C:\Users\ \SimplicityStudio\SDKs\gecko_sdk
- (MacOS): /Users/ /SimplicityStudio/SDKs/gecko_sdk
SDK バージョンに固有のドキュメントは、SDK とともにインストールされます。 追加情報は、多くの場合、ナレッジ ベースの記事 (KBA) に記載されています。 このリリースと以前のリリースに関する API リファレンスとその他の情報は、次の Web サイトで入手できます。 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 Key Management 機能の詳細については、AN1271: Secure Key Storage を参照してください。
セキュリティ勧告
セキュリティ アドバイザリに登録するには、Silicon Labs カスタマー ポータルにログインし、[アカウント ホーム] を選択します。 [ホーム] をクリックしてポータルのホーム ページに移動し、[通知の管理] タイルをクリックします。 「Software/Security Advisory Notices & Product Change Notices (PCNs)」がチェックされていること、およびプラットフォームとプロトコルに対して少なくともサブスクライブされていることを確認してください。 [保存] をクリックして変更を保存します。
サポート
Development Kit の顧客はトレーニングとテクニカル サポートを受けることができます。シリコン ラボラトリーの Zigbee を使用する web このページでは、Silicon Labs Zigbee のすべての製品とサービスに関する情報を入手し、製品サポートにサインアップします。
Silicon Laboratories のサポートに連絡できます。 http://www.silabs.com/support.
Simplicity Studio
MCUおよびワイヤレスツール、ドキュメント、ソフトウェア、ソースコードライブラリなどへのワンクリックアクセス。 Windows、Mac、Linuxで利用可能です！
免責事項
Silicon Labs は、Silicon Labs 製品を使用している、または使用を予定しているシステムおよびソフトウェア実装者向けに、利用可能なすべての周辺機器およびモジュールに関する最新かつ正確で詳細なドキュメントをお客様に提供することを目指しています。特性データ、利用可能なモジュールおよび周辺機器、メモリ サイズ、メモリ アドレスは各デバイスに固有のものであり、提供される「標準」パラメータはアプリケーションによって異なる場合があります。アプリケーション例ampここに記載されているファイルは、説明のみを目的としています。 Silicon Labs は、ここに記載されている製品情報、仕様、および説明を予告なしに変更する権利を留保し、含まれる情報の正確性または完全性を保証しません。 Silicon Labs は、事前の通知なしに、セキュリティまたは信頼性の理由から、製造プロセス中に製品ファームウェアを更新する場合があります。 このような変更により、製品の仕様または性能が変更されることはありません。 Silicon Labs は、このドキュメントで提供される情報の使用の結果について責任を負わないものとします。 このドキュメントは、集積回路を設計または製造するためのライセンスを暗示または明示的に付与するものではありません。 これらの製品は、Silicon Labs の書面による特定の同意なしに、FDA クラス III デバイス、FDA の市販前承認が必要なアプリケーション、または生命維持システム内で使用するように設計または認可されていません。 「ライフサポートシステム」とは、生命および/または健康をサポートまたは維持することを目的とした製品またはシステムであり、故障した場合、重大な人身傷害または死亡に至ることが合理的に予想される可能性があります。 Silicon Labs の製品は、軍事用途向けに設計または認可されていません。 Silicon Labs の製品は、いかなる状況においても、核兵器、生物兵器、化学兵器、またはそのような兵器を運ぶことができるミサイルを含む (ただしこれらに限定されない) 大量破壊兵器で使用してはなりません。 Silicon Labs は、すべての明示的および黙示的な保証を否認し、そのような無許可のアプリケーションでの Silicon Labs 製品の使用に関連する怪我または損害について責任を負わないものとします。
注記： このコンテンツには、現在廃止されている不快な用語が含まれている可能性があります。 Silicon Labsは、可能な限りこれらの用語を包括的な言語に置き換えています。 詳細については、次のWebサイトをご覧ください。 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 ロゴ®、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 SDK 7.4.1.0 GA Zigbee プロトコル スタック ソフトウェア [pdf] ユーザーガイド SDK 7.4.1.0 GA Zigbee プロトコル スタック ソフトウェア、SDK 7.4.1.0 GA、Zigbee プロトコル スタック ソフトウェア、プロトコル スタック ソフトウェア、スタック ソフトウェア |