如果你最近刷短視頻一定見過那種十幾厘米高、會搖頭晃腦、能聽懂簡單指令的小機(jī)器人。它們看起來像是工業(yè)機(jī)器人的縮小版但背后真正驅(qū)動它們的核心往往不是昂貴的樹莓派加激光雷達(dá)而是一塊幾十塊錢的 ESP32 開發(fā)板。很多人第一反應(yīng)是ESP32 不是一塊 WiFi 藍(lán)牙單片機(jī)嗎它也能做 AI 機(jī)器人這正是這篇教程想解決的問題。我會從一個真實場景出發(fā)你想打造一臺屬于自己的桌面積木機(jī)器人它有電機(jī)能移動有超聲波能避障有屏幕能顯示表情還能通過手機(jī)或網(wǎng)頁控制甚至接入 ROS 2 做更復(fù)雜的導(dǎo)航。傳統(tǒng)方案可能需要樹莓派、Arduino、各種驅(qū)動板拼在一起而 ESP32 一塊芯片就能承擔(dān)主控、通信、傳感器采樣和電機(jī)控制。文章會講清楚三件事ESP32 憑什么能當(dāng)機(jī)器人主控、如何用 Arduino 或 Micro-ROS 完成底層開發(fā)、以及從硬件選型到代碼調(diào)試的完整落地流程。無論你是機(jī)甲愛好者、剛?cè)腴T嵌入式的大學(xué)生還是想給孩子的科技作品加點智能這篇教程都值得收藏。1. 這篇文章真正要解決的問題先聊聊痛點。很多新手做機(jī)器人開場就掉進(jìn)選型迷宮。想用樹莓派發(fā)現(xiàn)要等供電、等系統(tǒng)啟動、等攝像頭驅(qū)動一套下來成本五六百想用 STM32發(fā)現(xiàn) HAL 庫和寄存器文檔對新手不友好WiFi 還得外掛模塊最后聽人說 Arduino 簡單結(jié)果 Uno 只有 2KB 內(nèi)存連個攝像頭圖傳都跑不動更別提 AI 推理和 ROS 2 通信。ESP32 恰好卡在中間位置它既不像 STM32 那樣硬核也不像樹莓派那樣臃腫。更重要的是ESP32 原生集成 WiFi 和藍(lán)牙雙核 240MHz 主頻有 520KB SRAM外設(shè)接口覆蓋了機(jī)器人常用的大部分需求。配合 Arduino 框架十幾分鐘就能跑起第一個點燈程序配合 Micro-ROS又能直接和 ROS 2 生態(tài)打通做 SLAM 導(dǎo)航也不是不可能。這篇文章要解決的真正問題是如何不用昂貴的開發(fā)板只靠 ESP32 加上常見模塊就造出一臺能遠(yuǎn)程控制、能避障、能和用戶做基礎(chǔ)交互的 AI 機(jī)器人小伙伴。讀完你會掌握ESP32 在機(jī)器人項目中的架構(gòu)定位和選型建議。從零搭建 ESP32 Arduino 開發(fā)環(huán)境并燒錄的完整流程。使用 L298N 或 DRV8833 驅(qū)動直流電機(jī)、讀取超聲波傳感器數(shù)據(jù)的代碼寫法。如何用 Web 頁面和手機(jī)藍(lán)牙控制機(jī)器人并擴(kuò)展語音、屏幕等 AI 交互能力。如何用 Micro-ROS 把 ESP32 接入 ROS 2為后續(xù)做自主導(dǎo)航鋪路。2. ESP32 為什么適合做機(jī)器人主控2.1 它到底是什么ESP32 是樂鑫推出的一系列 WiFi 藍(lán)牙 SoC不是單純的單片機(jī)。它內(nèi)部集成了 Xtensa 雙核處理器、WiFi 802.11 b/g/n、藍(lán)牙 4.2/5.0以及大量 GPIO 外設(shè)。不同型號差異不小做機(jī)器人最常用的是 ESP32 DevKitC 這類經(jīng)典板或者 ESP32-S3 這種帶 AI 加速的型號。用一句話概括ESP32 是“一塊帶 WiFi 藍(lán)牙的單片機(jī)”它的地位介于傳統(tǒng) MCU 和 Linux 單板機(jī)之間。2.2 和常見開發(fā)板對比對比項ESP32 DevKitCSTM32F407 探索者Arduino Uno樹莓派 4B主頻240MHz 雙核168MHz 單核16MHz1.5GHz 四核WiFi 藍(lán)牙原生集成需外掛模塊需外掛模塊原生集成內(nèi)存520KB SRAM192KB SRAM2KB SRAM2GB-8GB開發(fā)難度低Arduino/Python高HAL/寄存器最低較高Linux實時性較好很好一般較差系統(tǒng)啟動時間毫秒級毫秒級毫秒級秒級做桌面 AI 機(jī)器人適配度高中低高但成本高從這個表能看出ESP32 的最大優(yōu)勢不是算力而是“集成度 實時性 成本”的平衡點。2.3 開發(fā)板和單片機(jī)的區(qū)別很多新手會問開發(fā)板和單片機(jī)到底什么區(qū)別單片機(jī)是芯片本身開發(fā)板是把單片機(jī)芯片、晶振、USB 轉(zhuǎn)串口、電源電路、引腳排針集成在一起的電路板。買一塊 ESP32 開發(fā)板相當(dāng)于拿到一個“最小可用的 ESP32 系統(tǒng)”插上 USB 線就能燒錄和調(diào)試。這也是為什么教程中我會刻意說“開發(fā)板”而不是“芯片”。對機(jī)器人項目來說開發(fā)板的意義在于不必自己設(shè)計復(fù)雜的外圍電路把時間花在邏輯和結(jié)構(gòu)上。2.4 結(jié)論適合哪種項目ESP32 適合做資源受限機(jī)器人。所謂資源受限是指這臺機(jī)器人不需要本地跑大模型或稠密建圖而是通過 WiFi 把圖像或傳感器數(shù)據(jù)傳到上位機(jī)處理或者只執(zhí)行簡單的避障、巡線、語音指令響應(yīng)。如果你要做的恰好是一臺“眼睛靠攝像頭、大腦靠云端或手機(jī)、身體靠電機(jī)、表情靠屏幕”的桌面機(jī)器人ESP32 就是性價比最高的選擇。3. 總體架構(gòu)與硬件選型3.1 系統(tǒng)架構(gòu)設(shè)計在動手之前先畫出機(jī)器人小伙伴的功能框圖。這一步很重要否則焊完線才發(fā)現(xiàn)引腳沖突會非常痛苦。桌面 AI 機(jī)器人小伙伴可以拆成下面幾層感知層超聲波測距模塊、溫濕度傳感器、可選攝像頭。決策層ESP32 主控負(fù)責(zé)傳感器采樣、控制邏輯、通信。執(zhí)行層直流電機(jī)驅(qū)動板、舵機(jī)云臺、OLED/LVGL 屏幕。交互層手機(jī)網(wǎng)頁控制、藍(lán)牙手柄、語音播報模塊或離線語音識別。通信層WiFi 連接路由器或手機(jī)熱點通過 HTTP/WebSocket 與手機(jī)通信。3.2 硬件清單下面的清單不追求高性能只追求容易買到、接線友好、資料多。# 核心主控 1. ESP32 DevKitC V4 開發(fā)板或 ESP32-S3 DevKitC-1 2. 面包板 若干杜邦線 # 運(yùn)動系統(tǒng) 3. 2 個 TT 直流減速電機(jī) 橡膠輪 4. 1 個 L298N 電機(jī)驅(qū)動板或 DRV8833 5. 5V 2A 移動電源或 2 節(jié) 18650 電池 降壓模塊 # 傳感器 6. HC-SR04 超聲波傳感器 7. DHT11 或 DHT22 溫濕度傳感器可選 # 交互外設(shè) 8. 0.96 寸 SSD1306 OLED 屏幕 9. 1 或 2 個 SG90 舵機(jī)做出頭部擺動效果 10. 按鍵、LED 若干3.3 引腳規(guī)劃建議ESP32 引腳并不像 Arduino Uno 那樣“隨便一個就能用”有幾個坑要提前知道GPIO 6-11 默認(rèn)連接閃存芯片不能當(dāng)普通 IO 用。GPIO 12 是 strapping 引腳上電時如果拉高會影響進(jìn)入下載模式。GPIO 34-39 是輸入專用引腳不能輸出 PWM 或數(shù)字輸出。電機(jī)驅(qū)動板最好和傳感器使用不同電源域避免電機(jī)啟動時拉低傳感器供電。一個穩(wěn)妥的引腳分配如下設(shè)備ESP32 引腳左電機(jī) IN1/IN2GPIO 26 / GPIO 27右電機(jī) IN3/IN4GPIO 14 / GPIO 12若擔(dān)心可換成 32/33超聲波 TRIGGPIO 16超聲波 ECHOGPIO 17OLED SDA / SCLGPIO 21 / GPIO 22舵機(jī)信號GPIO 15DHT11 數(shù)據(jù)GPIO 4這里特別提醒GPIO 12 上電電平和下載模式有關(guān)如果插上拉模塊導(dǎo)致無法燒錄請優(yōu)先換引腳。4. 開發(fā)環(huán)境搭建4.1 安裝 Arduino IDE在 Arduino 官網(wǎng)下載 IDE 2.x 版本安裝完成并打開。4.2 添加 ESP32 開發(fā)板支持打開“文件 → 首選項 → 附加開發(fā)板管理器網(wǎng)址”填入樂鑫官方地址https://espressif.github.io/arduino-esp32/package_esp32_index.json然后打開“工具 → 開發(fā)板 → 開發(fā)板管理器”搜索esp32 by Espressif Systems點擊安裝。安裝包較大首次安裝可能需要較長時間。如果出現(xiàn)網(wǎng)絡(luò)下載失敗優(yōu)先檢查網(wǎng)絡(luò)環(huán)境或使用國內(nèi)鏡像源。從實際使用經(jīng)驗看ESP32 Arduino 內(nèi)核版本迭代較快遇到編譯報錯時先確認(rèn)你安裝的是 2.x 還是 3.x 版本因為不同版本對analogWrite、LEDC等 API 的兼容有明顯差異。4.3 測試燒錄把 ESP32 開發(fā)板插入 USB選擇開發(fā)板型號為ESP32 Dev Module選擇對應(yīng)的 COM 口上傳一個最簡代碼// 文件路徑test_blink/test_blink.ino #define LED_BUILTIN_PIN 2 void setup() { pinMode(LED_BUILTIN_PIN, OUTPUT); Serial.begin(115200); } void loop() { digitalWrite(LED_BUILTIN_PIN, HIGH); delay(500); digitalWrite(LED_BUILTIN_PIN, LOW); delay(500); Serial.println(ESP32 alive); }如果板載 LED 以 1 秒周期閃爍并且串口輸出ESP32 alive說明環(huán)境已經(jīng)通了。5. 電機(jī)控制與運(yùn)動系統(tǒng)實現(xiàn)5.1 電機(jī)驅(qū)動板接線L298N 是經(jīng)典電機(jī)驅(qū)動模塊接線時要特別注意共地問題ESP32 5V或外部 5V → L298N 12V 輸入 L298N 5V 輸出 → ESP32 VIN可選取決于供電方案 L298N GND → ESP32 GND GPIO 26 → L298N IN1 GPIO 27 → L298N IN2 GPIO 14 → L298N IN3 GPIO 12 → L298N IN4 電機(jī) A 兩線 → L298N OUT1 / OUT2 電機(jī) B 兩線 → L298N OUT3 / OUT4必須強(qiáng)調(diào)電機(jī)驅(qū)動板的電源和 ESP32 的電源最好分開。如果強(qiáng)行用同一個 USB 5V 供電去驅(qū)動兩個大電流電機(jī)很容易出現(xiàn)開發(fā)板重啟、串口斷連、電機(jī)抖動等情況。新手最常見的錯誤是只插 USB 線然后接上電機(jī)驅(qū)動板期望它能帶動機(jī)器人結(jié)果屏幕直接黑掉。5.2 電機(jī)控制代碼下面這段代碼實現(xiàn)了前、后、左、右、停止五個動作。它通過 digitalWrite 控制電機(jī)方向并通過 delay 控制運(yùn)行時間。// 文件路徑motor_test/motor_test.ino int motorA1 26; int motorA2 27; int motorB1 14; int motorB2 12; void setup() { pinMode(motorA1, OUTPUT); pinMode(motorA2, OUTPUT); pinMode(motorB1, OUTPUT); pinMode(motorB2, OUTPUT); Serial.begin(115200); Serial.println(Motor test start); } void loop() { runForward(1000); runBackward(1000); turnLeft(800); turnRight(800); stopMotor(1000); } void runForward(int duration) { digitalWrite(motorA1, HIGH); digitalWrite(motorA2, LOW); digitalWrite(motorB1, HIGH); digitalWrite(motorB2, LOW); delay(duration); } void runBackward(int duration) { digitalWrite(motorA1, LOW); digitalWrite(motorA2, HIGH); digitalWrite(motorB1, LOW); digitalWrite(motorB2, HIGH); delay(duration); } void turnLeft(int duration) { digitalWrite(motorA1, LOW); digitalWrite(motorA2, HIGH); digitalWrite(motorB1, HIGH); digitalWrite(motorB2, LOW); delay(duration); } void turnRight(int duration) { digitalWrite(motorA1, HIGH); digitalWrite(motorA2, LOW); digitalWrite(motorB1, LOW); digitalWrite(motorB2, HIGH); delay(duration); } void stopMotor(int duration) { digitalWrite(motorA1, LOW); digitalWrite(motorA2, LOW); digitalWrite(motorB1, LOW); digitalWrite(motorB2, LOW); delay(duration); }代碼里的左轉(zhuǎn)右轉(zhuǎn)是“原地差速轉(zhuǎn)向”也就是讓兩個輪子朝相反方向轉(zhuǎn)動。真實小車如果安裝的是帶減速箱的 TT 電機(jī)轉(zhuǎn)向效果會比較明顯。5.3 如何驗證運(yùn)動是否正常燒錄后把機(jī)器人放在桌面按順序觀察前進(jìn) 1 秒、后退 1 秒、左轉(zhuǎn) 0.8 秒、右轉(zhuǎn) 0.8 秒、停止 1 秒。如果發(fā)現(xiàn)動作順序不對只需要調(diào)整 IN1/IN2 或者 IN3/IN4 的接線位置就能解決不用改代碼。如果電機(jī)完全沒有反應(yīng)優(yōu)先排查 L298N 上的電源指示燈是否亮起以及 ESP32 的 GND 是否和 L298N 的 GND 接在一起。共地問題幾乎占據(jù)電機(jī)控制故障的一半。6. 傳感器感知與自動避障6.1 超聲波測距原理HC-SR04 的工作原理很簡單向 TRIG 引腳發(fā)送一個 10 微秒以上的高電平脈沖模塊就會發(fā)射超聲波當(dāng)聲波碰到障礙物返回時ECHO 引腳輸出高電平。測出這段高電平的時間再乘以聲速 340m/s 并除以 2就是到障礙物的距離。它在代碼里的實現(xiàn)如下// 文件路徑ultrasonic_test/ultrasonic_test.ino #define TRIG_PIN 16 #define ECHO_PIN 17 void setup() { Serial.begin(115200); pinMode(TRIG_PIN, OUTPUT); pinMode(ECHO_PIN, INPUT); } void loop() { long duration; float distanceCm; digitalWrite(TRIG_PIN, LOW); delayMicroseconds(2); digitalWrite(TRIG_PIN, HIGH); delayMicroseconds(10); digitalWrite(TRIG_PIN, LOW); duration pulseIn(ECHO_PIN, HIGH); distanceCm duration * 0.034 / 2; Serial.print(Distance: ); Serial.println(distanceCm); delay(100); }如果串口顯示距離一直在跳排除環(huán)境噪聲后大概率是供電不穩(wěn)。HC-SR04 在 5V 供電下更穩(wěn)定但它的 ECHO 引腳會返回 5V 電平直接接 ESP32 的 GPIO 有電壓不匹配風(fēng)險穩(wěn)妥做法是加一個分壓電路或用 3.3V 供電的傳感器模塊。6.2 添加避障邏輯把測距和電機(jī)控制合在一起就能寫出最簡單的“碰不到墻”的機(jī)器人// 文件路徑auto_avoid/auto_avoid.ino #define TRIG_PIN 16 #define ECHO_PIN 17 #define MOTOR_A1 26 #define MOTOR_A2 27 #define MOTOR_B1 14 #define MOTOR_B2 12 #define SAFE_DISTANCE 20.0 void setup() { Serial.begin(115200); pinMode(TRIG_PIN, OUTPUT); pinMode(ECHO_PIN, INPUT); pinMode(MOTOR_A1, OUTPUT); pinMode(MOTOR_A2, OUTPUT); pinMode(MOTOR_B1, OUTPUT); pinMode(MOTOR_B2, OUTPUT); } void loop() { float dist readDistance(); Serial.print(Distance: ); Serial.println(dist); if (dist SAFE_DISTANCE) { stopMotor(); delay(200); turnLeft(); delay(500); } else { runForward(); } } float readDistance() { digitalWrite(TRIG_PIN, LOW); delayMicroseconds(2); digitalWrite(TRIG_PIN, HIGH); delayMicroseconds(10); digitalWrite(TRIG_PIN, LOW); long duration pulseIn(ECHO_PIN, HIGH); if (duration 0) return 999; return duration * 0.034 / 2; } void runForward() { digitalWrite(MOTOR_A1, HIGH); digitalWrite(MOTOR_A2, LOW); digitalWrite(MOTOR_B1, HIGH); digitalWrite(MOTOR_B2, LOW); } void turnLeft() { digitalWrite(MOTOR_A1, LOW); digitalWrite(MOTOR_A2, HIGH); digitalWrite(MOTOR_B1, HIGH); digitalWrite(MOTOR_B2, LOW); } void stopMotor() { digitalWrite(MOTOR_A1, LOW); digitalWrite(MOTOR_A2, LOW); digitalWrite(MOTOR_B1, LOW); digitalWrite(MOTOR_B2, LOW); }這段代碼已經(jīng)能讓你看到一個“會自己躲墻的小車”。如果你希望它更智能一點可以把turnLeft()改成隨機(jī)選擇左轉(zhuǎn)或右轉(zhuǎn)避免遇到墻角時卡死。7. 接入 WiFi 和網(wǎng)頁遠(yuǎn)程控制7.1 為什么 ESP32 天然適合做遠(yuǎn)程控制ESP32 自帶 WiFi 是它比多數(shù)單片機(jī)更順手的地方。你不需要額外購買 ESP8266 模塊也不用寫復(fù)雜的 AT 指令。直接在 Arduino 代碼里引入 WiFi.h就能搖身一變成為一個 Web 服務(wù)器。這里要澄清一個常見誤解很多人以為 ESP32 “開 WiFi 會占很多資源”其實在簡單的控制場景里ESP32 的實時響應(yīng)影響可以忽略。更需要注意的是你的網(wǎng)絡(luò)環(huán)境是否穩(wěn)定以及機(jī)器人是否處于路由器信號覆蓋范圍內(nèi)。7.2 最小 Web 控制服務(wù)器下面這個代碼實現(xiàn)了一個網(wǎng)頁控制臺手機(jī)連上同一個 WiFi 后打開瀏覽器訪問機(jī)器人 IP點擊方向按鈕即可控制電機(jī)。同時它還提供了網(wǎng)頁上的測距數(shù)據(jù)顯示。// 文件路徑web_control/web_control.ino #include WiFi.h const char* ssid YOUR_WIFI_SSID; const char* password YOUR_WIFI_PASSWORD; #define TRIG_PIN 16 #define ECHO_PIN 17 #define MOTOR_A1 26 #define MOTOR_A2 27 #define MOTOR_B1 14 #define MOTOR_B2 12 WiFiServer server(80); String html !DOCTYPE htmlhtmlhead meta charsetutf-8 meta nameviewport contentwidthdevice-width, initial-scale1 titleESP32 Robot Control/title style body { font-family: Arial; text-align: center; margin-top: 40px; } .btn { display: inline-block; width: 160px; height: 60px; margin: 10px; font-size: 24px; background: #2196F3; color: white; border: none; border-radius: 12px; } .btn:hover { background: #0b7dda; } /style/headbody h2ESP32 AI Robot/h2 a href/forwardbutton classbtn前進(jìn)/button/a br a href/leftbutton classbtn左轉(zhuǎn)/button/a a href/stopbutton classbtn停止/button/a a href/rightbutton classbtn右轉(zhuǎn)/button/a br a href/backwardbutton classbtn后退/button/a pbutton classbtn onclick\location.href/distance\測量距離/button/p /body/html; void setup() { Serial.begin(115200); pinMode(TRIG_PIN, OUTPUT); pinMode(ECHO_PIN, INPUT); pinMode(MOTOR_A1, OUTPUT); pinMode(MOTOR_A2, OUTPUT); pinMode(MOTOR_B1, OUTPUT); pinMode(MOTOR_B2, OUTPUT); WiFi.begin(ssid, password); while (WiFi.status() ! WL_CONNECTED) { delay(500); Serial.print(.); } Serial.println(); Serial.print(WiFi connected, IP: ); Serial.println(WiFi.localIP()); server.begin(); } void loop() { WiFiClient client server.available(); if (!client) return; String request client.readStringUntil(\r); Serial.println(request); if (request.indexOf(/forward) 0) runMotor(HIGH, LOW, HIGH, LOW); else if (request.indexOf(/backward) 0) runMotor(LOW, HIGH, LOW, HIGH); else if (request.indexOf(/left) 0) runMotor(LOW, HIGH, HIGH, LOW); else if (request.indexOf(/right) 0) runMotor(HIGH, LOW, LOW, HIGH); else if (request.indexOf(/stop) 0) runMotor(LOW, LOW, LOW, LOW); else if (request.indexOf(/distance) 0) { float dist readDistance(); client.println(HTTP/1.1 200 OK); client.println(Content-Type: text/plain); client.println(); client.println(Distance: String(dist) cm); client.stop(); delay(1); return; } client.println(HTTP/1.1 200 OK); client.println(Content-Type: text/html); client.println(Connection: close); client.println(); client.println(html); client.stop(); delay(1); } void runMotor(int a1, int a2, int b1, int b2) { digitalWrite(MOTOR_A1, a1); digitalWrite(MOTOR_A2, a2); digitalWrite(MOTOR_B1, b1); digitalWrite(MOTOR_B2, b2); } float readDistance() { digitalWrite(TRIG_PIN, LOW); delayMicroseconds(2); digitalWrite(TRIG_PIN, HIGH); delayMicroseconds(10); digitalWrite(TRIG_PIN, LOW); long duration pulseIn(ECHO_PIN, HIGH); if (duration 0) return 999; return duration * 0.034 / 2; }把YOUR_WIFI_SSID和YOUR_WIFI_PASSWORD替換成你自己的 WiFi 信息燒錄后查看串口打印的 IP 地址在手機(jī)瀏覽器輸入這個 IP就能看到控制界面。7.3 大型機(jī)器人或者多設(shè)備場景怎么處理如果你的項目是搜索熱詞里提到的“機(jī)器人導(dǎo)航”“ROS2 機(jī)器人開發(fā)”那就要面對“多設(shè)備協(xié)同”的問題。ESP32 不適合作為復(fù)雜導(dǎo)航的主節(jié)點但它非常適合作為下位機(jī)把車速和傳感器數(shù)據(jù)通過 WiFi/串口發(fā)給上位機(jī)。上位機(jī)可以是 PC、Jetson Nano也可以是另一塊更強(qiáng)大的開發(fā)板。這時候把 HTTP 換成更高效的 WebSocket 或 MQTT 是更好的選擇。HTTP 請求每次都要建連和斷連控制頻率高了會產(chǎn)生明顯的延遲MQTT 或 WebSocket 則能保持長連接控制指令延遲能降到幾十毫秒以內(nèi)。8. 用 OLED 和語音模塊做 AI 交互8.1 添加表情屏幕機(jī)器人要有“小伙伴”的感覺單單會跑是不夠的。給它加一塊 0.96 寸 OLED用 U8g2 或 Adafruit SSD1306 庫畫一雙眼睛就能實現(xiàn)簡單的情感化反饋。在 Arduino 庫管理器中搜索SSD1306并安裝 Adafruit SSD1306 和 Adafruit GFX然后看下面的示例// 文件路徑oled_face/oled_face.ino #include Wire.h #include Adafruit_GFX.h #include Adafruit_SSD1306.h #define SCREEN_WIDTH 128 #define SCREEN_HEIGHT 64 #define OLED_ADDR 0x3C Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, Wire, -1); void setup() { Wire.begin(21, 22); display.begin(SSD1306_SWITCHCAPVCC, OLED_ADDR); display.clearDisplay(); } void loop() { // 畫一對“眼睛” display.clearDisplay(); drawEyes(); delay(2000); // 顯示一個“開心”表情 display.clearDisplay(); drawHappyFace(); delay(2000); } void drawEyes() { display.fillCircle(40, 28, 8, SSD1306_WHITE); display.fillCircle(88, 28, 8, SSD1306_WHITE); display.display(); } void drawHappyFace() { display.drawCircle(64, 32, 20, SSD1306_WHITE); display.fillCircle(56, 28, 3, SSD1306_WHITE); display.fillCircle(72, 28, 3, SSD1306_WHITE); display.drawArc(56, 38, 16, 200, 340, SSD1306_WHITE); display.display(); }注意drawArc在 Adafruit GFX 的某些版本里不可用如果你編譯報錯可以換用display.drawLine手動畫一條弧線。畫表情不是重點重點是你開始通過外設(shè)表達(dá)機(jī)器人“狀態(tài)”這就是交互體驗的基礎(chǔ)。8.2 接入基礎(chǔ)語音交互ESP32 直接跑本地大模型不現(xiàn)實但可以接離線語音識別模組或者通過 WiFi 請求云端語音接口。這里給一個最簡單的思路使用 SU-03T 這類離線語音識別模塊通過串口把識別結(jié)果發(fā)給 ESP32ESP32 根據(jù)結(jié)果執(zhí)行動作。接線方式SU-03T TX → ESP32 GPIO 3 (RX0) SU-03T RX → ESP32 GPIO 1 (TX0) SU-03T GND → ESP32 GND SU-03T VCC → ESP32 5V根據(jù)模塊要求在 Arduino 里用Serial2接收串口數(shù)據(jù)識別到“前進(jìn)”“后退”“停止”等關(guān)鍵詞后執(zhí)行對應(yīng)電機(jī)動作。這種方式?jīng)]有網(wǎng)絡(luò)延遲也不依賴外部服務(wù)適合離線演示。真正做 AI 對話交互時你更可能采用“ESP32 手機(jī) App 云端 API”的架構(gòu)ESP32 通過藍(lán)牙或 WiFi 把語音上傳到手機(jī)手機(jī)調(diào)用大模型接口再把返回的文本通過 TTS 播放出來。ESP32 在這里充當(dāng)?shù)氖菣C(jī)器人底層執(zhí)行器和語音前端。8.3 LVGL 屏幕界面如果你使用的是帶屏幕的 ESP32 開發(fā)板比如 ESP32-S3 配 ST7789 屏幕可以在板上運(yùn)行 LVGL。LVGL 是一個開源嵌入式圖形庫能設(shè)計按鈕、動畫、儀表盤。搜索熱詞里出現(xiàn)的esp32 lvgl是很多開發(fā)者在做智能面板項目時的主要方向。用 LVGL 做機(jī)器人控制界面的好處是它不需要依賴瀏覽器直接在機(jī)器人本地面板上顯示控制按鈕和狀態(tài)。缺點是開發(fā)量比 OLED 表情大不少適合作為進(jìn)階挑戰(zhàn)。9. 進(jìn)階用 Micro-ROS 把 ESP32 接入 ROS 29.1 Micro-ROS 是什么如果你看到過esp32 micro-ros arduino這組關(guān)鍵詞說明你可能已經(jīng)開始接觸機(jī)器人操作系統(tǒng) ROS 2。ROS 2 是機(jī)器人領(lǐng)域的主流軟件框架但它默認(rèn)運(yùn)行在 Linux 系統(tǒng)上對單片機(jī)并不友好。Micro-ROS 的作用就是讓內(nèi)存受限的 MCU 也能成為 ROS 2 網(wǎng)絡(luò)里的一個節(jié)點。用大白話說ROS 2 是一套機(jī)器人的“操作系統(tǒng)級通信框架”Micro-ROS 是它的瘦身版ESP32 通過 WiFi 或串口就能和跑著 ROS 2 的上位機(jī)通信。9.2 ESP32 在 ROS 2 里的定位在真實機(jī)器人項目中ESP32 最適合做執(zhí)行器節(jié)點和傳感器節(jié)點比如發(fā)布超聲波測距話題。發(fā)布 IMU 數(shù)據(jù)話題。訂閱/cmd_vel話題把速度指令轉(zhuǎn)成電機(jī) PWM。這樣上位機(jī)只需要負(fù)責(zé) SLAM 建圖、路徑規(guī)劃、AI 視覺而 ESP32 負(fù)責(zé)實時響應(yīng)和底層控制。9.3 接入 Micro-ROS 的大致流程第一步在 Arduino IDE 中安裝micro_ros_arduino庫?？梢酝ㄟ^ Library Manager 搜索micro_ros_arduino或從 GitHub 克隆到 Arduino/libraries 目錄。第二步根據(jù)網(wǎng)絡(luò)方式選擇傳輸層。WiFi 場景下需要先連接到熱點然后運(yùn)行 Micro-ROS Agent。串口場景下則用 USB 轉(zhuǎn) TTL 連接上位機(jī)。第三步用MicroRosPublisher發(fā)布話題。下面是一個最小示例結(jié)構(gòu)// 文件路徑micro_ros_demo/micro_ros_demo.ino示意 #include micro_ros_arduino.h #include stdio.h #include rcl/rcl.h #include rcl/error_handling.h #include std_msgs/msg/int32.h rcl_publisher_t publisher; rcl_publisher_t publisher; std_msgs__msg__Int32 msg; void setup() { set_microros_wifi_transports(YOUR_WIFI_SSID, YOUR_WIFI_PASSWORD, 192.168.1.100, 8888); // 其余初始化代碼略 } void loop() { msg.data analogRead(34); rcl_publish(publisher, msg, NULL); delay(100); }注意這段代碼只是示意完整運(yùn)行還需要在setup里創(chuàng)建節(jié)點、初始化 publisher并且處理rclc_executor的 spin。不同版本的 micro_ros_arduino 庫 API 有差異編譯報錯時先從官方例程micro_ros_arduino_publisher開始修改。9.4 ROS 2 上位機(jī)配置在上位機(jī)上啟動 Micro-ROS Agentsource /opt/ros/humble/setup.bash ros2 run micro_ros_agent micro_ros_agent serial --dev /dev/ttyUSB0或者使用 WiFi 傳輸ros2 run micro_ros_agent micro_ros_agent udp4 --port 8888啟動后在另一個終端執(zhí)行ros2 topic list如果能看到 ESP32 發(fā)布的話題名說明兩者已經(jīng)打通。這一步對于后續(xù)做“機(jī)器人導(dǎo)航”至關(guān)重要因為你可以讓機(jī)器人跑在 ROS 2 的導(dǎo)航棧里。10. 常見問題與排查方法問題現(xiàn)象可能原因排查方式解決方案燒錄失敗串口無法連接板子進(jìn)入不了下載模式按住 BOOT 鍵再點燒錄手動進(jìn)入下載模式或換 USB 數(shù)據(jù)線燒錄時報錯A fatal error occurred驅(qū)動未裝 / 端口錯 / 線材問題檢查設(shè)備管理器確認(rèn) COM 口安裝 CP210x 或 CH340 驅(qū)動電機(jī)不轉(zhuǎn)L298N 供電不足或未共地檢查電源指示燈、GND 連線外部供電接好共地電機(jī)轉(zhuǎn)向反了電機(jī)線接反或代碼方向不對觀察電機(jī)轉(zhuǎn)向調(diào)換 OUT 接線或改代碼超聲波距離數(shù)據(jù)亂跳供電不穩(wěn) / ECHO 電平不匹配萬用表測電壓串口打印通電后數(shù)據(jù)獨立供電或加分壓電路OLED 無顯示I2C 地址不對或 SDA/SCL 接反運(yùn)行 I2C 掃描程序嘗試 0x3C 和 0x3D 地址Web 控制頁打不開WiFi 名密碼錯誤 / 不在同一網(wǎng)段串口打印 IP手機(jī) ping 該 IP重新配網(wǎng)確保手機(jī)和開發(fā)板同一路由器Micro-ROS 連接失敗Agent 未啟動 / 端口被占用查看 Agent 日志關(guān)閉防火墻或換端口外接電源后 ESP32 重啟電機(jī)電流過大導(dǎo)致電壓跌落測電機(jī)啟動時電壓電機(jī)驅(qū)動單獨供電或加電容除了這些還有一個容易忽略的問題GPIO 引腳沖突。很多 ESP32 開發(fā)板把 LED 接在 GPIO 2 上如果你把電機(jī)引腳也用到 GPIO 2跑起來可能看到 LED 異常閃爍。建議在項目一開始就維護(hù)一張引腳分配表寫完代碼后逐項核對。11. 最佳實踐與工程建議11.1 先分模塊再拼接我見過太多把代碼一口氣寫完最后燒錄全部失敗的人。正確做法是先點亮 LED確認(rèn)環(huán)境可用。再跑電機(jī)測試確認(rèn)方向和 PWM 正常。再測傳感器確認(rèn)距離值準(zhǔn)確。再連 OLED確認(rèn)顯示正常。最后把模塊拼到一起加 WiFi 控制。每拼一個模塊就驗證一次能大幅降低排錯成本。11.2 供電設(shè)計是機(jī)器人的生命線桌面機(jī)器人的故障一半以上來自供電。建議電機(jī)驅(qū)動板和主控分開供電或者使用大電流降壓模塊。電機(jī)啟動時瞬間電流可能達(dá)到 1-2A電壓會明顯跌落。如果使用 18650 電池加一個 5V/3A 降壓模塊。萬用表測量各模塊實際電壓而不是只看理論值。11.3 代碼組織和版本管理即使是一個人做項目也建議用 Git 管理代碼?？梢园衙總€功能寫成單獨的.h文件或tab文件例如motor.h、ultrasonic.h、wifi_control.h最后在.ino文件里組合調(diào)用。這樣后續(xù)擴(kuò)展麥克風(fēng)、攝像頭、屏幕時不需要重寫底層邏輯。11.4 日志與調(diào)試習(xí)慣在關(guān)鍵位置添加Serial.println打印狀態(tài)遠(yuǎn)比斷點調(diào)試方便。尤其是 WiFi 連接、傳感器讀取、電機(jī)動作切換這幾個節(jié)點合理的日志輸出能讓你在 5 分鐘內(nèi)定位問題。上生產(chǎn)環(huán)境或長時間運(yùn)行時可以把日志合并成一個狀態(tài)字符串通過 WebSocket 發(fā)給控制端顯示這樣就能實時看到機(jī)器人“心路歷程”。11.5 安全邊界與合法使用提醒如果項目涉及攝像頭、語音采集、云端 API提醒自己遵守設(shè)備所屬地區(qū)和所在機(jī)構(gòu)的隱私與安全規(guī)定。不要采集未經(jīng)授權(quán)的個人信息不要繞過任何平臺的安全機(jī)制。代碼中默認(rèn)只處理授權(quán)范圍內(nèi)的受控設(shè)備。12. 總結(jié)與后續(xù)學(xué)習(xí)方向到這里你已經(jīng)把一顆可能還在吃灰的 ESP32 開發(fā)板變成了一臺能跑、能躲墻、能被手機(jī)控制、能顯示表情的基礎(chǔ)機(jī)器人小伙伴?；仡櫼幌逻@篇文章真正有用的是三塊內(nèi)容一是 ESP32 在機(jī)器人架構(gòu)中的定位它適合做主控而非復(fù)雜計算節(jié)點二是從電機(jī)、傳感器到 WiFi 控制的完整代碼鏈路這些代碼可以組合出非常多的玩法三是 Micro-ROS 的接入思路讓你以后從“玩具”走向“真機(jī)器人”時有明確路徑。下一步建議你按這個順序繼續(xù)深入先跑通本文的 Web 控制頁讓機(jī)器人在手機(jī)控制下自由移動。給機(jī)器人添加一個舵機(jī)云臺掛上攝像頭做簡單的 WiFi 圖傳。接入 Micro-ROS 和上位機(jī)用 ROS 2 的 Nav2 做 SLAM 導(dǎo)航。如果對屏幕交互感興趣學(xué)習(xí) LVGL在機(jī)器人上做一個完整的控制面板。如果對 AI 交互感興趣嘗試把離線語音識別模塊和云端大模型接進(jìn)來。說到底機(jī)器人開發(fā)的樂趣不在于一步到位而在于每次“換一個新模塊跑通一個新功能”的成就感?，F(xiàn)在就從你最感興趣的模塊開始動手吧你的第一個 AI 機(jī)器人小伙伴已經(jīng)在桌面上等你了。