驱动安装

  • 一般店家会提供驱动连接开发板，安装驱动后电脑才能识别设备
  • 未安装驱动时会出现带黄色感叹号的USB设备
  • 连接芯片型号：CH340
    下载地址：https://www.wch.cn/products/CH340.html
  • 识别成功后显示端口号（如COM5），请记录该端口号

环境部署

  1. 环境部署文档：
    https://icnynnzcwou8.feishu.cn/wiki/JEYDwTTALi5s2zkGlFGcDiRknXf
  2. 下载esp-idf：
    https://dl.espressif.com.cn/dl/esp-idf/
  3. 打开ESP-IDF 5.3 PowerShell预加载环境（自动加载Python）

下载源码

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

配置与编译

  1. 设置目标芯片（需连接开发板）：

    idf.py set-target esp32s3

  2. 进入配置界面：

    idf.py menuconfig

  3. 独立部署需修改三处配置（OTA/WS/开发板型号）：

    • 基于1.6.0版本（新版可能已取消WS配置）
  4. 配置完成后按 S 保存再退出
  5. 开发板点位图（通常由店家提供）：

  6. 开始编译：

    idf.py build

固件烧录

方法一：直接烧录

idf.py flash
  • 烧录时可能需要进入下载模式（本开发板会自动重启，需按Boot键进入）

方法二：使用flash_download_tool

  1. 生成烧录文件（不可直接用build/xiaozhi.bin）：

    cd ./scripts/
python ./release.py

  2. 使用生成的bin文件烧录：
注意：官方教程未说明需脚本打包，直接使用xiaozhi.bin烧录会导致黑屏

问题排查

运行串口监视器查看日志：

idf.py monitor

典型错误提示示例：

Build:Mar 27 2021 rst:0x7 (TG0WDT_SYS_RST),boot:0x18 (SPI_FAST_FLASH_BOOT)
Saved PC:0x40043ac8 -- 0x40043ac8: main in ROM SPIWP:0xee mode:DIO, clock div:1 
load:0x3c1b0020,len:0x2354fc Invalid image block, can't boot. ets_main.c 329 
ESP-ROM:esp32s3-20210327 Build:Mar 27 2021 rst:0x10 (RTCWDT_RTC_RST),boot:0x18 
(SPI_FAST_FLASH_BOOT) SPIWP:0xee mode:DIO, clock div:1 load:0x3c1b0020,len:0x2354fc 
Invalid image block, can't boot. ets_main.c 329
提示：VSCode操作按钮实际也是执行相应命令

## 转换说明
1. 保留了所有原始链接和图片引用
2. 命令行代码使用代码块格式（```bash）
3. 错误日志使用代码块展示（无语言标识）
4. 添加了层级标题（H1-H2）组织文档结构
5. 重要注意事项使用 `> **注意**` 格式突出显示
6. 删除了原Word文档中的图片尺寸属性（Markdown不支持）