Buildroot User Manual

https://buildroot.org/downloads/manual/manual.html

https://www.cnblogs.com/fuzidage/p/12049442.html

Chapter 4 Buildroot quick start

make menuconfig
make

make menuconfig 进入选择菜单，可以选择编译 kernel, bootloader, rootfs。

编译完成后内容会放到output目录下，其中：

image: 包括 kernel image, bootloader and root filesystem images

build:

host:

staging: 软链接，指向/host/<toolchain>/sysroot

target: 就是目标板的文件系统，和 staging 相比，developing files(header, etc.)被省略了，binaries are stripped, 去除了 debug info。

PARTⅡ User Guide

Chapter 6 Buildroot configuration

6.1 Cross-compilation toolchain

Buildroot 提供两种 toolchain:

internal toolchain backend, Buildroot toolchain in menuconfig.
external toolchain backend. External toolchain in menuconfig.

在 menuconfigToolchain Type->Toolchain 中选择。

6.1.1 Internal toolchain backend

make uclibc-menuconfig: 可以修改

缺点是，修改内部工具链选项时，整个 toolchain 和 system 必须重新 rebuild，很耗时间。

6.1.2 External toolchain backend

6.2. /dev management

// todo:

6.3 init system

Buildroot 支持三种 init 方式，在System configuration, Init system中配置：

默认方法为 busyboxBR2_INIT_BUSYBOX，利用 init 启动程序/etc/inittab,该文件主要任务是启动/etc/init.d/rcS。该 init 程序位于 package/busybox/inittab。
systemV
systemd

Chapter 7 Configuration of other components

Buildroot 还可对下面的 components 进行配置，在配置前确保对应的 component 已经在 buildroot menuconfig 中 enable。

BusyBox. 开启选项：BR2_PACKAGE_BUSYBOX_CONFIG, 配置菜单：make busybox-menuconfig
uClibc. 开启选项：BR2_UCLIBC_CONFIG, 配置菜单：make uclibc-menuconfig
Linux Kernel. linux config 文件：BR2_LINUX_KERNEL_USE_CUSTOM_CONFIG, 配置菜单：make linux-menuconfig
Barebox. Barebox config 文件：BR2_TARGET_BAREBOX_USE_CUSTOM_CONFIG，配置菜单：make barebox-menuconfig
U-Boot. Uboot config 文件：BR2_TARGET_UBOOT_USE_CUSTOM_CONFIG，配置菜单：make uboot-menuconfig

Chapter 8 General Buildroot usage

make clean：只删除 build products。

make distclean: 删除所有 build products 和 configuration。

make -s printvars VARS=: 可以打印编译过程中的变量，比如：

$ make -s printvars VARS=BR2_EXTERNAL
BR2_EXTERNAL=/home/yucheng_xiang/sdk_3917/platform

$ make -s printvars VARS=BR2_EXTERNAL RAW_VARS=YES # 如果变量中还有变量，这种方式可以不展开

8.2 Understanding when a full rebuild is necessary

Full rebuild: make clean all

什么时候需要 full rebuild:

architecture changed, 比如 binary format, floating point strategy 等
toolchain changed
rootfs skeleton changed. 但 rootfs overlay, 比如 post-build script 改动只需要 make 就可以

8.3 Understanding how to rebuild packages

make <package>-dirclean: 直接删除 package 目录。

make <package>-rebuild: 执行 make and make install, 因此只会 rebuild changed files。

make <package>-reconfigure: restart the configuration, compilation and installation of the package.

8.5 Building out-of-tree

make O=/tmp/build menuconfig

Or:

cd /tmp/build; make O=$PWD -C path/to/buildroot menuconfig

注意 O 后面的路径可以是相对或者绝对路径，相对路径是相对于 buildroot 根目录而不是当前目录。

8.6 Environment variables

HOSTCC, BR2_DL_DIR等一些 buildroot 自带的环境变量。

8.9 Graphing the dependencies between packages

make graph-depends：生成 packages 之间的依赖图，保存在 output/graphs/graph-depends.pdf。

make <pkg>-graph-depends: 生成某个 package 的依赖关系图。

8.10 Graphing the build duration

make graph-build: 生成每个 package 的 build 时间。

8.11 Graphing the filesystem size contribution of packages

make graph-size: 计算每个 packge 占 rootfs 的大小。

8.13 Advanced usage

8.13.1 Using the generated toolchain outside Buildroot

8.13.2 Using gdb in Buildroot

为了支持 gdb debug program。

Internal toolchain 需要打开BR2_PACKAGE_HOST_GDB, BR2_PACKAGE_GDB, BR2_PACKAGE_GDB_SERVER，这保证了 host machine 使用的 cross gdb 和 target 使用的 gdb server 被编译。
external toolchain 需要打开BR2_TOOLCHAIN_EXTERNAL_GDB_SERVER_COPY,把外部 toolchain 的 gdbserver 拷贝到 target，需要外部 toolchain 没有 cross gdb 和 gdbserver，那么启用和 internal toolchain 一样的选项。

调试 foo 程序，qemu 启动后，在 target 上:

gdbserver :2345 foo

在 host 上：

<buildroot>/output/host/bin/<tuple>-gdb -ix <buildroot>/output/staging/usr/share/buildroot/gdbinit foo

(gdb) target remote <target ip address>:2345

具体可参考 https://yc-xiang.github.io/posts/note/linux_driver/drm/qemu_debug_drm/

8.13.3 Using ccache in Buildroot

BR2_CCACHE

8.13.4 Location of downloaded packages

BR2_DL_DIR: 修改下载的 tarballs 位置。

8.13.5 Package-specific make targets

常用的 package make 命令:

The package build targets are (in the order they are executed):

make <package>-source: Fetch the source (download the tarball, clone the source repository, etc)
make -depends: Build and install all dependencies required to build the package
make -extract: Put the source in the package build directory (extract the tarball, copy the source, etc)
make -patch: Apply the patches, if any
make -configure: Run the configure commands, if any
make -build: Run the compilation commands
make -install: Run installation commands

Additionally, there are some other useful make targets:

make -show-depends: Displays the first-order dependencies required to build the package. 只展示一层依赖。
make -show-recursive-depends: Recursively displays the dependencies required to build the package. 展示多层依赖，所有需要的软件包。
make -graph-depends: Generate a dependency graph of the package
make -dirclean: 删除整个 package 目录
make -reinstall: Re-run the install commands
make -rebuild: Re-run the build commands
make -reconfigure: Re-run the configure commands, then rebuild

8.13.6 Using Buildroot during development

BR2_PACKAGE_OVERRIDE_FILE: 该选项指明了 override file 的路径和名称。默认位置为$(CONFIG_DIR)/local.mk，通常和.config 在同一目录下。

在该 override file 中可以指定各 package source code 的覆盖路径。这样 buildroot 就不用从网上下载，解压 package 了。

<pkg1>_OVERRIDE_SRCDIR = /path/to/pkg1/sources
<pkg2>_OVERRIDE_SRCDIR = /path/to/pkg2/sources

可以通过<pkg>_OVERRIDE_SRCDIR_RSYNC_EXCLUSIONS，在 rsync 时额外排除一些文件，防止拷贝过慢：

WEBKITGTK_OVERRIDE_SRCDIR = /home/bob/WebKit
WEBKITGTK_OVERRIDE_SRCDIR_RSYNC_EXCLUSIONS = \
        --exclude JSTests --exclude ManualTests --exclude PerformanceTests \
        --exclude WebDriverTests --exclude WebKitBuild --exclude WebKitLibraries \
        --exclude WebKit.xcworkspace --exclude Websites --exclude Examples

Chapter 9 Project-specific customization

9.1 Recommended directory structure

+-- board/
|   +-- <company>/
|       +-- <boardname>/
|           +-- linux.config
|           +-- busybox.config
|           +-- <other configuration files>
|           +-- post_build.sh
|           +-- post_image.sh
|           +-- rootfs_overlay/
|           |   +-- etc/
|           |   +-- <some files>
|           +-- patches/
|               +-- foo/
|               |   +-- <some patches>
|               +-- libbar/
|                   +-- <some other patches>
|
+-- configs/
|   +-- <boardname>_defconfig
|
+-- package/
|   +-- <company>/
|       +-- Config.in (if not using a br2-external tree)
|       +-- <company>.mk (if not using a br2-external tree)
|       +-- package1/
|       |    +-- Config.in
|       |    +-- package1.mk
|       +-- package2/
|           +-- Config.in
|           +-- package2.mk
|
+-- Config.in (if using a br2-external tree)
+-- external.mk (if using a br2-external tree)
+-- external.desc (if using a br2-external tree)

如果使用 br2-external tree, 那么<company>和<boardname>可以省略。

9.1.1 Implementing layered customizations

在 board/<company>/下面增加一层 common 层，可以对所有其他的 board 都 apply，这样就不用每个 board 都需要加相同的 config。

+-- board/
    +-- <company>/
        +-- common/
        |   +-- post_build.sh
        |   +-- rootfs_overlay/
        |   |   +-- ...
        |   +-- patches/
        |       +-- ...
        |
        +-- fooboard/
            +-- linux.config
            +-- busybox.config
            +-- <other configuration files>
            +-- post_build.sh
            +-- rootfs_overlay/
            |   +-- ...
            +-- patches/
                +-- ...

是否需要设置 BR2_GLOBAL_PATCH_DIR="board//common/patches board//fooboard/patches"???

9.2 Keeping customizations outside of Buildroot

使用 br2-external tree 的结构，源码放在 buildroot 外部，在编译时指定BR2_EXTERNAL

make BR2_EXTERNAL=/path/to/foo menuconfig

编译完成后会在 output 目录下生成.br2-external.mk文件，保存了一些 br2-external tree 的变量。

9.2.1 Layout of a br2-external tree

使用 br2-external tree 必须有下面三个文件：

external.desc
external.mk
Config.in

可选的有：

configs/ 自定义的板子 defconfig
provides/ 可调整 package 的实现方式，比如 jpeg 可以新建 jepg.in 来选择 libjpeg 还是 jpeg-turbo。

external.desc, 需要提供 name 和 desc，比如：

name: bar_42
desc: xxxxxxxxx

会生成两个变量BR2_EXTERNAL_$(NAME)_PATH(指向 br2-external tree 路径) 和 BR2_EXTERNAL_$(NAME)_DESC

external.mk, makefile 的总入口，include 各种 package 的*.mk，e.g.:

include $(sort $(wildcard $(BR2_EXTERNAL_BAR_42_PATH)/package/*/*.mk))

Config.in, Kconfig 总入口，source 各种 package 的 Config.in e.g.:

source "$BR2_EXTERNAL_BAR_42_PATH/package/package1/Config.in"
source "$BR2_EXTERNAL_BAR_42_PATH/package/package2/Config.in"

9.4 Storing the configuration of other components

make linux-update-defconfig: save config to BR2_LINUX_KERNEL_CUSTOM_CONFIG_FILE make busybox-update-config to BR2_PACKAGE_BUSYBOX_CONFIG make uclibc-update-config to BR2_UCLIBC_CONFIG make barebox-update-defconfig to BR2_TARGET_BAREBOX_CUSTOM_CONFIG_FILE make uboot-update-defconfig to BR2_TARGET_UBOOT_CUSTOM_CONFIG_FILE

9.5 Customizing the generated target filesystem

Root filesystem overlays: BR2_ROOTFS_OVERLAY

Post-build scripts: BR2_ROOTFS_POST_BUILD_SCRIPT

9.5.1 Setting file permissions and ownership and adding custom devices nodes

BR2_ROOTFS_DEVICE_TABLE

9.6 Adding custom user accounts

增加用户：BR2_ROOTFS_USERS_TABLES

9.7 Customization after the images have been created

BR2_ROOTFS_POST_IMAGE_SCRIPT, post-image script, 在所有 image 编译完成后执行的脚本。

9.8 Adding project-specific patches and hashes

首先会打全局的 patch，保存在:

BR2_GLOBAL_PATCH_DIR/<packagename>/(<packageversion>/)

再打每个 package 文件夹下的 patch:

<number>-<description>.patch, 按 number 的顺序打上 patch。

验证 package 完整性的 hash 文件路径和 patch 一样，文件名为<packagename>.hash

9.9 Adding project-specific packages

9.10 Quick guide to storing your project-specific customizations

参考网页

PartⅢ Developer guide

Chapter 17 Adding support for a particular board

记录了怎么 porting 开发板，略。

Chapter 18. Adding new packages to Buildroot

18.2 Config files

Config.in:

这边放置的给 target 的软件包。

config BR2_PACKAGE_LIBFOO
        bool "libfoo"
        help
          This is a comment that explains what libfoo is. The help text
          should be wrapped.

          http://foosoftware.org/libfoo/

Config.in.host:

这边放置的给 host 的软件包。

有两种情况：

如果该软件包 host-xxx 只是在编译其他软件包时需要，那么不要创建 Config.in.host 文件，只需在.mk 中把 host-xxx 放到其他软件包的 <package-name>_DEPENDENCIES 变量中。
该软件包 host-xxx 需要用户在 menuconfig 中主动选择，那么需要创建 Config.in.host 文件。之后该选项会在 menuconfig->Host utilities 中看到。

语法和 Config.in 一样。

18.3 The .mk file

一般有五种不同的.mk 文件类型：

generic packages
autotools-based packages
cmake-based packages
python modules
lua modules

18.4 The .hash file

对下载下来的文件进行 hash 验证，一般 hash 值 download 网站会提供。

如果 package 提供了版本号，那么一般放在/package/libfoo/1.2.3/libfoo.hash

# Hashes from: http://www.foosoftware.org/download/libfoo-1.2.3.tar.bz2.{sha1,sha256}:
sha1  486fb55c3efa71148fe07895fd713ea3a5ae343a  libfoo-1.2.3.tar.bz2
sha256  efc8103cc3bcb06bda6a781532d12701eb081ad83e8f90004b39ab81b65d4369  libfoo-1.2.3.tar.bz2

# md5 from: http://www.foosoftware.org/download/libfoo-1.2.3.tar.bz2.md5, sha256 locally computed:
md5  2d608f3c318c6b7557d551a5a09314f03452f1a1  libfoo-data.bin
sha256  01ba4719c80b6fe911b091a7c05124b64eeece964e09c058ef8f9805daca546b  libfoo-data.bin

# Locally computed:
sha256  ff52101fb90bbfc3fe9475e425688c660f46216d7e751c4bbdb1dc85cdccacb9  libfoo-fix-blabla.patch

# Hash for license files:
sha256  a45a845012742796534f7e91fe623262ccfb99460a2bd04015bd28d66fba95b8  COPYING
sha256  01b1f9f2c8ee648a7a596a1abe8aa4ed7899b1c9e5551bda06da6e422b04aa55  doc/COPYING.LGPL

18.5 The SNNFoo start script

采用 systemd 启动方式的系统，package 需要提供一个启动脚本。

18.6 Infrastructure for packages with specific build systems

18.6.1 generic-package tutorial

01: ################################################################################
02: #
03: # libfoo
04: #
05: ################################################################################
06:
07: LIBFOO_VERSION = 1.0
08: LIBFOO_SOURCE = libfoo-$(LIBFOO_VERSION).tar.gz
09: LIBFOO_SITE = http://www.foosoftware.org/download
10: LIBFOO_LICENSE = GPL-3.0+
11: LIBFOO_LICENSE_FILES = COPYING
12: LIBFOO_INSTALL_STAGING = YES
13: LIBFOO_CONFIG_SCRIPTS = libfoo-config
14: LIBFOO_DEPENDENCIES = host-libaaa libbbb
15:
16: define LIBFOO_BUILD_CMDS
17:     $(MAKE) $(TARGET_CONFIGURE_OPTS) -C $(@D) all
18: endef
19:
20: define LIBFOO_INSTALL_STAGING_CMDS
21:     $(INSTALL) -D -m 0755 $(@D)/libfoo.a $(STAGING_DIR)/usr/lib/libfoo.a
22:     $(INSTALL) -D -m 0644 $(@D)/foo.h $(STAGING_DIR)/usr/include/foo.h
23:     $(INSTALL) -D -m 0755 $(@D)/libfoo.so* $(STAGING_DIR)/usr/lib
24: endef
25:
26: define LIBFOO_INSTALL_TARGET_CMDS
27:     $(INSTALL) -D -m 0755 $(@D)/libfoo.so* $(TARGET_DIR)/usr/lib
28:     $(INSTALL) -d -m 0755 $(TARGET_DIR)/etc/foo.d
29: endef
30:
31: define LIBFOO_USERS
32:     foo -1 libfoo -1 * - - - LibFoo daemon
33: endef
34:
35: define LIBFOO_DEVICES
36:     /dev/foo c 666 0 0 42 0 - - -
37: endef
38:
39: define LIBFOO_PERMISSIONS
40:     /bin/foo f 4755 foo libfoo - - - - -
41: endef
42:
43: $(eval $(generic-package))

这些操作都依赖于$(@D), 该变量为 package source code 的目录。

43 行表示是 generic package。

18.6.2 generic-package reference

$(eval $(generic-package))
$(eval $(host-generic-package))

generic-package 用来生成 target package, host-generic-package 用来生成 host package, host-generic-package 必须在 generic-package 后面，两者可以同时存在。

生成出来的 package, 以 libfoo package 为例, generic package 的名称为 libfoo, host-generic-package 的名称为 host-libfoo。

generic package 变量以LIBFOO_*开头, host generic package 以HOST_LIBFOO_*开头，如果HOST_LIBFOO_*变量不存在, 那么会使用LIBFOO_*代替。

在 .mk 中可以设置的 metadata information 有(以 libfoo 为例):

LIBFOO_VERSION: mandatory, 版本号，可以是 revision number, tag 等，比如：

a version for a release tarball: LIBFOO_VERSION = 0.1.2
a sha1 for a git tree: LIBFOO_VERSION = cb9d6aa9429e838f0e54faa3d455bcbab5eef057
a tag for a git tree LIBFOO_VERSION = v0.1.2

LIBFOO_SOURCE: 从 LIBFOO_SITE 下载的 tarball 名称。如果不设置的话默认为 libfoo-$(LIBFOO_VERSION).tar.gz

LIBFOO_PATCH: 从 LIBFOO_SITE 下载的 patch 名称。如果 LIBFOO_PATCH 中包含了//, 那么 LIBFOO_PATCH 被认为是 URL, 从该 URL 下载 patch。注意 LIBFOO_PATCH 的 patch 都会在本地 package 目录下的*.patch 打完之后再打上。

LIBFOO_SITE: 下载 URL 或者 local filesystem path。

LIBFOO_DL_OPTS:

LIBFOO_EXTRA_DOWNLOADS:

LIBFOO_SITE_METHOD: 一般不需要主动设置, buildroot 会主动从 LIBFOO_SITE 推测。可选的有 wget, scp, sftp, svn, cvs, git, file(本地 tarball), local(本地源码)…

LIBFOO_GIT_SUBMODULES:

LIBFOO_GIT_LFS:

LIBFOO_SVN_EXTERNALS:

LIBFOO_STRIP_COMPONENTS:

LIBFOO_EXCLUDES: 解压 tarball 时排除的路径, 相当于 tar –exclude。

LIBFOO_DEPENDENCIES: 依赖包。

LIBFOO_EXTRACT_DEPENDENCIES: 解压时的依赖包，不常用。

LIBFOO_PATCH_DEPENDENCIES: 打 patch 时的依赖包, 不常用。

LIBFOO_PROVIDES:

LIBFOO_INSTALL_STAGING: YES or NO。如果为 YES, LIBFOO_INSTALL_STAGING_CMDS 命令执行, 安装 package 到 staging 目录。
LIBFOO_INSTALL_TARGET: YES or NO。如果为 YES, LIBFOO_INSTALL_TARGET_CMDS 命令执行, 安装 package 到 package 目录。
LIBFOO_INSTALL_IMAGES: YES or NO。如果为 YES, LIBFOO_INSTALL_IMAGES_CMDS 命令执行, 安装 package 到 images 目录。

LIBFOO_CONFIG_SCRIPTS: //TODO: 这个有什么用

LIBFOO_DEVICES: 定义该 package 使用的 device node
LIBFOO_PERMISSIONS: 设置该 package install 文件的权限
LIBFOO_USERS: 定义使用该 package 的 user

31: define LIBFOO_USERS
32:     foo -1 libfoo -1 * - - - LibFoo daemon
33: endef
34:
35: define LIBFOO_DEVICES
36:     /dev/foo c 666 0 0 42 0 - - -
37: endef
38:
39: define LIBFOO_PERMISSIONS
40:     /bin/foo f 4755 foo libfoo - - - - -
41: endef

LIBFOO_LICENSE: package license 是哪一种。
LIBFOO_LICENSE_FILES: tarball 解压后的 license 文件名。

下面是一些在不同阶段执行的操作, 一般以 define, endef 包起来:

define LIBFOO_BUILD_CMDS
      action 1
      action 2
      action 3
endef

在这些过程中可以使用如下变量：

$(LIBFOO_PKGDIR): 包含 libfoo.mk 和 Config.in 的 package 目录。
$(@D): buildroot package source code 目录。
$(LIBFOO_DL_DIR): package download 目录。
$(TARGET_CC), $(TARGET_LD), etc. 交叉编译工具链。
$(TARGET_CROSS) 交叉编译工具链前缀。
$(HOST_DIR), $(STAGING_DIR), $(TARGET_DIR)。

LIBFOO_EXTRACT_CMDS: 解压时的命令。一般用来处理 buildroot non-standard archive format, 类似 ZIP, RAR。

LIBFOO_CONFIGURE_CMDS: 编译前的 configure 命令。

LIBFOO_BUILD_CMDS: compile 命令。

HOST_LIBFOO_INSTALL_CMDS host package install 命令, host package 必须安装到 ${HOST_DIR}, 包括 development files 和头文件。

LIBFOO_INSTALL_TARGET_CMDS: target package install files for execution 到 ${TARGET_DIR}。

LIBFOO_INSTALL_STAGING_CMDS: target package install files 到 ${STAGING_DIR}, 包括 development files 和头文件。

LIBFOO_INSTALL_IMAGES_CMDS: target package install image 文件到 ${BINARIES_DIR}。

Application Package 一般只要安装到 target
Shared library 动态库必须安装到 target 与 staging
header-based library 和 static-only library 静态库只安装到 staging
bootloader 和 linux 要安装到 images

LIBFOO_INSTALL_INIT_SYSV:
LIBFOO_INSTALL_INIT_OPENRC:
LIBFOO_INSTALL_INIT_SYSTEMD:

18.8 Infrastructure for CMake-based packages

18.8.1 cmake-package tutorial

e.g.

01: ################################################################################
02: #
03: # libfoo
04: #
05: ################################################################################
06:
07: LIBFOO_VERSION = 1.0
08: LIBFOO_SOURCE = libfoo-$(LIBFOO_VERSION).tar.gz
09: LIBFOO_SITE = http://www.foosoftware.org/download
10: LIBFOO_INSTALL_STAGING = YES
11: LIBFOO_INSTALL_TARGET = NO
12: LIBFOO_CONF_OPTS = -DBUILD_DEMOS=ON
13: LIBFOO_DEPENDENCIES = libglib2 host-pkgconf
14:
15: $(eval $(cmake-package))

18.8.2. cmake-package reference

cmake-package 或 host-cmake-package。

首先所有 generic package 的 metadata 变量都可使用。

cmake-package 的选项：

LIBFOO_SUBDIR: 如果主 CMakeLists.txt 不在 package root, 那么要指明路径。

LIBFOO_CMAKE_BACKEND: 指明 CMake backend。make 或 ninja。

LIBFOO_CONF_ENV: 传递给 CMake 的环境变量。

LIBFOO_CONF_OPTS: 传递给 CMake 的一些额外配置，类似-DXXX 等。

LIBFOO_BUILD_ENV, LIBFOO_BUILD_OPTS:

LIBFOO_SUPPORTS_IN_SOURCE_BUILD: 如果不能在 inside source tree 中编译, 需要设置为 NO

LIBFOO_MAKE
LIBFOO_MAKE_ENV
LIBFOO_MAKE_OPTS

LIBFOO_INSTALL_OPTS: LIBFOO_INSTALL_TARGET_OPTS

18.9 Infrastructure for Python packages

18.9.1 python-package tutorial

e.g.

01: ################################################################################
02: #
03: # python-foo
04: #
05: ################################################################################
06:
07: PYTHON_FOO_VERSION = 1.0
08: PYTHON_FOO_SOURCE = python-foo-$(PYTHON_FOO_VERSION).tar.xz
09: PYTHON_FOO_SITE = http://www.foosoftware.org/download
10: PYTHON_FOO_LICENSE = BSD-3-Clause
11: PYTHON_FOO_LICENSE_FILES = LICENSE
12: PYTHON_FOO_ENV = SOME_VAR=1
13: PYTHON_FOO_DEPENDENCIES = libmad
14: PYTHON_FOO_SETUP_TYPE = setuptools
15:
16: $(eval $(python-package))

18.9.2 python-package reference

python-package 或者 host-python-package。

首先所有 generic package 的 metada 变量都可使用。

python-package 的选项：

必须的有：

PYTHON_FOO_SETUP_TYPE: 指定 python build system。一共支持的有五种 flit, pep517, setuptools, setuptools-rust and maturin。
可从 setup.py 中看出，是否有 import flit/setuptools，那么就使用对应的选项。如果该 package 使用 pyproject.toml，没有 build-system 要求，就使用 pep517。

可选的有：

PYTHON_FOO_SUBDIR: 指明 setup.py 路径。
PYTHON_FOO_ENV: 传递给 setup.py 的参数。 PYTHON_FOO_BUILD_OPTS
PYTHON_FOO_INSTALL_TARGET_OPTS

18.9.3. Generating a python-package from a PyPI repository

如果是 PyPI 管理的包，可以通过 buildroot 目录下的工具自动生成：

utils/scanpypi <package-name> -o <path>。

18.23 Hooks available in the various build steps

My Notes

一些环境变量：

output/对应BASE_DIR
output/build/对应BUILD_DIR
output/host/对应HOST_DIR
- Contains both the tools built for the host (cross-compiler, etc.) and the sysroot of the toolchain
- Host tools are directly in host/
- The sysroot is in host/<tuple>/sysroot/usrE.g: arm-unknown-linux-gnueabihf
- Variable for the sysroot: STAGING_DIR. ouput目录下的staging目录也是软连接到这的
output/target/对应TARGET_DIR
- Used to generate the final root filesystem images in images/
output/image/对应BINARIES_DIR

.mk 文件中的<pkg>_DEPENDENCIES 可以规定编译顺序，<pkg>_DEPENDENCIES 后面的软件包先编译。 host-generic-package 是用来生成 host package 的，host-generic-package 必须在 generic-package 后面。

Buildroot User Manual#

Chapter 4 Buildroot quick start#

PARTⅡ User Guide#

Chapter 6 Buildroot configuration#

6.1 Cross-compilation toolchain#

6.1.1 Internal toolchain backend#

6.1.2 External toolchain backend#

6.2. /dev management#

6.3 init system#

Chapter 7 Configuration of other components#

Chapter 8 General Buildroot usage#

8.2 Understanding when a full rebuild is necessary#

8.3 Understanding how to rebuild packages#

8.5 Building out-of-tree#

8.6 Environment variables#

8.9 Graphing the dependencies between packages#

8.10 Graphing the build duration#

8.11 Graphing the filesystem size contribution of packages#

8.13 Advanced usage#

8.13.1 Using the generated toolchain outside Buildroot#

8.13.2 Using gdb in Buildroot#

8.13.3 Using ccache in Buildroot#

8.13.4 Location of downloaded packages#

8.13.5 Package-specific make targets#

8.13.6 Using Buildroot during development#

Chapter 9 Project-specific customization#

9.1 Recommended directory structure#

9.1.1 Implementing layered customizations#

9.2 Keeping customizations outside of Buildroot#

9.2.1 Layout of a br2-external tree#

9.4 Storing the configuration of other components#

9.5 Customizing the generated target filesystem#

9.5.1 Setting file permissions and ownership and adding custom devices nodes#

9.6 Adding custom user accounts#

9.7 Customization after the images have been created#

9.8 Adding project-specific patches and hashes#

9.9 Adding project-specific packages#

9.10 Quick guide to storing your project-specific customizations#

PartⅢ Developer guide#

Chapter 17 Adding support for a particular board#

Chapter 18. Adding new packages to Buildroot#

18.2 Config files#

18.3 The .mk file#

18.4 The .hash file#

18.5 The SNNFoo start script#

18.6 Infrastructure for packages with specific build systems#

18.6.1 generic-package tutorial#

18.6.2 generic-package reference#

18.8 Infrastructure for CMake-based packages#

18.8.1 cmake-package tutorial#

18.8.2. cmake-package reference#

18.9 Infrastructure for Python packages#

18.9.1 python-package tutorial#

18.9.2 python-package reference#

18.9.3. Generating a python-package from a PyPI repository#

18.23 Hooks available in the various build steps#

My Notes#