FreeRTOS ライブラリ
FreeRTOS ライブラリは、FreeRTOS カーネルとその内部ライブラリに機能を追加します。組み込みアプリケーションでのネットワーキングとセキュリティのために FreeRTOS ライブラリを使用できます。FreeRTOS ライブラリを使用すると、アプリケーションによる AWS IoT サービスの操作も可能になります。FreeRTOS には、以下のことが可能なライブラリが含まれています。
-
MQTT とデバイスシャドウを使用して、デバイスを AWS IoT クラウドに安全に接続します。
-
AWS IoT Greengrass コアを検出して接続します。
-
Wi-Fi 接続を管理します。
-
FreeRTOS 無線通信経由更新をリッスンして処理します。
libraries ディレクトリには、FreeRTOS ライブラリのソースコードがあります。ライブラリ機能の実装を支援するヘルパー関数があります。これらのヘルパー関数を変更することはお勧めしません。
FreeRTOS 移植ライブラリ
以下の移植ライブラリは、FreeRTOS コンソールでダウンロード可能な FreeRTOS の設定に含まれています。これらのライブラリはプラットフォームに依存します。それらの内容は、ハードウェアプラットフォームに応じて変わります。これらのライブラリをデバイスに移植する方法については、FreeRTOS 移植ガイドを参照してください。
| ライブラリ | API リファレンス | 説明 |
|---|---|---|
| Bluetooth Low Energy | Bluetooth Low Energy API リファレンス | FreeRTOS Bluetooth Low Energy ライブラリを使用して、マイクロコントローラーはゲートウェイデバイスを介して AWS IoT MQTT ブローカーと通信できます。詳細については、「Bluetooth Low Energy ライブラリ」を参照してください。 |
| 無線による更新 | AWS IoT 無線通信更新 API リファレンス |
FreeRTOS AWS IoT 無線通信経由 (OTA) 更新ライブラリを使用すると、FreeRTOS デバイスで更新通知の管理、更新プログラムのダウンロード、ファームウェア更新の暗号化検証の実行ができます。 詳細については、「AWS IoT 無線通信経由 (OTA) ライブラリ」を参照してください。 |
| FreeRTOS+POSIX | FreeRTOS+POSIX API リファレンス |
FreeRTOS+POSIX ライブラリを使用して、POSIX 準拠のアプリケーションを FreeRTOS エコシステムに移植できます。 詳細については、「FreeRTOS+POSIX |
| セキュアソケット | セキュアソケット API リファレンス | 詳細については、「セキュアソケットライブラリ」を参照してください。 |
| FreeRTOS+TCP | FreeRTOS+TCP API リファレンス |
FreeRTOS+TCP は、FreeRTOS のスケーラブルなオープンソースでスレッドセーフな TCP/IP スタックです。 詳細については、「FreeRTOS+TCP |
| Wi-Fi | Wi-Fi API リファレンス |
FreeRTOS Wi-Fi ライブラリを使用すると、マイクロコントローラーの低いレベルのワイヤレスのスタックとの連動が可能になります。 詳細については、「Wi-Fi ライブラリ」を参照してください。 |
| corePKCS11 |
corePKCS11 ライブラリは、プロビジョニングと TLS クライアント認証をサポートするための公開鍵暗号標準 #11 のリファレンス実装です。 詳細については、「corePKCS11 ライブラリ」を参照してください。 |
|
| TLS |
詳細については、「Transport Layer Security」を参照してください。 |
|
| 共通 I/O | 共通 I/O API リファレンス |
詳細については、「共通 I/O」を参照してください。 |
| セルラーインターフェイス | セルラーインターフェイス API リファレンス |
セルラーインターフェイスライブラリは、統一された API を使用して、いくつかの一般的なセルラーモデムの機能を公開します。詳細については、「セルラーインターフェイスライブラリ」を参照してください。 |
FreeRTOS アプリケーションライブラリ
クラウドで AWS IoT サービスを操作するために、以下のスタンドアロンアプリケーションライブラリを必要に応じて FreeRTOS 設定に追加できます。
注記
一部のアプリケーションライブラリには、AWS IoT Device SDK for Embedded C にあるライブラリと同じ API があります。これらのライブラリについては、AWS IoT Device SDK C API リファレンスを参照してください。AWS IoT Device SDK for Embedded C の詳細については、「AWS IoTEmbedded C用 Device SDK 」を参照してください。
| ライブラリ | API リファレンス | 説明 |
|---|---|---|
| AWS IoT Device Defender | Device Defender C SDK API リファレンス |
FreeRTOS AWS IoT Device Defender ライブラリは FreeRTOS デバイスを AWS IoT Device Defender に接続します。 詳細については、「AWS IoT Device Defender ライブラリ」を参照してください。 |
| AWS IoT Greengrass | Greengrass API リファレンス |
FreeRTOS AWS IoT Greengrass ライブラリは FreeRTOS デバイスを AWS IoT Greengrass に接続します。 詳細については、「AWS IoT Greengrass 検出ライブラリ」を参照してください。 |
| MQTT |
coreMQTT ライブラリは、FreeRTOS デバイスが MQTT トピックを公開し、サブスクライブするためのクライアントを提供します。MQTT は、デバイスが AWS IoT を操作するために使用するプロトコルです。 coreMQTT ライブラリバージョン 3.0.0 の詳細については、「coreMQTT ライブラリ」を参照してください。 |
|
| coreMQTT エージェント |
coreMQTT エージェントライブラリは、スレッドセーフを coreMQTT ライブラリに追加する高レベル API です。これにより、バックグラウンドで MQTT 接続を管理し、他のタスクからの介入を必要としない専用の MQTT エージェントタスクを作成できます。このライブラリでは coreMQTT の API と同等のスレッドセーフを提供するため、マルチスレッド環境で使用できます。 coreMQTT エージェントライブラリの詳細については、coreMQTT エージェントライブラリを参照してください。 |
|
| AWS IoT デバイスシャドウ | Device Shadow C SDK API リファレンス |
AWS IoT Device Shadow ライブラリは、FreeRTOS デバイスが AWS IoT デバイスシャドウを操作できるようにします。 詳細については、「AWS IoT Device Shadow ライブラリ」を参照してください。 |
FreeRTOS ライブラリの設定
FreeRTOS および AWS IoT Device SDK for Embedded C の構成設定は、C プリプロセッサ定数として定義されています。グローバル設定ファイルで、または-D の gcc などのコンパイラオプションを使用して、構成を設定することができます。構成設定はコンパイル時定数として定義されているため、構成設定が変更された場合はライブラリを再ビルドする必要があります。
グローバル設定ファイルを使用して、設定オプションを設定する場合は、iot_config.h という名前でファイルを作成して保存し、インクルードパスに配置します。ファイル内で、#define ディレクティブを使用して、FreeRTOS ライブラリ、デモ、テストを設定します。
サポートされているグローバル設定オプションの詳細については、「グローバル設定ファイルリファレンス」を参照してください。
