Raspberry Pi または他のデバイスを接続する

1. Python およびその開発ツールをインストールする

   AWS IoTDevice SDK for Python では、Python v3.5 以降を Raspberry Pi にインストールする必要があります。

   デバイスのターミナルウィンドウで、次のコマンドを実行します。

   1. このコマンドを実行して、デバイスにインストールされている Python のバージョンを確認します。

      python3 --version

      Python がインストールされている場合は、そのバージョンが表示されます。

   2. 表示されているバージョンが Python 3.5 以降の場合は、ステップ 2 にスキップできます。

   3. 表示されたバージョンが Python 3.5 よりも前の場合は、このコマンドを実行して正しいバージョンをインストールできます。

      sudo apt install python3

   4. このコマンドを実行して、正しいバージョンの Python がインストールされていることを確認します。

      python3 --version

2. pip3 をテストする

   デバイスのターミナルウィンドウで、次のコマンドを実行します。

   1. このコマンドを実行して、pip3 がインストールされているかどうかを確認します。

      pip3 --version

   2. コマンドがバージョン番号を返す場合、pip3 はインストールされており、ステップ 3 にスキップできます。

   3. 前のコマンドがエラーを返す場合は、このコマンドを実行して pip3 をインストールします。

      sudo apt install python3-pip

   4. このコマンドを実行して、pip3 がインストールされているかどうかを確認します。

      pip3 --version

3. 現在の AWS IoTDevice SDK for Python をインストールする

   AWS IoTDevice SDK for Python をインストールし、サンプルアプリケーションをデバイスにダウンロードします。

   デバイスで、次のコマンドを実行します。

   cd ~
   python3 -m pip install awsiotsdk

   git clone https://github.com/aws/aws-iot-device-sdk-python-v2.git

1. Node.js の最新バージョンをインストールする

   AWS IoTDevice SDK for JavaScript では、Node.js と npm パッケージマネージャーを Raspberry Pi にインストールする必要があります。

   1. このコマンドを入力して、ノードリポジトリの最新バージョンをダウンロードします。

      cd ~
      curl -sL https://deb.nodesource.com/setup_12.x | sudo -E bash -

   2. Node と npm をインストールします。

      sudo apt-get install -y nodejs

   3. Node のインストールを確認します。

      node -v

      コマンドが Node のバージョンを表示することを確認します。このチュートリアルでは Node v10.0 以降が必要です。Node のバージョンが表示されない場合は、Node リポジトリを再度ダウンロードしてみてください。

   4. npm のインストールを確認します。

      npm -v

      コマンドが npm バージョンを表示することを確認します。npm のバージョンが表示されない場合は、Node と npm をもう一度インストールしてみてください。

   5. デバイスを再起動します。

      sudo shutdown -r 0

      デバイスの再起動後に続行します。

2. AWS IoTDevice SDK for JavaScript をインストールする

   Raspberry Pi に AWS IoTDevice SDK for JavaScript をインストールします。

   1. AWS IoTDevice SDK for JavaScript リポジトリをホームaws-iot-device-sdk-js-v2ディレクトリの ディレクトリにクローンします。Raspberry Pi では、ホームディレクトリは ~/ であり、次のコマンドでホームディレクトリとして使用されます。デバイスがホームディレクトリに別のパスを使用している場合は、次のコマンドで ~/ をデバイスの正しいパスに置き換える必要があります。

      これらのコマンドは、~/aws-iot-device-sdk-js-v2 ディレクトリを作成し、SDK コードをそのディレクトリにコピーします。

      cd ~
      git clone https://github.com/aws/aws-iot-device-sdk-js-v2.git

   2. 前の手順で作成した aws-iot-device-sdk-js-v2 ディレクトリに変更し、npm install を実行して SDK をインストールします。コマンド npm install が aws-crt ライブラリビルドを呼び出し、これは完了するまで数分かかることがあります。

      cd ~/aws-iot-device-sdk-js-v2
      npm install

サンプルアプリケーションをインストールして実行するには

1. サンプルアプリディレクトリに移動します。

   cd ~/aws-iot-device-sdk-python-v2/samples

2. コマンドラインウィンドウで、示されているように your-iot-endpoint を置き換えて、このコマンドを実行します。

   python3 pubsub.py --topic topic_1 --ca_file ~/certs/Amazon-root-CA-1.pem --cert ~/certs/device.pem.crt --key ~/certs/private.pem.key --endpoint your-iot-endpoint

3. サンプルアプリケーションが次のようになっていることを観察します。

   1. アカウントの AWS IoTサービスに接続します。

   2. メッセージトピック topic_1 をサブスクライブし、そのトピックで受信したメッセージを表示します。

   3. 10 個のメッセージをトピック、topic_1 に発行します。

   4. 次のような出力を表示します。

   Connecting to a3qEXAMPLEffp-ats.iot.us-west-2.amazonaws.com with client ID 'test-0c8ae2ff-cc87-49d2-a82a-ae7ba1d0ca5a'...
   Connected!
   Subscribing to topic 'topic_1'...
   Subscribed with QoS.AT_LEAST_ONCE
   Sending 10 message(s)
   Publishing message to topic 'topic_1': Hello World! [1]
   Received message from topic 'topic_1': b'Hello World! [1]'
   Publishing message to topic 'topic_1': Hello World! [2]
   Received message from topic 'topic_1': b'Hello World! [2]'
   Publishing message to topic 'topic_1': Hello World! [3]
   Received message from topic 'topic_1': b'Hello World! [3]'
   Publishing message to topic 'topic_1': Hello World! [4]
   Received message from topic 'topic_1': b'Hello World! [4]'
   Publishing message to topic 'topic_1': Hello World! [5]
   Received message from topic 'topic_1': b'Hello World! [5]'
   Publishing message to topic 'topic_1': Hello World! [6]
   Received message from topic 'topic_1': b'Hello World! [6]'
   Publishing message to topic 'topic_1': Hello World! [7]
   Received message from topic 'topic_1': b'Hello World! [7]'
   Publishing message to topic 'topic_1': Hello World! [8]
   Received message from topic 'topic_1': b'Hello World! [8]'
   Publishing message to topic 'topic_1': Hello World! [9]
   Received message from topic 'topic_1': b'Hello World! [9]'
   Publishing message to topic 'topic_1': Hello World! [10]
   Received message from topic 'topic_1': b'Hello World! [10]'
   10 message(s) received.
   Disconnecting...
   Disconnected!

   サンプルアプリケーションの実行に問題がある場合は、サンプルアプリケーションの問題をトラブルシューティングする を確認してください。

   コマンドラインに --verbosity Debug パラメータを追加して、サンプルアプリケーションが実行内容に関する詳細なメッセージを表示するようにすることもできます。この情報は、問題の修正に役立つ場合があります。

サンプルアプリケーションをインストールして実行するには

1. コマンドラインウィンドウで、SDK が作成した ~/aws-iot-device-sdk-js-v2/samples/node/pub_sub ディレクトリに移動し、これらのコマンドを使用してサンプルアプリケーションをインストールします。コマンド npm install が aws-crt ライブラリビルドを呼び出し、これは完了するまで数分かかることがあります。

   cd ~/aws-iot-device-sdk-js-v2/samples/node/pub_sub
   npm install

2. コマンドラインウィンドウで、示されているように your-iot-endpoint を置き換えて、このコマンドを実行します。

   node dist/index.js --topic topic_1 --ca_file ~/certs/Amazon-root-CA-1.pem --cert ~/certs/device.pem.crt --key ~/certs/private.pem.key --endpoint your-iot-endpoint

3. サンプルアプリケーションが次のようになっていることを観察します。

   1. アカウントの AWS IoTサービスに接続します。

   2. メッセージトピック topic_1 をサブスクライブし、そのトピックで受信したメッセージを表示します。

   3. 10 個のメッセージをトピック、topic_1 に発行します。

   4. 次のような出力を表示します。

   Publish received on topic topic_1
   {"message":"Hello world!","sequence":1}
   Publish received on topic topic_1
   {"message":"Hello world!","sequence":2}
   Publish received on topic topic_1
   {"message":"Hello world!","sequence":3}
   Publish received on topic topic_1
   {"message":"Hello world!","sequence":4}
   Publish received on topic topic_1
   {"message":"Hello world!","sequence":5}
   Publish received on topic topic_1
   {"message":"Hello world!","sequence":6}
   Publish received on topic topic_1
   {"message":"Hello world!","sequence":7}
   Publish received on topic topic_1
   {"message":"Hello world!","sequence":8}
   Publish received on topic topic_1
   {"message":"Hello world!","sequence":9}
   Publish received on topic topic_1
   {"message":"Hello world!","sequence":10}

   サンプルアプリケーションの実行に問題がある場合は、サンプルアプリケーションの問題をトラブルシューティングする を確認してください。

   コマンドラインに --verbosity Debug パラメータを追加して、サンプルアプリケーションが実行内容に関する詳細なメッセージを表示するようにすることもできます。この情報は、問題の修正に役立つ場合があります。