flowchart LR
subgraph ESP32
W["WiFiClientSecure<br>(TLS)"] --> P["PubSubClient<br>(MQTT)"]
P --> J["ArduinoJson<br>(delta の解析)"]
J --> I["赤外線の送信<br>(IRremoteESP8266)"]
end
P <-- "8883 番ポート" --> A[("AWS IoT Core")]
7 ESP32 実機へ(解説)
ここまでの仮想デバイスと同じことを、ESP32(Arduino フレームワーク)で行うときのポイントです。 この章の内容は、元のプロジェクト(ESP32-DevKitC + 赤外線受信・送信、PlatformIO)で 実機で確かめたこと です。このハンズオンでは ESP32 のコードのビルド・実機確認はしていません。
7.1 構成
| 役割 | ライブラリ |
|---|---|
| TLS(証明書による認証) | WiFiClientSecure(ESP32 Arduino コアに含まれる) |
| MQTT | PubSubClient |
| JSON | ArduinoJson |
7.2 接続まで
tlsClient.setCACert(AWS_CERT_CA); // AmazonRootCA1.pem の中身
tlsClient.setCertificate(AWS_CERT_CRT); // device.pem.crt
tlsClient.setPrivateKey(AWS_CERT_PRIVATE); // private.pem.key
mqtt.setServer(AWS_IOT_ENDPOINT, 8883);
mqtt.setBufferSize(2048); // 後述
mqtt.connect(THING_NAME); // クライアント ID = Thing 名(ポリシーと合わせる)証明書・秘密鍵・エンドポイントは secrets.h にまとめ、.gitignore に入れます。リポジトリには中身を空にした secrets.h.example だけを置きます。
7.2.1 つまずき 1:時刻が 1970 年だと TLS がつながらない
TLS では、サーバー証明書の 有効期限 を確かめます。ESP32 には時計の電池がなく、起動直後の時刻は 1970 年なので、証明書が「まだ有効になっていない」と判定されて接続に失敗します。 Wi-Fi に接続したら、NTP で時刻を合わせてから MQTT に接続します。
configTime(0, 0, "pool.ntp.org", "time.nist.gov");
// time(nullptr) が現実的な値(例:2023 年以降)になるまで待ってから connect する7.2.2 つまずき 2:PubSubClient の受信バッファが 256 バイト
PubSubClient の受信バッファは、既定で 256 バイト です。get/accepted には desired・reported・metadata(各フィールドの更新時刻)がすべて入るので、すぐに 256 バイトを超え、受信できずに黙って捨てられます。 setBufferSize(2048) のように広げ、ArduinoJson の解析用の領域(StaticJsonDocument<2048> など)も合わせて広げます。元のプロジェクトでは、最初の 384 バイトでも足りず、解析に失敗していました。
7.2.3 つまずき 3:BLE と TLS を同時に動かせない
元のプロジェクトは、スマホから BLE で操作する機能も持っていました。PSRAM のない ESP32(WROOM 系)では、
- BLE のスタックが、ヒープを常に 50〜70 KB ほど使う
- PlatformIO の既定の mbedTLS は、送受信バッファを 16 KB × 2 の固定長 で確保する(ビルド済みのライブラリなので小さくできない)
ため、Wi-Fi・BLE・TLS を同時に動かすとメモリが足りず、X509 - Certificate verification failed や SSL - Memory allocation failed が出続けました。 対策として、BLE モードとクラウドモードを排他 にし、クラウドモードに切り替えるときは BLEDevice::deinit() で BLE を止めてメモリを空けてから TLS に接続しています。
7.3 delta の処理
仮想デバイスの process_delta() と同じ構造です(元のプロジェクトのコードを簡略化)。
void processDelta(JsonObject delta) {
if (delta.isNull() || delta.size() == 0) return;
if (delta.containsKey("sendSlot")) {
String raw = delta["sendSlot"].as<String>(); // "5-1791382552299"
uint8_t slot = raw.substring(0, raw.indexOf('-')).toInt();
if (raw != lastSendSlot) { // 重複チェック(第 6 章)
irController.sendSlot(slot);
lastSendSlot = raw;
}
// 受け取った文字列を、文字列のまま書き戻す(ダブルクォートを忘れない)
String body = "{\"state\":{\"reported\":{\"sendSlot\":\"" + raw + "\"}}}";
mqtt.publish(TOPIC_UPDATE, body.c_str());
}
bool hasAc = delta.containsKey("power") || delta.containsKey("temp") /* ... */;
if (hasAc || delta.containsKey("cmdId")) {
// 今の状態に、届いたフィールドだけを上書き(第 6 章)
AcState s = irController.currentAcState();
if (delta.containsKey("power")) s.power = delta["power"].as<bool>();
if (delta.containsKey("temp")) s.temp = delta["temp"].as<int>();
// ...
irController.applyAc(s);
// 状態と cmdId を「1 回の publish」で書き戻す(第 5 章)
publishReported(s, delta["cmdId"].as<String>());
}
}/update/delta で届いたときは doc["state"]、/get/accepted で届いたときは doc["state"]["delta"] を、同じ processDelta() に渡します。
"\"cmdId\":" + cmdId と書くと数値、"\"cmdId\":\"" + cmdId + "\"" と書くと文字列になります。 desired と型が違うと、第 5 章の無限ループになります。ArduinoJson で組み立てれば、受け取った値の型をそのまま保てます。
7.4 クラウドの命令は、BLE 用の処理を通さない
元のプロジェクトのファームウェアは、BLE のコマンドをイベントキューに入れて状態機械で処理する設計でした(nRF52840 イベント駆動ファームウェア ハンズオン と同じ考え方)。 最初は Shadow の delta も同じイベントキューに入れていましたが、クラウドモードでは BLE を止めているため、
- 状態機械が「BLE 切断」として待機状態に戻っていて、送信コマンドを処理しない
- 処理の最後に BLE で結果を通知しようとして、止めた BLE スタックにアクセスする
という問題が起きました。クラウドからの命令は、赤外線の送信部分を直接呼ぶ ように分けています。 同じ機能を複数の経路(BLE・クラウド)から使うときは、経路ごとの前提(どのスタックが動いているか) を確かめます。
- TLS の前に NTP で時刻合わせ、PubSubClient の 受信バッファを広げる
- PSRAM のない ESP32 では、BLE と TLS の同時使用でメモリが足りない ことがある
- delta の処理は仮想デバイスと同じ。型をそろえた書き戻し・1 回の publish・重複チェック