创建`board`

针对开发者自己设计了一个新的硬件开发板，需要为这块新开发板做一些驱动初始化和适配工作，的情况

可以查看此文档

概述

tos.py new board 是 TuyaOpen SDK 提供的一个命令行工具

用于快速创建一个新的，基于TuyaOpen已经支持芯片平台的，硬件开发板支持包

该命令通过交互式界面和模板系统，帮助开发者快速为现有芯片平台添加新的开发板配置，极大地简化了硬件移植和适配的工作流程

Board 命名

必选字段

厂家名称：代表开发板的生产厂家。如涂鸦推出的开发板则会用 "TUYA" 开头
芯片名称：platform 名称，如 "T2"、"T5AI"

可选字段

体现开发板的主要特点或者功能：若 board 具有特定的功能模块或特点，如 "LCD"、"CAM"
系列名称和版本信息：一些厂商会有系列化的产品，可在命名中体现系列名称和版本号
其他：一些硬件标识等

命名规则

字母必须大写
字段和字段之间用下划线隔开
字段结合顺序顺序，"厂家名称_核心板名称_可选字段"

示例： TUYA_T5AI_BOARD

操作原理

使用命令tos.py new board，选择目标平台

命令执行后，系统会列出所有可用的硬件平台：
```
[INFO]: Running tos.py ...
--------------------
1. BK7231X
2. ESP32
3. LN882H
4. T2
5. T3
6. T5AI
7. Ubuntu
--------------------
Input "q" to exit.
Choice platform: 6
```
使用方向键选择您的目标平台（这里以T5AI为例），按回车确认。
输入板子名称
```
[NOTE] Input new board name.
input: MY_CUSTOM_BOARD
```
输入新开发板名称，建议使用：
- 英文大写字母
- 下划线分隔单词
- 避免使用特殊字符

自动生成文件

系统会自动创建以下文件结构：

boards/<platform>/<board_name>/
├── Kconfig           # 板级配置文件
├── CMakeLists.txt    # CMake 构建配置
├── board_com_api.h   # 板级 API 声明
└── board_com_api.c   # 板级 API 实现

boards/<platform>/Kconfig文件会自动更新，包含新板的配置选项

config BOARD_CHOICE_MY_CUSTOM_BOARD
bool "MY_CUSTOM_BOARD"
if (BOARD_CHOICE_MY_CUSTOM_BOARD)
    rsource "./MY_CUSTOM_BOARD/Kconfig"
endif

后续操作

概览：

验证编译

修改boards/<platform>/<board_name>/board_com_api.c文件，适配新开发板

调整配置

保存板级默认配置文件

验证编译

使用命令tos.py new project创建一个新的项目，进入项目目录

使用命令tos.py config choice选择一个相同芯片平台的配置

这样的好处是可以节省配置时间

然后使用命令tos.py config menu，选择刚刚创建的新开发板

执行命令tos.py build验证编译

适配开发板

修改boards/<platform>/<board_name>/board_com_api.c文件，适配新开发板

在文件中找到PERATE_RET board_register_hardware(void)函数，并根据新开发板的硬件信息进行修改

例如，添加KEY、LED、I2C等外设的初始化代码，此过程可以参考已有的开发板实现

如果需要添加其他的源文件或头文件目录，可以通过修改CMakeLists.txt文件来，配置LIB_SRCS和LIB_PUBLIC_INC变量来实现

调整配置

使用命令tos.py config menu，进入配置菜单，调整功能选项和参数

结合上个步骤，验证功能

保存配置

将项目目录下面的app_default.config文件复制到boards/<platform>/config目录下

并修改名称为<board_name>.config

方便其他开发者使用

常见问题

如何删除创建的板子

直接删除 boards/<platform>/<board_name> 目录，并手动从boards/<platform>/Kconfig中移除相关配置

修改已创建的板子名称

需要手动修改：

重命名板子目录
更新平台 Kconfig 中的引用
更新板子内部 Kconfig 的默认值

概述​

Board 命名​

必选字段​

可选字段​

命名规则​

操作原理​

后续操作​

验证编译​

适配开发板​

调整配置​

保存配置​

常见问题​

如何删除创建的板子​

修改已创建的板子名称​

概述