buildroot添加自定义应用过程
---## 场景设定我们要为嵌入式系统添加一个名为 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这样应用就会在系统启动时自动运行了。---

相关新闻

Unity游戏模组开发入门:BepInEx框架原理、安装与插件开发实战

Unity游戏模组开发入门:BepInEx框架原理、安装与插件开发实战

1. 项目概述:为什么BepInEx是Unity游戏模组开发的基石如果你玩过基于Unity引擎开发的PC游戏,尤其是那些在Steam创意工坊里拥有海量玩家自制内容的作品,你大概率已经间接接触过BepInEx了。它不是一个直接面向玩家的工具,而是连接玩…

2026/11/17 12:24:28 阅读更多 →
L3级自动驾驶技术解析:从传感器融合到产业化落地路径

L3级自动驾驶技术解析:从传感器融合到产业化落地路径

这次我们来深入探讨华为智能汽车解决方案BU CEO靳玉志关于L3级自动驾驶的最新观点。靳玉志明确表示"L3无法跳过",这一判断对整个自动驾驶行业的发展路径具有重要指导意义。随着自动驾驶技术从L2向更高级别演进,法律法规完善与用户适应确实都需…

2026/11/17 12:24:28 阅读更多 →
C++构建图床云存储服务:从HTTP解析到JWT认证的完整实践

C++构建图床云存储服务:从HTTP解析到JWT认证的完整实践

1. 项目概述:从零构建一个C图床云存储服务最近在整理个人博客和项目文档时,图片管理一直是个头疼的问题。用第三方图床总担心服务不稳定或政策变化,自己搭又觉得太复杂。于是,我决定用C手搓一个轻量级的图床共享云存储服务&#x…

2026/11/11 4:41:21 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/17 8:22:52 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/16 6:41:34 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/16 8:22:12 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/17 11:26:33 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/16 7:30:18 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/16 8:22:12 阅读更多 →

日新闻

周新闻

月新闻