flowchart LR
A["send.py<br>(Alexa の Lambda の代わり)"] -- "desired を更新" --> S[("Device Shadow<br>AWS IoT Core")]
S -- "delta を配信(MQTT)" --> D["virtual_device.py<br>(赤外線リモコンのふり)"]
D -- "reported を更新" --> S
AWS IoT Device Shadow で家電を動かす ハンズオン
desired・reported・delta の同期と、実際に起きた無限ループ事故から学ぶ設計
はじめに
English version available — Read in English (machine-assisted translation by generative AI).
「アレクサ、照明つけて」と話しかけると、クラウドを経由して自宅の赤外線リモコン(ESP32)が照明に信号を送る ―― このしくみの中心にあるのが、AWS IoT Core の Device Shadow です。
Shadow は、クラウドの「こうしてほしい(desired)」と、デバイスの「今こうなっている(reported)」を 1 つの JSON にまとめて、その 食い違い(delta) をデバイスに届けてくれるしくみです。 便利な反面、delta が「いつ・何を含んで」配信されるかを正しく理解していないと、
- 2 回目のコマンドが まったく届かない
- 1 回の操作で、照明が 点いたり消えたりし続ける(無限ループ)
という事故が起きます。このハンズオンは、作者が自宅の赤外線リモコンを Alexa 対応にしたときに 実際に起こした事故 をもとにしています。
教材に書いた Shadow の挙動(delta が配信される条件、無限ループの起こり方など)は、AWS IoT Core(東京リージョン)で実験して確かめたものです。 ブラウザで動くシミュレータも、その実験結果と一致するように作り、テストで照合しています。
このハンズオンのゴール
- Device Shadow の desired・reported・delta・version の関係を説明できる
- 実機なしで、PC の Python を仮想デバイスにして AWS IoT Core とやり取りできる
- 「同じ値は届かない」「無限ループ」「部分更新」「取りこぼし」「二重実行」が なぜ起きるか を説明し、防ぐ設計ができる
- 変更を本番機で試す前の 安全な確認手順 と 緊急停止 の方法を身につける
作るもの
本物の ESP32 や家電は不要です。PC で動く Python のプログラムが「赤外線リモコン」のふりをして、照明(スロット 5、押すたびに点灯と消灯が切り替わるトグル式)とエアコンを操作します。 ESP32 の実装のポイントと、Alexa から操作するしくみは、第 7・8 章で解説します。
対象読者
- IoT デバイスとクラウドをつなぐしくみに興味がある方(ESP32・Raspberry Pi などで何か作ったことがあると理解しやすい)
- ターミナルでコマンドを実行でき、Python のコードを読める方
- AWS のアカウントを持っている(または作れる)方
必要なもの
- AWS アカウントと AWS CLI v2(
aws sts get-caller-identityが通る状態) - Python 3.10 以上
- ターミナルを 3 つ開けること(デバイス・監視・操作)
使うのは AWS IoT Core のメッセージングと Device Shadow だけで、このハンズオンの範囲(数百〜数千メッセージ)なら費用はごくわずかです。 最後に第 2 章の手順で 作ったものをすべて削除 してください。
サンプルコード
code.zip をダウンロードして展開してください。中身は次のとおりです。
code/
├── requirements.txt paho-mqtt(MQTT)と boto3(AWS SDK)
├── setup/create_thing.sh Thing・証明書・ポリシーを作る
├── setup/cleanup.sh 作ったものをすべて削除する
├── device/virtual_device.py 仮想デバイス(--bug で事故を再現できる)
└── device/send.py クラウド側から Shadow を操作する
章構成
| 章 | 内容 |
|---|---|
| 1 | Device Shadow とは ― desired・reported・delta・version |
| 2 | AWS の準備 ― Thing・証明書・最小権限のポリシー |
| 3 | 仮想デバイスを動かす |
| 4 | 落とし穴 1:同じ値は届かない |
| 5 | 落とし穴 2:無限ループ ― 安全な確認手順と緊急停止 |
| 6 | 落とし穴 3:部分更新・取りこぼし・二重実行 |
| 7 | ESP32 実機へ(解説) |
| 8 | クラウドから操作する:Lambda と Alexa(解説) |
| 9 | 設計チェックリストと確認問題 |
1・4・5・6 章には、ブラウザで動く Shadow シミュレータ があります。AWS アカウントがなくても、シミュレータだけで落とし穴を体験できます。