4.0 KiB
编译1.6.0版本esp32固件
第1步 配置环境
先按照这个教程配置项目环境《Windows搭建 ESP IDF 5.3.2开发环境以及编译小智》
第2步 打开配置文件
配置好编译环境后，下载虾哥iaozhi-esp32项目源码，
从这里下载虾哥xiaozhi-esp32项目1.6.0版本源码。
从这里下载虾哥xiaozhi-esp32项目1.6.0版本源码。
从这里下载虾哥xiaozhi-esp32项目1.6.0版本源码。
下载后，解压缩包，打开xiaozhi-esp32/main/Kconfig.projbuild文件。
第3步 修改WEBSOCKET地址
找到WEBSOCKET_URL的default的内容，把wss://api.tenclass.net/xiaozhi/v1/
改成你自己的地址，例如，我的接口地址是ws://192.168.1.25:8000/xiaozhi/v1/，就把内容改成这个。
修改前：
config WEBSOCKET_URL
depends on CONNECTION_TYPE_WEBSOCKET
string "Websocket URL"
default "wss://api.tenclass.net/xiaozhi/v1/"
help
Communication with the server through websocket after wake up.
修改后(示例)：
config WEBSOCKET_URL
depends on CONNECTION_TYPE_WEBSOCKET
string "Websocket URL"
default "ws://192.168.1.25:8000/xiaozhi/v1/"
help
Communication with the server through websocket after wake up.
注意：你的地址是ws://开头，不是wss://开头，一定不要写错了。
注意：你的地址是ws://开头，不是wss://开头，一定不要写错了。
注意：你的地址是ws://开头，不是wss://开头，一定不要写错了。
第4步 设置编译参数
设置编译参数
# 终端命令行进入xiaozhi-esp32的根目录
cd xiaozhi-esp32
# 例如我使用的板子是esp32s3，所以设置编译目标为esp32s3，如果你的板子是其他型号，请替换成对应的型号
idf.py set-target esp32s3
# 进入菜单配置
idf.py menuconfig
进入菜单配置后，再进入Xiaozhi Assistant，将CONNECTION_TYPE设置为Websocket
回退到主菜单，再进入Xiaozhi Assistant，将BOARD_TYPE设置你板子的具体型号
保存退出，回到终端命令行。
第5步 编译固件
idf.py build
第6步 打包bin固件
cd scripts
python release.py
上面的打包命令执行完成后，会在项目根目录下的build目录下生成固件文件merged-binary.bin。
这个merged-binary.bin就是要烧录到硬件上的固件文件。
注意：如果执行到第二命令后，报了“zip”相关的错误，请忽略这个错误，只要build目录下生成固件文件merged-binary.bin
，对你没有太大影响，请继续。
第7步 烧录固件
将esp32设备连接电脑，使用chrome浏览器，打开以下网址
https://espressif.github.io/esp-launchpad/
打开这个教程，Flash工具/Web端烧录固件（无IDF开发环境）。
翻到：方式二：ESP-Launchpad 浏览器WEB端烧录，从3. 烧录固件/下载到开发板开始，按照教程操作。
烧录成功且联网成功后，通过唤醒词唤醒小智，留意server端输出的控制台信息。
常见问题
以下是一些常见问题，供参考：