簡(jiǎn)介一套基于Arduino開(kāi)發(fā)板的物聯(lián)網(wǎng)植物養(yǎng)護(hù)系統(tǒng)是面向單片機(jī)與嵌入式學(xué)習(xí)者的完整項(xiàng)目資源能夠直接應(yīng)用于畢業(yè)設(shè)計(jì)、課程設(shè)計(jì)、期末大作業(yè)、工程實(shí)訓(xùn)以及各類學(xué)科競(jìng)賽。項(xiàng)目已經(jīng)過(guò)博主嚴(yán)格測(cè)試功能正常拿到資料后按照引腳定義接線并燒錄源碼即可復(fù)現(xiàn)不需要自行繪制電路板使用面包板、杜邦線和傳感器模塊即可完成硬件部分。整個(gè)壓縮包共十一個(gè)文件體積僅一兆左右內(nèi)容涵蓋核心程序源碼、顯示字庫(kù)文件、外殼三維模型、項(xiàng)目說(shuō)明文檔、手機(jī)端界面設(shè)計(jì)以及若干輔助圖片從硬件結(jié)構(gòu)到上位機(jī)交互都有覆蓋。其中字庫(kù)基于常見(jiàn)圖形庫(kù)編寫可支持屏幕清晰顯示外殼模型可直接用于三維打印快速獲得實(shí)體結(jié)構(gòu)說(shuō)明文檔方便對(duì)照接線與調(diào)試。目前已有兩百余人學(xué)習(xí)使用尤其適合缺乏項(xiàng)目經(jīng)驗(yàn)的學(xué)生快速入門這套資源既可以作為課程設(shè)計(jì)或競(jìng)賽的直接方案也能在此基礎(chǔ)上繼續(xù)擴(kuò)展自動(dòng)澆灌、光照調(diào)節(jié)、遠(yuǎn)程監(jiān)控等更多功能是一個(gè)高性價(jià)比的嵌入式物聯(lián)網(wǎng)練手項(xiàng)目。1. 從花被澆死說(shuō)起Arduino 物聯(lián)網(wǎng)植物養(yǎng)護(hù)系統(tǒng)到底解決什么問(wèn)題出門一周回來(lái)陽(yáng)臺(tái)上的綠蘿要么干成標(biāo)本要么被自動(dòng)澆水器泡爛根這兩件事幾乎是所有養(yǎng)花人的共同經(jīng)歷。問(wèn)題不在于“澆不澆”而在于澆水這件事缺少反饋土壤干了沒(méi)人知道澆多了也沒(méi)人叫停。基于 Arduino 的物聯(lián)網(wǎng)植物養(yǎng)護(hù)系統(tǒng)本質(zhì)上就是把土壤濕度感知、環(huán)境溫濕度讀取、水泵執(zhí)行和控制決策串成一條完整閉環(huán)讓澆水的時(shí)機(jī)和水量由傳感器說(shuō)了算而不是靠定時(shí)器盲猜。這套系統(tǒng)的定位不是“智能花盆”這種消費(fèi)品而是典型的小型物聯(lián)網(wǎng)端到端項(xiàng)目。Arduino 負(fù)責(zé)邊緣側(cè)的邏輯讀傳感器、做滯回判斷、驅(qū)動(dòng)繼電器和泵云端負(fù)責(zé)數(shù)據(jù)展示、遠(yuǎn)程指令和設(shè)備狀態(tài)監(jiān)控。值得強(qiáng)調(diào)的是邊緣決策必須留在本地一旦斷網(wǎng)Arduino 依然要根據(jù)土壤濕度自動(dòng)澆水不能把“能不能澆”押在云端的網(wǎng)絡(luò)鏈路上。對(duì)畢設(shè)、課設(shè)、競(jìng)賽和實(shí)際項(xiàng)目開(kāi)發(fā)來(lái)說(shuō)這個(gè)項(xiàng)目的工作量分布也很友好一半在感知和執(zhí)行另一半在通信協(xié)議與數(shù)據(jù)上云兩邊都有明確的交付物。下面按動(dòng)手順序展開(kāi)先把傳感器和執(zhí)行器這條腿走穩(wěn)再談怎么上云。2. 硬件選型與接線土壤傳感器、繼電器和 ESP8266 的可靠鏈路2.1 土壤濕度傳感器怎么選YL-69 的電解損耗與電容式的取舍土壤濕度傳感器是整套系統(tǒng)的感知主角。最常見(jiàn)的方案是電阻式模塊 YL-69模塊上自帶 LM393 比較器輸出 DO數(shù)字和 AO模擬兩個(gè)引腳AO 接 Arduino 的 A0。原理是兩根金屬探針插入土壤含水量越高導(dǎo)電性越強(qiáng)模擬電壓發(fā)生對(duì)應(yīng)變化。這類模塊價(jià)格在幾塊錢很多課設(shè)的采購(gòu)清單里都是它。但電阻式探針有一個(gè)被很多人忽略的坑長(zhǎng)期通電時(shí)探針表面會(huì)發(fā)生電解銅離子慢慢析出到土壤里讀數(shù)不斷漂移探針一兩個(gè)月就會(huì)報(bào)廢。電容式土壤濕度傳感器原理不同它把探針表面做成耐腐蝕涂層通過(guò)測(cè)量介電常數(shù)變化來(lái)推算濕度壽命和穩(wěn)定性都明顯更好價(jià)格大概幾十元。如果是畢業(yè)設(shè)計(jì)并且預(yù)算允許優(yōu)先選電容式如果沿用 YL-69有個(gè)很實(shí)用的做法是用一個(gè)額外引腳給傳感器供電程序里采樣前 30 毫秒才通電讀完立刻斷電能把腐蝕速度壓低很多這個(gè)細(xì)節(jié)寫進(jìn)論文里也比單純報(bào)“采集失敗”強(qiáng)。環(huán)境溫濕度部分看精度要求。DHT11 濕度誤差約 ±5%RH溫度誤差 ±1℃勝在便宜穩(wěn)定DHT22 精度提升到 ±2%RH 和 ±0.5℃采樣周期也從 DHT11 的 1 秒縮短為 2 秒實(shí)際體驗(yàn)差距不大畢設(shè)指標(biāo)要求高就上 DHT22。數(shù)據(jù)引腳直接接數(shù)字口模塊上一般已經(jīng)有上拉電阻裸芯片才需要自己補(bǔ) 4.7k 上拉。注意DHT 系列模塊大多自帶電阻買裸芯片回來(lái)用才需要外接上拉否則讀到的數(shù)據(jù)會(huì)間歇性出 0。2.2 繼電器驅(qū)動(dòng)水泵低電平觸發(fā)、獨(dú)立供電與防空轉(zhuǎn)執(zhí)行鏈路最常見(jiàn)的是“Arduino 數(shù)字引腳 → 光耦繼電器 → 微型水泵”這個(gè)結(jié)構(gòu)。市面上常見(jiàn)的繼電器模塊是低電平觸發(fā)IN 引腳接 Arduino 數(shù)字口公共端 COM 接電源正極常開(kāi)端 NO 接水泵正極。之所以強(qiáng)調(diào)低電平觸發(fā)是因?yàn)?Arduino 上電瞬間 IO 口默認(rèn)狀態(tài)不確定如果初始化代碼里先把繼電器引腳置為高驅(qū)動(dòng)的卻是高電平觸發(fā)的繼電器就會(huì)發(fā)生“上電先抽水兩秒”的尷尬情況。我在代碼里會(huì)先強(qiáng)制關(guān)泵再初始化外設(shè)接線前務(wù)必確認(rèn)手上模塊是高電平還是低電平觸發(fā)。供電隔離是另一個(gè)不能省的環(huán)節(jié)。Arduino 的 5V 引腳只能驅(qū)動(dòng)傳感器、DHT 模塊和繼電器控制側(cè)微型水泵必須走獨(dú)立電源。5V 水泵就用單獨(dú) 5V 電源12V 水泵就用 12V 電源如果需要和主控共用電源先用 DC-DC 降壓模塊給 Arduino 供電再讓水泵從源端取電不要讓泵的大電流經(jīng)過(guò)開(kāi)發(fā)板的電源軌。防空轉(zhuǎn)在程序里至少做兩層保險(xiǎn)。第一層是單次澆水最長(zhǎng)持續(xù)時(shí)間比如 60 秒到點(diǎn)強(qiáng)停第二層是加一個(gè)液位傳感器或者浮球開(kāi)關(guān)水桶沒(méi)水時(shí)直接短路掉水泵使能。實(shí)際項(xiàng)目里我還見(jiàn)過(guò)把繼電器換成 SG90 舵機(jī)、去擰一個(gè)微型球閥的做法控制從開(kāi)關(guān)量變成角度量能精密限制每次滴灌水量改造后也能往競(jìng)賽方向擴(kuò)展。2.3 聯(lián)網(wǎng)方案的兩條路線UnoESP8266 還是直接上 NodeMCU/ESP32Uno 板載沒(méi)有無(wú)線能力聯(lián)網(wǎng)方案有兩個(gè)主流走向。做法一是保留 Arduino Uno 作為主控外接 ESP8266ESP-01 或 NodeMCU當(dāng)無(wú)線橋接模塊Uno 用軟串口把 JSON 報(bào)發(fā)給 ESP8266ESP8266 收到后轉(zhuǎn)成 MQTT 報(bào)文上云。這條方案的好處是主控和無(wú)線模塊職責(zé)清晰Uno 的引腳資源完全留給傳感器和泵答辯時(shí)也好解釋分層。壞處是多了塊板子、多一路串口協(xié)議要自己定。做法二更常見(jiàn)于實(shí)際項(xiàng)目開(kāi)發(fā)直接用一個(gè) NodeMCUESP8266或者 ESP32 跑 Arduino 代碼。它們?cè)?Arduino IDE 生態(tài)里完全兼容ADC、GPIO、PWM 一應(yīng)俱全還能省掉一塊主控。最近很多 esp32s3 物聯(lián)網(wǎng)項(xiàng)目也走這條路移植現(xiàn)有 Arduino 代碼基本只改引腳定義因?yàn)?Arduino 框架在 ESP32 上依然成立。如果將來(lái)要加攝像頭識(shí)別植物葉片狀態(tài)ESP32-S3 這類帶更強(qiáng)外設(shè)的芯片會(huì)更合適。對(duì)于以“基于 arduino 設(shè)計(jì)”為題的畢設(shè)來(lái)說(shuō)我的建議是把 Arduino Uno 和 ESP8266 分離寫成“邊緣控制器 無(wú)線網(wǎng)關(guān)”的結(jié)構(gòu)。理由很簡(jiǎn)單字體底下的答辯邏輯更順評(píng)委問(wèn)“為什么不用 ESP32 一體板”時(shí)你可以回答“保留 Uno 作為純業(yè)務(wù)控制器通信層走獨(dú)立微控制器方便后續(xù)更換不同的無(wú)線模塊也便于單獨(dú)斷電重啟網(wǎng)絡(luò)模塊”。2.4 接線清單、上拉電阻與 Arduino IDE 庫(kù)目錄的坑排一套最小系統(tǒng)接線表可以這樣對(duì)照著接模塊引腳連接對(duì)象供電備注土壤濕度傳感器 AOA0Arduino A0由 D9 引腳供電采樣前上電采樣后斷電DHT11/DHT22 DATAD2Arduino D25V模塊自帶電阻則不用外接上拉繼電器 IND7Arduino D75V/3V3注意低電平觸發(fā)水泵NO/COM獨(dú)立電源回路5V/12V不經(jīng)過(guò) Arduino 電源軌ESP8266 TXD3Arduino D2軟串口 RX3V3電平不匹配時(shí)用分壓ESP8266 RXD2Arduino D3軟串口 TX3V3串口交叉相接庫(kù)安裝方面有一個(gè)和“arduino安裝庫(kù)如何改位置”直接相關(guān)的問(wèn)題。Arduino IDE 默認(rèn)把第三方庫(kù)放在~/Documents/Arduino/libraries在“文件 → 首選項(xiàng) → 項(xiàng)目文件夾位置”里修改路徑后IDE 重啟才會(huì)重新掃描新目錄。很多人把庫(kù)解壓后丟進(jìn)原目錄、又改了項(xiàng)目文件夾位置編譯時(shí)就報(bào)“找不到頭文件”。每個(gè)庫(kù)的文件夾名必須和庫(kù)內(nèi)部聲明的名稱一致不能帶版本號(hào)后綴。用 vscode 替代 arduino 編輯器也是同一套機(jī)制Arduino 擴(kuò)展依然依賴這個(gè) libraries 目錄改完位置后記得重啟開(kāi)發(fā)環(huán)境。3. 讓澆水有分寸閾值控制、滯回區(qū)間與 EEPROM 參數(shù)保存3.1 為什么閾值控制會(huì)抖滯回區(qū)間的必要性與 PID 的取舍最簡(jiǎn)單的澆灌邏輯寫出來(lái)只有兩行土壤濕度低于 40% 就開(kāi)泵高于 55% 就停泵。這在實(shí)際運(yùn)行中會(huì)產(chǎn)生兩個(gè)問(wèn)題。第一是臨界抖動(dòng)土壤濕度在邊界附近波動(dòng)時(shí)繼電器會(huì)以秒級(jí)頻率頻繁吸合觸點(diǎn)壽命和泵電機(jī)都會(huì)受到影響。第二是局部誤判水泵剛開(kāi)始澆水水先流到傳感器附近讀數(shù)瞬間下降系統(tǒng)立刻停泵但根部還沒(méi)喝到水。解決辦法是引入滯回區(qū)間也就是讓啟動(dòng)閾值和停止閾值錯(cuò)開(kāi)。比如設(shè)定“濕度低于 35% 啟動(dòng)澆水高于 55% 停止?jié)菜敝虚g的 20 個(gè)百分點(diǎn)就是死區(qū)。這個(gè)思路等價(jià)于生活里的空調(diào)溫控邏輯設(shè)定 26℃ 制冷實(shí)際 27℃ 啟動(dòng)、25℃ 停機(jī)避免壓縮機(jī)頻繁啟停。有人會(huì)問(wèn)這里是不是應(yīng)該上 PID土壤濕度系統(tǒng)的問(wèn)題在于被控對(duì)象響應(yīng)非常慢從水泵開(kāi)啟到根部土壤真實(shí)變濕可能要十幾分鐘而執(zhí)行器是簡(jiǎn)單的繼電器開(kāi)關(guān)非線性很強(qiáng)PID 在這種開(kāi)關(guān)量慢系統(tǒng)上很容易積分飽和。答辯時(shí)被問(wèn)“為什么不用 PID”可以明確回答二位置滯回控制已經(jīng)能滿足植物養(yǎng)護(hù)的精度需求PID 的調(diào)節(jié)能力在這里換不來(lái)實(shí)際收益還引入了參數(shù)整定復(fù)雜度。這一個(gè)回答就能體現(xiàn)控制理論層面的思考而不是只會(huì)寫 if 判斷。3.2 非阻塞主循環(huán)濾波、狀態(tài)機(jī)與毫秒級(jí)調(diào)度主程序不適合用delay()因?yàn)闈菜^(guò)程中還要響應(yīng)串口指令、云端命令和手動(dòng)干預(yù)。下面這套代碼是整套系統(tǒng)的主干可以直接燒到 Arduino Uno 上再配合細(xì)粒度調(diào)整#include EEPROM.h #include avr/wdt.h #define SOIL_PIN A0 #define RELAY_PIN 7 #define MANUAL_STOP_PIN 8 const uint16_t CFG_MAGIC 0xA55A; const uint16_t CFG_ADDR 0; struct Config { uint16_t magic; uint8_t dryThreshold; // 低于此值啟動(dòng)水泵默認(rèn) 35 uint8_t wetThreshold; // 高于此值停止水泵默認(rèn) 55 uint16_t maxWateringSec; // 單次最長(zhǎng)澆水秒數(shù) uint16_t sampleInterval; // 采樣間隔毫秒 }; Config cfg; uint8_t state 0; // 0監(jiān)測(cè)1澆水中 unsigned long lastSample 0; unsigned long wateringStart 0; float readSoilPercent() { long sum 0; for (int i 0; i 8; i) sum analogRead(SOIL_PIN); int val sum / 8; // 干土約 720濕土約 260按實(shí)際標(biāo)定替換 float pct (720.0f - val) * 100.0f / (720.0f - 260.0f); return constrain(pct, 0, 100); } void loadConfig() { EEPROM.get(CFG_ADDR, cfg); if (cfg.magic ! CFG_MAGIC) { cfg.magic CFG_MAGIC; cfg.dryThreshold 35; cfg.wetThreshold 55; cfg.maxWateringSec 60; cfg.sampleInterval 5000; EEPROM.put(CFG_ADDR, cfg); } } void setPump(bool on) { digitalWrite(RELAY_PIN, on ? LOW : HIGH); // 低電平觸發(fā)繼電器 } void setup() { Serial.begin(9600); pinMode(RELAY_PIN, OUTPUT); pinMode(MANUAL_STOP_PIN, INPUT_PULLUP); setPump(false); loadConfig(); wdt_enable(WDTO_8S); } void loop() { wdt_reset(); if (state 0) { if (millis() - lastSample cfg.sampleInterval) { lastSample millis(); float soil readSoilPercent(); Serial.print(F(soil)); Serial.println(soil); if (soil cfg.dryThreshold) { state 1; wateringStart millis(); setPump(true); } } } else { unsigned long elapsed (millis() - wateringStart) / 1000UL; if (elapsed cfg.maxWateringSec) { setPump(false); state 0; return; } float soil readSoilPercent(); if (soil cfg.wetThreshold) { setPump(false); state 0; } } if (digitalRead(MANUAL_STOP_PIN) LOW) { setPump(false); state 0; } }這套邏輯的核心不在“多智能”而在“不打架”。讀取土壤濕度做了 8 次累加取平均抑制單次 ADC 抖動(dòng)澆水狀態(tài)里先檢查超時(shí)再讀取濕度防止卡在某個(gè)傳感器值的死循環(huán)里手動(dòng)停止按鈕采用INPUT_PULLUP按下時(shí)直接回到監(jiān)測(cè)狀態(tài)。sampleInterval默認(rèn) 5 秒因?yàn)橥寥罎穸仁莻€(gè)慢變量沒(méi)必要在 50 毫秒內(nèi)反復(fù)讀maxWateringSec默認(rèn) 60 秒是對(duì)水泵空轉(zhuǎn)的兜底即使傳感器讀數(shù)一直不達(dá)標(biāo)系統(tǒng)也不會(huì)無(wú)限澆下去。3.3 EEPROM 掉電保護(hù)參數(shù)不丟串口在線改閾值A(chǔ)rduino Uno 的 ATmega328P 內(nèi)置 1KB EEPROM擦寫壽命約 10 萬(wàn)次適合保存配置而不適合高頻存數(shù)據(jù)。上面代碼里loadConfig()用一塊struct Config整體讀寫用CFG_MAGIC判斷 EEPROM 里是不是有效數(shù)據(jù)。如果不檢查魔數(shù)首次上電讀出來(lái)的是隨機(jī)值系統(tǒng)會(huì)拿到一個(gè)離譜的閾值而亂澆水。調(diào)試階段常用的是串口在線改參數(shù)不需要每次重刷固件。下面這個(gè)函數(shù)放在loop()里支持SET:40:60:30格式依次更新干閾值、濕閾值和最大澆水秒數(shù)void parseSerialParams() { if (!Serial.available()) return; String line Serial.readStringUntil(\n); if (line.startsWith(SET:)) { int p1 line.indexOf(:, 4); int p2 line.indexOf(:, p1 1); cfg.dryThreshold line.substring(4, p1).toInt(); cfg.wetThreshold line.substring(p1 1, p2).toInt(); cfg.maxWateringSec line.substring(p2 1).toInt(); EEPROM.put(CFG_ADDR, cfg); Serial.println(F(param saved)); } }這里有個(gè)容易踩的坑串口監(jiān)視器右下角如果選的“換行符”不是 NLreadStringUntil(\n)會(huì)一直等不到結(jié)束符表現(xiàn)為命令無(wú)響應(yīng)。校準(zhǔn)標(biāo)定時(shí)把傳感器探頭分別插進(jìn)干土和濕土記錄 AD 值替換readSoilPercent()里干濕兩個(gè)標(biāo)定點(diǎn)比在代碼里硬猜數(shù)值靠譜得多。3.4 必調(diào)參數(shù)表和傳感器標(biāo)定方法參數(shù)名默認(rèn)值作用調(diào)參建議dryThreshold35%低于此值啟動(dòng)水泵根據(jù)栽培介質(zhì)調(diào)整砂土保水差可調(diào)到 40wetThreshold55%高于此值停止水泵與干閾值保持 15 個(gè)百分點(diǎn)以上死區(qū)maxWateringSec60s單次最長(zhǎng)澆水時(shí)間按水泵流量和花盆容積計(jì)算寧小勿大sampleInterval5000ms采樣周期改為 1000ms 觀察更靈敏功耗更高標(biāo)定方法是把傳感器插到完全干燥的土壤里讀 AD 值記為 dry再泡水后瀝干讀出 wet按(dry - adc) / (dry - wet) * 100計(jì)算濕度百分比。這里的百分比是相對(duì)值不是絕對(duì)土壤含水率論文里描述為“土壤濕度指數(shù)”更嚴(yán)謹(jǐn)。4. 物聯(lián)網(wǎng)上云MQTT 數(shù)據(jù)上報(bào)、topic 規(guī)劃與 OneNET 折線圖4.1 為什么物聯(lián)網(wǎng)側(cè)選 MQTT 而不是 HTTP植物養(yǎng)護(hù)系統(tǒng)的數(shù)據(jù)特征是小包、低頻、需要服務(wù)端主動(dòng)通知。如果走 HTTP 輪詢?cè)O(shè)備每 5 秒發(fā)起一次 GET 請(qǐng)求大量請(qǐng)求都是無(wú)效的而且服務(wù)端想立刻推送一條“手動(dòng)澆水”指令時(shí)HTTP 做不到主動(dòng)下發(fā)只能等設(shè)備下一次輪詢。MQTT 基于 TCP 長(zhǎng)連接采用發(fā)布訂閱模型設(shè)備端和云端各自訂閱自己關(guān)心的主題消息即刻送達(dá)。MQTT 的 QoS 也值得理解清楚。QoS 0 最多發(fā)一次丟了不管QoS 1 保證至少送達(dá)一次會(huì)有重復(fù)QoS 2 保證恰好一次開(kāi)銷大。植物養(yǎng)護(hù)場(chǎng)景里傳感器上行數(shù)據(jù)用 QoS 0 即可因?yàn)橄乱粠瑤酌牒缶偷降h(yuǎn)程手動(dòng)澆水這類控制指令建議 QoS 1避免網(wǎng)絡(luò)抖動(dòng)把指令丟了。另外 MQTT 的心跳包還能讓平臺(tái)判斷設(shè)備在線狀態(tài)斷線后平臺(tái)會(huì)收到通知這一點(diǎn)是 HTTP 需要額外設(shè)計(jì)才能做到的。4.2 串口橋結(jié)構(gòu)Uno 發(fā) JSONESP8266 轉(zhuǎn) MQTT在 UnoESP8266 的分體結(jié)構(gòu)里通信層和業(yè)務(wù)層通過(guò)軟串口解耦。Uno 側(cè)只負(fù)責(zé)采集和本地控制把要上報(bào)的數(shù)據(jù)封裝成一行 JSON 發(fā)給 ESP8266ESP8266 收到后原樣發(fā)布到 MQTT。反過(guò)來(lái)云端下發(fā)的指令由 ESP8266 訂閱再以CTL:前綴通過(guò)串口轉(zhuǎn)給 Uno。Uno 側(cè)的發(fā)送函數(shù)#include SoftwareSerial.h SoftwareSerial bridge(2, 3); // RXD2, TXD3 void publishTelemetry(float soil, float temp, float humi, uint16_t adc) { bridge.print(DEV:{); bridge.print(\soil\:); bridge.print(soil, 0); bridge.print(,\t\:); bridge.print(temp, 1); bridge.print(,\h\:); bridge.print(humi, 1); bridge.print(,\adc\:); bridge.print(adc); bridge.println(}); }ESP8266 側(cè)使用PubSubClient庫(kù)核心代碼如下#include ESP8266WiFi.h #include PubSubClient.h WiFiClient wifiClient; PubSubClient mqtt(wifiClient); const char* ssid 你的WiFi; const char* pass 你的密碼; const char* mqttHost 你的Broker地址; const int mqttPort 1883; const char* devId plant01; const char* topicTele plant/plant01/telemetry; const char* topicCmd plant/plant01/cmd; const char* topicStatus plant/plant01/status; void callback(char* topic, byte* payload, unsigned int len) { Serial.print(CTL:); Serial.write(payload, len); Serial.println(); } void mqttReconnect() { while (!mqtt.connected()) { if (mqtt.connect(devId, topicStatus, 0, false, offline)) { mqtt.subscribe(topicCmd); } else { delay(2000); } } } void setup() { Serial.begin(9600); WiFi.begin(ssid, pass); while (WiFi.status() ! WL_CONNECTED) delay(500); mqtt.setServer(mqttHost, mqttPort); mqtt.setCallback(callback); } void loop() { if (!mqtt.connected()) mqttReconnect(); mqtt.loop(); while (Serial.available() 0) { String line Serial.readStringUntil(\n); if (line.startsWith(DEV:{)) { mqtt.publish(topicTele, (const char*)line.substring(4).c_str()); } } }這段代碼里有一個(gè)細(xì)節(jié)值得說(shuō)mqtt.connect(devId, topicStatus, 0, false, offline)的第三個(gè)參數(shù)是遺囑消息的 QoS第四個(gè)是 retain 標(biāo)記第五個(gè)是遺囑 payload。設(shè)備異常掉線時(shí)broker 會(huì)替它在plant/plant01/status主題發(fā)布一條offlineAPP 端訂閱這個(gè)主題就能立即收到設(shè)備離線通知。串口橋結(jié)構(gòu)最大的好處是 Uno 側(cè)完全不需要知道 MQTT 的存在。后續(xù)如果從 OneNET 切換到自建 EMQX只需要改 ESP8266 的 broker 地址Uno 端程序一行不動(dòng)。如果你后面做的是充電樁這類平臺(tái)級(jí)項(xiàng)目云端換成 SpringBootNettyMQTT 網(wǎng)關(guān)終端側(cè)這套 topic 規(guī)范依然可以沿用。4.3 OneNET 控制臺(tái)的數(shù)據(jù)流模板與折線圖繪制OneNET 是物聯(lián)網(wǎng)畢業(yè)設(shè)計(jì)里使用率較高的平臺(tái)。設(shè)備側(cè)接入 MQTT 后需要在控制臺(tái)側(cè)做三件事創(chuàng)建產(chǎn)品時(shí)接入?yún)f(xié)議選 MQTT添加設(shè)備拿到設(shè)備 ID 和鑒權(quán)信息在“數(shù)據(jù)流模板”里定義soil、t、h等數(shù)據(jù)流名稱。老版 OneNET 的 MQTT 協(xié)議要求設(shè)備向$dp主題發(fā)布特定 JSON 結(jié)構(gòu)數(shù)據(jù)點(diǎn)格式如下{ datastreams: [ { id: soil, datapoints: [ { value: 35 } ] }, { id: t, datapoints: [ { value: 26.4 } ] }, { id: h, datapoints: [ { value: 61 } ] } ] }ESP8266 側(cè)只需要在收到 Uno 的DEV:報(bào)文后把數(shù)據(jù)拼成上面這個(gè)結(jié)構(gòu)發(fā)布到$dp主題即可。然后在“應(yīng)用管理”里新建應(yīng)用拖入折線圖組件綁定數(shù)據(jù)流頁(yè)面就能實(shí)時(shí)刷新土壤濕度曲線。聯(lián)調(diào)時(shí)先用桌面版 MQTTX 客戶端扮演設(shè)備直接發(fā)布一條$dp報(bào)文看折線圖是否跟著動(dòng)能省去大量查設(shè)備端問(wèn)題的時(shí)間。如果不想被單一平臺(tái)綁定可以本地跑一個(gè) EMQX broker再用 Node-RED 搭面板mqtt in節(jié)點(diǎn)訂閱plant//telemetry輸出給chart組件一個(gè)輕量級(jí)可視化頁(yè)面就出來(lái)了。這個(gè)方案自由度更高日后插接其他傳感器也只是加 topic 的事適合競(jìng)賽或項(xiàng)目開(kāi)發(fā)場(chǎng)景。4.4 topic 設(shè)計(jì)表與斷線重連的檢查點(diǎn)主題方向用途QoSplant/plant01/telemetry上行傳感器數(shù)據(jù)上報(bào)0plant/plant01/cmd下行遠(yuǎn)程澆水指令1plant/plant01/status狀態(tài)在線離線通知0/1plant//status訂閱多設(shè)備統(tǒng)一監(jiān)控0斷線重連有幾個(gè)容易忽略的檢查點(diǎn)。第一mqtt.loop()必須高頻調(diào)用它負(fù)責(zé)處理收發(fā)緩沖區(qū)和心跳很多“為什么收不到消息”的問(wèn)題是 loop 被長(zhǎng)阻塞代碼卡住了。第二mqttReconnect()里的delay(2000)不能省否則 WiFi 信號(hào)弱時(shí)會(huì)以極快頻率沖擊 broker。第三ESP8266 如果長(zhǎng)時(shí)間未重連成功建議主動(dòng)ESP.restart()而不是一直空轉(zhuǎn)因?yàn)榈讓?WiFi 協(xié)議?？赡茉谌跣盘?hào)下進(jìn)入異常狀態(tài)重啟比調(diào)試半天更管用。5. 仿真驗(yàn)證、看門狗與答辯演示的三個(gè)加分細(xì)節(jié)5.1 用 Wokwi 仿真先跑邏輯再買硬件手頭沒(méi)板子或者等快遞期間可以用 Wokwi 這類在線仿真平臺(tái)先把程序邏輯跑通。它支持 Arduino Uno、DHT11、電位器、LED 等常用器件能模擬串口輸出。新項(xiàng)目建好后diagram.json 大概長(zhǎng)這樣{ version: 1, parts: [ { type: board-uno, id: uno }, { type: wokwi-potentiometer, id: pot1, attrs: { value: 40 } }, { type: wokwi-led, id: led1, attrs: { color: green } } ], connections: [ [ uno:A0, pot1:OUT, green, [] ], [ uno:7, led1:ANODE, yellow, [] ], [ led1:CATHODE, uno:GND.1, black, [] ] ] }電位器模擬的是土壤濕度傳感器旋轉(zhuǎn)電位器改變 A0 電壓就相當(dāng)于改變土壤干濕程度LED 模擬水泵的啟停。仿真跑通的代碼再燒到真機(jī)上硬件問(wèn)題能縮小到接線和標(biāo)定這兩塊。競(jìng)賽場(chǎng)地沒(méi)有硬件環(huán)境時(shí)這個(gè)仿真平臺(tái)也能作為演示兜底方案。5.2 看門狗與故障上報(bào)泵卡死、傳感器拔掉怎么辦主程序加入軟看門狗setup()里執(zhí)行wdt_enable(WDTO_8S)主循環(huán)開(kāi)頭調(diào)用wdt_reset()。如果程序因?yàn)槲粗蚩ㄔ谝粋€(gè)阻塞循環(huán)里8 秒后自動(dòng)復(fù)位系統(tǒng)能自己緩過(guò)來(lái)。傳感器被拔出或斷線時(shí)ADC 讀數(shù)會(huì)直接跳到 0 或 1023標(biāo)定后的百分比會(huì)變成離譜的負(fù)數(shù)或者大于 100程序里要加一個(gè)范圍校驗(yàn)超限則沿用上次有效值并上報(bào)一條故障消息{ soil: 255, fault: sensor_timeout }5.3 答辯和比賽演示的三個(gè)展示細(xì)節(jié)演示順序建議按照“數(shù)據(jù)鏈路”走先在面板上展示實(shí)時(shí)溫濕度和土壤濕度曲線再現(xiàn)場(chǎng)把傳感器探頭從土里拔出插進(jìn)干燥的沙子幾秒后就能看到濕度值跌破閾值、水泵啟動(dòng)、折線圖上揚(yáng)。這比對(duì)著 PPT 念架構(gòu)圖更能說(shuō)明問(wèn)題。提前打印一份參數(shù)表和標(biāo)定記錄評(píng)委問(wèn)“為什么干閾值設(shè) 35”時(shí)能直接說(shuō)出這是根據(jù)沙土和營(yíng)養(yǎng)土的標(biāo)定結(jié)果確定的比籠統(tǒng)回答“網(wǎng)上抄的”加分得多。最后是緩沖方案盡量把仿真平臺(tái)作為第二手準(zhǔn)備現(xiàn)場(chǎng)無(wú)線斷聯(lián)或者設(shè)備離線時(shí)切到 Wokwi 仿真說(shuō)明核心邏輯仍然成立避免演示翻車。本文還有配套的精品資源點(diǎn)擊獲取