ESP32-NanoCam 串列 AT 協定手冊

淘寶店鋪

波特率：115200 | 數據位：8 | 校驗：無 | 停止位：1 | 流控：無 兼容主流攝影機模組 AT 指令集，新增 NanoCam 擴充指令。

---

一、通用規則

• 指令大小寫不敏感（STA_SSID = sta_ssid）
• 指令後需跟任意英文標點（, . : ; 等）作為結束符
• 部分指令修改後會自動重啟
• 每條指令以 \r\n 結尾（串列埠助手通常會自動加入）

二、WiFi 設定

STA 模式（連接路由器）

指令	說明	示例	返回值
sta_ssid:名稱	設定 WiFi 名稱	sta_ssid:MyWiFi	OK
sta_pd:密碼	設定 WiFi 密碼（修改後重啟）	sta_pd:12345678	OK（重啟）

WiFi 名稱和密碼最長 30 個字元，不支援中文。

AP 模式（內建熱點）

指令	說明	示例	返回值
ap_ssid:名稱	設定熱點名稱	ap_ssid:NanoCam-AP	OK
ap_pd:密碼	設定熱點密碼（修改後重啟）	ap_pd:12345678	OK（重啟）

WiFi 模式

指令	說明	參數	返回值
wifi_mode:X	切換模式	0=AP 1=STA 2=AP+STA	OK（變更時重啟）

---

三、AI 模式切換

指令	模式	說明	重啟
ai_mode:0	正常	MJPEG 圖傳，無 AI	✅
ai_mode:1	貓臉偵測	實時貓臉畫框 + 置信度	✅
ai_mode:2	人臉偵測	實時人臉畫框 + 座標	✅
ai_mode:3	顏色辨識	框選錄入→實時偵測	✅
ai_mode:4	人臉辨識	註冊→辨認→刪除	✅
ai_mode:5	二維條碼	實時解碼→串列輸出	✅
ai_mode:6	LLM 智能體	XiaoZhi AI 語音對話 + AI 視覺	✅
ai_mode:7	ESP-Claw	語音控制 + 拍照視覺分析 + OpenAI Vision	✅

ai_mode 有效值：0-7。超出範圍預設變為 0。修改後自動重啟，重啟後新模式生效。

---

四、資訊查詢

指令	說明	返回值示例
sta_ip	查詢 STA IP	sta_ip:192.168.1.100
ap_ip	查詢 AP IP	ap_ip:192.168.4.1
wifi_ver	查詢固件版本	NanoCam Board Ver:0.2.0

---

五、系統控制

指令	說明	返回值
wifi_reset	回復原廠設定（重啟）	Reset_OK
nano_reboot	軟復位	Rebooting...
nano_info	完整裝置資訊（JSON）	見下方

nano_info 返回示例

{
  "device": "NanoCam",
  "ver": "0.2.0",
  "chip": "ESP32-S3",
  "flash": "16MB",
  "psram": "8MB",
  "ai_mode": 1,
  "wifi_mode": 2,
  "sta_ip": "192.168.1.100",
  "free_heap": 245760
}

---

六、人臉辨識專用指令

僅在 ai_mode:4（人臉辨識模式）下有效。

指令	說明	標籤行為	返回示例
face_eril	註冊當前畫面中偵測到的人臉	藍色「Enroll: ID N」，閃現 0.5s	>>> face enroll triggered
face_rz	進入持續人臉辨識模式	綠色「ID: N」/ 紅色「who?」，持續顯示不消失	>>> face recognize triggered
face_del	刪除最後註冊的人臉 ID	紅色「N IDs left」，閃現 0.5s	>>> face delete triggered
face_detect	退出辨識模式，返回純人臉偵測	清除所有標籤	>>> face detect mode

人臉辨識操作流程

ai_mode:4          # 進入人臉辨識模式 (裝置自動重啟)
face_eril          # 註冊人臉 (確保只有一張臉在畫面中)
face_rz            # 開始持續辨識 — 標籤持續顯示不消失
face_detect        # 退出辨識模式 — 標籤清除
face_del           # 刪除最後註冊的人臉

人臉辨識注意事項

1. 註冊時需確保畫面中只有一張人臉，距離 30-50cm
2. 辨識模式（face_rz）下標籤持續顯示，不會 0.5 秒消失——這是 0.3.0 的新行為
3. 要退出辨識模式需發送 face_detect，否則標籤會一直顯示
4. 人臉特徵儲存於 Flash fr 分區，斷電不遺失，最多 47 個 ID
5. 辨識採用跳幀策略（每 10 幀執行一次 MFN 推理）

---

七、擴充指令（NanoCam 專屬）

指令	說明	狀態
nano_server:url	設定 LLM 伺服器地址（NVS 儲存）	✅
nano_api_key:key	設定 LLM API 密鑰（NVS 儲存）	✅
nano_mqtt:broker,port,topic	設定 MQTT 伺服器	🔨
nano_led:R,G,B	設定 RGB LED（WS2812, GPIO18 DIN）	📋
nano_snap	拍照儲存（SPIFFS）	✅
nano_stream:on/off	啟停圖傳	📋

nano_server / nano_api_key

指令	說明	示例	返回值
nano_server:URL	設定 LLM 伺服器地址	nano_server:https://api.openai.com	OK server=https://api.openai.com
nano_api_key:KEY	設定 API 密鑰	nano_api_key:sk-xxxx	OK

支援任意 OpenAI 兼容 API（vLLM / Ollama / 本機模型均可）。 ESP-Claw 模式（ai_mode:7）支援使用 nano_server，XiaoZhi AI（ai_mode:6）走獨立伺服器設定。

---

八、注意事項

1. sta_pd / ap_pd 修改後自動重啟，重啟後新密碼生效
2. ai_mode 修改後自動重啟（僅當模式改變時）
3. 人臉辨識模式（mode 4）下，Type-C 串列埠設定功能可能失效（記憶體不足）
4. WiFi 名稱/密碼不能超過 30 個字元，不能有中文
5. 指令後需要跟標點符號作為結束符

下一步

• 快速開始 — 從燒錄固件到 AI 模式切換的完整上手流程

相關產品

ESP32-S3 WiFi 視頻模組→