這是「ESP32 物聯網實戰」系列第一集的總整理。同一顆 DS18B20 溫度感測器,我在 2023 年陸續試了四種把讀值送出去的方法:序列埠接 C# 畫曲線、藍牙 SPP 上手機、公用 MQTT broker 接 Node-RED、在 Raspberry Pi 自架 Mosquitto 再用 cpolar 開通道。這篇把五篇原文串成一條線,並整理每條路的坑。
This is the wrap-up of EP1 of the "ESP32 IoT in Practice" series: one DS18B20 sensor, four ways to move its reading — serial to a C# chart, Bluetooth SPP to a phone, a public MQTT broker to Node-RED, and a self-hosted Mosquitto broker on a Raspberry Pi exposed through a cpolar tunnel.
本集用到的原文 | Original posts
- ESP32 one Wire Bus Application – DS18B20 section(2023/07)
- ESP32與DS18B20溫度感測器的C#圖形化資料收集(2023/01)
- DS18B20 temperature recorder - ESP32 Bluetooth SPP control(2023/07)
- ESP32 MQTT Publish/Subscribe DS18B20 Temperature to Node-Red(2023/08)
- Raspberry Pi self-hosted MQTT environment for Internet of Thing(2023/08)
第一章 DS18B20 與 1-Wire
一條資料線、每顆 64 位元序號、一條線可掛多顆;12 位元轉換要 750 ms,上電預設 85°C、斷線讀到 -127。DQ 要 4.7kΩ 上拉,ESP32 建議接 3.3V。序列埠指令 VER/DS18B20_ON/DS18B20_OFF(小寫自動轉大寫,用 strstr 比對)。
第二章 序列埠+C# 曲線
Node5 把溫度包成 JSON 經 Mesh 交給接 USB 的 Node1,C# 解析後畫曲線;手握探頭,不到 40 秒從約 23.7°C 升到 31°C。兩個坑:requestTemperatures 卡 750 ms、C# DataReceived 收到半行要先緩衝。
第三章 藍牙 SPP 上手機
BluetoothSerial 開「BT_BS18B20」,送「E+溫度」給手機 App 畫曲線。程式一輪呼叫兩次轉換(約 1.5 秒一筆)、手機端指令函式是空的;ESP32-S3/C3 與 iPhone 要改 BLE。
第四章 MQTT+Node-RED
公用 broker mqtt.eclipseprojects.io,發布 winsondiy/ESP32/temp 與環保署新竹 PM2.5,訂閱 winsondiy/ESP32/led 控制 GPIO16;先用 MQTT Explorer 驗證,再接 Node-RED。公用 broker 人人可讀寫,只適合測試。
第五章 Pi 自架 Mosquitto+cpolar
apt 安裝 mosquitto、兩個終端機 sub/pub 測試、一行腳本裝 Node-RED,cpolar 把本機 1883 開成 1.tcp.cpolar.io:10521,ESP32 只改 server 與 port。Mosquitto 2.0 預設只聽本機,區網直連要加 listener 與帳密。
第六章 四條路怎麼選
桌邊量測用序列埠、現場看用藍牙、快速驗證用公用 MQTT、長期使用自架 broker。下一集:沒有路由器也能組網的 ESP32 WiFi Mesh。
補充:原文沒寫到的原理與常見坑
補充一:DS18B20 與 1-Wire 重點
DS18B20 是 1-Wire 數位溫度感測器:一條資料線 DQ 同時負責傳指令和回資料,每顆出廠都有唯一的 64 位元 ROM 序號,所以同一條線可以並聯很多顆,用序號分辨。
| 項目 | 規格(datasheet) |
|---|---|
| 量測範圍 | -55~+125°C |
| 精度 | ±0.5°C(-10~+85°C) |
| 解析度/轉換時間 | 9 位元 93.75 ms、10 位元 187.5 ms、11 位元 375 ms、12 位元 750 ms(0.0625°C) |
| 電源 | 3.0~5.5V,也可寄生供電 |
| 特殊讀值 | 上電預設 +85°C;DallasTemperature 讀不到時回 -127(DEVICE_DISCONNECTED_C) |
接線注意:DQ 要有 4.7kΩ 上拉到 VCC(小模組板通常已焊好,防水探頭要自己加)。原文電路是 5V 供電、資料接 GPIO4;若上拉接 5V,DQ 閒置就是 5V,超過 ESP32 GPIO 的 3.3V 額定,建議 DS18B20 改接 3.3V。
補充二:讀溫度不要卡住主迴圈
requestTemperatures() 預設會等轉換完成才返回,12 位元要等 750 ms。主迴圈還要處理 Mesh、藍牙或 MQTT 時,改成「先發轉換、下一輪再讀」:
sensors.setResolution(12);
sensors.setWaitForConversion(false); // 不等 750 ms
sensors.requestTemperatures();
unsigned long last = 0;
void loop() {
if (millis() - last >= 2000) { // 間隔要大於轉換時間
last = millis();
float t = sensors.getTempCByIndex(0); // 上一輪的結果
sensors.requestTemperatures(); // 立刻發下一次
if (t != DEVICE_DISCONNECTED_C) { /* 送出 t */ }
}
// 其他工作:mesh.update()/MQTTClient.loop()…
}
(範例程式未實機編譯。)
補充三:藍牙 SPP 的限制
- SPP(Serial Port Profile)是傳統藍牙(Classic BT)的「無線序列埠」,Arduino-ESP32 的
BluetoothSerial用起來跟Serial一樣。 - 只有原始 ESP32 有傳統藍牙;ESP32-S3、ESP32-C3 只有 BLE,沒有
BluetoothSerial,要改用 BLE(例如 Nordic UART Service)。 - iPhone 一般 App 不能用傳統藍牙 SPP,要給 iPhone 看也得改 BLE。
- 原文 SPP 版程式在
flag.DS18B20Flag == 1時,先呼叫vDS18B20Task()(裡面已 requestTemperatures 一次),接著又 requestTemperatures 一次,等於一輪等兩次轉換,12 位元下約 1.5 秒才送一筆(由程式推算);只呼叫一次即可。 - 原文
BTprocessCommand()是空函式,所以 DS18B20_ON/OFF 仍從 USB 序列埠下;要從手機開關,把processCommand()的判斷搬進去即可。SerialBT.readString()會等到逾時(預設 1 秒)才返回,指令短的話改用readStringUntil('\n')。
補充四:MQTT 要知道的幾件事
- topic 用斜線分層,原文用
winsondiy/ESP32/temp、winsondiy/ESP32/pm2.5_avg(發布)、winsondiy/ESP32/led(訂閱);訂閱端可用+、#萬用字元,例如winsondiy/ESP32/#。 - QoS 0/1/2:0 送了就算、1 至少一次、2 剛好一次。PubSubClient 發布只支援 QoS 0,訂閱可 0 或 1;預設封包上限 256 位元組(
setBufferSize()可調),keepalive 15 秒。 - retain:broker 保留最後一筆,新訂閱者一連上就拿到,適合「目前溫度」。遺囑(Last Will):裝置斷線時 broker 代發,例如
status = offline。 - 公用 broker(mqtt.eclipseprojects.io、test.mosquitto.org)不用註冊,但任何人都能訂閱、也能發布到你的 led topic;只適合測試,topic 前綴取得獨特一點。
loop()裡每 5 秒做一次 HTTPS 查詢(環保署 API),查詢期間MQTTClient.loop()跑不到;API 很慢時,可把查詢拉長間隔(PM2.5 每小時才更新),或放到另一個 FreeRTOS 任務。原文程式的間隔是 5000 ms,註解寫「每10秒」,以程式為準。
補充五:Pi 自架 Mosquitto 的設定坑
Mosquitto 2.0 起,沒有設定 listener 時只聽本機(127.0.0.1)。原文用 cpolar 從 Pi 本機轉送 1883,所以不受影響;但同一個區網的 ESP32 直接連 Pi 的 IP 會被拒絕。要讓區網連線,在 /etc/mosquitto/conf.d/ 加一個檔:
listener 1883 allow_anonymous false password_file /etc/mosquitto/passwd
用 sudo mosquitto_passwd -c /etc/mosquitto/passwd esp32 建帳號,重啟 sudo systemctl restart mosquitto;ESP32 端把 MQTTUser/MQTTPassword 填上。透過 cpolar 對外公開時更要設帳密。通道重開後位址或埠號若改變,ESP32 程式的 MQTTServer、MQTTPort 要跟著改;固定位址或改走 Tailscale 等 VPN 可避免(見本系列 EP3)。
補充六:四條路怎麼選
| 方式 | 距離 | 需要網路 | 適合 |
|---|---|---|---|
| 序列埠+C# | USB 線(或 Mesh 接力) | 不用 | 桌邊量測、產線治具、要存檔畫圖 |
| 藍牙 SPP | 約 10 公尺 | 不用 | 現場用手機看、單人單機 |
| 公用 MQTT | 有網路就行 | 要 | 快速驗證、多人同時看 |
| 自架 MQTT+通道 | 有網路就行 | 要 | 長期使用、資料自己管 |
ESP32 物聯網實戰系列 | ESP32 IoT in Practice
- EP1:一顆溫度感測器的四條路(本篇)
- EP2:沒有路由器的網路:ESP32 WiFi Mesh(製作中)
- EP3:Pi 5 當 IoT 閘道:熱點、Tailscale、OTA 與繼電器(製作中)
- EP4:省電與感測進階:深度睡眠、語音控制、WiFi CSI(製作中)



































