第13章 ESP32 Web Server DHT11 完整教學:網頁即時顯示溫溼度與 Web Dashboard

發布日期: |更新日期:
文章主圖:第13章 ESP32 Web Server DHT11 完整教學:網頁即時顯示溫溼度與 Web Dashboard

在第 12 章,我們已經完成:

ESP32 Web Server + 手機控制 LED 與 Relay

手機瀏覽器可以透過 HTTP GET 控制 GPIO,讓 ESP32 從單純的微控制器進一步成為可以接受網路指令的 Web Server。

但第 12 章的網頁還有一個明顯限制:

每次按下按鈕,都需要重新載入整個 HTML 網頁。

真正的 IoT Dashboard 不應該一直重新整理整張網頁。

例如我們希望手機畫面持續顯示:

Temperature : 27.5 °C
Humidity    : 63 %
Relay       : OFF
WiFi RSSI   : -51 dBm

而且數值可以:

27.5°C
   ↓
27.7°C
   ↓
27.8°C

自動更新。

這時就需要加入:

  • HTML
  • CSS
  • JavaScript
  • Fetch API
  • AJAX
  • JSON
  • Sensor API

本章將把 ESP32 Web Server 進一步升級成真正的:

ESP32 Web 溫溼度監控站

ESP32 負責讀取 DHT11 / DHT22 感測器,再透過 HTTP API 提供 JSON 資料;手機瀏覽器則利用 JavaScript fetch() 定時讀取資料,做到:

網頁不重新整理,溫度、濕度、Relay 與 Wi-Fi RSSI 仍然會自動更新。

這就是現代 Web IoT Dashboard 的基本架構。

一、本章完成後的系統

本章實作的整體架構如下:

DHT11 / DHT22
      │
      │ Temperature
      │ Humidity
      ▼
    ESP32
      │
      ├── GPIO
      │     │
      │     └── Relay
      │
      ├── Wi-Fi RSSI
      │
      └── Web Server
             │
             ├── /
             │    └── HTML + CSS + JavaScript
             │
             └── /api/sensor
                    │
                    └── JSON
                         │
                         ▼
                       Wi-Fi
                         │
                         ▼
                    手機瀏覽器
                         │
                         ▼
                    Web Dashboard

手機畫面會顯示:

ESP32 Environment Monitor

Temperature
27.5 °C

Humidity
63 %

Relay
OFF

WiFi RSSI
-51 dBm

而且每隔數秒自動更新。

二、本章學習重點

這一章會把 ESP32 硬體與 Web 技術真正整合在一起。

需要理解:

ESP32 Web 溫溼度監控站使用技術
技術 作用
DHT11 / DHT22 取得溫度、濕度
WiFi.h ESP32 連接 Wi-Fi
WebServer.h 建立 HTTP Server
HTML 建立 Dashboard 結構
CSS 設計手機介面
JavaScript 控制網頁行為
Fetch API 向 ESP32 要資料
AJAX 不刷新頁面的資料交換概念
JSON ESP32 與網頁交換資料
Sensor API 提供感測器資料
millis() 非阻塞定時讀取
GPIO 控制 Relay

三、DHT11 與 DHT22 是什麼?

DHT11 與 DHT22 都是非常常見的:

數位溫溼度感測器。

一個模組就可以同時讀取:

Temperature
+
Humidity

因此非常適合:

  • ESP32 環境監測
  • 智慧家庭
  • 機房監控
  • 溫室
  • 倉庫
  • 教室
  • 實驗室
  • IoT Sensor Node

四、DHT11 與 DHT22 的差異

兩者最大的差別是:

DHT22 的量測範圍與精度通常比 DHT11 更好。

可以簡單比較:

DHT11 與 DHT22 規格比較
項目 DHT11 DHT22
溫度範圍 約 0~50°C 約 -40~80°C
溫度精度 約 ±2°C 約 ±0.5°C
濕度範圍 約 20~80% RH 約 0~100% RH
精度 較低 較高
價格 較低 較高
入門教學 很適合 很適合
環境監測 可用 更推薦

如果只是第一次學習:

DHT11 已經足夠。

如果未來要建立比較完整的:

ESP32 IoT 環境監測系統

則比較建議:

DHT22。

五、本章使用的 Library

本章使用:

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

其中:

WiFi.h

負責:

Wi-Fi
SSID
Password
IP Address
RSSI

WebServer.h

負責:

HTTP Server
URL Route
HTTP Request
HTTP Response

DHT.h

負責:

DHT11
DHT22
Temperature
Humidity

Adafruit 目前仍維護其 DHT Sensor Library,支援 DHT11、DHT22 等 DHT 系列感測器,並可從 Arduino Library Manager 安裝。

六、安裝 DHT Sensor Library

Arduino IDE:

Sketch
→ Include Library
→ Manage Libraries

搜尋:

DHT sensor library

選擇:

DHT sensor library
by Adafruit

安裝。

如果 Library Manager 提示相依套件,也安裝:

Adafruit Unified Sensor

Adafruit 官方 DHT Library 的說明也列出 Adafruit Unified Sensor Driver 為其相依套件。

七、DHT11 / DHT22 接線

本章將 DHT DATA 連接:

GPIO 4

程式設定:

#define DHT_PIN 4

DHT 模組版接線

如果購買的是常見三腳 DHT11 / DHT22 Module:

DHT11/DHT22 Module 與 ESP32 接線表
DHT Module ESP32
VCC 3.3V
DATA GPIO 4
GND GND

接線:

ESP32               DHT11 / DHT22
─────                ─────────────
3.3V  ─────────────► VCC

GPIO4 ─────────────► DATA

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

八、如果是裸 DHT Sensor

若不是 Module,而是四腳裸感測器,一般還需要在:

VCC
  │
  └── 10KΩ ─── DATA

加入 Pull-up Resistor。

Adafruit 的目前範例也仍說明,可在 DATA 與電源之間加入約 10 kΩ 的上拉電阻。

九、選擇 DHT11 或 DHT22

如果使用:

DHT11

程式:

#define DHT_TYPE DHT11

如果使用:

DHT22

改成:

#define DHT_TYPE DHT22

然後建立物件:

DHT dht(DHT_PIN, DHT_TYPE);

十、DHT Sensor 基本程式

單純讀取 DHT 的程式如下:

#include <DHT.h>

#define DHT_PIN 4
#define DHT_TYPE DHT11

DHT dht(DHT_PIN, DHT_TYPE);

void setup() {

  Serial.begin(115200);

  dht.begin();
}

void loop() {

  float temperature =
    dht.readTemperature();

  float humidity =
    dht.readHumidity();

  Serial.print("Temperature: ");
  Serial.print(temperature);
  Serial.println(" °C");

  Serial.print("Humidity: ");
  Serial.print(humidity);
  Serial.println(" %");

  delay(2000);
}

Adafruit 官方範例目前同樣以:

dht.readTemperature();
dht.readHumidity();

取得 Celsius 溫度與相對濕度。

十一、為什麼不能瘋狂讀取 DHT?

DHT11 / DHT22 並不是高速 Sensor。

因此不能:

void loop() {

  dht.readTemperature();
  dht.readHumidity();
}

毫無間隔地一直讀。

DHT 系列本身更新速度比較慢,Adafruit 的 DHT 範例也使用約 2 秒的量測間隔,並指出感測值可能具有約數秒更新週期。

因此本章會設計:

每 2.5 秒

讀取一次 DHT。

十二、不要直接使用 delay(2500)

初學程式可能會寫:

delay(2500);

但是現在 ESP32 同時要執行:

Web Server
Sensor
Relay
Wi-Fi
HTTP Request

如果使用很長的:

delay()

Web Server 的反應會變差。

因此本章改用:

millis()

建立:

Non-blocking Timer

也就是:

非阻塞式定時讀取。

十三、使用 millis() 讀取 Sensor

例如:

unsigned long lastSensorRead = 0;

const unsigned long SENSOR_INTERVAL = 2500;

在 loop():

if (millis() - lastSensorRead >= SENSOR_INTERVAL) {

  lastSensorRead = millis();

  temperature =
    dht.readTemperature();

  humidity =
    dht.readHumidity();
}

這樣 ESP32 可以一邊讀 Sensor,一邊繼續:

server.handleClient();

處理網頁要求。

十四、什麼是 Web Dashboard?

Dashboard 可以翻譯為:

儀表板 / 資訊看板。

例如工廠可能有:

Temperature
Humidity
Pressure
Machine Status
Alarm
Production

顯示在一個畫面。

ESP32 也可以用 HTML 建立自己的:

Web Dashboard

例如:

┌──────────────────────────┐
│ ESP32 Environment Monitor│
├──────────────────────────┤
│ Temperature              │
│ 27.5 °C                  │
├──────────────────────────┤
│ Humidity                 │
│ 63 %                     │
├──────────────────────────┤
│ Relay                    │
│ OFF                      │
├──────────────────────────┤
│ WiFi RSSI                │
│ -51 dBm                  │
└──────────────────────────┘

十五、HTML 負責什麼?

HTML:

HyperText Markup Language

負責網頁:

內容與結構。

例如:

<h1>ESP32 Environment Monitor</h1>

<div>
  Temperature:
  <span id="temperature">--</span> °C
</div>

其中:

id="temperature"

非常重要。

JavaScript 後面可以透過:

document.getElementById("temperature")

找到這個位置並更新數值。

十六、CSS 負責什麼?

CSS:

Cascading Style Sheets

負責:

  • 顏色
  • 字體
  • 間距
  • Button
  • Card
  • Dashboard Layout
  • 手機 Responsive Design

例如:

.card {
  background: white;
  border-radius: 16px;
  padding: 20px;
}

就可以把 Sensor 顯示成卡片。

十七、JavaScript 負責什麼?

JavaScript 在本專案扮演非常重要的角色。

它負責:

定期向 ESP32 Request
        ↓
取得 JSON
        ↓
解析資料
        ↓
更新 HTML

例如:

document.getElementById("temperature").textContent =
  data.temperature;

網頁就可以把:

--

改成:

27.5

而不需要重新載入整個頁面。

十八、什麼是 AJAX?

AJAX:

Asynchronous JavaScript And XML

雖然名稱裡有 XML,但現代 Web 開發更常使用:

JSON

它的重點不是 XML。

真正重要的概念是:

網頁可以在背景和 Server 交換資料,而不用整頁重新整理。

十九、第 12 章與第 13 章的差異

第 12 章:

按 Button
   ↓
HTTP GET
   ↓
ESP32
   ↓
重新產生完整 HTML
   ↓
Browser Reload

第 13 章:

Browser
   │
   │ JavaScript Fetch
   ▼
Sensor API
   │
   ▼
JSON
   │
   ▼
JavaScript
   │
   ▼
只修改畫面數字

這是一個非常重要的進步。

二十、什麼是 Fetch API?

現代 JavaScript 可以使用:

fetch()

執行 HTTP Request。

例如:

fetch("/api/sensor")

代表:

向目前的 ESP32 Web Server 要求 /api/sensor。

然後:

fetch("/api/sensor")
  .then(response => response.json())

把 Response 解析成 JSON。

二十一、什麼是 Sensor API?

我們在 ESP32 建立一個網址:

/api/sensor

這個 URL 不回傳 HTML。

它只回傳:

Sensor Data。

例如手機訪問:

http://192.168.1.105/api/sensor

ESP32 回傳:

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

這就是一個非常簡單的:

ESP32 Sensor API

二十二、什麼是 JSON?

JSON:

JavaScript Object Notation

是一種非常常用的資料交換格式。

例如:

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

它非常適合:

ESP32
↕
Browser

ESP32
↕
App

ESP32
↕
Server

ESP32
↕
Cloud

之間交換資料。

二十三、JSON 各欄位代表什麼?

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

對應:

Sensor API JSON 欄位說明
JSON Key 意義
temperature 溫度
humidity 濕度
relay Relay 狀態
rssi Wi-Fi RSSI

其中:

"relay": false

代表:

Relay OFF

而:

"relay": true

代表:

Relay ON

二十四、建立 ESP32 Sensor API

ESP32 程式建立:

server.on(
  "/api/sensor",
  HTTP_GET,
  handleSensorApi
);

因此當 Browser 要求:

GET /api/sensor

就執行:

handleSensorApi();

二十五、產生 JSON

例如:

void handleSensorApi() {

  String json = "{";

  json += "\"temperature\":";
  json += String(temperature, 1);

  json += ",";

  json += "\"humidity\":";
  json += String(humidity, 1);

  json += ",";

  json += "\"relay\":";
  json += relayState ? "true" : "false";

  json += ",";

  json += "\"rssi\":";
  json += String(WiFi.RSSI());

  json += "}";

  server.send(
    200,
    "application/json",
    json
  );
}

注意 Response Type:

application/json

而不是:

text/html

因為這次送的是 JSON。

二十六、HTML 如何取得 Sensor API?

JavaScript:

async function updateData() {

  const response =
    await fetch("/api/sensor");

  const data =
    await response.json();

}

這兩行的意義是:

ESP32 /api/sensor
        ↓
HTTP Response
        ↓
JSON
        ↓
JavaScript Object

二十七、如何把 JSON 放到網頁?

例如:

document.getElementById("temperature").textContent =
  data.temperature.toFixed(1);

原本 HTML:

<span id="temperature">--</span>

就會變成:

27.5

濕度:

document.getElementById("humidity").textContent =
  data.humidity.toFixed(1);

RSSI:

document.getElementById("rssi").textContent =
  data.rssi;

二十八、如何自動更新?

JavaScript 提供:

setInterval()

例如:

setInterval(updateData, 3000);

代表:

每 3000 ms
=
每 3 秒

執行一次:

updateData();

因此手機 Dashboard 會:

自動 Request
      ↓
JSON
      ↓
更新 Sensor Data

二十九、為什麼 Browser 更新 3 秒,而 DHT 讀取 2.5 秒?

這是刻意設計的。

ESP32:

每 2.5 秒
讀一次真正的 DHT

手機:

每 3 秒
向 ESP32 要一次最新值

Browser 並不直接控制 DHT Sensor 的讀取時間。

這樣架構更合理:

DHT
 │
 │ 固定取樣
 ▼
ESP32 Memory
 │
 │ API Request
 ▼
JSON
 │
 ▼
Browser

也就是:

ESP32 自己負責 Sensor Sampling,Web API 只提供最近一次有效資料。

三十、本章 Relay 接線

Relay 使用:

GPIO 26

接線:

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

本章仍假設常見:

Active LOW Relay

因此:

#define RELAY_ON  LOW
#define RELAY_OFF HIGH

三十一、本章完整硬體接線

ESP32
              ┌─────────────┐
              │             │
3.3V ─────────┤             ├──── DHT VCC
              │             │
GPIO 4 ───────┤             ├──── DHT DATA
              │             │
GND ──────────┤             ├──── DHT GND
              │             │
GPIO 26 ──────┤             ├──── Relay IN
              │             │
GND ──────────┤             ├──── Relay GND
              │             │
              └─────────────┘

三十二、實作:ESP32 Web 溫溼度監控站

現在把:

  • ESP32
  • Wi-Fi
  • Web Server
  • DHT11 / DHT22
  • Relay
  • HTML
  • CSS
  • JavaScript
  • Fetch
  • JSON
  • Sensor API

全部整合在一起。

三十三、完整 ESP32 Web Dashboard 程式

/*
 * =====================================================
 * 第 13 章
 * ESP32 Web Server 感測器監控
 *
 * ESP32 Web 溫溼度監控站
 * =====================================================
 *
 * 功能:
 *
 * 1. ESP32 連接 Wi-Fi
 * 2. DHT11 / DHT22 溫度監測
 * 3. DHT11 / DHT22 濕度監測
 * 4. Web Dashboard
 * 5. JSON Sensor API
 * 6. JavaScript Fetch / AJAX
 * 7. Dashboard 自動更新
 * 8. Relay ON / OFF
 * 9. Relay 狀態顯示
 * 10. Wi-Fi RSSI 顯示
 *
 * DHT DATA : GPIO 4
 * Relay    : GPIO 26
 *
 * Relay 預設 Active LOW
 * =====================================================
 */

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


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

const char* WIFI_SSID =
  "YOUR_SSID";

const char* WIFI_PASSWORD =
  "YOUR_PASSWORD";


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

#define DHT_PIN 4

// 使用 DHT11:
#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;


// =====================================================
// Web Server
// =====================================================

WebServer server(80);


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

float temperature = NAN;
float humidity = NAN;

bool sensorValid = false;


// =====================================================
// Sensor Timer
// =====================================================

unsigned long lastSensorRead = 0;

const unsigned long SENSOR_INTERVAL =
  2500;


// =====================================================
// Wi-Fi Reconnect Timer
// =====================================================

unsigned long lastReconnectTime = 0;

const unsigned long RECONNECT_INTERVAL =
  10000;


// =====================================================
// HTML Web Dashboard
// =====================================================

const char INDEX_HTML[] = R"rawliteral(

<!DOCTYPE html>

<html lang="zh-TW">

<head>

<meta charset="UTF-8">

<meta
  name="viewport"
  content="width=device-width, initial-scale=1.0">

<title>
ESP32 Environment Monitor
</title>


<style>

/* ==================================================
   BODY
   ================================================== */

* {
  box-sizing: border-box;
}

body {

  margin: 0;

  padding: 20px;

  font-family:
    Arial,
    "Microsoft JhengHei",
    sans-serif;

  background:
    #f4f6f8;

  color:
    #222;
}


/* ==================================================
   CONTAINER
   ================================================== */

.container {

  max-width:
    720px;

  margin:
    auto;
}


/* ==================================================
   HEADER
   ================================================== */

.header {

  text-align:
    center;

  margin-bottom:
    24px;
}

.header h1 {

  margin-bottom:
    8px;
}

.header p {

  color:
    #666;
}


/* ==================================================
   GRID
   ================================================== */

.grid {

  display:
    grid;

  grid-template-columns:
    repeat(
      2,
      1fr
    );

  gap:
    16px;
}


/* ==================================================
   CARD
   ================================================== */

.card {

  background:
    white;

  border-radius:
    16px;

  padding:
    24px;

  text-align:
    center;

  box-shadow:
    0 4px 14px
    rgba(0,0,0,0.08);
}


.label {

  font-size:
    16px;

  color:
    #666;

  margin-bottom:
    12px;
}


.value {

  font-size:
    34px;

  font-weight:
    bold;
}


.unit {

  font-size:
    18px;

  color:
    #555;
}


/* ==================================================
   STATUS
   ================================================== */

.status-on {

  color:
    #16883e;
}


.status-off {

  color:
    #d9342b;
}


.status-error {

  color:
    #d9342b;
}


/* ==================================================
   RELAY BUTTON
   ================================================== */

.relay-card {

  margin-top:
    16px;
}


.button {

  border:
    none;

  border-radius:
    10px;

  padding:
    14px 24px;

  margin:
    8px;

  font-size:
    17px;

  cursor:
    pointer;

  color:
    white;
}


.button-on {

  background:
    #16883e;
}


.button-off {

  background:
    #d9342b;
}


/* ==================================================
   NETWORK
   ================================================== */

.network {

  margin-top:
    16px;

  text-align:
    left;

  line-height:
    1.8;
}


/* ==================================================
   FOOTER
   ================================================== */

.footer {

  text-align:
    center;

  margin-top:
    18px;

  color:
    #777;

  font-size:
    14px;
}


/* ==================================================
   MOBILE
   ================================================== */

@media
(max-width: 600px) {

  .grid {

    grid-template-columns:
      1fr;
  }

  .value {

    font-size:
      30px;
  }
}

</style>

</head>


<body>

<div class="container">


<!-- =================================================
     HEADER
     ================================================= -->

<div class="header">

<h1>
ESP32 Environment Monitor
</h1>

<p>
Web Temperature & Humidity Dashboard
</p>

</div>


<!-- =================================================
     SENSOR CARDS
     ================================================= -->

<div class="grid">


<!-- Temperature -->

<div class="card">

<div class="label">
Temperature
</div>

<div>

<span
  id="temperature"
  class="value">
--
</span>

<span class="unit">
°C
</span>

</div>

</div>


<!-- Humidity -->

<div class="card">

<div class="label">
Humidity
</div>

<div>

<span
  id="humidity"
  class="value">
--
</span>

<span class="unit">
%
</span>

</div>

</div>


<!-- Relay -->

<div class="card">

<div class="label">
Relay
</div>

<div
  id="relay"
  class="value status-off">

OFF

</div>

</div>


<!-- RSSI -->

<div class="card">

<div class="label">
WiFi RSSI
</div>

<div>

<span
  id="rssi"
  class="value">
--
</span>

<span class="unit">
dBm
</span>

</div>

</div>


</div>


<!-- =================================================
     RELAY CONTROL
     ================================================= -->

<div class="card relay-card">

<h2>
Relay Control
</h2>

<button
  class="button button-on"
  onclick="relayControl('on')">

Relay ON

</button>


<button
  class="button button-off"
  onclick="relayControl('off')">

Relay OFF

</button>

</div>


<!-- =================================================
     NETWORK INFORMATION
     ================================================= -->

<div class="card network">

<h2>
Network Status
</h2>

<div>

Wi-Fi :
<span id="wifiStatus">
--
</span>

</div>

<div>

IP Address :
<span id="ip">
--
</span>

</div>

<div>

Last Update :
<span id="lastUpdate">
--
</span>

</div>

</div>


<!-- =================================================
     FOOTER
     ================================================= -->

<div class="footer">

ESP32 Web Sensor Dashboard

</div>


</div>


<script>


// ====================================================
// Update Sensor Dashboard
// ====================================================

async function updateData() {

  try {

    const response =
      await fetch(
        "/api/sensor",
        {
          cache:
            "no-store"
        }
      );


    if (
      !response.ok
    ) {

      throw new Error(
        "HTTP " +
        response.status
      );
    }


    const data =
      await response.json();


    // ================================================
    // Temperature
    // ================================================

    const temperatureElement =
      document.getElementById(
        "temperature"
      );


    if (
      data.temperature === null
    ) {

      temperatureElement.textContent =
        "--";
    }

    else {

      temperatureElement.textContent =
        Number(
          data.temperature
        ).toFixed(1);
    }


    // ================================================
    // Humidity
    // ================================================

    const humidityElement =
      document.getElementById(
        "humidity"
      );


    if (
      data.humidity === null
    ) {

      humidityElement.textContent =
        "--";
    }

    else {

      humidityElement.textContent =
        Number(
          data.humidity
        ).toFixed(1);
    }


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

    const relayElement =
      document.getElementById(
        "relay"
      );


    if (
      data.relay
    ) {

      relayElement.textContent =
        "ON";

      relayElement.className =
        "value status-on";
    }

    else {

      relayElement.textContent =
        "OFF";

      relayElement.className =
        "value status-off";
    }


    // ================================================
    // RSSI
    // ================================================

    document.getElementById(
      "rssi"
    ).textContent =
      data.rssi === null
      ? "--"
      : data.rssi;


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

    document.getElementById(
      "wifiStatus"
    ).textContent =
      data.wifi;


    // ================================================
    // IP
    // ================================================

    document.getElementById(
      "ip"
    ).textContent =
      data.ip;


    // ================================================
    // Update Time
    // ================================================

    document.getElementById(
      "lastUpdate"
    ).textContent =
      new Date()
      .toLocaleTimeString();

  }

  catch (error) {

    console.log(
      "Sensor API Error:",
      error
    );

    document.getElementById(
      "wifiStatus"
    ).textContent =
      "API ERROR";
  }
}


// ====================================================
// Relay Control
// ====================================================

async function relayControl(state) {

  try {

    const response =
      await fetch(
        "/api/relay/" + state,
        {
          cache:
            "no-store"
        }
      );


    if (
      !response.ok
    ) {

      throw new Error(
        "Relay HTTP Error"
      );
    }


    // Relay 動作完成後
    // 立即更新 Dashboard

    await updateData();

  }

  catch (error) {

    console.log(
      "Relay Error:",
      error
    );
  }
}


// ====================================================
// Initial Update
// ====================================================

updateData();


// ====================================================
// Auto Update
// ====================================================

setInterval(
  updateData,
  3000
);

</script>


</body>

</html>

)rawliteral";


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

void readSensor() {

  float newHumidity =
    dht.readHumidity();

  float newTemperature =
    dht.readTemperature();


  // ---------------------------------------------------
  // Check Sensor
  // ---------------------------------------------------

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

    Serial.println(
      "DHT read failed"
    );

    sensorValid =
      false;

    return;
  }


  // ---------------------------------------------------
  // Save Valid Data
  // ---------------------------------------------------

  humidity =
    newHumidity;

  temperature =
    newTemperature;

  sensorValid =
    true;


  // ---------------------------------------------------
  // Serial Monitor
  // ---------------------------------------------------

  Serial.print(
    "Temperature: "
  );

  Serial.print(
    temperature,
    1
  );

  Serial.print(
    " C"
  );


  Serial.print(
    " | Humidity: "
  );

  Serial.print(
    humidity,
    1
  );

  Serial.println(
    " %"
  );
}


// =====================================================
// Web Home
// =====================================================

void handleRoot() {

  server.send(
    200,
    "text/html; charset=utf-8",
    INDEX_HTML
  );
}


// =====================================================
// Sensor API
// =====================================================

void handleSensorApi() {

  String json;

  json.reserve(
    256
  );


  json += "{";


  // ---------------------------------------------------
  // Temperature
  // ---------------------------------------------------

  json +=
    "\"temperature\":";

  if (
    sensorValid
  ) {

    json +=
      String(
        temperature,
        1
      );
  }

  else {

    json +=
      "null";
  }


  // ---------------------------------------------------
  // Humidity
  // ---------------------------------------------------

  json +=
    ",\"humidity\":";

  if (
    sensorValid
  ) {

    json +=
      String(
        humidity,
        1
      );
  }

  else {

    json +=
      "null";
  }


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

  json +=
    ",\"relay\":";

  json +=
    relayState
    ? "true"
    : "false";


  // ---------------------------------------------------
  // RSSI
  // ---------------------------------------------------

  json +=
    ",\"rssi\":";

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

    json +=
      String(
        WiFi.RSSI()
      );
  }

  else {

    json +=
      "null";
  }


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

  json +=
    ",\"wifi\":\"";

  json +=
    WiFi.status() ==
    WL_CONNECTED
    ? "CONNECTED"
    : "DISCONNECTED";

  json +=
    "\"";


  // ---------------------------------------------------
  // IP Address
  // ---------------------------------------------------

  json +=
    ",\"ip\":\"";

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

    json +=
      WiFi.localIP()
      .toString();
  }

  else {

    json +=
      "0.0.0.0";
  }

  json +=
    "\"";


  json +=
    "}";


  // ---------------------------------------------------
  // HTTP Response
  // ---------------------------------------------------

  server.send(
    200,
    "application/json",
    json
  );
}


// =====================================================
// Relay ON API
// =====================================================

void handleRelayOn() {

  digitalWrite(
    RELAY_PIN,
    RELAY_ON
  );

  relayState =
    true;


  Serial.println(
    "Relay ON"
  );


  server.send(
    200,
    "application/json",
    "{\"relay\":true}"
  );
}


// =====================================================
// Relay OFF API
// =====================================================

void handleRelayOff() {

  digitalWrite(
    RELAY_PIN,
    RELAY_OFF
  );

  relayState =
    false;


  Serial.println(
    "Relay OFF"
  );


  server.send(
    200,
    "application/json",
    "{\"relay\":false}"
  );
}


// =====================================================
// 404
// =====================================================

void handleNotFound() {

  server.send(
    404,
    "application/json",
    "{\"error\":\"Not Found\"}"
  );
}


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

void connectWiFi() {

  WiFi.mode(
    WIFI_STA
  );


  WiFi.setAutoReconnect(
    true
  );


  WiFi.begin(
    WIFI_SSID,
    WIFI_PASSWORD
  );


  Serial.println();

  Serial.print(
    "Connecting to "
  );

  Serial.println(
    WIFI_SSID
  );


  unsigned long startTime =
    millis();


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

    delay(
      500
    );

    Serial.print(
      "."
    );
  }


  Serial.println();


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

    Serial.println(
      "WiFi Connected"
    );


    Serial.print(
      "IP Address: "
    );

    Serial.println(
      WiFi.localIP()
    );


    Serial.print(
      "RSSI: "
    );

    Serial.print(
      WiFi.RSSI()
    );

    Serial.println(
      " dBm"
    );
  }

  else {

    Serial.println(
      "WiFi Connection Failed"
    );
  }
}


// =====================================================
// SETUP
// =====================================================

void setup() {

  Serial.begin(
    115200
  );


  delay(
    500
  );


  Serial.println();

  Serial.println(
    "ESP32 Web Environment Monitor"
  );


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

  pinMode(
    RELAY_PIN,
    OUTPUT
  );


  digitalWrite(
    RELAY_PIN,
    RELAY_OFF
  );


  relayState =
    false;


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

  dht.begin();


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

  delay(
    2000
  );

  readSensor();


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

  connectWiFi();


  // ---------------------------------------------------
  // Web Routes
  // ---------------------------------------------------

  server.on(
    "/",
    HTTP_GET,
    handleRoot
  );


  server.on(
    "/api/sensor",
    HTTP_GET,
    handleSensorApi
  );


  server.on(
    "/api/relay/on",
    HTTP_GET,
    handleRelayOn
  );


  server.on(
    "/api/relay/off",
    HTTP_GET,
    handleRelayOff
  );


  server.onNotFound(
    handleNotFound
  );


  // ---------------------------------------------------
  // Start Server
  // ---------------------------------------------------

  server.begin();


  Serial.println(
    "HTTP Server Started"
  );


  Serial.print(
    "Dashboard: http://"
  );

  Serial.println(
    WiFi.localIP()
  );


  Serial.print(
    "Sensor API: http://"
  );

  Serial.print(
    WiFi.localIP()
  );

  Serial.println(
    "/api/sensor"
  );
}


// =====================================================
// LOOP
// =====================================================

void loop() {


  // ---------------------------------------------------
  // Handle HTTP Client
  // ---------------------------------------------------

  server.handleClient();


  // ---------------------------------------------------
  // Sensor Timer
  // ---------------------------------------------------

  if (
    millis() -
    lastSensorRead
    >=
    SENSOR_INTERVAL
  ) {

    lastSensorRead =
      millis();

    readSensor();
  }


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

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

    if (
      millis() -
      lastReconnectTime
      >=
      RECONNECT_INTERVAL
    ) {

      lastReconnectTime =
        millis();


      Serial.println(
        "WiFi disconnected"
      );


      Serial.println(
        "Trying reconnect..."
      );


      WiFi.reconnect();
    }
  }
}

三十四、程式上傳前需要修改什麼?

最重要的是:

const char* WIFI_SSID =
  "YOUR_SSID";

const char* WIFI_PASSWORD =
  "YOUR_PASSWORD";

例如:

const char* WIFI_SSID =
  "Jason_WIFI";

const char* WIFI_PASSWORD =
  "12345678";

正式公開程式碼時,不要把真正的 Password 放進公開 GitHub 或下載檔案。

三十五、DHT11 與 DHT22 如何切換?

如果是:

DHT11

#define DHT_TYPE DHT11

如果使用:

DHT22

改成:

#define DHT_TYPE DHT22

其他 Web Server 程式不需要修改。

三十六、Arduino IDE 設定

一般 ESP32-WROOM-32 / ESP32 DevKit 可選:

Tools
→ Board
→ ESP32 Arduino
→ ESP32 Dev Module

選擇正確:

COM Port

Serial Monitor:

115200 baud

因為程式:

Serial.begin(115200);

三十七、Serial Monitor 執行結果

正常開機後可能看到:

ESP32 Web Environment Monitor

Temperature: 27.5 C | Humidity: 63.0 %

Connecting to Jason_WIFI
.....

WiFi Connected

IP Address: 192.168.1.105
RSSI: -51 dBm

HTTP Server Started

Dashboard:
http://192.168.1.105

Sensor API:
http://192.168.1.105/api/sensor

三十八、手機如何開啟 Dashboard?

手機必須和 ESP32 位於可以互相通訊的同一個 LAN。

例如:

Router
   │
   ├── ESP32
   │   192.168.1.105
   │
   └── iPhone
       192.168.1.120

手機 Chrome / Safari 輸入:

http://192.168.1.105

即可看到 Web Dashboard。

三十九、手機畫面

Dashboard 會顯示:

ESP32 Environment Monitor

┌───────────────────────┐
│ Temperature           │
│                       │
│      27.5 °C          │
└───────────────────────┘

┌───────────────────────┐
│ Humidity              │
│                       │
│       63.0 %          │
└───────────────────────┘

┌───────────────────────┐
│ Relay                 │
│                       │
│        OFF            │
└───────────────────────┘

┌───────────────────────┐
│ WiFi RSSI             │
│                       │
│      -51 dBm          │
└───────────────────────┘


[ Relay ON ]

[ Relay OFF ]


Network Status

Wi-Fi      : CONNECTED
IP Address : 192.168.1.105
Last Update: 08:35:26

四十、測試 Sensor API

不要只測 Dashboard。

我們也應該直接測試:

/api/sensor

手機或電腦輸入:

http://192.168.1.105/api/sensor

應看到:

{
  "temperature": 27.5,
  "humidity": 63.0,
  "relay": false,
  "rssi": -51,
  "wifi": "CONNECTED",
  "ip": "192.168.1.105"
}

這代表:

ESP32 Sensor API 已經完成。

四十一、這個 API 為什麼重要?

目前是瀏覽器使用:

/api/sensor

未來其他設備也可以使用。

例如:

Python
   │
   ▼
GET /api/sensor

或:

Raspberry Pi
   │
   ▼
ESP32 Sensor API

甚至:

Home Assistant
Node-RED
Windows App
Android App
iPhone App
另一台 ESP32

都可以讀取相同 JSON。

這就是:

把硬體資料與使用者介面分離。

四十二、Dashboard 與 Sensor API 分離

這是本章非常重要的架構觀念。

以前可能寫:

ESP32
  │
  └── 直接把 Sensor 數值寫死到 HTML

本章改成:

ESP32
                    │
        ┌───────────┴──────────┐
        │                      │
        ▼                      ▼
       /                   /api/sensor
        │                      │
        ▼                      ▼
HTML/CSS/JS                  JSON
        │                      │
        └─────────┬────────────┘
                  │
                  ▼
               Browser

前端:

HTML
CSS
JavaScript

後端:

Sensor API
GPIO API

已經開始具有現代 Web Application 的:

Frontend / Backend

架構概念。

四十三、Fetch 的完整流程

JavaScript:

fetch("/api/sensor")

送出:

GET /api/sensor

ESP32:

handleSensorApi();

回傳:

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

JavaScript:

response.json()

解析 JSON。

最後:

document.getElementById(
  "temperature"
).textContent =
  data.temperature;

更新畫面。

完整流程:

JavaScript
   │
   ▼
fetch()
   │
   ▼
HTTP GET
   │
   ▼
ESP32
   │
   ▼
Sensor API
   │
   ▼
JSON
   │
   ▼
Browser
   │
   ▼
JavaScript
   │
   ▼
DOM Update

四十四、為什麼畫面不用重新整理?

因為:

fetch()

是在背景執行 HTTP Request。

網頁本身沒有重新載入:

index.html

只有畫面的:

Temperature
Humidity
Relay
RSSI

這幾個元素被更新。

這就是 AJAX 類型應用的主要價值。

四十五、什麼是 DOM?

DOM:

Document Object Model

簡單理解:

JavaScript 看待 HTML 網頁的方式。

例如 HTML:

<span id="temperature">
--
</span>

JavaScript:

document.getElementById(
  "temperature"
)

就是找到這個 HTML Element。

然後:

.textContent = "27.5";

將:

--

改成:

27.5

四十六、Relay ON 如何運作?

使用者按:

Relay ON

JavaScript:

relayControl("on");

接著:

fetch("/api/relay/on");

ESP32 收到:

GET /api/relay/on

執行:

digitalWrite(
  RELAY_PIN,
  RELAY_ON
);

接著:

relayState = true;

四十七、Relay OFF 如何運作?

按:

Relay OFF

Browser:

GET /api/relay/off

ESP32:

digitalWrite(
  RELAY_PIN,
  RELAY_OFF
);

然後:

relayState = false;

Dashboard 下一次取得 Sensor API 時:

"relay": false

畫面就顯示:

Relay
OFF

四十八、Relay 控制也不需要重新整理網頁

第 12 章:

按 Relay ON
    ↓
載入新 HTML

第 13 章:

按 Relay ON
    ↓
Fetch API
    ↓
Relay ON
    ↓
updateData()
    ↓
只修改 Relay Status

使用者體驗已經非常接近 App。

四十九、為什麼 Sensor API 回傳 null?

本章特別處理:

isnan()

如果 DHT 發生讀取錯誤:

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

不會回傳假的:

0°C

而是 JSON:

{
  "temperature": null,
  "humidity": null
}

JavaScript 看到:

null

就顯示:

--

這比錯誤地顯示:

0.0°C

更安全、更合理。

五十、DHT 讀取失敗的常見原因

如果 Serial Monitor 出現:

DHT read failed

請檢查:

1. DATA 接線

DHT DATA
→ GPIO 4

2. VCC

確認感測器供電正常。

3. GND

ESP32 與 DHT 必須共地。

4. DHT_TYPE

DHT11:

#define DHT_TYPE DHT11

DHT22:

#define DHT_TYPE DHT22

5. Pull-up Resistor

如果使用裸 Sensor:

DATA
↔
VCC

通常需要約:

10 kΩ

Pull-up。

6. 讀取太快

不要瘋狂讀取 DHT。

本專案:

2.5 秒

讀取一次。

五十一、WiFi RSSI 為什麼也要顯示?

環境 Sensor 正常,不代表網路一定正常。

IoT 系統還需要關心:

Network Quality

ESP32 可以利用:

WiFi.RSSI();

讀取訊號。

Arduino-ESP32 最新官方文件仍提供 Station Mode 與 RSSI、IP Address 等 Wi-Fi 狀態資訊;STA 是 ESP32 加入既有 Access Point 的標準模式。

五十二、RSSI 如何判斷?

例如:

-42 dBm

代表非常好的訊號。

而:

-82 dBm

則非常弱。

實務上可大致分類:

Wi-Fi RSSI 訊號品質參考
RSSI 評估
-30 ~ -50 dBm 非常好
-50 ~ -60 dBm 很好
-60 ~ -67 dBm 良好
-67 ~ -70 dBm 普通
-70 ~ -80 dBm 偏弱
< -80 dBm 很弱

因此 Dashboard 同時顯示:

Temperature
Humidity
WiFi RSSI

會比只顯示 Sensor 更符合實際 IoT 系統需求。

五十三、Web Dashboard 更新頻率可以改嗎?

目前:

setInterval(
  updateData,
  3000
);

也就是:

3 秒

更新一次。

如果想改為:

5 秒

改成:

setInterval(
  updateData,
  5000
);

五十四、是不是更新越快越好?

不是。

例如:

setInterval(
  updateData,
  100
);

代表:

每秒 10 次 Request

對於 DHT11 / DHT22 完全沒有必要。

因為 DHT 本來就是慢速環境感測器。

而且過度頻繁的 Request 會增加:

  • ESP32 CPU 負擔
  • Wi-Fi Traffic
  • Web Server Request
  • 記憶體使用
  • 手機耗電

環境監測通常:

2~10 秒

更新一次已相當足夠。

五十五、為什麼使用 millis() 而不是 delay()?

本章 ESP32 同時要:

讀 DHT
+
處理 HTTP
+
控制 Relay
+
監控 Wi-Fi

如果:

delay(5000);

則這 5 秒內:

server.handleClient()

可能無法及時執行。

所以使用:

millis()

是非常重要的 ESP32 IoT 程式設計方式。

五十六、ESP32 Web Server 的 loop() 架構

目前的核心結構:

void loop() {

  server.handleClient();

  if (
    Sensor Timer 到期
  ) {

    readSensor();
  }

  if (
    WiFi Disconnected
  ) {

    reconnect();
  }
}

也就是:

loop()
 │
 ├── HTTP Server
 │
 ├── Sensor Timer
 │
 └── Wi-Fi Monitor

未來還能繼續加入:

MQTT
OLED
LCD
RTC
SD Card
Alarm
Button
Motor
Cloud Upload

五十七、目前的 ESP32 已經有兩套 API

本章實際上建立了:

Sensor API

GET /api/sensor

用途:

取得:
Temperature
Humidity
Relay
RSSI
IP

Relay Control API

GET /api/relay/on

以及:

GET /api/relay/off

用途:

Relay Control

因此系統架構已經變成:

ESP32 REST-like API

雖然這還不是完整的 RESTful API 設計,但已經建立重要基礎。

五十八、下一階段可以改用 POST

目前為了教材簡單:

GET /api/relay/on

也可以控制 Relay。

但在更正式的 Web API 設計中:

GET

通常應該用於:

讀取資料

例如:

GET /api/sensor

而改變 Relay 狀態則更適合使用:

POST

例如:

POST /api/relay

Body:

{
  "state": true
}

這會是後續 API 設計可以再進一步學習的內容。

五十九、HTTP API 與 HTML 為什麼要分開?

如果把所有事情都塞在:

/

將來程式會越來越難維護。

分成:

/

提供:

UI

以及:

/api/sensor

提供:

Data

架構會清楚很多。

這種方式也很適合未來將 Dashboard 搬到:

  • Raspberry Pi
  • NAS
  • Web Server
  • Cloud
  • iPhone App

因為 Sensor API 不需要跟著改。

六十、Web Dashboard 的資料流

完整資料流程如下:

DHT11 / DHT22
      │
      ▼
ESP32 readSensor()
      │
      ▼
temperature
humidity
      │
      ▼
/api/sensor
      │
      ▼
JSON
      │
      ▼
HTTP
      │
      ▼
JavaScript Fetch
      │
      ▼
Browser DOM
      │
      ▼
Temperature : 27.5°C
Humidity    : 63%

六十一、Relay 的資料流

手機 Button
     │
     ▼
JavaScript
     │
     ▼
fetch()
     │
     ▼
/api/relay/on
     │
     ▼
ESP32
     │
     ▼
GPIO 26
     │
     ▼
Relay ON
     │
     ▼
relayState = true
     │
     ▼
/api/sensor
     │
     ▼
"relay": true
     │
     ▼
Dashboard
     │
     ▼
Relay : ON

六十二、這就是簡單的 Full-Stack IoT

到了本章,ESP32 專案已經同時包含:

Hardware

ESP32
DHT
Relay

Embedded Software

Arduino C++
WiFi.h
WebServer.h
DHT.h

Backend

HTTP Server
Sensor API
Relay API
JSON

Frontend

HTML
CSS
JavaScript
Fetch
DOM

因此它已經是一個非常簡化版的:

Full-Stack IoT Application

六十三、為什麼這一章很重要?

因為我們不再只是:

ESP32
→ Sensor
→ Serial Monitor

而是:

ESP32
→ Sensor
→ HTTP API
→ JSON
→ Wi-Fi
→ Browser
→ Web Dashboard

這就是 IoT 系統最典型的資料流之一。

六十四、區域網路控制與 Internet 控制的差異

目前手機通常必須與 ESP32 位於:

同一個 LAN

例如:

Home Router
    │
    ├── ESP32
    └── Phone

這叫:

Local Web Dashboard

目前不建議直接把 ESP32 Port 80 暴露到 Internet。

因為正式 Internet 遠端控制還需要考慮:

  • Authentication
  • HTTPS
  • TLS
  • Firewall
  • Access Control
  • Password
  • API Token
  • MQTT Security

這些不能忽略。

六十五、ESP32 WebServer 安全性也要注意

Arduino-ESP32 最新版本對 WebServer Request Processing 已加入更多長度、Header 與 Timeout 限制,以降低異常或惡意 HTTP Request 對 ESP32 資源造成的影響。

但這並不代表:

裸 ESP32 Web Server 就適合直接公開到 Internet。

本章定位仍然是:

可信任區域網路中的 IoT 教學與控制。

六十六、如果 Wi-Fi 中斷會怎樣?

本程式加入:

WiFi.setAutoReconnect(
  true
);

並且每:

10 秒

檢查 Wi-Fi。

如果斷線:

WiFi.reconnect();

Arduino-ESP32 官方 Wi-Fi API 支援 STA Mode 與相關連線管理機制,因此可以建立長時間運作的 ESP32 網路節點。

六十七、ESP32 Web Dashboard 可以用在哪裡?

本章架構可以直接延伸到很多實際應用。

機房監控

Temperature
Humidity
UPS Status
Fan
Alarm

溫室

Temperature
Humidity
Soil Moisture
Water Pump
Fan
Light

智慧家庭

Room Temperature
Humidity
Light
Air Conditioner
Relay
Door Sensor

工廠

Machine Temperature
Production Count
Alarm
Motor
Relay
Current
Voltage

倉庫

Temperature
Humidity
Door
Smoke
Alarm

六十八、下一步可以加入 Threshold Control

例如:

Temperature > 30°C

自動:

Relay ON

控制:

Fan

而:

Temperature < 28°C

自動:

Relay OFF

這樣就變成:

自動溫控系統。

六十九、也可以加入警報

例如:

Temperature > 35°C

Dashboard 顯示:

HIGH TEMPERATURE ALARM

並且:

Relay ON
Buzzer ON

甚至後面再加入:

MQTT
LINE
Telegram
Email

遠端通知。

七十、還可以加入圖表

目前 Dashboard 只有顯示:

Current Temperature
Current Humidity

之後可以加入 JavaScript Chart Library,顯示:

Temperature

30 ┤
29 ┤         ╭──
28 ┤     ╭───╯
27 ┤─────╯
26 ┤
   └────────────

也就是:

Real-Time Chart

再進一步把資料存進:

SQLite
MySQL
InfluxDB
Cloud Database

就可以查詢:

1 小時
24 小時
7 天
30 天

的歷史趨勢。

七十一、DHT11 是否適合真正長期監控?

DHT11 非常適合:

教學
實驗
入門
Prototype

但如果是比較正式的環境監測,可以考慮:

  • DHT22
  • SHT30
  • SHT31
  • SHT40
  • BME280

等精度、穩定度或功能更好的 Sensor。

所以教材可以先使用:

DHT11

理解完整架構,再更換 Sensor。

七十二、更換 Sensor 不需要重做 Dashboard

這就是 API 架構最大的優點之一。

現在:

DHT11
   │
   ▼
temperature
humidity

未來換成:

SHT31

只要 ESP32 最後仍然輸出:

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

手機 Dashboard:

完全不用修改

或只需要極少修改。

這就是:

Hardware Abstraction + API Interface

的重要觀念。

七十三、ESP32 Web Dashboard 常用技術整理

ESP32 Web Dashboard 常用技術整理
技術 用途
WiFi.h 無線網路
WebServer.h HTTP Server
DHT.h DHT11 / DHT22
HTML Dashboard Structure
CSS Dashboard UI
JavaScript Dashboard Logic
fetch() HTTP Request
JSON Data Format
AJAX Background Update
setInterval() Auto Refresh
document.getElementById() 更新網頁
millis() Sensor Timer
WiFi.RSSI() Wi-Fi Signal
digitalWrite() Relay Control

七十四、本章 API 整理

ESP32 Web Dashboard API 整理
URL Method 功能
/ GET Dashboard
/api/sensor GET Sensor JSON
/api/relay/on GET Relay ON
/api/relay/off GET Relay OFF

七十五、本章 JSON 資料格式

正常:

{
  "temperature": 27.5,
  "humidity": 63.0,
  "relay": false,
  "rssi": -51,
  "wifi": "CONNECTED",
  "ip": "192.168.1.105"
}

DHT 失敗:

{
  "temperature": null,
  "humidity": null,
  "relay": false,
  "rssi": -51,
  "wifi": "CONNECTED",
  "ip": "192.168.1.105"
}

Wi-Fi 不正常時,系統也不應該捏造 RSSI,因此程式可以用:

"rssi": null

表示目前沒有有效值。

七十六、第 11~13 章已經形成完整網路學習路線

第 11 章:

ESP32
↓
Wi-Fi
↓
Router
↓
IP Address

第 12 章:

Wi-Fi
↓
HTTP
↓
Web Server
↓
GPIO Control

第 13 章:

Sensor
↓
ESP32
↓
Sensor API
↓
JSON
↓
Fetch
↓
Web Dashboard

這三章實際上已經完成:

ESP32 IoT Web Application 的核心基礎。

七十七、本章完整系統資料流

DHT11 / DHT22
                           │
              Temperature │ Humidity
                           ▼
                       ESP32
                         │
           ┌─────────────┼──────────────┐
           │             │              │
           ▼             ▼              ▼
        Wi-Fi          Relay         Sensor
        RSSI          GPIO 26         Data
           │             │              │
           └─────────────┴──────────────┘
                         │
                         ▼
                    Sensor API
                         │
                         ▼
                        JSON
                         │
                         ▼
                      HTTP GET
                         │
                         ▼
                       Router
                         │
                         ▼
                       Phone
                         │
                         ▼
                 JavaScript Fetch
                         │
                         ▼
                    Web Dashboard
                         │
         ┌───────────────┼───────────────┐
         │               │               │
         ▼               ▼               ▼
    Temperature       Humidity         Relay
      27.5°C            63%             OFF
                                         │
                                         ▼
                                   WiFi RSSI
                                     -51 dBm

七十八、本章重點整理

學完第 13 章後,應該理解:

1. DHT11 / DHT22

可以取得:

Temperature
Humidity

2. ESP32 可以當 Sensor Server

Sensor
↓
ESP32
↓
HTTP

3. HTML 建立 Dashboard

<span id="temperature">
--
</span>

4. CSS 建立手機介面

可以設計:

Card
Grid
Button
Responsive UI

5. JavaScript 負責資料更新

updateData();

6. Fetch API 取得 ESP32 資料

fetch("/api/sensor");

7. JSON 是 ESP32 與 Browser 的資料格式

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

8. AJAX 可以避免重新整理整張網頁

Fetch
↓
JSON
↓
DOM Update

9. setInterval() 可以自動更新

setInterval(
  updateData,
  3000
);

10. Sensor API 將 UI 與 Sensor 分離

/api/sensor

不只 Browser 可以使用。

未來:

App
Python
Raspberry Pi
Home Assistant
Cloud

也可以使用。

七十九、結語

第 12 章我們完成了:

手機
↓
ESP32 Web Server
↓
GPIO
↓
LED / Relay

第 13 章則加入了另一個非常重要的方向:

Sensor
↓
ESP32
↓
HTTP API
↓
JSON
↓
Browser

最後形成完整的雙向系統:

ESP32
                   │
          ┌────────┴────────┐
          │                 │
          ▼                 ▼
       Sensor             Relay
          │                 ▲
          ▼                 │
     Sensor API        Control API
          │                 ▲
          ▼                 │
         JSON               │
          │                 │
          └──── Browser ────┘

手機既可以:

監控

Temperature : 27.5 °C
Humidity    : 63 %
Relay       : OFF
WiFi RSSI   : -51 dBm

也可以:

控制

Relay ON
Relay OFF

更重要的是,網頁已經不需要每次重新整理。

我們使用:

JavaScript
+
Fetch
+
AJAX
+
JSON
+
Sensor API

建立真正會自動更新的:

ESP32 Web Dashboard

因此,ESP32 已經從簡單的 Web Server,進一步變成具備:

  • Sensor
  • Actuator
  • HTTP Server
  • API
  • JSON
  • Frontend Dashboard
  • Wi-Fi

的完整 IoT Node。

這也是後面學習:

ESP32 MQTT
ESP32 REST API
ESP32 Cloud
ESP32 Home Assistant
ESP32 IoT Dashboard
ESP32 Data Logger

最重要的基礎之一。

🧪 ESP32 實作課程

ESP32 第 13 章相關實驗

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

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

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

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

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

← 回文章列表