(二)从零构建嵌入式Linux:SDK编译与交叉工具链实战

张开发
2026/4/11 23:07:36 15 分钟阅读

分享文章

(二)从零构建嵌入式Linux:SDK编译与交叉工具链实战
1. 嵌入式Linux开发环境搭建第一次接触嵌入式Linux开发的朋友们可能会被各种专业术语搞得一头雾水。别担心今天我就用最接地气的方式带大家从零开始搭建开发环境。我最近刚用全志T113-i芯片完成了一个项目正好把整个流程梳理出来分享给大家。嵌入式Linux开发和我们平时在电脑上写程序最大的区别就是交叉编译。简单来说就是在性能强大的电脑上编译出能在资源有限的嵌入式设备上运行的程序。这就好比你在现代化的厨房里做好一顿大餐然后打包送到野外去享用。1.1 SDK解压与准备工作拿到官方提供的SDK包后第一步就是解压。我建议在Linux系统下操作Windows用户可以用虚拟机或者WSL。解压命令很简单tar -zxvf LinuxSDK-v2.5.tar.gz -C /home/yourname/SDK这里有几个细节要注意-C参数后面跟的是目标路径记得改成你自己的参数-z表示解压gzip压缩包-x表示解压-v显示过程-f指定文件名路径最好用英文避免中文路径可能带来的问题解压完成后你会看到一堆目录和文件。初次接触可能会觉得眼花缭乱但其实主要关注这几个brandy/包含bootloader相关代码kernel/Linux内核源码buildroot/构建根文件系统的工具device/设备相关配置1.2 安装依赖软件接下来要安装各种依赖软件这一步特别容易出问题。我刚开始做的时候经常因为漏装某个依赖导致编译失败。后来我总结了一个完整的依赖列表sudo apt-get install -y build-essential bison flex libncurses5-dev \ libssl-dev libelf-dev bc git u-boot-tools device-tree-compiler \ gcc-arm-linux-gnueabi g-arm-linux-gnueabi这些依赖主要分为几类编译工具gcc、make等基础编译工具内核编译依赖libncurses用于menuconfig配置界面uboot工具mkimage等uboot相关工具交叉编译工具链arm-linux-gnueabi系列工具有些SDK会提供自动安装脚本比如install_tools.sh。如果有的话直接运行会更方便。不过我还是建议了解每个依赖的作用这样遇到问题时才能快速定位。1.3 处理Buildroot的dl目录Buildroot是一个自动化构建根文件系统的工具它会自动下载各种开源软件包。但是这些下载过程往往很耗时而且容易因为网络问题失败。官方SDK通常会提供一个预下载好的dl.tar.gz包我们可以直接解压到buildroot目录下tar xvf dl.tar.gz -C SDK/T113-i_v1.0/buildroot/buildroot-201902/这样做有几个好处节省大量下载时间避免网络问题导致的编译失败保证软件版本的一致性解压后检查一下dl目录应该包含各种开源软件的压缩包比如busybox、zlib等。如果发现某些包缺失可能需要手动下载补充。2. Linux系统镜像编译实战环境准备好后就可以开始编译整个系统了。这个过程有点像搭积木需要按正确顺序组装各个组件。我把它分为几个关键步骤每个步骤都有需要注意的细节。2.1 初始配置与清理在开始编译前建议先执行清理操作./build.sh distclean这个命令会清除之前的所有编译产物和配置。虽然第一次编译时可能没有旧文件但养成这个习惯很重要可以避免很多奇怪的问题。接下来是配置编译环境./build.sh config运行后会进入一个配置界面需要选择处理器型号T113-i开发板型号tlt113-evm-emmc编译器类型gnueabi或gnueabihf这里有个小技巧如果你不确定选哪个可以先记下默认选项等熟悉后再尝试其他配置。我刚开始就选错了编译器类型导致后面运行时出现奇怪的浮点错误。2.2 完整编译流程配置完成后就可以开始编译了。执行./build.sh这里有个特别重要的注意事项第一次编译需要执行两次这是全志平台的一个特点如果不这样做生成的镜像可能无法正常启动。编译过程根据电脑配置不同可能需要30分钟到几个小时。我的i7笔记本大概用了80分钟。期间可以观察编译输出如果有错误会很明显地显示出来。编译完成后在out目录下会生成各种镜像文件boot0_*.binSPLSecondary Program Loader镜像u-boot-sun8iw20p1.binU-Boot镜像boot.img内核镜像rootfs.ext4根文件系统2.3 常见问题排查在实际操作中你可能会遇到这些问题依赖缺失表现为编译中途报错提示某个命令或库找不到。解决方法就是安装对应的软件包。权限问题有些操作需要root权限比如挂载镜像文件。可以用sudo解决但要注意安全。空间不足完整编译可能需要10GB以上的磁盘空间。如果空间不够可以尝试删除中间文件或扩大虚拟机磁盘。网络问题虽然用了预下载的dl包但有些脚本可能还是会尝试联网。如果公司网络有限制可以考虑使用手机热点。遇到问题时建议仔细阅读错误信息检查相关日志文件搜索错误关键词在开发者社区提问3. 系统组件配置详解现在我们已经能编译出完整的系统镜像了但实际项目中经常需要定制各个组件。下面我就详细介绍如何配置内核、U-Boot和Buildroot。3.1 Linux内核配置内核配置是个精细活需要根据硬件特性和项目需求进行调整。进入内核源码目录cd SDK/T113-i_v1.0/kernel/linux-5.4 make ARCHarm menuconfig这会打开一个基于ncurses的配置界面。几个关键配置项CPU类型确保选中正确的ARM架构和CPU型号设备驱动根据硬件选择对应的外设驱动文件系统选择项目需要的文件系统支持内核特性如实时性需求、电源管理等配置完成后保存会生成新的.config文件。然后需要重新编译内核./build.sh kernel3.2 U-Boot配置U-Boot是系统的引导程序负责初始化硬件并加载内核。配置方法类似cd SDK/T113-i_v1.0/brandy/brandy-2.0/u-boot-2018 make ARCHarm menuconfig重要配置包括板级配置选择正确的开发板定义启动参数设置内核加载地址、设备树等环境变量定义bootcmd等关键变量驱动支持如存储设备、网络等修改后同样需要重新编译./build.sh brandy3.3 Buildroot定制Buildroot决定了根文件系统的内容。配置命令cd SDK/T113-i_v1.0/buildroot/buildroot-201902 make menuconfig这里可以添加或删除软件包配置busybox功能设置系统初始化脚本定制用户和权限修改后需要重新编译文件系统./build.sh buildroot4. 交叉编译链配置与使用交叉编译是嵌入式开发的核心技能。简单说就是在x86电脑上编译出能在ARM芯片上运行的程序。下面我就详细介绍如何配置和使用交叉编译工具链。4.1 工具链路径配置编译完成后SDK会生成专用的交叉编译工具链路径通常在out/t113_i/tlt113-evm-emmc/longan/buildroot/host/usr/bin为了让系统在任何目录都能使用这些工具需要把它们添加到环境变量中。编辑~/.bashrc文件vi ~/.bashrc添加以下内容export ARCHarm export CROSS_COMPILEarm-linux-gnueabi- export PATH$PATH:/path/to/toolchain/bin然后使配置生效source ~/.bashrc4.2 交叉编译测试写个简单的Hello World程序测试// hello.c #include stdio.h int main() { printf(Hello Embedded Linux!\n); return 0; }用交叉编译器编译arm-linux-gnueabi-gcc hello.c -o hello用file命令查看生成的可执行文件file hello应该显示为ARM架构的可执行文件。你可以在开发板上运行它验证交叉编译是否成功。4.3 实际项目中的应用在实际项目中交叉编译不仅仅用于简单的C程序。你可能还需要编译第三方库很多开源库需要先用交叉编译配置和编译构建复杂项目使用make或cmake管理的大型项目需要正确设置交叉编译参数调试技巧使用gdbserver在目标板上调试交叉编译的程序记住一个原则所有在目标板上运行的程序都应该用交叉编译器编译。直接使用本地编译器生成的程序是无法在ARM平台上运行的。5. 高级技巧与经验分享经过前面的步骤你应该已经能够构建基本的嵌入式Linux系统了。下面分享一些我在实际项目中总结的高级技巧这些内容很少在官方文档中提到但非常实用。5.1 局部编译与快速迭代全量编译整个系统非常耗时开发时我们可以使用局部编译来提高效率。常用的局部编译命令# 只编译uboot ./build.sh brandy # 只编译内核 ./build.sh kernel # 只编译文件系统 ./build.sh buildroot # 只打包镜像 ./build.sh pack但要注意修改设备树后必须完整编译./build.sh因为设备树的处理流程比较特殊。5.2 镜像烧写与调试编译生成的镜像通常需要烧写到存储设备中。常用的烧写方式有USB烧写通过全志的PhoenixSuit工具TF卡烧写直接用dd命令写入网络烧写通过uboot的tftp功能我推荐新手先用TF卡方式因为最简单。将TF卡插入读卡器然后sudo dd ifout/t113_i_linux_tlt113-evm-emmc_uart0.img of/dev/sdX bs1M注意把sdX换成你的实际设备名千万别搞错否则可能擦除系统硬盘5.3 性能优化技巧随着项目复杂度的增加你可能会遇到性能问题。几个优化方向内核裁剪去掉不需要的驱动和功能减小内核体积文件系统优化使用squashfs等压缩文件系统启动加速优化init流程并行启动服务内存管理调整swappiness等参数我曾经通过内核裁剪把启动时间从15秒缩短到了5秒。关键是要了解项目的实际需求不要盲目优化。6. 项目实战构建一个最小系统现在我们把所有知识串联起来实际构建一个能运行的最小系统。这个系统只包含最基本的组件非常适合作为学习起点。6.1 系统配置选择在menuconfig界面中我们选择以下配置内核去掉所有不必要的驱动只保留基础功能和网卡驱动Buildroot选择busybox提供基础命令去掉所有额外软件包U-Boot使用默认配置添加网络支持这样生成的系统镜像大约只有8MB左右包含了精简版Linux内核2MB基础根文件系统5MBU-Boot1MB6.2 编译与测试执行完整编译./build.sh distclean ./build.sh config # 选择最小配置 ./build.sh ./build.sh ./build.sh pack生成的镜像文件可以直接烧写到TF卡中。插入开发板通电你应该能在串口终端中看到启动日志最后进入shell提示符。虽然这个系统功能有限但它验证了我们的工具链和编译流程是正确的。后续可以根据需要逐步添加更多功能。6.3 添加自定义程序让我们尝试添加一个简单的自定义程序。创建一个新的目录存放我们的项目mkdir myapp cd myapp编写一个简单的LED控制程序// led.c #include stdio.h #include stdlib.h #include fcntl.h #include unistd.h int main() { int fd open(/sys/class/leds/user-led/brightness, O_WRONLY); if(fd 0) { perror(Open LED failed); return 1; } while(1) { write(fd, 1, 1); sleep(1); write(fd, 0, 1); sleep(1); } close(fd); return 0; }用交叉编译器编译arm-linux-gnueabi-gcc led.c -o led把生成的可执行文件放到文件系统的/usr/bin目录下。可以通过以下方式实现在Buildroot中创建一个自定义的overlay目录把你的程序放在overlay/usr/bin下重新编译文件系统这样每次生成的文件系统都会包含你的程序。当然更正规的做法是创建一个Buildroot package但这需要更多配置工作。7. 开发中的实用技巧在长期的项目开发中我积累了一些非常实用的技巧现在分享给大家。这些技巧能显著提高开发效率减少不必要的麻烦。7.1 版本控制策略嵌入式Linux开发涉及大量源码和配置好的版本控制策略非常重要。我的建议是SDK基础版本保持官方SDK原样作为基础标签自定义修改在自己的分支上进行所有修改模块化管理对内核、uboot等大组件使用git submodule配置归档保存各个版本的.config文件这样当官方发布SDK更新时你可以方便地合并到自己的分支中而不必从头开始。7.2 自动化构建手动执行编译命令既枯燥又容易出错。我们可以编写简单的脚本来自动化这个过程#!/bin/bash # 清理环境 ./build.sh distclean # 配置 ./build.sh config # 两次编译 ./build.sh ./build.sh # 打包 ./build.sh pack # 复制镜像文件 cp out/t113_i_linux_tlt113-evm-emmc_uart0.img /release/更进一步可以设置CI/CD系统在代码提交时自动构建并测试。7.3 调试方法嵌入式系统调试比普通程序更复杂。常用的调试手段包括串口调试最基本也是最重要的调试手段网络调试通过ssh或telnet远程访问日志系统syslog或自定义日志文件内核调试使用printk和dmesg性能分析top、vmstat等工具我强烈建议在开发初期就建立完善的日志系统这对后期排查问题非常有帮助。8. 从开发板到产品学习嵌入式Linux的最终目标是要做出真正的产品。从开发板到产品还有很长的路要走。下面我分享一些产品化过程中的关键点。8.1 系统裁剪与优化产品对系统的要求通常比开发板更严格尺寸优化移除所有不必要的组件减小镜像体积启动优化加速启动过程提升用户体验安全加固关闭调试接口加强权限控制稳定性测试长时间运行测试确保不会内存泄漏或崩溃我曾经参与过一个智能家居项目通过系统裁剪把镜像体积从60MB减小到了25MB大大降低了存储成本。8.2 生产烧录方案产品量产时不能再用开发板的烧录方式。常见的量产方案包括专用烧录器速度快适合大批量生产SD卡克隆小批量生产的经济选择在线烧录通过USB或网络直接烧录无论哪种方案都要考虑烧录速度错误检测序列号写入生产测试8.3 现场升级维护产品部署后还需要考虑固件升级方案本地升级通过U盘或SD卡网络升级HTTP或OTA无线升级差分升级只升级变化部分节省带宽好的升级方案应该做到安全可靠支持回滚进度显示错误恢复我曾经设计过一个双系统分区方案即使升级失败也能自动回退到旧版本大大提高了系统可靠性。

更多文章