7  ESP32 実機へ(解説)

ここまでの仮想デバイスと同じことを、ESP32(Arduino フレームワーク)で行うときのポイントです。 この章の内容は、元のプロジェクト(ESP32-DevKitC + 赤外線受信・送信、PlatformIO)で 実機で確かめたこと です。このハンズオンでは ESP32 のコードのビルド・実機確認はしていません。

7.1 構成

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")]

役割 ライブラリ
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() に渡します。

警告C++ で JSON を文字列連結すると、型を間違えやすい

"\"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・重複チェック