mirror of https://github.com/78/xiaozhi-esp32.git synced 2026-07-21 02:05:52 +00:00

Files

T

3dea6e7f84 Migrate to xiaozhi-fonts 2.0.0 (#2125 )

* feat: migrate firmware to xiaozhi-fonts 2.0.0

* fix: restart scrolling subtitles on text change

* docs: add AGENTS.md for project overview, architecture, rules, and commands

- Introduced AGENTS.md to document the XiaoZhi voice-assistant firmware architecture, required rules for development, board configuration process, and validation steps.
- Included detailed sections on project structure, commands for building and testing, and authoritative documentation references.

* feat: finalize glyph push protocol

* fix: remove stale emoji font include

* build: use xiaozhi-fonts 2.0.0

* fix: decouple custom fonts from glyph push

* refactor: improve wake word invocation handling

- Introduced BeginWakeWordInvoke method to streamline the wake word processing flow.
- Updated HandleWakeWordDetectedEvent to utilize the new method, ensuring proper state transitions and scheduling.
- Enhanced error handling to prevent the device from getting stuck in the connecting state.
- Refactored audio channel management to improve responsiveness during wake word detection.

---------

Co-authored-by: Xiaoxia <terrence.huang@tenclass.com>

2026-07-18 21:29:00 +08:00

2.6 KiB

Raw Blame History

ESP-VoCat 喵伴

简介

立创开源平台

ESP-VoCat 喵伴是一款智能 AI 开发套件，搭载 ESP32-S3-WROOM-1 模组，1.85 寸 QSPI 圆形触摸屏，双麦阵列，支持离线语音唤醒与声源定位算法。硬件详情等可查看立创开源项目。

配置、编译命令

配置编译目标为 ESP32S3

idf.py set-target esp32s3

打开 menuconfig 并配置

idf.py menuconfig

分别配置如下选项：

基本配置

Xiaozhi Assistant → Board Type → 选择 Espressif ESP-VoCat

UI风格选择

ESP-VoCat 支持多种不同的 UI 显示风格，通过 menuconfig 配置选择：

Xiaozhi Assistant → Select display style → 选择显示风格

可选风格

表情动画风格 (Emote animation style) - 推荐

配置选项: USE_EMOTE_MESSAGE_STYLE
特点: 使用自定义的 EmoteDisplay 表情显示系统
功能: 支持丰富的表情动画、眼睛动画、状态图标显示
适用: 智能助手场景，提供更生动的人机交互体验
类: emote::EmoteDisplay

⚠️ 重要: 选择此风格需要额外配置自定义资源文件：

Xiaozhi Assistant → Flash Assets → 选择 Flash Custom Assets
Xiaozhi Assistant → Custom Assets File → 填入资源文件地址：
```
https://dl.espressif.com/AE/wn9_nihaoxiaozhi_tts-font_puhui_common_20_4-echoear.bin
```
这是保留表情动画和模型的历史资源包；新版固件会忽略其中没有 Noto 元数据的旧 Puhui 字体，并使用内置 Noto basic 字体。待新的 Noto 资源包上传后可直接替换此 URL。

默认消息风格 (Enable default message style)

配置选项: USE_DEFAULT_MESSAGE_STYLE (默认)
特点: 使用标准的消息显示界面
功能: 传统的文本和图标显示界面
适用: 标准的对话场景
类: SpiLcdDisplay

微信消息风格 (Enable WeChat Message Style)

配置选项: USE_WECHAT_MESSAGE_STYLE
特点: 仿微信聊天界面风格
功能: 类似微信的消息气泡显示
适用: 喜欢微信风格的用户
类: SpiLcdDisplay

说明: ESP-VoCat 喵伴使用16MB Flash，需要使用专门的分区表配置来合理分配存储空间给应用程序、OTA更新、资源文件等。

按 S 保存，按 Q 退出。

编译

idf.py build

烧录

将 ESP-VoCat 喵伴连接至电脑，注意打开电源，并运行：

idf.py flash

2.6 KiB Raw Blame History