器人制作全攻略)
很多人在做智能小車(chē)或者機(jī)器人項(xiàng)目時(shí)第一反應(yīng)是選樹(shù)莓派或者 Jetson如果只是做一臺(tái)在室內(nèi)移動(dòng)、能回傳畫(huà)面、能遠(yuǎn)程遙控的小車(chē)使用 ESP32 系列芯片反而是性?xún)r(jià)比非常高的一條路線。ESP32-CAM 把攝像頭、WiFi、GPIO、PSRAM 集成在一塊很小的板子上配合電機(jī)驅(qū)動(dòng)模塊、云臺(tái)舵機(jī)和電池就能組成一臺(tái)“能看、能走、能轉(zhuǎn)彎”的迷你 WiFi 機(jī)器人。本文將圍繞 ESP32-CAM 的實(shí)時(shí)視頻回傳、電機(jī)運(yùn)動(dòng)控制、網(wǎng)頁(yè)遙控按鍵這三條主線完整講解從硬件選型到代碼燒錄的整個(gè)流程并把常見(jiàn)的燒錄失敗、視頻卡頓、供電不足等問(wèn)題一并梳理清楚。1. 用 ESP32 做 WiFi 機(jī)器人的價(jià)值在哪里1.1 為什么是 ESP32 而不是樹(shù)莓派樹(shù)莓派性能強(qiáng)、系統(tǒng)豐富但價(jià)格高、體積大、啟動(dòng)慢對(duì)電源要求也高。ESP32 單片機(jī)的優(yōu)勢(shì)正好相反芯片和模塊成本低開(kāi)發(fā)板幾十元就能買(mǎi)到支持 WiFi 和藍(lán)牙適合局域網(wǎng)內(nèi)做視頻流和指令傳輸可以通過(guò) Arduino IDE、PlatformIO、ESP-IDF 等方式開(kāi)發(fā)上手門(mén)檻低。對(duì)于“遙控小車(chē) 視頻回傳”這類(lèi)任務(wù)ESP32 的算力完全夠用。當(dāng)然ESP32 不適合做復(fù)雜圖像處理任務(wù)它的主要定位是采集視頻并實(shí)時(shí)傳輸至于圖像識(shí)別、避障規(guī)劃、導(dǎo)航建圖這類(lèi)算法通常放在 PC、手機(jī)或者樹(shù)莓派等上位機(jī)上完成。理解這一點(diǎn)才能在設(shè)計(jì)機(jī)器人方案時(shí)選對(duì)硬件。1.2 ESP32-CAM 在視頻傳輸中的角色ESP32-CAM 是基于 ESP32 芯片的攝像頭模塊板上集成了 OV2640 攝像頭和 PSRAM。PSRAMPseudo-SRAM用于緩存圖像數(shù)據(jù)這對(duì)視頻采集非常關(guān)鍵因?yàn)樗茏?ESP32-CAM 在低分辨率下流暢采集 JPEG 幀。實(shí)際使用中可以通過(guò) HTTP 的 MJPEG 流把畫(huà)面持續(xù)推送到瀏覽器手機(jī)、平板、電腦打開(kāi)一個(gè)網(wǎng)頁(yè)就能實(shí)時(shí)查看。它的工作流程可以簡(jiǎn)單理解成攝像頭采集圖像內(nèi)部轉(zhuǎn)換成 JPEG 格式ESP32 通過(guò) WiFi 建立 HTTP Server瀏覽器訪問(wèn)視頻流地址后服務(wù)器不斷發(fā)送 multipart 格式的 JPEG 幀瀏覽器逐幀刷新顯示形成流暢的視頻畫(huà)面。因此ESP32-CAM 非常適合做“第一視角”回傳設(shè)備例如小型機(jī)器人、管道探測(cè)、桌底床底巡查、室內(nèi)安防小車(chē)等。1.3 完整功能定位這篇文章要做的系統(tǒng)包含三大部分視頻回傳ESP32-CAM 開(kāi)啟局域網(wǎng)視頻流運(yùn)動(dòng)控制通過(guò)網(wǎng)頁(yè)按鈕控制左右電機(jī)的前進(jìn)、后退、轉(zhuǎn)向、停止云臺(tái)控制使用舵機(jī)帶動(dòng)攝像頭上下左右轉(zhuǎn)動(dòng)擴(kuò)大視野范圍。整體架構(gòu)比較簡(jiǎn)潔使用一塊 ESP32-CAM 作為主控L298N 或者 TB6612 電機(jī)驅(qū)動(dòng)模塊驅(qū)動(dòng)直流減速電機(jī)舵機(jī)云臺(tái)負(fù)責(zé)攝像頭角度調(diào)整。所有控制指令通過(guò) WiFi 傳輸不需要搭服務(wù)器也不依賴(lài)云平臺(tái)在局域網(wǎng)內(nèi)即可完成所有功能。2. 硬件選型與整車(chē)接線2.1 核心硬件清單下面是搭建這臺(tái)迷你 WiFi 機(jī)器人需要準(zhǔn)備的主要硬件硬件作用選購(gòu)建議ESP32-CAM 開(kāi)發(fā)板主控 攝像頭 WiFi優(yōu)先選擇帶底座的版本方便燒錄OV2640 攝像頭視頻采集ESP32-CAM 板載自帶L298N 驅(qū)動(dòng)模塊驅(qū)動(dòng)直流電機(jī)也可以用 TB6612、DRV8833直流減速電機(jī) × 2小車(chē)動(dòng)力3V~6V 工作電壓的 N20 或 TT 電機(jī)小車(chē)底盤(pán)承載電機(jī)和電路亞克力底盤(pán)或者 3D 打印底盤(pán)都可舵機(jī)云臺(tái) × 2控制攝像頭上下左右轉(zhuǎn)動(dòng)SG90 舵機(jī)即可18650 電池座或鋰電池組供電需要滿(mǎn)足 ESP32-CAM 和電機(jī)驅(qū)動(dòng)模塊的電壓需求降壓模塊穩(wěn)定供電給 ESP32-CAM例如 DC-DC 降壓模塊或 AMS1117杜邦線、螺絲、銅柱結(jié)構(gòu)固定常規(guī)必備需要注意的是不同商家的 ESP32-CAM 模塊引腳定義可能略有不同購(gòu)買(mǎi)時(shí)盡量讓商家提供官方引腳圖或者原理圖避免接線后引腳不生效。2.2 供電方案設(shè)計(jì)供電是這類(lèi)小車(chē)最容易出問(wèn)題的地方。L298N 驅(qū)動(dòng)模塊帶有一個(gè)板載 5V 穩(wěn)壓輸出但它的帶載能力有限。如果直接把 L298N 的 5V 輸出送給 ESP32-CAM在攝像頭啟動(dòng)和舵機(jī)轉(zhuǎn)動(dòng)瞬間可能導(dǎo)致電壓跌落引發(fā)開(kāi)發(fā)板重啟。更穩(wěn)妥的方式是電氣上分成兩級(jí)電機(jī)電源由電池組直接給 L298N 的電機(jī)會(huì)供電邏輯電源由單獨(dú)的降壓模塊輸出 5V 給 ESP32-CAM 和舵機(jī)供電共地處理把電池負(fù)極、L298N 的 GND、ESP32-CAM 的 GND 連接在一起保證信號(hào)電平一致。在實(shí)際搭建中很多人直接使用充電寶給 ESP32-CAM 供電電池組給電機(jī)供電這樣也能運(yùn)行但必須把兩路電源的負(fù)極接到一起否則 GPIO 控制信號(hào)無(wú)法形成回路。2.3 接線參考下面給出一個(gè)常見(jiàn)的接線方案先不要照抄引腳請(qǐng)以你自己開(kāi)發(fā)板絲印為準(zhǔn)L298N 的 IN1、IN2 接 ESP32-CAM 的 GPIO12、GPIO13L298N 的 IN3、IN4 接 ESP32-CAM 的 GPIO14、GPIO15L298N 電機(jī)輸出 A 接左電機(jī)電機(jī)輸出 B 接右電機(jī)水平舵機(jī)信號(hào)線接 GPIO4垂直舵機(jī)信號(hào)線接 GPIO2。如果你手里的卡板引出腳有限可以把電機(jī)引腳和舵機(jī)引腳重新規(guī)劃只要避開(kāi)攝像頭占用的引腳即可。3. 開(kāi)發(fā)環(huán)境搭建與 ESP32 燒錄基礎(chǔ)3.1 安裝 Arduino IDEArduino IDE 是目前 ESP32 開(kāi)發(fā)最直接的入口新手推薦從 Arduino IDE 2.x 開(kāi)始。下載安裝完成后打開(kāi)“開(kāi)發(fā)板管理器”搜索 ESP32安裝 Espressif 官方提供的 esp32 開(kāi)發(fā)板包。如果開(kāi)發(fā)板管理器中沒(méi)有 ESP32可以在“文件 - 首選項(xiàng) - 附加開(kāi)發(fā)板管理器網(wǎng)址”中添加官方 JSON 地址https://espressif.github.io/arduino-esp32/package_esp32_index.json添加后重新打開(kāi)開(kāi)發(fā)板管理器搜索esp32即可。安裝時(shí)間取決于網(wǎng)絡(luò)環(huán)境如果下載慢可以在晚上網(wǎng)絡(luò)空閑時(shí)重試。3.2 燒錄模式與常見(jiàn)問(wèn)題ESP32-CAM 模塊和普通開(kāi)發(fā)板不同很多版本沒(méi)有自動(dòng)下載電路需要手動(dòng)控制 GPIO0 的電平進(jìn)入下載模式。使用方法如下按住模塊上的 IO0/BOOT 按鍵點(diǎn)擊復(fù)位按鍵先松開(kāi)復(fù)位按鍵再松開(kāi) IO0/BOOT 按鍵此時(shí)模塊進(jìn)入燒錄模式可以在 Arduino IDE 中點(diǎn)擊上傳。如果燒錄時(shí)報(bào)錯(cuò)Failed to connect to ESP32多半是 GPIO0 沒(méi)有拉低或者串口驅(qū)動(dòng)沒(méi)有安裝?？梢韵葯z查設(shè)備管理器中是否認(rèn)出了 USB 轉(zhuǎn)串口芯片常見(jiàn)的芯片為 CH340G 或 CP2102。3.3 開(kāi)發(fā)板選擇在 Arduino IDE 開(kāi)發(fā)板列表中選擇AI Thinker ESP32-CAM這是比較通用的型號(hào)。如果你的攝像頭模塊是其他廠商生產(chǎn)的請(qǐng)?jiān)凇捌渌?ESP32 開(kāi)發(fā)板”中選擇合適型號(hào)或者直接選擇ESP32 Dev Module然后在配置中手動(dòng)設(shè)置 PSRAM 為啟用狀態(tài)。這里有一個(gè)容易踩坑的地方如果選擇的開(kāi)發(fā)板類(lèi)型沒(méi)有正確啟用 PSRAM攝像頭初始化會(huì)失敗視頻流無(wú)法啟動(dòng)。出現(xiàn)Camera init failed with error ...時(shí)優(yōu)先檢查開(kāi)發(fā)板類(lèi)型和 PSRAM 設(shè)置。4. 核心原理拆解視頻流、控制指令與網(wǎng)頁(yè)交互4.1 MJPEG 視頻流原理MJPEG 并不是一種嚴(yán)格的視頻編碼它本質(zhì)上是把連續(xù)的 JPEG 圖片一張接一張發(fā)送給瀏覽器。ESP32-CAM 使用esp_http_server庫(kù)建立 HTTP Server當(dāng)瀏覽器請(qǐng)求/stream時(shí)服務(wù)器不斷發(fā)送這樣的數(shù)據(jù)--frame Content-Type: image/jpeg Content-Length: 12345 JPEG 二進(jìn)制數(shù)據(jù) --frame Content-Type: image/jpeg Content-Length: 12345 JPEG 二進(jìn)制數(shù)據(jù)瀏覽器收到這種multipart/x-mixed-replace格式的響應(yīng)后會(huì)不斷用新幀替換舊幀用戶(hù)看到的效果就是“視頻”。這種做法實(shí)現(xiàn)簡(jiǎn)單兼容性好而且對(duì) ESP32 的 CPU 壓力較小。4.2 電機(jī)控制原理直流減速電機(jī)本身不需要復(fù)雜協(xié)議通過(guò)電機(jī)驅(qū)動(dòng)模塊把 GPIO 的高低電平轉(zhuǎn)換成電機(jī)的正反轉(zhuǎn)即可。以 L298N 為例IN1 和 IN2 控制一側(cè)電機(jī)IN1 高、IN2 低電機(jī)正轉(zhuǎn)IN1 低、IN2 高電機(jī)反轉(zhuǎn)IN1 和 IN2 同高或同低電機(jī)停止。左右兩路電機(jī)單獨(dú)控制就能實(shí)現(xiàn)前進(jìn)、后退、左轉(zhuǎn)、右轉(zhuǎn)。左轉(zhuǎn)時(shí)可以讓左側(cè)電機(jī)反轉(zhuǎn)、右側(cè)電機(jī)正轉(zhuǎn)實(shí)現(xiàn)差速原地轉(zhuǎn)向也可以讓左側(cè)電機(jī)停止、右側(cè)電機(jī)正轉(zhuǎn)這樣轉(zhuǎn)向半徑更大。4.3 控制指令協(xié)議設(shè)計(jì)為了讓網(wǎng)頁(yè)端的按鈕操作和機(jī)器人端代碼保持簡(jiǎn)潔本文使用一個(gè)/cmd接口通過(guò) URL 參數(shù)傳遞控制指令。例如http://192.168.1.100/cmd?dirforwardhttp://192.168.1.100/cmd?dirbackhttp://192.168.1.100/cmd?dirlefthttp://192.168.1.100/cmd?dirrighthttp://192.168.1.100/cmd?dirstophttp://192.168.1.100/cmd?diruphttp://192.168.1.100/cmd?dirdown網(wǎng)頁(yè)端通過(guò) JavaScript 的fetch發(fā)送請(qǐng)求每按下一個(gè)按鈕機(jī)器人就會(huì)執(zhí)行對(duì)應(yīng)的動(dòng)作。實(shí)際項(xiàng)目中你可能需要增加指令節(jié)流、狀態(tài)反饋、心跳檢測(cè)等機(jī)制避免指令丟失。5. 完整實(shí)戰(zhàn)案例搭建一個(gè)可遙控的 ESP32 WiFi 機(jī)器人下面進(jìn)入核心環(huán)節(jié)。我們使用 Arduino IDE 編寫(xiě)一個(gè)完整可運(yùn)行的代碼代碼同時(shí)實(shí)現(xiàn)視頻流、電機(jī)控制和舵機(jī)云臺(tái)控制。5.1 創(chuàng)建項(xiàng)目文件在 Arduino IDE 中新建項(xiàng)目命名esp32_wifi_robot。項(xiàng)目目錄如下esp32_wifi_robot/ └── esp32_wifi_robot.ino5.2 完整代碼下面的代碼是一個(gè)完整的.ino文件。配置 WiFi 部分時(shí)請(qǐng)把示例中的YourWiFi和YourPassword替換成你自己的網(wǎng)絡(luò)信息。// 文件路徑esp32_wifi_robot/esp32_wifi_robot.ino #include WiFi.h #include esp_camera.h #include esp_http_server.h #include ESP32Servo.h // WiFi 配置 const char* ssid YourWiFi; const char* password YourPassword; // 電機(jī)引腳 #define MOTOR_A1 12 #define MOTOR_A2 13 #define MOTOR_B1 14 #define MOTOR_B2 15 // 舵機(jī)引腳 #define SERVO_HORIZONTAL 4 #define SERVO_VERTICAL 2 // 云臺(tái)變量 Servo servoH; Servo servoV; int angleH 90; int angleV 90; // 攝像頭引腳定義 #define PWDN_GPIO_NUM 32 #define RESET_GPIO_NUM -1 #define XCLK_GPIO_NUM 0 #define SIOD_GPIO_NUM 26 #define SIOC_GPIO_NUM 27 #define Y9_GPIO_NUM 35 #define Y8_GPIO_NUM 34 #define Y7_GPIO_NUM 39 #define Y6_GPIO_NUM 36 #define Y5_GPIO_NUM 21 #define Y4_GPIO_NUM 19 #define Y3_GPIO_NUM 18 #define Y2_GPIO_NUM 5 #define VSYNC_GPIO_NUM 25 #define HREF_GPIO_NUM 23 #define PCLK_GPIO_NUM 22 // 電機(jī)控制函數(shù) void motorStop() { digitalWrite(MOTOR_A1, LOW); digitalWrite(MOTOR_A2, LOW); digitalWrite(MOTOR_B1, LOW); digitalWrite(MOTOR_B2, LOW); } void motorForward() { digitalWrite(MOTOR_A1, HIGH); digitalWrite(MOTOR_A2, LOW); digitalWrite(MOTOR_B1, HIGH); digitalWrite(MOTOR_B2, LOW); } void motorBack() { digitalWrite(MOTOR_A1, LOW); digitalWrite(MOTOR_A2, HIGH); digitalWrite(MOTOR_B1, LOW); digitalWrite(MOTOR_B2, HIGH); } void motorLeft() { digitalWrite(MOTOR_A1, LOW); digitalWrite(MOTOR_A2, HIGH); digitalWrite(MOTOR_B1, HIGH); digitalWrite(MOTOR_B2, LOW); } void motorRight() { digitalWrite(MOTOR_A1, HIGH); digitalWrite(MOTOR_A2, LOW); digitalWrite(MOTOR_B1, LOW); digitalWrite(MOTOR_B2, HIGH); } // 攝像頭初始化 void startCamera() { camera_config_t config; config.ledc_channel LEDC_CHANNEL_0; config.ledc_timer LEDC_TIMER_0; config.pin_d0 Y2_GPIO_NUM; config.pin_d1 Y3_GPIO_NUM; config.pin_d2 Y4_GPIO_NUM; config.pin_d3 Y5_GPIO_NUM; config.pin_d4 Y6_GPIO_NUM; config.pin_d5 Y7_GPIO_NUM; config.pin_d6 Y8_GPIO_NUM; config.pin_d7 Y9_GPIO_NUM; config.pin_xclk XCLK_GPIO_NUM; config.pin_pclk PCLK_GPIO_NUM; config.pin_vsync VSYNC_GPIO_NUM; config.pin_href HREF_GPIO_NUM; config.pin_sccb_sda SIOD_GPIO_NUM; config.pin_sccb_scl SIOC_GPIO_NUM; config.pin_pwdn PWDN_GPIO_NUM; config.pin_reset RESET_GPIO_NUM; config.xclk_freq_hz 20000000; config.pixel_format PIXFORMAT_JPEG; // 選擇合適分辨率和質(zhì)量 config.frame_size FRAMESIZE_VGA; config.jpeg_quality 12; config.fb_count 2; esp_err_t err esp_camera_init(config); if (err ! ESP_OK) { Serial.printf(攝像頭初始化失敗錯(cuò)誤碼 0x%x\n, err); return; } } // 視頻流回調(diào) static esp_err_t streamHandler(httpd_req_t* req) { camera_fb_t* fb NULL; esp_err_t res ESP_OK; char partBuf[64]; res httpd_resp_set_type(req, multipart/x-mixed-replace; boundaryframe); if (res ! ESP_OK) { return res; } while (true) { fb esp_camera_fb_get(); if (!fb) { res ESP_FAIL; break; } size_t jpgBufLen fb-len; uint8_t* jpgBuf fb-buf; if (fb-format ! PIXFORMAT_JPEG) { bool converted frame2jpg(fb, 80, jpgBuf, jpgBufLen); esp_camera_fb_return(fb); if (!converted) { res ESP_FAIL; break; } } int hLen snprintf(partBuf, sizeof(partBuf), --frame\r\nContent-Type: image/jpeg\r\nContent-Length: %u\r\n\r\n, jpgBufLen); httpd_resp_send_chunk(req, partBuf, hLen); httpd_resp_send_chunk(req, (const char*)jpgBuf, jpgBufLen); httpd_resp_send_chunk(req, \r\n, 2); if (fb-format PIXFORMAT_JPEG) { esp_camera_fb_return(fb); } } return res; } // 控制指令回調(diào) static esp_err_t cmdHandler(httpd_req_t* req) { char buf[128]; char dir[16] {0}; if (httpd_req_get_url_query_str(req, buf, sizeof(buf)) ESP_OK) { if (httpd_query_key_value(buf, dir, dir, sizeof(dir)) ESP_OK) { if (strcmp(dir, forward) 0) { motorForward(); } else if (strcmp(dir, back) 0) { motorBack(); } else if (strcmp(dir, left) 0) { motorLeft(); } else if (strcmp(dir, right) 0) { motorRight(); } else if (strcmp(dir, stop) 0) { motorStop(); } else if (strcmp(dir, up) 0) { angleV min(angleV 10, 180); servoV.write(angleV); } else if (strcmp(dir, down) 0) { angleV max(angleV - 10, 0); servoV.write(angleV); } else if (strcmp(dir, camleft) 0) { angleH min(angleH 10, 180); servoH.write(angleH); } else if (strcmp(dir, camright) 0) { angleH max(angleH - 10, 0); servoH.write(angleH); } } } httpd_resp_sendstr(req, OK); return ESP_OK; } // 控制頁(yè)面 static esp_err_t indexHandler(httpd_req_t* req) { const char* html !DOCTYPE html html head meta name\viewport\ content\widthdevice-width, initial-scale1\ titleESP32 WiFi Robot/title style body{font-family:sans-serif;text-align:center;background:#222;color:#fff;} .container{max-width:600px;margin:0 auto;padding:20px;} img{width:100%;border:2px solid #555;border-radius:8px;} .btn{width:70px;height:70px;margin:6px;font-size:18px;border:none;border-radius:12px;background:#3a7afe;color:#fff;cursor:pointer;} .btn:active{background:#1d4bb8;} .row{display:flex;justify-content:center;} /style /head body div class\container\ h2ESP32 WiFi Robot/h2 img src\/stream\ id\video\ p攝像頭云臺(tái)/p div class\row\ button class\btn\ onmousedown\sendCmd(camleft)\ ontouchstart\sendCmd(camleft)\左轉(zhuǎn)云臺(tái)/button button class\btn\ onmousedown\sendCmd(up)\ ontouchstart\sendCmd(up)\抬頭/button button class\btn\ onmousedown\sendCmd(camright)\ ontouchstart\sendCmd(camright)\右轉(zhuǎn)云臺(tái)/button /div div class\row\ button class\btn\ onmousedown\sendCmd(down)\ ontouchstart\sendCmd(down)\低頭/button /div p小車(chē)運(yùn)動(dòng)/p div class\row\ button class\btn\ onmousedown\sendCmd(forward)\ ontouchstart\sendCmd(forward)\前進(jìn)/button /div div class\row\ button class\btn\ onmousedown\sendCmd(left)\ ontouchstart\sendCmd(left)\左轉(zhuǎn)/button button class\btn\ onmousedown\sendCmd(stop)\ ontouchstart\sendCmd(stop)\停止/button button class\btn\ onmousedown\sendCmd(right)\ ontouchstart\sendCmd(right)\右轉(zhuǎn)/button /div div class\row\ button class\btn\ onmousedown\sendCmd(back)\ ontouchstart\sendCmd(back)\后退/button /div /div script function sendCmd(dir){ fetch(/cmd?dir dir); } /script /body /html; httpd_resp_set_type(req, text/html); httpd_resp_sendstr(req, html); return ESP_OK; } // 啟動(dòng) HTTP Server void startServer() { httpd_config_t config HTTPD_DEFAULT_CONFIG(); httpd_handle_t server NULL; httpd_uri_t indexUri { .uri /, .method HTTP_GET, .handler indexHandler, .user_ctx NULL }; httpd_uri_t streamUri { .uri /stream, .method HTTP_GET, .handler streamHandler, .user_ctx NULL }; httpd_uri_t cmdUri { .uri /cmd, .method HTTP_GET, .handler cmdHandler, .user_ctx NULL }; if (httpd_start(server, config) ESP_OK) { httpd_register_uri_handler(server, indexUri); httpd_register_uri_handler(server, streamUri); httpd_register_uri_handler(server, cmdUri); } } // setup void setup() { Serial.begin(115200); pinMode(MOTOR_A1, OUTPUT); pinMode(MOTOR_A2, OUTPUT); pinMode(MOTOR_B1, OUTPUT); pinMode(MOTOR_B2, OUTPUT); motorStop(); servoH.attach(SERVO_HORIZONTAL); servoV.attach(SERVO_VERTICAL); servoH.write(angleH); servoV.write(angleV); startCamera(); WiFi.begin(ssid, password); while (WiFi.status() ! WL_CONNECTED) { delay(500); Serial.print(.); } Serial.println(); Serial.print(WiFi 連接成功IP 地址); Serial.println(WiFi.localIP()); startServer(); } // loop void loop() { delay(10); }5.3 代碼結(jié)構(gòu)說(shuō)明這份代碼最核心的有四個(gè)部分startCamera()初始化攝像頭配置分辨率和 JPEG 質(zhì)量streamHandler()接收瀏覽器/stream請(qǐng)求持續(xù)發(fā)送 MJPEG 幀cmdHandler()接收/cmd請(qǐng)求根據(jù)dir參數(shù)執(zhí)行電機(jī)或云臺(tái)動(dòng)作indexHandler()返回網(wǎng)頁(yè)控制界面頁(yè)面內(nèi)嵌視頻流和按鍵腳本。代碼中電機(jī)控制使用的是純電平控制沒(méi)有 PWM 調(diào)速。如果希望小車(chē)可以調(diào)節(jié)速度需要給 L298N 的 ENA、ENB 引腳接入 PWM 信號(hào)程序中使用analogWrite或者ledcWrite即可。5.4 上傳與運(yùn)行步驟燒錄代碼前按下面的流程確認(rèn)所有配置。開(kāi)發(fā)板選擇AI Thinker ESP32-CAM波特率選擇 115200手動(dòng)進(jìn)入燒錄模式點(diǎn)擊“上傳”上傳完成后按一下復(fù)位鍵讓模塊正常運(yùn)行。打開(kāi)串口監(jiān)視器可以看到 WiFi 連接成功后的 IP 地址。假設(shè) IP 是192.168.1.100在瀏覽器中訪問(wèn)http://192.168.1.100頁(yè)面就會(huì)顯示實(shí)時(shí)視頻流和所有控制按鈕。點(diǎn)擊前進(jìn)、后退、左轉(zhuǎn)、右轉(zhuǎn)、停止小車(chē)會(huì)執(zhí)行對(duì)應(yīng)動(dòng)作點(diǎn)擊云臺(tái)按鈕攝像頭的角度會(huì)隨之改變。6. 運(yùn)行驗(yàn)證與效果優(yōu)化6.1 預(yù)期效果當(dāng)系統(tǒng)正常運(yùn)行后你會(huì)在瀏覽器頁(yè)面看到視頻畫(huà)面。默認(rèn)分辨率為 VGA640x480在局域網(wǎng)環(huán)境下幀率通?？梢赃_(dá)到 10 到 15 幀左右屬于可用的遙控畫(huà)面。如果你覺(jué)得畫(huà)面卡頓可以降低分辨率為FRAMESIZE_QVGA并把 JPEG 質(zhì)量降低到 10畫(huà)面流暢度會(huì)明顯提升但細(xì)節(jié)會(huì)損失一些。6.2 優(yōu)化視頻流暢度有幾個(gè)參數(shù)會(huì)影響 ESP32-CAM 的視頻流暢度f(wàn)b_count2雙緩沖可以讓攝像頭采集和網(wǎng)絡(luò)發(fā)送并行執(zhí)行xclk_freq_hz2000000020MHz 時(shí)鐘是常用配置jpeg_quality12數(shù)值越小畫(huà)質(zhì)越好、數(shù)據(jù)量越大frame_sizeFRAMESIZE_VGA分辨率越高單幀數(shù)據(jù)量越大。在沒(méi)有 PSRAM 或者 PSRAM 未啟用的情況下分辨率過(guò)高會(huì)直接導(dǎo)致攝像頭初始化失敗。因此網(wǎng)上很多教程教你“初始化失敗就降低分辨率”這本質(zhì)上是在內(nèi)存不足時(shí)減少數(shù)據(jù)處理量的手段。6.3 控制指令的響應(yīng)問(wèn)題如果按鈕按下去之后小車(chē)沒(méi)有反應(yīng)先檢查控制指令接口是否正常。在瀏覽器地址欄直接訪問(wèn)http://192.168.1.100/cmd?dirforward看到瀏覽器顯示OK說(shuō)明 HTTP 服務(wù)執(zhí)行正常。如果小車(chē)依然不動(dòng)就要用萬(wàn)用表檢查電機(jī)驅(qū)動(dòng)模塊的輸入輸出電平確認(rèn)是代碼問(wèn)題、接線問(wèn)題還是供電問(wèn)題。7. 常見(jiàn)問(wèn)題與排查思路實(shí)踐過(guò)程中很多問(wèn)題并不是代碼寫(xiě)錯(cuò)而是硬件接線和環(huán)境配置導(dǎo)致的。下面整理幾類(lèi)高頻問(wèn)題。問(wèn)題現(xiàn)象常見(jiàn)原因解決思路攝像頭初始化失敗PSRAM 未開(kāi)啟、分辨率過(guò)高檢查開(kāi)發(fā)板是否選擇 AI Thinker ESP32-CAM降低 frame_size視頻畫(huà)面卡頓WiFi 信號(hào)弱、分辨率過(guò)高靠近路由器調(diào)低分辨率或降低 JPEG 質(zhì)量上傳固件失敗GPIO0 未拉低、串口驅(qū)動(dòng)錯(cuò)誤重新進(jìn)入燒錄模式確認(rèn)主板是否識(shí)別串口小車(chē)前進(jìn)時(shí)跑偏左右電機(jī)轉(zhuǎn)速不一致使用 PWM 調(diào)速增加電機(jī)校準(zhǔn)邏輯舵機(jī)抖動(dòng)供電不足、信號(hào)線干擾獨(dú)立給舵機(jī)供電檢查共地網(wǎng)頁(yè)能打開(kāi)但無(wú)畫(huà)面瀏覽器插件攔截視頻流使用 Edge、Chrome 最新版本關(guān)閉攔截插件刷新頁(yè)面后畫(huà)面不出現(xiàn)視頻流被多個(gè)客戶(hù)端占用同一時(shí)間盡量減少視頻流訪問(wèn)數(shù)開(kāi)發(fā)板管理器下載失敗是比較常見(jiàn)的問(wèn)題。如果提示failed to install platform: esp32:...通常是網(wǎng)絡(luò)下載中斷或者下載地址不穩(wěn)定?？梢韵葎h除%LOCALAPPDATA%\Arduino15或 Arduino IDE 安裝目錄下的packages中相關(guān)緩存文件再重新安裝如果反復(fù)失敗可以考慮使用 PlatformIO 隔離安裝或者換一個(gè)網(wǎng)絡(luò)環(huán)境重試。在小車(chē)調(diào)試過(guò)程中建議先不帶電機(jī)負(fù)載單獨(dú)測(cè)試視頻流是否正常再單獨(dú)測(cè)試電機(jī)和舵機(jī)最后合入一個(gè)完整工程。這樣可以快速定位問(wèn)題出在哪一層避免代碼和硬件問(wèn)題互相干擾。8. 最佳實(shí)踐與工程建議8.1 供電設(shè)計(jì)務(wù)必重視供電是 ESP32-CAM 機(jī)器人最常見(jiàn)的“隱形殺手”。很多開(kāi)發(fā)板剛上電正常電機(jī)一轉(zhuǎn)就重啟原因是電源瞬間跌落。正確做法是電機(jī)驅(qū)動(dòng)模塊的電源和 ESP32-CAM 的電源分開(kāi)共地即可。如果使用同一個(gè)電池組電壓較高時(shí)一定要經(jīng)過(guò)降壓模塊穩(wěn)定到 5V 再供給 ESP32-CAM。8.2 增加指令去抖和心跳機(jī)制網(wǎng)頁(yè)端按鈕按住不放時(shí)JavaScript 會(huì)不斷發(fā)送控制請(qǐng)求這可能導(dǎo)致指令風(fēng)暴讓機(jī)器人反應(yīng)遲鈍。可以在前端做節(jié)流例如每 100ms 最多發(fā)送一次控制指令。同時(shí)遙控機(jī)器人應(yīng)該有自動(dòng)停機(jī)機(jī)制例如超過(guò) 1 秒沒(méi)收到指令就執(zhí)行剎車(chē)避免網(wǎng)絡(luò)卡頓后小車(chē)失控。8.3 安全邊界涉及 GPIO 控制電機(jī)時(shí)不要在生產(chǎn)環(huán)境中隨意接錯(cuò)電源正負(fù)極也不要熱插拔電機(jī)線。實(shí)驗(yàn)過(guò)程中電池供電和 L298N 的輸出部分可能產(chǎn)生較大電流應(yīng)該使用合適的線徑供電避免線路過(guò)熱。任何機(jī)器人項(xiàng)目在正式運(yùn)行前都要做好絕緣和固定處理防止短路和機(jī)械傷人。8.4 代碼可維護(hù)性當(dāng)前示例代碼為了可讀性把電機(jī)、舵機(jī)、視頻流都放在一個(gè)文件中。真正做產(chǎn)品原型時(shí)可以按模塊拆分源文件例如motor.cpp、servo_control.cpp、video_stream.cpp。此外WiFi 密碼不要硬編碼在源碼中可以考慮通過(guò)配置頁(yè)面、EEPROM 或者 NVS 保存方便現(xiàn)場(chǎng)修改。8.5 從單機(jī)到上位機(jī)ESP32-CAM 作為一個(gè)采集端非常稱(chēng)職但如果需要圖像識(shí)別、避障導(dǎo)航、多機(jī)器人協(xié)同直接在主控上跑算法并不現(xiàn)實(shí)。下一步可以把視頻流轉(zhuǎn)發(fā)到上位機(jī)或者機(jī)器人操作系統(tǒng)例如將 ESP32 接入 micro-ROS讓它成為 ROS2 底層傳感器節(jié)點(diǎn)。這樣機(jī)器人就可以逐步具備自動(dòng)導(dǎo)航、路徑規(guī)劃等能力。9. 動(dòng)手建議與后續(xù)學(xué)習(xí)路線做一臺(tái) ESP32 WiFi 機(jī)器人的過(guò)程能串聯(lián)起嵌入式開(kāi)發(fā)、WiFi 通信、攝像頭采集、電機(jī)控制和前后端交互等多塊知識(shí)。建議不要直接跳到最后一步而是按下面的路線逐步掌握先完成 ESP32-CAM 的點(diǎn)燈和串口打印實(shí)驗(yàn)跑通官方 CameraWebServer 例程確認(rèn)視頻流穩(wěn)定單獨(dú)測(cè)試電機(jī)驅(qū)動(dòng)模塊理解正反轉(zhuǎn)和 PWM 調(diào)速單獨(dú)測(cè)試舵機(jī)云臺(tái)熟悉角度控制范圍最后把視頻流、電機(jī)、云臺(tái)、網(wǎng)頁(yè)控制整合到一起。當(dāng)你已經(jīng)掌握這套基礎(chǔ)方案后可以繼續(xù)研究 PWM 調(diào)速、雙 ESP32 分工、TCP/UDP 低延遲傳輸、電池電量檢測(cè)、自動(dòng)避障等功能。你會(huì)發(fā)現(xiàn)原本復(fù)雜的機(jī)器人系統(tǒng)其實(shí)就是由一個(gè)個(gè)小模塊組合而成的。如果你對(duì)本文的方案有自己的改進(jìn)思路或者在實(shí)際搭建中遇到和文中不同的報(bào)錯(cuò)歡迎在評(píng)論區(qū)留言我會(huì)根據(jù)常見(jiàn)的反饋繼續(xù)補(bǔ)充更細(xì)的排查記錄。 基于ESP32-CAM的WiFi遙控機(jī)器人制作全攻略
很多人在做智能小車(chē)或者機(jī)器人項(xiàng)目時(shí)第一反應(yīng)是選樹(shù)莓派或者 Jetson如果只是做一臺(tái)在室內(nèi)移動(dòng)、能回傳畫(huà)面、能遠(yuǎn)程遙控的小車(chē)使用 ESP32 系列芯片反而是性?xún)r(jià)比非常高的一條路線。ESP32-CAM 把攝像頭、WiFi、GPIO、PSRAM 集成在一塊很小的板子上配合電機(jī)驅(qū)動(dòng)模塊、云臺(tái)舵機(jī)和電池就能組成一臺(tái)“能看、能走、能轉(zhuǎn)彎”的迷你 WiFi 機(jī)器人。本文將圍繞 ESP32-CAM 的實(shí)時(shí)視頻回傳、電機(jī)運(yùn)動(dòng)控制、網(wǎng)頁(yè)遙控按鍵這三條主線完整講解從硬件選型到代碼燒錄的整個(gè)流程并把常見(jiàn)的燒錄失敗、視頻卡頓、供電不足等問(wèn)題一并梳理清楚。1. 用 ESP32 做 WiFi 機(jī)器人的價(jià)值在哪里1.1 為什么是 ESP32 而不是樹(shù)莓派樹(shù)莓派性能強(qiáng)、系統(tǒng)豐富但價(jià)格高、體積大、啟動(dòng)慢對(duì)電源要求也高。ESP32 單片機(jī)的優(yōu)勢(shì)正好相反芯片和模塊成本低開(kāi)發(fā)板幾十元就能買(mǎi)到支持 WiFi 和藍(lán)牙適合局域網(wǎng)內(nèi)做視頻流和指令傳輸可以通過(guò) Arduino IDE、PlatformIO、ESP-IDF 等方式開(kāi)發(fā)上手門(mén)檻低。對(duì)于“遙控小車(chē) 視頻回傳”這類(lèi)任務(wù)ESP32 的算力完全夠用。當(dāng)然ESP32 不適合做復(fù)雜圖像處理任務(wù)它的主要定位是采集視頻并實(shí)時(shí)傳輸至于圖像識(shí)別、避障規(guī)劃、導(dǎo)航建圖這類(lèi)算法通常放在 PC、手機(jī)或者樹(shù)莓派等上位機(jī)上完成。理解這一點(diǎn)才能在設(shè)計(jì)機(jī)器人方案時(shí)選對(duì)硬件。1.2 ESP32-CAM 在視頻傳輸中的角色ESP32-CAM 是基于 ESP32 芯片的攝像頭模塊板上集成了 OV2640 攝像頭和 PSRAM。PSRAMPseudo-SRAM用于緩存圖像數(shù)據(jù)這對(duì)視頻采集非常關(guān)鍵因?yàn)樗茏?ESP32-CAM 在低分辨率下流暢采集 JPEG 幀。實(shí)際使用中可以通過(guò) HTTP 的 MJPEG 流把畫(huà)面持續(xù)推送到瀏覽器手機(jī)、平板、電腦打開(kāi)一個(gè)網(wǎng)頁(yè)就能實(shí)時(shí)查看。它的工作流程可以簡(jiǎn)單理解成攝像頭采集圖像內(nèi)部轉(zhuǎn)換成 JPEG 格式ESP32 通過(guò) WiFi 建立 HTTP Server瀏覽器訪問(wèn)視頻流地址后服務(wù)器不斷發(fā)送 multipart 格式的 JPEG 幀瀏覽器逐幀刷新顯示形成流暢的視頻畫(huà)面。因此ESP32-CAM 非常適合做“第一視角”回傳設(shè)備例如小型機(jī)器人、管道探測(cè)、桌底床底巡查、室內(nèi)安防小車(chē)等。1.3 完整功能定位這篇文章要做的系統(tǒng)包含三大部分視頻回傳ESP32-CAM 開(kāi)啟局域網(wǎng)視頻流運(yùn)動(dòng)控制通過(guò)網(wǎng)頁(yè)按鈕控制左右電機(jī)的前進(jìn)、后退、轉(zhuǎn)向、停止云臺(tái)控制使用舵機(jī)帶動(dòng)攝像頭上下左右轉(zhuǎn)動(dòng)擴(kuò)大視野范圍。整體架構(gòu)比較簡(jiǎn)潔使用一塊 ESP32-CAM 作為主控L298N 或者 TB6612 電機(jī)驅(qū)動(dòng)模塊驅(qū)動(dòng)直流減速電機(jī)舵機(jī)云臺(tái)負(fù)責(zé)攝像頭角度調(diào)整。所有控制指令通過(guò) WiFi 傳輸不需要搭服務(wù)器也不依賴(lài)云平臺(tái)在局域網(wǎng)內(nèi)即可完成所有功能。2. 硬件選型與整車(chē)接線2.1 核心硬件清單下面是搭建這臺(tái)迷你 WiFi 機(jī)器人需要準(zhǔn)備的主要硬件硬件作用選購(gòu)建議ESP32-CAM 開(kāi)發(fā)板主控 攝像頭 WiFi優(yōu)先選擇帶底座的版本方便燒錄OV2640 攝像頭視頻采集ESP32-CAM 板載自帶L298N 驅(qū)動(dòng)模塊驅(qū)動(dòng)直流電機(jī)也可以用 TB6612、DRV8833直流減速電機(jī) × 2小車(chē)動(dòng)力3V~6V 工作電壓的 N20 或 TT 電機(jī)小車(chē)底盤(pán)承載電機(jī)和電路亞克力底盤(pán)或者 3D 打印底盤(pán)都可舵機(jī)云臺(tái) × 2控制攝像頭上下左右轉(zhuǎn)動(dòng)SG90 舵機(jī)即可18650 電池座或鋰電池組供電需要滿(mǎn)足 ESP32-CAM 和電機(jī)驅(qū)動(dòng)模塊的電壓需求降壓模塊穩(wěn)定供電給 ESP32-CAM例如 DC-DC 降壓模塊或 AMS1117杜邦線、螺絲、銅柱結(jié)構(gòu)固定常規(guī)必備需要注意的是不同商家的 ESP32-CAM 模塊引腳定義可能略有不同購(gòu)買(mǎi)時(shí)盡量讓商家提供官方引腳圖或者原理圖避免接線后引腳不生效。2.2 供電方案設(shè)計(jì)供電是這類(lèi)小車(chē)最容易出問(wèn)題的地方。L298N 驅(qū)動(dòng)模塊帶有一個(gè)板載 5V 穩(wěn)壓輸出但它的帶載能力有限。如果直接把 L298N 的 5V 輸出送給 ESP32-CAM在攝像頭啟動(dòng)和舵機(jī)轉(zhuǎn)動(dòng)瞬間可能導(dǎo)致電壓跌落引發(fā)開(kāi)發(fā)板重啟。更穩(wěn)妥的方式是電氣上分成兩級(jí)電機(jī)電源由電池組直接給 L298N 的電機(jī)會(huì)供電邏輯電源由單獨(dú)的降壓模塊輸出 5V 給 ESP32-CAM 和舵機(jī)供電共地處理把電池負(fù)極、L298N 的 GND、ESP32-CAM 的 GND 連接在一起保證信號(hào)電平一致。在實(shí)際搭建中很多人直接使用充電寶給 ESP32-CAM 供電電池組給電機(jī)供電這樣也能運(yùn)行但必須把兩路電源的負(fù)極接到一起否則 GPIO 控制信號(hào)無(wú)法形成回路。2.3 接線參考下面給出一個(gè)常見(jiàn)的接線方案先不要照抄引腳請(qǐng)以你自己開(kāi)發(fā)板絲印為準(zhǔn)L298N 的 IN1、IN2 接 ESP32-CAM 的 GPIO12、GPIO13L298N 的 IN3、IN4 接 ESP32-CAM 的 GPIO14、GPIO15L298N 電機(jī)輸出 A 接左電機(jī)電機(jī)輸出 B 接右電機(jī)水平舵機(jī)信號(hào)線接 GPIO4垂直舵機(jī)信號(hào)線接 GPIO2。如果你手里的卡板引出腳有限可以把電機(jī)引腳和舵機(jī)引腳重新規(guī)劃只要避開(kāi)攝像頭占用的引腳即可。3. 開(kāi)發(fā)環(huán)境搭建與 ESP32 燒錄基礎(chǔ)3.1 安裝 Arduino IDEArduino IDE 是目前 ESP32 開(kāi)發(fā)最直接的入口新手推薦從 Arduino IDE 2.x 開(kāi)始。下載安裝完成后打開(kāi)“開(kāi)發(fā)板管理器”搜索 ESP32安裝 Espressif 官方提供的 esp32 開(kāi)發(fā)板包。如果開(kāi)發(fā)板管理器中沒(méi)有 ESP32可以在“文件 - 首選項(xiàng) - 附加開(kāi)發(fā)板管理器網(wǎng)址”中添加官方 JSON 地址https://espressif.github.io/arduino-esp32/package_esp32_index.json添加后重新打開(kāi)開(kāi)發(fā)板管理器搜索esp32即可。安裝時(shí)間取決于網(wǎng)絡(luò)環(huán)境如果下載慢可以在晚上網(wǎng)絡(luò)空閑時(shí)重試。3.2 燒錄模式與常見(jiàn)問(wèn)題ESP32-CAM 模塊和普通開(kāi)發(fā)板不同很多版本沒(méi)有自動(dòng)下載電路需要手動(dòng)控制 GPIO0 的電平進(jìn)入下載模式。使用方法如下按住模塊上的 IO0/BOOT 按鍵點(diǎn)擊復(fù)位按鍵先松開(kāi)復(fù)位按鍵再松開(kāi) IO0/BOOT 按鍵此時(shí)模塊進(jìn)入燒錄模式可以在 Arduino IDE 中點(diǎn)擊上傳。如果燒錄時(shí)報(bào)錯(cuò)Failed to connect to ESP32多半是 GPIO0 沒(méi)有拉低或者串口驅(qū)動(dòng)沒(méi)有安裝?？梢韵葯z查設(shè)備管理器中是否認(rèn)出了 USB 轉(zhuǎn)串口芯片常見(jiàn)的芯片為 CH340G 或 CP2102。3.3 開(kāi)發(fā)板選擇在 Arduino IDE 開(kāi)發(fā)板列表中選擇AI Thinker ESP32-CAM這是比較通用的型號(hào)。如果你的攝像頭模塊是其他廠商生產(chǎn)的請(qǐng)?jiān)凇捌渌?ESP32 開(kāi)發(fā)板”中選擇合適型號(hào)或者直接選擇ESP32 Dev Module然后在配置中手動(dòng)設(shè)置 PSRAM 為啟用狀態(tài)。這里有一個(gè)容易踩坑的地方如果選擇的開(kāi)發(fā)板類(lèi)型沒(méi)有正確啟用 PSRAM攝像頭初始化會(huì)失敗視頻流無(wú)法啟動(dòng)。出現(xiàn)Camera init failed with error ...時(shí)優(yōu)先檢查開(kāi)發(fā)板類(lèi)型和 PSRAM 設(shè)置。4. 核心原理拆解視頻流、控制指令與網(wǎng)頁(yè)交互4.1 MJPEG 視頻流原理MJPEG 并不是一種嚴(yán)格的視頻編碼它本質(zhì)上是把連續(xù)的 JPEG 圖片一張接一張發(fā)送給瀏覽器。ESP32-CAM 使用esp_http_server庫(kù)建立 HTTP Server當(dāng)瀏覽器請(qǐng)求/stream時(shí)服務(wù)器不斷發(fā)送這樣的數(shù)據(jù)--frame Content-Type: image/jpeg Content-Length: 12345 JPEG 二進(jìn)制數(shù)據(jù) --frame Content-Type: image/jpeg Content-Length: 12345 JPEG 二進(jìn)制數(shù)據(jù)瀏覽器收到這種multipart/x-mixed-replace格式的響應(yīng)后會(huì)不斷用新幀替換舊幀用戶(hù)看到的效果就是“視頻”。這種做法實(shí)現(xiàn)簡(jiǎn)單兼容性好而且對(duì) ESP32 的 CPU 壓力較小。4.2 電機(jī)控制原理直流減速電機(jī)本身不需要復(fù)雜協(xié)議通過(guò)電機(jī)驅(qū)動(dòng)模塊把 GPIO 的高低電平轉(zhuǎn)換成電機(jī)的正反轉(zhuǎn)即可。以 L298N 為例IN1 和 IN2 控制一側(cè)電機(jī)IN1 高、IN2 低電機(jī)正轉(zhuǎn)IN1 低、IN2 高電機(jī)反轉(zhuǎn)IN1 和 IN2 同高或同低電機(jī)停止。左右兩路電機(jī)單獨(dú)控制就能實(shí)現(xiàn)前進(jìn)、后退、左轉(zhuǎn)、右轉(zhuǎn)。左轉(zhuǎn)時(shí)可以讓左側(cè)電機(jī)反轉(zhuǎn)、右側(cè)電機(jī)正轉(zhuǎn)實(shí)現(xiàn)差速原地轉(zhuǎn)向也可以讓左側(cè)電機(jī)停止、右側(cè)電機(jī)正轉(zhuǎn)這樣轉(zhuǎn)向半徑更大。4.3 控制指令協(xié)議設(shè)計(jì)為了讓網(wǎng)頁(yè)端的按鈕操作和機(jī)器人端代碼保持簡(jiǎn)潔本文使用一個(gè)/cmd接口通過(guò) URL 參數(shù)傳遞控制指令。例如http://192.168.1.100/cmd?dirforwardhttp://192.168.1.100/cmd?dirbackhttp://192.168.1.100/cmd?dirlefthttp://192.168.1.100/cmd?dirrighthttp://192.168.1.100/cmd?dirstophttp://192.168.1.100/cmd?diruphttp://192.168.1.100/cmd?dirdown網(wǎng)頁(yè)端通過(guò) JavaScript 的fetch發(fā)送請(qǐng)求每按下一個(gè)按鈕機(jī)器人就會(huì)執(zhí)行對(duì)應(yīng)的動(dòng)作。實(shí)際項(xiàng)目中你可能需要增加指令節(jié)流、狀態(tài)反饋、心跳檢測(cè)等機(jī)制避免指令丟失。5. 完整實(shí)戰(zhàn)案例搭建一個(gè)可遙控的 ESP32 WiFi 機(jī)器人下面進(jìn)入核心環(huán)節(jié)。我們使用 Arduino IDE 編寫(xiě)一個(gè)完整可運(yùn)行的代碼代碼同時(shí)實(shí)現(xiàn)視頻流、電機(jī)控制和舵機(jī)云臺(tái)控制。5.1 創(chuàng)建項(xiàng)目文件在 Arduino IDE 中新建項(xiàng)目命名esp32_wifi_robot。項(xiàng)目目錄如下esp32_wifi_robot/ └── esp32_wifi_robot.ino5.2 完整代碼下面的代碼是一個(gè)完整的.ino文件。配置 WiFi 部分時(shí)請(qǐng)把示例中的YourWiFi和YourPassword替換成你自己的網(wǎng)絡(luò)信息。// 文件路徑esp32_wifi_robot/esp32_wifi_robot.ino #include WiFi.h #include esp_camera.h #include esp_http_server.h #include ESP32Servo.h // WiFi 配置 const char* ssid YourWiFi; const char* password YourPassword; // 電機(jī)引腳 #define MOTOR_A1 12 #define MOTOR_A2 13 #define MOTOR_B1 14 #define MOTOR_B2 15 // 舵機(jī)引腳 #define SERVO_HORIZONTAL 4 #define SERVO_VERTICAL 2 // 云臺(tái)變量 Servo servoH; Servo servoV; int angleH 90; int angleV 90; // 攝像頭引腳定義 #define PWDN_GPIO_NUM 32 #define RESET_GPIO_NUM -1 #define XCLK_GPIO_NUM 0 #define SIOD_GPIO_NUM 26 #define SIOC_GPIO_NUM 27 #define Y9_GPIO_NUM 35 #define Y8_GPIO_NUM 34 #define Y7_GPIO_NUM 39 #define Y6_GPIO_NUM 36 #define Y5_GPIO_NUM 21 #define Y4_GPIO_NUM 19 #define Y3_GPIO_NUM 18 #define Y2_GPIO_NUM 5 #define VSYNC_GPIO_NUM 25 #define HREF_GPIO_NUM 23 #define PCLK_GPIO_NUM 22 // 電機(jī)控制函數(shù) void motorStop() { digitalWrite(MOTOR_A1, LOW); digitalWrite(MOTOR_A2, LOW); digitalWrite(MOTOR_B1, LOW); digitalWrite(MOTOR_B2, LOW); } void motorForward() { digitalWrite(MOTOR_A1, HIGH); digitalWrite(MOTOR_A2, LOW); digitalWrite(MOTOR_B1, HIGH); digitalWrite(MOTOR_B2, LOW); } void motorBack() { digitalWrite(MOTOR_A1, LOW); digitalWrite(MOTOR_A2, HIGH); digitalWrite(MOTOR_B1, LOW); digitalWrite(MOTOR_B2, HIGH); } void motorLeft() { digitalWrite(MOTOR_A1, LOW); digitalWrite(MOTOR_A2, HIGH); digitalWrite(MOTOR_B1, HIGH); digitalWrite(MOTOR_B2, LOW); } void motorRight() { digitalWrite(MOTOR_A1, HIGH); digitalWrite(MOTOR_A2, LOW); digitalWrite(MOTOR_B1, LOW); digitalWrite(MOTOR_B2, HIGH); } // 攝像頭初始化 void startCamera() { camera_config_t config; config.ledc_channel LEDC_CHANNEL_0; config.ledc_timer LEDC_TIMER_0; config.pin_d0 Y2_GPIO_NUM; config.pin_d1 Y3_GPIO_NUM; config.pin_d2 Y4_GPIO_NUM; config.pin_d3 Y5_GPIO_NUM; config.pin_d4 Y6_GPIO_NUM; config.pin_d5 Y7_GPIO_NUM; config.pin_d6 Y8_GPIO_NUM; config.pin_d7 Y9_GPIO_NUM; config.pin_xclk XCLK_GPIO_NUM; config.pin_pclk PCLK_GPIO_NUM; config.pin_vsync VSYNC_GPIO_NUM; config.pin_href HREF_GPIO_NUM; config.pin_sccb_sda SIOD_GPIO_NUM; config.pin_sccb_scl SIOC_GPIO_NUM; config.pin_pwdn PWDN_GPIO_NUM; config.pin_reset RESET_GPIO_NUM; config.xclk_freq_hz 20000000; config.pixel_format PIXFORMAT_JPEG; // 選擇合適分辨率和質(zhì)量 config.frame_size FRAMESIZE_VGA; config.jpeg_quality 12; config.fb_count 2; esp_err_t err esp_camera_init(config); if (err ! ESP_OK) { Serial.printf(攝像頭初始化失敗錯(cuò)誤碼 0x%x\n, err); return; } } // 視頻流回調(diào) static esp_err_t streamHandler(httpd_req_t* req) { camera_fb_t* fb NULL; esp_err_t res ESP_OK; char partBuf[64]; res httpd_resp_set_type(req, multipart/x-mixed-replace; boundaryframe); if (res ! ESP_OK) { return res; } while (true) { fb esp_camera_fb_get(); if (!fb) { res ESP_FAIL; break; } size_t jpgBufLen fb-len; uint8_t* jpgBuf fb-buf; if (fb-format ! PIXFORMAT_JPEG) { bool converted frame2jpg(fb, 80, jpgBuf, jpgBufLen); esp_camera_fb_return(fb); if (!converted) { res ESP_FAIL; break; } } int hLen snprintf(partBuf, sizeof(partBuf), --frame\r\nContent-Type: image/jpeg\r\nContent-Length: %u\r\n\r\n, jpgBufLen); httpd_resp_send_chunk(req, partBuf, hLen); httpd_resp_send_chunk(req, (const char*)jpgBuf, jpgBufLen); httpd_resp_send_chunk(req, \r\n, 2); if (fb-format PIXFORMAT_JPEG) { esp_camera_fb_return(fb); } } return res; } // 控制指令回調(diào) static esp_err_t cmdHandler(httpd_req_t* req) { char buf[128]; char dir[16] {0}; if (httpd_req_get_url_query_str(req, buf, sizeof(buf)) ESP_OK) { if (httpd_query_key_value(buf, dir, dir, sizeof(dir)) ESP_OK) { if (strcmp(dir, forward) 0) { motorForward(); } else if (strcmp(dir, back) 0) { motorBack(); } else if (strcmp(dir, left) 0) { motorLeft(); } else if (strcmp(dir, right) 0) { motorRight(); } else if (strcmp(dir, stop) 0) { motorStop(); } else if (strcmp(dir, up) 0) { angleV min(angleV 10, 180); servoV.write(angleV); } else if (strcmp(dir, down) 0) { angleV max(angleV - 10, 0); servoV.write(angleV); } else if (strcmp(dir, camleft) 0) { angleH min(angleH 10, 180); servoH.write(angleH); } else if (strcmp(dir, camright) 0) { angleH max(angleH - 10, 0); servoH.write(angleH); } } } httpd_resp_sendstr(req, OK); return ESP_OK; } // 控制頁(yè)面 static esp_err_t indexHandler(httpd_req_t* req) { const char* html !DOCTYPE html html head meta name\viewport\ content\widthdevice-width, initial-scale1\ titleESP32 WiFi Robot/title style body{font-family:sans-serif;text-align:center;background:#222;color:#fff;} .container{max-width:600px;margin:0 auto;padding:20px;} img{width:100%;border:2px solid #555;border-radius:8px;} .btn{width:70px;height:70px;margin:6px;font-size:18px;border:none;border-radius:12px;background:#3a7afe;color:#fff;cursor:pointer;} .btn:active{background:#1d4bb8;} .row{display:flex;justify-content:center;} /style /head body div class\container\ h2ESP32 WiFi Robot/h2 img src\/stream\ id\video\ p攝像頭云臺(tái)/p div class\row\ button class\btn\ onmousedown\sendCmd(camleft)\ ontouchstart\sendCmd(camleft)\左轉(zhuǎn)云臺(tái)/button button class\btn\ onmousedown\sendCmd(up)\ ontouchstart\sendCmd(up)\抬頭/button button class\btn\ onmousedown\sendCmd(camright)\ ontouchstart\sendCmd(camright)\右轉(zhuǎn)云臺(tái)/button /div div class\row\ button class\btn\ onmousedown\sendCmd(down)\ ontouchstart\sendCmd(down)\低頭/button /div p小車(chē)運(yùn)動(dòng)/p div class\row\ button class\btn\ onmousedown\sendCmd(forward)\ ontouchstart\sendCmd(forward)\前進(jìn)/button /div div class\row\ button class\btn\ onmousedown\sendCmd(left)\ ontouchstart\sendCmd(left)\左轉(zhuǎn)/button button class\btn\ onmousedown\sendCmd(stop)\ ontouchstart\sendCmd(stop)\停止/button button class\btn\ onmousedown\sendCmd(right)\ ontouchstart\sendCmd(right)\右轉(zhuǎn)/button /div div class\row\ button class\btn\ onmousedown\sendCmd(back)\ ontouchstart\sendCmd(back)\后退/button /div /div script function sendCmd(dir){ fetch(/cmd?dir dir); } /script /body /html; httpd_resp_set_type(req, text/html); httpd_resp_sendstr(req, html); return ESP_OK; } // 啟動(dòng) HTTP Server void startServer() { httpd_config_t config HTTPD_DEFAULT_CONFIG(); httpd_handle_t server NULL; httpd_uri_t indexUri { .uri /, .method HTTP_GET, .handler indexHandler, .user_ctx NULL }; httpd_uri_t streamUri { .uri /stream, .method HTTP_GET, .handler streamHandler, .user_ctx NULL }; httpd_uri_t cmdUri { .uri /cmd, .method HTTP_GET, .handler cmdHandler, .user_ctx NULL }; if (httpd_start(server, config) ESP_OK) { httpd_register_uri_handler(server, indexUri); httpd_register_uri_handler(server, streamUri); httpd_register_uri_handler(server, cmdUri); } } // setup void setup() { Serial.begin(115200); pinMode(MOTOR_A1, OUTPUT); pinMode(MOTOR_A2, OUTPUT); pinMode(MOTOR_B1, OUTPUT); pinMode(MOTOR_B2, OUTPUT); motorStop(); servoH.attach(SERVO_HORIZONTAL); servoV.attach(SERVO_VERTICAL); servoH.write(angleH); servoV.write(angleV); startCamera(); WiFi.begin(ssid, password); while (WiFi.status() ! WL_CONNECTED) { delay(500); Serial.print(.); } Serial.println(); Serial.print(WiFi 連接成功IP 地址); Serial.println(WiFi.localIP()); startServer(); } // loop void loop() { delay(10); }5.3 代碼結(jié)構(gòu)說(shuō)明這份代碼最核心的有四個(gè)部分startCamera()初始化攝像頭配置分辨率和 JPEG 質(zhì)量streamHandler()接收瀏覽器/stream請(qǐng)求持續(xù)發(fā)送 MJPEG 幀cmdHandler()接收/cmd請(qǐng)求根據(jù)dir參數(shù)執(zhí)行電機(jī)或云臺(tái)動(dòng)作indexHandler()返回網(wǎng)頁(yè)控制界面頁(yè)面內(nèi)嵌視頻流和按鍵腳本。代碼中電機(jī)控制使用的是純電平控制沒(méi)有 PWM 調(diào)速。如果希望小車(chē)可以調(diào)節(jié)速度需要給 L298N 的 ENA、ENB 引腳接入 PWM 信號(hào)程序中使用analogWrite或者ledcWrite即可。5.4 上傳與運(yùn)行步驟燒錄代碼前按下面的流程確認(rèn)所有配置。開(kāi)發(fā)板選擇AI Thinker ESP32-CAM波特率選擇 115200手動(dòng)進(jìn)入燒錄模式點(diǎn)擊“上傳”上傳完成后按一下復(fù)位鍵讓模塊正常運(yùn)行。打開(kāi)串口監(jiān)視器可以看到 WiFi 連接成功后的 IP 地址。假設(shè) IP 是192.168.1.100在瀏覽器中訪問(wèn)http://192.168.1.100頁(yè)面就會(huì)顯示實(shí)時(shí)視頻流和所有控制按鈕。點(diǎn)擊前進(jìn)、后退、左轉(zhuǎn)、右轉(zhuǎn)、停止小車(chē)會(huì)執(zhí)行對(duì)應(yīng)動(dòng)作點(diǎn)擊云臺(tái)按鈕攝像頭的角度會(huì)隨之改變。6. 運(yùn)行驗(yàn)證與效果優(yōu)化6.1 預(yù)期效果當(dāng)系統(tǒng)正常運(yùn)行后你會(huì)在瀏覽器頁(yè)面看到視頻畫(huà)面。默認(rèn)分辨率為 VGA640x480在局域網(wǎng)環(huán)境下幀率通?？梢赃_(dá)到 10 到 15 幀左右屬于可用的遙控畫(huà)面。如果你覺(jué)得畫(huà)面卡頓可以降低分辨率為FRAMESIZE_QVGA并把 JPEG 質(zhì)量降低到 10畫(huà)面流暢度會(huì)明顯提升但細(xì)節(jié)會(huì)損失一些。6.2 優(yōu)化視頻流暢度有幾個(gè)參數(shù)會(huì)影響 ESP32-CAM 的視頻流暢度f(wàn)b_count2雙緩沖可以讓攝像頭采集和網(wǎng)絡(luò)發(fā)送并行執(zhí)行xclk_freq_hz2000000020MHz 時(shí)鐘是常用配置jpeg_quality12數(shù)值越小畫(huà)質(zhì)越好、數(shù)據(jù)量越大frame_sizeFRAMESIZE_VGA分辨率越高單幀數(shù)據(jù)量越大。在沒(méi)有 PSRAM 或者 PSRAM 未啟用的情況下分辨率過(guò)高會(huì)直接導(dǎo)致攝像頭初始化失敗。因此網(wǎng)上很多教程教你“初始化失敗就降低分辨率”這本質(zhì)上是在內(nèi)存不足時(shí)減少數(shù)據(jù)處理量的手段。6.3 控制指令的響應(yīng)問(wèn)題如果按鈕按下去之后小車(chē)沒(méi)有反應(yīng)先檢查控制指令接口是否正常。在瀏覽器地址欄直接訪問(wèn)http://192.168.1.100/cmd?dirforward看到瀏覽器顯示OK說(shuō)明 HTTP 服務(wù)執(zhí)行正常。如果小車(chē)依然不動(dòng)就要用萬(wàn)用表檢查電機(jī)驅(qū)動(dòng)模塊的輸入輸出電平確認(rèn)是代碼問(wèn)題、接線問(wèn)題還是供電問(wèn)題。7. 常見(jiàn)問(wèn)題與排查思路實(shí)踐過(guò)程中很多問(wèn)題并不是代碼寫(xiě)錯(cuò)而是硬件接線和環(huán)境配置導(dǎo)致的。下面整理幾類(lèi)高頻問(wèn)題。問(wèn)題現(xiàn)象常見(jiàn)原因解決思路攝像頭初始化失敗PSRAM 未開(kāi)啟、分辨率過(guò)高檢查開(kāi)發(fā)板是否選擇 AI Thinker ESP32-CAM降低 frame_size視頻畫(huà)面卡頓WiFi 信號(hào)弱、分辨率過(guò)高靠近路由器調(diào)低分辨率或降低 JPEG 質(zhì)量上傳固件失敗GPIO0 未拉低、串口驅(qū)動(dòng)錯(cuò)誤重新進(jìn)入燒錄模式確認(rèn)主板是否識(shí)別串口小車(chē)前進(jìn)時(shí)跑偏左右電機(jī)轉(zhuǎn)速不一致使用 PWM 調(diào)速增加電機(jī)校準(zhǔn)邏輯舵機(jī)抖動(dòng)供電不足、信號(hào)線干擾獨(dú)立給舵機(jī)供電檢查共地網(wǎng)頁(yè)能打開(kāi)但無(wú)畫(huà)面瀏覽器插件攔截視頻流使用 Edge、Chrome 最新版本關(guān)閉攔截插件刷新頁(yè)面后畫(huà)面不出現(xiàn)視頻流被多個(gè)客戶(hù)端占用同一時(shí)間盡量減少視頻流訪問(wèn)數(shù)開(kāi)發(fā)板管理器下載失敗是比較常見(jiàn)的問(wèn)題。如果提示failed to install platform: esp32:...通常是網(wǎng)絡(luò)下載中斷或者下載地址不穩(wěn)定?？梢韵葎h除%LOCALAPPDATA%\Arduino15或 Arduino IDE 安裝目錄下的packages中相關(guān)緩存文件再重新安裝如果反復(fù)失敗可以考慮使用 PlatformIO 隔離安裝或者換一個(gè)網(wǎng)絡(luò)環(huán)境重試。在小車(chē)調(diào)試過(guò)程中建議先不帶電機(jī)負(fù)載單獨(dú)測(cè)試視頻流是否正常再單獨(dú)測(cè)試電機(jī)和舵機(jī)最后合入一個(gè)完整工程。這樣可以快速定位問(wèn)題出在哪一層避免代碼和硬件問(wèn)題互相干擾。8. 最佳實(shí)踐與工程建議8.1 供電設(shè)計(jì)務(wù)必重視供電是 ESP32-CAM 機(jī)器人最常見(jiàn)的“隱形殺手”。很多開(kāi)發(fā)板剛上電正常電機(jī)一轉(zhuǎn)就重啟原因是電源瞬間跌落。正確做法是電機(jī)驅(qū)動(dòng)模塊的電源和 ESP32-CAM 的電源分開(kāi)共地即可。如果使用同一個(gè)電池組電壓較高時(shí)一定要經(jīng)過(guò)降壓模塊穩(wěn)定到 5V 再供給 ESP32-CAM。8.2 增加指令去抖和心跳機(jī)制網(wǎng)頁(yè)端按鈕按住不放時(shí)JavaScript 會(huì)不斷發(fā)送控制請(qǐng)求這可能導(dǎo)致指令風(fēng)暴讓機(jī)器人反應(yīng)遲鈍。可以在前端做節(jié)流例如每 100ms 最多發(fā)送一次控制指令。同時(shí)遙控機(jī)器人應(yīng)該有自動(dòng)停機(jī)機(jī)制例如超過(guò) 1 秒沒(méi)收到指令就執(zhí)行剎車(chē)避免網(wǎng)絡(luò)卡頓后小車(chē)失控。8.3 安全邊界涉及 GPIO 控制電機(jī)時(shí)不要在生產(chǎn)環(huán)境中隨意接錯(cuò)電源正負(fù)極也不要熱插拔電機(jī)線。實(shí)驗(yàn)過(guò)程中電池供電和 L298N 的輸出部分可能產(chǎn)生較大電流應(yīng)該使用合適的線徑供電避免線路過(guò)熱。任何機(jī)器人項(xiàng)目在正式運(yùn)行前都要做好絕緣和固定處理防止短路和機(jī)械傷人。8.4 代碼可維護(hù)性當(dāng)前示例代碼為了可讀性把電機(jī)、舵機(jī)、視頻流都放在一個(gè)文件中。真正做產(chǎn)品原型時(shí)可以按模塊拆分源文件例如motor.cpp、servo_control.cpp、video_stream.cpp。此外WiFi 密碼不要硬編碼在源碼中可以考慮通過(guò)配置頁(yè)面、EEPROM 或者 NVS 保存方便現(xiàn)場(chǎng)修改。8.5 從單機(jī)到上位機(jī)ESP32-CAM 作為一個(gè)采集端非常稱(chēng)職但如果需要圖像識(shí)別、避障導(dǎo)航、多機(jī)器人協(xié)同直接在主控上跑算法并不現(xiàn)實(shí)。下一步可以把視頻流轉(zhuǎn)發(fā)到上位機(jī)或者機(jī)器人操作系統(tǒng)例如將 ESP32 接入 micro-ROS讓它成為 ROS2 底層傳感器節(jié)點(diǎn)。這樣機(jī)器人就可以逐步具備自動(dòng)導(dǎo)航、路徑規(guī)劃等能力。9. 動(dòng)手建議與后續(xù)學(xué)習(xí)路線做一臺(tái) ESP32 WiFi 機(jī)器人的過(guò)程能串聯(lián)起嵌入式開(kāi)發(fā)、WiFi 通信、攝像頭采集、電機(jī)控制和前后端交互等多塊知識(shí)。建議不要直接跳到最后一步而是按下面的路線逐步掌握先完成 ESP32-CAM 的點(diǎn)燈和串口打印實(shí)驗(yàn)跑通官方 CameraWebServer 例程確認(rèn)視頻流穩(wěn)定單獨(dú)測(cè)試電機(jī)驅(qū)動(dòng)模塊理解正反轉(zhuǎn)和 PWM 調(diào)速單獨(dú)測(cè)試舵機(jī)云臺(tái)熟悉角度控制范圍最后把視頻流、電機(jī)、云臺(tái)、網(wǎng)頁(yè)控制整合到一起。當(dāng)你已經(jīng)掌握這套基礎(chǔ)方案后可以繼續(xù)研究 PWM 調(diào)速、雙 ESP32 分工、TCP/UDP 低延遲傳輸、電池電量檢測(cè)、自動(dòng)避障等功能。你會(huì)發(fā)現(xiàn)原本復(fù)雜的機(jī)器人系統(tǒng)其實(shí)就是由一個(gè)個(gè)小模塊組合而成的。如果你對(duì)本文的方案有自己的改進(jìn)思路或者在實(shí)際搭建中遇到和文中不同的報(bào)錯(cuò)歡迎在評(píng)論區(qū)留言我會(huì)根據(jù)常見(jiàn)的反饋繼續(xù)補(bǔ)充更細(xì)的排查記錄。