---## 场景设定我们要为嵌入式系统添加一个名为 hello-buildroot 的应用它会向控制台打印 Hello from Buildroot!。### 项目结构~/my_project/├── buildroot/ # Buildroot源码树└── app_src/ # 外部应用源码└── hello-buildroot/├── hello.c├── Makefile└── README---## 第一阶段准备应用源码### 1. 创建应用源码**创建应用目录**bashmkdir -p ~/my_project/app_src/hello-buildrootcd ~/my_project/app_src/hello-buildroot**编写 hello.c**c#include stdio.h#include unistd.hint main(int argc, char **argv) {int count 0;printf(Hello from Buildroot!\n);printf(Application running on: );// 打印系统信息#ifdef __linux__printf(Linux);#endif#ifdef __arm__printf( (ARM architecture));#endif#ifdef __x86_64__printf( (x86_64 architecture));#endifprintf(\n\n);// 每秒打印一次当前计数演示程序在运行while(1) {printf(Count: %d\n, count);sleep(1);}return 0;}**编写 Makefile**makefile# 交叉编译工具链变量将由Buildroot自动传入CC $(TARGET_CC)CFLAGS -Wall -O2LDFLAGS TARGET hello-buildrootSOURCES hello.cOBJECTS $(SOURCES:.c.o)all: $(TARGET)$(TARGET): $(OBJECTS)$(CC) $(CFLAGS) -o $ $^ $(LDFLAGS)%.o: %.c$(CC) $(CFLAGS) -c -o $ $clean:rm -f $(OBJECTS) $(TARGET)install:# 安装到目标系统由Buildroot的INSTALL_TARGET_CMDS处理echo Manual install handled by Buildroot.PHONY: all clean install---## 第二阶段创建Buildroot软件包### 2. 创建包目录结构bashcd ~/my_project/buildrootmkdir -p package/hello-buildroot### 3. 编写 Config.in在 package/hello-buildroot/Config.in 中添加kconfigconfig BR2_PACKAGE_HELLO_BUILDROOTbool hello-buildroothelpA simple demo application that prints Hello from Buildroot!This package demonstrates how to add a custom applicationto the Buildroot system.https://example.com/hello-buildroot### 4. 编写 hello-buildroot.mk这是最关键的文件定义如何构建和安装应用。makefile################################################################################# hello-buildroot################################################################################# 版本号可以是日期、git hash或自定义版本HELLO_BUILDROOT_VERSION 1.0.0# 源码位置使用本地源码外部目录HELLO_BUILDROOT_SITE $(TOPDIR)/../app_src/hello-buildrootHELLO_BUILDROOT_SITE_METHOD local# 许可证信息HELLO_BUILDROOT_LICENSE MITHELLO_BUILDROOT_LICENSE_FILES README# 依赖项如果有的话# HELLO_BUILDROOT_DEPENDENCIES libfoo libbar# 定义构建命令define HELLO_BUILDROOT_BUILD_CMDS# $(D) 是解压后的源码目录# 使用Buildroot的交叉编译工具链$(MAKE) CC$(TARGET_CC) LD$(TARGET_LD) \CFLAGS$(TARGET_CFLAGS) \LDFLAGS$(TARGET_LDFLAGS) \-C $(D) allendef# 定义安装到目标系统的命令define HELLO_BUILDROOT_INSTALL_TARGET_CMDS# 创建目标目录如果不存在mkdir -p $(TARGET_DIR)/usr/bin# 安装二进制文件$(INSTALL) -D -m 0755 $(D)/hello-buildroot $(TARGET_DIR)/usr/bin/hello-buildroot# 可选创建配置文件或数据文件# mkdir -p $(TARGET_DIR)/etc/hello# $(INSTALL) -D -m 0644 $(D)/hello.conf $(TARGET_DIR)/etc/hello/hello.confendef# 可选安装到 staging用于开发头文件/库# define HELLO_BUILDROOT_INSTALL_STAGING_CMDS# $(INSTALL) -D -m 0644 $(D)/hello.h $(STAGING_DIR)/usr/include/hello.h# endef# 注册包类型generic是最通用的$(eval $(generic-package))### 5. 将包注册到Buildroot主配置编辑 package/Config.in添加你的包bash# 在合适位置添加比如在 Custom packages 菜单下vi package/Config.in找到合适位置例如文件末尾添加kconfigmenu Custom packagessource package/hello-buildroot/Config.inendmenu---## 第三阶段构建系统### 6. 配置Buildroot进入Buildroot配置界面bashcd ~/my_project/buildroot# 如果没有配置过先选择目标平台以QEMU ARM为例make qemu_arm_vexpress_defconfig# 打开menuconfig选择你的应用make menuconfig在menuconfig中导航到Target packages ---Custom packages ---[*] hello-buildroot保存并退出。### 7. 构建整个系统bash# 开始构建首次会比较慢因为要下载很多依赖make构建完成后输出文件在 output/images/。---## 第四阶段验证安装### 8. 检查安装结果**查看构建日志**bash# 查看是否编译了hello-buildrootgrep hello-buildroot output/build/build-time.log# 查看安装的文件ls -la output/target/usr/bin/hello-buildrootfile output/target/usr/bin/hello-buildroot**查看根文件系统镜像内容**bash# 如果使用ext4格式mkdir -p /tmp/rootfs_checksudo mount -o loop output/images/rootfs.ext4 /tmp/rootfs_checkls -la /tmp/rootfs_check/usr/bin/hello-buildrootsudo umount /tmp/rootfs_check**查看最终的镜像大小**bashls -lh output/images/rootfs.*---## 第五阶段测试运行### 9. 在QEMU中测试假设使用ARM平台bash# 启动QEMU模拟器qemu-system-arm -M vexpress-a9 \-kernel output/images/zImage \-dtb output/images/vexpress-v2p-ca9.dtb \-append root/dev/mmcblk0 consolettyAMA0 \-drive fileoutput/images/rootfs.ext4,ifsd,formatraw \-nographic# 在QEMU中登录后运行应用# 用户名: root (无密码)/usr/bin/hello-buildroot预期输出Hello from Buildroot!Application running on: Linux (ARM architecture)Count: 0Count: 1Count: 2...---## 第六阶段调试与迭代### 10. 修改并重新编译应用当需要修改应用时bash# 1. 修改源码vi ~/my_project/app_src/hello-buildroot/hello.c# 2. 只重新编译你的应用不重建整个系统cd ~/my_project/buildrootrm -rf output/build/hello-buildroot-*make hello-buildroot# 3. 重新生成根文件系统镜像make ext4-rootfs# 4. 重新测试qemu-system-arm ... (同上)---## 完整脚本一键添加应用为了简化过程这里提供一个自动化脚本bash#!/bin/bash# 文件名: add-custom-app.shAPP_NAMEhello-buildrootAPP_SRC_DIR$HOME/my_project/app_src/$APP_NAMEBR_DIR$HOME/my_project/buildrootecho Step 1: Create application source...mkdir -p $APP_SRC_DIRcat $APP_SRC_DIR/hello.c EOF#include stdio.hint main() {printf(Hello from Buildroot!\n);return 0;}EOFcat $APP_SRC_DIR/Makefile EOFCC $(TARGET_CC)CFLAGS -Wall -O2TARGET hello-buildrootSOURCES hello.cOBJECTS $(SOURCES:.c.o)all: $(TARGET)$(TARGET): $(OBJECTS)$(CC) $(CFLAGS) -o $ $^clean:rm -f $(OBJECTS) $(TARGET).PHONY: all cleanEOFecho Step 2: Create Buildroot package...mkdir -p $BR_DIR/package/$APP_NAMEcat $BR_DIR/package/$APP_NAME/Config.in EOFconfig BR2_PACKAGE_HELLO_BUILDROOTbool hello-buildroothelpCustom demo application.EOFcat $BR_DIR/package/$APP_NAME/$APP_NAME.mk EOF################################################################################# hello-buildroot################################################################################HELLO_BUILDROOT_VERSION 1.0.0HELLO_BUILDROOT_SITE \$(TOPDIR)/../app_src/hello-buildrootHELLO_BUILDROOT_SITE_METHOD localHELLO_BUILDROOT_LICENSE MITdefine HELLO_BUILDROOT_BUILD_CMDS\$(MAKE) CC\$(TARGET_CC) -C \$(D) allendefdefine HELLO_BUILDROOT_INSTALL_TARGET_CMDS\$(INSTALL) -D -m 0755 \$(D)/hello-buildroot \$(TARGET_DIR)/usr/bin/hello-buildrootendef\$(eval \$(generic-package))EOFecho Step 3: Register package...if ! grep -q hello-buildroot $BR_DIR/package/Config.in; thenecho source package/hello-buildroot/Config.in $BR_DIR/package/Config.infiecho Done! Now run:echo cd $BR_DIRecho make menuconfig # Enable hello-buildrootecho make---## 关键概念总结| 步骤 | 文件/位置 | 作用 ||------|-----------|------|| 源码准备 | app_src/hello-buildroot/ | 应用程序源代码 || 包描述 | package/hello-buildroot/Config.in | 在menuconfig中显示选项 || 构建规则 | package/hello-buildroot/hello-buildroot.mk | 定义如何编译和安装 || 包注册 | package/Config.in | 让Buildroot知道你的包 || 输出位置 | output/target/ | 安装后的文件构建时 || 最终镜像 | output/images/rootfs.* | 可烧录的根文件系统镜像 |---## 常见陷阱与解决方案1. **问题**编译时找不到头文件**解决**在 .mk 文件中添加依赖makefileHELLO_BUILDROOT_DEPENDENCIES libfoo2. **问题**应用无法运行缺少共享库**解决**检查依赖并添加makefileHELLO_BUILDROOT_DEPENDENCIES libcurl openssl3. **问题**修改源码后 make 没有重新编译**解决**删除构建目录bashrm -rf output/build/hello-buildroot-*make hello-buildroot4. **问题**应用安装到了错误的位置**解决**检查 INSTALL_TARGET_CMDS 中的路径makefile$(INSTALL) -D -m 0755 $(D)/hello-buildroot $(TARGET_DIR)/usr/bin/hello-buildroot---## 拓展添加启动脚本如果想让应用开机自动运行可以添加启动脚本makefile# 在 hello-buildroot.mk 中添加define HELLO_BUILDROOT_INSTALL_INIT_SYSV$(INSTALL) -D -m 0755 package/hello-buildroot/S99hello \$(TARGET_DIR)/etc/init.d/S99helloendef创建 package/hello-buildroot/S99hellobash#!/bin/shcase $1 instart)echo Starting hello-buildroot.../usr/bin/hello-buildroot ;;stop)killall hello-buildroot;;esacexit 0这样应用就会在系统启动时自动运行了。---
---## 场景设定我们要为嵌入式系统添加一个名为 hello-buildroot 的应用它会向控制台打印 Hello from Buildroot!。### 项目结构~/my_project/├── buildroot/ # Buildroot源码树└── app_src/ # 外部应用源码└── hello-buildroot/├── hello.c├── Makefile└── README---## 第一阶段准备应用源码### 1. 创建应用源码**创建应用目录**bashmkdir -p ~/my_project/app_src/hello-buildrootcd ~/my_project/app_src/hello-buildroot**编写 hello.c**c#include stdio.h#include unistd.hint main(int argc, char **argv) {int count 0;printf(Hello from Buildroot!\n);printf(Application running on: );// 打印系统信息#ifdef __linux__printf(Linux);#endif#ifdef __arm__printf( (ARM architecture));#endif#ifdef __x86_64__printf( (x86_64 architecture));#endifprintf(\n\n);// 每秒打印一次当前计数演示程序在运行while(1) {printf(Count: %d\n, count);sleep(1);}return 0;}**编写 Makefile**makefile# 交叉编译工具链变量将由Buildroot自动传入CC $(TARGET_CC)CFLAGS -Wall -O2LDFLAGS TARGET hello-buildrootSOURCES hello.cOBJECTS $(SOURCES:.c.o)all: $(TARGET)$(TARGET): $(OBJECTS)$(CC) $(CFLAGS) -o $ $^ $(LDFLAGS)%.o: %.c$(CC) $(CFLAGS) -c -o $ $clean:rm -f $(OBJECTS) $(TARGET)install:# 安装到目标系统由Buildroot的INSTALL_TARGET_CMDS处理echo Manual install handled by Buildroot.PHONY: all clean install---## 第二阶段创建Buildroot软件包### 2. 创建包目录结构bashcd ~/my_project/buildrootmkdir -p package/hello-buildroot### 3. 编写 Config.in在 package/hello-buildroot/Config.in 中添加kconfigconfig BR2_PACKAGE_HELLO_BUILDROOTbool hello-buildroothelpA simple demo application that prints Hello from Buildroot!This package demonstrates how to add a custom applicationto the Buildroot system.https://example.com/hello-buildroot### 4. 编写 hello-buildroot.mk这是最关键的文件定义如何构建和安装应用。makefile################################################################################# hello-buildroot################################################################################# 版本号可以是日期、git hash或自定义版本HELLO_BUILDROOT_VERSION 1.0.0# 源码位置使用本地源码外部目录HELLO_BUILDROOT_SITE $(TOPDIR)/../app_src/hello-buildrootHELLO_BUILDROOT_SITE_METHOD local# 许可证信息HELLO_BUILDROOT_LICENSE MITHELLO_BUILDROOT_LICENSE_FILES README# 依赖项如果有的话# HELLO_BUILDROOT_DEPENDENCIES libfoo libbar# 定义构建命令define HELLO_BUILDROOT_BUILD_CMDS# $(D) 是解压后的源码目录# 使用Buildroot的交叉编译工具链$(MAKE) CC$(TARGET_CC) LD$(TARGET_LD) \CFLAGS$(TARGET_CFLAGS) \LDFLAGS$(TARGET_LDFLAGS) \-C $(D) allendef# 定义安装到目标系统的命令define HELLO_BUILDROOT_INSTALL_TARGET_CMDS# 创建目标目录如果不存在mkdir -p $(TARGET_DIR)/usr/bin# 安装二进制文件$(INSTALL) -D -m 0755 $(D)/hello-buildroot $(TARGET_DIR)/usr/bin/hello-buildroot# 可选创建配置文件或数据文件# mkdir -p $(TARGET_DIR)/etc/hello# $(INSTALL) -D -m 0644 $(D)/hello.conf $(TARGET_DIR)/etc/hello/hello.confendef# 可选安装到 staging用于开发头文件/库# define HELLO_BUILDROOT_INSTALL_STAGING_CMDS# $(INSTALL) -D -m 0644 $(D)/hello.h $(STAGING_DIR)/usr/include/hello.h# endef# 注册包类型generic是最通用的$(eval $(generic-package))### 5. 将包注册到Buildroot主配置编辑 package/Config.in添加你的包bash# 在合适位置添加比如在 Custom packages 菜单下vi package/Config.in找到合适位置例如文件末尾添加kconfigmenu Custom packagessource package/hello-buildroot/Config.inendmenu---## 第三阶段构建系统### 6. 配置Buildroot进入Buildroot配置界面bashcd ~/my_project/buildroot# 如果没有配置过先选择目标平台以QEMU ARM为例make qemu_arm_vexpress_defconfig# 打开menuconfig选择你的应用make menuconfig在menuconfig中导航到Target packages ---Custom packages ---[*] hello-buildroot保存并退出。### 7. 构建整个系统bash# 开始构建首次会比较慢因为要下载很多依赖make构建完成后输出文件在 output/images/。---## 第四阶段验证安装### 8. 检查安装结果**查看构建日志**bash# 查看是否编译了hello-buildrootgrep hello-buildroot output/build/build-time.log# 查看安装的文件ls -la output/target/usr/bin/hello-buildrootfile output/target/usr/bin/hello-buildroot**查看根文件系统镜像内容**bash# 如果使用ext4格式mkdir -p /tmp/rootfs_checksudo mount -o loop output/images/rootfs.ext4 /tmp/rootfs_checkls -la /tmp/rootfs_check/usr/bin/hello-buildrootsudo umount /tmp/rootfs_check**查看最终的镜像大小**bashls -lh output/images/rootfs.*---## 第五阶段测试运行### 9. 在QEMU中测试假设使用ARM平台bash# 启动QEMU模拟器qemu-system-arm -M vexpress-a9 \-kernel output/images/zImage \-dtb output/images/vexpress-v2p-ca9.dtb \-append root/dev/mmcblk0 consolettyAMA0 \-drive fileoutput/images/rootfs.ext4,ifsd,formatraw \-nographic# 在QEMU中登录后运行应用# 用户名: root (无密码)/usr/bin/hello-buildroot预期输出Hello from Buildroot!Application running on: Linux (ARM architecture)Count: 0Count: 1Count: 2...---## 第六阶段调试与迭代### 10. 修改并重新编译应用当需要修改应用时bash# 1. 修改源码vi ~/my_project/app_src/hello-buildroot/hello.c# 2. 只重新编译你的应用不重建整个系统cd ~/my_project/buildrootrm -rf output/build/hello-buildroot-*make hello-buildroot# 3. 重新生成根文件系统镜像make ext4-rootfs# 4. 重新测试qemu-system-arm ... (同上)---## 完整脚本一键添加应用为了简化过程这里提供一个自动化脚本bash#!/bin/bash# 文件名: add-custom-app.shAPP_NAMEhello-buildrootAPP_SRC_DIR$HOME/my_project/app_src/$APP_NAMEBR_DIR$HOME/my_project/buildrootecho Step 1: Create application source...mkdir -p $APP_SRC_DIRcat $APP_SRC_DIR/hello.c EOF#include stdio.hint main() {printf(Hello from Buildroot!\n);return 0;}EOFcat $APP_SRC_DIR/Makefile EOFCC $(TARGET_CC)CFLAGS -Wall -O2TARGET hello-buildrootSOURCES hello.cOBJECTS $(SOURCES:.c.o)all: $(TARGET)$(TARGET): $(OBJECTS)$(CC) $(CFLAGS) -o $ $^clean:rm -f $(OBJECTS) $(TARGET).PHONY: all cleanEOFecho Step 2: Create Buildroot package...mkdir -p $BR_DIR/package/$APP_NAMEcat $BR_DIR/package/$APP_NAME/Config.in EOFconfig BR2_PACKAGE_HELLO_BUILDROOTbool hello-buildroothelpCustom demo application.EOFcat $BR_DIR/package/$APP_NAME/$APP_NAME.mk EOF################################################################################# hello-buildroot################################################################################HELLO_BUILDROOT_VERSION 1.0.0HELLO_BUILDROOT_SITE \$(TOPDIR)/../app_src/hello-buildrootHELLO_BUILDROOT_SITE_METHOD localHELLO_BUILDROOT_LICENSE MITdefine HELLO_BUILDROOT_BUILD_CMDS\$(MAKE) CC\$(TARGET_CC) -C \$(D) allendefdefine HELLO_BUILDROOT_INSTALL_TARGET_CMDS\$(INSTALL) -D -m 0755 \$(D)/hello-buildroot \$(TARGET_DIR)/usr/bin/hello-buildrootendef\$(eval \$(generic-package))EOFecho Step 3: Register package...if ! grep -q hello-buildroot $BR_DIR/package/Config.in; thenecho source package/hello-buildroot/Config.in $BR_DIR/package/Config.infiecho Done! Now run:echo cd $BR_DIRecho make menuconfig # Enable hello-buildrootecho make---## 关键概念总结| 步骤 | 文件/位置 | 作用 ||------|-----------|------|| 源码准备 | app_src/hello-buildroot/ | 应用程序源代码 || 包描述 | package/hello-buildroot/Config.in | 在menuconfig中显示选项 || 构建规则 | package/hello-buildroot/hello-buildroot.mk | 定义如何编译和安装 || 包注册 | package/Config.in | 让Buildroot知道你的包 || 输出位置 | output/target/ | 安装后的文件构建时 || 最终镜像 | output/images/rootfs.* | 可烧录的根文件系统镜像 |---## 常见陷阱与解决方案1. **问题**编译时找不到头文件**解决**在 .mk 文件中添加依赖makefileHELLO_BUILDROOT_DEPENDENCIES libfoo2. **问题**应用无法运行缺少共享库**解决**检查依赖并添加makefileHELLO_BUILDROOT_DEPENDENCIES libcurl openssl3. **问题**修改源码后 make 没有重新编译**解决**删除构建目录bashrm -rf output/build/hello-buildroot-*make hello-buildroot4. **问题**应用安装到了错误的位置**解决**检查 INSTALL_TARGET_CMDS 中的路径makefile$(INSTALL) -D -m 0755 $(D)/hello-buildroot $(TARGET_DIR)/usr/bin/hello-buildroot---## 拓展添加启动脚本如果想让应用开机自动运行可以添加启动脚本makefile# 在 hello-buildroot.mk 中添加define HELLO_BUILDROOT_INSTALL_INIT_SYSV$(INSTALL) -D -m 0755 package/hello-buildroot/S99hello \$(TARGET_DIR)/etc/init.d/S99helloendef创建 package/hello-buildroot/S99hellobash#!/bin/shcase $1 instart)echo Starting hello-buildroot.../usr/bin/hello-buildroot ;;stop)killall hello-buildroot;;esacexit 0这样应用就会在系统启动时自动运行了。---
