Zephyr -- Board Porting Guide

Board/

添加自定义的board：boards/<arch>/<board>/

boards/<ARCH>/plank
├── board.cmake
├── CMakeLists.txt
├── doc
│   ├── plank.png
│   └── index.rst
├── Kconfig.board
├── Kconfig.defconfig
├── plank_defconfig
├── plank.dts
└── plank.yaml

必须要有的文件：

plank.dts：设备树。
Kconfig.board, Kconfig.defconfig, plank_defconfig: Kconfig文件。

可选文件：

board.cmake: 用于west flash和west debug。
CMakeLists.txt: 如果在board/下加其他*.c的话需要。
doc/: 文档。
plank.yaml: Test Runner(Twister)需要使用。

Kconfig.board: 至少需要config BOARD_PLANK选项。

config BOARD_PLANK
   bool "Plank board"
   depends on SOC_SERIES_YOUR_SOC_SERIES_HERE
   select SOC_PART_NUMBER_ABCDEFGH

Kconfig.defconfig: 板子的一些固定Kconfig选项，需要包括在 if BOARD_PLANK/endif中间。通常是invisible Kconfig Symbol，没有prompt。需要依赖default值或者其他Kconfig依赖，无法在配置菜单中选择。

if BOARD_PLANK
# Always set CONFIG_BOARD here. This isn't meant to be customized,
# but is set as a "default" due to Kconfig language restrictions.
config BOARD
   default "plank"

# Other options you want enabled by default go next. Examples:

config FOO
   default y

if NETWORKING
config SOC_ETHERNET_DRIVER
   default y
endif # NETWORKING

endif # BOARD_PLANK

plank_defconfig: 选择soc，时钟，串口等等CONFIG_开关。

CONFIG_SOC_${VENDOR_XYZ3000}=y                # select your SoC
CONFIG_SYS_CLOCK_HW_CYCLES_PER_SEC=120000000  # set up your clock, etc
CONFIG_SERIAL=y

Board/#

Board/