小智AI_ESP32C3_新增或修改板卡名称

本文介绍了为ESP32开发板添加新板卡配置的过程。首先下载xiaozhi-esp32代码库，测试"虾哥MiniC3"板卡能否正常编译。然后复制现有板卡代码创建新板卡"ymy_c3_ceshi"，在CMakeLists.txt和Kconfig.projbuild中添加新配置项，并修改config.json文件中的板卡名称。完成配置后先使用原有板卡测试编译，确认

James�Ye

673人浏览 · 2025-08-15 17:02:52

James�Ye · 2025-08-15 17:02:52 发布

一、下载 xiaozhi-esp32

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

二、先测试 “虾哥 Mini C3” 板卡能否正常编译

// 进入xiaozhi-esp32目录
cd xiaozhi-esp32

// 配置为ESP32C3
idf.py set-target esp32c3

// 进入menuconfig配置，并选择“虾哥 Mini C3”板卡
idf.py menuconfig
Xiaozhi Assistant → Board Type → 虾哥 Mini C3
    
// 编译
idf.py build
    
// 烧录测试
idf.py -p /dev/ttyS8 flash

三、复制 “xmini-c3” 板卡代码，并命名为 "ymy_c3_ceshi"

四、新增或修改新板卡配置

4.1 添加构建配置

在xiaozhi-esp32/main/CMakeLists.txt 添加编译构建指令

elseif(CONFIG_BOARD_TYPE_XMINI_C3)
    set(BOARD_TYPE "xmini-c3")
elseif(CONFIG_BOARD_TYPE_YMY_C3_CESHI)
    set(BOARD_TYPE "ymy-c3-ceshi")

在xiaozhi-esp32/main/Kconfig.projbuild添加配置指令

config BOARD_TYPE_XMINI_C3
    bool "虾哥 Mini C3"
    depends on IDF_TARGET_ESP32C3
config BOARD_TYPE_YMY_C3_CESHI
    bool "ymy C3 Ceshi"
    depends on IDF_TARGET_ESP32C3

4.2 修改板卡"name"

在xiaozhi-esp32/main/boards/ymy_c3_ceshi/config.json修改name

{
    "target": "esp32c3",
    "builds": [
        {
            "name": "ymy-c3-ceshi",
            "sdkconfig_append": [
                "CONFIG_PM_ENABLE=y",
                "CONFIG_FREERTOS_USE_TICKLESS_IDLE=y",
                "CONFIG_USE_ESP_WAKE_WORD=y",
                "CONFIG_ESP_CONSOLE_USB_SERIAL_JTAG=y"
            ]
        }
    ]
}

五、新增板卡配置后先用“虾哥 Mini C3” 板卡测试能否编译成功

idf.py build

六、选择新增的板卡

如果第五步编译成功，说明新增板卡的配置没有问题，此时就可以进入menuconfig配置菜单选择我们新建的板卡啦！

// 进入menuconfig配置，并选择新增的板卡“ymy_c3_ceshi”
idf.py menuconfig
Xiaozhi Assistant → Board Type → ymy_c3_ceshi
    
// 编译
idf.py build
    
// 烧录测试
idf.py -p /dev/ttyS8 flash