ESP32S3-小智AI源码编译+新增硬件board

MCU 更新：2025-09-05 浏览：140 收藏：0 点赞：0

环境准备

虚拟机装载 ubuntu22.04 系统。

虚拟机搭建系统教程：在虚拟机中安装与卸载Ubuntu-硬件文档博客

Linux安装ESP-IDFV5.4.1

全部步骤本人亲测有效，笔记是操作完成后重新记录的。本文章写于2025年8月22日。

修改apt国内镜像源，不然apt安装软件会比较慢。（apt源已改的可以跳过）
以阿里巴巴镜像源为例：（Ubuntu版本22.04）其他版本请参照阿里巴巴镜像站教程。

cd /etc/apt

cp sources.list sources.list.bkp

echo "" > sources.list

sudo vi sources.list

#粘贴以下内容：（按快捷键i进入编辑,粘贴后按ESC键再输入‘:wq’保存退出）
deb https://mirrors.aliyun.com/ubuntu/ jammy main restricted universe multiverse
deb-src https://mirrors.aliyun.com/ubuntu/ jammy main restricted universe multiverse

deb https://mirrors.aliyun.com/ubuntu/ jammy-security main restricted universe multiverse
deb-src https://mirrors.aliyun.com/ubuntu/ jammy-security main restricted universe multiverse

deb https://mirrors.aliyun.com/ubuntu/ jammy-updates main restricted universe multiverse
deb-src https://mirrors.aliyun.com/ubuntu/ jammy-updates main restricted universe multiverse

# deb https://mirrors.aliyun.com/ubuntu/ jammy-proposed main restricted universe multiverse
# deb-src https://mirrors.aliyun.com/ubuntu/ jammy-proposed main restricted universe multiverse

deb https://mirrors.aliyun.com/ubuntu/ jammy-backports main restricted universe multiverse
deb-src https://mirrors.aliyun.com/ubuntu/ jammy-backports main restricted universe multiverse

开始安装

为了在 ESP32-S3 中使用 ESP-IDF，需要根据操作系统安装一些软件包：

sudo apt install git wget flex bison gperf python3 python3-pip python3-venv cmake ninja-build ccache libffi-dev libssl-dev dfu-util libusb-1.0-0 -y

完成后我打算在系统根目录下新建一个esp的文件夹，后面ESP-IDF相关的文件都放这里。

mkdir esp

进入这个文件夹

cd esp

下载安装辅助工具包：

git clone https://gitee.com/EspressifSystems/esp-gitee-tools.git

进入我们下载下来的工具包文件夹:

cd esp-gitee-tools

更改国内仓库：

./jihu-mirror.sh set

退出文件夹：

cd ..

克隆esp-idf仓库，很大比较久：

git clone --recursive https://github.com/espressif/esp-idf.git

切换idf版本：

cd esp-idf
git checkout v5.4.1
../esp-gitee-tools/submodule-update.sh

导出环境变量：

export IDF_GITHUB_ASSETS="dl.espressif.cn/github_assets"

更改pip源：

pip config set global.index-url http://mirrors.aliyun.com/pypi/simple
pip config set global.trusted-host mirrors.aliyun.com

安装所有模块：

../esp-gitee-tools/install.sh

图片#B #S #R #60% #auto
如上所示则安装好了。

将idf添加至 PATH 环境变量：

. ~/esp/esp-idf/export.sh

linux安装vscode

为了方便更新以及查看小智AI的代码，建议安装一个vscode，同时在vscode中安装esp-idf插件，UI式操作不用命令行。

从vscode官网下载最新版本，deb包下载地址：Download Visual Studio Code - Mac, Linux, Windows

图片#B #S #R #60% #auto

下载后在放置 deb 包的文件夹直接打开终端，然后输入：
```
sudo  dpkg  -i code_1.45.1-1589445302_amd64.deb
```
其中的 -i 后面的就是deb包名；执行之后等待安装完成就行了。

后面在系统中直接通过UI打开VSCODE就好。

图片#B #S #R #60% #auto

安装esp-idf插件

图片#B #S #R #60% #auto

后面的操作就根据这里来了 1.3.2在线安装章节：1. IDF环境安装 | 立创开发板技术文档中心

小智AI源码下载

下载地址：78/xiaozhi-esp32: An MCP-based chatbot | 一个基于MCP的聊天机器人

仓库拉取命令：

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

拉取完成后使用VSCODE打开这个文件夹。

小智AI源码新增开发板

新增开发板的步骤参考官方文档：xiaozhi-esp32/main/boards/README.md at main · 78/xiaozhi-esp32

接下来介绍我的步骤。

在 main/boards 路径下，新建自己的板子文件夹，我直接复制lichuang-dev文件夹，且粘贴重新命名为 aaa-lichuang-dev。

在里面根据官方文档说的配置三个文件：

配置config.json文件：
图片#B #S #R #60% #auto

配置config.h文件为你硬件的IO：
图片#B #S #R #60% #auto

改.cc 文件里面为你板子的名称：
图片#B #S #R #60% #auto
同时也要把 .cc 文件改错为你板子的名字。

完成后为了编译能够编译我们的新板子代码，需要在main文件夹下的 CMakeLists.txt 中添加自己板子的配置：
图片#B #S #R #60% #auto

在同目录下的 Kconfig.projbuild 中添加我们板子的名称：
图片#B #S #R #60% #auto

完成后打开终端：
图片#B #S #R #60% #auto

执行编译命令：

按照官方文档说的执行编译打包命令：

使用 python scripts/release.py [开发板目录名字] 来编译打包固件。

图片#B #S #R #60% #auto

编译完成后，会告诉你固件的路径：

图片#B #S #R #60% #auto

到此完成。

如何修改唤醒词

在工程的命令行下，输入idf.py menuconfig进入配置界面
键盘上下选择“ESP Speech Recognition”
图片#B #S #R #60% #auto
选择“Load Multiple Wake Words”

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

更改之后不能用 python scripts/release.py 命令，它会删除我们的配置，需要使用命令：idf.py build进行编译，编译完成后在编译提醒处找到我们项目的所有散固件，按照提示地址烧录即可。

图片#B #S #R #60% #auto

联系管理员

ESP32S3-小智AI源码编译+新增硬件board

环境准备

Linux安装ESP-IDFV5.4.1

开始安装

linux安装vscode

小智AI源码下载

小智AI源码新增开发板

如何修改唤醒词

评论

联系管理员

ESP32S3-小智AI源码编译+新增硬件board

环境准备

Linux安装ESP-IDFV5.4.1

开始安装

linux安装vscode

小智AI源码下载

小智AI源码新增开发板

如何修改唤醒词

相关文章

评论

￥{{ payArticleData.total_amount }}

￥{{ payArticleData.total_amount }}

登录 / Login

社交账号登录