板级配置使用说明¶
1. 概述¶
板级配置文件主要用于管理芯片所处的硬件环境。例如配置芯片引脚功能和复用选项(UART使用哪些引脚、I2C使用哪些引脚等)，音频模拟电路的配置参数等。CI13XX系列芯片SDK中把这些硬件差异相关的配置参数全部提炼到板级配置文件中。对于启英泰伦官方提供的开发板，在SDK都已提供了对应的板级配置文件，只需要在 “user_config.h” 中配置所选开发板的名字所对应的配置文件即可运行demo程序。
2. 使用说明¶
板级配置代码路径：CI13XX_SDK\driver\boards
2.1. 代码结构¶
| 源文件 | 说明 |
|---|---|
| board_default.c |
板级配置弱定义接口 |
| board.c board.h |
板级配置接口 |
| board_port_template.c |
板级配置示例 |
| CI-D06GT01D_REV.c |
CI标准板D06GT01D配置源文件 |
2.2. 新板添加步骤¶
当开发者需要定义自己的硬件板配置时，需要按照如下步骤进行添加，若SDK中已有配置源文件，只需要按照步骤二关联当前板子即可。
2.2.1. 步骤一：添加源文件¶
添加新板源文件，例如CI-D06GT01D_REV.c，添加方法：复制board_port_template.c于SDK\driver\boards中，并将其重命名，然后根据自己的硬件板电路修改文件中各接口中的内容，若需新增接口查看步骤三。
2.2.2. 步骤二：关联新板源文件¶
在SDK\driver\boards下添加好新板的源文件之后，需要将新板源文件与当前SDK关联起来，关联方法：打开工程代码，修改user_config.h中的BOARD_PORT_FILE宏定义，使新的板级配置源文件被关联。
#define BOARD_PORT_FILE "CI-D06GT01D_REV_V1.0.c" //板级配置源文件关联到CI-D06GT01D_REV_V1.0.c
2.2.3. 步骤三：新增接口添加说明¶
(1)在新添加的配置源文件中添加接口，图中以示例源文件为例。
图2-1 新增板级配置接口步骤一
(2)在boards.h文件中添加函数声明，如下图所示。
图2-2 新增板级配置接口步骤二
(3)在borads_default.c中添加同名虚函数，如下图所示。
图2-3 新增板级配置接口步骤三