AWS IoT Device Shadow で家電を動かす ハンズオン

desired・reported・delta の同期と、実際に起きた無限ループ事故から学ぶ設計

公開

2026年10月18日

はじめに

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(東京リージョン)で実験して確かめたものです。 ブラウザで動くシミュレータも、その実験結果と一致するように作り、テストで照合しています。

このハンズオンのゴール

  1. Device Shadow の desired・reported・delta・version の関係を説明できる
  2. 実機なしで、PC の Python を仮想デバイスにして AWS IoT Core とやり取りできる
  3. 「同じ値は届かない」「無限ループ」「部分更新」「取りこぼし」「二重実行」が なぜ起きるか を説明し、防ぐ設計ができる
  4. 変更を本番機で試す前の 安全な確認手順 と 緊急停止 の方法を身につける

作るもの

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

本物の 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 アカウントがなくても、シミュレータだけで落とし穴を体験できます。