如果你最近刷短視頻一定見過那種十幾厘米高、會搖頭晃腦、能聽懂簡單指令的小機器人。它們看起來像是工業(yè)機器人的縮小版但背后真正驅(qū)動它們的核心往往不是昂貴的樹莓派加激光雷達而是一塊幾十塊錢的 ESP32 開發(fā)板。很多人第一反應是ESP32 不是一塊 WiFi 藍牙單片機嗎它也能做 AI 機器人這正是這篇教程想解決的問題。我會從一個真實場景出發(fā)你想打造一臺屬于自己的桌面積木機器人它有電機能移動有超聲波能避障有屏幕能顯示表情還能通過手機或網(wǎng)頁控制甚至接入 ROS 2 做更復雜的導航。傳統(tǒng)方案可能需要樹莓派、Arduino、各種驅(qū)動板拼在一起而 ESP32 一塊芯片就能承擔主控、通信、傳感器采樣和電機控制。文章會講清楚三件事ESP32 憑什么能當機器人主控、如何用 Arduino 或 Micro-ROS 完成底層開發(fā)、以及從硬件選型到代碼調(diào)試的完整落地流程。無論你是機甲愛好者、剛?cè)腴T嵌入式的大學生還是想給孩子的科技作品加點智能這篇教程都值得收藏。1. 這篇文章真正要解決的問題先聊聊痛點。很多新手做機器人開場就掉進選型迷宮。想用樹莓派發(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 和藍牙雙核 240MHz 主頻有 520KB SRAM外設接口覆蓋了機器人常用的大部分需求。配合 Arduino 框架十幾分鐘就能跑起第一個點燈程序配合 Micro-ROS又能直接和 ROS 2 生態(tài)打通做 SLAM 導航也不是不可能。這篇文章要解決的真正問題是如何不用昂貴的開發(fā)板只靠 ESP32 加上常見模塊就造出一臺能遠程控制、能避障、能和用戶做基礎交互的 AI 機器人小伙伴。讀完你會掌握ESP32 在機器人項目中的架構(gòu)定位和選型建議。從零搭建 ESP32 Arduino 開發(fā)環(huán)境并燒錄的完整流程。使用 L298N 或 DRV8833 驅(qū)動直流電機、讀取超聲波傳感器數(shù)據(jù)的代碼寫法。如何用 Web 頁面和手機藍牙控制機器人并擴展語音、屏幕等 AI 交互能力。如何用 Micro-ROS 把 ESP32 接入 ROS 2為后續(xù)做自主導航鋪路。2. ESP32 為什么適合做機器人主控2.1 它到底是什么ESP32 是樂鑫推出的一系列 WiFi 藍牙 SoC不是單純的單片機。它內(nèi)部集成了 Xtensa 雙核處理器、WiFi 802.11 b/g/n、藍牙 4.2/5.0以及大量 GPIO 外設。不同型號差異不小做機器人最常用的是 ESP32 DevKitC 這類經(jīng)典板或者 ESP32-S3 這種帶 AI 加速的型號。用一句話概括ESP32 是“一塊帶 WiFi 藍牙的單片機”它的地位介于傳統(tǒng) MCU 和 Linux 單板機之間。2.2 和常見開發(fā)板對比對比項ESP32 DevKitCSTM32F407 探索者Arduino Uno樹莓派 4B主頻240MHz 雙核168MHz 單核16MHz1.5GHz 四核WiFi 藍牙原生集成需外掛模塊需外掛模塊原生集成內(nèi)存520KB SRAM192KB SRAM2KB SRAM2GB-8GB開發(fā)難度低Arduino/Python高HAL/寄存器最低較高Linux實時性較好很好一般較差系統(tǒng)啟動時間毫秒級毫秒級毫秒級秒級做桌面 AI 機器人適配度高中低高但成本高從這個表能看出ESP32 的最大優(yōu)勢不是算力而是“集成度 實時性 成本”的平衡點。2.3 開發(fā)板和單片機的區(qū)別很多新手會問開發(fā)板和單片機到底什么區(qū)別單片機是芯片本身開發(fā)板是把單片機芯片、晶振、USB 轉(zhuǎn)串口、電源電路、引腳排針集成在一起的電路板。買一塊 ESP32 開發(fā)板相當于拿到一個“最小可用的 ESP32 系統(tǒng)”插上 USB 線就能燒錄和調(diào)試。這也是為什么教程中我會刻意說“開發(fā)板”而不是“芯片”。對機器人項目來說開發(fā)板的意義在于不必自己設計復雜的外圍電路把時間花在邏輯和結(jié)構(gòu)上。2.4 結(jié)論適合哪種項目ESP32 適合做資源受限機器人。所謂資源受限是指這臺機器人不需要本地跑大模型或稠密建圖而是通過 WiFi 把圖像或傳感器數(shù)據(jù)傳到上位機處理或者只執(zhí)行簡單的避障、巡線、語音指令響應。如果你要做的恰好是一臺“眼睛靠攝像頭、大腦靠云端或手機、身體靠電機、表情靠屏幕”的桌面機器人ESP32 就是性價比最高的選擇。3. 總體架構(gòu)與硬件選型3.1 系統(tǒng)架構(gòu)設計在動手之前先畫出機器人小伙伴的功能框圖。這一步很重要否則焊完線才發(fā)現(xiàn)引腳沖突會非常痛苦。桌面 AI 機器人小伙伴可以拆成下面幾層感知層超聲波測距模塊、溫濕度傳感器、可選攝像頭。決策層ESP32 主控負責傳感器采樣、控制邏輯、通信。執(zhí)行層直流電機驅(qū)動板、舵機云臺、OLED/LVGL 屏幕。交互層手機網(wǎng)頁控制、藍牙手柄、語音播報模塊或離線語音識別。通信層WiFi 連接路由器或手機熱點通過 HTTP/WebSocket 與手機通信。3.2 硬件清單下面的清單不追求高性能只追求容易買到、接線友好、資料多。# 核心主控 1. ESP32 DevKitC V4 開發(fā)板或 ESP32-S3 DevKitC-1 2. 面包板 若干杜邦線 # 運動系統(tǒng) 3. 2 個 TT 直流減速電機 橡膠輪 4. 1 個 L298N 電機驅(qū)動板或 DRV8833 5. 5V 2A 移動電源或 2 節(jié) 18650 電池 降壓模塊 # 傳感器 6. HC-SR04 超聲波傳感器 7. DHT11 或 DHT22 溫濕度傳感器可選 # 交互外設 8. 0.96 寸 SSD1306 OLED 屏幕 9. 1 或 2 個 SG90 舵機做出頭部擺動效果 10. 按鍵、LED 若干3.3 引腳規(guī)劃建議ESP32 引腳并不像 Arduino Uno 那樣“隨便一個就能用”有幾個坑要提前知道GPIO 6-11 默認連接閃存芯片不能當普通 IO 用。GPIO 12 是 strapping 引腳上電時如果拉高會影響進入下載模式。GPIO 34-39 是輸入專用引腳不能輸出 PWM 或數(shù)字輸出。電機驅(qū)動板最好和傳感器使用不同電源域避免電機啟動時拉低傳感器供電。一個穩(wěn)妥的引腳分配如下設備ESP32 引腳左電機 IN1/IN2GPIO 26 / GPIO 27右電機 IN3/IN4GPIO 14 / GPIO 12若擔心可換成 32/33超聲波 TRIGGPIO 16超聲波 ECHOGPIO 17OLED SDA / SCLGPIO 21 / GPIO 22舵機信號GPIO 15DHT11 數(shù)據(jù)GPIO 4這里特別提醒GPIO 12 上電電平和下載模式有關如果插上拉模塊導致無法燒錄請優(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)絡下載失敗優(yōu)先檢查網(wǎng)絡環(huán)境或使用國內(nèi)鏡像源。從實際使用經(jīng)驗看ESP32 Arduino 內(nèi)核版本迭代較快遇到編譯報錯時先確認你安裝的是 2.x 還是 3.x 版本因為不同版本對analogWrite、LEDC等 API 的兼容有明顯差異。4.3 測試燒錄把 ESP32 開發(fā)板插入 USB選擇開發(fā)板型號為ESP32 Dev Module選擇對應的 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. 電機控制與運動系統(tǒng)實現(xiàn)5.1 電機驅(qū)動板接線L298N 是經(jīng)典電機驅(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 電機 A 兩線 → L298N OUT1 / OUT2 電機 B 兩線 → L298N OUT3 / OUT4必須強調(diào)電機驅(qū)動板的電源和 ESP32 的電源最好分開。如果強行用同一個 USB 5V 供電去驅(qū)動兩個大電流電機很容易出現(xiàn)開發(fā)板重啟、串口斷連、電機抖動等情況。新手最常見的錯誤是只插 USB 線然后接上電機驅(qū)動板期望它能帶動機器人結(jié)果屏幕直接黑掉。5.2 電機控制代碼下面這段代碼實現(xiàn)了前、后、左、右、停止五個動作。它通過 digitalWrite 控制電機方向并通過 delay 控制運行時間。// 文件路徑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 電機轉(zhuǎn)向效果會比較明顯。5.3 如何驗證運動是否正常燒錄后把機器人放在桌面按順序觀察前進 1 秒、后退 1 秒、左轉(zhuǎn) 0.8 秒、右轉(zhuǎn) 0.8 秒、停止 1 秒。如果發(fā)現(xiàn)動作順序不對只需要調(diào)整 IN1/IN2 或者 IN3/IN4 的接線位置就能解決不用改代碼。如果電機完全沒有反應優(yōu)先排查 L298N 上的電源指示燈是否亮起以及 ESP32 的 GND 是否和 L298N 的 GND 接在一起。共地問題幾乎占據(jù)電機控制故障的一半。6. 傳感器感知與自動避障6.1 超聲波測距原理HC-SR04 的工作原理很簡單向 TRIG 引腳發(fā)送一個 10 微秒以上的高電平脈沖模塊就會發(fā)射超聲波當聲波碰到障礙物返回時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 有電壓不匹配風險穩(wěn)妥做法是加一個分壓電路或用 3.3V 供電的傳感器模塊。6.2 添加避障邏輯把測距和電機控制合在一起就能寫出最簡單的“碰不到墻”的機器人// 文件路徑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()改成隨機選擇左轉(zhuǎn)或右轉(zhuǎn)避免遇到墻角時卡死。7. 接入 WiFi 和網(wǎng)頁遠程控制7.1 為什么 ESP32 天然適合做遠程控制ESP32 自帶 WiFi 是它比多數(shù)單片機更順手的地方。你不需要額外購買 ESP8266 模塊也不用寫復雜的 AT 指令。直接在 Arduino 代碼里引入 WiFi.h就能搖身一變成為一個 Web 服務器。這里要澄清一個常見誤解很多人以為 ESP32 “開 WiFi 會占很多資源”其實在簡單的控制場景里ESP32 的實時響應影響可以忽略。更需要注意的是你的網(wǎng)絡環(huán)境是否穩(wěn)定以及機器人是否處于路由器信號覆蓋范圍內(nèi)。7.2 最小 Web 控制服務器下面這個代碼實現(xiàn)了一個網(wǎng)頁控制臺手機連上同一個 WiFi 后打開瀏覽器訪問機器人 IP點擊方向按鈕即可控制電機。同時它還提供了網(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前進/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 地址在手機瀏覽器輸入這個 IP就能看到控制界面。7.3 大型機器人或者多設備場景怎么處理如果你的項目是搜索熱詞里提到的“機器人導航”“ROS2 機器人開發(fā)”那就要面對“多設備協(xié)同”的問題。ESP32 不適合作為復雜導航的主節(jié)點但它非常適合作為下位機把車速和傳感器數(shù)據(jù)通過 WiFi/串口發(fā)給上位機。上位機可以是 PC、Jetson Nano也可以是另一塊更強大的開發(fā)板。這時候把 HTTP 換成更高效的 WebSocket 或 MQTT 是更好的選擇。HTTP 請求每次都要建連和斷連控制頻率高了會產(chǎn)生明顯的延遲MQTT 或 WebSocket 則能保持長連接控制指令延遲能降到幾十毫秒以內(nèi)。8. 用 OLED 和語音模塊做 AI 交互8.1 添加表情屏幕機器人要有“小伙伴”的感覺單單會跑是不夠的。給它加一塊 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手動畫一條弧線。畫表情不是重點重點是你開始通過外設表達機器人“狀態(tài)”這就是交互體驗的基礎。8.2 接入基礎語音交互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ù)識別到“前進”“后退”“停止”等關鍵詞后執(zhí)行對應電機動作。這種方式?jīng)]有網(wǎng)絡延遲也不依賴外部服務適合離線演示。真正做 AI 對話交互時你更可能采用“ESP32 手機 App 云端 API”的架構(gòu)ESP32 通過藍牙或 WiFi 把語音上傳到手機手機調(diào)用大模型接口再把返回的文本通過 TTS 播放出來。ESP32 在這里充當?shù)氖菣C器人底層執(zhí)行器和語音前端。8.3 LVGL 屏幕界面如果你使用的是帶屏幕的 ESP32 開發(fā)板比如 ESP32-S3 配 ST7789 屏幕可以在板上運行 LVGL。LVGL 是一個開源嵌入式圖形庫能設計按鈕、動畫、儀表盤。搜索熱詞里出現(xiàn)的esp32 lvgl是很多開發(fā)者在做智能面板項目時的主要方向。用 LVGL 做機器人控制界面的好處是它不需要依賴瀏覽器直接在機器人本地面板上顯示控制按鈕和狀態(tài)。缺點是開發(fā)量比 OLED 表情大不少適合作為進階挑戰(zhàn)。9. 進階用 Micro-ROS 把 ESP32 接入 ROS 29.1 Micro-ROS 是什么如果你看到過esp32 micro-ros arduino這組關鍵詞說明你可能已經(jīng)開始接觸機器人操作系統(tǒng) ROS 2。ROS 2 是機器人領域的主流軟件框架但它默認運行在 Linux 系統(tǒng)上對單片機并不友好。Micro-ROS 的作用就是讓內(nèi)存受限的 MCU 也能成為 ROS 2 網(wǎng)絡里的一個節(jié)點。用大白話說ROS 2 是一套機器人的“操作系統(tǒng)級通信框架”Micro-ROS 是它的瘦身版ESP32 通過 WiFi 或串口就能和跑著 ROS 2 的上位機通信。9.2 ESP32 在 ROS 2 里的定位在真實機器人項目中ESP32 最適合做執(zhí)行器節(jié)點和傳感器節(jié)點比如發(fā)布超聲波測距話題。發(fā)布 IMU 數(shù)據(jù)話題。訂閱/cmd_vel話題把速度指令轉(zhuǎn)成電機 PWM。這樣上位機只需要負責 SLAM 建圖、路徑規(guī)劃、AI 視覺而 ESP32 負責實時響應和底層控制。9.3 接入 Micro-ROS 的大致流程第一步在 Arduino IDE 中安裝micro_ros_arduino庫?？梢酝ㄟ^ Library Manager 搜索micro_ros_arduino或從 GitHub 克隆到 Arduino/libraries 目錄。第二步根據(jù)網(wǎng)絡方式選擇傳輸層。WiFi 場景下需要先連接到熱點然后運行 Micro-ROS Agent。串口場景下則用 USB 轉(zhuǎn) TTL 連接上位機。第三步用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); }注意這段代碼只是示意完整運行還需要在setup里創(chuàng)建節(jié)點、初始化 publisher并且處理rclc_executor的 spin。不同版本的 micro_ros_arduino 庫 API 有差異編譯報錯時先從官方例程micro_ros_arduino_publisher開始修改。9.4 ROS 2 上位機配置在上位機上啟動 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ù)做“機器人導航”至關重要因為你可以讓機器人跑在 ROS 2 的導航棧里。10. 常見問題與排查方法問題現(xiàn)象可能原因排查方式解決方案燒錄失敗串口無法連接板子進入不了下載模式按住 BOOT 鍵再點燒錄手動進入下載模式或換 USB 數(shù)據(jù)線燒錄時報錯A fatal error occurred驅(qū)動未裝 / 端口錯 / 線材問題檢查設備管理器確認 COM 口安裝 CP210x 或 CH340 驅(qū)動電機不轉(zhuǎn)L298N 供電不足或未共地檢查電源指示燈、GND 連線外部供電接好共地電機轉(zhuǎn)向反了電機線接反或代碼方向不對觀察電機轉(zhuǎn)向調(diào)換 OUT 接線或改代碼超聲波距離數(shù)據(jù)亂跳供電不穩(wěn) / ECHO 電平不匹配萬用表測電壓串口打印通電后數(shù)據(jù)獨立供電或加分壓電路OLED 無顯示I2C 地址不對或 SDA/SCL 接反運行 I2C 掃描程序嘗試 0x3C 和 0x3D 地址Web 控制頁打不開WiFi 名密碼錯誤 / 不在同一網(wǎng)段串口打印 IP手機 ping 該 IP重新配網(wǎng)確保手機和開發(fā)板同一路由器Micro-ROS 連接失敗Agent 未啟動 / 端口被占用查看 Agent 日志關閉防火墻或換端口外接電源后 ESP32 重啟電機電流過大導致電壓跌落測電機啟動時電壓電機驅(qū)動單獨供電或加電容除了這些還有一個容易忽略的問題GPIO 引腳沖突。很多 ESP32 開發(fā)板把 LED 接在 GPIO 2 上如果你把電機引腳也用到 GPIO 2跑起來可能看到 LED 異常閃爍。建議在項目一開始就維護一張引腳分配表寫完代碼后逐項核對。11. 最佳實踐與工程建議11.1 先分模塊再拼接我見過太多把代碼一口氣寫完最后燒錄全部失敗的人。正確做法是先點亮 LED確認環(huán)境可用。再跑電機測試確認方向和 PWM 正常。再測傳感器確認距離值準確。再連 OLED確認顯示正常。最后把模塊拼到一起加 WiFi 控制。每拼一個模塊就驗證一次能大幅降低排錯成本。11.2 供電設計是機器人的生命線桌面機器人的故障一半以上來自供電。建議電機驅(qū)動板和主控分開供電或者使用大電流降壓模塊。電機啟動時瞬間電流可能達到 1-2A電壓會明顯跌落。如果使用 18650 電池加一個 5V/3A 降壓模塊。萬用表測量各模塊實際電壓而不是只看理論值。11.3 代碼組織和版本管理即使是一個人做項目也建議用 Git 管理代碼?？梢园衙總€功能寫成單獨的.h文件或tab文件例如motor.h、ultrasonic.h、wifi_control.h最后在.ino文件里組合調(diào)用。這樣后續(xù)擴展麥克風、攝像頭、屏幕時不需要重寫底層邏輯。11.4 日志與調(diào)試習慣在關鍵位置添加Serial.println打印狀態(tài)遠比斷點調(diào)試方便。尤其是 WiFi 連接、傳感器讀取、電機動作切換這幾個節(jié)點合理的日志輸出能讓你在 5 分鐘內(nèi)定位問題。上生產(chǎn)環(huán)境或長時間運行時可以把日志合并成一個狀態(tài)字符串通過 WebSocket 發(fā)給控制端顯示這樣就能實時看到機器人“心路歷程”。11.5 安全邊界與合法使用提醒如果項目涉及攝像頭、語音采集、云端 API提醒自己遵守設備所屬地區(qū)和所在機構(gòu)的隱私與安全規(guī)定。不要采集未經(jīng)授權(quán)的個人信息不要繞過任何平臺的安全機制。代碼中默認只處理授權(quán)范圍內(nèi)的受控設備。12. 總結(jié)與后續(xù)學習方向到這里你已經(jīng)把一顆可能還在吃灰的 ESP32 開發(fā)板變成了一臺能跑、能躲墻、能被手機控制、能顯示表情的基礎機器人小伙伴。回顧一下這篇文章真正有用的是三塊內(nèi)容一是 ESP32 在機器人架構(gòu)中的定位它適合做主控而非復雜計算節(jié)點二是從電機、傳感器到 WiFi 控制的完整代碼鏈路這些代碼可以組合出非常多的玩法三是 Micro-ROS 的接入思路讓你以后從“玩具”走向“真機器人”時有明確路徑。下一步建議你按這個順序繼續(xù)深入先跑通本文的 Web 控制頁讓機器人在手機控制下自由移動。給機器人添加一個舵機云臺掛上攝像頭做簡單的 WiFi 圖傳。接入 Micro-ROS 和上位機用 ROS 2 的 Nav2 做 SLAM 導航。如果對屏幕交互感興趣學習 LVGL在機器人上做一個完整的控制面板。如果對 AI 交互感興趣嘗試把離線語音識別模塊和云端大模型接進來。說到底機器人開發(fā)的樂趣不在于一步到位而在于每次“換一個新模塊跑通一個新功能”的成就感?，F(xiàn)在就從你最感興趣的模塊開始動手吧你的第一個 AI 機器人小伙伴已經(jīng)在桌面上等你了。 ESP32打造桌面AI機器人：從電機控制到ROS 2接入全教程
如果你最近刷短視頻一定見過那種十幾厘米高、會搖頭晃腦、能聽懂簡單指令的小機器人。它們看起來像是工業(yè)機器人的縮小版但背后真正驅(qū)動它們的核心往往不是昂貴的樹莓派加激光雷達而是一塊幾十塊錢的 ESP32 開發(fā)板。很多人第一反應是ESP32 不是一塊 WiFi 藍牙單片機嗎它也能做 AI 機器人這正是這篇教程想解決的問題。我會從一個真實場景出發(fā)你想打造一臺屬于自己的桌面積木機器人它有電機能移動有超聲波能避障有屏幕能顯示表情還能通過手機或網(wǎng)頁控制甚至接入 ROS 2 做更復雜的導航。傳統(tǒng)方案可能需要樹莓派、Arduino、各種驅(qū)動板拼在一起而 ESP32 一塊芯片就能承擔主控、通信、傳感器采樣和電機控制。文章會講清楚三件事ESP32 憑什么能當機器人主控、如何用 Arduino 或 Micro-ROS 完成底層開發(fā)、以及從硬件選型到代碼調(diào)試的完整落地流程。無論你是機甲愛好者、剛?cè)腴T嵌入式的大學生還是想給孩子的科技作品加點智能這篇教程都值得收藏。1. 這篇文章真正要解決的問題先聊聊痛點。很多新手做機器人開場就掉進選型迷宮。想用樹莓派發(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 和藍牙雙核 240MHz 主頻有 520KB SRAM外設接口覆蓋了機器人常用的大部分需求。配合 Arduino 框架十幾分鐘就能跑起第一個點燈程序配合 Micro-ROS又能直接和 ROS 2 生態(tài)打通做 SLAM 導航也不是不可能。這篇文章要解決的真正問題是如何不用昂貴的開發(fā)板只靠 ESP32 加上常見模塊就造出一臺能遠程控制、能避障、能和用戶做基礎交互的 AI 機器人小伙伴。讀完你會掌握ESP32 在機器人項目中的架構(gòu)定位和選型建議。從零搭建 ESP32 Arduino 開發(fā)環(huán)境并燒錄的完整流程。使用 L298N 或 DRV8833 驅(qū)動直流電機、讀取超聲波傳感器數(shù)據(jù)的代碼寫法。如何用 Web 頁面和手機藍牙控制機器人并擴展語音、屏幕等 AI 交互能力。如何用 Micro-ROS 把 ESP32 接入 ROS 2為后續(xù)做自主導航鋪路。2. ESP32 為什么適合做機器人主控2.1 它到底是什么ESP32 是樂鑫推出的一系列 WiFi 藍牙 SoC不是單純的單片機。它內(nèi)部集成了 Xtensa 雙核處理器、WiFi 802.11 b/g/n、藍牙 4.2/5.0以及大量 GPIO 外設。不同型號差異不小做機器人最常用的是 ESP32 DevKitC 這類經(jīng)典板或者 ESP32-S3 這種帶 AI 加速的型號。用一句話概括ESP32 是“一塊帶 WiFi 藍牙的單片機”它的地位介于傳統(tǒng) MCU 和 Linux 單板機之間。2.2 和常見開發(fā)板對比對比項ESP32 DevKitCSTM32F407 探索者Arduino Uno樹莓派 4B主頻240MHz 雙核168MHz 單核16MHz1.5GHz 四核WiFi 藍牙原生集成需外掛模塊需外掛模塊原生集成內(nèi)存520KB SRAM192KB SRAM2KB SRAM2GB-8GB開發(fā)難度低Arduino/Python高HAL/寄存器最低較高Linux實時性較好很好一般較差系統(tǒng)啟動時間毫秒級毫秒級毫秒級秒級做桌面 AI 機器人適配度高中低高但成本高從這個表能看出ESP32 的最大優(yōu)勢不是算力而是“集成度 實時性 成本”的平衡點。2.3 開發(fā)板和單片機的區(qū)別很多新手會問開發(fā)板和單片機到底什么區(qū)別單片機是芯片本身開發(fā)板是把單片機芯片、晶振、USB 轉(zhuǎn)串口、電源電路、引腳排針集成在一起的電路板。買一塊 ESP32 開發(fā)板相當于拿到一個“最小可用的 ESP32 系統(tǒng)”插上 USB 線就能燒錄和調(diào)試。這也是為什么教程中我會刻意說“開發(fā)板”而不是“芯片”。對機器人項目來說開發(fā)板的意義在于不必自己設計復雜的外圍電路把時間花在邏輯和結(jié)構(gòu)上。2.4 結(jié)論適合哪種項目ESP32 適合做資源受限機器人。所謂資源受限是指這臺機器人不需要本地跑大模型或稠密建圖而是通過 WiFi 把圖像或傳感器數(shù)據(jù)傳到上位機處理或者只執(zhí)行簡單的避障、巡線、語音指令響應。如果你要做的恰好是一臺“眼睛靠攝像頭、大腦靠云端或手機、身體靠電機、表情靠屏幕”的桌面機器人ESP32 就是性價比最高的選擇。3. 總體架構(gòu)與硬件選型3.1 系統(tǒng)架構(gòu)設計在動手之前先畫出機器人小伙伴的功能框圖。這一步很重要否則焊完線才發(fā)現(xiàn)引腳沖突會非常痛苦。桌面 AI 機器人小伙伴可以拆成下面幾層感知層超聲波測距模塊、溫濕度傳感器、可選攝像頭。決策層ESP32 主控負責傳感器采樣、控制邏輯、通信。執(zhí)行層直流電機驅(qū)動板、舵機云臺、OLED/LVGL 屏幕。交互層手機網(wǎng)頁控制、藍牙手柄、語音播報模塊或離線語音識別。通信層WiFi 連接路由器或手機熱點通過 HTTP/WebSocket 與手機通信。3.2 硬件清單下面的清單不追求高性能只追求容易買到、接線友好、資料多。# 核心主控 1. ESP32 DevKitC V4 開發(fā)板或 ESP32-S3 DevKitC-1 2. 面包板 若干杜邦線 # 運動系統(tǒng) 3. 2 個 TT 直流減速電機 橡膠輪 4. 1 個 L298N 電機驅(qū)動板或 DRV8833 5. 5V 2A 移動電源或 2 節(jié) 18650 電池 降壓模塊 # 傳感器 6. HC-SR04 超聲波傳感器 7. DHT11 或 DHT22 溫濕度傳感器可選 # 交互外設 8. 0.96 寸 SSD1306 OLED 屏幕 9. 1 或 2 個 SG90 舵機做出頭部擺動效果 10. 按鍵、LED 若干3.3 引腳規(guī)劃建議ESP32 引腳并不像 Arduino Uno 那樣“隨便一個就能用”有幾個坑要提前知道GPIO 6-11 默認連接閃存芯片不能當普通 IO 用。GPIO 12 是 strapping 引腳上電時如果拉高會影響進入下載模式。GPIO 34-39 是輸入專用引腳不能輸出 PWM 或數(shù)字輸出。電機驅(qū)動板最好和傳感器使用不同電源域避免電機啟動時拉低傳感器供電。一個穩(wěn)妥的引腳分配如下設備ESP32 引腳左電機 IN1/IN2GPIO 26 / GPIO 27右電機 IN3/IN4GPIO 14 / GPIO 12若擔心可換成 32/33超聲波 TRIGGPIO 16超聲波 ECHOGPIO 17OLED SDA / SCLGPIO 21 / GPIO 22舵機信號GPIO 15DHT11 數(shù)據(jù)GPIO 4這里特別提醒GPIO 12 上電電平和下載模式有關如果插上拉模塊導致無法燒錄請優(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)絡下載失敗優(yōu)先檢查網(wǎng)絡環(huán)境或使用國內(nèi)鏡像源。從實際使用經(jīng)驗看ESP32 Arduino 內(nèi)核版本迭代較快遇到編譯報錯時先確認你安裝的是 2.x 還是 3.x 版本因為不同版本對analogWrite、LEDC等 API 的兼容有明顯差異。4.3 測試燒錄把 ESP32 開發(fā)板插入 USB選擇開發(fā)板型號為ESP32 Dev Module選擇對應的 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. 電機控制與運動系統(tǒng)實現(xiàn)5.1 電機驅(qū)動板接線L298N 是經(jīng)典電機驅(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 電機 A 兩線 → L298N OUT1 / OUT2 電機 B 兩線 → L298N OUT3 / OUT4必須強調(diào)電機驅(qū)動板的電源和 ESP32 的電源最好分開。如果強行用同一個 USB 5V 供電去驅(qū)動兩個大電流電機很容易出現(xiàn)開發(fā)板重啟、串口斷連、電機抖動等情況。新手最常見的錯誤是只插 USB 線然后接上電機驅(qū)動板期望它能帶動機器人結(jié)果屏幕直接黑掉。5.2 電機控制代碼下面這段代碼實現(xiàn)了前、后、左、右、停止五個動作。它通過 digitalWrite 控制電機方向并通過 delay 控制運行時間。// 文件路徑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 電機轉(zhuǎn)向效果會比較明顯。5.3 如何驗證運動是否正常燒錄后把機器人放在桌面按順序觀察前進 1 秒、后退 1 秒、左轉(zhuǎn) 0.8 秒、右轉(zhuǎn) 0.8 秒、停止 1 秒。如果發(fā)現(xiàn)動作順序不對只需要調(diào)整 IN1/IN2 或者 IN3/IN4 的接線位置就能解決不用改代碼。如果電機完全沒有反應優(yōu)先排查 L298N 上的電源指示燈是否亮起以及 ESP32 的 GND 是否和 L298N 的 GND 接在一起。共地問題幾乎占據(jù)電機控制故障的一半。6. 傳感器感知與自動避障6.1 超聲波測距原理HC-SR04 的工作原理很簡單向 TRIG 引腳發(fā)送一個 10 微秒以上的高電平脈沖模塊就會發(fā)射超聲波當聲波碰到障礙物返回時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 有電壓不匹配風險穩(wěn)妥做法是加一個分壓電路或用 3.3V 供電的傳感器模塊。6.2 添加避障邏輯把測距和電機控制合在一起就能寫出最簡單的“碰不到墻”的機器人// 文件路徑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()改成隨機選擇左轉(zhuǎn)或右轉(zhuǎn)避免遇到墻角時卡死。7. 接入 WiFi 和網(wǎng)頁遠程控制7.1 為什么 ESP32 天然適合做遠程控制ESP32 自帶 WiFi 是它比多數(shù)單片機更順手的地方。你不需要額外購買 ESP8266 模塊也不用寫復雜的 AT 指令。直接在 Arduino 代碼里引入 WiFi.h就能搖身一變成為一個 Web 服務器。這里要澄清一個常見誤解很多人以為 ESP32 “開 WiFi 會占很多資源”其實在簡單的控制場景里ESP32 的實時響應影響可以忽略。更需要注意的是你的網(wǎng)絡環(huán)境是否穩(wěn)定以及機器人是否處于路由器信號覆蓋范圍內(nèi)。7.2 最小 Web 控制服務器下面這個代碼實現(xiàn)了一個網(wǎng)頁控制臺手機連上同一個 WiFi 后打開瀏覽器訪問機器人 IP點擊方向按鈕即可控制電機。同時它還提供了網(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前進/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 地址在手機瀏覽器輸入這個 IP就能看到控制界面。7.3 大型機器人或者多設備場景怎么處理如果你的項目是搜索熱詞里提到的“機器人導航”“ROS2 機器人開發(fā)”那就要面對“多設備協(xié)同”的問題。ESP32 不適合作為復雜導航的主節(jié)點但它非常適合作為下位機把車速和傳感器數(shù)據(jù)通過 WiFi/串口發(fā)給上位機。上位機可以是 PC、Jetson Nano也可以是另一塊更強大的開發(fā)板。這時候把 HTTP 換成更高效的 WebSocket 或 MQTT 是更好的選擇。HTTP 請求每次都要建連和斷連控制頻率高了會產(chǎn)生明顯的延遲MQTT 或 WebSocket 則能保持長連接控制指令延遲能降到幾十毫秒以內(nèi)。8. 用 OLED 和語音模塊做 AI 交互8.1 添加表情屏幕機器人要有“小伙伴”的感覺單單會跑是不夠的。給它加一塊 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手動畫一條弧線。畫表情不是重點重點是你開始通過外設表達機器人“狀態(tài)”這就是交互體驗的基礎。8.2 接入基礎語音交互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ù)識別到“前進”“后退”“停止”等關鍵詞后執(zhí)行對應電機動作。這種方式?jīng)]有網(wǎng)絡延遲也不依賴外部服務適合離線演示。真正做 AI 對話交互時你更可能采用“ESP32 手機 App 云端 API”的架構(gòu)ESP32 通過藍牙或 WiFi 把語音上傳到手機手機調(diào)用大模型接口再把返回的文本通過 TTS 播放出來。ESP32 在這里充當?shù)氖菣C器人底層執(zhí)行器和語音前端。8.3 LVGL 屏幕界面如果你使用的是帶屏幕的 ESP32 開發(fā)板比如 ESP32-S3 配 ST7789 屏幕可以在板上運行 LVGL。LVGL 是一個開源嵌入式圖形庫能設計按鈕、動畫、儀表盤。搜索熱詞里出現(xiàn)的esp32 lvgl是很多開發(fā)者在做智能面板項目時的主要方向。用 LVGL 做機器人控制界面的好處是它不需要依賴瀏覽器直接在機器人本地面板上顯示控制按鈕和狀態(tài)。缺點是開發(fā)量比 OLED 表情大不少適合作為進階挑戰(zhàn)。9. 進階用 Micro-ROS 把 ESP32 接入 ROS 29.1 Micro-ROS 是什么如果你看到過esp32 micro-ros arduino這組關鍵詞說明你可能已經(jīng)開始接觸機器人操作系統(tǒng) ROS 2。ROS 2 是機器人領域的主流軟件框架但它默認運行在 Linux 系統(tǒng)上對單片機并不友好。Micro-ROS 的作用就是讓內(nèi)存受限的 MCU 也能成為 ROS 2 網(wǎng)絡里的一個節(jié)點。用大白話說ROS 2 是一套機器人的“操作系統(tǒng)級通信框架”Micro-ROS 是它的瘦身版ESP32 通過 WiFi 或串口就能和跑著 ROS 2 的上位機通信。9.2 ESP32 在 ROS 2 里的定位在真實機器人項目中ESP32 最適合做執(zhí)行器節(jié)點和傳感器節(jié)點比如發(fā)布超聲波測距話題。發(fā)布 IMU 數(shù)據(jù)話題。訂閱/cmd_vel話題把速度指令轉(zhuǎn)成電機 PWM。這樣上位機只需要負責 SLAM 建圖、路徑規(guī)劃、AI 視覺而 ESP32 負責實時響應和底層控制。9.3 接入 Micro-ROS 的大致流程第一步在 Arduino IDE 中安裝micro_ros_arduino庫?？梢酝ㄟ^ Library Manager 搜索micro_ros_arduino或從 GitHub 克隆到 Arduino/libraries 目錄。第二步根據(jù)網(wǎng)絡方式選擇傳輸層。WiFi 場景下需要先連接到熱點然后運行 Micro-ROS Agent。串口場景下則用 USB 轉(zhuǎn) TTL 連接上位機。第三步用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); }注意這段代碼只是示意完整運行還需要在setup里創(chuàng)建節(jié)點、初始化 publisher并且處理rclc_executor的 spin。不同版本的 micro_ros_arduino 庫 API 有差異編譯報錯時先從官方例程micro_ros_arduino_publisher開始修改。9.4 ROS 2 上位機配置在上位機上啟動 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ù)做“機器人導航”至關重要因為你可以讓機器人跑在 ROS 2 的導航棧里。10. 常見問題與排查方法問題現(xiàn)象可能原因排查方式解決方案燒錄失敗串口無法連接板子進入不了下載模式按住 BOOT 鍵再點燒錄手動進入下載模式或換 USB 數(shù)據(jù)線燒錄時報錯A fatal error occurred驅(qū)動未裝 / 端口錯 / 線材問題檢查設備管理器確認 COM 口安裝 CP210x 或 CH340 驅(qū)動電機不轉(zhuǎn)L298N 供電不足或未共地檢查電源指示燈、GND 連線外部供電接好共地電機轉(zhuǎn)向反了電機線接反或代碼方向不對觀察電機轉(zhuǎn)向調(diào)換 OUT 接線或改代碼超聲波距離數(shù)據(jù)亂跳供電不穩(wěn) / ECHO 電平不匹配萬用表測電壓串口打印通電后數(shù)據(jù)獨立供電或加分壓電路OLED 無顯示I2C 地址不對或 SDA/SCL 接反運行 I2C 掃描程序嘗試 0x3C 和 0x3D 地址Web 控制頁打不開WiFi 名密碼錯誤 / 不在同一網(wǎng)段串口打印 IP手機 ping 該 IP重新配網(wǎng)確保手機和開發(fā)板同一路由器Micro-ROS 連接失敗Agent 未啟動 / 端口被占用查看 Agent 日志關閉防火墻或換端口外接電源后 ESP32 重啟電機電流過大導致電壓跌落測電機啟動時電壓電機驅(qū)動單獨供電或加電容除了這些還有一個容易忽略的問題GPIO 引腳沖突。很多 ESP32 開發(fā)板把 LED 接在 GPIO 2 上如果你把電機引腳也用到 GPIO 2跑起來可能看到 LED 異常閃爍。建議在項目一開始就維護一張引腳分配表寫完代碼后逐項核對。11. 最佳實踐與工程建議11.1 先分模塊再拼接我見過太多把代碼一口氣寫完最后燒錄全部失敗的人。正確做法是先點亮 LED確認環(huán)境可用。再跑電機測試確認方向和 PWM 正常。再測傳感器確認距離值準確。再連 OLED確認顯示正常。最后把模塊拼到一起加 WiFi 控制。每拼一個模塊就驗證一次能大幅降低排錯成本。11.2 供電設計是機器人的生命線桌面機器人的故障一半以上來自供電。建議電機驅(qū)動板和主控分開供電或者使用大電流降壓模塊。電機啟動時瞬間電流可能達到 1-2A電壓會明顯跌落。如果使用 18650 電池加一個 5V/3A 降壓模塊。萬用表測量各模塊實際電壓而不是只看理論值。11.3 代碼組織和版本管理即使是一個人做項目也建議用 Git 管理代碼?？梢园衙總€功能寫成單獨的.h文件或tab文件例如motor.h、ultrasonic.h、wifi_control.h最后在.ino文件里組合調(diào)用。這樣后續(xù)擴展麥克風、攝像頭、屏幕時不需要重寫底層邏輯。11.4 日志與調(diào)試習慣在關鍵位置添加Serial.println打印狀態(tài)遠比斷點調(diào)試方便。尤其是 WiFi 連接、傳感器讀取、電機動作切換這幾個節(jié)點合理的日志輸出能讓你在 5 分鐘內(nèi)定位問題。上生產(chǎn)環(huán)境或長時間運行時可以把日志合并成一個狀態(tài)字符串通過 WebSocket 發(fā)給控制端顯示這樣就能實時看到機器人“心路歷程”。11.5 安全邊界與合法使用提醒如果項目涉及攝像頭、語音采集、云端 API提醒自己遵守設備所屬地區(qū)和所在機構(gòu)的隱私與安全規(guī)定。不要采集未經(jīng)授權(quán)的個人信息不要繞過任何平臺的安全機制。代碼中默認只處理授權(quán)范圍內(nèi)的受控設備。12. 總結(jié)與后續(xù)學習方向到這里你已經(jīng)把一顆可能還在吃灰的 ESP32 開發(fā)板變成了一臺能跑、能躲墻、能被手機控制、能顯示表情的基礎機器人小伙伴。回顧一下這篇文章真正有用的是三塊內(nèi)容一是 ESP32 在機器人架構(gòu)中的定位它適合做主控而非復雜計算節(jié)點二是從電機、傳感器到 WiFi 控制的完整代碼鏈路這些代碼可以組合出非常多的玩法三是 Micro-ROS 的接入思路讓你以后從“玩具”走向“真機器人”時有明確路徑。下一步建議你按這個順序繼續(xù)深入先跑通本文的 Web 控制頁讓機器人在手機控制下自由移動。給機器人添加一個舵機云臺掛上攝像頭做簡單的 WiFi 圖傳。接入 Micro-ROS 和上位機用 ROS 2 的 Nav2 做 SLAM 導航。如果對屏幕交互感興趣學習 LVGL在機器人上做一個完整的控制面板。如果對 AI 交互感興趣嘗試把離線語音識別模塊和云端大模型接進來。說到底機器人開發(fā)的樂趣不在于一步到位而在于每次“換一個新模塊跑通一個新功能”的成就感?，F(xiàn)在就從你最感興趣的模塊開始動手吧你的第一個 AI 機器人小伙伴已經(jīng)在桌面上等你了。