ESP32 小智 新手指導包

立創實戰派 ESP32-S3 · 由完全新手到識玩

1你手上嘅裝備

你部機係「立創實戰派 ESP32-S3（小智 AI 開發版）」——一部掌心大小嘅語音 AI 裝置，唔係手機。

機身有咩

  • 3.2 吋彩色觸控螢幕 — 顯示表情、天氣、對話狀態（320×240）
  • 雙麥克風 + 喇叭 — 收音同出聲；喇叭夠大聲，唔使貼耳
  • 鏡頭（GC2145） — 可以影相再問佢「你見到啲咩？」
  • BOOT 鍵、RST 鍵 — BOOT = 手動叫醒／下載模式；RST = 重新啟動
  • USB-C 口 — 供電、充電、燒錄固件、睇除錯訊息（三合一）
  • TF 卡槽、擴展口（5V/3.3V + GPIO10/11）、I2C 擴展口 — 之後想加感測器就靠佢
  • 6 軸姿態感測器 — 可以感應傾斜／搖動（預設未用）

三件你要知嘅事

只食 2.4GHz WiFi 你屋企／手機熱點如果係 5GHz 或「5G 優先」，佢係搵唔到嘅。

冇內置電池 要插 USB 供電；想帶出街就要自己加 1S 鋰電 + 充電板（我可以幫你改埋電量顯示）。

唔防水、怕靜電 唔好濕手摸、唔好短路擴展口嘅針腳。

25 分鐘上手

由插電到叫醒佢，四步。第一次設定之後，平時只需插電就可以用。

  1. 準備一條「識傳資料」嘅 USB-C 線 世界上好多 USB 線只供電、唔傳資料。用跟機線或手機線；插落電腦如果見到新嘅 COM／序列埠 = 合格。
  2. 插電開機 螢幕著 + 有開機提示音。如果螢幕一直黑，拔電再插；仍然黑就按一下 RST。
  3. 配網（只需要做一次，換 WiFi 才要再做） ① 手機 WiFi 揀 Xiaozhi-xxxx（開發板自己開嘅熱點，無密碼）
    ② 等幾秒會自動彈設定頁；冇彈就開瀏覽器打 192.168.4.1
    ③ 揀你屋企 2.4GHz WiFi、輸入密碼、按連接
    ④ 如果頁面有「高級選項」而你嘅伺服器要指定 OTA 地址，就喺嗰度填（我幫你設定嘅話多數唔使填）
    ⑤ 等佢自動重啟（約 10 秒）
  4. 叫醒佢 講 「Hi Jarvis」 或者 「Jarvis」，又或者按一下 BOOT 鍵。見到螢幕有反應／聽到提示音，就講你嘅問題。

即刻試呢三句

  • 「今日天氣點？」 會答即時氣溫、濕度、警告
  • 「你叫咩名？」 會答阿維／Jarvis
  • 「音量校到 60」 會即刻改喇叭音量

講嘢小技巧

  • 一次講一件事，等佢答完先講下一句
  • 距離 30–100cm、正常聲量就夠（唔使大叫）
  • 環境太嘈（電視、抽油煙機）會影響收音
  • 佢唔明就換個講法，唔使講到好長

3你可以叫佢做咩

呢部機預設已經掛咗以下「工具」，用自然語氣講就得。

功能講法例子
調音量「音量校到 80」、「大聲啲」
螢幕亮度「螢幕調暗啲」、「亮度 30」
主題「轉深色模式」／「轉淺色」
拍照＋看圖「影張相，睇下枱面有咩」
自我狀態「你而家音量幾多？WiFi 收得好唔好？」
鬧鐘／提醒／倒數「設個 10 分鐘倒數」、「七點叫我」
播歌「播首歌」、「下一首」、「停」
歌單「我個歌單有咩歌？」
天氣「今日天氣」、「聽日使唔使帶傘」
重新配網「重新配網」（會進入配網熱點模式）
常識問答／傾偈「點解天會藍？」、「講個笑話」
驗證碼「讀出你嘅驗證碼」

仲可以做嘅：由手機／Telegram 控制

呢部機接咗我幫你起嘅伺服器，所以除咗用口講，你亦可以喺 Telegram 直接叫 Jarvis 做嘢（例如「幫我睇下小智音量」、「叫佢拍張相」），唔需要喺佢旁邊。

4出問題？照住查

新手最常撞到嘅情況，點一下展開。

螢幕寫「檢查新版本失敗 Code32774」

呢個係固件去檢查更新時 TLS 連線超時（唔係壞機）。新固件已經把更新地址寫死落你嘅伺服器，正常唔會再見。如果再見到：按一下 RST 重啟，佢會再試。

叫佢影相，佢話「Failed to capture photo」

九成係鏡頭模組鬆咗。鏡頭係插座式（FPC 排線），好易鬆：斷電 → 輕輕打開插座扣 → 抽出排線 → 對準金手指方向插返實 → 扣好 → 通電再試。

你塊板嘅鏡頭型號係 GC2145（唔係預設 GC0308），所以我已經用對應設定幫你編固件。如果插實都唔得，同我講，我會讀相機診斷碼再處理。

叫極都唔醒

① 先按一下 BOOT 鍵睇下佢有冇反應（分開「收音問題」同「網絡問題」）
② 確認螢幕有 WiFi 圖示、冇顯示離線
③ 近啲講、慢啲講「Hi Jarvis」
④ 仍然唔得：按 RST 重啟，等 20 秒再試

有反應但冇聲

可能音量被調到 0。講「音量校到 80」；或者喺 Telegram 叫我幫你設定。

配網時搵唔到屋企 WiFi

佢只支援 2.4GHz。如果你用手機熱點，要去熱點設定開「最大兼容性／2.4GHz」。路由器就分開 2.4G 同 5G 兩個 SSID，揀 2.4G 嗰個。

會唔會燒壞／燒死？

唔會「燒死」。ESP32-S3 內置一段不可擦除嘅開機程式（ROM bootloader），就算固件壞晒，都可以用 USB 重新燒返。你塊板仲有自動下載電路，插 USB 就認到。

拔電會唔會唔見設定？

WiFi 同設定會保留喺板內記憶體。只有「重新燒錄固件（USB 全片燒錄）」先會清；就算清咗，重新配網 2 分鐘搞掂。

5進階：呢部機點運作

知多少少，之後想改就知邊樣喺邊。

開發板（小智固件）收音、喇叭、螢幕、鏡頭、按鍵
↓ MQTT + UDP（音訊加密傳送）
你嘅小智伺服器語音轉文字（ASR）· 大腦（LLM）· 文字轉語音（TTS）· 天氣/工具
↓ 控制接口
Hermes（Telegram）你用手機叫佢控制開發板：音量、亮度、拍照、定時

好處：大腦同聲音都喺伺服器側，所以改角色、換聲音、加功能都唔需要重新燒固件；只有「喚醒詞」同「硬件相關」先要編固件。

固件更新（唔使插線）

你部機支援 OTA（無線更新）：新固件放上伺服器，開機時佢自己下載更新，WiFi 設定唔會清。

  • 我有新版固件（例如換喚醒詞）就會推上去，你只要等佢重啟
  • 想即刻觸發：斷電再插電，佢開機會檢查一次

USB 燒錄（後備方案）

只在「OTA 都入唔到」或者你想回復原廠固件時用。

  1. 裝 Flash Download Tool（樂鑫官方），開程式選 ChipType = ESP32-S3
  2. 揀合併固件 .bin，燒錄地址填 0x0
  3. USB-C 插電腦，選 COM 埠、baud 921600
  4. 先按 ERASE 清空，再按 START 燒錄
  5. 完成後拔插 USB 或按 RST

官方原廠固件（後備用）已經幫你備份咗一份，壞咗都有得還原。

之後可以加嘅嘢

唔好做嘅事

  • 唔好將 5V 直接接落 3.3V 或 GPIO（會燒板）
  • 唔好喺通電時插拔鏡頭排線
  • 唔好短路擴展口針腳（金屬工具／水）
  • 唔好插 5V 以上嘅電源（USB 5V 就夠）

6名詞小辭典

見到啲字唔明就返嚟查。

ESP32-S3樂鑫出品嘅微控制器晶片，有 WiFi／藍牙，係你部機嘅心臟。
固件 / Firmware燒入去晶片、控制硬件嘅程式。你部機嘅固件叫「小智」。
燒錄 / Flash把固件寫入晶片。可以 USB 做，亦可以無線（OTA）。
OTAOver-The-Air，無線更新固件。
配網告訴開發板要連邊個 WiFi（第一次用必做）。
喚醒詞叫醒佢嘅字，例如「Hi Jarvis」。需要對應嘅模型寫入固件。
GPIO晶片嘅通用腳位，可以讀訊號（按鈕、感測器）或輸出（LED、繼電器）。
ADC把電壓變成數字，用嚟量電壓（例如量電池電量）。
I2C一種兩線通訊（SDA／SCL），接感測器、IO 擴展晶片好常用。
ASR語音轉文字（聽得明你講咩）。
TTS文字轉語音（佢把聲）。現用粵語男聲。
LLM大語言模型，即係「大腦」，負責理解同回答。
MQTT / UDP開發板同伺服器之間嘅通訊方式：控制訊息走 MQTT，音訊走 UDP。
MCP一套標準協議，令「大腦」可以叫開發板做嘢（調音量、拍照…）。
伺服器一部長期開機嘅電腦，負責認聲、思考、出聲；你部機係連住佢嘅。
Hermes我用嘅智能代理系統：你喺 Telegram 打一句，佢就幫你操作開發板同其他事情。