測(cè)系統(tǒng):ESP01S+OneNET+小程序全鏈路實(shí)戰(zhàn))
做物聯(lián)網(wǎng)畢業(yè)設(shè)計(jì)或競(jìng)賽項(xiàng)目很多人不是卡在代碼難寫而是卡在“整條鏈路太長”。以廚房安全監(jiān)測(cè)系統(tǒng)為例你需要讓 STM32 采集溫濕度、煙霧濃度通過 ESP01S 將數(shù)據(jù)推到 OneNET 云平臺(tái)再在微信小程序里顯示并遠(yuǎn)程控制繼電器。單看任何一個(gè)節(jié)點(diǎn)網(wǎng)上都能找到教程一旦要求它們聯(lián)調(diào)跑通各種問題就冒出來了——串口亂碼、AT 指令不返回、MQTT 連接失敗、小程序收不到數(shù)據(jù)……這篇文章的目的很明確幫你把這條鏈路完整走通。我會(huì)從系統(tǒng)架構(gòu)、硬件選型、STM32 驅(qū)動(dòng)代碼、ESP01S 接入 OneNET、小程序?qū)?、PCB 設(shè)計(jì)到常見排錯(cuò)按真實(shí)開發(fā)順序講一遍。內(nèi)容以 STM32F103C8T6 ESP01S OneNET 這套主流方案為主線同樣適用于智能家居、環(huán)境監(jiān)測(cè)、宿舍安防等類似選題。1. 這個(gè)項(xiàng)目解決什么問題物聯(lián)網(wǎng)畢設(shè)的真正難點(diǎn)先說一個(gè)觀察很多做 STM32 畢設(shè)或競(jìng)賽項(xiàng)目的同學(xué)容易陷入“局部自嗨”的怪圈——傳感器讀取寫得滾瓜爛熟OLED 屏幕顯示也做得很好看但一提到上云就卡殼。為什么因?yàn)榍懊孢@些只是單片機(jī)基本功物聯(lián)網(wǎng)項(xiàng)目真正考核的是“端-云-應(yīng)用”三層鏈路的數(shù)據(jù)閉環(huán)。所謂“鏈路打通”指的是傳感器數(shù)據(jù)能被 MCU 正確采集MCU 能把數(shù)據(jù)通過串口交給 WiFi 模塊WiFi 模塊能連上路由器、能連上云平臺(tái)云平臺(tái)上能正確創(chuàng)建產(chǎn)品、設(shè)備、數(shù)據(jù)流小程序/APP 能通過云平臺(tái)接口讀到設(shè)備數(shù)據(jù)、下發(fā)控制指令。任何一環(huán)斷了整個(gè)項(xiàng)目都不算完成。這套基于 STM32 的廚房安全監(jiān)測(cè)系統(tǒng)適合的讀者包括物聯(lián)網(wǎng)、電子信息、計(jì)算機(jī)相關(guān)專業(yè)的畢業(yè)生正在挑畢設(shè)題目準(zhǔn)備參加電子設(shè)計(jì)競(jìng)賽、互聯(lián)網(wǎng)、挑戰(zhàn)杯的學(xué)生團(tuán)隊(duì)想完整掌握“STM32 云平臺(tái) 小程序”全鏈路開發(fā)但又缺乏項(xiàng)目經(jīng)驗(yàn)的開發(fā)者。項(xiàng)目完成后你的成果物不只是“一個(gè)能報(bào)警的設(shè)備”而是一整套可以演示、答辯、擴(kuò)展的方案一塊自研 PCB 底板集成了 STM32 最小系統(tǒng)、傳感器接口、繼電器驅(qū)動(dòng)、ESP01S 座子一套 STM32 標(biāo)準(zhǔn)庫工程包含傳感器驅(qū)動(dòng)、串口通信、AT 指令控制 WiFi 模塊的邏輯一個(gè) OneNET 云平臺(tái)設(shè)備實(shí)例能生成 APIKey、數(shù)據(jù)流、命令下發(fā)一個(gè)微信小程序界面能實(shí)時(shí)顯示溫度、濕度、煙霧濃度并遠(yuǎn)程觸發(fā)聲光報(bào)警或排風(fēng)扇。這套鏈路本身也是物聯(lián)網(wǎng)行業(yè)里非常通用的能力。做完這個(gè)項(xiàng)目你已經(jīng)摸清了嵌入式上云的基本方法后續(xù)換傳感器、換 WiFi 模塊、換云平臺(tái)都是同一套思路的遷移。2. 系統(tǒng)總體架構(gòu)與核心選型邏輯2.1 四層架構(gòu)從數(shù)據(jù)流的角度看系統(tǒng)分為四層層級(jí)作用本項(xiàng)目的具體實(shí)現(xiàn)感知層采集廚房環(huán)境數(shù)據(jù)DHT11 溫濕度、MQ-2 煙霧濃度、火焰?zhèn)鞲衅骺刂茖犹幚頂?shù)據(jù)、執(zhí)行本地邏輯STM32F103C8T6 主控、繼電器控制排風(fēng)扇/電磁閥平臺(tái)層數(shù)據(jù)中轉(zhuǎn)、存儲(chǔ)、API 輸出OneNET 云平臺(tái)通過 MQTT 協(xié)議接入應(yīng)用層用戶遠(yuǎn)程查看與控制微信小程序這四層不是孤立的。感知層把物理信號(hào)變成數(shù)字量控制層負(fù)責(zé)“本地判斷 遠(yuǎn)程上傳”平臺(tái)層負(fù)責(zé)把設(shè)備與小程序解耦應(yīng)用層則給用戶提供可視化界面。2.2 控制邏輯本地邏輯可以這樣設(shè)計(jì)STM32 每 2 秒采集一次溫度、濕度、煙霧濃度如果煙霧濃度或溫度超過閾值立即打開繼電器控制排風(fēng)扇或燃?xì)怆姶砰y并驅(qū)動(dòng)蜂鳴器報(bào)警無論是否報(bào)警數(shù)據(jù)都會(huì)通過 ESP01S 上傳到 OneNET。這個(gè)“本地閉環(huán)”設(shè)計(jì)非常重要。它保證即使 WiFi 斷開、云平臺(tái)不可用廚房的安全機(jī)制依然能工作。很多初學(xué)者容易忽略這一點(diǎn)把所有判斷都交給云端結(jié)果網(wǎng)絡(luò)一抖設(shè)備就“失靈”了。2.3 為什么用 ESP01S 而不是 ESP8266 開發(fā)板ESP01S 本質(zhì)上是 ESP8266 芯片的一個(gè)最小模組引出 8 個(gè)引腳其中可用 GPIO 只有 2 個(gè)。它沒有獨(dú)立的 USB 轉(zhuǎn)串口電路也沒有穩(wěn)壓和下載電路看起來對(duì)新手不太友好。但它有兩個(gè)明顯優(yōu)勢(shì)便宜單模塊成本低適合做產(chǎn)品化的 PCB出廠自帶 AT 固件不需要額外寫 ESP8266 的固件把它當(dāng)“串口轉(zhuǎn) WiFi 透明通道”來用就行。在畢設(shè)場(chǎng)景里ESP01S 是最省事的方案STM32 通過串口發(fā) AT 指令ESP01S 負(fù)責(zé) WiFi 連接與 MQTT 協(xié)議處理所有業(yè)務(wù)邏輯都在 STM32 上完成。如果你選用的是整塊 NodeMCU 開發(fā)板也不是不行但體積大、集成度低做 PCB 時(shí)不好安排位置。2.4 為什么選 OneNETOneNET 是中移物聯(lián)網(wǎng)的開放平臺(tái)對(duì)校園用戶和開發(fā)者比較友好。它的優(yōu)勢(shì)在于不需要自己買服務(wù)器、搭后端直接在平臺(tái)上創(chuàng)建設(shè)備生成鑒權(quán)信息提供 MQTT 接入方式兼容性好數(shù)據(jù)流和命令下發(fā)清晰適合展示畢設(shè)的“端到端”能力。相比自建 MQTT 服務(wù)器OneNET 明顯更適合課程設(shè)計(jì)和競(jìng)賽場(chǎng)景。它讓項(xiàng)目可以聚焦在“設(shè)備端怎么發(fā)數(shù)據(jù)、應(yīng)用端怎么讀數(shù)據(jù)”而不是花大量精力去維護(hù)服務(wù)器。3. 硬件設(shè)計(jì)與原理圖要點(diǎn)3.1 主控與核心器件本系統(tǒng)主控采用 STM32F103C8T6這是 STM32 家族里最常用的入門型號(hào)之一。它基于 Arm Cortex-M3 內(nèi)核主頻 72MHz內(nèi)置 64KB Flash、20KB SRAM擁有 3 個(gè) USART、2 個(gè) SPI、2 個(gè) I2C、多個(gè)定時(shí)器和 ADC。為什么夠用傳感器采集是模擬量 單總線協(xié)議PWM 或 ADC 就能解決與 ESP01S 通信只需要一個(gè)串口控制繼電器、蜂鳴器只需要 GPIO不需要跑操作系統(tǒng)裸機(jī)輪詢即可。其他核心器件包括器件作用備注DHT11采集溫度、濕度單總線協(xié)議3 根線MQ-2 煙霧傳感器檢測(cè)可燃?xì)怏w/煙霧濃度模擬量輸出接到 ADC火焰?zhèn)鞲衅鳈z測(cè)明火紅外光譜數(shù)字或模擬量輸出繼電器模塊控制排風(fēng)扇、電磁閥5V 或 3.3V 觸發(fā)注意驅(qū)動(dòng)電流蜂鳴器本地聲光報(bào)警有源蜂鳴器更簡單ESP01SWiFi 通信3.3V 供電注意電流需求3.2 傳感器選型邏輯廚房安全的核心是“燃?xì)庑孤焙汀皽囟犬惓!?。MQ-2 對(duì)液化氣、丙烷、氫氣等可燃?xì)怏w比較敏感而且價(jià)格低、資料多非常適合畢設(shè)演示。它輸出模擬電壓煙霧濃度越高電壓越大接 STM32 的 ADC 引腳即可讀取。DHT11 精度雖然不高但勝在協(xié)議簡單、驅(qū)動(dòng)例程到處都是用來做環(huán)境溫濕度采集完全夠用。如果你想讓項(xiàng)目更有“工程感”可以換成 DHT22 或 SHT30但這屬于后期優(yōu)化不影響整體架構(gòu)。火焰?zhèn)鞲衅髦饕袃煞N一種輸出數(shù)字量檢測(cè)到火焰時(shí)輸出低電平一種輸出模擬量可以判斷火焰強(qiáng)度。建議接 ADC 引腳這樣既能判斷“有火”也能看“火勢(shì)”。它的檢測(cè)距離有限實(shí)際擺放時(shí)要靠近灶臺(tái)區(qū)域。3.3 電源方案與繼電器控制整個(gè)系統(tǒng)的供電可以選擇 USB 5V 輸入也可以選擇 220V 轉(zhuǎn) 5V 的電源模塊。這里有一個(gè)關(guān)鍵點(diǎn)ESP01S 的工作電流瞬間可能達(dá)到 200mA 以上如果用 STM32 板載的 3.3V LDO 給它供電WiFi 連接瞬間大概率會(huì)復(fù)位??煽康淖龇ㄊ?V 輸入通過獨(dú)立的 AMS1117-3.3 穩(wěn)壓芯片給 ESP01S 供電STM32 的 3.3V 也建議單獨(dú)用一路 LDO。繼電器驅(qū)動(dòng)不要直接用 STM32 的 GPIO 去推。繼電器線圈屬于感性負(fù)載驅(qū)動(dòng)時(shí)需要三極管或 ULN2003并且線圈兩端要并聯(lián)續(xù)流二極管否則斷開瞬間的反向電動(dòng)勢(shì)可能損壞 GPIO。常用驅(qū)動(dòng)結(jié)構(gòu)GPIO 輸出高電平經(jīng)限流電阻接 NPN 三極管基極繼電器線圈接在三極管集電極與 5V 之間線圈兩端并聯(lián) 1N4007 二極管負(fù)極接 5V。3.4 電路設(shè)計(jì)要點(diǎn)原理圖設(shè)計(jì)需要注意幾個(gè)細(xì)節(jié)STM32F103C8T6 的 BOOT0 接 10K 電阻到 GND避免上電后意外進(jìn)入系統(tǒng)存儲(chǔ)器模式NRST 引腳接 100nF 電容到地VDD 每個(gè)引腳就近放一個(gè) 100nF 去耦電容8MHz 晶振的兩個(gè)負(fù)載電容通常選 22pF 左右但準(zhǔn)確值要根據(jù)芯片數(shù)據(jù)手冊(cè)中的負(fù)載電容參數(shù)計(jì)算公式是 CL (C1 * C2) / (C1 C2) 寄生電容ESP01S 的 VCC 引腳需要 3.3V且建議在模塊附近放一個(gè) 10uF 或 100uF 電解電容應(yīng)對(duì) WiFi 發(fā)射時(shí)的電流尖峰。如果你用的是立創(chuàng)EDA嘉立創(chuàng)EDA畫完原理圖后可以直接檢查 ERC、生成 PCB然后在線下單打樣整套流程對(duì)新手比較友好網(wǎng)上相關(guān)教程也很多。4. STM32 開發(fā)環(huán)境搭建4.1 開發(fā)工具鏈本文代碼基于 STM32 標(biāo)準(zhǔn)外設(shè)庫Standard Peripheral Library開發(fā)環(huán)境是 Keil MDK。這套組合雖然是“老配方”但資料多、社區(qū)成熟非常適合課程設(shè)計(jì)和競(jìng)賽快速推進(jìn)。需要準(zhǔn)備的工具工具說明Keil MDK 5.x編寫、編譯、下載代碼STM32F1xx 器件支持包在 Keil 中安裝包含芯片型號(hào)定義ST-Link 驅(qū)動(dòng) / J-Link 驅(qū)動(dòng)下載調(diào)試器驅(qū)動(dòng)STM32 標(biāo)準(zhǔn)庫提供外設(shè)驅(qū)動(dòng)源碼STM32 ST-LINK Utility用于連接異常時(shí)的芯片解鎖與燒錄串口調(diào)試助手查看 MCU 打印日志、調(diào)試 AT 指令4.2 Keil 安裝 C51 與 STM32 共存問題很多同學(xué)電腦上之前裝過 Keil C51再裝 Keil MDK 時(shí)兩個(gè)軟件會(huì)默認(rèn)裝到不同目錄。這里容易出的問題是打開一個(gè)項(xiàng)目時(shí)界面顯示沒有對(duì)應(yīng)的編譯器或芯片包。解決辦法如果以 C51 為主先安裝 Keil C51再安裝 Keil MDK并把 C51 的安裝目錄指定為 Keil 安裝目錄下的 UV4 文件夾這樣兩者可以共存在 MDK 中打開項(xiàng)目時(shí)需要在 Project 窗口右鍵選擇 Manage Project Items確認(rèn)編譯器版本是 ARM Compiler而不是 C51 編譯器下載報(bào)錯(cuò)Error: Flash Download failed - Cortex-M3通常是因?yàn)闆]有在 Options for Target 的 Debug 頁面配置 Flash Download或者芯片型號(hào)選錯(cuò)。這些問題的本質(zhì)是“兩個(gè)版本 Keil 的工程文件結(jié)構(gòu)不同 芯片支持包缺失”。排查時(shí)先看 Tools 菜單下的 Pack Installer確認(rèn)是否安裝了對(duì)應(yīng)的器件支持包。4.3 STM32 標(biāo)準(zhǔn)庫工程結(jié)構(gòu)標(biāo)準(zhǔn)庫工程的典型結(jié)構(gòu)如下Project/ ├── Core/ │ ├── inc/ │ └── src/ ├── HAL/ # 標(biāo)準(zhǔn)庫使用 SystemInit 啟動(dòng)文件 ├── STM32F10x_FWLib/ │ ├── inc/ │ └── src/ ├── User/ │ ├── main.c │ ├── stm32f10x_it.c │ └── system_stm32f10x.c └── MDK-ARM/新建工程時(shí)建議手動(dòng)建立以下幾個(gè)用戶文件bsp_usart.c/h串口初始化與重定向 printfbsp_dht11.c/hDHT11 驅(qū)動(dòng)bsp_adc.c/hADC 采集模擬量esp01s_at.c/h封裝 AT 指令發(fā)送與 MQTT 連接流程app_task.c/h主循環(huán)業(yè)務(wù)邏輯。這樣組織的好處是傳感器驅(qū)動(dòng)、WiFi 通信、業(yè)務(wù)邏輯相互獨(dú)立后期更換傳感器或云平臺(tái)時(shí)不用大面積改代碼。5. 傳感器驅(qū)動(dòng)與數(shù)據(jù)采集代碼5.1 DHT11 溫濕度讀取DHT11 是單總線器件通信時(shí)序相對(duì)固定主機(jī)先拉低總線至少 18ms再釋放總線然后讀取 40 位數(shù)據(jù)濕度整數(shù)、濕度小數(shù)、溫度整數(shù)、溫度小數(shù)、校驗(yàn)和。下面的代碼是一個(gè)簡化版示例重點(diǎn)看協(xié)議流程而不是追求完整產(chǎn)品級(jí)容錯(cuò)。// 文件路徑User/bsp_dht11.c #include bsp_dht11.h #include stm32f10x.h #define DHT11_GPIO_PORT GPIOB #define DHT11_GPIO_PIN GPIO_Pin_0 #define DHT11_RCC RCC_APB2Periph_GPIOB static uint8_t dht11_data[5]; static void DHT11_GPIO_Output(void) { GPIO_InitTypeDef GPIO_InitStructure; GPIO_InitStructure.GPIO_Pin DHT11_GPIO_PIN; GPIO_InitStructure.GPIO_Mode GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(DHT11_GPIO_PORT, GPIO_InitStructure); } static void DHT11_GPIO_Input(void) { GPIO_InitTypeDef GPIO_InitStructure; GPIO_InitStructure.GPIO_Pin DHT11_GPIO_PIN; GPIO_InitStructure.GPIO_Mode GPIO_Mode_IN_FLOATING; GPIO_Init(DHT11_GPIO_PORT, GPIO_InitStructure); } static uint8_t DHT11_ReadByte(void) { uint8_t i, byte 0; for (i 0; i 8; i) { while (GPIO_ReadInputDataBit(DHT11_GPIO_PORT, DHT11_GPIO_PIN) RESET); delay_us(40); if (GPIO_ReadInputDataBit(DHT11_GPIO_PORT, DHT11_GPIO_PIN) SET) { byte (byte 1) | 0x01; } else { byte (byte 1); } while (GPIO_ReadInputDataBit(DHT11_GPIO_PORT, DHT11_GPIO_PIN) SET); } return byte; } uint8_t DHT11_ReadData(float *temp, float *humi) { uint8_t i; DHT11_GPIO_Output(); GPIO_ResetBits(DHT11_GPIO_PORT, DHT11_GPIO_PIN); delay_ms(20); GPIO_SetBits(DHT11_GPIO_PORT, DHT11_GPIO_PIN); delay_us(30); DHT11_GPIO_Input(); while (GPIO_ReadInputDataBit(DHT11_GPIO_PORT, DHT11_GPIO_PIN) SET); while (GPIO_ReadInputDataBit(DHT11_GPIO_PORT, DHT11_GPIO_PIN) RESET); while (GPIO_ReadInputDataBit(DHT11_GPIO_PORT, DHT11_GPIO_PIN) SET); for (i 0; i 5; i) { dht11_data[i] DHT11_ReadByte(); } if ((dht11_data[0] dht11_data[1] dht11_data[2] dht11_data[3]) dht11_data[4]) { *humi (float)((dht11_data[0] 8 | dht11_data[1]) 8); *temp (float)((dht11_data[2] 8 | dht11_data[3]) 8); return 1; } return 0; }這里有幾個(gè)容易出錯(cuò)的地方起始信號(hào)的低電平時(shí)間必須足夠短了傳感器不響應(yīng)常見問題是時(shí)序函數(shù)延時(shí)不準(zhǔn)讀取每一位時(shí)40us 的判斷是區(qū)分“0”和“1”的關(guān)鍵不能死等校驗(yàn)和的判斷不能省否則干擾環(huán)境下會(huì)出現(xiàn)離譜數(shù)據(jù)。5.2 MQ-2 煙霧濃度采集MQ-2 輸出的是模擬電壓STM32 采集它只需要 ADC 外設(shè)。// 文件路徑User/bsp_adc.c #include bsp_adc.h #include stm32f10x.h void ADC_Config(void) { GPIO_InitTypeDef GPIO_InitStructure; ADC_InitTypeDef ADC_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_ADC1, ENABLE); GPIO_InitStructure.GPIO_Pin GPIO_Pin_1; GPIO_InitStructure.GPIO_Mode GPIO_Mode_AIN; GPIO_Init(GPIOA, GPIO_InitStructure); ADC_InitStructure.ADC_Mode ADC_Mode_Independent; ADC_InitStructure.ADC_ScanConvMode DISABLE; ADC_InitStructure.ADC_ContinuousConvMode DISABLE; ADC_InitStructure.ADC_ExternalTrigConv ADC_ExternalTrigConv_None; ADC_InitStructure.ADC_DataAlign ADC_DataAlign_Right; ADC_InitStructure.ADC_NbrOfChannel 1; ADC_Init(ADC1, ADC_InitStructure); ADC_Cmd(ADC1, ENABLE); ADC_ResetCalibration(ADC1); while (ADC_GetResetCalibrationStatus(ADC1)); ADC_StartCalibration(ADC1); while (ADC_GetCalibrationStatus(ADC1)); } uint16_t MQ2_Read(void) { ADC_RegularChannelConfig(ADC1, ADC_Channel_1, 1, ADC_SampleTime_55Cycles5); ADC_SoftwareStartConvCmd(ADC1, ENABLE); while (ADC_GetFlagStatus(ADC1, ADC_FLAG_EOC) RESET); return ADC_GetConversionValue(ADC1); }ADC 采樣值是一個(gè) 0 到 4095 的數(shù)字量對(duì)應(yīng) 0 到 3.3V。如果你需要電壓值可以折算float voltage (float)adc_value * 3.3f / 4095.0f;在實(shí)際項(xiàng)目里直接把原始 ADC 值作為“煙霧濃度指標(biāo)”也可以因?yàn)閳?bào)警閾值只需要一個(gè)相對(duì)量標(biāo)定好“正常環(huán)境下的基準(zhǔn)值”和“報(bào)警環(huán)境下的采樣值”在這個(gè)區(qū)間內(nèi)配置閾值即可。5.3 串口調(diào)試信息輸出調(diào)試離不開串口。推薦把 printf 重定向到串口 1這樣可以直接在串口助手看數(shù)據(jù)。// 文件路徑User/bsp_usart.c #include bsp_usart.h #include stm32f10x.h #include stdio.h void USART1_Init(uint32_t baudrate) { GPIO_InitTypeDef GPIO_InitStructure; USART_InitTypeDef USART_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_USART1, ENABLE); GPIO_InitStructure.GPIO_Pin GPIO_Pin_9; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_InitStructure.GPIO_Mode GPIO_Mode_AF_PP; GPIO_Init(GPIOA, GPIO_InitStructure); GPIO_InitStructure.GPIO_Pin GPIO_Pin_10; GPIO_InitStructure.GPIO_Mode GPIO_Mode_IN_FLOATING; GPIO_Init(GPIOA, GPIO_InitStructure); USART_InitStructure.USART_BaudRate baudrate; USART_InitStructure.USART_WordLength USART_WordLength_8b; USART_InitStructure.USART_StopBits USART_StopBits_1; USART_InitStructure.USART_Parity USART_Parity_No; USART_InitStructure.USART_HardwareFlowControl USART_HardwareFlowControl_None; USART_InitStructure.USART_Mode USART_Mode_Rx | USART_Mode_Tx; USART_Init(USART1, USART_InitStructure); USART_Cmd(USART1, ENABLE); } int fputc(int ch, FILE *f) { while (USART_GetFlagStatus(USART1, USART_FLAG_TXE) RESET); USART_SendData(USART1, (uint8_t)ch); return ch; }串口調(diào)試時(shí)建議保持固定波特率比如 115200。如果發(fā)現(xiàn)亂碼優(yōu)先檢查串口助手的波特率和單片機(jī)初始化參數(shù)是否一致。6. ESP01S 接入 OneNET 云平臺(tái)的完整實(shí)現(xiàn)6.1 ESP01S 出廠 AT 固件的使用前提ESP01S 出廠一般刷好了 AT 固件使用前先用 USB 轉(zhuǎn) TTL 模塊連接它確認(rèn)能收到AT回復(fù)OK。常見的 AT 固件版本不同指令集也有差異。這里用一個(gè)保守但穩(wěn)妥的說法ESP8266 官方 AT 指令集經(jīng)過了多個(gè)版本迭代支持 MQTT 的指令在不同版本中格式不完全一致。如果你的模塊不支持ATMQTTCONN這類指令可以先用串口助手把固件升級(jí)到支持 MQTT 的版本或者使用舊的 TCP 透?jìng)鞣绞竭B接 OneNET。無論固件版本如何調(diào)試順序都是固定的配置 WiFi 模式連接路由器建立 TCP 或 MQTT 連接發(fā)送/接收數(shù)據(jù)。6.2 先用串口助手手動(dòng)聯(lián)調(diào) AT 指令在寫 STM32 代碼之前強(qiáng)烈建議先用 USB 轉(zhuǎn) TTL 模塊把 ESP01S 接電腦用串口助手手動(dòng)敲一遍指令。這一步能幫你確認(rèn) ESP01S 的 AT 指令格式和 OneNET 接入?yún)?shù)避免后面代碼調(diào)試時(shí)分不清是“指令寫錯(cuò)”還是“網(wǎng)絡(luò)問題”。典型流程如下AT # 回復(fù) OK ATCWMODE1 # 回復(fù) OK設(shè)置為 STA 模式 ATCWJAP你的WiFi名,你的WiFi密碼 # 回復(fù) WIFI GOT IP # 連接 OneNET 服務(wù)器 ATMQTTUSERCFG0,1,clientId,username,password,0,0, ATMQTTCONN0,host地址,端口,1關(guān)于 OneNET 的接入?yún)?shù)這里需要特別注意。OneNET 平臺(tái)有多個(gè)接入版本舊版多協(xié)議接入的 MQTT 參數(shù)與新版 OneNET Studio 不完全相同舊版多協(xié)議接入時(shí)clientId、username、password 由平臺(tái)提供的設(shè)備信息生成新版 Studio 則更強(qiáng)調(diào)產(chǎn)品 ID、設(shè)備名稱、設(shè)備密鑰的組合關(guān)系不同版本的接入域名和端口也可能不同。所以我的建議是不要憑網(wǎng)上某篇文章里的 IP 和端口直接抄而是登錄 OneNET 控制臺(tái)找到“設(shè)備接入”或“MQTT 接入”頁面以平臺(tái)給出的實(shí)際接入點(diǎn)為準(zhǔn)。這個(gè)細(xì)節(jié)很多初學(xué)者會(huì)踩坑也是 ESP8266/ESP01S 連接 OneNET 失敗的高頻原因之一。6.3 STM32 通過串口控制 ESP01S 的代碼手動(dòng)調(diào)試通過后就可以把 AT 指令封裝到 STM32 代碼里。ESP01S 與 STM32 的接線方式STM32ESP01SPA2USART2 TXRXPA3USART2 RXTX3.3V獨(dú)立穩(wěn)壓VCCGNDGND10K 上拉電阻CH_PD/EN下面這段代碼演示了如何使用串口 2 發(fā)送 AT 指令并等待 ESP01S 返回指定關(guān)鍵字。// 文件路徑User/esp01s_at.c #include esp01s_at.h #include stm32f10x.h #include string.h #include stdio.h extern UART_HandleTypeDef huart2; // 標(biāo)準(zhǔn)庫項(xiàng)目請(qǐng)?zhí)鎿Q為 USART2 static uint8_t rx_buffer[512]; static uint16_t rx_len 0; void ESP01S_SendCmd(const char *cmd) { USART_SendString(USART2, (uint8_t *)cmd); } uint8_t ESP01S_WaitResponse(const char *keyword, uint16_t timeout) { // 簡化實(shí)現(xiàn)輪詢接收緩沖區(qū)判斷是否包含關(guān)鍵字 // 真實(shí)項(xiàng)目中建議使用狀態(tài)機(jī) 環(huán)形緩沖區(qū) } uint8_t ESP01S_ConnectWiFi(const char *ssid, const char *pwd) { char cmd[128]; sprintf(cmd, ATCWJAP\%s\,\%s\\r\n, ssid, pwd); ESP01S_SendCmd(cmd); return ESP01S_WaitResponse(OK, 10000); } uint8_t ESP01S_ConnectMQTT(const char *clientId, const char *username, const char *password, const char *host, int port) { char cmd[256]; sprintf(cmd, ATMQTTUSERCFG0,1,\%s\,\%s\,\%s\,0,0,\\\r\n, clientId, username, password); ESP01S_SendCmd(cmd); if (ESP01S_WaitResponse(OK, 3000)) { sprintf(cmd, ATMQTTCONN0,\%s\,%d,1\r\n, host, port); ESP01S_SendCmd(cmd); return ESP01S_WaitResponse(CONNACK, 10000); } return 0; } uint8_t ESP01S_PublishData(float temp, float humi, uint16_t gas) { char payload[128]; sprintf(payload, {\temperature\:%.1f,\humidity\:%.1f,\gas\:%d}, temp, humi, gas); char cmd[192]; sprintf(cmd, ATMQTTPUB0,\數(shù)據(jù)流主題名\,\%s\,0,0\r\n, payload); ESP01S_SendCmd(cmd); return ESP01S_WaitResponse(OK, 3000); }這段代碼里的USART_SendString和USART2在本示例中約定在bsp_usart.c中實(shí)現(xiàn)。標(biāo)準(zhǔn)庫環(huán)境下需要為串口 2 單獨(dú)寫初始化與串口 1 布局一致。實(shí)際應(yīng)用中AT 指令的響應(yīng)不是一次就發(fā)完的。最推薦的方案是串口接收中斷 環(huán)形緩沖區(qū)在主循環(huán)中解析緩沖區(qū)內(nèi)容。純阻塞式等待在局域網(wǎng)環(huán)境下問題不大但 Wi-Fi 環(huán)境不穩(wěn)定時(shí)一旦丟包程序就會(huì)卡死。6.4 OneNET 平臺(tái)配置與數(shù)據(jù)流OneNET 平臺(tái)側(cè)的操作大致是注冊(cè)賬號(hào)并登錄 OneNET 控制臺(tái)創(chuàng)建產(chǎn)品選擇 MQTT 協(xié)議在產(chǎn)品下添加設(shè)備記錄設(shè)備 ID、鑒權(quán)信息查看接入文檔確定 MQTT broker 地址、端口和 Topic 格式在一段時(shí)間內(nèi)收集設(shè)備上報(bào)的數(shù)據(jù)然后在平臺(tái)添加或確認(rèn)數(shù)據(jù)流模板。這里有幾個(gè)容易混淆的概念數(shù)據(jù)流Datastream描述一個(gè)設(shè)備的某一類數(shù)據(jù)比如 “temperature”數(shù)據(jù)點(diǎn)Datapoint某個(gè)時(shí)間點(diǎn)的具體數(shù)值命令/消息下發(fā)從云平臺(tái)或小程序向設(shè)備發(fā)送控制指令。聯(lián)動(dòng)小程序時(shí)上報(bào)數(shù)據(jù)可以直接按 JSON 格式打包平臺(tái)側(cè)根據(jù)數(shù)據(jù)流模板解析。如果平臺(tái)沒有預(yù)定義模板只要在發(fā)布時(shí)使用相同的 Topic 和字段名也能在設(shè)備日志里看到原始數(shù)據(jù)。6.5 ESP01S 發(fā)送 TCP 消息與手機(jī)接收熱搜詞里有“esp01s發(fā)送tcp消息 手機(jī)”這其實(shí)是 ESP01S 最基礎(chǔ)的用法通過ATCIPSTART建立 TCP 連接把數(shù)據(jù)發(fā)到某個(gè)服務(wù)器或手機(jī) App 監(jiān)聽端口。它在局域網(wǎng)里很容易驗(yàn)證比如用手機(jī)上的網(wǎng)絡(luò)調(diào)試助手工具監(jiān)聽端口ESP01S 就能把數(shù)據(jù)推過去。但在本項(xiàng)目里這種“點(diǎn)對(duì)點(diǎn) TCP”并不適合做完整畢設(shè)原因有二手機(jī)沒有公網(wǎng) IP 時(shí)無法直接接收局域網(wǎng)外的 ESP01S 數(shù)據(jù)TCP 透?jìng)鳑]有鑒權(quán)、沒有歷史存儲(chǔ)不夠“平臺(tái)化”。OneNET 的價(jià)值正是解決這兩個(gè)問題把數(shù)據(jù)存儲(chǔ)在云端小程序通過 API 訂閱設(shè)備側(cè)只維護(hù)一條 MQTT 長連接。7. 微信小程序控制端設(shè)計(jì)與對(duì)接思路7.1 小程序架構(gòu)微信小程序端有兩種常見做法直連 OneNET API通過 HTTP 請(qǐng)求獲取設(shè)備最新數(shù)據(jù)點(diǎn)再展示到頁面上。優(yōu)點(diǎn)是架構(gòu)簡單缺點(diǎn)是直接暴露平臺(tái)訪問密鑰到前端有安全風(fēng)險(xiǎn)。個(gè)人演示項(xiàng)目可以接受但正式項(xiàng)目不建議。自建后端中轉(zhuǎn)小程序請(qǐng)求自己的后端接口后端再與 OneNET 交互。更安全但需要一臺(tái)服務(wù)器或云函數(shù)。對(duì)課程設(shè)計(jì)和競(jìng)賽而言第一種方案演示速度最快。OneNET 的 API 一般支持按產(chǎn)品設(shè)備和數(shù)據(jù)流查詢最新數(shù)據(jù)返回 JSON 后在小程序里渲染即可。7.2 頁面與功能一個(gè)典型的廚房安全監(jiān)測(cè)小程序包含三個(gè)頁面數(shù)據(jù)總覽頁卡片式展示溫度、濕度、煙霧濃度設(shè)備控制頁排風(fēng)扇開關(guān)、報(bào)警復(fù)位按鈕設(shè)置頁上報(bào)閾值、WiFi 信息如果設(shè)備端支持遠(yuǎn)程配置。需要特別提醒小程序端必須處理“設(shè)備離線”狀態(tài)。如果 ESP01S 斷開連接OneNET 會(huì)標(biāo)記設(shè)備離線小程序顯示的數(shù)據(jù)可能是舊數(shù)據(jù)此時(shí)界面要提示“設(shè)備離線”而不是給用戶一個(gè)誤以為實(shí)時(shí)的數(shù)值。7.3 命令下發(fā)原理遠(yuǎn)程控制的本質(zhì)是“向設(shè)備發(fā)布一條消息”。在 OneNET 里這通常表現(xiàn)為云平臺(tái)向設(shè)備的訂閱 Topic 下發(fā)消息ESP01S 收到后通過串口發(fā)給 STM32STM32 解析后控制繼電器或蜂鳴器。因此STM32 端不僅要有“上報(bào)數(shù)據(jù)”的代碼還要有“接收下行消息”的解析邏輯。這需要用到串口接收中斷和消息隊(duì)列復(fù)雜度比單向上報(bào)高一些。做的時(shí)候先保證上報(bào)能通再擴(kuò)展下行控制不要一上來就同時(shí)做雙向通信。8. PCB 設(shè)計(jì)從原理圖到打板8.1 設(shè)計(jì)流程如果項(xiàng)目要出實(shí)物板推薦用嘉立創(chuàng)EDA立創(chuàng)EDA這類國產(chǎn)工具流程短、上手快而且可以直接對(duì)接打板服務(wù)。基本流程新建工程畫原理圖添加 STM32F103C8T6、晶振、復(fù)位、電源、傳感器接口、繼電器驅(qū)動(dòng)等器件進(jìn)行 ERC 電氣規(guī)則檢查修正未連接網(wǎng)絡(luò)生成 PCB先擺好核心器件位置再進(jìn)行布線鋪銅、添加絲印、檢查開路短路導(dǎo)出 Gerber 文件上傳打板也可以直接在 EDA 內(nèi)使用在線下單。8.2 PCB 布局與布線要點(diǎn)廚房安全監(jiān)測(cè)板屬于混合電路板既有 3.3V 數(shù)字電路又有繼電器這樣的功率電路。布局時(shí)最忌諱把大電流線路與敏感傳感器線攪在一起。幾個(gè)實(shí)用原則按模塊分區(qū)STM32 最小系統(tǒng)放中間ESP01S 放一側(cè)繼電器放另一側(cè)傳感器接口放邊緣電源走線加粗5V 和 GND 走線建議 30mil 以上繼電器控制線至少在 20mil 以上信號(hào)線 12mil 即可晶振盡量靠近 STM32 的 OSC 引腳走線要短且不要平行長距離走線模擬地和數(shù)字地可以先用磁珠或 0Ω 電阻連接重點(diǎn)保證 MQ-2 的 ADC 采樣穩(wěn)定絲印字號(hào)不要太小打板回來后要能看清接口標(biāo)識(shí)繼電器下方銅皮要留足必要時(shí)加開窗避免散熱和機(jī)械應(yīng)力導(dǎo)致焊盤脫落。8.3 常見 PCB 設(shè)計(jì)問題熱搜詞里有很多 PCB 相關(guān)問題比如“gerber 文件轉(zhuǎn)成 pcb 文件”“pcb 板廠鉆孔工序”“pcb 添加 ole 文件對(duì)象”等。站在新手角度最容易忽略的是下面幾個(gè)Gerber 文件是生產(chǎn)文件不是可以繼續(xù)編輯的 PCB 工程文件。需要修改板子時(shí)要回到 EDA 工程里改而不是去處理 Gerber打板時(shí)板廠會(huì)按廠商件和標(biāo)準(zhǔn)工藝區(qū)分最小線寬、線距、孔徑。下單前先查看所選工藝參數(shù)不能想畫多細(xì)都行鉆孔文件Drill通常和 Gerber 一起打包轉(zhuǎn)格式時(shí)不要把鉆孔文件漏掉否則板子無法打孔PCB 絲印模糊通常是因?yàn)樽煮w太小或線寬過細(xì)設(shè)計(jì)階段就要檢查絲印規(guī)則。9. 常見問題與排查思路整理一份完整排查表覆蓋這套系統(tǒng)從焊接、燒錄到上云過程中最高頻的問題問題現(xiàn)象可能原因排查方式解決方案error: no stm32 target found! if your product embeds debug authenticationST-Link 連接不穩(wěn)定、芯片鎖死、供電不足檢查 SWDIO/SWCLK 和 GND 接線測(cè) 3.3V 電壓按住復(fù)位再點(diǎn)下載用 STM32 ST-LINK Utility 連接按復(fù)位期間燒錄必要時(shí)設(shè)置 BOOT0 拉高Keil 編譯報(bào)錯(cuò)找不到器件未安裝 STM32F1 器件支持包打開 Pack Installer 確認(rèn)在 Pack Installer 中安裝 STM32F1xx 系列支持包Keil 打開 C51 項(xiàng)目后無法編譯 STM32編譯器版本不對(duì)查看 Options for Target 中的編譯器設(shè)置選擇 ARM Compiler確保工程文件是 MDK 工程串口打印亂碼波特率不匹配檢查串口助手和 MCU 初始化波特率統(tǒng)一為 115200ESP01S 上電后不響應(yīng) AT供電不足 或 CH_PD 未拉高測(cè)量 VCC 電壓是否穩(wěn)定 3.3V檢查 CH_PD 引腳使用獨(dú)立 3.3V 穩(wěn)壓CH_PD 接 10K 上拉ESP01S 連接 WiFi 失敗SSID/密碼錯(cuò)誤、路由器是 5GHz 或加密方式不支持檢查 AT 返回的 ERROR 碼使用 2.4GHz 路由器確認(rèn)賬號(hào)密碼必要時(shí)重置 WiFi 配置OneNET 連接失敗設(shè)備鑒權(quán)信息不對(duì)、接入地址端口錯(cuò)誤查看 MQTT CONNECT 返回碼以 OneNET 控制臺(tái)接入文檔的參數(shù)為準(zhǔn)不要照抄老教程數(shù)據(jù)上傳成功但平臺(tái)無數(shù)據(jù)Topic 或數(shù)據(jù)流字段名不一致在平臺(tái)查看設(shè)備日志和原始上報(bào)數(shù)據(jù)統(tǒng)一 Topic 與 JSON 字段名小程序設(shè)備離線ESP01S 掉線或網(wǎng)絡(luò)異常檢查 ESP01S 供電與 WiFi 信號(hào)增加斷線重連機(jī)制定時(shí)發(fā)送心跳繼電器不動(dòng)作GPIO 驅(qū)動(dòng)能力不足或三極管接線錯(cuò)誤測(cè)量繼電器控制端電壓使用三極管/ULN2003 驅(qū)動(dòng)并聯(lián)續(xù)流二極管PCB 下載程序時(shí)報(bào)芯片找不到焊接虛焊、BOOT0 未接地、晶振不起振檢查 STM32 最小系統(tǒng)焊接和供電重新焊接關(guān)鍵引腳檢查晶振和復(fù)位電路PCB 打樣回來后絲印看不清絲印線寬過細(xì)在 EDA 中檢查絲印層調(diào)整絲印最小線寬一般在 10mil 以上這里特別要提一下stm32 virtual com port 嘆號(hào)這個(gè)問題。很多 STM32 板子通過 USB 虛擬串口連接電腦時(shí)設(shè)備管理器里會(huì)出現(xiàn)黃色感嘆號(hào)本質(zhì)是缺少驅(qū)動(dòng)。遇到這種情況先裝 STM32 的 VCPVirtual COM Port驅(qū)動(dòng)再檢查 USB 線是否只供電沒有信號(hào)線。還有一種情況是板子的 USB D 上拉電阻沒有接好這種屬于硬件問題。10. 最佳實(shí)踐與工程建議10.1 代碼層面的工程化建議不要把所有邏輯都塞在 main 函數(shù)的 while 循環(huán)里。推薦至少拆成幾個(gè)模塊傳感器采集模塊負(fù)責(zé)讀取原始數(shù)據(jù)并校驗(yàn)數(shù)據(jù)上報(bào)模塊負(fù)責(zé)拼裝 JSON、通過串口發(fā)送 AT 指令控制模塊負(fù)責(zé)本地閾值判斷、繼電器和蜂鳴器動(dòng)作串口接收模塊負(fù)責(zé)處理 ESP01S 返回的下行數(shù)據(jù)。每個(gè)模塊之間通過結(jié)構(gòu)體或全局狀態(tài)機(jī)傳遞數(shù)據(jù)。這樣做的好處是調(diào)試時(shí)能快速定位問題也方便答辯時(shí)講清楚代碼結(jié)構(gòu)。另外一定要打開編譯器的 warning 提示盡量做到零 warning。很多人把 warning 當(dāng)回車鍵跳過結(jié)果上電才發(fā)現(xiàn)某個(gè)變量未初始化產(chǎn)生隨機(jī)值導(dǎo)致系統(tǒng)行為不可預(yù)期。10.2 安全邊界廚房安全系統(tǒng)的核心價(jià)值是“不安全時(shí)能報(bào)警”而不是“網(wǎng)絡(luò)通暢時(shí)才安全”。因此設(shè)計(jì)時(shí)要注意本地判斷優(yōu)先即使無法上云也要保證本地蜂鳴器和繼電器能響應(yīng)斷電恢復(fù)意外斷電后重新上電系統(tǒng)能自動(dòng)恢復(fù)初始化而不是停在異常狀態(tài)傳感器臟污處理MQ-2 長時(shí)間使用會(huì)漂移要定期校準(zhǔn)基準(zhǔn)值或加自動(dòng)標(biāo)定邏輯閾值可配置默認(rèn)閾值只是演示值正式使用要根據(jù)安裝環(huán)境重新標(biāo)定。10.3 不斷線重連ESP01S 在長時(shí)間運(yùn)行時(shí)可能掉線。工程上要有一個(gè)“連接狀態(tài)檢測(cè) 自動(dòng)重連”的機(jī)制定期檢查是否收到 OneNET 的響應(yīng)如果超過 N 秒沒有消息就重新執(zhí)行 WiFi 連接和 MQTT 連接流程。這里要注意反復(fù)快速重連可能會(huì)被路由器或云平臺(tái)臨時(shí)封禁所以重連間隔要加退避比如第一次 5 秒、第二次 10 秒、之后 30 秒。10.4 答辯與文檔準(zhǔn)備如果是畢業(yè)設(shè)計(jì)除了代碼跑通還要提前準(zhǔn)備好以下材料系統(tǒng)框圖、時(shí)序圖、狀態(tài)機(jī)圖關(guān)鍵模塊的測(cè)試記錄比如 AT 指令聯(lián)調(diào)日志、數(shù)據(jù)上報(bào)日志PCB 原理圖、Gerber 文件、BOM 清單小程序截圖和演示視頻。關(guān)鍵是講清楚“我為什么這么做”而不是只講“我做了什么”。比如為什么選擇 MQTT 而不是 HTTP為什么本地也要做判斷為什么電源要獨(dú)立穩(wěn)壓這些問題在答辯時(shí)被問到的概率極高。10.5 擴(kuò)展方向這套系統(tǒng)做完之后可擴(kuò)展的方向很多把 DHT11 換成 SHT30提高溫濕度精度加入 OLED 顯示屏本地可視化數(shù)據(jù)接入攝像頭實(shí)現(xiàn)遠(yuǎn)程廚房看護(hù)換成 4G 模塊如合宙 Air724 等擺脫 WiFi 依賴把 OneNET 換成自建 MQTT 服務(wù)器學(xué)習(xí)更底層的數(shù)據(jù)流轉(zhuǎn)過程。11. 總結(jié)STM32 廚房安全監(jiān)測(cè)系統(tǒng)不是一個(gè)“高大上”的選題但它非常典型它把單片機(jī)編程、傳感器接口、串口通信、WiFi 模塊 AT 指令、云平臺(tái) MQTT 接入、小程序 API 調(diào)用、PCB 設(shè)計(jì)這些物聯(lián)網(wǎng)核心技術(shù)點(diǎn)串成了一個(gè)完整閉環(huán)。真正值得你投入精力的不是背下某一條 AT 指令也不是記住某個(gè)平臺(tái)按鈕的位置而是理解“端-云-應(yīng)用”這條數(shù)據(jù)鏈路的連接方式。做完這個(gè)項(xiàng)目你手里就有一套可以遷移到很多物聯(lián)網(wǎng)場(chǎng)景的“骨架”。建議動(dòng)手順序也很明確先用最小舵機(jī)跑通單點(diǎn)上報(bào)再做本地控制最后接小程序和 PCB。這樣每一步都有可驗(yàn)證的產(chǎn)出不容易卡在最后聯(lián)調(diào)階段。建議把這篇文章收藏備用按章節(jié)逐步實(shí)踐。如果你遇到某個(gè)環(huán)節(jié)卡住優(yōu)先對(duì)照“常見問題與排查思路”表格絕大多數(shù)問題出在供電、接線、串口參數(shù)和平臺(tái)鑒權(quán)這四類原因上。祝你的廚房安全系統(tǒng)順利落地。