xiaozhi-esp32 接入 RYMCU BigSmart 开发板硬件适配、源码解析与固件编译指南【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32本文以 xiaozhi-esp32 开源项目中的 RYMCU BigSmart 开发板适配为主题完整介绍该板卡的硬件资源映射、GPIO 引脚分配、关键外设触摸、摄像头、IO 扩展芯片的初始化原理以及基于 ESP-IDF 的完整编译烧录流程。读完本文你将掌握如何为该板卡配置构建目标、理解板级驱动源码的调用关系并能独立完成固件的编译与部署。一、RYMCU BigSmart 板卡概述RYMCU BigSmart 是乐鑫 ESP32-S3 生态下的一块多功能 AI 开发板xiaozhi-esp32 项目为其提供了开箱即用的板级适配源码位于 main/boards/rymcu/bigsmart/。该目录共包含四个文件文件作用README.md板卡适配说明与编译指引config.h板级 GPIO 引脚与硬件参数宏定义config.json构建配置manufacturer、type、target 与 sdkconfig 追加项rymcu_bigsmart_board.cc板级驱动实现Board 类及各外设初始化按照官方硬件文档该板卡的核心硬件资源如下主控ESP32-S3-WROOM-1-N16R816MB Flash 8MB PSRAM显示ST7789320x240 分辨率SPI 接口触摸GT911 电容触摸I2C 接口音频ES8311音频编解码 ES7210ADCI2S I2C 接口IO 扩展PCA9557I2C 地址0x19摄像头GC0308DVP 并行接口由于 BigSmart 同时具备屏幕、触摸、双麦克风音频、摄像头和 RGB LED它非常适合作为带视觉能力的桌面级 AI 语音助手终端。二、构建系统如何识别该板卡在编译之前需要理解 xiaozhi-esp32 是如何把「菜单选择」和「具体源码目录」绑定起来的这涉及三个层面的配置1. Kconfig 中的板卡选项在 main/Kconfig.projbuild 中定义了板卡选择菜单Target Board其中 RYMCU BigSmart 对应的配置项为config BOARD_TYPE_RYMCU_BIGSMART bool RYMCU BigSmart depends on IDF_TARGET_ESP32S3注意depends on IDF_TARGET_ESP32S3——这意味着必须先执行idf.py set-target esp32s3把目标芯片设为 ESP32-S3菜单中才会出现该选项。同时该板卡还出现在两处功能开关的依赖列表中USE_EMOTE_MESSAGE_STYLEEmote 表情动画显示风格的依赖中包含BOARD_TYPE_RYMCU_BIGSMARTUSE_DEVICE_AEC设备端回声消除的依赖中包含BOARD_TYPE_RYMCU_BIGSMART。2. CMake 中的源码目录绑定在 main/CMakeLists.txt 中当选中CONFIG_BOARD_TYPE_RYMCU_BIGSMART时elseif(CONFIG_BOARD_TYPE_RYMCU_BIGSMART) set(BOARD_DIR rymcu/bigsmart) set(BUILTIN_TEXT_FONT font_noto_sans_basic_20_4) set(BUILTIN_ICON_FONT font_material_symbols_20_4) set(DEFAULT_EMOJI_COLLECTION noto-color-emoji_128)即把板级源码目录定位到boards/rymcu/bigsmart同时为该板卡选用 20x4 的 Noto Sans 基础字体、Material Symbols 图标字体以及 128px 的彩色 emoji 资源适配 320x240 屏幕的显示密度。随后 CMake 会通过file(GLOB ...)自动收集该目录下的*.cc/*.c源文件参与编译。3. config.json 的构建元信息main/boards/rymcu/bigsmart/config.json 内容如下{ manufacturer: rymcu, type: bigsmart, target: esp32s3, builds: [ { name: rymcu-bigsmart, sdkconfig_append: [ CONFIG_USE_DEVICE_AECy ] } ] }该文件在 CMake 中被解析见 main/CMakeLists.txt 中BOARD_CONFIG_FILE的读取逻辑其中manufacturer/type会被固件用于上报板卡型号与厂商信息builds[].sdkconfig_append会在构建该固件变体时自动追加CONFIG_USE_DEVICE_AECy即默认开启设备端回声消除AEC。这与板卡采用 ES8311 输出 ES7210 双麦输入的架构相匹配——AEC 依赖干净的扬声器参考信号与麦克风/喇叭之间的物理隔离。三、引脚映射与硬件参数config.h 详解main/boards/rymcu/bigsmart/config.h 是理解整个适配的核心文件。它通过宏定义了所有外设的 GPIO 与参数以下按外设分组解读。音频I2S I2C#define AUDIO_INPUT_SAMPLE_RATE 24000 #define AUDIO_OUTPUT_SAMPLE_RATE 24000 #define AUDIO_INPUT_REFERENCE true #define AUDIO_I2S_GPIO_MCLK GPIO_NUM_38 #define AUDIO_I2S_GPIO_WS GPIO_NUM_13 #define AUDIO_I2S_GPIO_BCLK GPIO_NUM_14 #define AUDIO_I2S_GPIO_DIN GPIO_NUM_12 #define AUDIO_I2S_GPIO_DOUT GPIO_NUM_45 #define AUDIO_CODEC_USE_PCA9557 #define AUDIO_CODEC_I2C_SDA_PIN GPIO_NUM_1 #define AUDIO_CODEC_I2C_SCL_PIN GPIO_NUM_2 #define AUDIO_CODEC_ES8311_ADDR ES8311_CODEC_DEFAULT_ADDR #define AUDIO_CODEC_ES7210_ADDR 0x82采样率统一为 24000 HzAUDIO_INPUT_REFERENCE true表示输入侧使用参考信号为 AEC 提供扬声器输出的参考路径ES8311 负责 DAC播放ES7210 负责 ADC录音两者共享同一 I2S 数据总线DIN/DOUT 分离与 I2C 控制总线SDAGPIO1、SCLGPIO2宏AUDIO_CODEC_USE_PCA9557表明音频功放使能引脚并非直接接 GPIO而是通过 PCA9557 扩展 IO 控制。按键与 LED#define BUILTIN_LED_GPIO GPIO_NUM_NC #define RGB_LED_GPIO GPIO_NUM_43 #define BOOT_BUTTON_GPIO GPIO_NUM_0 #define CUSTOM_BUTTON_GPIO GPIO_NUM_10 #define VOLUME_UP_BUTTON_GPIO GPIO_NUM_NC #define VOLUME_DOWN_BUTTON_GPIO GPIO_NUM_NC板卡没有独立内置 LED 和实体音量键而是提供一颗 RGB LEDGPIO43与两个按键BOOT 键GPIO0和自定义功能键GPIO10。显示与背光#define DISPLAY_WIDTH 320 #define DISPLAY_HEIGHT 240 #define DISPLAY_MIRROR_X true #define DISPLAY_MIRROR_Y false #define DISPLAY_SWAP_XY true #define DISPLAY_OFFSET_X 0 #define DISPLAY_OFFSET_Y 0 #define DISPLAY_BACKLIGHT_PIN GPIO_NUM_42 #define DISPLAY_BACKLIGHT_OUTPUT_INVERT trueST7789 屏幕 320x240需要交换 X/Y 轴并对 X 方向镜像这是竖屏/横屏安装方向差异的常见处理方式背光由 GPIO42 输出且极性反转高电平关闭背光。触摸#define TOUCH_INT_GPIO GPIO_NUM_NC #define TOUCH_RST_GPIO GPIO_NUM_NCGT911 的中断与复位引脚均未连接NC驱动以轮询方式工作。摄像头GC0308DVP#define CAMERA_PIN_PWDN GPIO_NUM_NC #define CAMERA_PIN_RESET GPIO_NUM_NC #define CAMERA_PIN_XCLK GPIO_NUM_5 #define CAMERA_PIN_SIOD GPIO_NUM_1 #define CAMERA_PIN_SIOC GPIO_NUM_2 #define CAMERA_PIN_D7 GPIO_NUM_9 #define CAMERA_PIN_D6 GPIO_NUM_4 #define CAMERA_PIN_D5 GPIO_NUM_6 #define CAMERA_PIN_D4 GPIO_NUM_15 #define CAMERA_PIN_D3 GPIO_NUM_17 #define CAMERA_PIN_D2 GPIO_NUM_8 #define CAMERA_PIN_D1 GPIO_NUM_18 #define CAMERA_PIN_D0 GPIO_NUM_16 #define CAMERA_PIN_VSYNC GPIO_NUM_44 #define CAMERA_PIN_HREF GPIO_NUM_46 #define CAMERA_PIN_PCLK GPIO_NUM_7 #define XCLK_FREQ_HZ 16000000摄像头 SCCB 控制总线SIOD/SIOC与音频 I2C 复用 GPIO1/GPIO2。XCLK 时钟为 16 MHz。电池#define BATTERY_CHARGING_PIN GPIO_NUM_3 #define BATTERY_ADC_PIN GPIO_NUM_11通过 ADC 引脚采集电池电压、充电检测引脚判断充电状态供系统电量显示使用。四、板级驱动源码解析rymcu_bigsmart_board.ccmain/boards/rymcu/bigsmart/rymcu_bigsmart_board.cc 中定义了RymcuBigsmartBoard类继承自WifiBoard并在文件末尾通过DECLARE_BOARD(RymcuBigsmartBoard)宏注册为板级入口该宏定义见 main/boards/common/board.h其作用是为create_board()工厂函数返回板卡实例。构造函数依次完成各外设初始化。1. I2C 总线与 PCA9557 扩展芯片InitializeI2c()使用i2c_new_master_bus创建 I2C 主机总线SDAGPIO1、SCLGPIO2随后实例化Pca9557设备。PCA9557 是一个 8 位 GPIO 扩展器驱动类在其构造函数中完成初始寄存器配置Pca9557(i2c_master_bus_handle_t i2c_bus, uint8_t addr) : I2cDevice(i2c_bus, addr) { WriteReg(0x01, 0x03); WriteReg(0x03, 0xf8); }其中0x01为输出端口寄存器0x03为配置寄存器。从后续调用可以看出 PCA9557 各输出位的用途bit0LCD 复位控制InitializeSt7789Display()中pca9557_-SetOutputState(0, 0)触发屏幕复位bit1音频功放使能CustomAudioCodec::EnableOutput()中控制bit2摄像头电源控制InitializeCamera()中SetOutputState(2, 0)上电。这种设计把多个外设的开关控制集中到一颗扩展芯片上节省了主控 GPIO。2. 音频编解码CustomAudioCodecCustomAudioCodec继承自BoxAudioCodec实现见 main/audio/codecs/box_audio_codec.h构造时传入 ES8311 与 ES7210 的 I2C 地址以及 MCLK/BCLK/WS/DOUT/DIN 引脚。它只重写了EnableOutput(bool)virtual void EnableOutput(bool enable) override { BoxAudioCodec::EnableOutput(enable); if (enable) { pca9557_-SetOutputState(1, 1); // 通过 PCA9557 打开功放 } else { pca9557_-SetOutputState(1, 0); } }即功放使能不直接由 GPIO 驱动而是经由 PCA9557 的 bit1 控制与 config.h 中AUDIO_CODEC_USE_PCA9557宏呼应。3. 显示初始化InitializeSt7789Display()使用esp_lcd驱动框架在 SPI3 主机上创建 ST7789 面板SPI 时钟 80 MHz、SPI mode 2、16bit RGB565并调用esp_lcd_panel_invert_color(panel, true)反转颜色ST7789 常见处理再根据DISPLAY_SWAP_XY/DISPLAY_MIRROR_X进行坐标变换。屏幕点亮后根据编译选项选择显示风格#if CONFIG_USE_EMOTE_MESSAGE_STYLE display_ new emote::EmoteDisplay(panel, panel_io, DISPLAY_WIDTH, DISPLAY_HEIGHT); #else display_ new SpiLcdDisplay(panel_io, panel, ...); #endif即若在 menuconfig 中启用了USE_EMOTE_MESSAGE_STYLE表情动画风格则使用 main/display/emote_display.cc 中的EmoteDisplay否则使用常规的SpiLcdDisplay。4. GT911 触摸初始化InitializeTouch()在 I2C 总线上以 GT911 的 I2C 地址创建触摸面板 IO配置坐标上限x_maxDISPLAY_HEIGHT、y_maxDISPLAY_WIDTH与DISPLAY_SWAP_XY保持一致并通过lvgl_port_add_touch将触摸接入 LVGL 输入系统。由于 INT/RST 引脚为 NClevels与复位中断标志按驱动要求设置。5. GC0308 摄像头初始化InitializeCamera()先通过 PCA9557 给摄像头供电然后构建camera_config_tRGB565 输出、QVGA 分辨率、JPEG 质量 12、帧缓冲置于 PSRAMCAMERA_FB_IN_PSRAM得益于 N16R8 的 8MB PSRAM、CAMERA_GRAB_WHEN_EMPTY抓帧模式最终封装为Esp32Camera实现见 main/boards/common/esp32_camera.cc。6. 按键交互逻辑InitializeButtons()为 BOOT 键注册了交互逻辑单击若设备处于启动状态kDeviceStateStarting则进入 WiFi 配置模式否则切换对话开关状态ToggleChatState()双击仅在CONFIG_USE_DEVICE_AEC开启时编译在空闲状态下切换设备端 AEC 的开关。7. MCP 工具注册InitializeTools()通过 main/mcp_server.h 中的McpServer::GetInstance()注册了一个名为self.system.reconfigure_wifi的 MCP 工具其作用是结束当前对话并进入 WiFi 配置模式且提示 AI 必须先获得用户确认。这体现了本项目基于 MCPModel Context Protocol的能力设备端把系统动作暴露为可供大模型调用的工具。五、编译与烧录步骤1. 环境准备编译 xiaozhi-esp32 需要 ESP-IDF 工具链当前仓库适配的 IDF 版本请以项目根目录 README.md 与 sdkconfig.defaults 为准。项目根目录还提供了针对不同芯片的默认配置例如 sdkconfig.defaults.esp32s3。2. 设置目标芯片并配置idf.py set-target esp32s3 idf.py menuconfig3. 选择板卡在 menuconfig 菜单中依次进入Xiaozhi Assistant - Target Board - RYMCU BigSmart选中后相关依赖项会自动生效Xiaozhi Assistant - Display Style中可选择Emote animation style表情动画风格该选项依赖中包含 RYMCU BigSmartXiaozhi Assistant - Enable Device-Side AEC设备端回声消除对该板卡可用且通过 config.json 的sdkconfig_append会在构建时自动追加开启。4. 编译idf.py build编译产物生成后可通过常规方式烧录idf.py flash monitor5. 首次配网固件启动后单击 BOOT 键GPIO0可进入 WiFi 配置模式通过手机配网项目支持 Hotspot 与 ESP-BluFi 两种配网方式见 main/Kconfig.projbuild 中的WiFi Configuration Method菜单。配网成功后设备即可接入对话服务。六、常见问题与调试建议菜单中看不到 RYMCU BigSmart确认已执行idf.py set-target esp32s3该选项依赖IDF_TARGET_ESP32S3。音频无声或录音异常确认 PCA9557 的 bit1 功放使能被正确驱动检查AUDIO_CODEC_ES8311_ADDR与AUDIO_CODEC_ES7210_ADDRES7210 为0x82是否与硬件一致。摄像头画面异常颜色/方向在 menuconfig 的Camera Configuration菜单中调整镜像/翻转选项或检查 PSRAM 配置是否生效。屏幕颜色反相或方向不对对应esp_lcd_panel_invert_color与DISPLAY_SWAP_XY/DISPLAY_MIRROR_X等宏可按实际屏幕批次在 config.h 中调整后重新编译。七、相关资源板卡适配说明main/boards/rymcu/bigsmart/README.md引脚定义main/boards/rymcu/bigsmart/config.h驱动实现main/boards/rymcu/bigsmart/rymcu_bigsmart_board.cc构建元信息main/boards/rymcu/bigsmart/config.json板卡选择菜单main/Kconfig.projbuild板卡源码绑定main/CMakeLists.txt音频编解码基类main/audio/codecs/box_audio_codec.h摄像头通用封装main/boards/common/esp32_camera.cc表情动画显示main/display/emote_display.cc从引脚宏定义到驱动源码RYMCU BigSmart 的适配展示了 xiaozhi-esp32 板级移植的标准范式Kconfig 注册 → CMake 绑定源码目录 → config.h 定义引脚 → Board 类统一初始化。理解这一链路后你也可以参照 docs/custom-board.md 为任意 ESP32-S3 开发板编写自己的适配。【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 xiaozhi-esp32 接入 RYMCU BigSmart 开发板：硬件适配、源码解析与固件编译指南
xiaozhi-esp32 接入 RYMCU BigSmart 开发板硬件适配、源码解析与固件编译指南【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32本文以 xiaozhi-esp32 开源项目中的 RYMCU BigSmart 开发板适配为主题完整介绍该板卡的硬件资源映射、GPIO 引脚分配、关键外设触摸、摄像头、IO 扩展芯片的初始化原理以及基于 ESP-IDF 的完整编译烧录流程。读完本文你将掌握如何为该板卡配置构建目标、理解板级驱动源码的调用关系并能独立完成固件的编译与部署。一、RYMCU BigSmart 板卡概述RYMCU BigSmart 是乐鑫 ESP32-S3 生态下的一块多功能 AI 开发板xiaozhi-esp32 项目为其提供了开箱即用的板级适配源码位于 main/boards/rymcu/bigsmart/。该目录共包含四个文件文件作用README.md板卡适配说明与编译指引config.h板级 GPIO 引脚与硬件参数宏定义config.json构建配置manufacturer、type、target 与 sdkconfig 追加项rymcu_bigsmart_board.cc板级驱动实现Board 类及各外设初始化按照官方硬件文档该板卡的核心硬件资源如下主控ESP32-S3-WROOM-1-N16R816MB Flash 8MB PSRAM显示ST7789320x240 分辨率SPI 接口触摸GT911 电容触摸I2C 接口音频ES8311音频编解码 ES7210ADCI2S I2C 接口IO 扩展PCA9557I2C 地址0x19摄像头GC0308DVP 并行接口由于 BigSmart 同时具备屏幕、触摸、双麦克风音频、摄像头和 RGB LED它非常适合作为带视觉能力的桌面级 AI 语音助手终端。二、构建系统如何识别该板卡在编译之前需要理解 xiaozhi-esp32 是如何把「菜单选择」和「具体源码目录」绑定起来的这涉及三个层面的配置1. Kconfig 中的板卡选项在 main/Kconfig.projbuild 中定义了板卡选择菜单Target Board其中 RYMCU BigSmart 对应的配置项为config BOARD_TYPE_RYMCU_BIGSMART bool RYMCU BigSmart depends on IDF_TARGET_ESP32S3注意depends on IDF_TARGET_ESP32S3——这意味着必须先执行idf.py set-target esp32s3把目标芯片设为 ESP32-S3菜单中才会出现该选项。同时该板卡还出现在两处功能开关的依赖列表中USE_EMOTE_MESSAGE_STYLEEmote 表情动画显示风格的依赖中包含BOARD_TYPE_RYMCU_BIGSMARTUSE_DEVICE_AEC设备端回声消除的依赖中包含BOARD_TYPE_RYMCU_BIGSMART。2. CMake 中的源码目录绑定在 main/CMakeLists.txt 中当选中CONFIG_BOARD_TYPE_RYMCU_BIGSMART时elseif(CONFIG_BOARD_TYPE_RYMCU_BIGSMART) set(BOARD_DIR rymcu/bigsmart) set(BUILTIN_TEXT_FONT font_noto_sans_basic_20_4) set(BUILTIN_ICON_FONT font_material_symbols_20_4) set(DEFAULT_EMOJI_COLLECTION noto-color-emoji_128)即把板级源码目录定位到boards/rymcu/bigsmart同时为该板卡选用 20x4 的 Noto Sans 基础字体、Material Symbols 图标字体以及 128px 的彩色 emoji 资源适配 320x240 屏幕的显示密度。随后 CMake 会通过file(GLOB ...)自动收集该目录下的*.cc/*.c源文件参与编译。3. config.json 的构建元信息main/boards/rymcu/bigsmart/config.json 内容如下{ manufacturer: rymcu, type: bigsmart, target: esp32s3, builds: [ { name: rymcu-bigsmart, sdkconfig_append: [ CONFIG_USE_DEVICE_AECy ] } ] }该文件在 CMake 中被解析见 main/CMakeLists.txt 中BOARD_CONFIG_FILE的读取逻辑其中manufacturer/type会被固件用于上报板卡型号与厂商信息builds[].sdkconfig_append会在构建该固件变体时自动追加CONFIG_USE_DEVICE_AECy即默认开启设备端回声消除AEC。这与板卡采用 ES8311 输出 ES7210 双麦输入的架构相匹配——AEC 依赖干净的扬声器参考信号与麦克风/喇叭之间的物理隔离。三、引脚映射与硬件参数config.h 详解main/boards/rymcu/bigsmart/config.h 是理解整个适配的核心文件。它通过宏定义了所有外设的 GPIO 与参数以下按外设分组解读。音频I2S I2C#define AUDIO_INPUT_SAMPLE_RATE 24000 #define AUDIO_OUTPUT_SAMPLE_RATE 24000 #define AUDIO_INPUT_REFERENCE true #define AUDIO_I2S_GPIO_MCLK GPIO_NUM_38 #define AUDIO_I2S_GPIO_WS GPIO_NUM_13 #define AUDIO_I2S_GPIO_BCLK GPIO_NUM_14 #define AUDIO_I2S_GPIO_DIN GPIO_NUM_12 #define AUDIO_I2S_GPIO_DOUT GPIO_NUM_45 #define AUDIO_CODEC_USE_PCA9557 #define AUDIO_CODEC_I2C_SDA_PIN GPIO_NUM_1 #define AUDIO_CODEC_I2C_SCL_PIN GPIO_NUM_2 #define AUDIO_CODEC_ES8311_ADDR ES8311_CODEC_DEFAULT_ADDR #define AUDIO_CODEC_ES7210_ADDR 0x82采样率统一为 24000 HzAUDIO_INPUT_REFERENCE true表示输入侧使用参考信号为 AEC 提供扬声器输出的参考路径ES8311 负责 DAC播放ES7210 负责 ADC录音两者共享同一 I2S 数据总线DIN/DOUT 分离与 I2C 控制总线SDAGPIO1、SCLGPIO2宏AUDIO_CODEC_USE_PCA9557表明音频功放使能引脚并非直接接 GPIO而是通过 PCA9557 扩展 IO 控制。按键与 LED#define BUILTIN_LED_GPIO GPIO_NUM_NC #define RGB_LED_GPIO GPIO_NUM_43 #define BOOT_BUTTON_GPIO GPIO_NUM_0 #define CUSTOM_BUTTON_GPIO GPIO_NUM_10 #define VOLUME_UP_BUTTON_GPIO GPIO_NUM_NC #define VOLUME_DOWN_BUTTON_GPIO GPIO_NUM_NC板卡没有独立内置 LED 和实体音量键而是提供一颗 RGB LEDGPIO43与两个按键BOOT 键GPIO0和自定义功能键GPIO10。显示与背光#define DISPLAY_WIDTH 320 #define DISPLAY_HEIGHT 240 #define DISPLAY_MIRROR_X true #define DISPLAY_MIRROR_Y false #define DISPLAY_SWAP_XY true #define DISPLAY_OFFSET_X 0 #define DISPLAY_OFFSET_Y 0 #define DISPLAY_BACKLIGHT_PIN GPIO_NUM_42 #define DISPLAY_BACKLIGHT_OUTPUT_INVERT trueST7789 屏幕 320x240需要交换 X/Y 轴并对 X 方向镜像这是竖屏/横屏安装方向差异的常见处理方式背光由 GPIO42 输出且极性反转高电平关闭背光。触摸#define TOUCH_INT_GPIO GPIO_NUM_NC #define TOUCH_RST_GPIO GPIO_NUM_NCGT911 的中断与复位引脚均未连接NC驱动以轮询方式工作。摄像头GC0308DVP#define CAMERA_PIN_PWDN GPIO_NUM_NC #define CAMERA_PIN_RESET GPIO_NUM_NC #define CAMERA_PIN_XCLK GPIO_NUM_5 #define CAMERA_PIN_SIOD GPIO_NUM_1 #define CAMERA_PIN_SIOC GPIO_NUM_2 #define CAMERA_PIN_D7 GPIO_NUM_9 #define CAMERA_PIN_D6 GPIO_NUM_4 #define CAMERA_PIN_D5 GPIO_NUM_6 #define CAMERA_PIN_D4 GPIO_NUM_15 #define CAMERA_PIN_D3 GPIO_NUM_17 #define CAMERA_PIN_D2 GPIO_NUM_8 #define CAMERA_PIN_D1 GPIO_NUM_18 #define CAMERA_PIN_D0 GPIO_NUM_16 #define CAMERA_PIN_VSYNC GPIO_NUM_44 #define CAMERA_PIN_HREF GPIO_NUM_46 #define CAMERA_PIN_PCLK GPIO_NUM_7 #define XCLK_FREQ_HZ 16000000摄像头 SCCB 控制总线SIOD/SIOC与音频 I2C 复用 GPIO1/GPIO2。XCLK 时钟为 16 MHz。电池#define BATTERY_CHARGING_PIN GPIO_NUM_3 #define BATTERY_ADC_PIN GPIO_NUM_11通过 ADC 引脚采集电池电压、充电检测引脚判断充电状态供系统电量显示使用。四、板级驱动源码解析rymcu_bigsmart_board.ccmain/boards/rymcu/bigsmart/rymcu_bigsmart_board.cc 中定义了RymcuBigsmartBoard类继承自WifiBoard并在文件末尾通过DECLARE_BOARD(RymcuBigsmartBoard)宏注册为板级入口该宏定义见 main/boards/common/board.h其作用是为create_board()工厂函数返回板卡实例。构造函数依次完成各外设初始化。1. I2C 总线与 PCA9557 扩展芯片InitializeI2c()使用i2c_new_master_bus创建 I2C 主机总线SDAGPIO1、SCLGPIO2随后实例化Pca9557设备。PCA9557 是一个 8 位 GPIO 扩展器驱动类在其构造函数中完成初始寄存器配置Pca9557(i2c_master_bus_handle_t i2c_bus, uint8_t addr) : I2cDevice(i2c_bus, addr) { WriteReg(0x01, 0x03); WriteReg(0x03, 0xf8); }其中0x01为输出端口寄存器0x03为配置寄存器。从后续调用可以看出 PCA9557 各输出位的用途bit0LCD 复位控制InitializeSt7789Display()中pca9557_-SetOutputState(0, 0)触发屏幕复位bit1音频功放使能CustomAudioCodec::EnableOutput()中控制bit2摄像头电源控制InitializeCamera()中SetOutputState(2, 0)上电。这种设计把多个外设的开关控制集中到一颗扩展芯片上节省了主控 GPIO。2. 音频编解码CustomAudioCodecCustomAudioCodec继承自BoxAudioCodec实现见 main/audio/codecs/box_audio_codec.h构造时传入 ES8311 与 ES7210 的 I2C 地址以及 MCLK/BCLK/WS/DOUT/DIN 引脚。它只重写了EnableOutput(bool)virtual void EnableOutput(bool enable) override { BoxAudioCodec::EnableOutput(enable); if (enable) { pca9557_-SetOutputState(1, 1); // 通过 PCA9557 打开功放 } else { pca9557_-SetOutputState(1, 0); } }即功放使能不直接由 GPIO 驱动而是经由 PCA9557 的 bit1 控制与 config.h 中AUDIO_CODEC_USE_PCA9557宏呼应。3. 显示初始化InitializeSt7789Display()使用esp_lcd驱动框架在 SPI3 主机上创建 ST7789 面板SPI 时钟 80 MHz、SPI mode 2、16bit RGB565并调用esp_lcd_panel_invert_color(panel, true)反转颜色ST7789 常见处理再根据DISPLAY_SWAP_XY/DISPLAY_MIRROR_X进行坐标变换。屏幕点亮后根据编译选项选择显示风格#if CONFIG_USE_EMOTE_MESSAGE_STYLE display_ new emote::EmoteDisplay(panel, panel_io, DISPLAY_WIDTH, DISPLAY_HEIGHT); #else display_ new SpiLcdDisplay(panel_io, panel, ...); #endif即若在 menuconfig 中启用了USE_EMOTE_MESSAGE_STYLE表情动画风格则使用 main/display/emote_display.cc 中的EmoteDisplay否则使用常规的SpiLcdDisplay。4. GT911 触摸初始化InitializeTouch()在 I2C 总线上以 GT911 的 I2C 地址创建触摸面板 IO配置坐标上限x_maxDISPLAY_HEIGHT、y_maxDISPLAY_WIDTH与DISPLAY_SWAP_XY保持一致并通过lvgl_port_add_touch将触摸接入 LVGL 输入系统。由于 INT/RST 引脚为 NClevels与复位中断标志按驱动要求设置。5. GC0308 摄像头初始化InitializeCamera()先通过 PCA9557 给摄像头供电然后构建camera_config_tRGB565 输出、QVGA 分辨率、JPEG 质量 12、帧缓冲置于 PSRAMCAMERA_FB_IN_PSRAM得益于 N16R8 的 8MB PSRAM、CAMERA_GRAB_WHEN_EMPTY抓帧模式最终封装为Esp32Camera实现见 main/boards/common/esp32_camera.cc。6. 按键交互逻辑InitializeButtons()为 BOOT 键注册了交互逻辑单击若设备处于启动状态kDeviceStateStarting则进入 WiFi 配置模式否则切换对话开关状态ToggleChatState()双击仅在CONFIG_USE_DEVICE_AEC开启时编译在空闲状态下切换设备端 AEC 的开关。7. MCP 工具注册InitializeTools()通过 main/mcp_server.h 中的McpServer::GetInstance()注册了一个名为self.system.reconfigure_wifi的 MCP 工具其作用是结束当前对话并进入 WiFi 配置模式且提示 AI 必须先获得用户确认。这体现了本项目基于 MCPModel Context Protocol的能力设备端把系统动作暴露为可供大模型调用的工具。五、编译与烧录步骤1. 环境准备编译 xiaozhi-esp32 需要 ESP-IDF 工具链当前仓库适配的 IDF 版本请以项目根目录 README.md 与 sdkconfig.defaults 为准。项目根目录还提供了针对不同芯片的默认配置例如 sdkconfig.defaults.esp32s3。2. 设置目标芯片并配置idf.py set-target esp32s3 idf.py menuconfig3. 选择板卡在 menuconfig 菜单中依次进入Xiaozhi Assistant - Target Board - RYMCU BigSmart选中后相关依赖项会自动生效Xiaozhi Assistant - Display Style中可选择Emote animation style表情动画风格该选项依赖中包含 RYMCU BigSmartXiaozhi Assistant - Enable Device-Side AEC设备端回声消除对该板卡可用且通过 config.json 的sdkconfig_append会在构建时自动追加开启。4. 编译idf.py build编译产物生成后可通过常规方式烧录idf.py flash monitor5. 首次配网固件启动后单击 BOOT 键GPIO0可进入 WiFi 配置模式通过手机配网项目支持 Hotspot 与 ESP-BluFi 两种配网方式见 main/Kconfig.projbuild 中的WiFi Configuration Method菜单。配网成功后设备即可接入对话服务。六、常见问题与调试建议菜单中看不到 RYMCU BigSmart确认已执行idf.py set-target esp32s3该选项依赖IDF_TARGET_ESP32S3。音频无声或录音异常确认 PCA9557 的 bit1 功放使能被正确驱动检查AUDIO_CODEC_ES8311_ADDR与AUDIO_CODEC_ES7210_ADDRES7210 为0x82是否与硬件一致。摄像头画面异常颜色/方向在 menuconfig 的Camera Configuration菜单中调整镜像/翻转选项或检查 PSRAM 配置是否生效。屏幕颜色反相或方向不对对应esp_lcd_panel_invert_color与DISPLAY_SWAP_XY/DISPLAY_MIRROR_X等宏可按实际屏幕批次在 config.h 中调整后重新编译。七、相关资源板卡适配说明main/boards/rymcu/bigsmart/README.md引脚定义main/boards/rymcu/bigsmart/config.h驱动实现main/boards/rymcu/bigsmart/rymcu_bigsmart_board.cc构建元信息main/boards/rymcu/bigsmart/config.json板卡选择菜单main/Kconfig.projbuild板卡源码绑定main/CMakeLists.txt音频编解码基类main/audio/codecs/box_audio_codec.h摄像头通用封装main/boards/common/esp32_camera.cc表情动画显示main/display/emote_display.cc从引脚宏定义到驱动源码RYMCU BigSmart 的适配展示了 xiaozhi-esp32 板级移植的标准范式Kconfig 注册 → CMake 绑定源码目录 → config.h 定义引脚 → Board 类统一初始化。理解这一链路后你也可以参照 docs/custom-board.md 为任意 ESP32-S3 开发板编写自己的适配。【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考