PRACTICAL ARTICLE • HACKGADGET ACADEMY

ESP32でMQTTメッセージを受け取る

ESP32開発基板をPCの『ESP32 Wi‑Fi / MQTT』操作画面で順にPower→Wi‑Fi→MQTT→Subscribe/Publishを実行し、PCから送ったテストメッセージがESP32で受信されることを確認する入門実習です。教材ファームウェアは事前書込済みを前提とします。

初級防御系LESSON開発基板PC サインインすると進捗を保存

このレッスンでは、ESP32開発ボードをUSBで給電してPC上の「ESP32 Wi‑Fi / MQTT」操作画面からWi‑Fi接続→MQTTブローカー接続→特定トピックの購読を行い、PC側から送信したテストメッセージをESP32側で受け取れる状態にする手順を学びます。初心者向けに操作は短く、確認ポイントを絞って説明します。

今回できるようになること

ESP32開発ボードをUSBで動かし、PC上のESP32用操作画面からWi‑FiとMQTTブローカーへ接続し、指定トピックを購読してPCから送信したテストメッセージを受信・表示できるようになります。成功すれば、ESP32がネットワーク経由でメッセージを受け取れることを確認できます。

Labで使う IT / Tech 用語

Wi‑Fi：無線LANの接続。SSID（ネットワーク名）とパスワードで接続し、接続後にIPアドレスを取得します。
MQTT：軽量なメッセージ送受信プロトコル。端末はブローカー（仲介サーバ）に接続してPublish/Subscribeを行います。
ブローカー（Broker）：MQTTメッセージの仲介役。端末はここに接続してトピック単位で通信します（例: test/topic）。
トピック（Topic）：メッセージのチャンネル名。購読（Subscribe）したトピックに送られたメッセージを受け取ります。

今回やること（Mission Plan）

このレッスンでは、ESP32をUSBで給電し、PC上の『ESP32 Wi‑Fi / MQTT』操作画面から以下を順に実行して結果を確認します：1) Wi‑Fiに接続、2) MQTTブローカーへ接続、3) 指定トピックを購読、4) PCからテストメッセージを送ってESP32で受信表示を確認する、という一連の流れです。

まず始めに機器の接続とアプリの起動を確認します。Lab本編では操作は画面上のボタンや入力欄だけで完結し、長いコマンド入力やファームウェア書き込みは含みません。実際にやる範囲は接続と1回のPublish/Subscribeの確認に限定します。

使う機器

開発基板：USB給電とMQTTクライアント動作を実行する主役の開発基板。教材ファームウェアが書き込まれていることが前提。
PC：ESP32用の操作パネル（ESP32 Wi‑Fi / MQTT）や必要ならSerial Monitorを表示して設定・結果を確認する操作端末。

安全ルール

公衆Wi‑Fiや第三者ネットワークは使わず、隔離したテストSSIDを利用してください。
教材ファームウェアが事前に書き込まれていることを確認してから始めてください。

Interactive Lab

ここまで確認した仕組みを、実際に操作しながら試します。Terminalでコマンドを実行したり、生成されたファイルやログを開いたりしながら、処理がどのように進むのか確認していきます。

記事の内容をもとにした仮想教材です。操作し、表示された結果を確認してください。

Lab Debrief

Labが終わったら、実際に行った操作を画面を見ながら振り返ります。作業台の接続、実行したコマンド、その結果として作られたログやファイルを順番に確認し、「何をしたのか」「なぜこの結果になったのか」を整理します。

実習前のチェックと操作の流れ

始める前に確認する項目：ESP32に教材ファームウェアが書かれているか、USBケーブルでPCと接続されているか、テスト用SSIDとMQTTブローカーのホスト名・ポート・トピックが控えてあるかを確認してください。操作用アプリはPC上の『ESP32 Wi‑Fi / MQTT』（Device Tools風のUI）を使います。必要ならSerial Monitorで接続状態を覗けますが、原則はアプリのUIで操作します。

操作の流れ（画面操作で完了する短い手順）: PCでアプリを開く → ESP32が接続されていることを確認（Device Connected） → Wi‑FiのSSIDとパスワードを入力して接続 → ブローカー情報（ホスト/ポート/認証）を入力して接続 → Subscribeボタンでトピックを購読 → PCから同じトピックへメッセージをPublishして受信を確認、という順序です。各操作の直後に画面の状態表示（例: "Wi‑Fi: Connected (SSID)"）を確認してください。

実習後の解説と注意点

成功の目安は次の表示が確認できることです：アプリに『Device: Connected』または『Power: ON』、『Wi‑Fi: Connected (SSID)』とIPアドレス、『MQTT: Connected to broker』、そしてSubscribe後にPublishしたテストメッセージが受信ログに表示されること（例: "hello"）。これらが揃えばESP32がブローカー経由でメッセージを受け取れると判断できます。

注意点：表示だけでは通信が暗号化されているかは分かりません。実運用では必ずブローカーの認証（ユーザー名/パスワード）やTLSを有効にし、ESP32の設定でもTLSをオンにしてください。また、IoT機器は可能なら隔離ネットワーク（ゲストSSIDやVLAN）に配置してください。

まとめと次に進むための提案

このレッスンでESP32がWi‑FiとMQTTでメッセージの受信ができることを確認できれば、次はローカルにMosquittoを立ててTLS証明書やユーザー管理を試したり、ESP32側でセンサー値をPublishするようにファームを拡張するステップへ進めます。どちらも今回の手順を踏まえれば自然に取り組めます。