第15章 ESP32 MQTT IoT 完整教學:DHT11 溫溼度上傳、Mosquitto 與 Relay 遠端控制

發布日期: |更新日期:
文章主圖:第15章 ESP32 MQTT IoT 完整教學:DHT11 溫溼度上傳、Mosquitto 與 Relay 遠端控制

前面的 ESP32 課程,我們已經完成:

  • ESP32 Wi-Fi 無線網路
  • ESP32 Web Server
  • 手機控制 LED / Relay
  • DHT11 / DHT22 Web Dashboard
  • JSON Sensor API
  • Bluetooth Classic
  • BLE 手機控制

到了第 15 章,我們要正式跨入真正的:

IoT — Internet of Things

前面的 Web Server 架構通常是:

手機
 │
 │ HTTP
 ▼
ESP32

手機必須知道 ESP32 的:

IP Address

而 MQTT 的架構完全不同。

ESP32 不需要直接和每一支手機、電腦或 Raspberry Pi 建立連線。

所有裝置都連到中央:

MQTT Broker

例如:

MQTT Broker
            /     |      \
           /      |       \
          ▼       ▼        ▼
       ESP32   Raspberry   Phone
                 Pi

ESP32 可以把 DHT11 溫度與濕度資料:

Publish

到 MQTT Broker。

另一台電腦、手機、Home Assistant 或 Raspberry Pi 只要:

Subscribe

相同 Topic,就能立即收到資料。

同時 ESP32 也可以訂閱:

home/relay/set

當 Broker 收到:

ON

ESP32 就開啟 Relay。

收到:

OFF

就關閉 Relay。

因此本章將完成:

ESP32 MQTT 智慧溫溼度控制器

系統架構如下:

DHT11 / DHT22
      │
      ▼
    ESP32
      │
      │ Wi-Fi
      ▼
 MQTT Broker
      │
      ├── Temperature / Humidity
      │
      └── Relay Control

並完整學習:

MQTT、Broker、Client、Publisher、Subscriber、Topic、Payload、QoS、JSON、Mosquitto、Wi-Fi + MQTT。

一、什麼是 MQTT?

MQTT 全名:

Message Queuing Telemetry Transport

MQTT 是一種非常適合:

  • IoT
  • Sensor
  • Embedded System
  • Low Bandwidth Network
  • Machine-to-Machine
  • Remote Monitoring

使用的訊息通訊協定。

和傳統 HTTP 很不同。

HTTP 常見架構:

Client
  │
  │ Request
  ▼
Server
  │
  │ Response
  ▼
Client

MQTT 則採用:

Publish
   │
   ▼
Broker
   │
   ▼
Subscribe

這叫做:

Publish / Subscribe Architecture

也就是:

發佈 / 訂閱架構。

二、ESP32 為什麼非常適合 MQTT?

ESP32 本身具有:

Wi-Fi
+
TCP/IP
+
MCU

再搭配:

MQTT

就可以非常容易地成為 IoT Node。

例如:

DHT11
 │
 ▼
ESP32
 │
 ▼
Wi-Fi
 │
 ▼
MQTT Broker
 │
 ├── Home Assistant
 ├── Raspberry Pi
 ├── Node-RED
 ├── Python
 ├── Database
 └── Mobile App

ESP32 不需要知道:

誰正在看我的資料?

它只負責:

Publish Sensor Data

即可。

三、什麼是 MQTT Broker?

Broker 可以理解為:

MQTT 系統的訊息交換中心。

例如:

ESP32 #1 ──────┐
ESP32 #2 ──────┤
ESP32 #3 ──────┤
               ▼
          MQTT Broker
               │
       ┌───────┼────────┐
       ▼       ▼        ▼
     Phone   Server   Raspberry Pi

所有 MQTT Client 都與 Broker 連線。

Broker 負責:

接收 Publisher 訊息
       ↓
依 Topic 分類
       ↓
轉送給 Subscriber

四、Mosquitto 是什麼?

Mosquitto 是 Eclipse Foundation 的開源 MQTT Broker。

除了 Broker 本身,它也提供非常實用的命令列工具:

mosquitto_pub

以及:

mosquitto_sub

目前 Mosquitto 的 command-line clients 支援 MQTT 5、MQTT 3.1.1、MQTT 3.1,也可設定 QoS、帳號密碼與 TLS。

因此非常適合 ESP32 MQTT 教學與實驗。

五、MQTT Client 是什麼?

只要連接 MQTT Broker 的裝置,都可以稱為:

MQTT Client

例如:

ESP32
Raspberry Pi
PC
Python Program
Home Assistant
Node-RED
MQTT Explorer
Smartphone

都可以是 Client。

一個 Client 可以同時:

Publish
+
Subscribe

所以 ESP32 不一定只能傳 Sensor。

它可以:

Publish Temperature

同時:

Subscribe Relay Command

六、什麼是 Publisher?

Publisher:

發布者

負責將訊息送到 Broker。

例如 ESP32:

Temperature = 27.5°C
Humidity = 63%

送到:

home/esp32/sensor

流程:

ESP32
 │
 │ Publish
 ▼
home/esp32/sensor
 │
 ▼
MQTT Broker

此時 ESP32 就是:

Publisher

七、什麼是 Subscriber?

Subscriber:

訂閱者

負責訂閱某個 Topic。

例如 Raspberry Pi:

Subscribe
home/esp32/sensor

ESP32 發布:

{"temperature":27.5,"humidity":63}

Broker 就把訊息送給 Raspberry Pi。

ESP32
 │
 │ Publish
 ▼
Broker
 │
 │
 ▼
Raspberry Pi
Subscriber

八、一台 ESP32 可以同時是 Publisher 與 Subscriber

這點很重要。

本章 ESP32:

Publisher

發布:

home/esp32/sensor

內容:

{
  "temperature": 27.5,
  "humidity": 63.0
}

同時發布:

home/relay/state

例如:

ON

Subscriber

訂閱:

home/relay/set

接收:

ON

或:

OFF

因此:

ESP32
 =
Publisher
+
Subscriber

九、什麼是 MQTT Topic?

Topic 是 MQTT 最重要的觀念之一。

可以把 Topic 理解成:

訊息分類路徑。

例如:

home/livingroom/temperature

或:

home/livingroom/humidity

或:

home/relay/set

Topic 看起來很像:

Folder Path

但是它不是檔案系統。

它只是 MQTT 用來分類訊息的名稱。

十、本章 Topic 設計

本章使用:

ESP32 MQTT Topic 規劃
Topic 方向 用途
home/esp32/sensor ESP32 → Broker DHT11 JSON
home/relay/set Broker → ESP32 Relay 控制
home/relay/state ESP32 → Broker Relay 狀態
home/esp32/status ESP32 / Broker Online / Offline

其中最重要的控制 Topic:

home/relay/set

這會完全依照題目的設計使用。

十一、什麼是 Payload?

Topic 是:

地址

Payload 是:

內容

例如:

Topic:
home/relay/set

Payload:

ON

完整概念:

Topic
home/relay/set

Payload
ON

ESP32 就知道:

Relay ON

十二、Sensor Payload 可以使用 JSON

如果只傳溫度:

27.5

沒有問題。

但是同時有:

Temperature
Humidity
RSSI
Relay

就很適合使用:

JSON

例如:

{
  "temperature": 27.5,
  "humidity": 63.0,
  "relay": false,
  "rssi": -51
}

這種格式比:

27.5,63,0,-51

更容易閱讀與擴充。

十三、什麼是 QoS?

QoS:

Quality of Service

代表 MQTT 訊息傳送的服務品質等級。

MQTT 主要有:

QoS 0
QoS 1
QoS 2

十四、QoS 0

QoS 0:

At most once

概念:

送一次
不等待確認

優點:

最快
流量最小
負擔最低

缺點:

訊息可能遺失

非常適合:

Temperature
Humidity
RSSI

這類持續更新的 Sensor Data。

因為就算:

27.5°C

某一筆沒有收到,幾秒後:

27.6°C

還會再傳。

十五、QoS 1

QoS 1:

At least once

Broker / Client 會進行確認。

訊息至少會送達一次,但極端情況可能重複。

因此適合:

Relay Command
Alarm
重要狀態

例如:

home/relay/set

本章訂閱設定為:

QoS 1

十六、QoS 2

QoS 2:

Exactly once

提供最高等級的 MQTT 交付流程。

但是代價是:

更多封包
更多確認
更多延遲
更多資源

一般 ESP32 Sensor 不一定需要 QoS 2。

Mosquitto 的 publish / subscribe clients 都能設定 QoS 0、1、2。

十七、ESP32 MQTT Library 選擇

很多較舊的 ESP32 MQTT 教學都使用:

PubSubClient

它確實曾經是 Arduino MQTT 最經典的 Library。

但是到了 2026 年,PubSubClient 作者已在官方專案 README 明確標示該函式庫不再維護,並建議新專案選擇仍持續維護的替代方案。PubSubClient 本身也只能 Publish QoS 0。

因此本章新的教材範例改採:

arduino-mqtt

程式使用:

#include <MQTT.h>

這個 Library 可以搭配 ESP32 的 WiFiClient,並提供 MQTT Publish、Subscribe、QoS 0 / 1 / 2、Will 等功能。

十八、安裝 MQTT Library

Arduino IDE:

Sketch
→ Include Library
→ Manage Libraries

搜尋:

MQTT

本章使用的是:

256dpi / arduino-mqtt

程式 Header:

#include <MQTT.h>

不要和:

PubSubClient.h

的範例混在一起。

因為兩套 Library 的 API 不同。

十九、本章其他 Library

還需要:

#include <WiFi.h>
#include <DHT.h>
#include <MQTT.h>

其中:

WiFi.h

負責 ESP32 Wi-Fi。

DHT.h

負責 DHT11 / DHT22。

MQTT.h

負責 MQTT。

二十、本章硬體

需要:

ESP32 MQTT 智慧溫溼度控制器元件清單
元件 數量
ESP32 DevKit / ESP32-WROOM-32 1
DHT11 或 DHT22 1
Relay Module 1
Wi-Fi Router 1
MQTT Broker 1
杜邦線 若干

本章:

DHT DATA → GPIO 4
Relay IN → GPIO 26

二十一、DHT11 接線

DHT11 與 ESP32 接線表
DHT11 ESP32
VCC 3.3V
DATA GPIO 4
GND GND

接線:

ESP32              DHT11
─────              ─────

3.3V ────────────► VCC

GPIO 4 ──────────► DATA

GND ─────────────► GND

如果使用裸 DHT11,而不是三腳 Module,DATA 通常還需要 Pull-up Resistor。

二十二、Relay 接線

Relay Module 與 ESP32 接線表
Relay ESP32
IN GPIO 26
GND GND
VCC 依 Relay Module 規格

本章假設:

Active LOW Relay

因此:

#define RELAY_ON  LOW
#define RELAY_OFF HIGH

如果你的模組是 Active HIGH,只需要改成:

#define RELAY_ON  HIGH
#define RELAY_OFF LOW

二十三、整體硬體與 MQTT 架構

DHT11
 │
 │ GPIO 4
 ▼
ESP32
 │
 ├──────── GPIO 26 ───────► Relay
 │
 │
 │ Wi-Fi
 ▼
Router
 │
 ▼
MQTT Broker
 │
 ├────────► Database
 │
 ├────────► Raspberry Pi
 │
 ├────────► Home Assistant
 │
 └────────► MQTT Client

二十四、MQTT Broker IP Address

假設 Mosquitto 安裝在:

192.168.1.10

那麼 ESP32 MQTT Broker 設定:

const char* MQTT_HOST =
  "192.168.1.10";

標準未加密 MQTT Port 通常使用:

1883

程式:

const int MQTT_PORT =
  1883;

所以:

ESP32
 │
 ▼
192.168.1.10:1883

二十五、建立 MQTT Client

先建立 ESP32 的 TCP Client:

WiFiClient networkClient;

再建立:

MQTTClient mqttClient(512);

這裡:

512

設定 MQTT 接收 Buffer。

然後:

mqttClient.begin(
  MQTT_HOST,
  MQTT_PORT,
  networkClient
);

把:

Wi-Fi TCP

和:

MQTT

連接起來。

二十六、Wi-Fi + MQTT 是兩層不同連線

這點非常重要。

ESP32 MQTT 需要:

第一層
Wi-Fi Connected

然後才有:

第二層
MQTT Connected

架構:

ESP32
 │
 ▼
Wi-Fi
 │
 ▼
TCP/IP
 │
 ▼
MQTT Broker

所以:

WiFi Connected

不代表:

MQTT Connected

二十七、MQTT Client ID

每個 MQTT Client 應該有:

Client ID

例如:

ESP32-123456789ABC

如果多台 ESP32 都使用:

ESP32Client

可能造成 Broker 認為是同一 Client,導致互相踢下線。

因此本章使用 ESP32:

MAC Address

產生唯一 Client ID。

例如:

String clientId =
  "ESP32-" +
  WiFi.macAddress();

clientId.replace(
  ":",
  ""
);

最後可能得到:

ESP32-246F28123456

二十八、MQTT Subscribe

連線 Broker 成功後:

mqttClient.subscribe(
  "home/relay/set",
  1
);

代表:

ESP32 訂閱
home/relay/set

QoS = 1

之後只要 Broker 收到:

Topic:
home/relay/set

Payload:
ON

ESP32 就能收到。

二十九、MQTT Callback

建立:

void messageReceived(
  String &topic,
  String &payload
)

例如:

void messageReceived(
  String &topic,
  String &payload
) {

  Serial.println(
    topic + " = " + payload
  );
}

每當 MQTT 訊息進入時,就執行這個 Callback。

三十、控制 Relay

如果:

Topic
=
home/relay/set

而 Payload:

ON

ESP32:

digitalWrite(
  RELAY_PIN,
  RELAY_ON
);

如果:

OFF

執行:

digitalWrite(
  RELAY_PIN,
  RELAY_OFF
);

三十一、MQTT Callback 不建議做太多工作

本章使用的 MQTT Library 官方文件特別提醒:

在 Message Callback 裡,不建議直接進行新的 QoS Publish、Subscribe 或 Unsubscribe,否則可能造成通訊等待甚至 deadlock;較好的方式是先修改變數,再回到 loop() 處理。

因此本章會使用:

Callback
   │
   ▼
記錄 Pending Command
   │
   ▼
loop()
   │
   ▼
真正控制 Relay
   │
   ▼
Publish Relay State

這是一個比直接在 Callback 塞滿所有功能更好的架構。

三十二、Publisher:發布 Sensor JSON

例如 DHT11 讀到:

Temperature = 27.5°C

Humidity = 63%

ESP32 產生:

{
  "temperature":27.5,
  "humidity":63.0,
  "relay":false,
  "rssi":-51
}

接著:

mqttClient.publish(
  "home/esp32/sensor",
  json,
  false,
  0
);

其中:

false

代表:

Retain = false

而:

0

代表:

QoS 0

三十三、為什麼 Sensor 使用 QoS 0?

因為:

Temperature
Humidity
RSSI

都是週期性資料。

例如每 5 秒:

27.5
27.6
27.7
27.6

少一筆通常不重要。

所以使用:

QoS 0

可以降低負擔。

三十四、Relay State 使用 Retain

Relay 狀態不同。

例如:

home/relay/state

Payload:

ON

如果後來才開啟 MQTT Dashboard,我們希望它一訂閱就知道:

Relay 現在是 ON

這時可以使用:

Retained Message

發布:

mqttClient.publish(
  TOPIC_RELAY_STATE,
  "ON",
  true,
  1
);

其中:

true

表示:

Retain

Broker 會保存最後狀態。

Mosquitto 的 mosquitto_pub 同樣提供 retain 選項,Broker 可以保存該 Topic 最後一筆 retained message,讓新 Subscriber 訂閱時立即取得。

三十五、什麼是 Last Will and Testament?

MQTT 還有一個非常重要的功能:

Last Will and Testament
LWT

假設 ESP32:

突然斷電
Wi-Fi 消失
程式 Crash

它沒有機會主動發布:

offline

因此在 MQTT Connect 時,可以先告訴 Broker:

如果我異常消失,請幫我發布 offline。

本章使用:

home/esp32/status

正常連線:

online

異常斷線:

offline

Mosquitto 的 MQTT clients 也支援設定 Will Topic、Will Payload、Will QoS 與 Will Retain。

三十六、ESP32 MQTT 智慧溫溼度控制器完整程式

以下程式整合:

Wi-Fi
DHT11 / DHT22
MQTT
JSON
Publisher
Subscriber
QoS
Retain
LWT
Relay
Wi-Fi Reconnect
MQTT Reconnect

完整實作如下。

/*
 * =====================================================
 * 第 15 章
 * ESP32 MQTT IoT 完整教學
 *
 * ESP32 MQTT 智慧溫溼度控制器
 * =====================================================
 *
 * 功能:
 *
 * 1. ESP32 連接 Wi-Fi
 * 2. ESP32 連接 MQTT Broker
 * 3. DHT11 / DHT22 讀取溫溼度
 * 4. Publish JSON Sensor Data
 * 5. Subscribe home/relay/set
 * 6. 遠端 Relay ON / OFF
 * 7. Publish Relay State
 * 8. Wi-Fi RSSI
 * 9. MQTT Retain
 * 10. MQTT Last Will
 * 11. Wi-Fi 自動重連
 * 12. MQTT 自動重連
 *
 * Library:
 *
 * WiFi.h
 * DHT.h
 * MQTT.h   (256dpi / arduino-mqtt)
 *
 * GPIO:
 *
 * DHT   -> GPIO 4
 * Relay -> GPIO 26
 * =====================================================
 */

#include <WiFi.h>
#include <DHT.h>
#include <MQTT.h>


// =====================================================
// Wi-Fi
// =====================================================

const char* WIFI_SSID =
  "YOUR_WIFI_SSID";

const char* WIFI_PASSWORD =
  "YOUR_WIFI_PASSWORD";


// =====================================================
// MQTT Broker
// =====================================================

const char* MQTT_HOST =
  "192.168.1.10";

const int MQTT_PORT =
  1883;


// =====================================================
// MQTT Authentication
// =====================================================
//
// 如果 Broker 暫時沒有帳號密碼,
// 可先保留空字串。
//
// 正式系統建議使用帳號、密碼與 TLS。
// =====================================================

const char* MQTT_USERNAME =
  "";

const char* MQTT_PASSWORD =
  "";


// =====================================================
// MQTT Topics
// =====================================================

const char* TOPIC_SENSOR =
  "home/esp32/sensor";

const char* TOPIC_RELAY_SET =
  "home/relay/set";

const char* TOPIC_RELAY_STATE =
  "home/relay/state";

const char* TOPIC_STATUS =
  "home/esp32/status";


// =====================================================
// DHT Sensor
// =====================================================

#define DHT_PIN 4

#define DHT_TYPE DHT11

// 如果使用 DHT22:
// #define DHT_TYPE DHT22

DHT dht(
  DHT_PIN,
  DHT_TYPE
);


// =====================================================
// Relay
// =====================================================

#define RELAY_PIN 26

#define RELAY_ON  LOW
#define RELAY_OFF HIGH

bool relayState =
  false;


// =====================================================
// MQTT Network
// =====================================================

WiFiClient networkClient;


// =====================================================
// MQTT Client
// =====================================================

MQTTClient mqttClient(
  512
);


// =====================================================
// Sensor Data
// =====================================================

float temperature =
  NAN;

float humidity =
  NAN;

bool sensorValid =
  false;


// =====================================================
// Timers
// =====================================================

unsigned long lastSensorTime =
  0;

unsigned long lastPublishTime =
  0;

unsigned long lastWiFiReconnect =
  0;

unsigned long lastMQTTReconnect =
  0;


// =====================================================
// Intervals
// =====================================================

const unsigned long SENSOR_INTERVAL =
  2500;

const unsigned long MQTT_PUBLISH_INTERVAL =
  5000;

const unsigned long WIFI_RECONNECT_INTERVAL =
  10000;

const unsigned long MQTT_RECONNECT_INTERVAL =
  5000;


// =====================================================
// Pending Relay Command
// =====================================================

enum RelayCommand {

  RELAY_CMD_NONE,

  RELAY_CMD_ON,

  RELAY_CMD_OFF
};

volatile RelayCommand
  pendingRelayCommand =
    RELAY_CMD_NONE;


// =====================================================
// MQTT Client ID
// =====================================================

String getMQTTClientId() {

  String clientId =
    "ESP32-";

  String mac =
    WiFi.macAddress();

  mac.replace(
    ":",
    ""
  );

  clientId +=
    mac;

  return clientId;
}


// =====================================================
// Read DHT
// =====================================================

void readSensor() {

  float newHumidity =
    dht.readHumidity();

  float newTemperature =
    dht.readTemperature();


  if (
    isnan(newHumidity) ||
    isnan(newTemperature)
  ) {

    Serial.println(
      "DHT read failed"
    );

    sensorValid =
      false;

    return;
  }


  humidity =
    newHumidity;

  temperature =
    newTemperature;

  sensorValid =
    true;


  Serial.print(
    "Temperature: "
  );

  Serial.print(
    temperature,
    1
  );

  Serial.print(
    " C"
  );


  Serial.print(
    " | Humidity: "
  );

  Serial.print(
    humidity,
    1
  );

  Serial.println(
    " %"
  );
}


// =====================================================
// Publish Relay State
// =====================================================

void publishRelayState() {

  if (
    !mqttClient.connected()
  ) {

    return;
  }


  const char* state =
    relayState
    ? "ON"
    : "OFF";


  // Retain = true
  // QoS   = 1

  mqttClient.publish(
    TOPIC_RELAY_STATE,
    state,
    true,
    1
  );


  Serial.print(
    "MQTT Relay State: "
  );

  Serial.println(
    state
  );
}


// =====================================================
// Publish Sensor JSON
// =====================================================

void publishSensorData() {

  if (
    !mqttClient.connected()
  ) {

    return;
  }


  if (
    !sensorValid
  ) {

    Serial.println(
      "Skip MQTT publish: sensor invalid"
    );

    return;
  }


  char json[
    192
  ];


  snprintf(
    json,
    sizeof(json),

    "{"
      "\"temperature\":%.1f,"
      "\"humidity\":%.1f,"
      "\"relay\":%s,"
      "\"rssi\":%d"
    "}",

    temperature,
    humidity,

    relayState
      ? "true"
      : "false",

    WiFi.RSSI()
  );


  // Sensor:
  // Retain = false
  // QoS   = 0

  bool ok =
    mqttClient.publish(
      TOPIC_SENSOR,
      json,
      false,
      0
    );


  Serial.print(
    "Publish "
  );

  Serial.print(
    TOPIC_SENSOR
  );

  Serial.print(
    " : "
  );

  Serial.println(
    json
  );


  if (
    !ok
  ) {

    Serial.println(
      "MQTT publish failed"
    );
  }
}


// =====================================================
// MQTT Message Callback
// =====================================================

void messageReceived(
  String &topic,
  String &payload
) {

  Serial.println();

  Serial.print(
    "MQTT Message"
  );

  Serial.println();


  Serial.print(
    "Topic   : "
  );

  Serial.println(
    topic
  );


  Serial.print(
    "Payload : "
  );

  Serial.println(
    payload
  );


  // ---------------------------------------------------
  // Relay Control
  // ---------------------------------------------------

  if (
    topic ==
    TOPIC_RELAY_SET
  ) {

    payload.trim();

    payload.toUpperCase();


    if (
      payload == "ON" ||
      payload == "1"
    ) {

      pendingRelayCommand =
        RELAY_CMD_ON;
    }


    else if (
      payload == "OFF" ||
      payload == "0"
    ) {

      pendingRelayCommand =
        RELAY_CMD_OFF;
    }


    else {

      Serial.println(
        "Unknown relay command"
      );
    }
  }
}


// =====================================================
// Process Relay Command
// =====================================================

void processRelayCommand() {

  RelayCommand command =
    pendingRelayCommand;


  if (
    command ==
    RELAY_CMD_NONE
  ) {

    return;
  }


  pendingRelayCommand =
    RELAY_CMD_NONE;


  // ---------------------------------------------------
  // ON
  // ---------------------------------------------------

  if (
    command ==
    RELAY_CMD_ON
  ) {

    digitalWrite(
      RELAY_PIN,
      RELAY_ON
    );

    relayState =
      true;

    Serial.println(
      "Relay ON"
    );
  }


  // ---------------------------------------------------
  // OFF
  // ---------------------------------------------------

  else if (
    command ==
    RELAY_CMD_OFF
  ) {

    digitalWrite(
      RELAY_PIN,
      RELAY_OFF
    );

    relayState =
      false;

    Serial.println(
      "Relay OFF"
    );
  }


  // ---------------------------------------------------
  // Publish State
  // ---------------------------------------------------

  publishRelayState();
}


// =====================================================
// Connect Wi-Fi
// =====================================================

void connectWiFi() {

  if (
    WiFi.status() ==
    WL_CONNECTED
  ) {

    return;
  }


  Serial.println();

  Serial.print(
    "Connecting Wi-Fi: "
  );

  Serial.println(
    WIFI_SSID
  );


  WiFi.mode(
    WIFI_STA
  );


  WiFi.setAutoReconnect(
    true
  );


  WiFi.begin(
    WIFI_SSID,
    WIFI_PASSWORD
  );


  unsigned long start =
    millis();


  while (
    WiFi.status() !=
      WL_CONNECTED
    &&
    millis() - start <
      15000
  ) {

    delay(
      500
    );

    Serial.print(
      "."
    );
  }


  Serial.println();


  if (
    WiFi.status() ==
    WL_CONNECTED
  ) {

    Serial.println(
      "Wi-Fi Connected"
    );


    Serial.print(
      "IP Address: "
    );

    Serial.println(
      WiFi.localIP()
    );


    Serial.print(
      "MAC: "
    );

    Serial.println(
      WiFi.macAddress()
    );
  }


  else {

    Serial.println(
      "Wi-Fi connection failed"
    );
  }
}


// =====================================================
// Connect MQTT
// =====================================================

bool connectMQTT() {

  if (
    WiFi.status() !=
    WL_CONNECTED
  ) {

    return false;
  }


  if (
    mqttClient.connected()
  ) {

    return true;
  }


  String clientId =
    getMQTTClientId();


  Serial.println();

  Serial.print(
    "Connecting MQTT Broker: "
  );

  Serial.print(
    MQTT_HOST
  );

  Serial.print(
    ":"
  );

  Serial.println(
    MQTT_PORT
  );


  Serial.print(
    "Client ID: "
  );

  Serial.println(
    clientId
  );


  bool connected;


  // ---------------------------------------------------
  // MQTT Authentication
  // ---------------------------------------------------

  if (
    strlen(MQTT_USERNAME) >
    0
  ) {

    connected =
      mqttClient.connect(
        clientId.c_str(),
        MQTT_USERNAME,
        MQTT_PASSWORD
      );
  }


  else {

    connected =
      mqttClient.connect(
        clientId.c_str()
      );
  }


  // ---------------------------------------------------
  // Connect Success
  // ---------------------------------------------------

  if (
    connected
  ) {

    Serial.println(
      "MQTT Connected"
    );


    // -----------------------------------------------
    // Subscribe Relay Control
    // QoS = 1
    // -----------------------------------------------

    bool subscribed =
      mqttClient.subscribe(
        TOPIC_RELAY_SET,
        1
      );


    Serial.print(
      "Subscribe "
    );

    Serial.print(
      TOPIC_RELAY_SET
    );

    Serial.print(
      " : "
    );

    Serial.println(
      subscribed
      ? "OK"
      : "FAILED"
    );


    // -----------------------------------------------
    // Online Status
    // Retain = true
    // QoS = 1
    // -----------------------------------------------

    mqttClient.publish(
      TOPIC_STATUS,
      "online",
      true,
      1
    );


    // -----------------------------------------------
    // Current Relay State
    // -----------------------------------------------

    publishRelayState();


    return true;
  }


  // ---------------------------------------------------
  // Connect Failed
  // ---------------------------------------------------

  Serial.println(
    "MQTT Connection Failed"
  );


  return false;
}


// =====================================================
// Setup
// =====================================================

void setup() {

  Serial.begin(
    115200
  );


  delay(
    500
  );


  Serial.println();

  Serial.println(
    "ESP32 MQTT Smart Environment Controller"
  );


  // ---------------------------------------------------
  // Relay
  // ---------------------------------------------------

  pinMode(
    RELAY_PIN,
    OUTPUT
  );


  digitalWrite(
    RELAY_PIN,
    RELAY_OFF
  );


  relayState =
    false;


  // ---------------------------------------------------
  // DHT
  // ---------------------------------------------------

  dht.begin();


  // ---------------------------------------------------
  // Wi-Fi
  // ---------------------------------------------------

  connectWiFi();


  // ---------------------------------------------------
  // MQTT
  // ---------------------------------------------------

  mqttClient.begin(
    MQTT_HOST,
    MQTT_PORT,
    networkClient
  );


  mqttClient.onMessage(
    messageReceived
  );


  // ---------------------------------------------------
  // MQTT Last Will
  //
  // 若 ESP32 異常斷線:
  //
  // home/esp32/status
  // offline
  //
  // Retain = true
  // QoS = 1
  // ---------------------------------------------------

  mqttClient.setWill(
    TOPIC_STATUS,
    "offline",
    true,
    1
  );


  connectMQTT();


  // ---------------------------------------------------
  // First Sensor Read
  // ---------------------------------------------------

  delay(
    2000
  );


  readSensor();
}


// =====================================================
// Loop
// =====================================================

void loop() {

  // ---------------------------------------------------
  // MQTT Processing
  // ---------------------------------------------------

  mqttClient.loop();


  // ---------------------------------------------------
  // Process Pending Relay Command
  // ---------------------------------------------------

  processRelayCommand();


  unsigned long now =
    millis();


  // ---------------------------------------------------
  // Sensor Read
  // ---------------------------------------------------

  if (
    now -
    lastSensorTime
    >=
    SENSOR_INTERVAL
  ) {

    lastSensorTime =
      now;

    readSensor();
  }


  // ---------------------------------------------------
  // MQTT Sensor Publish
  // ---------------------------------------------------

  if (
    now -
    lastPublishTime
    >=
    MQTT_PUBLISH_INTERVAL
  ) {

    lastPublishTime =
      now;

    publishSensorData();
  }


  // ---------------------------------------------------
  // Wi-Fi Reconnect
  // ---------------------------------------------------

  if (
    WiFi.status() !=
    WL_CONNECTED
  ) {

    if (
      now -
      lastWiFiReconnect
      >=
      WIFI_RECONNECT_INTERVAL
    ) {

      lastWiFiReconnect =
        now;


      Serial.println(
        "Wi-Fi disconnected"
      );


      WiFi.reconnect();
    }
  }


  // ---------------------------------------------------
  // MQTT Reconnect
  // ---------------------------------------------------

  else if (
    !mqttClient.connected()
  ) {

    if (
      now -
      lastMQTTReconnect
      >=
      MQTT_RECONNECT_INTERVAL
    ) {

      lastMQTTReconnect =
        now;


      Serial.println(
        "MQTT disconnected"
      );


      connectMQTT();
    }
  }


  delay(
    2
  );
}

三十七、程式需要修改的地方

首先修改 Wi-Fi:

const char* WIFI_SSID =
  "YOUR_WIFI_SSID";

const char* WIFI_PASSWORD =
  "YOUR_WIFI_PASSWORD";

例如:

const char* WIFI_SSID =
  "Jason_WIFI";

const char* WIFI_PASSWORD =
  "12345678";

三十八、修改 MQTT Broker IP

假設 Mosquitto Server:

192.168.1.10

設定:

const char* MQTT_HOST =
  "192.168.1.10";

Port:

const int MQTT_PORT =
  1883;

請不要直接照抄範例 IP。

應該改成自己 Mosquitto 主機的:

LAN IP Address

三十九、如果 Mosquitto 有帳號密碼

例如:

Username:
esp32

Password:
your_password

改:

const char* MQTT_USERNAME =
  "esp32";

const char* MQTT_PASSWORD =
  "your_password";

如果目前只是實驗室 LAN 測試、Broker 沒有 Authentication:

const char* MQTT_USERNAME = "";
const char* MQTT_PASSWORD = "";

四十、Serial Monitor 執行結果

ESP32 開機後可能看到:

ESP32 MQTT Smart Environment Controller

Connecting Wi-Fi: Jason_WIFI
.....

Wi-Fi Connected

IP Address: 192.168.1.105
MAC: 24:6F:28:12:34:56

Connecting MQTT Broker:
192.168.1.10:1883

Client ID:
ESP32-246F28123456

MQTT Connected

Subscribe home/relay/set : OK

MQTT Relay State: OFF

Temperature: 27.5 C | Humidity: 63.0 %

Publish home/esp32/sensor :
{"temperature":27.5,"humidity":63.0,"relay":false,"rssi":-51}

之後每:

5 秒

發布一次 Sensor JSON。

四十一、使用 mosquitto_sub 監看 ESP32

在安裝 Mosquitto Client Tools 的電腦執行:

mosquitto_sub \
  -h 192.168.1.10 \
  -t "home/#" \
  -v

mosquitto_sub 是官方提供的 MQTT Subscribe command-line client,而 -v 可以同時顯示 Topic 與 Payload。

畫面可能看到:

home/esp32/status online

home/relay/state OFF

home/esp32/sensor {"temperature":27.5,"humidity":63.0,"relay":false,"rssi":-51}

home/esp32/sensor {"temperature":27.6,"humidity":63.0,"relay":false,"rssi":-52}

四十二、使用 mosquitto_pub 控制 Relay ON

電腦執行:

mosquitto_pub \
  -h 192.168.1.10 \
  -t "home/relay/set" \
  -m "ON" \
  -q 1

mosquitto_pub 可以指定 Topic、Payload 與 QoS;Mosquitto 官方目前支援 -q 0、1、2。

資料流程:

PC
 │
 │ Publish
 │
 │ Topic:
 │ home/relay/set
 │
 │ Payload:
 │ ON
 ▼
Mosquitto
 │
 │ Forward
 ▼
ESP32
 │
 ▼
Relay ON

Serial Monitor:

MQTT Message

Topic   : home/relay/set
Payload : ON

Relay ON

MQTT Relay State: ON

四十三、關閉 Relay

執行:

mosquitto_pub \
  -h 192.168.1.10 \
  -t "home/relay/set" \
  -m "OFF" \
  -q 1

ESP32:

Relay OFF

然後 Publish:

home/relay/state
OFF

四十四、也可以使用 1 / 0

本章 Callback 同時接受:

ON
OFF

以及:

1
0

因此:

mosquitto_pub \
  -h 192.168.1.10 \
  -t "home/relay/set" \
  -m "1"

等同:

Relay ON

而:

mosquitto_pub \
  -h 192.168.1.10 \
  -t "home/relay/set" \
  -m "0"

等同:

Relay OFF

四十五、如果 Broker 有帳號密碼

Subscribe:

mosquitto_sub \
  -h 192.168.1.10 \
  -u esp32 \
  -P your_password \
  -t "home/#" \
  -v

Publish:

mosquitto_pub \
  -h 192.168.1.10 \
  -u esp32 \
  -P your_password \
  -t "home/relay/set" \
  -m "ON" \
  -q 1

Mosquitto command-line clients 目前均提供 Username / Password 參數。

四十六、Topic Wildcard:# 是什麼?

剛才我們用了:

home/#

其中:

#

是 MQTT Multi-level Wildcard。

意思:

所有 home/ 底下的 Topic

例如:

home/esp32/sensor
home/esp32/status
home/relay/set
home/relay/state
home/livingroom/light
home/bedroom/temperature

全部都可以收到。

四十七、+ Wildcard 是什麼?

另一個 MQTT Wildcard:

+

代表:

一層

例如:

home/+/temperature

可以匹配:

home/livingroom/temperature
home/bedroom/temperature
home/kitchen/temperature

但不匹配:

home/livingroom/sensor/temperature

因為層數不同。

四十八、好的 MQTT Topic 應該如何規劃?

如果未來有多台 ESP32,不建議全部使用:

home/esp32/sensor

可以改成:

home/livingroom/esp32-01/sensor

home/bedroom/esp32-02/sensor

home/serverroom/esp32-03/sensor

控制:

home/livingroom/esp32-01/relay/set

狀態:

home/livingroom/esp32-01/relay/state

這樣比較容易擴充。

四十九、更完整的 Topic 架構

例如:

home/
 │
 ├── livingroom/
 │     │
 │     └── esp32-01/
 │           │
 │           ├── sensor
 │           │
 │           ├── status
 │           │
 │           └── relay/
 │                 ├── set
 │                 └── state
 │
 └── bedroom/
       │
       └── esp32-02/

這已經非常接近真正 IoT 系統。

五十、MQTT 與 HTTP 最大的差異

HTTP:

Phone
 │
 │ GET
 ▼
ESP32

Client 必須直接找到 Server。

MQTT:

Phone
   \
    \
     ▼
    Broker
     ▲
    /
   /
ESP32

兩邊只需要知道:

Broker Address

彼此不需要知道對方的:

IP Address

五十一、MQTT 解決什麼問題?

假設有:

100 台 ESP32

如果使用 HTTP Direct Control:

ESP32 #1 → IP
ESP32 #2 → IP
ESP32 #3 → IP
...
ESP32 #100 → IP

管理會越來越麻煩。

MQTT:

100 ESP32
    │
    ▼
1 MQTT Broker

然後依:

Topic

管理。

五十二、Publisher 不需要知道 Subscriber 是誰

例如 ESP32 Publish:

home/esp32/sensor

ESP32 完全不用知道:

有沒有手機?
有沒有 Raspberry Pi?
有沒有 Node-RED?
有沒有 Database?

它只需要:

Publish

Broker 自己處理後面的 Subscriber。

這叫:

Loose Coupling

也就是系統之間:

降低直接耦合。

五十三、同一個 Topic 可以有多個 Subscriber

例如:

ESP32
 │
 │ home/esp32/sensor
 ▼
Broker
 │
 ├──► Home Assistant
 │
 ├──► Node-RED
 │
 ├──► Raspberry Pi
 │
 ├──► Database
 │
 └──► MQTT Explorer

ESP32 只 Publish 一次。

Broker 可以分送給很多 Client。

這就是 MQTT 非常適合 IoT 的重要原因。

五十四、Retained Message 很適合「狀態」

適合 Retain:

Relay State
Device Status
Operating Mode
Last Setpoint

例如:

home/relay/state
ON

不一定適合 Retain:

每秒 Sensor Streaming Data
Button Event
Alarm Event History

因為 Retain 的功能不是建立歷史資料庫。

它只是保存:

該 Topic 最後一筆 retained value。

五十五、MQTT Broker 不是資料庫

這也是非常重要的觀念。

MQTT Broker:

負責訊息傳遞

Database:

負責歷史資料保存

真正完整架構:

ESP32
 │
 ▼
MQTT Broker
 │
 ▼
Subscriber
 │
 ▼
Database

例如:

ESP32
↓
Mosquitto
↓
Node-RED
↓
InfluxDB
↓
Grafana

五十六、DHT11 Sensor 資料可以存到 Database

現在 ESP32 Publish:

{
  "temperature":27.5,
  "humidity":63.0
}

未來 Raspberry Pi / Server Subscribe:

home/esp32/sensor

收到 JSON 後寫入:

MySQL
MariaDB
SQLite
InfluxDB
PostgreSQL

就可以做:

1 Hour
24 Hours
7 Days
30 Days

歷史趨勢分析。

五十七、MQTT + Node-RED

MQTT 很常搭配:

Node-RED

架構:

ESP32
 │
 ▼
Mosquitto
 │
 ▼
Node-RED
 │
 ├── Dashboard
 ├── Database
 ├── Alarm
 └── Automation

Node-RED 不需要直接連 ESP32。

只需要:

Subscribe Topic

五十八、MQTT + Home Assistant

智慧家庭也很適合:

ESP32
 │
 ▼
MQTT Broker
 │
 ▼
Home Assistant

例如:

Temperature
Humidity
Relay
Door Sensor
Light
Fan

都可以經 MQTT 整合。

五十九、MQTT + Raspberry Pi

Raspberry Pi 可以直接安裝:

Mosquitto Broker

架構:

ESP32
 │
 │ Wi-Fi
 ▼
Raspberry Pi
 │
 ├── Mosquitto
 ├── Node-RED
 ├── Database
 └── Dashboard

這是一套非常實用的:

Local IoT Server

六十、Wi-Fi 斷線後怎麼辦?

本章程式不會只在:

setup()

連一次 Wi-Fi。

而是在 loop() 持續檢查:

WiFi.status()

如果斷線:

WiFi.reconnect();

讓系統具備:

Connection Recovery

六十一、MQTT Broker 重新啟動怎麼辦?

假設:

Mosquitto Restart

ESP32 的 MQTT Connection 會消失。

本程式每:

5 秒

檢查:

mqttClient.connected()

如果失敗:

connectMQTT();

再次連線。

六十二、為什麼 MQTT 重連後要重新 Subscribe?

因為重新建立 Session 後,不能假設之前的 Subscription 一定存在。

因此:

connectMQTT()

成功後重新:

mqttClient.subscribe(
  TOPIC_RELAY_SET,
  1
);

這樣 Broker 重開後 ESP32 還能繼續收 Relay Command。

六十三、MQTT loop() 非常重要

程式:

mqttClient.loop();

需要頻繁執行。

它負責:

接收 MQTT Packet
處理 Keep Alive
接收 Publish
處理 MQTT Protocol

目前 arduino-mqtt 官方 API 也明確要求 loop() 在 Arduino loop() 中持續呼叫。

所以不要寫:

delay(30000);

把 MQTT Client 卡住太久。

六十四、Sensor Timer 也使用 millis()

本章:

DHT Read
=
2.5 秒

MQTT Publish:

5 秒

利用:

millis()

而不是:

delay(5000);

這樣 ESP32 可以同時:

MQTT
Sensor
Relay
Wi-Fi

非阻塞運作。

六十五、本章資料流:Sensor Upload

DHT11
 │
 │ Temperature / Humidity
 ▼
ESP32
 │
 ▼
readSensor()
 │
 ▼
JSON
 │
 ▼
MQTT Publish
 │
 ▼
home/esp32/sensor
 │
 ▼
Mosquitto Broker
 │
 ├──► MQTT Explorer
 ├──► Raspberry Pi
 ├──► Node-RED
 └──► Database

六十六、本章資料流:Relay Control

PC / Phone
 │
 │ Publish
 │
 │ Topic:
 │ home/relay/set
 │
 │ Payload:
 │ ON
 ▼
MQTT Broker
 │
 ▼
ESP32 Subscriber
 │
 ▼
messageReceived()
 │
 ▼
pendingRelayCommand
 │
 ▼
processRelayCommand()
 │
 ▼
GPIO 26
 │
 ▼
Relay ON
 │
 ▼
Publish State
 │
 ▼
home/relay/state
 │
 ▼
Broker

六十七、本章完整 IoT 架構

MQTT Clients
         ┌─────────────┼─────────────┐
         │             │             │
         ▼             ▼             ▼
       Phone       Raspberry Pi    PC
         │             │             │
         └─────────────┼─────────────┘
                       │
                       ▼
                MQTT Mosquitto
                    Broker
                       │
             ┌─────────┴─────────┐
             │                   │
             ▼                   ▼
    home/esp32/sensor      home/relay/set
             ▲                   │
             │                   ▼
          Publish             Subscribe
             │                   │
             └────────┬──────────┘
                      │
                      ▼
                    ESP32
                      │
             ┌────────┴────────┐
             │                 │
             ▼                 ▼
           DHT11             Relay
             │                 │
             ▼                 ▼
       Temperature          ON / OFF
       Humidity

六十八、MQTT Security 很重要

本章為了教學方便使用:

MQTT TCP
Port 1883

如果只是在可信任:

家庭 LAN
實驗室 LAN

可以先用於學習。

但正式系統不要把未加密的:

1883

直接公開到 Internet。

Mosquitto 官方文件也明確建議,除了最基本測試之外,應使用 TLS 加密連線。

六十九、正式 MQTT 建議

正式環境至少考慮:

Username
Password
ACL
TLS
Firewall
Unique Client ID
Topic Permission

架構:

ESP32
 │
 │ TLS
 │ Port 8883
 ▼
MQTT Broker

而不是:

Internet
 │
 ▼
Anonymous MQTT 1883

七十、MQTT ACL 是什麼?

ACL:

Access Control List

例如:

ESP32-01

只能:

Publish:
home/esp32-01/#

Subscribe:
home/esp32-01/relay/set

不能隨便:

Subscribe:
#

看到所有設備。

正式多裝置 IoT 系統應該設計這種權限。

七十一、Client ID 也不能當 Password

Client ID:

ESP32-246F28123456

主要用途是:

識別 MQTT Client

不是秘密。

不要把:

Client ID

當作真正的 Authentication。

仍然應該使用:

Username
Password
TLS Certificate

等安全機制。

七十二、MQTT 與 Web Server 可以同時存在嗎?

可以。

例如:

ESP32
 │
 ├── Web Server
 │      │
 │      └── Local Dashboard
 │
 └── MQTT Client
        │
        └── IoT Broker

本地控制:

手機
↓
HTTP
↓
ESP32

遠端系統:

ESP32
↓
MQTT
↓
Broker

兩套系統可以同時使用。

七十三、BLE + Wi-Fi + MQTT 也能一起整合

甚至可以:

BLE
↓
設定 Wi-Fi

Wi-Fi
↓
連 MQTT

MQTT
↓
正常 IoT Operation

完整產品流程:

第一次開機
   │
   ▼
BLE Provisioning
   │
   ▼
手機輸入 SSID / Password
   │
   ▼
ESP32 Wi-Fi
   │
   ▼
MQTT Broker
   │
   ▼
Cloud / Server

這就開始接近真正 IoT 商品。

七十四、MQTT Topic 不要亂設計

不建議:

temp

因為多設備後不知道:

哪裡的 temp?
哪一台 ESP32?
哪一個 Sensor?

比較好:

home/livingroom/esp32-01/temperature

或:

factory/line1/machine03/temperature

Topic 本身就是 IoT 系統設計的一部分。

七十五、Payload 也應保持一致

不要某台:

ON

另一台:

1

另一台:

TRUE

正式系統應統一格式。

例如 Relay Control:

{
  "state":"ON"
}

或簡單固定:

ON
OFF

本章為教學方便,同時接受:

ON / OFF
1 / 0

七十六、JSON 可以繼續增加資料

目前:

{
  "temperature":27.5,
  "humidity":63.0,
  "relay":false,
  "rssi":-51
}

後面可以變成:

{
  "device":"esp32-01",
  "temperature":27.5,
  "humidity":63.0,
  "relay":false,
  "rssi":-51,
  "alarm":false,
  "uptime":123456
}

甚至增加:

timestamp
firmware version
IP address
sensor status

七十七、ESP32 MQTT 常見問題

Q1:ESP32 Wi-Fi 連上,但 MQTT 連不上?

檢查:

Broker IP
Port
Username
Password
Firewall
Mosquitto 是否正在執行

Q2:192.168.1.10 一定是 Broker IP 嗎?

不是。

這只是本章範例。

需要改成自己的:

Mosquitto Server IP

Q3:Broker 位址可以填本機回環主機名稱嗎?

不可以。對 ESP32 而言,本機回環主機名稱指向 ESP32 自己,而不是執行 Mosquitto 的 Windows 或 Raspberry Pi。應填入 MQTT Broker 在區域網路中的 IP Address。

Q4:Relay 收不到指令?

先監控:

mosquitto_sub \
  -h 192.168.1.10 \
  -t "home/relay/set" \
  -v

然後再:

mosquitto_pub \
  -h 192.168.1.10 \
  -t "home/relay/set" \
  -m "ON"

先確認 Broker 真的收到訊息。

Q5:DHT 顯示 Sensor Invalid?

檢查:

VCC
GND
DATA
GPIO 4
DHT_TYPE
Pull-up

Q6:Relay ON / OFF 相反?

你的 Relay 可能是:

Active HIGH

將:

#define RELAY_ON  LOW
#define RELAY_OFF HIGH

改為:

#define RELAY_ON  HIGH
#define RELAY_OFF LOW

七十八、MQTT 常用術語整理

MQTT 常用術語整理
名詞 意義
MQTT IoT 訊息協定
Broker 訊息交換中心
Client MQTT 連線裝置
Publisher 發布資料
Subscriber 訂閱資料
Topic 訊息分類路徑
Payload 訊息內容
QoS 訊息服務品質
Retain Broker 保存最後訊息
LWT 異常離線訊息
JSON 結構化資料格式
Mosquitto MQTT Broker
MQTT Client ID Client 識別名稱

七十九、QoS 整理

MQTT QoS 等級比較
QoS 意義 特性 適合用途
0 At most once 最快 Sensor
1 At least once 至少一次、可能重複 Control / State
2 Exactly once 最可靠、負擔最高 特殊重要交易

本章:

Sensor
→ QoS 0

而:

Relay Control
→ QoS 1

是一個相當合理的 IoT 教學配置。

八十、本章 MQTT Topic 整理

home/esp32/sensor

用途:

ESP32 Sensor JSON
home/relay/set

用途:

Relay Command
home/relay/state

用途:

Relay Current State
home/esp32/status

用途:

online
offline

八十一、本章測試命令整理

監控所有 Home Topic:

mosquitto_sub \
  -h 192.168.1.10 \
  -t "home/#" \
  -v

Relay ON:

mosquitto_pub \
  -h 192.168.1.10 \
  -t "home/relay/set" \
  -m "ON" \
  -q 1

Relay OFF:

mosquitto_pub \
  -h 192.168.1.10 \
  -t "home/relay/set" \
  -m "OFF" \
  -q 1

只監看 Sensor:

mosquitto_sub \
  -h 192.168.1.10 \
  -t "home/esp32/sensor" \
  -v

只監看 Relay:

mosquitto_sub \
  -h 192.168.1.10 \
  -t "home/relay/#" \
  -v

八十二、第 11~15 章已經形成完整 ESP32 IoT 路線

第 11 章

ESP32
↓
Wi-Fi
↓
Router

第 12 章

Browser
↓
HTTP
↓
ESP32 Web Server
↓
LED / Relay

第 13 章

DHT11
↓
Sensor API
↓
JSON
↓
Web Dashboard

第 14 章

Phone
↓
Bluetooth / BLE
↓
ESP32

第 15 章

DHT11
↓
ESP32
↓
Wi-Fi
↓
MQTT
↓
Broker
↓
IoT System

到了這一章,ESP32 已經正式具備:

Sensor
+
Actuator
+
Wi-Fi
+
Bluetooth
+
HTTP
+
JSON
+
MQTT

完整 IoT Node 的核心能力。

八十三、本章真正重要的架構觀念

不要只把這一章理解為:

ESP32 把 DHT11 傳到 Mosquitto。

真正重要的是:

Device
   │
   ▼
MQTT Client
   │
   ▼
Broker
   │
   ├── Subscriber A
   ├── Subscriber B
   ├── Subscriber C
   └── Subscriber D

ESP32 已經從:

單機控制器

進化成:

Distributed IoT System Node

也就是:

分散式 IoT 系統中的一個節點。

八十四、本章重點整理

學完本章後,應該理解:

1. MQTT 使用 Publish / Subscribe

Publisher
↓
Broker
↓
Subscriber

2. Broker 是 MQTT 核心

本章使用:

Mosquitto

3. ESP32 是 MQTT Client

而且可以同時:

Publisher
+
Subscriber

4. Topic 用來分類訊息

例如:

home/relay/set

5. Payload 是真正資料

例如:

ON

6. Sensor 適合使用 JSON

{
  "temperature":27.5,
  "humidity":63
}

7. QoS 有 0 / 1 / 2

不同資料可以使用不同可靠度。

8. Retain 適合保存目前狀態

例如:

Relay State

9. LWT 可以判斷設備是否異常 Offline

例如:

home/esp32/status

10. Wi-Fi 與 MQTT 都需要斷線恢復

真正 IoT 裝置必須考慮:

Reconnect

而不是只能開機成功一次。

八十五、結語

第 15 章是 ESP32 教材非常重要的一個分水嶺。

前面的 Web Server:

Phone
↓
ESP32

還是比較偏向:

Point-to-Point Control

到了 MQTT:

ESP32
 │
 ▼
Broker
 │
 ├── Phone
 ├── Server
 ├── Raspberry Pi
 ├── Database
 └── Home Assistant

ESP32 已經正式進入:

IoT Messaging Architecture

本章完成的:

ESP32 MQTT 智慧溫溼度控制器

具有完整的雙向資料流。

Sensor Upload:

DHT11
↓
ESP32
↓
JSON
↓
MQTT Publish
↓
Mosquitto Broker

遠端控制:

MQTT Client
↓
home/relay/set
↓
Broker
↓
ESP32 Subscriber
↓
Relay

狀態回報:

Relay
↓
ESP32
↓
home/relay/state
↓
Broker

設備生命狀態:

online
offline

則透過:

MQTT Last Will

管理。

因此現在的 ESP32 已經不是只有:

GPIO
Sensor
Wi-Fi

而是完整具備:

ESP32
+
Sensor
+
Actuator
+
Wi-Fi
+
MQTT
+
JSON
+
Broker
+
Publish
+
Subscribe
+
QoS
+
Remote Control

的:

ESP32 IoT Device。

下一個階段就可以進一步將 MQTT 與:

Node-RED
Database
Grafana
Home Assistant
Cloud

整合,真正建立完整的 ESP32 IoT Monitoring & Automation Platform。

🧪 ESP32 實作課程

ESP32 第 15 章相關實驗

讀完技術原理後,前往威棋實作教材中心,跟著教材進行接線、程式撰寫與實際測試。

前往第 15 章實驗 →
下一步學習

不要停在這一篇,接著把內容做成自己的實作

目前主題:ESP32 / IoT。從完整學習路線、免費資源、會員下載,再接到實作所需材料。

同系列:ESP32 |  已是會員?直接前往 Getfile
相關資源與會員文章下載
文章可免費閱讀;下載完整 DOCX 或 PDF 需登入免費基本會員。
查看相關資源 會員免費下載 DOCX 會員免費 PDF/列印

← 回文章列表