控器：低功耗硬件方案與全棧實(shí)踐)
1. 項(xiàng)目概述為什么需要一個(gè)墨水屏的PC性能監(jiān)視器最近在折騰我的主力臺(tái)式機(jī)機(jī)箱側(cè)透RGB燈效拉滿但總覺(jué)得少了點(diǎn)什么。每次想看看CPU溫度、內(nèi)存占用要么得切到任務(wù)管理器要么得依賴第三方懸浮窗軟件不僅占用屏幕空間還有點(diǎn)“軟”不夠“硬核”。直到我看到手邊吃灰的ESP32開(kāi)發(fā)板和一塊2.9英寸的電子墨水屏一個(gè)想法冒了出來(lái)能不能用它們做一個(gè)獨(dú)立的、低功耗的、能擺在桌面上隨時(shí)瞥一眼的硬件性能監(jiān)視器這個(gè)“ESP32 PC性能監(jiān)控器”項(xiàng)目就是答案。它的核心思路很簡(jiǎn)單在PC端運(yùn)行一個(gè)輕量級(jí)的服務(wù)程序?qū)崟r(shí)采集系統(tǒng)性能數(shù)據(jù)如CPU/GPU占用率、溫度、內(nèi)存使用量、網(wǎng)絡(luò)速度等然后通過(guò)Wi-Fi將這些數(shù)據(jù)發(fā)送給ESP32。ESP32接收到數(shù)據(jù)后驅(qū)動(dòng)連接的電子墨水屏e-Paper進(jìn)行刷新顯示。墨水屏的特性決定了它只在刷新時(shí)耗電顯示靜態(tài)內(nèi)容時(shí)零功耗非常適合這種需要長(zhǎng)時(shí)間顯示、但數(shù)據(jù)更新頻率不高比如每秒一次的場(chǎng)景。這不僅僅是一個(gè)“為做而做”的極客玩具。對(duì)于需要長(zhǎng)時(shí)間渲染、編譯代碼、跑模擬或挖礦的用戶一個(gè)不占用主屏幕、低干擾的硬件監(jiān)視器能讓你隨時(shí)掌握系統(tǒng)狀態(tài)避免過(guò)熱或資源耗盡。對(duì)于喜歡簡(jiǎn)潔桌面的用戶它能取代軟件懸浮窗讓桌面更清爽。更重要的是整個(gè)項(xiàng)目融合了嵌入式開(kāi)發(fā)、網(wǎng)絡(luò)通信、系統(tǒng)監(jiān)控和硬件驅(qū)動(dòng)等多個(gè)有趣的技術(shù)點(diǎn)是一次非常棒的全棧式學(xué)習(xí)實(shí)踐。2. 核心方案設(shè)計(jì)與技術(shù)選型2.1 為什么是ESP32 e-Paper選擇ESP32作為主控幾乎是這個(gè)項(xiàng)目的必然選擇。首先它內(nèi)置Wi-Fi和藍(lán)牙完美解決了與PC通信的問(wèn)題無(wú)需額外模塊。其次它的雙核處理器和充足的內(nèi)存通常4MB Flash520KB SRAM足以處理JSON數(shù)據(jù)解析和驅(qū)動(dòng)墨水屏這類任務(wù)。最后其龐大的社區(qū)和豐富的庫(kù)支持無(wú)論是Arduino框架還是ESP-IDF讓開(kāi)發(fā)門(mén)檻大大降低。而選擇電子墨水屏e-Paper則是出于顯示特性的考慮。與LCD或OLED屏需要持續(xù)刷新以維持顯示不同墨水屏利用帶電粒子在電場(chǎng)中移動(dòng)的原理一旦畫(huà)面刷新完成即使斷電圖像也能保持。這帶來(lái)了兩大核心優(yōu)勢(shì)超低功耗和類紙的視覺(jué)體驗(yàn)。對(duì)于這個(gè)監(jiān)控器項(xiàng)目我們可能每1-5秒才更新一次數(shù)據(jù)在99%的時(shí)間里ESP32和屏幕都可以處于深度睡眠或完全斷電狀態(tài)功耗極低。同時(shí)它沒(méi)有背光不刺眼適合長(zhǎng)時(shí)間擺在眼前。2.2 整體架構(gòu)與通信協(xié)議項(xiàng)目的架構(gòu)清晰分為兩端PC端數(shù)據(jù)采集與發(fā)送端一個(gè)常駐后臺(tái)的服務(wù)或腳本。它負(fù)責(zé)調(diào)用操作系統(tǒng)API獲取性能數(shù)據(jù)并將數(shù)據(jù)打包通過(guò)網(wǎng)絡(luò)發(fā)送給ESP32。ESP32端數(shù)據(jù)接收與顯示端硬件主體。它連接Wi-Fi監(jiān)聽(tīng)特定端口接收PC發(fā)來(lái)的數(shù)據(jù)包解析后驅(qū)動(dòng)墨水屏更新顯示。通信協(xié)議的選擇至關(guān)重要它需要兼顧簡(jiǎn)單、高效和可靠。這里有幾個(gè)主流選項(xiàng)HTTP (REST API)ESP32作為簡(jiǎn)易的HTTP服務(wù)器PC端通過(guò)POST請(qǐng)求發(fā)送JSON數(shù)據(jù)。優(yōu)點(diǎn)是通用、易于調(diào)試可以用Postman測(cè)試但開(kāi)銷相對(duì)較大需要處理HTTP頭。WebSocket建立全雙工通信通道適合需要PC主動(dòng)推送且ESP32可能反向控制的場(chǎng)景。但協(xié)議稍復(fù)雜對(duì)于單向數(shù)據(jù)流有點(diǎn)“殺雞用牛刀”。TCP/UDP 原始套接字最靈活高效的方式。可以自定義非常精簡(jiǎn)的數(shù)據(jù)包格式。UDP更快但不可靠TCP可靠但稍慢。對(duì)于局域網(wǎng)內(nèi)、短距離、高頻率如1秒一次的更新UDP是很好的選擇即使偶爾丟包下一次更新也會(huì)覆蓋。MQTT發(fā)布/訂閱模式。如果未來(lái)想擴(kuò)展為多個(gè)顯示屏監(jiān)控多個(gè)PC或者通過(guò)手機(jī)查看MQTT是優(yōu)雅的解決方案。ESP32訂閱一個(gè)主題PC向該主題發(fā)布消息。它需要額外的MQTT代理服務(wù)器如Mosquitto。對(duì)于初學(xué)者或追求快速實(shí)現(xiàn)HTTP JSON是最推薦的方式因?yàn)樗?jiǎn)單直觀調(diào)試方便。當(dāng)我們追求極致效率和低延遲時(shí)可以轉(zhuǎn)向自定義TCP/UDP協(xié)議。本項(xiàng)目后續(xù)的實(shí)操將以HTTP JSON為例進(jìn)行因?yàn)樗钅荏w現(xiàn)從原理到實(shí)現(xiàn)的完整鏈路理解后遷移到其他協(xié)議也很容易。注意在PC端程序的選擇上Python憑借其豐富的系統(tǒng)監(jiān)控庫(kù)如psutil和網(wǎng)絡(luò)庫(kù)成為快速原型開(kāi)發(fā)的首選。對(duì)于最終希望以系統(tǒng)服務(wù)形式運(yùn)行的用戶可以考慮用Go或C#將其編譯為原生可執(zhí)行文件。3. 硬件準(zhǔn)備與電路連接3.1 物料清單你需要準(zhǔn)備以下硬件ESP32開(kāi)發(fā)板任何一款通用的ESP32開(kāi)發(fā)板均可如ESP32-DevKitC、NodeMCU-32S等。確保其Wi-Fi功能正常。電子墨水屏e-Paper模塊推薦使用2.9英寸或4.2英寸的三色黑、白、紅墨水屏分辨率通常為296x128或400x300。品牌方面Waveshare微雪的產(chǎn)品資料最全配套庫(kù)也最完善。購(gòu)買時(shí)務(wù)必選擇帶SPI接口的“裸屏驅(qū)動(dòng)板”一體模塊。杜邦線若干用于連接。USB數(shù)據(jù)線用于給ESP32供電和燒錄程序?？蛇x外殼與支架3D打印一個(gè)外殼或者用樂(lè)高積木搭建一個(gè)支架讓成品更美觀。3.2 電路連接詳解墨水屏與ESP32通常通過(guò)SPI串行外設(shè)接口通信。SPI需要4根線SCK時(shí)鐘、MOSI主機(jī)輸出從機(jī)輸入、MISO主機(jī)輸入從機(jī)輸出、CS片選。此外墨水屏還需要額外的控制引腳DC數(shù)據(jù)/命令選擇、RST復(fù)位、BUSY忙狀態(tài)指示。以下是典型的連接方式以ESP32和微雪2.9英寸三色屏為例墨水屏引腳ESP32 GPIO引腳功能說(shuō)明VCC3.3V電源務(wù)必接3.3V接5V會(huì)燒屏GNDGND地線DINGPIO 23 (MOSI)SPI數(shù)據(jù)輸入主機(jī)輸出CLKGPIO 18 (SCK)SPI時(shí)鐘CSGPIO 5片選低電平有效DCGPIO 17數(shù)據(jù)/命令選擇高電平數(shù)據(jù)低電平命令RSTGPIO 16復(fù)位低電平復(fù)位BUSYGPIO 4忙狀態(tài)指示高電平空閑低電平忙實(shí)操心得1GPIO分配ESP32的許多GPIO有復(fù)用功能。上述分配是常見(jiàn)方案但并非唯一。如果與其他外設(shè)沖突你可以更改只需在代碼中相應(yīng)修改引腳定義即可。避開(kāi)一些特殊引腳如GPIO6-11通常用于內(nèi)部FlashGPIO34-39只能輸入不能輸出。實(shí)操心得2供電穩(wěn)定性ESP32和墨水屏在刷新瞬間電流可能較大。如果使用USB口供電請(qǐng)確保USB線質(zhì)量良好且電源電腦USB口或充電頭能提供足夠電流至少500mA。供電不穩(wěn)可能導(dǎo)致ESP32重啟或屏幕刷新異常。連接完成后硬件部分就準(zhǔn)備好了。建議先用廠家提供的示例程序測(cè)試一下屏幕是否能正常顯示排除硬件連接故障。4. PC端數(shù)據(jù)采集服務(wù)實(shí)現(xiàn)PC端是我們的“數(shù)據(jù)源頭”。我們將使用Python來(lái)編寫(xiě)這個(gè)服務(wù)因?yàn)樗缙脚_(tái)Windows/macOS/Linux并且有強(qiáng)大的psutil庫(kù)來(lái)獲取系統(tǒng)信息。4.1 環(huán)境搭建與依賴安裝首先確保你的電腦安裝了Python 3.6或更高版本。然后通過(guò)pip安裝必要的庫(kù)pip install psutil flaskpsutil跨平臺(tái)的系統(tǒng)信息和進(jìn)程工具庫(kù)是我們獲取所有性能數(shù)據(jù)的核心。flask一個(gè)輕量級(jí)的Web框架。我們將用它創(chuàng)建一個(gè)簡(jiǎn)單的HTTP服務(wù)器供ESP32查詢數(shù)據(jù)。4.2 核心數(shù)據(jù)采集函數(shù)編寫(xiě)創(chuàng)建一個(gè)名為pc_monitor_server.py的文件。我們先編寫(xiě)數(shù)據(jù)采集部分import psutil import json import time def get_system_stats(): 采集并返回系統(tǒng)性能數(shù)據(jù)的字典 stats {} # CPU相關(guān) stats[cpu_percent] psutil.cpu_percent(interval0.5) # 0.5秒內(nèi)的平均使用率 stats[cpu_freq] psutil.cpu_freq().current if psutil.cpu_freq() else 0 # 當(dāng)前頻率(MHz) stats[cpu_temp] _get_cpu_temperature() # 溫度獲取需要平臺(tái)特定代碼見(jiàn)下文 # 內(nèi)存相關(guān) mem psutil.virtual_memory() stats[mem_total] mem.total // (1024**2) # 轉(zhuǎn)換為MB stats[mem_used] mem.used // (1024**2) stats[mem_percent] mem.percent # 磁盤(pán)相關(guān)默認(rèn)取C盤(pán)或根分區(qū) disk psutil.disk_usage(/) if not psutil.WINDOWS else psutil.disk_usage(C:\\) stats[disk_total] disk.total // (1024**3) # 轉(zhuǎn)換為GB stats[disk_used] disk.used // (1024**3) stats[disk_percent] disk.percent # 網(wǎng)絡(luò)相關(guān)獲取當(dāng)前活動(dòng)的網(wǎng)卡計(jì)算收發(fā)速度 net_io psutil.net_io_counters() stats[net_sent] net_io.bytes_sent stats[net_recv] net_io.bytes_recv # 注意這里發(fā)送的是累計(jì)值速度需要在客戶端計(jì)算差值/時(shí)間 # GPU相關(guān)需要額外庫(kù)如pynvml for NVIDIA GPU stats[gpu_percent], stats[gpu_temp] _get_gpu_info() # 可選功能 stats[timestamp] int(time.time()) # 添加時(shí)間戳 return stats def _get_cpu_temperature(): 獲取CPU溫度平臺(tái)相關(guān) try: if psutil.LINUX: # Linux: 通常從/sys/class/thermal讀取 with open(/sys/class/thermal/thermal_zone0/temp, r) as f: temp int(f.read()) / 1000.0 return temp elif psutil.MACOS: # macOS: 使用osx-cpu-temp庫(kù)或調(diào)用istats命令需額外安裝 # 這里返回一個(gè)模擬值或0 return 0.0 elif psutil.WINDOWS: # Windows: 需要pyspectator或OpenHardwareMonitorWMI等復(fù)雜方式 # 為簡(jiǎn)化這里返回0建議使用第三方工具如HWiNFO的共享內(nèi)存接口 return 0.0 except: return 0.0 def _get_gpu_info(): 獲取GPU信息需要NVIDIA ML庫(kù) # 這是一個(gè)高級(jí)功能初期可以返回(0, 0) return 0, 04.3 創(chuàng)建HTTP API服務(wù)接下來(lái)使用Flask創(chuàng)建一個(gè)簡(jiǎn)單的Web服務(wù)器暴露一個(gè)API端點(diǎn)來(lái)返回JSON數(shù)據(jù)from flask import Flask, jsonify import threading app Flask(__name__) # 全局變量存儲(chǔ)上一次的網(wǎng)絡(luò)IO計(jì)數(shù)用于計(jì)算瞬時(shí)速度 last_net_io psutil.net_io_counters() last_time time.time() def calculate_network_speed(): 計(jì)算網(wǎng)絡(luò)上傳下載速度KB/s global last_net_io, last_time current_net_io psutil.net_io_counters() current_time time.time() time_diff current_time - last_time if time_diff 0: up_speed (current_net_io.bytes_sent - last_net_io.bytes_sent) / time_diff / 1024.0 down_speed (current_net_io.bytes_recv - last_net_io.bytes_recv) / time_diff / 1024.0 else: up_speed down_speed 0.0 last_net_io current_net_io last_time current_time return round(up_speed, 1), round(down_speed, 1) app.route(/api/stats, methods[GET]) def get_stats(): 主API端點(diǎn)返回所有系統(tǒng)狀態(tài) stats get_system_stats() up_speed, down_speed calculate_network_speed() stats[net_up_speed] up_speed stats[net_down_speed] down_speed return jsonify(stats) app.route(/health, methods[GET]) def health(): 健康檢查端點(diǎn) return jsonify({status: ok}) def run_server(): 在獨(dú)立線程中運(yùn)行Flask服務(wù)器 # 注意在生產(chǎn)環(huán)境中不要使用debugTrue并且最好綁定到局域網(wǎng)IP而非0.0.0.0 app.run(host0.0.0.0, port5000, debugFalse, threadedTrue) if __name__ __main__: print(PC性能監(jiān)控服務(wù)啟動(dòng)訪問(wèn) http://localhost:5000/api/stats) # 直接運(yùn)行主線程開(kāi)發(fā)用 app.run(host0.0.0.0, port5000, debugTrue)現(xiàn)在在PC上運(yùn)行這個(gè)腳本python pc_monitor_server.py然后在瀏覽器中訪問(wèn)http://localhost:5000/api/stats你應(yīng)該能看到返回的JSON格式系統(tǒng)性能數(shù)據(jù)。這就意味著數(shù)據(jù)源已經(jīng)準(zhǔn)備好了。注意事項(xiàng)默認(rèn)情況下Flask開(kāi)發(fā)服務(wù)器僅適用于本地開(kāi)發(fā)和測(cè)試。如果你希望從同一局域網(wǎng)內(nèi)的ESP32訪問(wèn)需要確保防火墻允許5000端口的入站連接并且如上代碼所示使用host0.0.0.0。對(duì)于長(zhǎng)期后臺(tái)運(yùn)行建議使用waitress或gunicorn等生產(chǎn)級(jí)WSGI服務(wù)器來(lái)替代Flask自帶的服務(wù)器并將其設(shè)置為系統(tǒng)服務(wù)如Windows服務(wù)或Linux的systemd服務(wù)。5. ESP32端固件開(kāi)發(fā)與顯示驅(qū)動(dòng)ESP32端是項(xiàng)目的“大腦”和“臉面”。我們將使用Arduino框架進(jìn)行開(kāi)發(fā)因?yàn)樗鼛?kù)管理方便對(duì)墨水屏支持好。5.1 Arduino開(kāi)發(fā)環(huán)境配置安裝Arduino IDE從Arduino官網(wǎng)下載并安裝。添加ESP32開(kāi)發(fā)板支持打開(kāi)Arduino IDE進(jìn)入文件 - 首選項(xiàng)在“附加開(kāi)發(fā)板管理器網(wǎng)址”中輸入https://espressif.github.io/arduino-esp32/package_esp32_index.json然后進(jìn)入工具 - 開(kāi)發(fā)板 - 開(kāi)發(fā)板管理器搜索“esp32”安裝“Espressif Systems”提供的ESP32開(kāi)發(fā)板包。安裝必要的庫(kù)WiFi庫(kù)通常已內(nèi)置。HTTPClient庫(kù)用于發(fā)起HTTP請(qǐng)求已內(nèi)置。ArduinoJson庫(kù)用于解析從PC端收到的JSON數(shù)據(jù)。在庫(kù)管理中搜索“ArduinoJson”并安裝建議安裝v6.x或更高版本。墨水屏驅(qū)動(dòng)庫(kù)根據(jù)你購(gòu)買的屏幕型號(hào)安裝。以微雪為例在庫(kù)管理中搜索“GxEPD2”或“e-Paper”安裝其提供的庫(kù)。或者從微雪官網(wǎng)下載其Arduino示例庫(kù)手動(dòng)安裝。5.2 固件主程序邏輯拆解創(chuàng)建一個(gè)新的Arduino項(xiàng)目我們將其邏輯分為幾個(gè)部分1. 網(wǎng)絡(luò)連接與配置首先你需要讓ESP32連接到你的家庭Wi-Fi。建議將SSID和密碼寫(xiě)在代碼里或者更優(yōu)雅地使用WiFiManager庫(kù)實(shí)現(xiàn)網(wǎng)頁(yè)配網(wǎng)。#include WiFi.h #include HTTPClient.h #include ArduinoJson.h // 你的Wi-Fi憑證 const char* ssid 你的Wi-Fi名稱; const char* password 你的Wi-Fi密碼; // PC端服務(wù)的地址和端口 const char* serverURL http://192.168.1.100:5000/api/stats; // 替換為你的PC局域網(wǎng)IP void connectToWiFi() { Serial.print(正在連接到Wi-Fi: ); Serial.println(ssid); WiFi.begin(ssid, password); int attempts 0; while (WiFi.status() ! WL_CONNECTED attempts 20) { delay(500); Serial.print(.); attempts; } if (WiFi.status() WL_CONNECTED) { Serial.println(\nWi-Fi連接成功); Serial.print(IP地址: ); Serial.println(WiFi.localIP()); } else { Serial.println(\nWi-Fi連接失敗請(qǐng)檢查配置。); // 這里可以添加進(jìn)入配網(wǎng)模式的邏輯 } }2. 數(shù)據(jù)獲取與解析連接Wi-Fi后ESP32需要定時(shí)向PC端的API發(fā)起HTTP GET請(qǐng)求并解析返回的JSON數(shù)據(jù)。// 定義存儲(chǔ)數(shù)據(jù)的結(jié)構(gòu)體 struct SystemStats { float cpuPercent; float cpuTemp; unsigned long memUsed; unsigned long memTotal; float memPercent; float diskPercent; float netUpSpeed; float netDownSpeed; // ... 其他字段 }; SystemStats currentStats; bool fetchSystemStats() { if (WiFi.status() ! WL_CONNECTED) { Serial.println(Wi-Fi未連接無(wú)法獲取數(shù)據(jù)); return false; } HTTPClient http; http.begin(serverURL); int httpCode http.GET(); if (httpCode HTTP_CODE_OK) { String payload http.getString(); // 開(kāi)始解析JSON DynamicJsonDocument doc(1024); // 根據(jù)JSON大小調(diào)整緩沖區(qū) DeserializationError error deserializeJson(doc, payload); if (error) { Serial.print(JSON解析失敗: ); Serial.println(error.c_str()); http.end(); return false; } // 提取數(shù)據(jù)到結(jié)構(gòu)體 currentStats.cpuPercent doc[cpu_percent]; currentStats.cpuTemp doc[cpu_temp]; currentStats.memUsed doc[mem_used]; currentStats.memTotal doc[mem_total]; currentStats.memPercent doc[mem_percent]; currentStats.diskPercent doc[disk_percent]; currentStats.netUpSpeed doc[net_up_speed]; currentStats.netDownSpeed doc[net_down_speed]; Serial.println(數(shù)據(jù)獲取并解析成功); http.end(); return true; } else { Serial.printf(HTTP請(qǐng)求失敗錯(cuò)誤碼: %d\n, httpCode); http.end(); return false; } }3. 墨水屏驅(qū)動(dòng)與顯示這是最有趣的部分。你需要根據(jù)具體的屏幕型號(hào)和庫(kù)來(lái)編寫(xiě)顯示代碼。以下是一個(gè)基于GxEPD2庫(kù)的通用示例框架#include GxEPD2_BW.h // 對(duì)于黑白屏 // #include GxEPD2_3C.h // 對(duì)于三色黑、白、紅屏 #include Fonts/FreeMonoBold9pt7b.h // 內(nèi)置字體 #include Fonts/FreeMonoBold12pt7b.h // 內(nèi)置字體 // 根據(jù)你的屏幕型號(hào)定義顯示對(duì)象例如對(duì)于2.9英寸黑白屏 // GxEPD2_BWGxEPD2_290, GxEPD2_290::HEIGHT display(GxEPD2_290(/*CS*/5, /*DC*/17, /*RST*/16, /*BUSY*/4)); // 對(duì)于2.9英寸三色屏 GxEPD2_3CGxEPD2_290c, GxEPD2_290c::HEIGHT display(GxEPD2_290c(/*CS*/5, /*DC*/17, /*RST*/16, /*BUSY*/4)); void setupDisplay() { display.init(115200); // 初始化屏幕 display.setRotation(1); // 設(shè)置旋轉(zhuǎn)方向0-3 display.setTextColor(GxEPD_BLACK); // 設(shè)置字體顏色 display.setFullWindow(); // 設(shè)置全窗口更新模式慢但無(wú)殘影 // display.setPartialWindow(0, 0, display.width(), display.height()); // 部分更新模式快可能有殘影 } void drawStatsOnDisplay(const SystemStats stats) { display.firstPage(); do { display.setFont(FreeMonoBold12pt7b); display.setCursor(10, 20); display.print(PC Monitor); display.setFont(FreeMonoBold9pt7b); display.setCursor(10, 50); display.printf(CPU: %.1f%%, stats.cpuPercent); display.setCursor(10, 70); display.printf(Temp: %.1fC, stats.cpuTemp); display.setCursor(10, 90); display.printf(Mem: %lu/%lu MB, stats.memUsed, stats.memTotal); display.setCursor(10, 110); display.printf(Disk: %.1f%%, stats.diskPercent); display.setCursor(10, 130); display.printf(Up: %.1f KB/s, stats.netUpSpeed); display.setCursor(10, 150); display.printf(Down: %.1f KB/s, stats.netDownSpeed); // 繪制進(jìn)度條或簡(jiǎn)單的圖形化表示 drawProgressBar(10, 170, 100, 10, stats.cpuPercent); // 繪制CPU進(jìn)度條 } while (display.nextPage()); // 更新完成后可以進(jìn)入深度睡眠以省電 // display.hibernate(); // 讓屏幕進(jìn)入休眠狀態(tài)功耗極低 } void drawProgressBar(int x, int y, int width, int height, float percent) { int fillWidth (percent / 100.0) * width; display.drawRect(x, y, width, height, GxEPD_BLACK); // 畫(huà)邊框 display.fillRect(x, y, fillWidth, height, GxEPD_BLACK); // 畫(huà)填充 }4. 主循環(huán)邏輯最后在setup()和loop()中串聯(lián)所有功能unsigned long lastUpdateTime 0; const unsigned long updateInterval 2000; // 更新間隔單位毫秒2秒 void setup() { Serial.begin(115200); delay(1000); // 給串口一點(diǎn)啟動(dòng)時(shí)間 setupDisplay(); // 首次顯示一個(gè)等待界面 display.setFullWindow(); display.firstPage(); do { display.setFont(FreeMonoBold12pt7b); display.setCursor(50, 80); display.print(Connecting...); } while (display.nextPage()); connectToWiFi(); } void loop() { unsigned long currentTime millis(); // 判斷是否到達(dá)更新間隔 if (currentTime - lastUpdateTime updateInterval) { lastUpdateTime currentTime; if (fetchSystemStats()) { // 獲取數(shù)據(jù)成功更新顯示 drawStatsOnDisplay(currentStats); Serial.println(顯示已更新); } else { // 獲取失敗顯示錯(cuò)誤或保持原畫(huà)面 Serial.println(更新失敗等待下次嘗試); // 可以在這里繪制一個(gè)錯(cuò)誤提示注意墨水屏刷新次數(shù)有限頻繁全刷會(huì)縮短壽命 } } // 短暫延遲避免loop()空轉(zhuǎn)消耗CPU delay(100); }將以上代碼整合并根據(jù)你的屏幕型號(hào)調(diào)整引腳定義和顯示庫(kù)對(duì)象編譯并上傳到ESP32。上電后它應(yīng)該會(huì)連接Wi-Fi然后開(kāi)始定期從你的PC獲取數(shù)據(jù)并顯示在墨水屏上。6. 優(yōu)化、調(diào)試與進(jìn)階玩法基礎(chǔ)功能實(shí)現(xiàn)后我們可以從多個(gè)維度進(jìn)行優(yōu)化和擴(kuò)展。6.1 功耗優(yōu)化策略墨水屏項(xiàng)目最大的優(yōu)勢(shì)就是低功耗但ESP32本身的功耗也不容忽視。深度睡眠Deep Sleep如果更新間隔較長(zhǎng)如30秒以上可以讓ESP32在每次更新顯示后進(jìn)入深度睡眠。設(shè)置一個(gè)定時(shí)器或使用外部RTC喚醒到時(shí)間后喚醒獲取數(shù)據(jù)刷新屏幕然后再次睡眠。這能將平均電流從幾十mA降到幾十μA級(jí)別。但需要注意深度睡眠下Wi-Fi連接會(huì)斷開(kāi)每次喚醒需要重新連接這會(huì)增加延遲和功耗。需要權(quán)衡連接耗時(shí)與睡眠省電。屏幕休眠調(diào)用display.hibernate()。這會(huì)讓屏幕驅(qū)動(dòng)芯片完全斷電僅保留圖像是墨水屏最省電的狀態(tài)。降低CPU頻率在Arduino中可以通過(guò)setCpuFrequencyMhz()函數(shù)降低ESP32的主頻如降到80MHz在滿足性能需求的同時(shí)降低功耗。6.2 通信協(xié)議優(yōu)化如前所述HTTPJSON方便但開(kāi)銷大。優(yōu)化方向改用UDP定義簡(jiǎn)單的二進(jìn)制數(shù)據(jù)包格式。例如將所有浮點(diǎn)數(shù)乘以10轉(zhuǎn)為整數(shù)避免浮點(diǎn)傳輸然后用固定的結(jié)構(gòu)體發(fā)送。PC端用Python的socket庫(kù)發(fā)送UDP包ESP32端用WiFiUDP接收。數(shù)據(jù)包大小可以從幾百字節(jié)壓縮到幾十字節(jié)。添加簡(jiǎn)單校驗(yàn)在數(shù)據(jù)包末尾添加一個(gè)校驗(yàn)和如所有字節(jié)相加取低8位ESP32收到后計(jì)算校驗(yàn)和比對(duì)防止錯(cuò)誤數(shù)據(jù)顯示。6.3 顯示效果與UI優(yōu)化局部刷新墨水屏全屏刷新display.setFullWindow()速度慢約2-3秒且會(huì)有明顯的全屏閃爍。部分型號(hào)支持局部刷新display.setPartialWindow()它只更新變化的部分區(qū)域速度更快幾百毫秒且無(wú)閃爍。但局部刷新多次后可能產(chǎn)生“殘影”需要定期進(jìn)行一次全刷來(lái)清除。合理的策略是前N次更新用局部刷新第N1次用全刷。自定義字體與圖形使用更美觀的字體如FreeSans系列或者將圖標(biāo)、Logo轉(zhuǎn)換為位圖數(shù)組顯示提升顏值。多頁(yè)面顯示如果屏幕足夠大可以設(shè)計(jì)多個(gè)“頁(yè)面”通過(guò)ESP32上的按鈕或通過(guò)PC發(fā)送指令來(lái)切換顯示不同的信息組合如第一頁(yè)顯示概覽第二頁(yè)顯示詳細(xì)圖表第三頁(yè)顯示網(wǎng)絡(luò)流量歷史。6.4 常見(jiàn)問(wèn)題與排查技巧屏幕不顯示或花屏檢查接線這是最常見(jiàn)的問(wèn)題。確保VCC接3.3VGND接地SPI線序正確特別是CS、DC、RST、BUSY這幾根控制線。檢查庫(kù)和型號(hào)確認(rèn)安裝的墨水屏庫(kù)與你的屏幕型號(hào)完全匹配。微雪不同尺寸、顏色的屏幕驅(qū)動(dòng)芯片可能不同。供電不足嘗試使用獨(dú)立的5V/2A電源適配器通過(guò)ESP32的Vin引腳供電或者換一根更粗的USB線。ESP32無(wú)法連接Wi-Fi檢查密碼和SSID確保代碼中的SSID和密碼正確注意大小寫(xiě)。檢查路由器設(shè)置有些路由器可能禁用了2.4GHz頻段或者設(shè)置了MAC地址過(guò)濾、隱藏了SSID。信號(hào)強(qiáng)度ESP32的Wi-Fi信號(hào)接收能力一般如果距離路由器太遠(yuǎn)或有太多墻體阻隔可能會(huì)連接不穩(wěn)定。可以打印WiFi.RSSI()查看信號(hào)強(qiáng)度。HTTP請(qǐng)求失敗錯(cuò)誤碼 -1, 4xx, 5xx-1連接失敗檢查PC端服務(wù)器是否運(yùn)行防火墻是否關(guān)閉ESP32代碼中的serverURLIP和端口是否正確。在PC命令行用ping [ESP32_IP]和curl http://localhost:5000/api/stats雙向測(cè)試網(wǎng)絡(luò)連通性。404API路徑錯(cuò)誤檢查PC端Flask的app.route定義。500PC端Python腳本出錯(cuò)查看Flask運(yùn)行終端的錯(cuò)誤信息。JSON解析失敗緩沖區(qū)大小DynamicJsonDocument doc(1024);這里的緩沖區(qū)大小可能不夠。如果PC端返回的數(shù)據(jù)很大需要增加這個(gè)值?？梢栽贏rduino串口打印出收到的payload查看其長(zhǎng)度和內(nèi)容。數(shù)據(jù)格式確保PC端返回的是嚴(yán)格合法的JSON?？梢允褂迷诰€JSON驗(yàn)證工具檢查。屏幕刷新太慢全刷 vs 局刷確認(rèn)是否使用了display.setFullWindow()。嘗試切換到局部刷新模式。網(wǎng)絡(luò)延遲如果從發(fā)送HTTP請(qǐng)求到收到響應(yīng)時(shí)間過(guò)長(zhǎng)也會(huì)拖慢整體更新周期。優(yōu)化網(wǎng)絡(luò)或改用UDP。復(fù)雜圖形繪制大量圖形或使用大字體會(huì)減慢渲染速度。簡(jiǎn)化UI。7. 項(xiàng)目擴(kuò)展與進(jìn)階思路這個(gè)項(xiàng)目是一個(gè)完美的起點(diǎn)你可以在此基礎(chǔ)上添加更多功能多PC監(jiān)控修改PC端服務(wù)使其能采集多臺(tái)電腦的數(shù)據(jù)通過(guò)局域網(wǎng)發(fā)現(xiàn)或手動(dòng)配置。ESP32端可以輪詢多個(gè)IP地址或者使用MQTT讓每臺(tái)PC發(fā)布到各自的主題ESP32訂閱所有主題。歷史數(shù)據(jù)與簡(jiǎn)單圖表ESP32內(nèi)存有限但可以存儲(chǔ)最近幾十次的數(shù)據(jù)并在屏幕上繪制簡(jiǎn)單的折線圖顯示CPU使用率的歷史趨勢(shì)。報(bào)警功能當(dāng)CPU溫度超過(guò)閾值或內(nèi)存占用超過(guò)95%時(shí)讓ESP32板載的LED閃爍或者在屏幕上用紅色顯示警告信息。無(wú)線配置使用藍(lán)牙或WiFiManager庫(kù)讓ESP32在首次啟動(dòng)時(shí)進(jìn)入配網(wǎng)模式通過(guò)手機(jī)網(wǎng)頁(yè)配置Wi-Fi和服務(wù)器地址無(wú)需修改代碼。集成到智能家居平臺(tái)將ESP32采集到的數(shù)據(jù)通過(guò)MQTT上報(bào)到Home Assistant或Node-RED這樣你就能在手機(jī)App或家庭控制面板上看到PC狀態(tài)甚至可以設(shè)置自動(dòng)化如PC溫度過(guò)高時(shí)自動(dòng)打開(kāi)房間風(fēng)扇。我個(gè)人在完成這個(gè)項(xiàng)目后把它放在了我的顯示器旁邊。它安靜、省電提供的信息一目了然。最大的成就感來(lái)自于打通了“軟件”和“硬件”的界限讓一個(gè)想法從代碼變成了桌面上一個(gè)實(shí)實(shí)在在、有用的小物件。如果你在復(fù)現(xiàn)過(guò)程中遇到了任何問(wèn)題最關(guān)鍵的是分段調(diào)試先用示例程序測(cè)試屏幕再單獨(dú)測(cè)試Wi-Fi連接然后測(cè)試HTTP獲取數(shù)據(jù)最后整合。耐心一點(diǎn)每個(gè)問(wèn)題都能在社區(qū)找到答案。祝你制作愉快 ESP32墨水屏PC性能監(jiān)控器：低功耗硬件方案與全棧實(shí)踐
1. 項(xiàng)目概述為什么需要一個(gè)墨水屏的PC性能監(jiān)視器最近在折騰我的主力臺(tái)式機(jī)機(jī)箱側(cè)透RGB燈效拉滿但總覺(jué)得少了點(diǎn)什么。每次想看看CPU溫度、內(nèi)存占用要么得切到任務(wù)管理器要么得依賴第三方懸浮窗軟件不僅占用屏幕空間還有點(diǎn)“軟”不夠“硬核”。直到我看到手邊吃灰的ESP32開(kāi)發(fā)板和一塊2.9英寸的電子墨水屏一個(gè)想法冒了出來(lái)能不能用它們做一個(gè)獨(dú)立的、低功耗的、能擺在桌面上隨時(shí)瞥一眼的硬件性能監(jiān)視器這個(gè)“ESP32 PC性能監(jiān)控器”項(xiàng)目就是答案。它的核心思路很簡(jiǎn)單在PC端運(yùn)行一個(gè)輕量級(jí)的服務(wù)程序?qū)崟r(shí)采集系統(tǒng)性能數(shù)據(jù)如CPU/GPU占用率、溫度、內(nèi)存使用量、網(wǎng)絡(luò)速度等然后通過(guò)Wi-Fi將這些數(shù)據(jù)發(fā)送給ESP32。ESP32接收到數(shù)據(jù)后驅(qū)動(dòng)連接的電子墨水屏e-Paper進(jìn)行刷新顯示。墨水屏的特性決定了它只在刷新時(shí)耗電顯示靜態(tài)內(nèi)容時(shí)零功耗非常適合這種需要長(zhǎng)時(shí)間顯示、但數(shù)據(jù)更新頻率不高比如每秒一次的場(chǎng)景。這不僅僅是一個(gè)“為做而做”的極客玩具。對(duì)于需要長(zhǎng)時(shí)間渲染、編譯代碼、跑模擬或挖礦的用戶一個(gè)不占用主屏幕、低干擾的硬件監(jiān)視器能讓你隨時(shí)掌握系統(tǒng)狀態(tài)避免過(guò)熱或資源耗盡。對(duì)于喜歡簡(jiǎn)潔桌面的用戶它能取代軟件懸浮窗讓桌面更清爽。更重要的是整個(gè)項(xiàng)目融合了嵌入式開(kāi)發(fā)、網(wǎng)絡(luò)通信、系統(tǒng)監(jiān)控和硬件驅(qū)動(dòng)等多個(gè)有趣的技術(shù)點(diǎn)是一次非常棒的全棧式學(xué)習(xí)實(shí)踐。2. 核心方案設(shè)計(jì)與技術(shù)選型2.1 為什么是ESP32 e-Paper選擇ESP32作為主控幾乎是這個(gè)項(xiàng)目的必然選擇。首先它內(nèi)置Wi-Fi和藍(lán)牙完美解決了與PC通信的問(wèn)題無(wú)需額外模塊。其次它的雙核處理器和充足的內(nèi)存通常4MB Flash520KB SRAM足以處理JSON數(shù)據(jù)解析和驅(qū)動(dòng)墨水屏這類任務(wù)。最后其龐大的社區(qū)和豐富的庫(kù)支持無(wú)論是Arduino框架還是ESP-IDF讓開(kāi)發(fā)門(mén)檻大大降低。而選擇電子墨水屏e-Paper則是出于顯示特性的考慮。與LCD或OLED屏需要持續(xù)刷新以維持顯示不同墨水屏利用帶電粒子在電場(chǎng)中移動(dòng)的原理一旦畫(huà)面刷新完成即使斷電圖像也能保持。這帶來(lái)了兩大核心優(yōu)勢(shì)超低功耗和類紙的視覺(jué)體驗(yàn)。對(duì)于這個(gè)監(jiān)控器項(xiàng)目我們可能每1-5秒才更新一次數(shù)據(jù)在99%的時(shí)間里ESP32和屏幕都可以處于深度睡眠或完全斷電狀態(tài)功耗極低。同時(shí)它沒(méi)有背光不刺眼適合長(zhǎng)時(shí)間擺在眼前。2.2 整體架構(gòu)與通信協(xié)議項(xiàng)目的架構(gòu)清晰分為兩端PC端數(shù)據(jù)采集與發(fā)送端一個(gè)常駐后臺(tái)的服務(wù)或腳本。它負(fù)責(zé)調(diào)用操作系統(tǒng)API獲取性能數(shù)據(jù)并將數(shù)據(jù)打包通過(guò)網(wǎng)絡(luò)發(fā)送給ESP32。ESP32端數(shù)據(jù)接收與顯示端硬件主體。它連接Wi-Fi監(jiān)聽(tīng)特定端口接收PC發(fā)來(lái)的數(shù)據(jù)包解析后驅(qū)動(dòng)墨水屏更新顯示。通信協(xié)議的選擇至關(guān)重要它需要兼顧簡(jiǎn)單、高效和可靠。這里有幾個(gè)主流選項(xiàng)HTTP (REST API)ESP32作為簡(jiǎn)易的HTTP服務(wù)器PC端通過(guò)POST請(qǐng)求發(fā)送JSON數(shù)據(jù)。優(yōu)點(diǎn)是通用、易于調(diào)試可以用Postman測(cè)試但開(kāi)銷相對(duì)較大需要處理HTTP頭。WebSocket建立全雙工通信通道適合需要PC主動(dòng)推送且ESP32可能反向控制的場(chǎng)景。但協(xié)議稍復(fù)雜對(duì)于單向數(shù)據(jù)流有點(diǎn)“殺雞用牛刀”。TCP/UDP 原始套接字最靈活高效的方式。可以自定義非常精簡(jiǎn)的數(shù)據(jù)包格式。UDP更快但不可靠TCP可靠但稍慢。對(duì)于局域網(wǎng)內(nèi)、短距離、高頻率如1秒一次的更新UDP是很好的選擇即使偶爾丟包下一次更新也會(huì)覆蓋。MQTT發(fā)布/訂閱模式。如果未來(lái)想擴(kuò)展為多個(gè)顯示屏監(jiān)控多個(gè)PC或者通過(guò)手機(jī)查看MQTT是優(yōu)雅的解決方案。ESP32訂閱一個(gè)主題PC向該主題發(fā)布消息。它需要額外的MQTT代理服務(wù)器如Mosquitto。對(duì)于初學(xué)者或追求快速實(shí)現(xiàn)HTTP JSON是最推薦的方式因?yàn)樗?jiǎn)單直觀調(diào)試方便。當(dāng)我們追求極致效率和低延遲時(shí)可以轉(zhuǎn)向自定義TCP/UDP協(xié)議。本項(xiàng)目后續(xù)的實(shí)操將以HTTP JSON為例進(jìn)行因?yàn)樗钅荏w現(xiàn)從原理到實(shí)現(xiàn)的完整鏈路理解后遷移到其他協(xié)議也很容易。注意在PC端程序的選擇上Python憑借其豐富的系統(tǒng)監(jiān)控庫(kù)如psutil和網(wǎng)絡(luò)庫(kù)成為快速原型開(kāi)發(fā)的首選。對(duì)于最終希望以系統(tǒng)服務(wù)形式運(yùn)行的用戶可以考慮用Go或C#將其編譯為原生可執(zhí)行文件。3. 硬件準(zhǔn)備與電路連接3.1 物料清單你需要準(zhǔn)備以下硬件ESP32開(kāi)發(fā)板任何一款通用的ESP32開(kāi)發(fā)板均可如ESP32-DevKitC、NodeMCU-32S等。確保其Wi-Fi功能正常。電子墨水屏e-Paper模塊推薦使用2.9英寸或4.2英寸的三色黑、白、紅墨水屏分辨率通常為296x128或400x300。品牌方面Waveshare微雪的產(chǎn)品資料最全配套庫(kù)也最完善。購(gòu)買時(shí)務(wù)必選擇帶SPI接口的“裸屏驅(qū)動(dòng)板”一體模塊。杜邦線若干用于連接。USB數(shù)據(jù)線用于給ESP32供電和燒錄程序?？蛇x外殼與支架3D打印一個(gè)外殼或者用樂(lè)高積木搭建一個(gè)支架讓成品更美觀。3.2 電路連接詳解墨水屏與ESP32通常通過(guò)SPI串行外設(shè)接口通信。SPI需要4根線SCK時(shí)鐘、MOSI主機(jī)輸出從機(jī)輸入、MISO主機(jī)輸入從機(jī)輸出、CS片選。此外墨水屏還需要額外的控制引腳DC數(shù)據(jù)/命令選擇、RST復(fù)位、BUSY忙狀態(tài)指示。以下是典型的連接方式以ESP32和微雪2.9英寸三色屏為例墨水屏引腳ESP32 GPIO引腳功能說(shuō)明VCC3.3V電源務(wù)必接3.3V接5V會(huì)燒屏GNDGND地線DINGPIO 23 (MOSI)SPI數(shù)據(jù)輸入主機(jī)輸出CLKGPIO 18 (SCK)SPI時(shí)鐘CSGPIO 5片選低電平有效DCGPIO 17數(shù)據(jù)/命令選擇高電平數(shù)據(jù)低電平命令RSTGPIO 16復(fù)位低電平復(fù)位BUSYGPIO 4忙狀態(tài)指示高電平空閑低電平忙實(shí)操心得1GPIO分配ESP32的許多GPIO有復(fù)用功能。上述分配是常見(jiàn)方案但并非唯一。如果與其他外設(shè)沖突你可以更改只需在代碼中相應(yīng)修改引腳定義即可。避開(kāi)一些特殊引腳如GPIO6-11通常用于內(nèi)部FlashGPIO34-39只能輸入不能輸出。實(shí)操心得2供電穩(wěn)定性ESP32和墨水屏在刷新瞬間電流可能較大。如果使用USB口供電請(qǐng)確保USB線質(zhì)量良好且電源電腦USB口或充電頭能提供足夠電流至少500mA。供電不穩(wěn)可能導(dǎo)致ESP32重啟或屏幕刷新異常。連接完成后硬件部分就準(zhǔn)備好了。建議先用廠家提供的示例程序測(cè)試一下屏幕是否能正常顯示排除硬件連接故障。4. PC端數(shù)據(jù)采集服務(wù)實(shí)現(xiàn)PC端是我們的“數(shù)據(jù)源頭”。我們將使用Python來(lái)編寫(xiě)這個(gè)服務(wù)因?yàn)樗缙脚_(tái)Windows/macOS/Linux并且有強(qiáng)大的psutil庫(kù)來(lái)獲取系統(tǒng)信息。4.1 環(huán)境搭建與依賴安裝首先確保你的電腦安裝了Python 3.6或更高版本。然后通過(guò)pip安裝必要的庫(kù)pip install psutil flaskpsutil跨平臺(tái)的系統(tǒng)信息和進(jìn)程工具庫(kù)是我們獲取所有性能數(shù)據(jù)的核心。flask一個(gè)輕量級(jí)的Web框架。我們將用它創(chuàng)建一個(gè)簡(jiǎn)單的HTTP服務(wù)器供ESP32查詢數(shù)據(jù)。4.2 核心數(shù)據(jù)采集函數(shù)編寫(xiě)創(chuàng)建一個(gè)名為pc_monitor_server.py的文件。我們先編寫(xiě)數(shù)據(jù)采集部分import psutil import json import time def get_system_stats(): 采集并返回系統(tǒng)性能數(shù)據(jù)的字典 stats {} # CPU相關(guān) stats[cpu_percent] psutil.cpu_percent(interval0.5) # 0.5秒內(nèi)的平均使用率 stats[cpu_freq] psutil.cpu_freq().current if psutil.cpu_freq() else 0 # 當(dāng)前頻率(MHz) stats[cpu_temp] _get_cpu_temperature() # 溫度獲取需要平臺(tái)特定代碼見(jiàn)下文 # 內(nèi)存相關(guān) mem psutil.virtual_memory() stats[mem_total] mem.total // (1024**2) # 轉(zhuǎn)換為MB stats[mem_used] mem.used // (1024**2) stats[mem_percent] mem.percent # 磁盤(pán)相關(guān)默認(rèn)取C盤(pán)或根分區(qū) disk psutil.disk_usage(/) if not psutil.WINDOWS else psutil.disk_usage(C:\\) stats[disk_total] disk.total // (1024**3) # 轉(zhuǎn)換為GB stats[disk_used] disk.used // (1024**3) stats[disk_percent] disk.percent # 網(wǎng)絡(luò)相關(guān)獲取當(dāng)前活動(dòng)的網(wǎng)卡計(jì)算收發(fā)速度 net_io psutil.net_io_counters() stats[net_sent] net_io.bytes_sent stats[net_recv] net_io.bytes_recv # 注意這里發(fā)送的是累計(jì)值速度需要在客戶端計(jì)算差值/時(shí)間 # GPU相關(guān)需要額外庫(kù)如pynvml for NVIDIA GPU stats[gpu_percent], stats[gpu_temp] _get_gpu_info() # 可選功能 stats[timestamp] int(time.time()) # 添加時(shí)間戳 return stats def _get_cpu_temperature(): 獲取CPU溫度平臺(tái)相關(guān) try: if psutil.LINUX: # Linux: 通常從/sys/class/thermal讀取 with open(/sys/class/thermal/thermal_zone0/temp, r) as f: temp int(f.read()) / 1000.0 return temp elif psutil.MACOS: # macOS: 使用osx-cpu-temp庫(kù)或調(diào)用istats命令需額外安裝 # 這里返回一個(gè)模擬值或0 return 0.0 elif psutil.WINDOWS: # Windows: 需要pyspectator或OpenHardwareMonitorWMI等復(fù)雜方式 # 為簡(jiǎn)化這里返回0建議使用第三方工具如HWiNFO的共享內(nèi)存接口 return 0.0 except: return 0.0 def _get_gpu_info(): 獲取GPU信息需要NVIDIA ML庫(kù) # 這是一個(gè)高級(jí)功能初期可以返回(0, 0) return 0, 04.3 創(chuàng)建HTTP API服務(wù)接下來(lái)使用Flask創(chuàng)建一個(gè)簡(jiǎn)單的Web服務(wù)器暴露一個(gè)API端點(diǎn)來(lái)返回JSON數(shù)據(jù)from flask import Flask, jsonify import threading app Flask(__name__) # 全局變量存儲(chǔ)上一次的網(wǎng)絡(luò)IO計(jì)數(shù)用于計(jì)算瞬時(shí)速度 last_net_io psutil.net_io_counters() last_time time.time() def calculate_network_speed(): 計(jì)算網(wǎng)絡(luò)上傳下載速度KB/s global last_net_io, last_time current_net_io psutil.net_io_counters() current_time time.time() time_diff current_time - last_time if time_diff 0: up_speed (current_net_io.bytes_sent - last_net_io.bytes_sent) / time_diff / 1024.0 down_speed (current_net_io.bytes_recv - last_net_io.bytes_recv) / time_diff / 1024.0 else: up_speed down_speed 0.0 last_net_io current_net_io last_time current_time return round(up_speed, 1), round(down_speed, 1) app.route(/api/stats, methods[GET]) def get_stats(): 主API端點(diǎn)返回所有系統(tǒng)狀態(tài) stats get_system_stats() up_speed, down_speed calculate_network_speed() stats[net_up_speed] up_speed stats[net_down_speed] down_speed return jsonify(stats) app.route(/health, methods[GET]) def health(): 健康檢查端點(diǎn) return jsonify({status: ok}) def run_server(): 在獨(dú)立線程中運(yùn)行Flask服務(wù)器 # 注意在生產(chǎn)環(huán)境中不要使用debugTrue并且最好綁定到局域網(wǎng)IP而非0.0.0.0 app.run(host0.0.0.0, port5000, debugFalse, threadedTrue) if __name__ __main__: print(PC性能監(jiān)控服務(wù)啟動(dòng)訪問(wèn) http://localhost:5000/api/stats) # 直接運(yùn)行主線程開(kāi)發(fā)用 app.run(host0.0.0.0, port5000, debugTrue)現(xiàn)在在PC上運(yùn)行這個(gè)腳本python pc_monitor_server.py然后在瀏覽器中訪問(wèn)http://localhost:5000/api/stats你應(yīng)該能看到返回的JSON格式系統(tǒng)性能數(shù)據(jù)。這就意味著數(shù)據(jù)源已經(jīng)準(zhǔn)備好了。注意事項(xiàng)默認(rèn)情況下Flask開(kāi)發(fā)服務(wù)器僅適用于本地開(kāi)發(fā)和測(cè)試。如果你希望從同一局域網(wǎng)內(nèi)的ESP32訪問(wèn)需要確保防火墻允許5000端口的入站連接并且如上代碼所示使用host0.0.0.0。對(duì)于長(zhǎng)期后臺(tái)運(yùn)行建議使用waitress或gunicorn等生產(chǎn)級(jí)WSGI服務(wù)器來(lái)替代Flask自帶的服務(wù)器并將其設(shè)置為系統(tǒng)服務(wù)如Windows服務(wù)或Linux的systemd服務(wù)。5. ESP32端固件開(kāi)發(fā)與顯示驅(qū)動(dòng)ESP32端是項(xiàng)目的“大腦”和“臉面”。我們將使用Arduino框架進(jìn)行開(kāi)發(fā)因?yàn)樗鼛?kù)管理方便對(duì)墨水屏支持好。5.1 Arduino開(kāi)發(fā)環(huán)境配置安裝Arduino IDE從Arduino官網(wǎng)下載并安裝。添加ESP32開(kāi)發(fā)板支持打開(kāi)Arduino IDE進(jìn)入文件 - 首選項(xiàng)在“附加開(kāi)發(fā)板管理器網(wǎng)址”中輸入https://espressif.github.io/arduino-esp32/package_esp32_index.json然后進(jìn)入工具 - 開(kāi)發(fā)板 - 開(kāi)發(fā)板管理器搜索“esp32”安裝“Espressif Systems”提供的ESP32開(kāi)發(fā)板包。安裝必要的庫(kù)WiFi庫(kù)通常已內(nèi)置。HTTPClient庫(kù)用于發(fā)起HTTP請(qǐng)求已內(nèi)置。ArduinoJson庫(kù)用于解析從PC端收到的JSON數(shù)據(jù)。在庫(kù)管理中搜索“ArduinoJson”并安裝建議安裝v6.x或更高版本。墨水屏驅(qū)動(dòng)庫(kù)根據(jù)你購(gòu)買的屏幕型號(hào)安裝。以微雪為例在庫(kù)管理中搜索“GxEPD2”或“e-Paper”安裝其提供的庫(kù)。或者從微雪官網(wǎng)下載其Arduino示例庫(kù)手動(dòng)安裝。5.2 固件主程序邏輯拆解創(chuàng)建一個(gè)新的Arduino項(xiàng)目我們將其邏輯分為幾個(gè)部分1. 網(wǎng)絡(luò)連接與配置首先你需要讓ESP32連接到你的家庭Wi-Fi。建議將SSID和密碼寫(xiě)在代碼里或者更優(yōu)雅地使用WiFiManager庫(kù)實(shí)現(xiàn)網(wǎng)頁(yè)配網(wǎng)。#include WiFi.h #include HTTPClient.h #include ArduinoJson.h // 你的Wi-Fi憑證 const char* ssid 你的Wi-Fi名稱; const char* password 你的Wi-Fi密碼; // PC端服務(wù)的地址和端口 const char* serverURL http://192.168.1.100:5000/api/stats; // 替換為你的PC局域網(wǎng)IP void connectToWiFi() { Serial.print(正在連接到Wi-Fi: ); Serial.println(ssid); WiFi.begin(ssid, password); int attempts 0; while (WiFi.status() ! WL_CONNECTED attempts 20) { delay(500); Serial.print(.); attempts; } if (WiFi.status() WL_CONNECTED) { Serial.println(\nWi-Fi連接成功); Serial.print(IP地址: ); Serial.println(WiFi.localIP()); } else { Serial.println(\nWi-Fi連接失敗請(qǐng)檢查配置。); // 這里可以添加進(jìn)入配網(wǎng)模式的邏輯 } }2. 數(shù)據(jù)獲取與解析連接Wi-Fi后ESP32需要定時(shí)向PC端的API發(fā)起HTTP GET請(qǐng)求并解析返回的JSON數(shù)據(jù)。// 定義存儲(chǔ)數(shù)據(jù)的結(jié)構(gòu)體 struct SystemStats { float cpuPercent; float cpuTemp; unsigned long memUsed; unsigned long memTotal; float memPercent; float diskPercent; float netUpSpeed; float netDownSpeed; // ... 其他字段 }; SystemStats currentStats; bool fetchSystemStats() { if (WiFi.status() ! WL_CONNECTED) { Serial.println(Wi-Fi未連接無(wú)法獲取數(shù)據(jù)); return false; } HTTPClient http; http.begin(serverURL); int httpCode http.GET(); if (httpCode HTTP_CODE_OK) { String payload http.getString(); // 開(kāi)始解析JSON DynamicJsonDocument doc(1024); // 根據(jù)JSON大小調(diào)整緩沖區(qū) DeserializationError error deserializeJson(doc, payload); if (error) { Serial.print(JSON解析失敗: ); Serial.println(error.c_str()); http.end(); return false; } // 提取數(shù)據(jù)到結(jié)構(gòu)體 currentStats.cpuPercent doc[cpu_percent]; currentStats.cpuTemp doc[cpu_temp]; currentStats.memUsed doc[mem_used]; currentStats.memTotal doc[mem_total]; currentStats.memPercent doc[mem_percent]; currentStats.diskPercent doc[disk_percent]; currentStats.netUpSpeed doc[net_up_speed]; currentStats.netDownSpeed doc[net_down_speed]; Serial.println(數(shù)據(jù)獲取并解析成功); http.end(); return true; } else { Serial.printf(HTTP請(qǐng)求失敗錯(cuò)誤碼: %d\n, httpCode); http.end(); return false; } }3. 墨水屏驅(qū)動(dòng)與顯示這是最有趣的部分。你需要根據(jù)具體的屏幕型號(hào)和庫(kù)來(lái)編寫(xiě)顯示代碼。以下是一個(gè)基于GxEPD2庫(kù)的通用示例框架#include GxEPD2_BW.h // 對(duì)于黑白屏 // #include GxEPD2_3C.h // 對(duì)于三色黑、白、紅屏 #include Fonts/FreeMonoBold9pt7b.h // 內(nèi)置字體 #include Fonts/FreeMonoBold12pt7b.h // 內(nèi)置字體 // 根據(jù)你的屏幕型號(hào)定義顯示對(duì)象例如對(duì)于2.9英寸黑白屏 // GxEPD2_BWGxEPD2_290, GxEPD2_290::HEIGHT display(GxEPD2_290(/*CS*/5, /*DC*/17, /*RST*/16, /*BUSY*/4)); // 對(duì)于2.9英寸三色屏 GxEPD2_3CGxEPD2_290c, GxEPD2_290c::HEIGHT display(GxEPD2_290c(/*CS*/5, /*DC*/17, /*RST*/16, /*BUSY*/4)); void setupDisplay() { display.init(115200); // 初始化屏幕 display.setRotation(1); // 設(shè)置旋轉(zhuǎn)方向0-3 display.setTextColor(GxEPD_BLACK); // 設(shè)置字體顏色 display.setFullWindow(); // 設(shè)置全窗口更新模式慢但無(wú)殘影 // display.setPartialWindow(0, 0, display.width(), display.height()); // 部分更新模式快可能有殘影 } void drawStatsOnDisplay(const SystemStats stats) { display.firstPage(); do { display.setFont(FreeMonoBold12pt7b); display.setCursor(10, 20); display.print(PC Monitor); display.setFont(FreeMonoBold9pt7b); display.setCursor(10, 50); display.printf(CPU: %.1f%%, stats.cpuPercent); display.setCursor(10, 70); display.printf(Temp: %.1fC, stats.cpuTemp); display.setCursor(10, 90); display.printf(Mem: %lu/%lu MB, stats.memUsed, stats.memTotal); display.setCursor(10, 110); display.printf(Disk: %.1f%%, stats.diskPercent); display.setCursor(10, 130); display.printf(Up: %.1f KB/s, stats.netUpSpeed); display.setCursor(10, 150); display.printf(Down: %.1f KB/s, stats.netDownSpeed); // 繪制進(jìn)度條或簡(jiǎn)單的圖形化表示 drawProgressBar(10, 170, 100, 10, stats.cpuPercent); // 繪制CPU進(jìn)度條 } while (display.nextPage()); // 更新完成后可以進(jìn)入深度睡眠以省電 // display.hibernate(); // 讓屏幕進(jìn)入休眠狀態(tài)功耗極低 } void drawProgressBar(int x, int y, int width, int height, float percent) { int fillWidth (percent / 100.0) * width; display.drawRect(x, y, width, height, GxEPD_BLACK); // 畫(huà)邊框 display.fillRect(x, y, fillWidth, height, GxEPD_BLACK); // 畫(huà)填充 }4. 主循環(huán)邏輯最后在setup()和loop()中串聯(lián)所有功能unsigned long lastUpdateTime 0; const unsigned long updateInterval 2000; // 更新間隔單位毫秒2秒 void setup() { Serial.begin(115200); delay(1000); // 給串口一點(diǎn)啟動(dòng)時(shí)間 setupDisplay(); // 首次顯示一個(gè)等待界面 display.setFullWindow(); display.firstPage(); do { display.setFont(FreeMonoBold12pt7b); display.setCursor(50, 80); display.print(Connecting...); } while (display.nextPage()); connectToWiFi(); } void loop() { unsigned long currentTime millis(); // 判斷是否到達(dá)更新間隔 if (currentTime - lastUpdateTime updateInterval) { lastUpdateTime currentTime; if (fetchSystemStats()) { // 獲取數(shù)據(jù)成功更新顯示 drawStatsOnDisplay(currentStats); Serial.println(顯示已更新); } else { // 獲取失敗顯示錯(cuò)誤或保持原畫(huà)面 Serial.println(更新失敗等待下次嘗試); // 可以在這里繪制一個(gè)錯(cuò)誤提示注意墨水屏刷新次數(shù)有限頻繁全刷會(huì)縮短壽命 } } // 短暫延遲避免loop()空轉(zhuǎn)消耗CPU delay(100); }將以上代碼整合并根據(jù)你的屏幕型號(hào)調(diào)整引腳定義和顯示庫(kù)對(duì)象編譯并上傳到ESP32。上電后它應(yīng)該會(huì)連接Wi-Fi然后開(kāi)始定期從你的PC獲取數(shù)據(jù)并顯示在墨水屏上。6. 優(yōu)化、調(diào)試與進(jìn)階玩法基礎(chǔ)功能實(shí)現(xiàn)后我們可以從多個(gè)維度進(jìn)行優(yōu)化和擴(kuò)展。6.1 功耗優(yōu)化策略墨水屏項(xiàng)目最大的優(yōu)勢(shì)就是低功耗但ESP32本身的功耗也不容忽視。深度睡眠Deep Sleep如果更新間隔較長(zhǎng)如30秒以上可以讓ESP32在每次更新顯示后進(jìn)入深度睡眠。設(shè)置一個(gè)定時(shí)器或使用外部RTC喚醒到時(shí)間后喚醒獲取數(shù)據(jù)刷新屏幕然后再次睡眠。這能將平均電流從幾十mA降到幾十μA級(jí)別。但需要注意深度睡眠下Wi-Fi連接會(huì)斷開(kāi)每次喚醒需要重新連接這會(huì)增加延遲和功耗。需要權(quán)衡連接耗時(shí)與睡眠省電。屏幕休眠調(diào)用display.hibernate()。這會(huì)讓屏幕驅(qū)動(dòng)芯片完全斷電僅保留圖像是墨水屏最省電的狀態(tài)。降低CPU頻率在Arduino中可以通過(guò)setCpuFrequencyMhz()函數(shù)降低ESP32的主頻如降到80MHz在滿足性能需求的同時(shí)降低功耗。6.2 通信協(xié)議優(yōu)化如前所述HTTPJSON方便但開(kāi)銷大。優(yōu)化方向改用UDP定義簡(jiǎn)單的二進(jìn)制數(shù)據(jù)包格式。例如將所有浮點(diǎn)數(shù)乘以10轉(zhuǎn)為整數(shù)避免浮點(diǎn)傳輸然后用固定的結(jié)構(gòu)體發(fā)送。PC端用Python的socket庫(kù)發(fā)送UDP包ESP32端用WiFiUDP接收。數(shù)據(jù)包大小可以從幾百字節(jié)壓縮到幾十字節(jié)。添加簡(jiǎn)單校驗(yàn)在數(shù)據(jù)包末尾添加一個(gè)校驗(yàn)和如所有字節(jié)相加取低8位ESP32收到后計(jì)算校驗(yàn)和比對(duì)防止錯(cuò)誤數(shù)據(jù)顯示。6.3 顯示效果與UI優(yōu)化局部刷新墨水屏全屏刷新display.setFullWindow()速度慢約2-3秒且會(huì)有明顯的全屏閃爍。部分型號(hào)支持局部刷新display.setPartialWindow()它只更新變化的部分區(qū)域速度更快幾百毫秒且無(wú)閃爍。但局部刷新多次后可能產(chǎn)生“殘影”需要定期進(jìn)行一次全刷來(lái)清除。合理的策略是前N次更新用局部刷新第N1次用全刷。自定義字體與圖形使用更美觀的字體如FreeSans系列或者將圖標(biāo)、Logo轉(zhuǎn)換為位圖數(shù)組顯示提升顏值。多頁(yè)面顯示如果屏幕足夠大可以設(shè)計(jì)多個(gè)“頁(yè)面”通過(guò)ESP32上的按鈕或通過(guò)PC發(fā)送指令來(lái)切換顯示不同的信息組合如第一頁(yè)顯示概覽第二頁(yè)顯示詳細(xì)圖表第三頁(yè)顯示網(wǎng)絡(luò)流量歷史。6.4 常見(jiàn)問(wèn)題與排查技巧屏幕不顯示或花屏檢查接線這是最常見(jiàn)的問(wèn)題。確保VCC接3.3VGND接地SPI線序正確特別是CS、DC、RST、BUSY這幾根控制線。檢查庫(kù)和型號(hào)確認(rèn)安裝的墨水屏庫(kù)與你的屏幕型號(hào)完全匹配。微雪不同尺寸、顏色的屏幕驅(qū)動(dòng)芯片可能不同。供電不足嘗試使用獨(dú)立的5V/2A電源適配器通過(guò)ESP32的Vin引腳供電或者換一根更粗的USB線。ESP32無(wú)法連接Wi-Fi檢查密碼和SSID確保代碼中的SSID和密碼正確注意大小寫(xiě)。檢查路由器設(shè)置有些路由器可能禁用了2.4GHz頻段或者設(shè)置了MAC地址過(guò)濾、隱藏了SSID。信號(hào)強(qiáng)度ESP32的Wi-Fi信號(hào)接收能力一般如果距離路由器太遠(yuǎn)或有太多墻體阻隔可能會(huì)連接不穩(wěn)定。可以打印WiFi.RSSI()查看信號(hào)強(qiáng)度。HTTP請(qǐng)求失敗錯(cuò)誤碼 -1, 4xx, 5xx-1連接失敗檢查PC端服務(wù)器是否運(yùn)行防火墻是否關(guān)閉ESP32代碼中的serverURLIP和端口是否正確。在PC命令行用ping [ESP32_IP]和curl http://localhost:5000/api/stats雙向測(cè)試網(wǎng)絡(luò)連通性。404API路徑錯(cuò)誤檢查PC端Flask的app.route定義。500PC端Python腳本出錯(cuò)查看Flask運(yùn)行終端的錯(cuò)誤信息。JSON解析失敗緩沖區(qū)大小DynamicJsonDocument doc(1024);這里的緩沖區(qū)大小可能不夠。如果PC端返回的數(shù)據(jù)很大需要增加這個(gè)值?？梢栽贏rduino串口打印出收到的payload查看其長(zhǎng)度和內(nèi)容。數(shù)據(jù)格式確保PC端返回的是嚴(yán)格合法的JSON?？梢允褂迷诰€JSON驗(yàn)證工具檢查。屏幕刷新太慢全刷 vs 局刷確認(rèn)是否使用了display.setFullWindow()。嘗試切換到局部刷新模式。網(wǎng)絡(luò)延遲如果從發(fā)送HTTP請(qǐng)求到收到響應(yīng)時(shí)間過(guò)長(zhǎng)也會(huì)拖慢整體更新周期。優(yōu)化網(wǎng)絡(luò)或改用UDP。復(fù)雜圖形繪制大量圖形或使用大字體會(huì)減慢渲染速度。簡(jiǎn)化UI。7. 項(xiàng)目擴(kuò)展與進(jìn)階思路這個(gè)項(xiàng)目是一個(gè)完美的起點(diǎn)你可以在此基礎(chǔ)上添加更多功能多PC監(jiān)控修改PC端服務(wù)使其能采集多臺(tái)電腦的數(shù)據(jù)通過(guò)局域網(wǎng)發(fā)現(xiàn)或手動(dòng)配置。ESP32端可以輪詢多個(gè)IP地址或者使用MQTT讓每臺(tái)PC發(fā)布到各自的主題ESP32訂閱所有主題。歷史數(shù)據(jù)與簡(jiǎn)單圖表ESP32內(nèi)存有限但可以存儲(chǔ)最近幾十次的數(shù)據(jù)并在屏幕上繪制簡(jiǎn)單的折線圖顯示CPU使用率的歷史趨勢(shì)。報(bào)警功能當(dāng)CPU溫度超過(guò)閾值或內(nèi)存占用超過(guò)95%時(shí)讓ESP32板載的LED閃爍或者在屏幕上用紅色顯示警告信息。無(wú)線配置使用藍(lán)牙或WiFiManager庫(kù)讓ESP32在首次啟動(dòng)時(shí)進(jìn)入配網(wǎng)模式通過(guò)手機(jī)網(wǎng)頁(yè)配置Wi-Fi和服務(wù)器地址無(wú)需修改代碼。集成到智能家居平臺(tái)將ESP32采集到的數(shù)據(jù)通過(guò)MQTT上報(bào)到Home Assistant或Node-RED這樣你就能在手機(jī)App或家庭控制面板上看到PC狀態(tài)甚至可以設(shè)置自動(dòng)化如PC溫度過(guò)高時(shí)自動(dòng)打開(kāi)房間風(fēng)扇。我個(gè)人在完成這個(gè)項(xiàng)目后把它放在了我的顯示器旁邊。它安靜、省電提供的信息一目了然。最大的成就感來(lái)自于打通了“軟件”和“硬件”的界限讓一個(gè)想法從代碼變成了桌面上一個(gè)實(shí)實(shí)在在、有用的小物件。如果你在復(fù)現(xiàn)過(guò)程中遇到了任何問(wèn)題最關(guān)鍵的是分段調(diào)試先用示例程序測(cè)試屏幕再單獨(dú)測(cè)試Wi-Fi連接然后測(cè)試HTTP獲取數(shù)據(jù)最后整合。耐心一點(diǎn)每個(gè)問(wèn)題都能在社區(qū)找到答案。祝你制作愉快