手機打開一個網頁,按一下,遠處的 ESP32 就把繼電器吸合;要改韌體也不用拔 USB 線,Pi 5 透過 WiFi 把新版推過去。萬一新版有問題,ESP32 會自己退回舊版。這篇是這個專題的完整規劃:ESP32 和 4 路繼電器板怎麼接、ESP32 的兩顆核心怎麼分工跑 OTA 和控制、Pi 5 端的介面怎麼設計。韌體已經在 Pi 5 上編譯通過,Pi 5 端程式和網頁用模擬的 ESP32 測過;實機燒錄和接線測試是下一步,文末會講清楚哪些還沒驗證。
一、為什麼要讓 ESP32 來控制繼電器
這片 4 路繼電器板原本是直接接在 Pi 5 的 GPIO 上。這樣可以動,但有三個問題:
- 距離:繼電器要放在被控制的設備旁邊(例如測試治具的電源),Pi 5 不一定在旁邊;GPIO 線拉長容易受干擾。
- 數量:想控制好幾組設備時,每組都要一台 Pi 太貴;ESP32 一片幾百元,Pi 5 當中控就好。
- 維護:ESP32 裝進治具後要改程式,每次都拆下來接 USB 很麻煩,所以一定要能無線更新韌體(OTA)。
所以架構改成:Pi 5 當中控,跑網頁和韌體管理;ESP32 當遠端 IO,負責實際開關繼電器,兩者走 WiFi。
圖說:Pi 5(裝 AI NVMe 擴充板),目前繼電器板就是從這排 GPIO 接出去
圖說:ESP32-WROOM-32 DevKit(CP2102 USB 轉序列),雙核 Xtensa LX6,WiFi 內建
二、硬體與接線規劃
先看懂這片繼電器板
圖說:4 路繼電器板:繼電器是 SRD-05VDC-SL-C(線圈 5 V,接點 10 A 250 VAC),每路前面有一顆光耦
市面上這種藍色 4 路板的電路大同小異:輸入排針是 GND IN1 IN2 IN3 IN4 VCC,旁邊還有一組 JD-VCC VCC GND 的 3 pin 排針,平常用跳線帽把 JD-VCC 和 VCC 短接。每一路的路徑是:VCC → 電阻 → 光耦 LED → 指示燈 → INx。所以 INx 拉低時電流流過光耦,光耦導通,電晶體推動繼電器線圈吸合,也就是「低電位觸發」。
為什麼要拔掉 JD-VCC 跳線
如果跳線帽不拔、VCC 接 5 V,ESP32 輸出「高」只有 3.3 V,光耦那一串兩端還剩 5 − 3.3 = 1.7 V。能不能完全斷開要看板子:指示燈和光耦 LED 串在一起的板子,兩顆合計要將近 3 V 才會亮,1.7 V 不夠,直接接也能動;只有光耦 LED(順向電壓約 1.2 V)的板子,就可能有微小電流,繼電器狀態不確定。下面這個接法兩種板子都穩,而且繼電器線圈的電流不會經過 ESP32 的 3.3 V 穩壓器:
- 拔掉 JD-VCC 跳線帽。
- 輸入排針的 VCC 接 ESP32 的 3.3 V:光耦這一側只用 3.3 V,ESP32 輸出高電位時 LED 兩端是 0 V,完全不亮。
- JD-VCC 接外部 5 V:專門給繼電器線圈。這種線圈一顆大約 70~80 mA,四顆全吸約 300 mA,建議用 5 V 1 A 以上的電源,不要從 ESP32 的 3.3 V 穩壓器拉。
圖說:接線圖:3V3→VCC(光耦)、GND→GND、GPIO26/27/32/33→IN1~IN4,JD-VCC 跳線拔掉、接外部 5 V
腳位怎麼挑
| 繼電器板 | ESP32 | 說明 |
|---|---|---|
| VCC | 3V3 | 光耦電源(拔掉 JD-VCC 跳線後) |
| GND | GND | 和外部 5 V 電源共地 |
| IN1 | GPIO26 | 都不是 strapping 腳,開機時不會輸出脈衝 |
| IN2 | GPIO27 | |
| IN3 | GPIO32 | |
| IN4 | GPIO33 | |
| JD-VCC | (外部 5 V) | 繼電器線圈電源 |
挑腳的原則是開機那一瞬間不能讓繼電器跳一下。ESP32 有幾支腳要避開:GPIO0、2、5、12、15 是開機時讀電位決定開機模式的 strapping 腳,有的開機時還會輸出 PWM;GPIO1、3 是 USB 序列埠;GPIO6~11 接著 SPI flash;GPIO34~39 只能輸入。GPIO26、27、32、33 開機時是高阻抗輸入,這時 IN 腳被光耦那一側拉到 VCC,繼電器保持斷開,剛好是我們要的安全狀態。
安全提醒:繼電器接點標 10 A 250 VAC,但這種板子的走線間距和端子不適合長時間接近上限,接市電負載時要有外殼、保險絲,接線前一定斷電。這篇的測試用低壓負載(例如 DUT 的 12 V 電源)比較安全。
三、韌體:core 0 跑網路,core 1 跑繼電器
ESP32 是雙核心:core 0(PRO_CPU)和 core 1(APP_CPU)。ESP-IDF 的 WiFi 驅動和 TCP/IP 本來就跑在 core 0,所以把所有網路相關的事都放 core 0,繼電器控制單獨放 core 1。網路再忙(HTTP 請求、下載韌體),都不會拖慢繼電器的計時。
圖說:雙核分工:兩邊只透過指令佇列和狀態快照溝通
core 1:唯一碰 GPIO 的繼電器任務
規則只有一條:只有 core 1 的 relay 任務可以動 GPIO。網頁按鈕、OTA、failsafe 想動繼電器,都只能丟一個指令進 FreeRTOS 佇列,由 relay 任務照順序處理。這樣不會有兩個地方同時改同一支腳的競爭問題。relay 任務每 5 ms 跑一圈:
- 處理指令:on/off/toggle/pulse(點動)/all off。
- 點動到期:例如「吸合 0.3 秒」模擬按開機鍵,時間到自己斷開。這段計時在 core 1,不會因為 WiFi 卡住而被拉長。
- 最短切換間隔 100 ms:同一路兩次切換至少隔 100 ms,保護繼電器接點,也擋掉網頁連點。
- 心跳逾時 failsafe:Pi 每 5 秒送一次心跳,設定時間內沒收到就全部斷開。Pi 當機或 WiFi 斷了,負載不會一直通電;這個判斷在 ESP32 自己身上,不靠 Pi。
- safe 狀態:OTA 前全部斷開並鎖住,更新期間不接受控制。
static void task(void *) {
RelayCmd c;
for (;;) {
// 最多等 5 ms:沒有指令也要定時檢查脈衝到期與心跳逾時
bool got = xQueueReceive(q, &c, pdMS_TO_TICKS(5)) == pdTRUE;
uint32_t now = millis();
if (got) handle(c, now);
for (uint8_t i = 0; i < 4; i++)
if (pulseEnd[i] && (int32_t)(now - pulseEnd[i]) >= 0) { /* 點動到期 → 斷開 */ }
if (st.failsafeS && st.on && now - st.lastHeartbeatMs > st.failsafeS * 1000UL)
allOff(now); // Pi 失聯:全部斷開
}
}
// core 1、優先權 3(比網路任務高)
xTaskCreatePinnedToCore(task, "relay", 4096, nullptr, 3, nullptr, 1);
開機時還有一個小細節:先把輸出準位設成「斷開」,再把腳切成輸出。順序反過來的話,腳一切成輸出的瞬間是低電位,低電位觸發的繼電器會跳一下。
for (uint8_t i = 0; i < 4; i++) {
digitalWrite(RELAY_PINS[i], HIGH); // 低電位觸發:HIGH=斷開
pinMode(RELAY_PINS[i], OUTPUT);
}
網頁要顯示狀態時,core 0 不直接讀 relay 任務的變數,而是在臨界區(portMUX)裡複製一份快照,避免讀到改到一半的資料。
core 0:WiFi、HTTP API 與 OTA
core 0 的 net 任務負責 WiFi 連線與斷線重連、mDNS(esp32-relay.local)、HTTP API,以及兩種 OTA。
WiFi 設兩個 AP:這片 ESP32 會在公司和家裡兩邊用,所以用 WiFiMulti 同時登記公司的 DQA-WPA3 和家裡的 winson2.4,開機時掃描、連訊號最強的已知 AP,斷線後也重新掃描,換地方不用改程式。要注意 ESP32-WROOM-32 只支援 2.4 GHz,家裡的 5 GHz SSID 列進去也連不上。DQA-WPA3 是 WPA2/WPA3 混合模式,在第 9 頻道(2.4 GHz),ESP32 可以連。SSID 和密碼放在 secrets.h,不進 git。
API 很簡單,用 curl 就能測:
| API | 用途 |
|---|---|
GET /api/state | 韌體版本、IP、連上的 SSID 與 RSSI、開機時間、執行中分割區與確認狀態、4 路狀態、OTA 進度 |
POST /api/relay?ch=1&op=on|off|toggle|pulse&ms=300 | 控制單路 |
POST /api/all | 全部斷開 |
POST /api/heartbeat | Pi 的心跳(failsafe 用) |
POST /api/failsafe?s=30 | 設定心跳逾時秒數(存 NVS) |
POST /api/ota?url=…&md5=…&ver=… | 叫 ESP32 去 Pi 拉新韌體 |
會改變狀態的 API 都要帶 X-Token 標頭,免得同網段任何人都能開關繼電器。ESP32 也內建一個簡單的備用網頁:Pi 掛掉時,手機直接連 ESP32 還是能控制。
四、OTA:兩種更新方式與自動回滾
分割區選 min_spiffs,有兩個 1.9 MB 的 app 分割區(app0、app1)。韌體目前 1.1 MB,放得下。OTA 永遠寫「另一個」分割區,寫完才切過去,所以寫到一半斷電也不會變磚,舊版還在。
- ArduinoOTA(espota 推):Arduino IDE、PlatformIO 內建的方式,Pi 上跑 espota.py 推過去。適合開發時快速更新,但沒有版本管理。
- HTTP 拉(平常用這個):Pi 告訴 ESP32「去這個網址拉新韌體,MD5 是多少、版本是多少」,ESP32 自己下載,邊下載邊寫進另一個分割區,最後比對 MD5。整包不用放 RAM(ESP32 也放不下 1 MB),下載中斷或 MD5 不符就放棄,舊版照跑。
圖說:OTA 流程:正常走上面一排;下載失敗或新版沒通過確認,都會留在/回到舊版
更新前為什麼要先把繼電器全部斷開
ESP32 的程式是從外部 flash 執行的。寫 flash 時,兩顆核心都會短暫停住,core 1 的繼電器任務也一樣。我之前在 ESP32-S3 平衡車上量過:OTA 寫入期間,控制迴圈最長被卡住 426 ms。如果這時候某一路正在「點動 0.3 秒」,就可能變成通電將近 0.8 秒。所以 OTA 開始前,core 0 先丟一個 R_SAFE 指令給 core 1:全部斷開、鎖住,並等 core 1 回報 safe 了才開始寫。更新失敗時再解鎖。
新韌體壞掉怎麼辦:自我確認與回滾
ESP32 的 bootloader 支援 app 回滾(Arduino-ESP32 3.3.12 的設定有開 CONFIG_BOOTLOADER_APP_ROLLBACK_ENABLE,我去 sdkconfig 確認過)。新韌體第一次開機時,狀態是「待確認」(pending verify),要由程式自己宣告「我沒問題」。這個專題的規則:
- 覆寫
verifyRollbackLater()回傳 true,讓 Arduino core 開機時不要自動把新版標成有效。注意它是 C 函式,要加extern "C"才覆寫得到。這是我在平衡車專案踩過的坑:沒加的話,新韌體一開機就被當成有效,回滾永遠不會發生。 - WiFi 連上、而且 core 1 的繼電器任務確實在跑(迴圈計數有在增加),持續 20 秒 →
esp_ota_mark_app_valid_cancel_rollback()。 - 60 秒內還沒確認(例如新版 WiFi 密碼寫錯,永遠連不上)→ 主動呼叫
esp_ota_mark_app_invalid_rollback_and_reboot()。只靠 bootloader 不夠:回滾只發生在「待確認狀態下重開」時,新版如果沒當機、只是一直連不上網,它就永遠不會重開,也就永遠不會回滾。
extern "C" bool verifyRollbackLater() { return true; }
static void rollbackIfStuck() {
if (!validated && millis() > ROLLBACK_AFTER_MS && strcmp(ota_img_state(), "pending_verify") == 0)
esp_ota_mark_app_invalid_rollback_and_reboot(); // 回到舊版
}
Pi 端怎麼知道結果?看 ESP32 重開後回報的版本:等於新版、而且已確認 → 成功;變回舊版 → 回滾了。另外 Pi 怎麼知道上傳的 .bin 是哪一版?韌體裡放了一串固定的標記 ESP32-4RELAY-FW:1.0.0,Pi 讀檔就找得到。這串字要在程式裡真的被用到(開機時印出來),不然連結器會把它當成沒用的資料拿掉;我第一次編譯就被拿掉了。
實機 OTA 步驟(照著做)
第一次一定要用 USB 燒(板子裡還沒有會 OTA 的程式),之後全部從 Pi 5 的網頁更新,ESP32 不用再接電腦。以下是 11/16 實機跑的流程,截圖都是當時的畫面:
- 改版本號:
config.h的FW_VERSION往上加(例如 1.1.0 → 1.1.1)。Pi 是靠韌體裡的版本標記認版本,不是看檔名,所以版本號一定要改,不然判斷不出成功還是回滾。 - 編譯:
tools/build.sh,在 Pi 5 上用 arduino-cli 編,產出build/esp32_4relay.ino.bin。要的是這個 app 檔,不是 merged 或 bootloader(網頁上傳時會檢查第一個 byte 是不是 0xE9)。 - 上傳到 Pi:網頁「韌體更新(OTA)」按「上傳 .bin」,或直接把檔案放進 Pi 的
hub/firmware/。列表會顯示從檔案裡讀到的版本、大小、MD5,目前在跑的那版標「執行中」。 - 選裝置:上方分頁點要更新的那一片(多片時一片一片更新,其他片照常運作)。
- 按「更新到這版」:跳出確認框,提醒繼電器會先全部斷開、更新中不能控制、新版沒通過確認會自動回到舊版。
- 下載+寫入:ESP32 先把四路全部斷開並鎖住,再到 Pi 下載、邊下載邊寫進另一個 app 分割區,進度條即時更新。這段期間按繼電器會被拒絕。
- 重開+自我確認:寫完、MD5 對了就重開,從新分割區開機,狀態是「待確認」。WiFi 連上、繼電器任務正常跑滿 20 秒,才把自己標成有效。
- 完成:Pi 看到版本=目標、而且已確認,就顯示完成和總秒數;事件紀錄會留下整段過程。如果 60 秒內沒確認,ESP32 會自己回到舊版,網頁顯示「已回滾」。
圖說:步驟 6:寫入 flash 46%,繼電器已全部斷開、暫停控制,更新按鈕全部鎖住
圖說:步驟 7:新版 1.1.0 已經開機(列表的「執行中」跳到 1.1.0),等它通過 20 秒自我確認
圖說:步驟 8:五步全綠,1.1.1 → 1.1.0 共 72 秒(含 20 秒自我確認)
圖說:事件紀錄:OTA 開始 → 斷線重開 → 以新版在 app0「待確認」連上 → 20 秒後 OTA 成功。分割區在 app0/app1 之間輪流切換
實機量到的時間:1.1.0 → 1.1.1 → 1.1.0 → 1.1.1 三次分別是 46、72、49 秒,其中 20 秒是故意等的自我確認,下載加寫入 1.1 MB 大約 10~20 秒,其餘是重開和重新連上 WiFi。
五、Pi 5 端:relay hub 與介面設計
Pi 5 上跑一支 Python 程式(只用標準函式庫,不用另外裝套件),用 systemd 常駐,提供網頁 http://<Pi>:8096。它每秒向 ESP32 問一次狀態、每 5 秒送心跳,並把韌體檔放在自己身上給 ESP32 來拉。介面設計的幾個方向:
- 狀態一眼看懂:每路一張卡片,吸合是綠色大字,斷開是灰色;點動中顯示倒數「9.9 秒後斷開」。
- 按鈕夠大、手機好按:桌機四張卡片一排,手機兩張一排,深色、淺色跟著系統。
- 名稱可以改:「繼電器 1」改成「DUT 電源」,事件紀錄也用新名字,事後查比較清楚。
- 緊急動作最醒目:紅色「全部斷開」橫跨整排;failsafe 時間就放在旁邊。
- 危險操作要確認:OTA 前跳確認框,說明「繼電器會先全部斷開、更新期間不能控制、新版沒通過確認會自動回到舊版」。
- 更新過程看得到:送出 → 下載+寫入(進度條)→ 重開 → 自我確認 → 完成,五個步驟亮燈;失敗或回滾會停在那一步、顯示原因。
- 不能用的時候就鎖住:ESP32 離線或更新中,控制按鈕全部變灰,上方顯示原因。
- 每個動作都留紀錄:誰在什麼時間吸合、點動、更新到哪一版,全部進事件紀錄。
圖說:控制台:第 1 路改名「DUT 電源」,第 2 路點動中(倒數),下面是 ESP32 狀態與韌體列表(畫面是接模擬 ESP32 拍的)
圖說:更新中:繼電器已全部斷開、按鈕鎖住,步驟列顯示「下載+寫入 25%」
圖說:手機(深色):卡片兩張一排,大按鈕好按
以上三張是開發初期接模擬 ESP32 拍的。下面是 11/16 接上實機後的畫面(ESP32 第二片,韌體 1.1.1)。
圖說:實機畫面:上方是裝置分頁(綠點在線、紅點離線),第 1 路吸合、第 3 路點動倒數中;狀態區看得到主機名稱、MAC、跑在哪個分割區
圖說:手機(深色):分頁、卡片兩張一排
後來加的:一個網頁管多片 ESP32
第二片 ESP32 上線後,兩片燒同一份韌體會撞名(都叫 esp32-relay.local)。韌體 1.1.0 起改成主機名稱帶 MAC 後 4 碼,例如 esp32-relay-c540,並在 mDNS 多廣播一個 _esp32relay._tcp 服務。Pi 端每 30 秒送一次 mDNS 查詢,找到新的就自動加進上方分頁,IP 變了也會自己更新;這段用 Python 標準函式庫直接組 DNS 封包,不用另外裝 avahi-utils。舊版或不同網段的板子,可以按「+ 加入裝置」輸入 IP。每片各自輪詢、心跳、OTA,事件紀錄前面標是哪一片。
按下去要等一下?先查網路
實機一開始覺得按吸合、斷開反應慢。量了才發現有三層:ESP32 回應時繼電器任務還沒做完、Pi 沒用那份回應而是等下一輪輪詢、網頁一秒才更新一次,最多疊到 2 秒。程式這邊改成韌體 1.1.1 等 core 1 做完才回應、Pi 直接用回應更新、網頁按下就先變色。
但最大的原因其實是 Pi 5 的 WiFi 省電模式:訊號 -34 dBm 很好,ping 路由器卻平均 173 ms、最高 383 ms。關掉省電(iw dev wlan0 set power_save off,再用 nmcli 把 powersave 設成 2 永久生效)後降到平均 44 ms,網頁按鍵從 0.4~1.4 秒變成 0.04~0.18 秒。Raspberry Pi 用 WiFi 當伺服器,這個設定值得先檢查。
沒有實機時怎麼開發 Pi 端?我另外寫了一支模擬 ESP32(mock_esp32.py),API 跟韌體一模一樣,OTA 時也會真的去 Pi 下載 .bin、比對 MD5、讀版本標記,再假裝重開;檔名有 rollback 的會假裝新版沒通過確認、回到舊版。上面的網頁截圖都是接它拍的。
六、目前測到哪裡
| 項目 | 結果 |
|---|---|
| 韌體編譯 | ✔ Pi 5 上 arduino-cli、esp32 core 3.3.12 編譯通過,1,151,200 bytes(app 分割區 1.9 MB) |
| Pi 端網頁+API(模擬 ESP32) | ✔ 改名、吸合、點動倒數、全部斷開 |
| OTA 流程(模擬 ESP32) | ✔ 1.0.0 → 1.1.0:更新中繼電器全部斷開、鎖住,重開後切到 app1、自我確認,全程 31 秒(模擬的時間,不代表實機) |
| 回滾判斷(模擬 ESP32) | ✔ 新版沒通過確認 → Pi 看到版本變回 1.0.0,顯示「已回滾」 |
| 開發中抓到的 bug | Pi 端在 ESP32 斷線那一刻持鎖寫紀錄,鎖重複取得造成死結,OTA 卡在「重開中」(模擬測試抓到,已改成可重入鎖) |
| 實機 USB 第一次燒錄(兩片) | ✔ 經 Pi 5 USB(CP2102)燒錄,開機連上 DQA-WPA3、Pi 用 mDNS 找到、20 秒後自我確認 |
| 實機 API 控制(未接繼電器板) | ✔ 吸合、點動自動斷開、全部斷開,狀態正確 |
| 實機 OTA | ✔ 1.1.0 → 1.1.1 共 46 秒、1.1.1 → 1.1.0 共 72 秒,app0/app1 輪流切換,更新中繼電器鎖住 |
| 多片管理 | ✔ 主機名稱帶 MAC、mDNS 自動加入分頁 |
| 按鍵反應 | ✔ 0.4~1.4 秒 → 0.04~0.18 秒(主因 Pi 5 WiFi 省電) |
| 繼電器板改接到 ESP32 | ✔ 已接 |
| 開機會不會跳、3.3 V 光耦是否完全斷開、四路全吸 5 V 壓降 | ☐ 還沒量 |
| 實機回滾(故意燒壞版本) | ☐ 還沒做 |
七、下一步
- 實測:開機時繼電器會不會跳一下、3.3 V 驅動光耦是否完全斷開、四路全吸時 5 V 電源壓降。
- 實機回滾:故意燒一版 WiFi 密碼錯的韌體,確認 60 秒後會回到舊版。
- 網路:實機確認公司(DQA-WPA3)和家裡(winson2.4)兩邊都連得上、換地方會自動換 AP。Pi 5 要和 ESP32 在同一個網段(mDNS 才找得到);如果 Pi 用有線網路,也可以讓 Pi 的 WiFi 開熱點專門給 ESP32 用。
- 擴充:排程(幾點開、幾點關)、MQTT 推播狀態、多片一起動作(群組)。















沒有留言:
張貼留言