SILICON LABS Zigbee EmberZ Net SDK
仕様
- Zigbee EmberZNet SDK バージョン: 8.1 GA
- Simplicity SDK スイート バージョン: 2024.12.0
- 発売日: 16年2024月XNUMX日
- 互換性のあるコンパイラ: GCC バージョン 12.2.1
- EZSP プロトコル バージョン: 0x10
製品情報
Silicon Labs は、自社製品に Zigbee ネットワークを組み込む OEM にとって最適なベンダーです。Silicon Labs Zigbee プラットフォームは、最も統合され、完全で、機能が豊富な Zigbee ソリューションです。Silicon Labs EmberZNet SDK には、Silicon Labs による Zigbee スタック仕様の実装が含まれています。
主な特徴
ジグビー
- -APS リンク キー テーブルに 250 以上のエントリ
- Android 12 (v21.0.6113669) および Tizen (v0.1-13.1) での ZigbeeD サポート
- xG26 モジュールのサポート
マルチプロトコル
- OpenWRT での ZigbeeD および OTBR サポート – GA
- DMP BLE + CMP ZB & Matter/OT、MG26 向け SoC での同時リスニング機能搭載 – GA
- 802.15.4 統合無線スケジューラ優先度コンポーネント
- MP ホスト アプリケーション向けの Debian パッケージ サポート – Alpha
新商品
重要な変更点
APS リンク キー テーブル サイズ (SL_ZIGBEE_KEY_TABLE_SIZE を使用して構成) が 127 エントリから 254 エントリに拡張されます。
- R23 では、ZDD ネットワーク コミッショニング機能のサポートが追加されました。トンネリング機能は、レガシー ネットワークの使用例のサポートなしで利用できます。
- Network Steering および Network Creator コンポーネントが更新され、R23 参加のサポートが追加されました。これには、次の関連する変更が含まれます。
- デフォルトの Trust Center リンク キー (TCLK) 要求ポリシーが更新され、要求元デバイスごとに新しいキーが生成されます。要求元デバイスが Trust Center リンク キーの更新を試みるたびに、新しいキーが生成されます。
- 以前の TCLK ポリシーの変更により、Network Creator セキュリティ コンポーネントにはセキュリティ リンク キー コンポーネントが必要になりました。アプリケーションのアップグレードは、この新しい要件に準拠するように更新されます。
- 新しい構成、
SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY が追加され、コアのハッシュ キーを使用して参加できるようになりました。この設定は、Network Creator セキュリティ コンポーネントの下にあります。このポリシーを使用すると、参加する各デバイスは参加後に一意の TCLK を受信できますが、TCLK の更新を繰り返しても、要求元デバイスの新しいキーは生成されません。このハッシュ リンク キーの使用は、このリリースより前のデフォルト ポリシーでした。このポリシーを使用すると、トラスト センターは、フラッシュにキーを保存するセキュリティ リンク キー コンポーネントを導入する必要がなくなります。
注記: Silicon Labs では、このポリシーの使用は推奨していません。このポリシーにより、参加するデバイスが TCLK をロールまたは更新できなくなるためです。
- ホスト SPI デバイスとそのピン インターフェイスを構成できるように、コンポーネント zigbee_ezsp_spi に新しい構成セットが追加されました。
- 元ampプロジェクトを含む、 files (.slcps) およびプロジェクト フォルダーの名前は、Silicon Labs の命名ガイドラインに従って変更され、「projects」ディレクトリの下に移動されます。
新しいプラットフォームのサポート
- 新しいモジュール
- MG260PD32VNA2 型番
- MG260PD32VNN2 型番
- MG260PD22VNA2 型番
- MG260PB32VNA5 型番
- MG260PB32VNN5 型番
- MG260PB22VNA5 型番
- BGM260PB22VNA2
- BGM260PB32VNA2
- 新しいラジオボード
- MGM260P-RB4350A
- MGM260P-RB4351A
- 新しい部品
- efr32xg27
- エクスプローラーキット
- BRD2709A
- MGM260P-EK2713A
新しいドキュメント
リリース 600 以降用の新しい EZSP ユーザー ガイド UG8.1。
改善点
- SL_ZIGBEE_KEY_TABLE_SIZE の制限が最大 254 エントリまで拡張されました。
- Z3Light に zigbee_security_link_keys を追加しました。
- zigbee_security_link_keys を zigbee_mp_z3_tc_z3_tc に追加しました。キー テーブルのサイズも更新しました。
- Z3 ゲートウェイ キー テーブル サイズ (ncp に設定されます) を 20 に増加しました。
修正された問題
現在のリリースの既知の問題
太字の問題は、前のリリース以降に追加されたものです。リリースを見逃した場合は、最新のリリース ノートを次の場所から入手できます。 https://www.silabs.com/developers/zigbee-emberznet Tech Docs タブで。
非推奨のアイテム
- zigbee_watchdog_periodic_refreshコンポーネントはZigbeeアプリケーションフレームワークでは使用されなくなり、このリリースでは非推奨となりました。ウォッチドッグタイマーはすべてのsに対してデフォルトで無効になっています。ample アプリケーション。将来的には、改良されたウォッチドッグ コンポーネントが SDK に追加される予定です。
- 注記: アプリケーションで構成項目 SL_LEGACY_HAL_DISABLE_WATCHDOG を 0 に設定してウォッチドッグ タイマーを有効にします。
ネットワークの制限と考慮事項
この EmberZNet リリースに同梱されているデフォルトの Trust Center アプリケーションは、ネットワーク上の複数のデバイスをサポートできます。この数は、構成されたテーブル サイズ、NVM の使用状況、その他の生成時間や実行時間の値など、いくつかの要因に基づいて決定されます。大規模なネットワークを作成しようとしているユーザーは、アプリケーションがサポートできる範囲を超えてネットワークを拡大すると、リソースの問題に直面する可能性があります。たとえば、ampたとえば、トラスト センターからトラスト センター リンク キーを要求するデバイスは、トラスト センターで sl_zigbee_af_zigbee_key_establishment_cb コールバックをトリガーし、h ステータスを SL_ZIGBEE_KEY_TABLE_FULL に設定することがあります。これは、キー テーブルに要求元デバイスの新しいキーを追加する余地がないか、NVM3 に使用可能なスペースがないことを示します。Silicon Labs は、大規模なネットワークを作成しようとしているユーザーに対して、次の推奨事項を提供します。トラスト センター アプリケーションの場合、次の構成が推奨されます。これらの推奨事項は網羅的ではなく、大規模なネットワークを拡張することを意図しているアプリケーションのベースラインとして役立ちます。
- アドレステーブルコンポーネント（zigbee_address_table）の追加。
- SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE 構成項目を目的のネットワークのサイズに設定する
- SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE の値が最大値 (4) に設定されている
- セキュリティリンクキーコンポーネント（zigbee_security_link_keys）の追加
- SL_ZIGBEE_KEY_TABLE_SIZE値はネットワークのサイズに設定されます
- 以下の設定項目は、希望するネットワークのサイズに合わせて設定されます。
- Zigbee Pro Stack コンポーネントにある SL_ZIGBEE_BROADCAST_TABLE_SIZE
- ソースルーティングが使用されている場合、ソースルーティングコンポーネントにある SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE
- NVM3 の使用状況に応じて NVM3_DEFAULT_NVM_SIZE と NVM3_DEFAULT_CACHE_SIZE を調整する
- 例えば、65ノードを超えるネットワークサイズでは、3KのNVM64サイズが必要になる可能性があります。Silicon Labs ZigbeeのデフォルトのNVM3サイズは、ample アプリケーションの最大メモリは 32K です。NVM をより頻繁に使用するアプリケーションでは、この値をさらに高く調整する必要がある場合があります。
- 最大 65 ノードの大規模ネットワークでは、3 バイトの NVM1200 キャッシュ サイズが必要になる場合があります。それよりも大きなネットワークでは、この値を 2400 倍の XNUMX バイトに増やす必要がある場合があります。
これらの調整はセキュリティセンターにのみ適用されます
マルチプロトコル ゲートウェイと RCP
新商品
xG26 パーツで同時リスニングを行う Zigbee + Openthread CMP を使用した BLE DMP の GA SoC サポートを有効にしました。Zigbeed、OTBR、Z3Gateway アプリケーションに Debian アルファ サポートが追加されました。Zigbeed と OTBR は、選択したリファレンス プラットフォーム (Raspberry PI 4) 用の DEB パッケージ形式でも提供されています。マルチプロトコル コプロセッサを搭載した Linux ホストで Zigbee、OpenThread、Bluetooth を同時に実行する方法については、次の URL を参照してください。 docs.silabs.com詳細については、こちらをご覧ください。arm0.1およびaarch13.1用のTizen-32-64とaarch12用のAndroid 64にZigbeedのサポートを追加しました。Zigbeedの詳細については、こちらをご覧ください。 docs.silabs.com新しい「802.15.4 統合無線スケジューラ優先度」コンポーネントを追加しました。このコンポーネントは、15.4 スタックの無線優先度を設定するために使用されます。このコンポーネントには、新しい「radio_priority_configurator」コンポーネントも必要です。このコンポーネントにより、プロジェクトは Simplicity Studio の Radio Priority Configurator ツールを使用して、必要なスタックの無線優先度レベルを設定できます。
改善点
アプリケーションノート「マルチプロトコルコプロセッサを搭載したLinuxホストでZigbee、OpenThread、Bluetoothを同時に実行する」(AN1333)は、 docs.silabs.comOpenWRT サポートが GA 品質になりました。Zigbee、OTBR、Z3Gateway アプリケーションに OpenWRT サポートが追加されました。Zigbeed と OTBR は、リファレンス プラットフォーム (Raspberry PI 4) 用の IPK パッケージ形式でも提供されています。マルチプロトコル コプロセッサを搭載した Linux ホストで Zigbee、OpenThread、Bluetooth を同時に実行する方法については、次の Web サイトを参照してください。 docs.silabs.com、 詳細については。
修正された問題
現在のリリースの既知の問題
太字で表示されている問題は、前回のリリース以降に追加されたものです。リリースを見逃した場合は、最新のリリースノートをこちらから入手できます。https://www.silabs.com/developers/simplicity-software-development-kit.
非推奨のアイテム
現在 DockerHub (siliconlabsinc/multiprotocol) で利用可能な「マルチプロトコル コンテナ」は、今後のリリースで廃止される予定です。コンテナは更新されなくなり、DockerHub から取得することもできなくなります。コンテナの削除によって失われた機能は、cpcd、ZigBee、ot-br-posix の Debian ベースのパッケージと、ネイティブに生成およびコンパイルされたプロジェクトによって置き換えられます。
このリリースの使用
このリリースには次の内容が含まれています。
- ジグビースタック
- Zigbee アプリケーション フレームワーク
- ジグビーSampファイルアプリケーション
Zigbee と EmberZNet SDK の詳細については、「UG103.02: Zigbee Fundamentals」を参照してください。初めてのユーザーの場合は、開発環境の構成、ビルドとフラッシュの手順については、「QSG180: Zigbee EmberZNet Quick-Start Guide for SDK 7.0 and Higher」を参照してください。ample アプリケーション、および ext 手順を指すドキュメント参照。
インストールと使用
Zigbee EmberZNet SDK は、Silicon Labs SDK スイートである Simplicity SDK の一部として提供されています。Simplicity SDK をすぐに使い始めるには、Simplicity Studio 5 をインストールしてください。これにより、開発環境がセットアップされ、Simplicity SDK のインストール手順が案内されます。Simplicity Studio 5 には、リソースおよびプロジェクト ランチャー、ソフトウェア構成ツール、GNU ツールチェーンを備えた完全な IDE、分析ツールなど、Silicon Labs デバイスを使用した IoT 製品開発に必要なすべてのものが含まれています。インストール手順は、オンラインの Simplicity Studio 5 ユーザー ガイドに記載されています。または、GitHub から最新のものをダウンロードまたはクローンして、Simplicity SDK を手動でインストールすることもできます。 https://github.com/SiliconLabs/simplicity_sdk 詳細については、Simplicity Studio を参照してください。Simplicity SDK は、デフォルトで次の場所にインストールされます。
- (Windows): C:\Users\\SimplicityStudio\SDKs\simplicity_sdk
- (MacOS): /Users//SimplicityStudio/SDKs/simplicity_sdk
SDKバージョン固有のドキュメントはSDKとともにインストールされます。追加情報は多くの場合、ナレッジベースの記事（KBA）に記載されています。このリリースおよび以前のリリースに関するAPIリファレンスおよびその他の情報は、以下から入手できます。 https://docs.silabs.com/.
セキュリティ情報
安全なボールト統合
Secure Vault-High パーツ上の Secure Key Storage コンポーネントを使用してキーを安全に保存することを選択したアプリケーションの場合、次の表に、Zigbee Security Manager コンポーネントが管理する保護されたキーとそのストレージ保護特性を示します。
「Non-Exportable」とマークされたラップされた鍵は使用できますが、 view実行時にエクスポートまたは共有することはできません。「エクスポート可能」とマークされたラップされたキーは、実行時に使用または共有できますが、フラッシュに保存されている間は暗号化されたままです。ユーザー アプリケーションは、これらのキーの大部分を操作する必要はありません。リンク キー テーブル キーまたは一時キーを管理するための既存の API は、ユーザー アプリケーションで引き続き使用でき、Zigbee セキュリティ マネージャー コンポーネントを介してルーティングされます。
セキュリティ勧告
セキュリティ アドバイザリに登録するには、Silicon Labs カスタマー ポータルにログインし、[アカウント ホーム] を選択します。 [ホーム] をクリックしてポータルのホーム ページに移動し、[通知の管理] タイルをクリックします。 「Software/Security Advisory Notices & Product Change Notices (PCNs)」がチェックされていること、およびプラットフォームとプロトコルに対して少なくともサブスクライブされていることを確認してください。 [保存] をクリックして変更を保存します。
サポート
Development Kit の顧客はトレーニングとテクニカル サポートを受けることができます。シリコン ラボラトリーの Zigbee を使用する web Silicon Labs Zigbee製品とサービスに関する情報を入手し、製品サポートにサインアップするには、このページをご覧ください。Silicon Laboratoriesのサポートに問い合わせるには、 http://www.silabs.com/support.
Zigbee 認証
Ember ZNet 8.1リリースは、SoC、NC、P、およびRCPアーキテクチャのZigbee準拠プラットフォームとして認定されています。このリリースにはZCP認定IDが関連付けられていますので、CSAを確認してください。 webサイトはこちら:
https://csa-iot.org/csa-iot_products/.
ZCP認証は fileリリースを投稿してからCSAに反映されるまでに数週間かかります webさらなる質問については、Silicon Laboratoriesのサポートまでお問い合わせください。 http://www.silabs.com/support.
よくある質問
A: APS リンク キー テーブルのサイズは、SL_ZIGBEE_KEY_TABLE_SIZE パラメータを使用して設定できます。バージョン 8.1 では、127 エントリから 254 エントリに拡張されました。
Q: バージョン 8.1 の改善点は何ですか?
A: バージョン 8.1 では、APS リンク キー テーブル サイズの拡張、コンポーネントの名前変更、Athe pp Framework イベント キューのミューテックス保護の追加などの機能強化が行われています。改善点の詳細なリストについては、リリース ノートを参照してください。
Q: SDK で修正された問題をどのように処理すればよいですか?
A: ネイバー テーブル サイズ構成に関する潜在的な問題の解決、コンポーネントの名前変更、ソース ルートのオーバーヘッドの修正、ZCL コマンドの処理など、SDK の問題を修正しました。これらの修正のメリットを享受するには、最新バージョンに更新してください。
ドキュメント / リソース
 |
SILICON LABS Zigbee EmberZ Net SDK [pdf] 説明書 Zigbee EmberZ ネット SDK、EmberZ ネット SDK、ネット SDK、SDK |
