當 ESP32 還在麵包板開發階段時,每次修改程式,只要:
USB
↓
ESP32
↓
Upload
就可以重新燒錄 Firmware。
但是當 ESP32 已經安裝到:
- 天花板
- 電控箱
- 機台內部
- 工廠設備
- 戶外感測器
- 智慧家庭設備
- 農業監控節點
- 已經交付給客戶的產品
如果每次更新 Firmware 都必須:
拆機
↓
接 USB
↓
重新 Upload
↓
裝回去
就會非常麻煩。
這時就需要 ESP32 非常重要的一項產品化能力:
OTA — Over The Air Update
也就是:
透過 Wi-Fi 無線更新 ESP32 Firmware。
完成第一次 USB 燒錄之後,以後只要 ESP32 與開發電腦位於可通訊的網路環境,就可以:
Arduino IDE
│
│ Wi-Fi
▼
Router
│
│ OTA
▼
ESP32
直接更新程式。
本章將完整介紹:
- ESP32 OTA
- Over The Air
- ArduinoOTA
- Wi-Fi Update
- Firmware
- 無線更新
- OTA Password
- OTA Security
- Firmware Version
- Firmware Management
- OTA Partition
- OTA Update Process
- OTA Error Handling
最後完成:
ESP32 Wi-Fi OTA 更新 LED / Relay 控制系統
讓 ESP32 即使安裝完成後,仍然可以不用 USB 線直接更新程式。
一、什麼是 OTA?
OTA 全名是:
Over The Air
中文通常稱為:
空中更新、無線更新、遠端更新
OTA 的目的,就是讓設備不需要透過實體 USB、UART 或燒錄器,就可以接收新的 Firmware。
傳統更新方式:
PC
│
│ USB
▼
ESP32
OTA 更新則是:
PC
│
│ Wi-Fi
▼
Router
│
│ Network
▼
ESP32
甚至在真正的 IoT Product 中,可以做到:
Firmware Server
│
│ Internet / HTTPS
▼
Router
│
▼
ESP32
因此 OTA 是 ESP32 從:
Maker Prototype
走向:
IoT Product
非常重要的一項技術。
二、Firmware 是什麼?
Firmware 可以理解成:
執行在 ESP32 裡面的程式。
例如我們寫:
digitalWrite(LED_PIN, HIGH);
經過 Arduino IDE 編譯後,會產生 ESP32 可以執行的 Binary Firmware。
流程:
Arduino Sketch
.ino
│
▼
Compiler
│
▼
Firmware Binary
.bin
│
▼
ESP32 Flash
平常按:
Upload
其實就是把新的 Firmware 寫入 ESP32 Flash。
OTA 只是把:
USB 傳 Firmware
改成:
Network 傳 Firmware
三、ESP32 OTA 的基本架構
ArduinoOTA 最簡單的架構:
┌──────────────────────┐
│ Arduino IDE │
│ │
│ Firmware v1.1 │
└──────────┬───────────┘
│
│ Wi-Fi OTA
▼
┌──────────────────────┐
│ Router │
└──────────┬───────────┘
│
▼
┌──────────────────────┐
│ ESP32 │
│ │
│ Firmware v1.0 │
└──────────────────────┘
更新完成:
ESP32 Restart
↓
Firmware v1.1
不需要 USB。
四、第一次還是需要 USB
這一點非常重要。
一塊全新的 ESP32:
沒有 ArduinoOTA 程式
自然不知道如何接收 OTA Firmware。
因此第一次必須:
PC
│
│ USB
▼
ESP32
先燒入支援 OTA 的 Firmware。
之後才可以:
PC
│
│ Wi-Fi
▼
ESP32
持續 OTA 更新。
因此完整流程是:
第一次
USB Upload
↓
OTA Firmware Installed
↓
第二次以後
Wi-Fi OTA
↓
Wi-Fi OTA
↓
Wi-Fi OTA
五、ESP32 OTA 更新到底怎麼運作?
ESP32 的正式 OTA 機制並不是直接把目前正在執行的 Firmware 覆蓋掉。
典型 OTA Partition 架構會包含:
ota_0
ota_1
ota_data
例如:
Flash
│
├── Bootloader
│
├── Partition Table
│
├── ota_data
│
├── ota_0
│ Firmware v1.0
│
└── ota_1
空白
ESP32 正在:
ota_0
執行 Firmware v1.0。
OTA 更新時:
Firmware v1.1
↓
寫入 ota_1
完成並驗證後:
Boot Partition
ota_0
↓
ota_1
重新啟動:
ESP32
↓
ota_1
↓
Firmware v1.1
Espressif 官方 OTA 文件指出,安全的 Application OTA 架構至少需要兩個 OTA Application Slot,例如 ota_0、ota_1,以及 OTA Data Partition;新 Firmware 會先寫入目前未執行的 OTA Slot,成功後再修改下一次開機所使用的 Partition。
六、為什麼不能只有一個 Application Partition?
假設 ESP32 正在執行:
Firmware A
如果 OTA 直接覆寫:
Firmware A
更新一半突然:
停電
可能就變成:
Firmware A 被破壞
Firmware B 又沒寫完
設備就可能無法正常啟動。
雙 OTA Partition 的概念則是:
目前 Firmware A
保持不動
│
│
Firmware B
寫到另一區
只有 Firmware B 完整寫入之後,才切換 Boot Partition。
這就是產品 OTA 可靠性的重要基礎。
七、Arduino IDE 的 Partition Scheme 要注意
使用 Arduino ESP32 OTA 時,必須選擇:
支援 OTA 的 Partition Scheme
如果選擇的 Partition Scheme 把幾乎所有 Flash 都配置給單一 Application,甚至明確標示:
No OTA
就不能正常進行雙 Partition OTA。
因此 Arduino IDE:
Tools
→ Partition Scheme
應選擇具有 OTA Application Slot 的配置。
不要選:
No OTA
類型的 Partition Scheme。
不同 Arduino-ESP32 Core 版本與不同 Flash 容量的選項名稱可能略有不同,因此判斷原則比死記名稱重要:
至少要有足夠空間容納目前 Firmware 與新的 OTA Firmware。
八、OTA Firmware 大小也有限制
假設 Flash 被切成:
ota_0 = 1.4 MB
ota_1 = 1.4 MB
那麼 Firmware 就不能編譯成:
2 MB
否則 OTA Slot 放不下。
所以如果 Arduino IDE 顯示:
Sketch uses 1450000 bytes
而 OTA App Slot 只有:
1310720 bytes
OTA 就無法完成。
因此產品設計要同時管理:
Flash Size
Partition Scheme
Firmware Size
OTA Slot Size
Filesystem Size
九、ArduinoOTA 是什麼?
Arduino ESP32 提供:
#include <ArduinoOTA.h>
可以快速讓 Arduino IDE 透過 Wi-Fi 對 ESP32 上傳 Firmware。
基本流程只有:
ArduinoOTA.begin();
以及在:
loop()
持續呼叫:
ArduinoOTA.handle();
目前 Espressif 官方 Arduino-ESP32 BasicOTA 範例仍採用這個基本架構。
十、最基本 ESP32 ArduinoOTA 程式
先看最簡單版本:
#include <WiFi.h>
#include <ArduinoOTA.h>
const char* ssid =
"YOUR_WIFI_SSID";
const char* password =
"YOUR_WIFI_PASSWORD";
void setup() {
Serial.begin(115200);
WiFi.mode(WIFI_STA);
WiFi.begin(
ssid,
password
);
while (
WiFi.status() != WL_CONNECTED
) {
delay(500);
Serial.print(".");
}
Serial.println();
Serial.print("IP: ");
Serial.println(
WiFi.localIP()
);
ArduinoOTA.begin();
Serial.println(
"OTA Ready"
);
}
void loop() {
ArduinoOTA.handle();
}
這已經是一個最基本的 ESP32 OTA Firmware。
十一、ArduinoOTA.handle() 為什麼不能漏掉?
ArduinoOTA:
ArduinoOTA.begin();
只是初始化 OTA。
真正讓 ESP32 持續處理:
OTA Request
Firmware Packet
Update Command
的是:
ArduinoOTA.handle();
因此:
void loop() {
ArduinoOTA.handle();
}
一定要持續執行。
如果程式長時間卡在:
delay(60000);
OTA 反應就可能非常差。
十二、這也是為什麼產品程式不應該大量使用長 delay()
例如:
digitalWrite(LED_PIN, HIGH);
delay(30000);
digitalWrite(LED_PIN, LOW);
這 30 秒內:
ArduinoOTA.handle();
沒有被執行。
因此 OTA 可能:
Timeout
Connect Failed
較好的設計是使用:
millis()
建立 Non-blocking 程式。
例如:
if (
millis() - previousMillis >= 1000
) {
previousMillis = millis();
ledState = !ledState;
digitalWrite(
LED_PIN,
ledState
);
}
這樣:
ArduinoOTA.handle();
就可以一直被呼叫。
十三、設定 ESP32 OTA Hostname
如果有很多 ESP32:
ESP32 #1
ESP32 #2
ESP32 #3
ESP32 #4
只看到 IP Address 很難管理。
可以設定:
ArduinoOTA.setHostname(
"esp32-node01"
);
例如:
esp32-bedroom
esp32-livingroom
esp32-gateway
esp32-relay01
這也是 Firmware Management 第一個值得建立的規範。
目前官方 ArduinoOTA 範例同樣提供 ArduinoOTA.setHostname(),若沒有自行設定則會使用預設 Hostname。
十四、設定 OTA Password
如果完全沒有密碼:
任何同網路使用者
↓
可能嘗試 OTA
所以至少應設定:
ArduinoOTA.setPassword(
"YourStrongPassword"
);
例如:
ArduinoOTA.setPassword(
"ESP32-OTA-2026!"
);
之後 OTA Upload 就需要驗證 Password。
十五、目前 ArduinoOTA Password 的處理方式
目前 Espressif 官方 ArduinoOTA BasicOTA 範例指出,可以:
ArduinoOTA.setPassword(
"admin"
);
也可以設定預先計算的 Hash:
ArduinoOTA.setPasswordHash(
"..."
);
目前官方範例也註明 plain-text password 會在內部進行 Hash 處理,現行實作使用 PBKDF2-HMAC-SHA256。
不過這並不代表:
ArduinoOTA Password = 完整產品級 Secure OTA
這一點後面還會特別說明。
十六、ArduinoOTA Callback
OTA 更新過程可以監控:
Start
Progress
End
Error
完整架構:
ArduinoOTA
.onStart(...)
.onEnd(...)
.onProgress(...)
.onError(...);
這在產品上非常重要。
例如更新開始時:
Relay OFF
Motor STOP
Output Safe
OTA 完成:
Restart
OTA 錯誤:
Error Log
十七、OTA Start Callback
例如:
ArduinoOTA.onStart([]() {
Serial.println(
"OTA Update Start"
);
});
如果 ESP32 正在控制:
Motor
Heater
Relay
Pump
OTA 開始時應先讓設備進入安全狀態。
例如:
digitalWrite(
RELAY_PIN,
HIGH
);
關閉 Relay。
這是產品設計很重要的一點:
更新 Firmware 前先處理硬體安全狀態。
十八、OTA Progress Callback
可以顯示:
10%
20%
30%
...
100%
例如:
ArduinoOTA.onProgress(
[](unsigned int progress,
unsigned int total) {
Serial.printf(
"Progress: %u%%\n",
progress / (total / 100)
);
}
);
更新時可能看到:
Progress: 10%
Progress: 25%
Progress: 50%
Progress: 75%
Progress: 100%
十九、OTA Error Callback
常見 OTA Error:
Authentication Error
Begin Error
Connect Error
Receive Error
End Error
官方 BasicOTA 範例目前也對:
OTA_AUTH_ERROR
OTA_BEGIN_ERROR
OTA_CONNECT_ERROR
OTA_RECEIVE_ERROR
OTA_END_ERROR
分別處理。
二十、本章實作:ESP32 OTA LED / Relay 控制器
現在正式製作:
ESP32 Wi-Fi OTA LED / Relay Controller
硬體:
ESP32
│
├── GPIO2 → LED
│
└── GPIO26 → Relay
網路:
Arduino IDE
│
│ Wi-Fi
▼
Router
│
▼
ESP32 OTA
更新時:
Firmware v1.0
↓
Wi-Fi OTA
↓
Firmware v1.1
完全不需要 USB。
二十一、硬體接線
LED
如果 ESP32 DevKit 的 GPIO2 已經有內建 LED,可以直接使用。
如果使用外接 LED:
GPIO2
│
220Ω
│
LED
│
GND
Relay
本章使用:
GPIO26
控制 Relay。
| Relay Module | ESP32 |
|---|---|
| IN | GPIO26 |
| GND | GND |
| VCC | 依模組規格 |
注意:
有些 Relay Module 是:
Active LOW
也就是:
GPIO LOW
→ Relay ON
GPIO HIGH
→ Relay OFF
有些則是:
Active HIGH
因此程式會加入:
#define RELAY_ACTIVE_LOW true
方便調整。
二十二、完整 OTA LED / Relay Firmware v1.0
下面是一個比較適合真正教學與專題使用的版本。
包含:
- Wi-Fi
- ArduinoOTA
- OTA Password
- Hostname
- Firmware Version
- OTA Progress
- OTA Error
- LED Heartbeat
- Relay Control
- Serial Command
- Wi-Fi Reconnect
- Non-blocking 程式架構
#include <Arduino.h>
#include <WiFi.h>
#include <ESPmDNS.h>
#include <NetworkUdp.h>
#include <ArduinoOTA.h>
// =====================================================
// Firmware
// =====================================================
const char* DEVICE_NAME =
"ESP32-Relay-01";
const char* FIRMWARE_VERSION =
"1.0.0";
// =====================================================
// Wi-Fi
// =====================================================
const char* WIFI_SSID =
"YOUR_WIFI_SSID";
const char* WIFI_PASSWORD =
"YOUR_WIFI_PASSWORD";
// =====================================================
// OTA
//
// 實際產品不要直接使用範例密碼
// =====================================================
const char* OTA_HOSTNAME =
"esp32-relay-01";
const char* OTA_PASSWORD =
"ChangeThisOTAPassword";
// =====================================================
// GPIO
// =====================================================
#define LED_PIN 2
#define RELAY_PIN 26
#define RELAY_ACTIVE_LOW true
// =====================================================
// State
// =====================================================
bool ledState = false;
bool relayState = false;
unsigned long previousLedMillis = 0;
unsigned long previousWiFiCheck = 0;
const unsigned long LED_INTERVAL =
1000;
const unsigned long WIFI_CHECK_INTERVAL =
5000;
// =====================================================
// Relay Function
// =====================================================
void setRelay(bool on) {
relayState = on;
if (RELAY_ACTIVE_LOW) {
digitalWrite(
RELAY_PIN,
on ? LOW : HIGH
);
} else {
digitalWrite(
RELAY_PIN,
on ? HIGH : LOW
);
}
Serial.print("Relay = ");
Serial.println(
on ? "ON" : "OFF"
);
}
// =====================================================
// Wi-Fi Connect
// =====================================================
void connectWiFi() {
Serial.println();
Serial.println(
"Connecting Wi-Fi..."
);
WiFi.mode(WIFI_STA);
WiFi.begin(
WIFI_SSID,
WIFI_PASSWORD
);
unsigned long startTime =
millis();
while (
WiFi.status() != WL_CONNECTED &&
millis() - startTime < 15000
) {
delay(250);
Serial.print(".");
}
Serial.println();
if (
WiFi.status() == WL_CONNECTED
) {
Serial.println(
"Wi-Fi Connected"
);
Serial.print("SSID: ");
Serial.println(
WiFi.SSID()
);
Serial.print("IP: ");
Serial.println(
WiFi.localIP()
);
Serial.print("RSSI: ");
Serial.print(
WiFi.RSSI()
);
Serial.println(" dBm");
} else {
Serial.println(
"Wi-Fi Connect Timeout"
);
}
}
// =====================================================
// OTA Setup
// =====================================================
void setupOTA() {
// -----------------------------------------------
// Hostname
// -----------------------------------------------
ArduinoOTA.setHostname(
OTA_HOSTNAME
);
// -----------------------------------------------
// Password
// -----------------------------------------------
ArduinoOTA.setPassword(
OTA_PASSWORD
);
// -----------------------------------------------
// OTA Start
// -----------------------------------------------
ArduinoOTA.onStart([]() {
Serial.println();
Serial.println(
"============================"
);
Serial.println(
"OTA Update Started"
);
// 更新期間先讓 Relay 進入安全狀態
setRelay(false);
String type;
if (
ArduinoOTA.getCommand() ==
U_FLASH
) {
type = "Firmware";
} else {
type = "Filesystem";
}
Serial.print(
"Updating: "
);
Serial.println(type);
});
// -----------------------------------------------
// OTA End
// -----------------------------------------------
ArduinoOTA.onEnd([]() {
Serial.println();
Serial.println(
"OTA Update Complete"
);
});
// -----------------------------------------------
// OTA Progress
// -----------------------------------------------
ArduinoOTA.onProgress(
[](unsigned int progress,
unsigned int total) {
unsigned int percent =
progress /
(total / 100);
Serial.printf(
"OTA Progress: %u%%\r",
percent
);
}
);
// -----------------------------------------------
// OTA Error
// -----------------------------------------------
ArduinoOTA.onError(
[](ota_error_t error) {
Serial.printf(
"OTA Error [%u]: ",
error
);
if (
error == OTA_AUTH_ERROR
) {
Serial.println(
"Authentication Failed"
);
} else if (
error == OTA_BEGIN_ERROR
) {
Serial.println(
"Begin Failed"
);
} else if (
error == OTA_CONNECT_ERROR
) {
Serial.println(
"Connect Failed"
);
} else if (
error == OTA_RECEIVE_ERROR
) {
Serial.println(
"Receive Failed"
);
} else if (
error == OTA_END_ERROR
) {
Serial.println(
"End Failed"
);
}
}
);
// -----------------------------------------------
// Start ArduinoOTA
// -----------------------------------------------
ArduinoOTA.begin();
Serial.println();
Serial.println(
"ArduinoOTA Ready"
);
Serial.print(
"OTA Hostname: "
);
Serial.println(
OTA_HOSTNAME
);
}
// =====================================================
// Serial Commands
//
// 1 = Relay ON
// 0 = Relay OFF
// T = Toggle Relay
// V = Firmware Version
// I = Network Information
// =====================================================
void handleSerial() {
if (!Serial.available()) {
return;
}
char command =
Serial.read();
switch (command) {
case '1':
setRelay(true);
break;
case '0':
setRelay(false);
break;
case 't':
case 'T':
setRelay(
!relayState
);
break;
case 'v':
case 'V':
Serial.print(
"Firmware Version: "
);
Serial.println(
FIRMWARE_VERSION
);
break;
case 'i':
case 'I':
Serial.print("IP: ");
Serial.println(
WiFi.localIP()
);
Serial.print("RSSI: ");
Serial.print(
WiFi.RSSI()
);
Serial.println(" dBm");
break;
}
}
// =====================================================
// LED Heartbeat
// =====================================================
void handleLED() {
if (
millis() -
previousLedMillis >=
LED_INTERVAL
) {
previousLedMillis =
millis();
ledState =
!ledState;
digitalWrite(
LED_PIN,
ledState
);
}
}
// =====================================================
// Wi-Fi Reconnect
// =====================================================
void handleWiFiReconnect() {
if (
millis() -
previousWiFiCheck <
WIFI_CHECK_INTERVAL
) {
return;
}
previousWiFiCheck =
millis();
if (
WiFi.status() !=
WL_CONNECTED
) {
Serial.println(
"Wi-Fi disconnected"
);
WiFi.disconnect();
WiFi.begin(
WIFI_SSID,
WIFI_PASSWORD
);
}
}
// =====================================================
// Setup
// =====================================================
void setup() {
Serial.begin(115200);
delay(1000);
Serial.println();
Serial.println(
"============================"
);
Serial.println(
DEVICE_NAME
);
Serial.print(
"Firmware Version: "
);
Serial.println(
FIRMWARE_VERSION
);
Serial.println(
"============================"
);
// -----------------------------------------------
// GPIO
// -----------------------------------------------
pinMode(
LED_PIN,
OUTPUT
);
pinMode(
RELAY_PIN,
OUTPUT
);
digitalWrite(
LED_PIN,
LOW
);
// 開機時 Relay 預設 OFF
setRelay(false);
// -----------------------------------------------
// Wi-Fi
// -----------------------------------------------
connectWiFi();
// -----------------------------------------------
// OTA
// -----------------------------------------------
if (
WiFi.status() ==
WL_CONNECTED
) {
setupOTA();
}
Serial.println();
Serial.println(
"Commands:"
);
Serial.println(
"1 = Relay ON"
);
Serial.println(
"0 = Relay OFF"
);
Serial.println(
"T = Toggle Relay"
);
Serial.println(
"V = Firmware Version"
);
Serial.println(
"I = Network Info"
);
}
// =====================================================
// Loop
// =====================================================
void loop() {
// OTA 必須持續被處理
if (
WiFi.status() ==
WL_CONNECTED
) {
ArduinoOTA.handle();
}
handleLED();
handleSerial();
handleWiFiReconnect();
}
二十三、第一次 USB 燒錄流程
首先:
ESP32
│
│ USB
▼
Windows 11 PC
Arduino IDE 選擇:
Tools
→ Board
→ ESP32 Arduino
→ 對應 ESP32 Board
再選:
Tools
→ Port
→ COMx
然後:
Upload
完成第一次燒錄。
二十四、Serial Monitor 應該看到什麼?
Baud Rate:
115200
可能顯示:
============================
ESP32-Relay-01
Firmware Version: 1.0.0
============================
Connecting Wi-Fi...
....
Wi-Fi Connected
SSID: YourWiFi
IP: 192.168.1.120
RSSI: -48 dBm
ArduinoOTA Ready
OTA Hostname: esp32-relay-01
代表 OTA 已經準備完成。
二十五、Arduino IDE 如何找到 ESP32 OTA Port?
ESP32 與 PC 位於相同可通訊網路後:
Tools
→ Port
除了:
COM3
COM4
之類 USB Port 外,可能還會出現 Network Port。
例如概念上:
esp32-relay-01
192.168.1.120
選取 ESP32 Network Port。
接下來按:
Upload
Arduino IDE 就不再走 USB。
而會:
Arduino IDE
│
│ Wi-Fi
▼
192.168.1.120
│
▼
ESP32
進行 OTA。
二十六、為什麼 Windows 看不到 ESP32 Network Port?
ArduinoOTA 的裝置發現通常需要:
mDNS
如果 ESP32 明明:
Wi-Fi Connected
但 Arduino IDE 看不到 OTA Port,可以檢查:
- PC 與 ESP32 是否同一網路
- Router 是否開啟 Client Isolation
- Windows Firewall
- VPN 是否干擾
- mDNS 是否可以通過
- Hostname 是否正常
- ESP32 是否仍持續執行 ArduinoOTA.handle()
Espressif 的 Arduino OTA 文件也指出,開發電腦與 ESP32 必須位於可互相連線的網路;Windows 等環境的名稱探索也與 mDNS / Bonjour 支援有關。
二十七、第二次更新:Firmware v1.0 → v1.1
現在要真正測試:
不用 USB 更新程式
把:
const char* FIRMWARE_VERSION =
"1.0.0";
改成:
const char* FIRMWARE_VERSION =
"1.1.0";
再把 LED 閃爍速度:
const unsigned long LED_INTERVAL =
1000;
改成:
const unsigned long LED_INTERVAL =
250;
也就是:
Firmware v1.0
LED 每 1 秒切換一次
Firmware v1.1
LED 每 0.25 秒切換一次
二十八、選擇 Network OTA Port
這一次:
USB 可以拔掉。
ESP32 只需要正常供電。
例如:
5V Adapter
│
▼
ESP32
Arduino IDE:
Tools
→ Port
→ esp32-relay-01
再按:
Upload
如果設定了 OTA Password,Arduino IDE 會要求驗證。
成功後 ESP32:
Receiving Firmware
↓
Write OTA Partition
↓
Restart
↓
Firmware v1.1.0
二十九、如何確認 OTA 真的成功?
更新後重新看 Serial Monitor。
輸入:
V
ESP32 回:
Firmware Version: 1.1.0
而 LED 也會從:
1 秒
改為:
250 ms
因此可以明確確認:
OTA Firmware 已經成功更新。
三十、Relay 更新測試
例如 Firmware v1.0:
Relay 開機預設 OFF
Firmware v1.1 可以增加:
Serial.println(
"Firmware v1.1 OTA Update OK"
);
或者增加新的指令:
A = Relay ON
B = Relay OFF
重新 OTA 後,新功能立即生效。
這就是 OTA 最大價值:
產品已安裝
↓
不用拆機
↓
不用接 USB
↓
直接更新功能
三十一、Firmware Version 為什麼非常重要?
如果只有一塊 ESP32:
Version
好像不重要。
但是如果部署:
ESP32 #001
ESP32 #002
ESP32 #003
...
ESP32 #100
很快就會遇到問題:
哪一台是最新 Firmware?
因此每個 Firmware 都應該具有版本號。
例如:
1.0.0
1.0.1
1.1.0
2.0.0
三十二、Semantic Versioning
很適合使用:
MAJOR.MINOR.PATCH
例如:
2.3.5
分別表示:
2
↓
Major Version
3
↓
Minor Version
5
↓
Patch Version
例如:
1.0.0
第一正式版
1.0.1
修正 Bug
1.1.0
增加功能
2.0.0
重大架構修改
三十三、建議加入 Build Date
還可以加入:
const char* BUILD_DATE =
__DATE__;
const char* BUILD_TIME =
__TIME__;
啟動時:
Serial.print("Build: ");
Serial.print(BUILD_DATE);
Serial.print(" ");
Serial.println(BUILD_TIME);
可能看到:
Build:
Aug 21 2026 09:15:20
這對 Debug 非常方便。
三十四、進一步建立 Firmware Information
可以建立:
struct FirmwareInfo {
const char* product;
const char* version;
const char* buildDate;
const char* buildTime;
};
例如:
Product:
ESP32-ENV-01
Firmware:
2.1.3
Build:
2026-08-21
未來如果加入 Web Server,就能建立:
http://esp32/status
顯示 Firmware 狀態。
三十五、Firmware Management 應該管理哪些資料?
正式 IoT 設備至少值得管理:
Device ID
Model
Hardware Version
Firmware Version
Build Date
MAC Address
IP Address
OTA Status
Last Update
Update Result
例如:
| Device | Model | Firmware | Status |
|---|---|---|---|
| Node-001 | ENV01 | 1.2.0 | Online |
| Node-002 | ENV01 | 1.1.0 | Update Required |
| Node-003 | RELAY01 | 2.0.1 | Online |
這就開始進入:
Fleet Management
的概念。
三十六、ArduinoOTA 適合什麼情況?
ArduinoOTA 非常適合:
- Arduino 開發
- Maker Project
- 實驗室
- 公司內網設備
- 同一 LAN 內設備
- Prototype
- 少量 ESP32 維護
- 工程階段 Debug
例如:
辦公室
│
├── ESP32 Sensor
├── ESP32 Relay
├── ESP32 Gateway
└── ESP32 Test Device
都位於同一個 LAN。
Arduino IDE 就可以直接 OTA。
三十七、ArduinoOTA 不等於完整遠端 Internet OTA
這一點非常重要。
本章:
Arduino IDE
↓
LAN
↓
ESP32
比較適合:
開發與區域網路管理
真正商業產品常見:
ESP32
↓
HTTPS
↓
Firmware Server
↓
firmware_v2.1.0.bin
ESP32 自己檢查:
目前版本 2.0.0
Server 版本 2.1.0
然後:
Download
Verify
Install
Restart
這才是真正大規模 Product OTA 的方向。
三十八、Web OTA
另一種方式是讓 ESP32 本身建立 Web Update 頁面。
例如:
Browser
│
▼
http://esp32.local
│
▼
Choose Firmware.bin
│
▼
Upload
Espressif Arduino-ESP32 官方文件目前仍提供 Web OTA Update 的範例流程,可由瀏覽器上傳編譯後的 .bin Firmware。
這種方式不一定需要 Arduino IDE。
三十九、HTTP / HTTPS OTA
真正產品更常見:
ESP32
│
│ HTTPS
▼
Firmware Server
│
└── firmware.bin
ESP32 主動:
GET
https://server/firmware.bin
下載並更新。
例如:
ESP32
↓
Check Version
↓
New Firmware?
↓ YES
HTTPS Download
↓
Verify
↓
Install
↓
Restart
四十、OTA Password 安全嗎?
設定:
ArduinoOTA.setPassword(...)
比完全沒有 Authentication 好很多。
它可以避免最基本的:
未授權 OTA Upload
但不要誤解:
有 Password 就等於 Enterprise Secure OTA。
並不是。
ArduinoOTA Password 主要是 OTA Authentication。
真正產品還需要考慮:
- Firmware 是否加密傳輸
- Firmware 是否被竄改
- Firmware 是否由合法廠商簽署
- 是否允許舊 Firmware Downgrade
- 私鑰管理
- Secure Boot
- Flash Encryption
- HTTPS Certificate
- Rollback
Espressif 在產品安全指引中明確建議 OTA 更新使用安全傳輸,例如 HTTPS;搭配 Secure Boot 時,Server 應提供正確簽名的 Firmware Image。
四十一、Password 不要直接使用 admin
教學常看到:
ArduinoOTA.setPassword(
"admin"
);
這只是 Demonstration。
正式設備不要使用:
admin
123456
password
esp32
ota
這類弱密碼。
至少應使用:
長密碼
+
大小寫
+
數字
+
特殊符號
而產品化後更應避免所有設備共用同一個容易外洩的 OTA Credential。
四十二、不要把 Wi-Fi / OTA Password 公開在 GitHub
例如:
const char* WIFI_PASSWORD =
"MyCompany123";
const char* OTA_PASSWORD =
"OTA-Admin-123";
如果直接 Push 到:
Public GitHub
等於把 Credential 公開。
開發時至少可以拆成:
secrets.h
例如:
#include "secrets.h"
並將:
secrets.h
加入:
.gitignore
真正產品還應進一步考慮 Provisioning 與 Secure Storage。
四十三、OTA Firmware 簽章
只靠下載:
firmware.bin
還有一個問題:
怎麼知道這個 Firmware 真的是自己公司發布的?
因此產品級 OTA 應考慮:
Digital Signature
概念:
Firmware
+
Private Key
↓
Signature
ESP32 使用可信任的 Public Key 驗證:
Firmware
+
Signature
↓
Verify
↓
Valid?
只有合法 Firmware 才允許執行。
目前 Arduino-ESP32 的 Update Library 也已提供 Firmware Signature Verification、Encrypted Update 等能力;更完整的產品安全架構則通常搭配 ESP-IDF Secure Boot。
四十四、Secure Boot 是什麼?
Secure Boot 的核心概念:
ESP32 只執行可信任、正確簽章的 Firmware。
攻擊者即使得到設備,也不能單純燒錄:
Hacker Firmware
讓裝置直接執行。
因此:
OTA
+
Firmware Signature
+
Secure Boot
才逐漸接近正式產品安全架構。
Espressif 也建議 Secure Boot 與 Flash Encryption 搭配使用,以提高裝置對實體與 Firmware 攻擊的防護。
四十五、Flash Encryption 是什麼?
Flash Encryption 用來保護:
ESP32 Flash 中儲存的內容。
沒有 Encryption:
Flash
↓
Firmware / Data
可能較容易被直接讀取分析。
使用 Flash Encryption:
Firmware
↓
Encrypted Flash
降低 Firmware 與敏感資料被直接讀出的風險。
OTA、Secure Boot 與 Flash Encryption 是三個不同概念:
OTA
=
如何更新
Secure Boot
=
允許誰的 Firmware 執行
Flash Encryption
=
Flash 裡的內容如何保護
四十六、什麼是 OTA Rollback?
假設:
Firmware 1.2.0
OTA 更新成:
Firmware 1.3.0
但是 v1.3.0 有嚴重 Bug:
Wi-Fi 無法啟動
Sensor 無法工作
App Crash
如果沒有 Recovery 機制,設備可能就:
Remote Brick
因此產品 OTA 很重要的一項能力是:
Rollback
概念:
v1.2.0
↓
OTA
↓
v1.3.0
↓
Self Test
↓
FAIL
↓
Rollback
↓
v1.2.0
Espressif 官方 OTA 架構提供 Rollback 流程,可以在新 Application 通過功能驗證後才正式確認其有效性。
四十七、什麼是 Anti-Rollback?
Rollback:
新版有問題,可以退回前一版。
但安全上又有另一個問題。
假設:
Firmware 1.0
有安全漏洞
Firmware 2.0
已修正
攻擊者故意讓設備回到:
Firmware 1.0
就可以利用舊漏洞。
因此有:
Anti-Rollback
裝置可以設定:
Security Version >= 5
那麼:
Security Version 4
即使 Firmware 簽章正確,也不允許執行。
ESP-IDF 可使用存於 eFuse 的 Security Version 機制來拒絕低於允許安全版本的 Application。
四十八、Firmware Version 與 Security Version 不一定相同
例如:
Firmware Version
2.5.7
代表產品功能版本。
而:
Security Version
3
代表安全最低版本。
因此:
Firmware Version
用於:
功能管理
版本追蹤
Bug Tracking
Release Notes
而:
Security Version
用於:
Anti-Rollback
兩者應分開管理。
四十九、正式 Firmware Server 可以長什麼樣?
例如:
正式環境應使用自有 Firmware Server 的 HTTPS 網址。
Server 保存:
devices/
└── relay01/
├── manifest.json
├── firmware-1.0.0.bin
├── firmware-1.1.0.bin
└── firmware-1.2.0.bin
manifest.json:
{
"model": "RELAY01",
"version": "1.2.0",
"url": "由正式 Firmware Server 配發的 HTTPS 下載網址",
"sha256": "..."
}
ESP32:
Check manifest
↓
Compare Version
↓
Download
↓
Verify
↓
Install
這就是 Firmware Management 的基本雛形。
五十、不要所有設備同時更新
如果有:
10,000 台 ESP32
全部同一秒:
Download firmware.bin
Firmware Server 可能瞬間承受巨大流量。
因此真正 OTA Platform 常使用:
Staged Deployment
例如:
Stage 1
10 台 Engineering Device
Stage 2
100 台 Beta Device
Stage 3
10%
Stage 4
50%
Stage 5
100%
發現問題就停止。
這比:
一次更新所有設備
安全很多。
五十一、OTA 前應該做哪些檢查?
正式產品更新前可以確認:
Battery Voltage
Wi-Fi RSSI
Firmware Version
Flash Space
Device Model
Hardware Revision
Server Availability
例如 Battery Device:
Battery < 20%
可以暫緩 OTA。
因為 Firmware 更新期間斷電不是理想情況。
五十二、OTA 更新期間 Relay 要怎麼辦?
這是本章實作特別加入:
setRelay(false);
的原因。
假設 Relay 控制:
Heater
Pump
Motor
Power
OTA 時程式可能停止正常控制。
因此更新開始:
OTA Start
↓
Relay OFF
↓
Firmware Update
↓
Restart
↓
Initialize
這是一個重要的:
Fail-Safe Design
五十三、但不是所有設備都應該 Relay OFF
例如 Relay 控制:
冷凍設備
生命安全設備
重要工業設備
直接:
Relay OFF
反而可能有風險。
所以真正產品必須根據系統定義:
OTA Safe State
可能是:
OFF
ON
Hold Last State
Hardware Interlock
External Controller Takes Over
不能所有產品都套同一種策略。
五十四、OTA 與 Watchdog
真正產品還可能遇到:
Firmware Update
↓
Restart
↓
Application Hang
因此可以加入:
Watchdog
Health Check
Boot Count
Rollback
建立:
OTA
↓
Boot New Firmware
↓
Self Test
↓
Wi-Fi OK?
Sensor OK?
Storage OK?
↓
YES
Mark Firmware Valid
否則:
Rollback
這才是可靠 OTA。
五十五、ArduinoOTA 更新失敗常見原因
問題 1:看不到 Network Port
檢查:
PC 與 ESP32 網路
Firewall
mDNS
VPN
Router Isolation
問題 2:Authentication Failed
通常是:
OTA Password 錯誤
問題 3:Connect Failed
可能:
ESP32 Offline
IP 改變
Firewall
Wi-Fi Disconnect
ArduinoOTA.handle() 沒有執行
問題 4:Receive Failed
可能:
Network 不穩
Wi-Fi RSSI 太差
Router 問題
問題 5:Firmware 太大
檢查:
Partition Scheme
OTA App Size
Compiled Binary Size
五十六、為什麼第一次 OTA 成功,第二次卻再也找不到 ESP32?
最常見的原因之一:
你更新的新 Firmware 忘了保留 OTA 程式。
例如 Firmware v1.0:
ArduinoOTA.begin();
ArduinoOTA.handle();
有 OTA。
結果 Firmware v1.1 改成:
void loop() {
digitalWrite(
LED_PIN,
HIGH
);
}
卻把:
ArduinoOTA.handle();
刪掉。
那麼:
v1.0
↓
OTA v1.1
↓
成功
↓
v1.1 不支援 OTA
下一次只能:
USB 救回來。
因此只要產品希望持續支援 OTA:
每一版 Firmware 都必須保留 OTA 能力。
五十七、長時間 delay 也可能讓 OTA 看起來壞掉
例如:
void loop() {
ArduinoOTA.handle();
delay(60000);
}
每分鐘才處理一次 OTA。
這不合理。
應改成:
void loop() {
ArduinoOTA.handle();
handleSensor();
handleRelay();
handleLED();
}
每一個功能都使用:
Non-blocking
架構。
五十八、ESP32 OTA + Deep Sleep 會有什麼問題?
上一章學過 Deep Sleep。
如果 ESP32:
Wake 5 秒
Sleep 5 分鐘
那麼 OTA 只有醒著的 5 秒可以連線。
設備睡眠時:
Wi-Fi OFF
CPU OFF
ArduinoOTA 自然找不到它。
因此 Battery Sensor OTA 要重新設計。
例如:
Wake
↓
Check OTA Flag
↓
OTA Mode?
├─ NO → Sensor → Send → Sleep
└─ YES → 保持 Awake → OTA
五十九、低功耗設備 OTA Mode
可以設計:
正常模式
Wake
↓
Sensor
↓
Send
↓
Deep Sleep
收到 Server 命令:
OTA_REQUIRED = true
下一次 Wake:
Wake
↓
Enter OTA Mode
↓
Wi-Fi Keep Alive
↓
Firmware Update
↓
Restart
↓
Normal Mode
這就把:
第 17 章 Deep Sleep
和:
第 18 章 OTA
結合起來。
六十、ESP-NOW Sensor Node 又要如何 OTA?
如果低功耗 Sensor Node 只使用:
ESP-NOW
沒有連 Wi-Fi Router:
Sensor Node
↓
ESP-NOW
↓
Gateway
那麼 ArduinoOTA 就不能直接這樣使用。
可以設計:
Gateway
↓
ESP-NOW
↓
OTA Command
↓
Sensor Node
↓
Enable Wi-Fi
↓
Connect Router
↓
HTTPS OTA
形成完整:
ESP-NOW
+
Wi-Fi OTA
架構。
六十一、ESP32 OTA 與 MQTT 結合
第 15 章學過 MQTT。
可以設計 Topic:
devices/node01/ota
Server Publish:
{
"version": "1.3.0",
"url": "https://server/fw/node01-1.3.0.bin"
}
ESP32 收到:
Current:
1.2.0
Server:
1.3.0
於是:
MQTT
↓
OTA Command
↓
HTTPS Firmware Download
↓
Verify
↓
Update
這就是更接近商業 IoT Device Management 的架構。
六十二、完整 ESP32 IoT OTA 架構
前面章節已經學過:
Wi-Fi
BLE
MQTT
ESP-NOW
Deep Sleep
OTA
現在可以組合成:
Sensor Node
│
│ ESP-NOW
▼
ESP32 Gateway
│
│ Wi-Fi
▼
MQTT Broker
│
▼
IoT Server
│
├── Sensor Data
├── Device Status
├── Firmware Version
└── OTA Management
Firmware Server:
firmware_v1.0.bin
firmware_v1.1.bin
firmware_v1.2.bin
IoT Server 可以知道:
Node 001 → v1.2
Node 002 → v1.1
Node 003 → v1.2
Node 004 → v1.0
再決定:
哪些設備需要更新
六十三、產品 Firmware Release 建議流程
Firmware 不應該修改完就直接全部更新。
較好的流程:
Development
↓
Compile
↓
Unit Test
↓
Hardware Test
↓
OTA Test
↓
Beta Device
↓
Release Candidate
↓
Production Release
例如:
1.2.0-dev
1.2.0-beta
1.2.0-rc1
1.2.0
六十四、每一版 Firmware 建議保留 Release Notes
例如:
Firmware 1.2.0
Added:
- MQTT reconnect
- OTA password
Changed:
- Wi-Fi timeout 15s → 10s
Fixed:
- Relay boot state
- DHT22 timeout
未來 Debug 時非常有用。
否則幾個月後看到:
Firmware 1.7.3
自己可能都不知道改過什麼。
六十五、OTA Firmware 命名方式
不要每次都叫:
firmware.bin
正式管理建議:
產品名稱_硬體版本_Firmware版本.bin
例如:
ESP32_RELAY01_HW1.0_FW1.2.3.bin
或:
envnode_v1_hw2_fw2.1.0.bin
如此可以降低:
把錯誤 Firmware 更新到錯誤硬體
的風險。
六十六、Hardware Version 也必須管理
假設:
HW 1.0
Relay = GPIO26
後來:
HW 2.0
Relay = GPIO27
如果把 HW1 Firmware:
GPIO26
更新到 HW2:
GPIO27
功能可能完全錯誤。
因此 OTA Manifest 應該檢查:
Product Model
Hardware Revision
Firmware Compatibility
不能只看 Firmware Version。
六十七、OTA 更新前的產品檢查表
正式設備可以檢查:
Model correct?
Hardware correct?
Firmware newer?
Battery sufficient?
Network stable?
Firmware signature valid?
Firmware size valid?
Flash space sufficient?
全部通過才:
Update
六十八、ESP32 OTA 安全層級
可以簡單分成:
Level 1:教學
ArduinoOTA
No Password
只適合實驗。
Level 2:Maker / Lab
ArduinoOTA
+
Strong Password
+
Private LAN
Level 3:IoT Product
HTTPS OTA
+
Firmware Verification
+
Version Management
Level 4:高安全產品
HTTPS
+
Signed Firmware
+
Secure Boot
+
Flash Encryption
+
Rollback
+
Anti-Rollback
+
Device Authentication
這是一條從 Maker 走向 Product 的技術演進路線。
六十九、本章完整實作流程整理
第一次:
Arduino IDE
│
│ USB
▼
ESP32
│
├── Wi-Fi
├── ArduinoOTA
├── LED
└── Relay
ESP32 加入 Router:
ESP32
↓
Wi-Fi
↓
192.168.1.120
Arduino IDE 發現:
esp32-relay-01
修改 Firmware:
v1.0.0
↓
v1.1.0
然後:
Arduino IDE
│
│ Wi-Fi OTA
▼
ESP32
ESP32:
OTA Start
↓
Relay Safe State
↓
Receive Firmware
↓
Write New OTA Partition
↓
Complete
↓
Restart
↓
Firmware v1.1.0
這就是本章完整 ESP32 OTA 流程。
七十、本章常見問題 FAQ
Q1:ESP32 OTA 還需要 USB 嗎?
第一次通常需要。
因為必須先燒錄支援 OTA 的 Firmware。
之後才可以 Wi-Fi OTA。
Q2:OTA 一定要 Internet 嗎?
不一定。
ArduinoOTA 可以只在:
Local LAN
使用。
Q3:OTA 一定要 Router 嗎?
ArduinoOTA 最常見情況會讓 PC 與 ESP32 經由同一個 IP 網路通訊。
更進階也可以採用其他網路拓撲,但入門建議使用同一 LAN。
Q4:ESP32 OTA 可以更新整個程式嗎?
可以。
它更新的是新的 Application Firmware。
Q5:OTA 可以更新 SPIFFS / Filesystem 嗎?
OTA 架構可以處理 Application 或相應資料分區,但需要使用適合的更新流程與 Partition 配置。
官方 BasicOTA callback 也會辨識 Firmware 或 Filesystem 更新命令。
Q6:OTA Password 可以不設嗎?
技術上可以。
但不建議正式設備完全沒有 Authentication。
Q7:設定 OTA Password 就完全安全了嗎?
不是。
正式 Product 還應考慮:
HTTPS
Signed Firmware
Secure Boot
Flash Encryption
Rollback
Anti-Rollback
Q8:Firmware 太大會 OTA 失敗嗎?
會。
Firmware 必須能放進 OTA Application Slot。
Q9:為什麼 Arduino IDE 找不到 ESP32?
檢查:
Wi-Fi
IP Network
mDNS
Firewall
VPN
Router Isolation
ArduinoOTA.handle()
Q10:OTA 更新後還能再 OTA 嗎?
可以。
但新的 Firmware 必須繼續保留:
ArduinoOTA.begin();
ArduinoOTA.handle();
七十一、ESP32 OTA、MQTT、ESP-NOW、Deep Sleep 的關係
到目前為止,可以把 ESP32 IoT 技術整理成:
Wi-Fi
│
├── HTTP
│
├── MQTT
│
└── OTA
裝置對裝置:
ESP32
│
└── ESP-NOW
低功耗:
ESP32
│
└── Deep Sleep
無線維護:
ESP32
│
└── OTA
因此真正完整 Sensor Node 可以是:
Wake
↓
Read Sensor
↓
ESP-NOW / Wi-Fi
↓
Send Data
↓
Check OTA
↓
Deep Sleep
七十二、本章重點整理
完成本章後,應該掌握以下重要觀念。
1. OTA
OTA 是:
Over The Air
讓 ESP32 透過無線網路更新 Firmware。
2. 第一次仍需要 USB
第一次必須先將 OTA 功能燒入 ESP32。
之後才能:
Wi-Fi Update
3. ArduinoOTA
核心 Library:
#include <ArduinoOTA.h>
初始化:
ArduinoOTA.begin();
處理:
ArduinoOTA.handle();
4. Hostname
建議每台設備設定唯一 Hostname:
ArduinoOTA.setHostname(
"esp32-relay-01"
);
5. Password
至少加入:
ArduinoOTA.setPassword(
"StrongPassword"
);
避免完全沒有 OTA Authentication。
6. Firmware Version
每一版 Firmware 都應該有:
1.0.0
1.1.0
1.1.1
2.0.0
才能建立正常 Firmware Management。
7. OTA Partition
可靠 Application OTA 通常使用:
ota_0
ota_1
ota_data
新的 Firmware 先寫到非目前執行的 OTA Slot。
8. Non-blocking Programming
使用 ArduinoOTA 時:
ArduinoOTA.handle();
必須頻繁執行。
因此避免大量:
delay()
而改用:
millis()
建立 Non-blocking 程式。
9. OTA Safe State
Firmware Update 開始前,Relay、Motor、Heater 等輸出應進入預先定義的安全狀態。
10. Product OTA
正式產品不能只停留在:
ArduinoOTA + Password
而應逐步發展到:
HTTPS
Firmware Signature
Secure Boot
Flash Encryption
Rollback
Anti-Rollback
Firmware Management
七十三、本章實作成果
本章完成:
ESP32 Wi-Fi OTA LED / Relay Controller
系統:
Arduino IDE
│
│ Wi-Fi OTA
▼
Router
│
▼
┌────────────────┐
│ ESP32 │
│ │
│ ArduinoOTA │
│ Firmware │
│ Version │
│ Password │
│ LED │
│ Relay │
└────────────────┘
第一次:
USB
↓
Firmware v1.0
之後:
Wi-Fi
↓
Firmware v1.1
↓
Firmware v1.2
↓
Firmware v2.0
不需要再拆設備接 USB。
這代表 ESP32 已經從單純:
Maker 開發板
向真正:
可部署、可維護、可升級的 IoT Product
跨出非常重要的一步。
七十四、從 ESP32 Maker 到 Product 的完整思維
如果把前面幾章串起來:
ESP32 GPIO
↓
Sensor
↓
Wi-Fi
↓
BLE
↓
MQTT
↓
ESP-NOW
↓
Deep Sleep
↓
OTA
就可以形成:
┌────────────────────┐
│ ESP32 IoT Node │
│ │
│ Sensor │
│ GPIO │
│ Wi-Fi │
│ MQTT │
│ ESP-NOW │
│ Deep Sleep │
│ OTA │
└─────────┬──────────┘
│
▼
IoT Server
│
├── Data
├── Control
├── Device Status
└── Firmware Management
ESP32 不再只是:
LED Blink
而開始具備真正 IoT Product 所需要的:
Connectivity
Remote Control
Low Power
Remote Maintenance
Firmware Upgrade
Security
能力。
而其中:
OTA Firmware Update
正是產品交付之後,能不能持續修正 Bug、增加功能與維護設備的關鍵技術之一。