6 落とし穴 3:部分更新・取りこぼし・二重実行
無限ループほど派手ではありませんが、気づきにくい不具合が 3 つあります。
6.1 部分更新:温度だけ変えたら電源が切れる
エアコンが「ON・冷房・24℃」のときに、「アレクサ、エアコンを 26 度にして」と言うと、Lambda は desired に {"temp": 26, "cmdId": ...} を書きます。 delta には、変わったフィールドだけ が入ります(実測)。
desired を更新: {"temp": 26}
delta: {"temp": 26}
ここで、デバイスが delta を「エアコンの全設定」だと思って、
power = delta.get("power", False) # 入っていない → False
temp = delta.get("temp", 26)
send_aircon(power, temp) # 電源 OFF の信号を送ってしまうと書くと、温度を変えただけなのに電源が切れます。入っていないフィールドを、既定値で埋めてしまったためです。
正しくは、今の状態を元に、届いたフィールドだけを上書き します(virtual_device.py)。
for k in AC_KEYS: # 届いたフィールドだけ上書きし、残りは現在値のまま
if k in delta:
ac[k] = delta[k]デバイスが再起動しても今の状態が分かるように、元のプロジェクトでは ESP32 のフラッシュ(NVS)に保存しています。 赤外線の家電は状態を返してくれないので、デバイスが覚えている状態が唯一の手がかり です。
6.2 取りこぼし:切断中の delta は届かない
デバイスが Wi-Fi の切断や再起動で オフラインのあいだに配信された delta は、再接続しても届きません(実測)。
# デバイスを止めた状態で
python device/send.py slot 1
python device/send.py ac --power on --temp 23
# デバイスを起動する
python device/virtual_device.py[ 0.1s] 接続しました(Success)
[ 0.1s] <<< reported 更新: {"power": false, "mode": "cool", "temp": 26, "fan": "auto"}
[ 0.2s] delta 受信(get): {"sendSlot": "1-1791382699754", "power": true, "temp": 23, "cmdId": "1791382700002"}
[ 0.2s] >>> 赤外線送信 #1: スロット 1「テレビ 音量+」
[ 0.2s] >>> 赤外線送信 #2: エアコン {'power': True, 'mode': 'cool', 'temp': 23, 'fan': 'auto'}
仮想デバイスは、接続直後に get を送って、そのときの delta をまとめて受け取っている ので、切断中の 2 つの操作をどちらも実行できました。 購読しただけで get をしないと、この 2 つは失われます。
接続時に clean session = false(永続セッション)を指定し、QoS 1 で購読していれば、切断中の delta は AWS IoT が保持し、同じクライアント ID で再接続したときに届きます(実測)。 ただし、保持される期間には上限があり(既定 1 時間)、ESP32 でよく使う PubSubClient の既定は clean session です。 接続直後の get は、セッションの設定に関係なく確実に今の delta を取れるので、両方を使うのが安全です。
6.2.1 push の取りこぼしと、定期的な get
元のプロジェクトでは、接続中でも push された delta が ESP32 に届かないことがありました(WiFiClientSecure と PubSubClient の組み合わせで、TLS のデータが分割されて届いたときに受信を取りこぼす現象)。 そこで、5 秒ごとに get を送るポーリング を、push の予備として常に動かしています(virtual_device.py の --poll)。
6.3 二重実行:同じ delta が 2 回届く
push と get の両方で delta を受け取る設計にすると、同じ delta が 2 回届く ことがあります。上の再接続の実験の続きを見てください。
[ 0.2s] <<< reported 更新: {"power": true, "mode": "cool", "temp": 23, "fan": "auto", "cmdId": "1791382700002"}
[ 0.3s] delta 受信(push): {"power": true, "temp": 23, "cmdId": "1791382700002"}
[ 0.3s] (cmdId 1791382700002 は処理済みなので送信しない)
get で処理したのと 同じエアコンのコマンドが、0.1 秒後に push でも届いています。 原因は、接続直後の 状態の報告(0.1 秒)です。この時点ではまだ desired と食い違っていたので、その報告をきっかけに delta が配信されました(第 1 章の規則 5)。
重複チェックがなければ、エアコンに同じ信号を 2 回送ります。エアコンなら実害は小さいですが、トグル式の照明なら点いてすぐ消えます。
6.3.1 対策:処理済みのコマンドを覚える(冪等にする)
コマンドには毎回違う値("5-時刻"、cmdId)が付いているので、処理済みの値を覚えておけば、2 回目は実行せずに済みます。
if raw in done_ids:
log("処理済みなので送信しない")
else:
send_ir(...)
done_ids.add(raw)
report({"sendSlot": raw}) # 書き戻しは毎回する(delta を消すため)同じ操作を何回受け取っても結果が 1 回分になる性質を 冪等(べきとう) といいます。 ネットワーク越しの命令は「少なくとも 1 回 届く(2 回以上届くこともある)」と考え、受け取る側を冪等にしておくのが基本です。
仮想デバイスは処理済みの値をすべて覚えていますが、マイコンではメモリが限られます。 「最後に処理した sendSlot の値」と「最後に処理した cmdId」の 2 つを覚えるだけでも、ここで見た二重実行は防げます。
6.4 シミュレータで確かめる
「デバイスの実装」を 重複チェックなし にして、次を試してください。
- 「デバイスを切断」する
- 「エアコン ON 24℃」を押す(切断中なので届かない)
- 「デバイスを接続」する → 接続直後の get と、状態報告をきっかけにした push の 両方 で届き、送信が 2 回になる
正しい実装 に戻して同じことをすると、2 回目は「処理済み」として送信しません。
- delta には 変わったフィールドだけ が入る。今の状態に上書き し、既定値で埋めない
- 切断中の delta は届かない。接続直後に get する(永続セッションも併用できる)
- 同じ delta が 2 回届くことがある。処理済みの値を覚えて 冪等 にする