关于唤醒词更改及配置操作步骤
关于唤醒词更改及配置操作步骤
本项目开源默认唤醒词是 “你好小智”，由本项目负责人/群主在乐鑫官方申请的。
如果你想更改词唤醒词，目前有两种方案：
如何更换唤醒词
-
ESP-IDF 环境支持
对于AI语音类项目，乐鑫官方提供一些免费开放的唤醒词（26个左右）修改支持，但需要在安装配置 ESP IDF开发环境下进行配置，且能够正常编译xiaozhi-esp32源代码的环境下进行。
**注意：ESP-IDF 环境支持是修改唤醒词前提条件，如果没有配置好IDF开发环境的，请先到乐鑫官网了解相关配置说明，此处从略。
-
方式一：通过VSCode视图修改
-
SDK配置入口
打开 VSCode，如下图示，在左侧导航上找到安装好的 ESP-IDF：资源管理器 图标，点击查看命令，选择 SDK Configuration Editor(menuconfig) ，点击后将进入 SDK 配置页面（第一次进入需要等待加载初始配置）。
或者 点击最下方状态栏的 配置图标直接进入，如下图示：
-
SDK 配置操作
在 SDK配置页面左侧点击 ESP Speech Recognition ，在右侧配置内容中找到 use wakenet （本项目已经勾选）Select wake words 下方的选择下拉框选择对应的唤醒词进行修改，按自己的喜好进行选择，如下图示，最后点击保存设置。
提示：以上是以ESP32-S3为目标芯片的唤醒词选择项，如果是ESP32或其他芯片，只会有少数几个唤醒词，请先在VSCode软件状态栏切换目标芯片为esp32s3（USB-JTAG）。
-
重新编译烧录
先关闭所有配置选项，确保电脑上接好 ESP32S3开发板，一般建议连接UART接口，对应开发板正面两个TypeC接口朝下时的右边接口。
-
设备COM端口号与状态栏选择 COM端口对应（状态栏 插头图标）
-
设备目标为 esp32s3（状态栏 芯片图标）
-
烧录方法为 UART（状态栏 五角星图标）
-
构建烧录操作，点击下方状态栏 ESP-IDF：构建、烧录和监控图标（火焰图标，如下图箭头所示），进行重新构建编译和烧录（首次构建需要一些时间，请耐心等待，如出现错误可自行根据提示检查或者QQ群咨询）。
等待烧录成功结束，在监控窗口看到设备自动重新启动后，使用新的 唤醒词 进行唤醒，即完成唤唤醒词更换操作。
*注意：
如果之前编译过该项目，为确保更新可选择使用 idf.py fullclean 清除一下缓存组件。
也可以选择先 build 构建项目，然后再烧录固件到 ESP32S3开发板，请自行选择操作。
-
方式2：通过idf.py menuconfig 菜单修改
-
入口命令 idf.py menuconfig
请确保 Windows 电脑上已经安装配置的 ESP-IDF 开发环境，电脑开始菜单打开 ESP-IDF 5.3 PowerShell （建议以管理员身份运行，用 ESP-IDF 5.3 CMD也可以），如下图示：
在 ESP-IDF 5.3 PowerShell 命令行输入 idf.py menuconfig
-
ESP Speech Recognition 配置项
进入 ESP Speech Recognition 配置项进行配置修改，如下图示：
3.3 进入use wakenet 配置唤醒词
键盘Enter 回车确认后进入配置页面，选择 use wakenet 选项下 Select wake words ( xxxxxxxx ) —> 进入选择唤醒词更换。
进入后请选择自己想用的免费唤醒词，使用Enter回车选中，选项前的括号里出现X（X），表示选中，如下图示：
提示：以上是以ESP32-S3为目标芯片的唤醒词选择项，如果是ESP32或其他芯片，只会有少数几个唤醒词，请先使用 idf.py set-target esp32s3 命令切换目标芯片为esp32s3。
3.4 保存配置选项并退出
唤醒词修改配置后需要保存退出，先按 键盘【S】出现如下图示界面，再按 Enter 回车 Save 保存，蓝色提示层消失，最后按键盘 【Q】 或 Esc 退出配置界面。
3.5 重新构建编译和烧录
**注意：唤醒词配置更换后，需要重新构建编译固件下载到 ESP32S3开发板上重新启动才能生效。
在完成本节上述操作后，确保电脑连接好 ESP32S3开发板串口 UART 接口（开发板正面TypeC接口朝下时，右边的接口）， 进行 build 编译如下图示：
-
重新构建
在项目源代码根目录下（以 xiaozhi-esp32-0.3.2 版本为示例），xiaozhi-esp32-0.3.2>
先确保目标设备为 esp32s3，输入命令：idf.py set-target esp32s3 （如果已经是了就不用操作此步骤）
重新编译构建项目，输入命令：idf.py build
*注意：如果之前编译过该项目，为确保更新可选择使用 idf.py fullclean 清除一下缓存组件在进行 idf.py build
ESP32 程序build构建根据电脑硬件和软件环境配置不同等待时间不同，一般几分钟到20分钟不等，在项目构建成功后会提示 Successfully created esp32s3 image. （遇到问题请QQ群里咨询），如下图示。
-
重新烧录和监控
请确保 ESP32S3开发板已经被电脑识别并确认COM端口号，如果Windows上有多个COM设备，可指定端口进行烧录和监控，输入命令：idf.py -p COM7 flash monitor （如果其他设备不支持IDF烧录，不指定也没关系，输入命令：idf.py flash monitor ），如下图示：
最后等待烧录完成（提示写入 100% ），完成后自动进入串口监控模式。
**注意：
EPS32S3开发板芯片固件重新烧录后，如果WIFI版本需要重新配网，请参考之前的文档配网后，即可用新的 唤醒词进行唤醒。
更换唤醒词后，语音输入唤醒词后，串口监控应用返回文字还是 小智，此处不影响使用，暂时不做处理。
**关于定制唤醒词，请咨询乐鑫官方
乐鑫官方提供商用换新词定制服务，申请条件较高，简单参考如下图示，具体访问乐鑫官网了解。
