AWS IoT Device Shadow で家電を動かす

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

今日のゴール

  1. Device Shadow の desired・reported・delta・version を説明できる
  2. 「届かない・止まらない・2 回動く」がなぜ起きるかを説明できる
  3. 防ぐ設計と、本番機の前の 安全確認・緊急停止 を身につける

ヒント

手順・コード・シミュレータは ハンズオンブック にあります。本文の挙動はすべて AWS IoT Core で実測したもの

元になった事故

自宅の赤外線リモコン(ESP32)を Alexa 対応にしたとき ……

  • 「アレクサ、照明つけて」が 2 回目から反応しない
  • 直そうとしたら、照明が 点いたり消えたりし続ける → USB を抜いて止めた
  • 直したと思ったら、今度は エアコンで同じことが起きる

原因はすべて、Shadow の delta の配信規則 の誤解でした

1. Device Shadow とは

クラウドとデバイスの「影」

sequenceDiagram
  participant C as クラウド(Lambda)
  participant S as Shadow
  participant D as デバイス
  C->>S: desired: {power: true}
  S-->>D: delta: {power: true}
  Note over D: 赤外線を送信
  D->>S: reported: {power: true}
  Note over S: 一致 → delta なし

delta の規則(実測)

  1. 更新は マージ。null は 削除
  2. delta = desired のうち reported と 値と型が違う フィールド
  3. 更新のたびに version が 1 増える(値が同じでも)
  4. 更新の後、delta が空でなければ delta 全体を配信
    • reported の更新でも、関係ないフィールドの更新でも
  5. 切断中に配信された delta は 届かない(get で取れる)

規則 4 が事故の中心

2. 落とし穴 1:同じ値は届かない

2 回目が届かない

desired reported delta
1 回目 sendSlot: 5 なし sendSlot: 5 → 届く
書き戻し後 sendSlot: 5 sendSlot: 5 なし
2 回目 sendSlot: 5 sendSlot: 5 なし → 届かない

Shadow は 状態 の同期。「ボタンを押す」は 出来事(コマンド)

対策:毎回変わる値を混ぜる

  • コマンド型(ボタン):値そのものを変える
    • {"sendSlot": "5-1791382552299"}(スロット-時刻)
  • 状態型(エアコン):状態はそのまま、cmdId を足す
    • {"temp": 27, "cmdId": "1791382573706"}
    • 同じ温度でも cmdId だけが delta に入って届く

3. 落とし穴 2:無限ループ

書き戻しがきっかけで、また届く

食い違いが残ったまま書き戻すと、その書き戻し自体 で delta が再配信される

書き戻し方 実測(仮想デバイス)
null で消す 0.4 秒で 8 回 送信(安全装置で停止)
型を変える("1700" → 1700) 0.4 秒で 8 回 送信
書き戻さない 5 秒ごと(ポーリングのたび)に送信
2 回に分ける 1 回の操作で 2 回 送信

シミュレータ

正しい書き戻し方と、止め方

  • 同じ値・同じ型 で書き戻す。null で消さない
  • 複数フィールドは 1 回の publish にまとめる

本番機の前に:

  1. watch で version を監視 しながら、1 回だけ 送る
  2. 15〜20 秒待って、送信が ちょうど 1 回、version が 増え続けていない ことを確認
  3. 増え続けたら desired を null に({"state": {"desired": null}})

4. 落とし穴 3

部分更新・取りこぼし・二重実行

  • 部分更新:delta {"temp": 26} に power は入らない
    • 既定値で埋めると 温度を変えただけで電源が切れる → 今の状態に上書き
  • 取りこぼし:切断中の delta は届かない
    • 接続直後に get(永続セッション + QoS 1 なら一定時間保持)
  • 二重実行:接続直後の状態報告がきっかけで、get と push の 両方で届いた(実測)
    • 処理済みの値を覚えて 冪等 に。トグル式の照明は 2 回で元に戻る

まとめ

設計チェックリスト

  1. ポリシーは その Thing の Shadow だけ、秘密鍵はコミットしない
  2. コマンド型 は値に時刻、状態型 は cmdId
  3. 同じ値・同じ型・null にしない・1 回の publish で書き戻す
  4. 実現できない desired を 残さない
  5. delta の欠けたフィールドを 既定値で埋めない
  6. 接続直後に get、同じ命令は 1 回だけ実行
  7. 本番機の前に 1 回送って version 監視、止めるときは desired を null

ハンズオンブック

  • 実機なしで、PC の Python を仮想デバイス にして AWS IoT Core とやり取り
  • --bug で事故を安全に再現(安全装置つき)
  • ESP32 の実装(NTP・バッファ・BLE と TLS のメモリ)と、Lambda・Alexa の解説

ヒント

AWS アカウントがなくても、ブラウザのシミュレータで落とし穴を体験できます