ESP-IDF 開發環境搭建及編譯小智

本文將指導你如何在 Windows 系統上搭建 ESP-IDF 5.3.2 開發環境，並編譯小智韌體。

安裝 ESP-IDF

1. 下載離線安裝包

從樂鑫官網下載 ESP-IDF v5.3.2 離線安裝包：

訪問 https://dl.espressif.com/dl/esp-idf/

下載適合 Windows 的離線安裝包：esp-idf-tools-setup-offline-5.3.2.exe

2. 運行安裝程式

1. 運行下載的安裝包
2. 選擇安裝路徑（建議默認路徑）
3. 等待安裝完成

3. 配置環境變數

安裝完成後，會自動在開始選單創建 “ESP-IDF 5.3 CMD” 快捷方式。

編譯小智專案

1. 獲取小智原始碼

git clone https://github.com/78/xiaozhi.git
cd xiaozhi

2. 配置目標晶片

idf.py set-target esp32s3

3. 配置專案

idf.py menuconfig

在選單中可以配置：

• WiFi 設定
• 音頻設定
• 顯示設定

4. 編譯專案

idf.py build

編譯成功後，會在 build 目錄下生成韌體檔案。

5. 燒錄韌體

連接 ESP32-S3 開發板，然後執行：

idf.py flash

6. 監控日誌

idf.py monitor

常見問題

編譯錯誤

如果遇到編譯錯誤，嘗試：

1. 清理專案：idf.py clean
2. 重新編譯：idf.py build

燒錄失敗

1. 檢查 USB 連接
2. 確認開發板進入下載模式
3. 檢查串列埠設定

環境變數問題

如果命令找不到，檢查是否：

1. 正確安裝 ESP-IDF
2. 使用 ESP-IDF 專用命令提示字元
3. 環境變數配置正確

進階配置

自訂配置

修改 sdkconfig 檔案可以調整：

• 記憶體配置
• 無線設定
• 除錯選項

多目標支援

如果需要支援其他晶片：

idf.py set-target esp32
# 或
idf.py set-target esp32c3

編譯完成後，你就可以開始小智AI的開發工作了！