

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

# Raspberry Pi の Managed Integrations Hub SDK イメージ
<a name="raspberrypi-device-hub-sdk"></a>

**注記**  
 Raspberry Pi AWS IoT での Hub SDK のこの実装は、学習とテストのみを目的としており、本番環境での使用を意図していません。このデモでは、開発を容易にするために以下の設定を行います。  
 **AWS 認証情報ストレージ**: デモのみを目的として、認証情報と証明書は、テストと開発を容易にするためにアクセス可能な場所に保存されます。本番環境では AWS Secrets Manager、 や Systems Manager Parameter Store などの安全なストレージソリューションを使用する必要があります。保管時の暗号化を実装し、 AWS IoT セキュリティガイドラインに従う必要があります。  
 **コンテナ権限**: デモは昇格された権限で実行され、ホストリソースへの無制限アクセスを許可し、開発ワークフローを簡素化します。本番環境では、コンテナは最小限必要な権限で動作する必要があります。  
 **ネットワークブリッジ設定**: デモでは、デバッグとモニタリングを容易にするために内部ネットワークトラフィックを公開するネットワークブリッジ設定を使用します。本番環境では、適切なネットワーク分離とセグメンテーションを実装して、内部ネットワークトラフィックへの不正アクセスを防止します。  
 **USB デバイスのアクセス許可**: 開発周辺機器とテストデバイスの接続を容易にするために、無制限の USB デバイスアクセスが有効になっています。本番環境では、厳格な USB デバイスコントロールと検証を実装して、デバイスのなりすまし攻撃を防止します。  
 これらの設定により、簡単なテストが可能になり、本番環境で使用してはいけません。本番環境にデプロイする場合は、セキュリティのベストプラクティスに従って、ホストシステムの侵害や認証情報への不正アクセスを防止してください。

## 前提条件
<a name="deployment-prerequisites"></a>

Raspberry Pi イメージをデプロイする前に、以下の要件を満たす必要があります。
+ [Raspberry Pi イメージャ](https://www.raspberrypi.com/software/)をダウンロードしてインストールします。
+ [SD カード](https://www.amazon.com/dp/B0CWPPDS3D?ref=ppx_yo2ov_dt_b_fed_asin_title)を取得します。
+ [2.4 Ghz 64 ビットクアッドコア CPU (8GB RAM) を搭載した Raspberry Pi 5 ](https://www.amazon.com/CanaKit-Raspberry-Starter-Kit-PRO/dp/B0CRSNCJ6Y/)をセットアップします。
+ [Sonoff Zigbee USB ドングル](https://www.amazon.com/Plus-ZBDongle-Interface-Pre-Installed-Coordinated-Zigbee2MQTT/dp/B0B6P22YJC/)を接続します。
+ [ファームウェアを Sonoff Zigbee USB ドングルにフラッシュする](supported-raspberry.md#sonoff-zigbee-firmware-flashing).
+ [Silicon Labs SLUSB001A ドングル](https://www.digikey.com/en/products/detail/silicon-labs/SLUSB001A/9867108)を接続します。
+ [AWS アカウントにサインアップします](https://docs.aws.amazon.com/iot-mi/latest/devguide/setting-up.html#sign-up-for-aws)。
+ Managed [AWS CLI Integrations コマンドリファレンスから最新バージョンの AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/) をインストールします。

## 新しい SD カードで Raspberry Pi イメージをフラッシュする
<a name="image-deployment"></a>

以下の手順に従って、マネージド統合イメージを SD カードにフラッシュします。

1. [Managed Integrations Raspberry Pi Hub SDK イメージ](https://d2no7dt1utuyzo.cloudfront.net/IotMI-HubSDK-RaspberryPi/1.0.0/IotMI-HubSDK-RPi-Image-v1.0.0.img.gz)をダウンロードします。

1. デスクトップで Raspberry Pi Imager を起動します。

1. SD カードをコンピュータの組み込み SD カードリーダーまたは外部 USB カードリーダーに挿入します。

1. **デバイスの選択** → Raspberry Pi 5 を選択します。

1. **Select OS** → Use custom → Find the IotMI-HubSDK-RPi-Image-v1.0.0.img.gz file → Open を選択します。

1. Select **storage** → Select your SD Card Reader を選択します。

1. 設定が次の画面と一致することを確認します。  
![デバイス、OS、ストレージの選択を示す Raspberry Pi Imager の設定画面](https://docs.aws.amazon.com/ja_jp/iot-mi/latest/devguide/images/raspberry-pi-imager-config.png)

1. **[次へ]** をクリックします。

1. OS のカスタマイズ設定を構成します。
   + **ホスト名:** **raspberrypi** を選択します。
   + **ユーザー名とパスワード:**
     + Enable **ユーザー名とパスワードの設定**:
     + **Username:** には、 を入力します`hub123456`。
     + **パスワード:** には、 を入力します`sh123456`。
   + **ワイヤレス LAN:**
     + **ワイヤレス LAN の設定**を有効にします。
     + ルーターの **SSID** と**パスワード**を入力します。

       設定の例
       + **SSID**:`iotmi-tplink`
       + **パスワード**:`********` (8 文字以上)
     + **国**: を に設定します`US`。
   + **ロケール設定の設定:**
     + **タイムゾーン **を に設定します`America/Los Angeles`。
     + **キーボードレイアウト** を に設定します`US`。
   + **SSH:**
     + **サービス**タブを選択します。
     + **SSH を有効にする** を確認します。
     + **パスワード認証を使用する** を選択します。

1. OS のカスタマイズとデータ消去のすべてのポップアップを確認します。

1. 書き込みプロセスが完了するまで待ちます。

1. 次の画面で正常に完了したことを確認します。  
![完了した書き込みオペレーションを示す Raspberry Pi Imager の成功画面](https://docs.aws.amazon.com/ja_jp/iot-mi/latest/devguide/images/raspberry-pi-write-success.png)

1. [**次へ**] をクリックします。

1. SD カードを取り外し、Raspberry Pi に挿入します。

## Raspberry Pi で Hub SDK を実行する
<a name="hub-sdk-execution"></a>

設定した Raspberry Pi で Hub SDK サービスを起動します。

1. 準備した SD カードを Raspberry Pi 5 デバイスに挿入します。

1. Sonoff Zigbee USB ドングルと Silicon Labs SLUSB001A ドングルを Raspberry Pi に接続します。

1. Raspberry Pi の電源を入れます。

1. Raspberry Pi とコンピュータ (SSH を使用) が同じネットワークにあることを確認します。

1. イメージのデプロイ時に設定した認証情報を使用して、Raspberry Pi に SSH します。

   ```
   ssh username@hostname
   ```

1. ハブ SDK ディレクトリに移動します。

   ```
   cd /data/aws/iotmi
   ```

1. [Hub オンボーディング設定](https://docs.aws.amazon.com/iot-mi/latest/devguide/managedintegrations-sdk-v2-cookbook-hubsetup.html)を完了して、認証マテリアルと設定マテリアルを追加します。
**注記**  
このステップを実行するには、 `YUL`または `DUB` リージョンにいる必要があります。

1. Hub SDK を実行します。

   ```
   cd /data/aws/iotmi
   bash start_hub_sdk.sh
   ```

Hub SDK が正常に開始されると、次のレスポンスが表示されます。

```
-------Stopping SDK running processes---
-------Starting Hub SDK-------------
-------Creating logs directory----------
Logs directory created.
-------Verifying Middleware paths-------
All middleware libraries exist
-------Verifying Middleware pre reqs---
AIPC and KVstroage directories exist
-------Starting HubOnboarding-----------
-------Starting MQTT Proxy-----------
-------Staring Log Daemon---
-------Starting Event Manager-----------
-------Starting Zigbee Service----------
--Checking Zigbee network information--
-------Starting Zwave Service----------
/data/aws/iotmi/middleware/AceZwave/bin /data/aws/iotmi
/data/aws/iotmi
-------Starting CDMB--------------------
-------Starting Agent--------------------
-------Starting Provisioner--------------
-------Checking SDK status---------------
hub1234+    1780  0.2  0.1 1093936 16368 pts/1   Sl+  16:34   0:00 ./iotmi_mqtt_proxy -C /data/aws/iotmi/config/iotmi_config.json
Process 'iotmi_mqtt_proxy' is running.
hub1234+    1884  0.0  0.0 236272  2624 pts/1    Sl+  16:34   0:00 ./middleware/AceCommon/bin/ace_eventmgr
Process 'ace_eventmgr' is running.
hub1234+    1892  9.1  0.1 393040  8352 pts/1    Sl+  16:34   0:04 ./middleware/AceZigbee/bin/ace_zigbee_service
Process 'ace_zigbee_service' is running.
hub1234+    1923  0.0  0.1 1570736 12736 pts/1   Sl+  16:34   0:00 ./zwave_svc
Process 'zwave_svc' is running.
hub1234+    1958  0.0  0.0 1067632 5776 pts/1    Sl+  16:34   0:00 ./iotmi_cdmb
Process 'iotmi_cdmb' is running.
hub1234+    2001  0.2  0.2 2017712 21264 pts/1   Sl+  16:35   0:00 ./iotmi_device_agent
Process 'iotmi_device_agent' is running.
hub1234+    2045  0.0  0.1 1457824 12624 pts/1   Sl+  16:35   0:00 ./iotmi_lpw_provisioner
Process 'iotmi_lpw_provisioner' is running.
hub1234+    1813  0.0  0.0 875152  6848 pts/1    Sl+  16:34   0:00 ./iotmi_log_daemon
Process 'iotmi_log_daemon' is running.
------Successfully Started Hub SDK----
```

## 次の手順
<a name="next-steps"></a>

Hub SDK を正常に起動したら、 でデバイスのオンボーディングと管理に進みます[デバイスをオンボードして運用するためのユーザーガイドの設定](managedintegrations-sdk-v2-cookbook-ugs.md)。