mirror of
https://github.com/armbian/build
synced 2025-09-24 19:47:06 +07:00
87f37f6a3d
Changes to be committed: modified: config/boards/aml-s9xx-box.tvb modified: packages/bsp/aml-s9xx-box/boot/extlinux/extlinux.conf.template The aml-s9xx-box builds use the native TV Box u-boot. I've had as a todo item to figure out how to not build and include an unused u-boot. In a recent PR for a different board the opposite was being done (adding a u-boot where a board didn't previously ship one), thus I then had the info to remove it here. This also changes the generated extlinux.conf to include a fdt line by adding the boot_fdt_file to the board config file. This reduces the effort needed to manually modify the extlinux.conf.
Internal build options
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
- Example:
- 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..
- Refer to sources table
- Example:
sun50iw1
- BOARD_MAINTAINER ( space-separated list of Github login ): Declares the maintainer of the board
- BOOTCONFIG ( u-boot identifier ): declares the name of the u-boot configuration for the build without the '_defconifig' suffix
- Refer to the u-boot source tree to find configuration for the board
- Example:
teres-i
- BOOTSIZE ( int ): Declares the size of the boot partitin in Mib
- Default:
256 - Example:
256
- Default:
- 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_DESKTOPis set toyes
- Default:
not set
- Values:
- 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.
- Refer to the crust source tree to find configuration for the board
- Example:
nanopi_m1_defconfig
- IMAGE_PARTITION_TABLE ( string ): defines which disklabel type to use
- Values:
- msdos: Use dos/msdos disklabel
- gpt: Use GPT disklabel
- Default: msdos
- Values:
- BOOTFS_TYPE ( filesystem ): defines the expected filesystem for the boot file system
- Values:
- none: Uses /boot on the root filesystem
- ext4: Use the Fourth Extended Filesystem
- ext2: Use the Second Extended Filesystem
- fat: Use the File Allocation Table 32
- Default:
ext4
- Values:
- 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
- Examples:
- DEFAULT_CONSOLE ( string ): declares default console for the boot output
- Values:
- serial: Output boot messages to serial console
- Default:
not set
- Values:
- 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
- Example:
- SKIP_ARMBIAN_REPO ( boolean ): Whether to include the armbian repository in the built image
- Values:
- yes: Include (default)
- no: Do NO include
- Values:
- 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
- Values:
- 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
- Values:
- KERNEL_TEST_TARGET ( comma-separated list of kernel releases or branches ): if test targets are different for testings (internal switch)
- FULL_DESKTOP ( boolean ): defines whether to install desktop stack of applications such as office, thunderbird, etc..
- Values:
- yes: install desktop stack
- no: doesn't install desktop stack
- Values:
- DESKTOP_AUTOLOGIN ( boolean ): Toggle desktop autologin
- Values:
- yes: Automatically login to the desktop
- no: disable desktop autologin
- Default:
no
- Values:
- PACKAGE_LIST_BOARD ( space-separated list of packages ): Declares which packages should be installed on the system
- PACKAGE_LIST_BOARD_REMOVE ( space-separated list of packages ): Declares packages to be removed from the system
- BOOT_FDT_FILE ( device tree configuration ): Force to load specific device tree configuration if different from the one defined by u-boot
- Values:
- [family]/[file.dtb]: Replace device tree with the one specified
- none: Do not use device tree configuration
- Example:
rockchip/rk3568-rock-3-a.dtb
- Values:
- CPUMIN ( minimum CPU frequency to scale in Hz ): Set minimal CPU frequency of the system
- Default: Differs per family
480000for sunxi8 boards
- Default: Differs per family
- CPUMAX ( minimum CPU frequency to scale in Hz ): Set maximal CPU frequency of the system
- Default: Differs per family
1400000for sunxi8 boards
- Default: Differs per family
- FORCE_BOOTSCRIPT_UPDATE ( boolean ): Force bootscript installation if they are not present
- Values:
- yes: Enable
- no: Disable
- Values:
- OVERLAY_PREFIX ( prefix ): Prefix for device tree and overlay file paths which will be set while creating an image
- Example:
sun8i-h3
- Example:
Deprecated
- BOOTCONFIG_LEGACY ( u-boot identifier ): use BOOTCONFIG instead
- BOOTCONFIG_CURRENT ( u-boot identifier ): use BOOTCONFIG instead
- BOOTCONFIG_EDGE ( u-boot identifier ): use BOOTCONFIG instead
- PACKAGE_LIST_BOARD_DESKTOP ( space-separated list of packages ): use PACKAGE_LIST_BOARD instead
- PACKAGE_LIST_BOARD_DESKTOP_REMOVE ( space-separated list of packages ): use PACKAGE_LIST_BOARD instead
File extensions
Statuses displayed at the login prompt:
| file type | description |
|---|---|
| .csc or .tvb | community creations or no active maintainer |
| .wip | work in progress |
| .eos | end of life |