跳到主要内容

Windows ESP IDF 5.3 编译小智

1. 下载源码​

进入虾哥 Github 小智代码主页:https://github.com/78/xiaozhi-esp32

点击Code - Download ZIP

电脑装了git工具的话,建议还是用命令 git clone https://github.com/78/xiaozhi-esp32 ,有时候下载zip会有问题

下载小智AI代码

下载完成后解压到任意目录备用

下载小智AI代码解压

进入终端,打开IDF 5.3或者双击桌面的ESP IDF5.3 Powershell

我解压的目录和你们的不一样,各自输入 刚刚解压的目录:

cd J:\xiaozhi-esp32-main_2\xiaozhi-esp32-main

下载小智AI代码解压路径

2. 设置芯片类型​

默认的编译芯片是ESP32的,所以自己的板子是S3的话一定要输入以下命令把芯片设置为S3

idf.py set-target esp32s3

如果你使用的芯片是ESP32C3的话,需要输入 idf.py set-target esp32c3 先把芯片类型设置为C3,再去menuconfig里选择对应的板子类型

设置小智AI项目目标芯片

设置小智AI项目目标芯片2

3. 更换编译板子类型​

默认编译出的固件是面包板的,如果需要更换板子,需要输入 idf.py menuconfig

进入小智AI项目配置菜单

进入Xiaozhi Assistant选项

进入小智AI项目配置菜单2

进入小智AI项目配置菜单3

自己是什么板子就选什么型号,不是一定要选Kevin SP V3板子,如果你是ESP32C3板子就要选C3的,并且一定要先运行idf.py set-target esp32c3

进入小智AI项目配置菜单4

选择需要编译的板子固件后按键盘的‘S’键保存 然后Esc退出menuconfig

4. 开始编译​

再次输入 idf.py build 进行编译

编译小智AI项目代码

编译小智AI项目代码2

编译完成后输入 idf.py build flash monitor 进行下载和显示日志

5. 如何修改唤醒词​

输入 idf.py menuconfig 进入配置界面

进入小智AI项目配置菜单

键盘上下选择 ESP Speech Recognition

配置小智AI项目唤醒词

配置小智AI项目唤醒词2

选择任意唤醒词后按Enter确定后按键盘的'S'保存退出

配置小智AI项目唤醒词3

6. 如何修改websocket api接口​

输入 idf.py menuconfig 进入配置界面

进入小智AI项目配置菜单

键盘上下选择 Xiaozhi Assistant

修改小智AI项目Websocket API

修改小智AI项目Websocket API2

选择Websocket确定

修改小智AI项目Websocket API3 修改小智AI项目Websocket API4

输入自己的api地址后保存退出重新编译

修改小智AI项目Websocket API5

7. 安装串口驱动​

有的用户电脑没有串口驱动下载过程中一直卡着不动的情况下可以尝试一下安装以下驱动:

MAC下的驱动:

点击下载CH341驱动文件

Windows下的驱动:

点击下载CH343驱动文件

I2C冲突的问题解决办法​

如果您编译烧录后发现出现以下问题:

当然在最新版本代码里已经修复了此问题

修改小智AI项目I2C冲突

进入 idf.py menuconifg ->Component config->Audio Codec Device Configuration

关掉第一行后重新编译烧录就可以了

修改小智AI项目I2C冲突2