MacOS 10.14+ のセットアップ

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

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を介して確立されたホストマシン上の仮想通信ポートを介して変換します。仮想シリアルポートとその間の通信のマウントを有効にするには、対応するドライバをダウンロードしてインストールする必要があります。

  1. デバイスがホストマシンに接続されていないことを確認します。
  2. macOS 用のSilicon Labs CP210x driverを こちら ダウンロードします。
  3. ダウンロードしたファイルを解凍し、 SiLabsUSBDriverDisk.dmg を実行します
  4. マウントされると Install C210x VCP Driver がありますので、実行してインストールを行います
    • macOS 10.13 もしくはより新しいバージョンではインストールがブロックされる場合があります。その場合は、 System Preferences Security & Privacy と開き、 鍵アイコン をクリックして解除し、開発元を 許可 し、再度 鍵アイコン をクリックします。詳しくは Apple Technical Note TN2459 を参照してください。
  5. コンピュータを再起動すると利用の準備が整います

Visual Studio Code のインストール

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

ダウンロードしたVS Codeは Downloads フォルダでそのまま利用するのではなく、Application フォルダに移動してから利用することを推奨します。

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リファレンスハードウェアは同梱のUSB-C - USB-Aケーブルを利用して接続しますが、Mac側にUSB-Aポートが無い場合は、変換アダプターなどを別途用意したうえで利用してください。接続できたら電源を入れます。ホストマシンに接続すると、デバイスの電源が自動的にオンになりますが、電源を入れる必要がある場合は、電源ボタンを押します。

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

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

  1. PlatformIOの Quick Access メニューの PIO Home で、Devices を選択します
  2. Descriptionの列で CP2104 USB to UART Bridge Controllerと書かれた行が見つかりますので、Port列ののパスが書かれている右側に表示されているアイコンをクリックして、パスをコピーします。(通常は /dev/cu.SLAB_USBtoUART)
リストに表示されない場合は、電源が入っていること、および付属の 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.