Ubuntu Linux v18.0+ のセットアップ

以下に、Linux環境に必要なを設定して、GitHub リポジトリからコードをダウンロードし、コードを表示および編集し、ハードウェアで使用できるようにコードをコンパイルし、ハードウェアのフラッシュメモリにコードをアップロードする手順を示します。これらのインストール手順は、RainMaker プラットフォーム用の Espressif の AWS アカウントとサービスを使用する 開始方法 チュートリアルで必要となります。

依存関係のインストール

コードをダウンロードし、 コードをコンパイル し、 Python プログラミング言語のパッケージインストーラ を使用して機能の依存関係をダウンロードするスクリプトを実行するには、まず依存関係ライブラリまたはアプリケーションを事前にインストールする必要があります。GitHub のリモートコードリポジトリからコードをダウンロードするには、 git をインストールする必要があります。コードをコンパイルするために、Espressif は cmake ビルドシステムを使用してデバイスアプリケーションの設定を解析し、 gcc コンパイラ を使用して、AWS IoT 用 Core2 が理解して実行できるオブジェクトコードにファームウェアをコンパイルします。すべての依存関係は、ターミナルで次のコマンドを使用して簡単にインストールすることができます。

sudo apt install build-essential python3-pip curl git cmake

Silicon Labs USB to UART bridgeのセットアップ

AWS IoT Kit for Core2 は、Silicon Labsの CP210x USB から UART ブリッジを介してホストマシンと通信します。オンボードCP2104は、ESP32-D0WDマイクロコントローラとのホスト通信を容易にするUSB-to-UARTブリッジです。マイクロコントローラは、 UART 0 を介して双方向に通信します。CP210xは、USB-Cを介して確立されたホストマシン上の仮想通信ポートを介して変換します。 Linux カーネルのバージョン 3.x.x および 4.x.x には、ディストリビューションの一部として CP210x に必要なドライバが既に含まれています。ただし、既定では、シリアル通信はダイヤルアウトグループの一部であるユーザーに制限されます。ユーザをダイヤルアウトグループに追加するには、以下のコマンドを入力します。

sudo usermod -a -G dialout $USER

権限を適用するには、ホストマシンを今すぐ再起動する必要があります。

Visual Studio Code のインストール

Visual Studio Code (VS Code) は、コードを表示、編集、管理できるオープンソースの統合開発環境(IDE) です。お使いのオペレーティングシステムの最新の Visual Studio コード をダウンロードします。Visual Studio コードのインストールまたは使用に関する問題のトラブルシューティングについては、 それらのドキュメント を参照してください。

PlatformIOのインストール

PlatformIO (PIO) は、組み込みソフトウェア開発を簡素化するプロフェッショナルな組み込み開発プラットフォームを提供します。VS Codeの拡張機能は、PlatformIO コマンドラインインターフェイス(CLI) のグラフィカルインターフェイスで機能を提供します。拡張機能のダウンロードについては、 こちら を参照してください。

PlatformIOの拡張機能をインストールしたら、VS Codeを再起動する必要があります。

ソースコードの取得

プロジェクトとファイルはすべて GitHub リポジトリ に存在し、リポジトリ内の各ファイルのリビジョン履歴を表示することもできます。チュートリアルに必要なコードをコピーするには、次の方法でPIOインターフェースを使用します。

  1. VS Codeアクティビティバー（左端のメニュー）でPlatformIOのロゴをクリックする。
  2. PlatformIO の Quick Accessメニューから、Miscellaneous で、Clone Git Projectを選択します。
  3. テキストフィールドに https://github.com/m5stack/Core2-for-AWS-IoT-EduKit.git を貼り付けて、プロジェクトを保存する場所を選択します。

    PlatformIO Clone Git Project

スマートフォン向けアプリのダウンロードとインストール

ESP RainMaker Phone Apps は、iOS および Androidで Wi-Fi ネットワークの構成、ユーザー作成、ユーザーデバイスの関連付け、およびデバイス制御を提供するために利用できます。アプリはこちらにあります：

互換性のある Android または iOS デバイスを所有していない場合は、 RainMaker CLI を使用することもできます。使い方についてはサイトの CLI Usage を参照してください。

USBポートの確認

Core2 for AWS IoT Kitリファレンスハードウェアを接続し、電源を入れます。ホストマシンに接続すると、デバイスの電源が自動的にオンになりますが、電源を入れる必要がある場合は、電源ボタンを押します。

AWS の M5Stack Core2 をオンまたはオフにする方法

デバイスの準備ができて、このチュートリアルに必要なソフトウェアをインストールしたら、デバイスが仮想的にマウントされているポートを特定して、そのポートに対する読み取りおよび書き込み操作を実行できるようにします。

  1. PlatformIOの Quick Access メニューの PIO Home で、Devices を選択します
  2. Descriptionの列で CP2104 USB to UART Bridge Controllerと書かれた行が見つかりますので、Port列ののパスが書かれている右側に表示されているアイコンをクリックして、パスをコピーします。(通常は /dev/ttyUSB0)
リストに表示されない場合は、電源が入っていること、および付属の USB-A から USB-C ケーブルを使用していることを確認してください。USB-C ハブの中には、シリアルポートの確立に互換性の問題があるものがあります。

次の手順

すべてのセットアップとホストマシンの準備ができて、Core2 for AWS IoT Kitリファレンスハードウェアと通信できる状態になったら、次の章 ESP RainMaker エージェントの実行 に進みます。

Questions? Please use M5Stack Forum

AWS IoT Kit now features direct access to M5Stack Forum , which is a community-driven, questions-and-answers service. Search re:Post using the Core2 for AWS tag to see if your question has been asked and answered. If not, ask a new question using the Core2 for AWS tag.