SILICON LABS Bluetooth Mesh SDK 組み込みソフトウェアユーザーガイド

コンテンツ 隠れる

1 SILICON LABS Bluetooth メッシュ SDK 組み込みソフトウェア

2 製品仕様

SILICON LABS Bluetooth メッシュ SDK 組み込みソフトウェア

製品仕様

製品名: シンプルSDKスイート

バージョン: 2024.6.0
発売日： 5年2024月XNUMX日

Bluetooth メッシュ仕様バージョン: 1.1

製品使用説明書

Bluetooth メッシュは、Bluetooth Low Energy (LE) デバイスで利用できる新しいトポロジで、多対多 (m:m) 通信を可能にします。大規模なデバイスネットワークの作成に最適化されており、ビルディングオートメーション、センサーネットワーク、資産追跡に最適です。Bluetooth 開発用のソフトウェアと SDK は、Bluetooth メッシュと Bluetooth 機能をサポートしています。開発者は、コネクテッドライト、ホームオートメーション、資産追跡システムなどの LE デバイスにメッシュネットワーク通信を追加できます。このソフトウェアは Bluetooth ビーコン、ビーコンスキャン、GATT 接続もサポートしているため、Bluetooth メッシュはスマートフォン、タブレット、その他の Bluetooth LE デバイスに接続できます。このリリースには、Bluetooth メッシュ仕様バージョン 1.1 でサポートされている機能が含まれています。

これらのリリースノートには、次の SDK バージョンが含まれます。
7.0.0.0 5 年 2024 月 XNUMX 日にリリース

互換性と使用上の注意
セキュリティ更新と通知の詳細については、この SDK とともにインストールされるプラットフォームリリースノートのセキュリティの章、または Silicon Labs リリースノートページを参照してください。また、Silicon Labs では、最新情報を得るためにセキュリティアドバイザリを購読することを強くお勧めします。手順について、または Silicon Labs Bluetooth mesh SDK を初めて使用する場合は、「このリリースの使用」を参照してください。

互換性のあるコンパイラ
IAR Embedded Workbench for ARM (IAR-EWARM) バージョン 9.40.1

macOS または Linux で IarBuild.exe コマンドラインユーティリティまたは IAR Embedded Workbench GUI を使用して wine を使用してビルドすると、正しくないエラーが発生する可能性があります。 fileショートを生成するためのワインのハッシュアルゴリズムでの衝突のために使用されています file 名前。

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

GCC (GNU Compiler Collection) バージョン 12.2.1、Simplicity Studio に付属。

GCC のリンク時最適化機能が無効になっているため、画像サイズがわずかに増加します。

新商品
Simplicity SDKは、シリーズ2およびシリーズ3のワイヤレスおよびMCUデバイスをベースにしたIoT製品を構築するための組み込みソフトウェア開発プラットフォームです。ワイヤレスプロトコルスタック、ミドルウェア、周辺機器ドライバー、ブートローダー、アプリケーションエクステンションを統合しています。ampSimplicity SDK は、電力が最適化され、安全な IoT デバイスを構築するための堅牢なフレームワークです。Simplicity SDK は、超低消費電力、強力なネットワーク信頼性、多数のノードのサポート、マルチプロトコルや事前認証などの複雑な要件の抽象化などの強力な機能を提供します。さらに、Silicon Labs は、リモートでデバイスを更新し、メンテナンスコストを最小限に抑え、エンドユーザーの製品エクスペリエンスを向上させるために、無線 (OTA) ソフトウェアおよびセキュリティアップデートを提供します。Simplicity SDK は、人気の高い Gecko SDK の後継であり、シリーズ 0 およびシリーズ 1 のデバイスに長期サポートを提供し続けます。

シリーズ 0 およびシリーズ 1 デバイスの詳細については、以下を参照してください。 シリーズ0およびシリーズ1 EFM32/EZR32/EFR32デバイス（シラブス.com).

新機能

リリース 7.0.0.0 で追加
クロックマネージャーのサポートが追加されました。スタックコンポーネントは、クロックの初期化に device_init() を使用しなくなりました。代わりに、アプリケーションプロジェクトには、クロックの初期化を行う clock_manager コンポーネントを含める必要があります。共通メモリマネージャーのサポートが追加されました。

新しいAPI
リリース 7.0.0.0 で追加されました。なし。

改善点

ノード ID アドバタイズメントソースをチェックするためのノード BGAPI クラスコマンド sl_btmesh_node_test_identity が追加されました。
センサーサーバーexに低電力ノード機能を追加ampレ。

センサーサーバークライアントexにフレンド機能を追加ampル。

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

BGAPI の変更:
受信したノード ID アドバタイズメントが特定のノードから発信されたものかどうかを確認するためのノード BGAPI クラスコマンド sl_btmesh_node_test_identity が追加されました。
Exampアプリケーションの変更:
低電力ノード機能がセンサーサーバーexに追加されましたamples (btmesh_soc_sensor_thermometer、btmesh_soc_nlc_sensor_oc-cupancy btmesh_soc_nlc_sensor_ambient_light)、およびフレンド機能がセンサーサーバークライアントexに追加されました。ample (btmesh_soc_sen-sor_client)。

修正された問題
リリース 7.0.0.0 で修正済み

PB-GATT のみを使用してノードがプロビジョニングされている場合は、アドバタイズメントベアラーを開始しないでください。

過負荷のデバイスでのプロビジョニングイベントレポートが改善されました。
過負荷のデバイスでの DFU イベントレポートが改善されました。

DFU ディストリビューターおよびスタンドアロンアップデータモデルの場合、ノード上の Blob 転送構成が不十分な場合にエラーレポートが追加されました。
sl_btmesh_node_power_off() API を使用するときに、リプレイ保護を NVM3 に保存する問題を修正しました。

ID＃	説明
356148	PB-GATT のみを使用してノードがプロビジョニングされている場合は、アドバタイズメントベアラーの開始を回避します。
1250461	過負荷のデバイスでのプロビジョニングイベントレポートをより堅牢にしました。
1258654	過負荷のデバイスでの DFU イベントレポートをより堅牢にしました。
1274632	DFU ディストリビューターおよびスタンドアロンアップデータモデルでは、ノード上の Blob 転送構成が不十分な場合にエラーが報告されるようになりました。
1284204	アプリケーションが sl_btmesh_node_power_off() API を使用するときに、リプレイ保護を NVM3 に保存する問題を修正しました。

現在のリリースの既知の問題
太字の問題は、以前のリリース以降に追加されたものです。

セグメント化されたメッセージ処理の失敗に対する BGAPI イベントはありません。

キー更新状態変更イベントにより NCP キューがフラッディングされる可能性があります。
バージョン 1.5 と比較すると、ラウンドトリップ遅延テストでパフォーマンスがわずかに低下します。
すべての接続がアクティブで、GATT プロキシが使用されている場合、接続可能な広告を再確立する際に問題が発生します。
GATT ベアラーを介したセグメント化されたメッセージ送信のパフォーマンスが低下します。

ID＃	説明	回避策
401550	セグメント化されたメッセージ処理の失敗に対する BGAPI イベントはありません。	アプリケーションは、タイムアウト/アプリケーション層の応答の欠如から障害を推定する必要があります。ベンダーモデルには API が提供されています。
454059	KR プロセスの終了時に多数のキー更新状態変更イベントが生成され、NCP キューがフラッドする可能性があります。	プロジェクト内の NCP キューの長さを増やします。
454061	往復遅延テストでは 1.5 と比較してわずかなパフォーマンスの低下が観察されました。
624514	すべての接続がアクティブで、GATT プロキシが使用されている場合、接続可能なアドバタイズメントを再確立するときに問題が発生します。	必要な接続よりも 1 つ多くの接続を割り当てます。
841360	GATT ベアラーを介したセグメント化されたメッセージ送信のパフォーマンスが低下します。	基礎となる BLE 接続の接続間隔が短いことを確認してください。 ATT MTU がフルメッシュ PDU に適合するのに十分な大きさであることを確認します。接続イベントごとに複数の LL パケットを送信できるように、接続イベントの最小長を調整します。
1121605	丸め誤差により、スケジュールされたイベントが予想よりわずかに異なる時間にトリガーされる可能性があります。
1226127	ホストプロビジョナーexamp2 番目のノードのプロビジョニングを開始すると、ファイルが停止する可能性があります。	2 番目のノードをプロビジョニングする前に、ホストプロビジョナーアプリを再起動します。
1204017	ディストリビューターは、自己 FW アップデートと FW アップロードを並行して処理することはできません。	自己 FW アップデートと FW アップロードを並行して実行しないでください。
1301325	スケジューラアクションが永続ストレージに正しく保存されません。
1305041	ホストから EFR32 への NCP 通信がタイムアウトする可能性があります。	sl_simple_com_usart.c を編集してタイムアウト値を修正することができます。
1305928	10 個以上の更新ノードを DFU レシーバーとして設定すると、SoC ディストリビューターアプリで失敗する可能性があります。

非推奨のアイテム
リリース 7.0.0.0 で非推奨
BGAPI コマンド sl_btmesh_prov_test_identity は非推奨になりました。代わりに sl_btmesh_node_test_identity を使用してください。

削除されたアイテム
リリース 7.0.0.0 で削除されました
このリリースでは、シリーズ 1 ハードウェア (xG12 および xG13) のサポートが削除されました。

このリリースの使用
このリリースには、次のものが含まれています

Silicon Labs Bluetooth メッシュスタックライブラリ
Bluetooth メッシュampファイルアプリケーション

初めて使用する場合は、「QSG176: Silicon Labs Bluetooth Mesh SDK v2.x クイックスタートガイド」を参照してください。

インストールと使用
Bluetooth メッシュ SDK は、Silicon Labs SDK スイートである Simplicity SDK (GSDK) の一部として提供されます。Simplicity SDK をすぐに使い始めるには、Simplicity Studio 5 をインストールしてください。これにより、開発環境が設定され、Simplicity SDK のインストール手順が案内されます。Simplicity Studio 5 には、リソースおよびプロジェクトランチャー、ソフトウェア構成ツール、GNU ツールチェーンを備えた完全な IDE、分析ツールなど、Silicon Labs デバイスを使用した IoT 製品開発に必要なものがすべて含まれています。インストール手順は、オンラインの Simplicity Studio 5 ユーザーガイドに記載されています。または、GitHub から最新のものをダウンロードまたはクローンして、Simplicity SDK を手動でインストールすることもできます。 https://github.com/Sili-conLabs/simplicity_sdk 詳細についてはこちらをご覧ください。

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

ウィンドウズ:
- C:\ユーザー\ \SimplicityStudio\SDKs\simplicity_sdk
MacOSの場合: /ユーザー/ /SimplicityStudio/SDKs/simplicity_sdk
SDK バージョンに固有のドキュメントは、SDK とともにインストールされます。追加情報は、多くの場合、ナレッジベースの記事 (KBA) に記載されています。このリリースと以前のリリースに関する API リファレンスとその他の情報は、次の Web サイトで入手できます。 https://docs.silabs.com/.

セキュリティ情報

鍵	ノード上のエクスポート可能性	プロビジョナーでのエクスポート可能性	注記
ネットワークキー	エクスポート可能	エクスポート可能	ネットワークキーの導出は RAM にのみ存在しますが、ネットワークキーはフラッシュに保存されます
アプリケーションキー	輸出不可	エクスポート可能
デバイスキー	輸出不可	エクスポート可能	Provisioner の場合、Provisionerr 自身のデバイスキーと他のデバイスのキーに適用されます。

安全なボールト統合
このバージョンのスタックは、Secure Vault Key Management と統合されています。 Secure Vault High デバイスに展開すると、メッシュ暗号化キーは Secure Vault キー管理機能を使用して保護されます。次の表は、保護されたキーとそのストレージ保護特性を示しています。

「エクスポート不可」とマークされているキーは使用できますが、使用できません。 view実行時に編集または共有されます。

「エクスポート可能」とマークされたキーは実行時に使用または共有できますが、フラッシュに保存されている間は暗号化されたままになります。
Secure Vault Key Management機能の詳細については、 AN1271を参照: 安全なキーストレージ。

セキュリティ勧告
セキュリティアドバイザリに登録するには、Silicon Labs カスタマーポータルにログインし、[アカウントホーム] を選択します。 [ホーム] をクリックしてポータルのホームページに移動し、[通知の管理] タイルをクリックします。「Software/Security Advisory Notices & Product Change Notices (PCNs)」がチェックされていること、およびプラットフォームとプロトコルに対して少なくともサブスクライブされていることを確認してください。 [保存] をクリックして変更を保存します。

サポート
Development Kit の顧客はトレーニングとテクニカルサポートを受けることができます。 Silicon Labs Bluetooth メッシュを使用する web すべての Silicon Labs Bluetooth 製品およびサービスに関する情報を取得し、製品サポートにサインアップするには、ページをご覧ください。
Silicon Laboratories のサポートにお問い合わせください。 http://www.silabs.com/support.

Simplicity Studio
MCUおよびワイヤレスツール、ドキュメント、ソフトウェア、ソースコードライブラリなどへのワンクリックアクセス。 Windows、Mac、Linuxで利用可能です！

免責事項
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は、可能な限りこれらの用語を包括的な言語に置き換えています。詳細については、次の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、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 の登録商標です。ここに記載されているその他の製品名またはブランド名は、それぞれの所有者の商標です。

よくある質問（FAQ）

Q: セキュリティ更新に関する詳細情報はどこで入手できますか?
A: 詳細なセキュリティ更新については、プラットフォームリリースノートのセキュリティの章を参照するか、Silicon Labs リリースノートページにアクセスしてください。

Q: クロックの初期化に clock_manager コンポーネントを組み込むにはどうすればよいですか?
A: クロックの初期化に clock_manager コンポーネントを含めるには、ユーザーマニュアルに記載されている手順に従って、アプリケーションプロジェクトを適宜更新してください。

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

IoTポートフォリオ
www.silabs.com/IoT

SW / HW
www.silabs.com/simplicity

品質
www.silabs.com/quality

サポートとコミュニティ
www.silabs.com/community

ドキュメント / リソース

SILICON LABS Bluetooth メッシュ SDK 組み込みソフトウェア [pdf] ユーザーガイド
Bluetooth Mesh SDK 組み込みソフトウェア、Mesh SDK 組み込みソフトウェア、SDK 組み込みソフトウェア、組み込みソフトウェア、ソフトウェア

参考文献

ユーザーマニュアル