¶ 添加自定义板型
¶ 概述
在前面的设备树章节中描述了硬件板型资源的层级数据结构和使用方法，csk6 sdk默认支持了csk6011a_nano等开发板板型，开发者在使用官方的开发板时进行应用开发时可以直接使用这些板型。
但在实际的应用场景中，开发者往往会基于CSK6芯片构建自己的硬件产品，为方便应用开发和项目代码集中管理，开发者可能需要根据自己的硬件情况新增一个板型。
csk6 sdk支持开发者在app应用目录下新增一个应用级别的board，通过本章节的学习，您将了解到：
- 新增一个板型的正确方法
- 如何针对新的硬件适配自定义板型
¶ 添加自定义board
csk6 sdk适配了csk6011a_nano开发板，对应的board配置文件在zephyr\boards\arm\csk6011a_nano目录下，目录文件结构如下：
└── csk6011a_nano
├── board.cmake
├── CMakeLists.txt
├── csk6011a_nano_defconfig
├── csk6011a_nano_pinctrl.dtsi
├── csk6011a_nano.dts
├── csk6011a_nano.yaml
├── Kconfig.board
└── Kconfig.defconfig
同样，在app目录下添加boards板型文件时也必须遵守boards/<arch>/<board_name>格式，本章节以添加新板型csk6002_myboard为例，在app目录下完成新增board的实现。
添加board一般的做法是在SDK的zephyr/boards目录下寻找一个使用相同soc的board作为模板，再根据硬件的差异对dts和配置文件进行修改，Zephyr sdk也提供了添加board的sample，位于zephyr/samples/application_development/out_of_tree_board目录下。
本章节将基于csk6 sdk 提供的blinky sample项目，新建一个名为csk6002_myboard的板型，并使用这个新的板型对blinky sample进行编译与运行。
¶ 步骤一：创建应用项目，以便在应用项目上增加自定义板型
创建blinky sample项目步骤如下：
首先创建一个sample，可以是hello_world或者其他应用项目，并在sample项目的基础上添加自定义板型。
¶ 步骤二：在app目录下为新的板型csk6002_myboard添加板型配置文件
在刚创建的sample的工程目录下创建 boards\arm\csk6002_myboard目录
将SDK的 zephyr\boards\arm\csk6011a_nano 目录下的所有内容拷贝到csk6002_myboard目录下，并把文件的所有 csk6011a_nano 名称修改为 csk6002_myboard。
app目录
└── boards
└── arm
└── csk6002_myboard
├── board.cmake
├── CMakeLists.txt
├── csk6002_myboard_defconfig
├── csk6002_myboard_pinctrl.dtsi
├── csk6002_myboard.dts
├── csk6002_myboard.yaml
├── Kconfig.board
└── Kconfig.defconfig
配置文件中的csk6011a_nano字段需要同步改成csk6002_myboard。
- csk6002_myboard_defconfig文件
CONFIG_BOARD_csk6002_myboard=y
- csk6002_myboard_pinctrl.dtsi文件
csk6002_myboard_pinctrl:csk6002_pinctrl
- csk6002_myboard.dts文件
#include "csk6002_myboard_pinctrl.dtsi"
/ {
model = "csk6002 myboard";
compatible = "csk,csk6002_myboard";
- csk6002_myboard.yaml文件
identifier: csk6002_myboard
- Kconfig.board文件
config BOARD_csk6002_myboard
bool "csk6002_myboard Board"
depends on SOC_CSK6
- Kconfig.defconfig文件
if BOARD_csk6002_myboard
config BOARD
default "csk6002_myboard"
endif # BOARD_csk6002_myboard
¶ 步骤三：CMake文件修改
在app/CMakeLists.txt(注意不是boards目录下的CMakeLists.txt)文件中添加set(BOARD_ROOT ${CMAKE_CURRENT_LIST_DIR})编译配置，指定项目编译时引用app目录下的board配置：
# SPDX-License-Identifier: Apache-2.0
cmake_minimum_required(VERSION 3.20.0)
# 指定使用app目录下的自定义boards
set(BOARD_ROOT ${CMAKE_CURRENT_LIST_DIR})
find_package(Zephyr REQUIRED HINTS $ENV{ZEPHYR_BASE})
project(blinky)
target_sources(app PRIVATE src/main.c)
¶ 步骤四：修改dts和配置文件
¶ .dts文件修改
在设备树章节中可学习到.dts文件是设备树的源文件，用来定义硬件设备的细节，比如定义一个uart设备，并定义其引脚信息等。
参考csk6011a_nano配置在该文件中完成leds、gpio_keys、wifi_module、uart0、flash0、 psram0、spi0等外设的设备树配置，更多关于设备树配置和规则请查阅设备树章节。
修改示例：
csk6002_myboard相对 csk6011a_nano 在硬件上硬件选用了不同的wifi模组，那么对应的wifi设备树配置需要做如下改动：
wifi_module: xr819s {
compatible = "wifi,xr819s";
label = "WiFi module";
dataready-gpios = <&gpioa 16 0>;
reset-gpios = <&gpioa 17 0>;
sdio-clk-gpios = <&gpioa 20 0>;
sdio-cmd-gpios = <&gpioa 18 0>;
sdio-dat0-gpios = <&gpioa 19 0>;
status = "okay";
};
同理，其他pin脚有不一样的也需要同步修改dts设备树对应的配置。
¶ 步骤五：编译烧录
¶ 编译
在app根目录下通过以下指令完成编译，编译时指定配置好的新board板型csk6002_myboard：
lisa zep build -b csk6002_myboard
¶ 烧录
csk6002_myboard开发板通过USB连接PC，通过烧录指令烧录：
lisa zep flash
TIP
如果您的硬件板型不带daplink，可通过J-link或串口烧录，详细的烧录方式可在csk6 烧录章节中查看。
¶ 查看结果
CSK6-NanoKit通过板载DAPlink虚拟串口连接电脑，或者将CSK6-NanoKit的日志串口A03 TX A02 RX外接串口板并连接电脑。
- 通过lisa提供的
lisa term命令查看日志 - 或者在电脑端使用串口调试助手查看日志，默认波特率为115200。
以上即为基于csk6 sdk适配csk6002_myboard开发板的过程。