Amazon-FreeRTOS Github リポジトリ移行ガイド - 無料RTOS

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon-FreeRTOS Github リポジトリ移行ガイド

廃止された Amazon-Freertos リポジトリに基づいて既存の FreeRTOS プロジェクトがある場合は、次の手順に従います。

  1. 公開されている最新のセキュリティ修正を使用して最新の状態に保ちます。無料RTOSLTSライブラリページで更新を確認するか、無料 RTOS-LTS GitHub リポジトリにサブスクライブして、重要なバグ修正とセキュリティバグ修正を含む最新のLTSパッチを受け取ります。個々の GitHub リポジトリから直接、必要な最新の無料RTOSLTSパッチをダウンロードまたはクローンできます。

  2. ネットワークトランスポートインターフェイスの実装をリファクタリングして、ハードウェアプラットフォームを最適化することを検討してください。最新のコアMQTTライブラリでは、セキュアソケットWifi APIs APIsなどの抽象は必要ありません。詳細については、「Transport Interface」を参照してください。

付録

次の表は、Amazon-FreeRTOS リポジトリAPIs内のすべてのデモプロジェクト、レガシーライブラリ、および抽象化に関する推奨事項を示しています。

移行されたライブラリとデモ
名前 レコメンデーション

コアHTTP

デモとライブラリ

FreeRTOS Github 組織 のコアHTTPリポジトリ (git を使用している場合はサブモジュール) から直接コアHTTPライブラリをクローンまたはダウンロードします。コアHTTPデモはプライマリ無料RTOSディストリビューション にあります。詳細については、コアHTTPページ を参照してください。

コアMQTT

デモとライブラリ

FreeRTOS Github 組織 のコアMQTTリポジトリ (git を使用している場合はサブモジュール) から直接、コアMQTTライブラリをクローンまたはダウンロードします。コアMQTTデモはプライマリ無料RTOSディストリビューション にあります。詳細については、コアMQTTページ を参照してください。

コア MQTT- エージェント

デモとライブラリ

FreeRTOS Github 組織のコア MQTT-Agent リポジトリ (git を使用している場合はサブモジュール) から直接、コア MQTT-Agent ライブラリをクローンまたはダウンロードします。コア MQTT-Agent デモは、コア MQTT-Agent-Demos リポジトリにあります。詳細については、 コアの MQTT-Agent ページを参照してください。

device_defender_for_aws

デモとライブラリ

AWS IoT Device Defender ライブラリは、AWS GitHub 組織のリポジトリにあります。AWS IoT Device Defender リポジトリから直接 (git を使用している場合はサブモジュールを) 複製またはダウンロードします。 AWS IoT Device Defender のデモは、プライマリ無料RTOSディストリビューション にあります。詳細については、AWS IoT Device Defender のページを参照してください。

device_shadow_for_aws

デモとライブラリ

AWS IoT Device Shadow ライブラリは、AWS GitHub 組織のリポジトリにあります。AWS IoT Device Shadow リポジトリから直接 (git を使用している場合はサブモジュールを) 複製またはダウンロードします。 AWS IoT Device Shadow のデモは、プライマリ無料RTOSディストリビューション にあります。詳細については、AWS IoT Device Shadow のページを参照してください。

jobs_for_aws

デモとライブラリ

AWS IoT Jobs ライブラリは、AWS GitHub 組織 のリポジトリにあります。AWS IoT Jobs リポジトリから直接 (git を使用している場合はサブモジュールを) 複製またはダウンロードします。 AWS IoT Jobs デモはプライマリ無料RTOSディストリビューション にあります。詳細については、AWS IoT Jobs のページを参照してください。

OTA

デモとライブラリ

AWS IoT Over-The-Air (OTA) 更新ライブラリは、AWS GitHub 組織 のリポジトリにあります。AWS IoT OTA リポジトリから直接コピーまたはダウンロードします (git を使用する場合はサブモジュール)。 AWS IoT OTA デモはプライマリ無料RTOSディストリビューション にあります。詳細については、AWS IoT OTA「」ページを参照してください。

CLI および無料 RTOS_Plus_CLI

デモとライブラリ

で実行されているCLI例があります WinSim。詳細については、FreeRTOS Plus コマンドラインインターフェイスページを参照してください。 NXP i.MX RT1060 および STM32U5プラットフォームでの注目の無料RTOS IoT リファレンス統合では、実際のハードウェアCLIの例も示しています。

ログ記録

マクロ

一部の無料RTOSライブラリで使用される特定のハードウェアプラットフォームのロギングマクロの実装があります。ロギングマクロの実装方法については、ロギングのページを参照してください。実際のハードウェアで実行されている例については、無料のRTOS IoT リファレンスを参照してください

greengrass_connectivity

デモ

〔移行中] このデモプロジェクトでは、 AWS IoT Greengrass デバイスに接続する前にクラウド接続が利用可能であると仮定しました。ローカル認証と検出機能を実証する新しいプロジェクトが開発中です。新しいデモプロジェクトは、まもなく FreeRTOS Github 組織 で公開される予定です。

非推奨ライブラリとデモ
名前 レコメンデーション

BLE

デモとライブラリ

FreeRTOS BLEライブラリは、独自のMQTTプロトコルを実装し、携帯電話などのプロキシデバイスを介した Bluetooth Low Energy (BLE) を介したMQTTトピックの発行とサブスクライブをサポートします。これはもはや義務付けられているものではありません。独自のBLEスタックまたは NimBLE などのサードパーティーオプションを使用して、プロジェクトを最適化します。

dev_mode_key_provisioning

デモ

NXP i.MX RT1060、、または ESP32-C3 STM32U5プラットフォームの Featured FreeRTOS IoT リファレンス統合は、 を使用した重要なプロビジョニングの例を提供しますCLI。

posix

抽象化とデモ

使用はお勧めしません。

wifi_provisioning

この例では、Amazon-FreeRTOS BLEライブラリを使用してデバイスで WiFi 認証情報をプロビジョニングする方法を示しました。を介した WiFi プロビジョニングの例については、 ESP32C3プラットフォームの無料RTOS IoT IoT リファレンスを参照してくださいBLE。

レガシー抽象 APIs

コード

これらは、さまざまなベンダーのさまざまなサードパーティーのソフトウェアスタック、接続モジュール、MCUプラットフォームに抽象インターフェイスを提供するために作成されたAPIsものです。例えば、抽 WiFi 象化、セキュアソケットなどのインターフェイスがあります。これらは Amazon-FreeRTOS リポジトリでサポートされており、 フォルダにあります/libraries/abstractions/ 無料RTOSLTSライブラリ を使用する場合、これらは必須APIsではありません。

上の表のライブラリとデモには、セキュリティパッチやバグ修正は適用されません。

サードパーティライブラリ

Amazon-FreeRTOS のデモでサードパーティーライブラリを使用する場合は、サードパーティーリポジトリから直接サブモジュール化することをお勧めします。

  • CMock: Cmock リポジトリから直接クローンを作成します (git を使用する場合はサブモジュール)。

  • jsmn: 推奨されておらず、サポートも終了しています。

  • lwip: lwip-tcpip リポジトリから直接 (git を使っている場合はサブモジュールを) 複製します。

  • lwip_osal : ハードウェアプラットフォーム/ボードに lwip_osal を実装STM32U5する方法については、i.MX RT1060 の無料RTOS機能リファレンス統合を参照してください。

  • mbedtls : Mbed-TLS リポジトリから直接クローンを作成します (git を使用する場合はサブモジュール)。mbedtls の設定とユーティリティは再利用できます。この場合はローカルコピーを作成してください。

  • pkcs11: コアPKCS11ライブラリまたは OASIS11 PKCS リポジトリから直接クローンを作成します (git を使用する場合はサブモジュール)。

  • tinycbor: tinycbor リポジトリから直接 (git を使っている場合はサブモジュールを) 複製します。

  • tinycrypt : 利用可能な場合は、MCUプラットフォームの暗号化アクセラレータを使用することをお勧めします。tinycrypt を引き続き使用したい場合は、tinycrypt リポジトリから直接 (git を使っている場合はサブモジュールを) 複製してください。

  • tracealyzer_recorder: Percepio の trace recorder リポジトリから直接 (git を使っている場合はサブモジュールを) 複製します。

  • unity : ThrowTheSwitch/Unity リポジトリから直接クローンを作成します (git を使用する場合はサブモジュール)。

  • win_pcap: win_pcap のメンテナンスは行われなくなりました。代わりに libslirp、libpcap (posix)、または npcap を使用することをお勧めします。

移植テストと統合テスト

無料RTOSライブラリの統合を検証するために必要な/testsフォルダ内のすべてのテストが FreeRTOS-Libraries-Integration-Testsリポジトリに移行されました。これらは、PAL実装とライブラリ統合をテストするために使用できます。Device Tester (IDT) では、同じテストが AWS IoT AWS Device Qualification Program for Free RTOSで使用されます。