36-适配自己的板卡
输入“/”快速插入内容
36-适配自己的板卡
36-适配自己的板卡
用户5985用户59852025年5月9日修改
如果你自己画了PCB板，需要把自己绘制的板卡配置小智AI工程，可以参考此文档。
下载源码
克隆或下载源码到本地，这里以1.5.5为例，大家可以自行修改其它版本
代码块
虾哥版本的源码
https://github.com/78/xiaozhi-esp32/tree/v1.5.5
代码结构
仓库包含多个文件和文件夹，主要结构如下：
代码块
.gitignore git工程管理文件
CMakeLists.txt 工程cmake构建文件
LICENSE MIT License 允许用户自由使用、修改和分发代码，只需在软件或文档中包含原作者的版权声明和许可声明即可。
README.md README说明文档_中文
README_en.md README说明文档_英文
README_ja.md README说明文档_日文
partitions.csv 分区配置文件：16M Flash的分区表，默认选择，可以通过idf.py menuconfig修改，建议选择支持16M的硬件，后续扩展开发和OTA更方便
partitions_32M_sensecap.csv 分区配置文件：32M Flash的分区表
partitions_4M.csv 分区配置文件：4M Flash的分区表
partitions_8M.csv 分区配置文件：8M Flash的分区表
sdkconfig.defaults idf sdk默认配置,工程目前支持esp32s3和esp32c3两款芯片，只有s3支持唤醒词，基于乐鑫esp-sr实现
sdkconfig.defaults.esp32c3 idf sdk esp32c3默认配置
sdkconfig.defaults.esp32s3 idf sdk esp32s3默认配置
docs/ 文档文件，里面包含README文档使用的图片资料，还有一份服务器websocket交互协议
scripts/ 脚本文件，包含音频编码测试脚本、烧录调试脚本、版本打包相关脚本
.github/ GitHub Actions 的配置文件（.yaml 格式），用于定义项目的自动化工作流程，例如代码的持续集成（CI），可以在每次代码推送到仓库时自动运行测试、代码检查等任务
main/ 主要源码文件夹
添加构建配置
下方配置已经在工程中配置好，如果你需要自己重新设计硬件，可以参考下方流程，添加自己的板卡适配：
在xiaozhi-esp32/main/CMakeLists.txt 添加编译构建指令
代码块
elseif(CONFIG_BOARD_TYPE_XINGZHI_Cube_1_54TFT_ML307)
set(BOARD_TYPE "xingzhi-cube-1.54tft-ml307")
elseif(CONFIG_BOARD_TYPE_XINGZHI_AIO_S3)
set(BOARD_TYPE "xiaozhi-all-in-one-s3")
endif()
在xiaozhi-esp32/main/Kconfig.projbuild添加配置指令
代码块
config BOARD_TYPE_XINGZHI_Cube_1_54TFT_ML307
bool "无名科技星智1.54(ML307)"
config BOARD_TYPE_XINGZHI_AIO_S3
bool "xiaozhi All in One 多合一版本"
endchoice
在boards中添加文件夹：
xiaozhi-esp32/main/boards/xiaozhi-all-in-one-s3
在xiaozhi-all-in-one-s3文件夹中创建config.h文件xiaozhi-esp32/main/boards/xiaozhi-all-in-one-s3/config.h
这个文件主要配置板卡的硬件接口和相关参数
代码块
#ifndef _BOARD_CONFIG_H_
#define _BOARD_CONFIG_H_
#include <driver/gpio.h>
// 该头文件用于配置 xiaozhi-all-in-one-s3 开发板的相关参数
/*
定义音频 I2S 接口相关的 GPIO 引脚
*/
// 音频 I2S 接口的主时钟信号（MCLK）
#define AUDIO_I2S_GPIO_MCLK GPIO_NUM_6
// 音频 I2S 接口的字选择信号（WS）
#define AUDIO_I2S_GPIO_WS GPIO_NUM_12
// 音频 I2S 接口的位时钟信号（BCLK）
#define AUDIO_I2S_GPIO_BCLK GPIO_NUM_14
// 音频 I2S 接口的数据输入信号（DIN）
#define AUDIO_I2S_GPIO_DIN GPIO_NUM_13
// 音频 I2S 接口的数据输出信号（DOUT）
#define AUDIO_I2S_GPIO_DOUT GPIO_NUM_11
// 音频编解码器的功率放大器（PA）
#define AUDIO_CODEC_PA_PIN GPIO_NUM_10
// 音频编解码器 I2C 通信的数据信号线（SDA）
#define AUDIO_CODEC_I2C_SDA_PIN GPIO_NUM_5
// 音频编解码器 I2C 通信的时钟信号线（SCL）
#define AUDIO_CODEC_I2C_SCL_PIN GPIO_NUM_4
// 音频编解码器 ES8311 的默认 I2C 地址
#define AUDIO_CODEC_ES8311_ADDR ES8311_CODEC_DEFAULT_ADDR
/*
音频参数
*/
#define AUDIO_INPUT_SAMPLE_RATE 24000
// 音频输入的采样率设置为 24000Hz
#define AUDIO_OUTPUT_SAMPLE_RATE 24000
// 音频输出的采样率设置为 24000Hz
/*
定义显示 SPI 接口相关的 GPIO 引脚
*/
// 显示 SPI 接口的时钟信号（SCLK）
#define DISPLAY_SPI_SCLK_PIN GPIO_NUM_16
// 显示 SPI 接口的主输出从输入信号（MOSI）
#define DISPLAY_SPI_MOSI_PIN GPIO_NUM_17
// 显示 SPI 接口的片选信号（CS）
#define DISPLAY_SPI_CS_PIN GPIO_NUM_15
// 显示 SPI 接口的数据/命令选择信号（DC）
#define DISPLAY_SPI_DC_PIN GPIO_NUM_21
// 显示 SPI 接口的复位信号（RESET）
#define DISPLAY_SPI_RESET_PIN GPIO_NUM_18
// 显示 SPI 接口的时钟频率设置为 40MHz
#define DISPLAY_SPI_SCLK_HZ (40 * 1000 * 1000)
// 显示屏背光灯控制引脚使用的 GPIO
#define DISPLAY_BACKLIGHT_PIN GPIO_NUM_42
// 显示屏背光灯输出是否反转
#define DISPLAY_BACKLIGHT_OUTPUT_INVERT true
/*
显示参数
*/
// 显示屏的宽度为 172 像素
#define DISPLAY_WIDTH 172
// 显示屏的高度为 320 像素
#define DISPLAY_HEIGHT 320
// 是否交换 X 和 Y 坐标，这里设置为交换
#define DISPLAY_SWAP_XY false
// 是否在 Y 轴上镜像显示，这里设置为镜像
#define DISPLAY_MIRROR_Y false
// 是否在 X 轴上镜像显示，这里设置为不镜像
#define DISPLAY_MIRROR_X false
// 显示屏在 X 轴上的偏移量为 0
#define DISPLAY_OFFSET_X 34
// 显示屏在 Y 轴上的偏移量为 0
#define DISPLAY_OFFSET_Y 0
/**
* 外设IO配置
*/
// 开发板上内置 LED 灯使用的 GPIO
#define BUILTIN_LED_GPIO GPIO_NUM_9
// 开发板上的启动按钮使用的 GPIO
#define BOOT_BUTTON_GPIO GPIO_NUM_0
#endif // _BOARD_CONFIG_H_