u-boot configuration

  • target: Odroid-N2
  • tag: v2019.07

Tips to add/remove boards

When adding a new board, the following steps are generally needed:
[1] Add a header file include/configs/<target>.h
[2] Make sure to define necessary CONFIG_SYS_* in Kconfig:
Define CONFIG_SYS_CPU="cpu" to compile arch/<arch>/cpu/<cpu>
Define CONFIG_SYS_SOC="soc" to compile arch/<arch>/cpu/<cpu>/<soc>
Define CONFIG_SYS_VENDOR="vendor" to compile board/<vendor>/common/*
and board/<vendor>/<board>/*
Define CONFIG_SYS_BOARD="board" to compile board/<board>/*
(or board/<vendor>/<board>/* if CONFIG_SYS_VENDOR is defined)
Define CONFIG_SYS_CONFIG_NAME="target" to include
include/configs/<target>.h
[3] Add a new entry to the board select menu in Kconfig.
The board select menu is located in arch/<arch>/Kconfig or
arch/<arch>/*/Kconfig.
[4] Add a MAINTAINERS file
It is generally placed at board/<board>/MAINTAINERS or
board/<vendor>/<board>/MAINTAINERS
[5] Add configs/<target>_defconfig
When removing an obsolete board, the following steps are generally needed:
[1] Remove configs/<target>_defconfig
[2] Remove include/configs/<target>.h if it is not used by any other boards
[3] Remove board/<vendor>/<board>/* or board/<board>/* if it is not used
by any other boards
[4] Update MAINTAINERS if necessary
[5] Remove the unused entry from the board select menu in Kconfig
[6] Add an entry to doc/README.scrapyard

Configuration files for use in C sources

  • include/generated/autoconf.h (generated by Kconfig for Normal)
  • include/configs/<board>.h (exists for all boards)

Configuration file for use in makefiles

  • include/config/auto.conf (generated by Kconfig)
  • include/autoconf.mk (generated by the old config for Normal)
  • spl/include/autoconfig.mk (generated by the old config for SPL)
  • tpl/include/autoconfig.mk (generated by the old config for TPL)

When adding a new CONFIG macro, it is highly recommended to add it to Kconfig rather than to a header file.

CONFIG_SYS_CONFIG_NAME을 μ„€μ •ν•˜λ©΄ u-boot λΆ€νŒ…μ‹œ u-boot/include/configs/<CONFIG_SYS_CONFIG_NAME>.h와 μ•„λž˜ 파일 듀을 νŒŒμ‹±ν•˜μ—¬ μ‹€ν–‰λ©λ‹ˆλ‹€.

u-boot/scripts/kconfig/Makefile
SRCARCH := ..
%_defconfig: $(obj)/conf
$(Q)$< $(silent) --defconfig=arch/$(SRCARCH)/configs/$@ $(Kconfig)
u-boot/scripts/Makefile.autoconf
# SPDX-License-Identifier: GPL-2.0
# This helper makefile is used for creating
# - symbolic links (arch/$ARCH/include/asm/arch
# - include/autoconf.mk, {spl,tpl}/include/autoconf.mk
# - include/config.h
#
# When our migration to Kconfig is done
# (= When we move all CONFIGs from header files to Kconfig)
# this makefile can be deleted.

Etc

CONFIG_SYS_CPU=

./config.mk:43:CPUDIR=arch/$(ARCH)/cpu$(if $(CPU),/$(CPU),)
./scripts/Makefile.autoconf:130: dest=arch/$(ARCH)/include/asm/arch-$(if $(SOC),$(SOC),$(CPU))

CONFIG_SYS_SOC=

# If arch/$(ARCH)/mach-$(SOC)/include/mach exists,
# make a symbolic link to that directory.
# Otherwise, create a symbolic link to arch/$(ARCH)/include/asm/arch-$(SOC).

CONFIG_SYS_VENDOR=

./config.mk:53:BOARDDIR = $(VENDOR)/$(BOARD)
./scripts/Makefile.spl:69:HAVE_VENDOR_COMMON_LIB = $(if $(wildcard $(srctree)/board/$(VENDOR)/common/Makefile),y,n)
./scripts/Makefile.autoconf:106: echo \#define CONFIG_BOARDDIR board/$(if $(VENDOR),$(VENDOR)/)$(BOARD);\

CONFIG_SYS_BOARD=

./include/common.h:156:/* $(BOARD)/$(BOARD).c */
./include/common.h:160:/* $(BOARD)/eeprom.c */
./include/common.h:179:/* $(BOARD)/$(BOARD).c */
./scripts/Makefile.spl:212:ALL-y += $(obj)/$(BOARD)-spl.bin
./scripts/Makefile.spl:325:$(obj)/$(BOARD)-spl.bin: $(obj)/u-boot-spl.bin
./scripts/Makefile.spl:326: $(if $(wildcard $(objtree)/spl/board/samsung/$(BOARD)/tools/mk$(BOARD)spl),\
./scripts/Makefile.spl:327: $(objtree)/spl/board/samsung/$(BOARD)/tools/mk$(BOARD)spl,\
./scripts/Makefile.autoconf:106: echo \#define CONFIG_BOARDDIR board/$(if $(VENDOR),$(VENDOR)/)$(BOARD);\

CONFIG_SYS_CONFIG_NAME=

./arch/Kconfig:276: The header file include/configs/<CONFIG_SYS_CONFIG_NAME>.h
./arch/arm/mach-meson/Kconfig:87:config SYS_CONFIG_NAME
./arch/arm/mach-meson/Kconfig:92: Based on this option include/configs/<CONFIG_SYS_CONFIG_NAME>.h header
./scripts/Makefile.autoconf:109: echo \#include \<configs/$(CONFIG_SYS_CONFIG_NAME).h\>;

Reference

Last updated on