These options are used to declare variables used by the armbian build system to build a board-specific configuration.
If you are unsure about the documentation then invoke $ grep -r -A5 -B5 "BUILD_OPTION_HERE" /path/to/local/armbian/build/repository to get context to the option from the source code.
BOARD_NAME ( company product version ): defines the board name used in welcome text, hostname and others relevant usage.The general convention is COMPANY PRODUCT VERSION - Often used as part of the scripting logic (namely for hacks) so follow the name declared in the board configuration.
Example: OLIMEX Teres A64
BOARDFAMILY ( board-family ): defines the family of the board to apply board-specific configuration during build time such as adjustments for the temperature, LED behavior, etc..
BOOTSIZE ( int ): Declares the size of the boot partitin in Mib
Default: 256
Example: 256
BOOT_LOGO ( string ): defines whether to use a eyecandy during bootloader phase
Values:
yes: Show the armbian boot logo
desktop: Show the armbian boot logo when BUILD_DESKTOP is set to yes
Default: not set
CRUSTCONFIG ( crust identifier ): declares the name of the crust defconfig configuration for the build. Specify only if the board has Allwinner CPU with AR100 coprocessor and SOC is supported by crust firmware.
DEFAULT_OVERLAYS ( space-separated list list of dtb overlays ): defines dtb overlays that are enabled by default. There is a basic dtb for each family but they have different level of used SoC features. Board X might have four USB ports but others might not. Therefore other does not need to have those enabled while board X does.
Examples:
usbhost0
usbhost2
usbhost3
cir
analog-codec
gpio-regulator-1.3v
uart1
DEFAULT_CONSOLE ( string ): declares default console for the boot output
Values:
serial: Output boot messages to serial console
Default: not set
MODULES ( space-separated list of kernel modules ): appends modules to the kernel command line for all kernel branches
MODULES_LEGACY ( space-separated list of kernel modules ): appends modules to the kernel command line for legacy kernel
MODULES_CURRENT ( space-separated list of kernel modules ): appends modules to the kernel command line for current kernel
MODULES_EDGE ( space-separated list of kernel modules ): appends modules to the kernel command line for edge kernel
MODULES_BLACKLIST ( space-separated list of kernel modules ): appends modules to the kernel's blacklist/deny list for all kernel branches
MODULES_BLACKLIST_LEGACY ( space-separated list of kernel modules ): appends modules to the kernel's blacklist/deny list for legacy kernel
MODULES_BLACKLIST_CURRENT ( space-separated list of kernel modules ): appends modules to the kernel's blacklist/deny list for current kernel
MODULES_BLACKLIST_EDGE ( space-separated list of kernel modules ): appends modules to the kernel's blacklist/deny list for edge kernel
SERIALCON ( comma-separated list of terminal interfaces [:bandwidth] ): declares which serial console should be used on the system
Example: ttyS0:15000000,ttyGS1
SKIP_ARMBIAN_REPO ( boolean ): Whether to include the armbian repository in the built image
Values:
yes: Include (default)
no: Do NO include
HAS_VIDEO_OUTPUT ( boolean ): defines whether the system has video output such as eye candy, bootsplash, etc..
Values:
yes: Enable video-related configuration
no: Disable video-related configuration
KERNEL_TARGET ( comma-separated list of kernel releases or branches ): declares which kernels should be used for the build
Values:
legacy: Use legacy kernel
current: Use current kernel
edge: Use edge kernel
[branch]: Use specified [branch] kernel
[none]: Exits with error
KERNEL_TEST_TARGET ( comma-separated list of kernel releases or branches ): if test targets are different for testings. Also applies to build list generation. (internal switch)
KERNEL_UPGRADE_FREEZE ( comma-separated list of kernels with versions obove which they stop updating, example: KERNEL_UPGRADE_FREEZE="vendor-rk35xx@24.8.1,current-rockchip-rk3588@24.8.2" )
FULL_DESKTOP ( boolean ): defines whether to install desktop stack of applications such as office, thunderbird, etc..
