xiaozhi-esp32 开发板适配指南Movecall Moji2.0ESP32-C5固件编译与配置全流程【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32本文档是 xiaozhi-esp32 项目中 Movecall Moji2.0小智 AI 衍生版开发板的编译配置指南面向已经拿到该硬件、希望从源码构建并烧录固件的开发者。读完本文你将掌握ESP32-C5 目标芯片的项目初始化、通过 menuconfig 选择开发板型号的完整路径、固件编译/清理/烧录/串口监视的常用命令以及该开发板在仓库中的板级实现细节GPIO 分配、音频编解码、QSPI 屏驱、电源管理与按键交互逻辑。硬件与软件环境要求在开始编译前请确认你的开发环境满足以下前提条件项目要求ESP-IDF 版本v5.5目标芯片ESP32-C5开发板Movecall Moji2.0小智 AI 衍生版该开发板在本仓库中被归类为 ESP32-C5 平台因此在编译链路中需要先通过idf.py set-target esp32c5将整个工程的目标芯片切换为 ESP32-C5。仓库根目录下的 sdkconfig.defaults.esp32c5 即为 ESP32-C5 平台准备的默认配置其中启用了 QIO 闪存模式、240 MHz 默认 CPU 频率、精简的 Wi-Fi 缓冲区参数以及CONFIG_USE_ESP_WAKE_WORDy使用 Wakenet 唤醒词模型而不带 AFE与中文唤醒词CONFIG_SR_WN_WN9S_NIHAOXIAOZHIy这些配置会在编译时自动叠加生效。说明ESP32-C5 属于较新的芯片平台建议使用与仓库 CI 一致的 ESP-IDF v5.5 版本避免因工具链版本差异导致编译失败。开发板在构建系统中的注册关系Movecall Moji2.0 的板级支持由仓库中四个文件共同构成理解它们之间的关系有助于后续排查问题main/boards/movecall/moji2-esp32c5/config.json声明板卡元信息厂商 movecall、类型movecall-moji2-esp32c5、目标esp32c5并携带一份sdkconfig_append追加配置见下文说明。main/boards/movecall/moji2-esp32c5/config.h全部引脚分配与硬件参数宏定义音频、显示、按键、LED 等。main/boards/movecall/moji2-esp32c5/movecall_moji2_esp32s3.cc板级实现类MovecallMoji2ESP32C5以DECLARE_BOARD宏注册进框架。main/boards/movecall/moji2-esp32c5/README_zh.md即本文所依据的官方编译指南。其中config.json里的sdkconfig_append会在编译该板卡时自动写入以下关键配置CONFIG_FREERTOS_USE_TICKLESS_IDLEy, CONFIG_SPIRAMy, CONFIG_SPIRAM_MODE_QUADy, CONFIG_SPIRAM_SPEED_80My, CONFIG_SPI_FLASH_FREQ_LIMIT_C5_240MHZy这几项的意义分别是开启 FreeRTOS tickless 空闲模式低功耗休眠基础、启用 PSRAM四线 SPI 模式、80 MHz 速率以及将 C5 的 SPI Flash 频率上限提升至 240 MHz。也就是说Moji2.0 是一块带外部 PSRAM 的 ESP32-C5 硬件。编译步骤1. 设置编译目标为 ESP32-C5首次编译前必须先将项目目标芯片设置为 ESP32-C5idf.py set-target esp32c5该命令会为 ESP32-C5 生成对应的sdkconfig与构建目录。这一步是后续所有步骤的前提如果跳过menuconfig 中将看不到 ESP32-C5 专属的开发板选项BOARD_TYPE_MOVECALL_MOJI2_ESP32C5在 main/Kconfig.projbuild 中通过depends on IDF_TARGET_ESP32C5约束只有目标芯片匹配时才会出现。2. 通过 menuconfig 选择开发板型号运行以下命令打开图形化配置菜单idf.py menuconfig在菜单中按照以下路径操作Xiaozhi Assistant→Board Type→Movecall Moji 2.0操作提示配置完成后按S保存并按回车确认再按Q退出菜单。该菜单项对应 Kconfig 中的CONFIG_BOARD_TYPE_MOVECALL_MOJI2_ESP32C5。选中后main/CMakeLists.txt 中对应分支会把BOARD_DIR设置为movecall/moji2-esp32c5并将内置字体设为font_noto_sans_basic_20_4、图标字体设为font_material_symbols_20_4、默认 emoji 集合设为noto-color-emoji_64随后编译系统会自动引入该目录下的config.h与板级.cc源文件。3. 执行编译idf.py build编译产物生成后即可进入烧录与调试阶段。若需要同时完成编译 烧录 打开串口监视器也可以使用组合命令idf.py flash monitor。常用维护命令命令用途适用场景idf.py fullclean清理全部编译缓存遇到诡异报错、切换芯片目标或更换 SDK 版本后建议先执行idf.py flash烧录固件到设备编译成功后写入固件idf.py monitor查看串口日志观察启动日志、Wi-Fi 配网状态与对话流程清理编译缓存遇到报错建议执行idf.py fullclean烧录固件idf.py flash查看串口日志idf.py monitor提示fullclean会删除build目录下的全部构建产物执行后需要重新idf.py build。如果烧录时提示无法连接串口请检查 USB 转串口驱动、串口设备节点权限以及CONFIG_ESPTOOLPY_PORT配置。板级实现细节硬件资源如何被初始化阅读 movecall_moji2_esp32s3.cc 可以更深入地理解这块板子的硬件拓扑。板类继承自WifiBoard构造函数依次完成以下初始化音频通路ES8311 编解码器I2C 总线SDAGPIO26、SCLGPIO27启用内部上拉驱动 ES8311 音频 CodecI2S 数据通路使用 MCLKGPIO25、WSGPIO24、BCLKGPIO11、DINGPIO12、DOUTGPIO23采样率固定为 24 kHz定义见 config.hPA 功放使能引脚为 GPIO5。显示通路ST77916 QSPI 屏采用 QSPI 四线接口的 360×360 圆形 LCDSPI 时钟 40 MHzDISPLAY_QSPI_*引脚为 SCLKGPIO0、RESETGPIO1、D0~D3GPIO9/8/7/6、CSGPIO3背光引脚 GPIO2非反相 PWM 调光。屏幕初始化命令表lcd_init_cmds完整写入 ST77916 寄存器序列最终封装为SpiLcdDisplay实例。电源与低功耗管理通过AdcBatteryMonitorADC 通道 3量程 5.1 V检测电池电压与充电状态PowerSaveTimer在空闲 240 秒后进入屏幕省电模式充电时自动禁用省电定时器。config.json中开启的 tickless idle 模式为这类省电逻辑提供了底层支撑。交互按键BOOT 键GPIO28在启动阶段短按直接进入 Wi-Fi 配网模式正常运行状态下单击切换对话状态按住期间配合PressToTalkMcpToolmain/boards/common/press_to_talk_mcp_tool.cc实现按下讲话的 MCP 对讲功能按下唤醒省电定时器并开始录音松开即结束本轮语音输入。板载单 LEDGPIO10用于状态指示。烧录后首次使用固件烧录完成后通过idf.py monitor观察启动日志。首次使用需要配网设备会以热点方式广播 Wi-Fi 配置入口USE_HOTSPOT_WIFI_PROVISIONING默认开启连接后按提示输入 Wi-Fi 账号密码即可。配网与更多功能说明可参考仓库根目录的 README_zh.md 与 docs/blufi_zh.md。常见问题排查menuconfig 中找不到 Movecall Moji 2.0 选项确认已执行idf.py set-target esp32c5该选项仅在目标芯片为 ESP32-C5 时可见。编译报错且原因不明优先执行idf.py fullclean清理缓存后重新idf.py build。唤醒词不生效检查 sdkconfig 中CONFIG_USE_ESP_WAKE_WORD与CONFIG_SR_WN_WN9S_NIHAOXIAOZHI是否启用ESP32-C5 平台使用不带 AFE 的 Wakenet 模型路径见 sdkconfig.defaults.esp32c5。屏幕异常或花屏确认 QSPI 屏线序与 config.h 中DISPLAY_QSPI_*引脚定义一致该板依赖 40 MHz QSPI 时序排线质量与焊接会直接影响显示稳定性。【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
xiaozhi-esp32 开发板适配指南Movecall Moji2.0ESP32-C5固件编译与配置全流程【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32本文档是 xiaozhi-esp32 项目中 Movecall Moji2.0小智 AI 衍生版开发板的编译配置指南面向已经拿到该硬件、希望从源码构建并烧录固件的开发者。读完本文你将掌握ESP32-C5 目标芯片的项目初始化、通过 menuconfig 选择开发板型号的完整路径、固件编译/清理/烧录/串口监视的常用命令以及该开发板在仓库中的板级实现细节GPIO 分配、音频编解码、QSPI 屏驱、电源管理与按键交互逻辑。硬件与软件环境要求在开始编译前请确认你的开发环境满足以下前提条件项目要求ESP-IDF 版本v5.5目标芯片ESP32-C5开发板Movecall Moji2.0小智 AI 衍生版该开发板在本仓库中被归类为 ESP32-C5 平台因此在编译链路中需要先通过idf.py set-target esp32c5将整个工程的目标芯片切换为 ESP32-C5。仓库根目录下的 sdkconfig.defaults.esp32c5 即为 ESP32-C5 平台准备的默认配置其中启用了 QIO 闪存模式、240 MHz 默认 CPU 频率、精简的 Wi-Fi 缓冲区参数以及CONFIG_USE_ESP_WAKE_WORDy使用 Wakenet 唤醒词模型而不带 AFE与中文唤醒词CONFIG_SR_WN_WN9S_NIHAOXIAOZHIy这些配置会在编译时自动叠加生效。说明ESP32-C5 属于较新的芯片平台建议使用与仓库 CI 一致的 ESP-IDF v5.5 版本避免因工具链版本差异导致编译失败。开发板在构建系统中的注册关系Movecall Moji2.0 的板级支持由仓库中四个文件共同构成理解它们之间的关系有助于后续排查问题main/boards/movecall/moji2-esp32c5/config.json声明板卡元信息厂商 movecall、类型movecall-moji2-esp32c5、目标esp32c5并携带一份sdkconfig_append追加配置见下文说明。main/boards/movecall/moji2-esp32c5/config.h全部引脚分配与硬件参数宏定义音频、显示、按键、LED 等。main/boards/movecall/moji2-esp32c5/movecall_moji2_esp32s3.cc板级实现类MovecallMoji2ESP32C5以DECLARE_BOARD宏注册进框架。main/boards/movecall/moji2-esp32c5/README_zh.md即本文所依据的官方编译指南。其中config.json里的sdkconfig_append会在编译该板卡时自动写入以下关键配置CONFIG_FREERTOS_USE_TICKLESS_IDLEy, CONFIG_SPIRAMy, CONFIG_SPIRAM_MODE_QUADy, CONFIG_SPIRAM_SPEED_80My, CONFIG_SPI_FLASH_FREQ_LIMIT_C5_240MHZy这几项的意义分别是开启 FreeRTOS tickless 空闲模式低功耗休眠基础、启用 PSRAM四线 SPI 模式、80 MHz 速率以及将 C5 的 SPI Flash 频率上限提升至 240 MHz。也就是说Moji2.0 是一块带外部 PSRAM 的 ESP32-C5 硬件。编译步骤1. 设置编译目标为 ESP32-C5首次编译前必须先将项目目标芯片设置为 ESP32-C5idf.py set-target esp32c5该命令会为 ESP32-C5 生成对应的sdkconfig与构建目录。这一步是后续所有步骤的前提如果跳过menuconfig 中将看不到 ESP32-C5 专属的开发板选项BOARD_TYPE_MOVECALL_MOJI2_ESP32C5在 main/Kconfig.projbuild 中通过depends on IDF_TARGET_ESP32C5约束只有目标芯片匹配时才会出现。2. 通过 menuconfig 选择开发板型号运行以下命令打开图形化配置菜单idf.py menuconfig在菜单中按照以下路径操作Xiaozhi Assistant→Board Type→Movecall Moji 2.0操作提示配置完成后按S保存并按回车确认再按Q退出菜单。该菜单项对应 Kconfig 中的CONFIG_BOARD_TYPE_MOVECALL_MOJI2_ESP32C5。选中后main/CMakeLists.txt 中对应分支会把BOARD_DIR设置为movecall/moji2-esp32c5并将内置字体设为font_noto_sans_basic_20_4、图标字体设为font_material_symbols_20_4、默认 emoji 集合设为noto-color-emoji_64随后编译系统会自动引入该目录下的config.h与板级.cc源文件。3. 执行编译idf.py build编译产物生成后即可进入烧录与调试阶段。若需要同时完成编译 烧录 打开串口监视器也可以使用组合命令idf.py flash monitor。常用维护命令命令用途适用场景idf.py fullclean清理全部编译缓存遇到诡异报错、切换芯片目标或更换 SDK 版本后建议先执行idf.py flash烧录固件到设备编译成功后写入固件idf.py monitor查看串口日志观察启动日志、Wi-Fi 配网状态与对话流程清理编译缓存遇到报错建议执行idf.py fullclean烧录固件idf.py flash查看串口日志idf.py monitor提示fullclean会删除build目录下的全部构建产物执行后需要重新idf.py build。如果烧录时提示无法连接串口请检查 USB 转串口驱动、串口设备节点权限以及CONFIG_ESPTOOLPY_PORT配置。板级实现细节硬件资源如何被初始化阅读 movecall_moji2_esp32s3.cc 可以更深入地理解这块板子的硬件拓扑。板类继承自WifiBoard构造函数依次完成以下初始化音频通路ES8311 编解码器I2C 总线SDAGPIO26、SCLGPIO27启用内部上拉驱动 ES8311 音频 CodecI2S 数据通路使用 MCLKGPIO25、WSGPIO24、BCLKGPIO11、DINGPIO12、DOUTGPIO23采样率固定为 24 kHz定义见 config.hPA 功放使能引脚为 GPIO5。显示通路ST77916 QSPI 屏采用 QSPI 四线接口的 360×360 圆形 LCDSPI 时钟 40 MHzDISPLAY_QSPI_*引脚为 SCLKGPIO0、RESETGPIO1、D0~D3GPIO9/8/7/6、CSGPIO3背光引脚 GPIO2非反相 PWM 调光。屏幕初始化命令表lcd_init_cmds完整写入 ST77916 寄存器序列最终封装为SpiLcdDisplay实例。电源与低功耗管理通过AdcBatteryMonitorADC 通道 3量程 5.1 V检测电池电压与充电状态PowerSaveTimer在空闲 240 秒后进入屏幕省电模式充电时自动禁用省电定时器。config.json中开启的 tickless idle 模式为这类省电逻辑提供了底层支撑。交互按键BOOT 键GPIO28在启动阶段短按直接进入 Wi-Fi 配网模式正常运行状态下单击切换对话状态按住期间配合PressToTalkMcpToolmain/boards/common/press_to_talk_mcp_tool.cc实现按下讲话的 MCP 对讲功能按下唤醒省电定时器并开始录音松开即结束本轮语音输入。板载单 LEDGPIO10用于状态指示。烧录后首次使用固件烧录完成后通过idf.py monitor观察启动日志。首次使用需要配网设备会以热点方式广播 Wi-Fi 配置入口USE_HOTSPOT_WIFI_PROVISIONING默认开启连接后按提示输入 Wi-Fi 账号密码即可。配网与更多功能说明可参考仓库根目录的 README_zh.md 与 docs/blufi_zh.md。常见问题排查menuconfig 中找不到 Movecall Moji 2.0 选项确认已执行idf.py set-target esp32c5该选项仅在目标芯片为 ESP32-C5 时可见。编译报错且原因不明优先执行idf.py fullclean清理缓存后重新idf.py build。唤醒词不生效检查 sdkconfig 中CONFIG_USE_ESP_WAKE_WORD与CONFIG_SR_WN_WN9S_NIHAOXIAOZHI是否启用ESP32-C5 平台使用不带 AFE 的 Wakenet 模型路径见 sdkconfig.defaults.esp32c5。屏幕异常或花屏确认 QSPI 屏线序与 config.h 中DISPLAY_QSPI_*引脚定义一致该板依赖 40 MHz QSPI 时序排线质量与焊接会直接影响显示稳定性。【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
