1. 为什么今天还要折腾Ubuntu 14.04看到这个标题你可能会觉得有点“复古”。确实Ubuntu 14.04 LTSTrusty Tahr在2024年的今天早已过了官方支持的生命周期。主流开发环境早已拥抱Ubuntu 20.04、22.04甚至更新的版本。那么为什么我们还要专门讨论在这个“老古董”上搭建RT-Thread的开发环境呢这背后其实有几个非常现实的场景。首先嵌入式开发的“长尾效应”。很多老旧的工控设备、医疗仪器、工业网关其出厂时配套的SDK、BSP板级支持包和编译工具链就是基于特定版本的Linux系统比如Ubuntu 14.04构建和测试的。贸然升级宿主机的操作系统极有可能导致工具链不兼容、库文件版本冲突最终编译出来的固件无法运行或者出现一些难以排查的玄学问题。对于维护这些存量设备的开发者来说保持与原始开发环境的一致性是最高效、最稳妥的选择。其次虚拟机或容器的轻量化需求。Ubuntu 14.04作为一个相对轻量的系统非常适合在虚拟机如VirtualBox、VMware或Docker容器中快速部署一个纯净的、专用于特定项目编译的隔离环境。你不需要在主力机上安装一堆可能用不到的旧库一个轻量的Ubuntu 14.04镜像就能完美解决环境依赖问题。最后学习与复现的确定性。很多经典的RT-Thread教程、书籍或开源项目其操作步骤是基于数年前的Ubuntu LTS版本记录的。为了能原汁原味地复现教程中的每一步避免因系统差异带来的额外调试成本直接使用教程指定的系统版本是最佳路径。RT-Thread本身虽然对新系统兼容性越来越好但其庞大的软件包生态和多样的BSP确保在“原配”环境下工作能减少很多不必要的麻烦。所以这篇指南的目标非常明确为那些因为项目维护、环境隔离或学习复现而必须在Ubuntu 14.04上搭建RT-Thread开发环境的工程师提供一份详尽、可靠、一步一坑都踩过的实操手册。我会假设你有一台刚安装好的、纯净的Ubuntu 14.04系统实体机或虚拟机我们从零开始直到能成功编译并运行一个RT-Thread的示例工程。2. 环境准备系统更新与基础工具链安装好Ubuntu 14.04后第一件事不是急着下载RT-Thread而是先给这个“老系统”打好基础。由于官方源已经停止维护我们需要先处理软件源然后安装编译所需的各类工具。2.1 修正软件源与系统更新Ubuntu 14.04的官方源archive.ubuntu.com已经移到了old-releases仓库。直接apt-get update会报错。我们需要修改软件源列表。打开终端备份并编辑源列表文件sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak sudo vim /etc/apt/sources.list将文件内的所有http://archive.ubuntu.com/ubuntu替换为http://old-releases.ubuntu.com/ubuntu。同样将http://security.ubuntu.com/ubuntu替换为http://old-releases.ubuntu.com/ubuntu。一个可用的参考源如下注意务必根据你的系统版本是32位还是64位选择deb http://old-releases.ubuntu.com/ubuntu/ trusty main restricted universe multiverse这类格式deb http://old-releases.ubuntu.com/ubuntu/ trusty main restricted universe multiverse deb http://old-releases.ubuntu.com/ubuntu/ trusty-security main restricted universe multiverse deb http://old-releases.ubuntu.com/ubuntu/ trusty-updates main restricted universe multiverse deb http://old-releases.ubuntu.com/ubuntu/ trusty-backports main restricted universe multiverse保存退出后执行更新sudo apt-get update sudo apt-get upgrade -y注意upgrade过程可能会比较慢并且可能会提示某些软件包无法更新或已被废弃这是正常的。只要核心系统包能更新即可我们不需要一个完全最新的系统只需要一个能工作的基础环境。2.2 安装编译RT-Thread的必备工具RT-Thread的编译主要依赖GCC交叉编译工具链、Python、SCons构建工具、以及一些辅助工具。在Ubuntu 14.04上我们需要安装特定版本的软件包。安装基础开发工具sudo apt-get install -y build-essential git wget curlbuild-essential包含了gcc, g, make等基础编译工具这是任何开发环境的基石。安装Python与pip RT-Thread的构建系统scons依赖于Python。Ubuntu 14.04默认的Python 2.7.6版本过低我们需要安装Python 3和pip。sudo apt-get install -y python3 python3-pip安装后建议将pip3设置为默认pip并升级到最新版本在旧系统上可用版本sudo update-alternatives --install /usr/bin/python python /usr/bin/python3 1 sudo pip3 install --upgrade pip安装SCons构建工具 RT-Thread使用SCons作为其构建系统。直接通过pip安装指定版本3.0版本即可但不宜过高以免兼容性问题sudo pip install scons3.1.2安装完成后运行scons --version验证是否成功。安装设备树编译器dtc 对于使用Linux作为开发主机且目标平台涉及设备树如某些ARM SoC的情况需要安装dtc。sudo apt-get install -y device-tree-compiler安装其他可能需要的库sudo apt-get install -y libncurses5-dev libncursesw5-dev这两个库是用于menuconfig配置界面基于ncurses的依赖非常重要。没有它们后续运行menuconfig配置系统时会报错。至此你的Ubuntu 14.04已经具备了编译RT-Thread所需的基本宿主环境。接下来我们将进入核心环节获取RT-Thread源码和对应的交叉编译工具链。3. 获取RT-Thread源码与交叉工具链RT-Thread是一个模块化程度很高的实时操作系统其源码托管在GitHub和Gitee上。为了获得最佳的网络体验我们通常从Gitee克隆。3.1 克隆RT-Thread源码打开终端选择一个你习惯的工作目录例如~/workspacemkdir -p ~/workspace/rt-thread cd ~/workspace/rt-thread git clone https://gitee.com/rtthread/rt-thread.git克隆完成后进入源码目录cd rt-thread你可以通过git tag查看所有发布版本。对于学习和大多数应用使用最新的稳定版如v4.1.1或master分支即可。这里我们切换到最新的LTS版本以当时最新为准例如git checkout v4.1.1实操心得对于生产项目强烈建议锁定一个具体的发布版本Tag而不是使用时刻变动的master分支。这能确保项目代码的稳定性和可复现性。你可以通过git checkout -b my_project v4.1.1来基于特定版本创建自己的开发分支。3.2 安装与配置交叉编译工具链这是整个环境搭建中最关键、也最容易出问题的一步。交叉编译工具链Cross-Compilation Toolchain允许你在x86的Ubuntu系统上编译生成运行在ARM、RISC-V等架构芯片上的二进制文件。RT-Thread支持多种架构我们以最常用的ARM Cortex-M系列使用ARM GNU工具链为例。下载ARM GNU工具链 访问ARM官方开发者网站或国内镜像站下载。由于网络原因推荐使用国内镜像。例如下载gcc-arm-none-eabi-10-2020-q4-major这个版本这是一个经过广泛验证的稳定版本cd ~ wget https://developer.arm.com/-/media/Files/downloads/gnu-rm/10-2020q4/gcc-arm-none-eabi-10-2020-q4-major-x86_64-linux.tar.bz2如果官方链接速度慢可以尝试搜索“清华镜像 arm gcc”等关键词寻找国内镜像源。解压并安装到系统目录tar -xjf gcc-arm-none-eabi-10-2020-q4-major-x86_64-linux.tar.bz2 sudo mv gcc-arm-none-eabi-10-2020-q4-major /opt/将工具链路径加入系统环境变量 修改当前用户的~/.bashrc文件vim ~/.bashrc在文件末尾添加以下行export PATH$PATH:/opt/gcc-arm-none-eabi-10-2020-q4-major/bin保存退出后使配置立即生效source ~/.bashrc验证工具链安装arm-none-eabi-gcc --version如果终端能正确输出GCC的版本信息如10.2.1说明工具链安装成功。踩坑记录工具链版本与库依赖在非常旧的系统如Ubuntu 14.04上安装过高版本的交叉工具链如GCC 10可能会因为宿主系统GLIBC库版本过低而无法运行报错如/lib/x86_64-linux-gnu/libc.so.6: version \GLIBC_2.25 not found。这就是为什么我们选择了2020年的版本10-2020-q4它对于GLIBC的要求与Ubuntu 14.04自带的版本2.19是兼容的。如果你必须使用更新版本的工具链可能需要考虑在容器内构建或者寻找静态链接版本的工具链。4. 编译第一个示例STM32 BSP理论准备就绪现在我们来实战编译一个具体的板级支持包BSP。我们以STM32系列中非常经典且资料丰富的STM32F407-ATK-Explorer开发板为例。这个BSP在RT-Thread源码中已经提供。4.1 进入BSP目录并配置工程定位BSPcd ~/workspace/rt-thread/rt-thread/bsp/stm32/stm32f407-atk-explorer每个BSP目录都是一个独立的工程。使用Env工具或直接scons配置 RT-Thread推荐使用其自带的Env配置工具它集成了menuconfig和包管理器。但在Ubuntu 14.04上我们可以直接使用scons命令配合--menuconfig参数。 首先确保你在BSP根目录然后生成默认的工程配置.config文件scons --menuconfig如果一切正常这会启动一个基于文本的图形配置界面。基础配置 在menuconfig界面中我们需要进行一些关键配置RT-Thread Kernel确保内核是启用的时钟节拍Tick保持默认10001ms。Hardware Drivers Config-Onboard Peripheral Drivers根据你的开发板使能对应的外设例如串口UART、LED、按键等。对于第一次测试使能一个串口如UART1和板载LED就足够了。RT-Thread Components-Device Drivers确保串口设备驱动框架是启用的。最重要的是工具链路径在menuconfig中进入Toolchain configuration检查CROSS_TOOL是否已经自动识别为gcc。如果没有手动选择gcc。同时确认EXEC_PATH是否正确指向了你安装的ARM GCC工具链的bin目录例如/opt/gcc-arm-none-eabi-10-2020-q4-major/bin。这一步是编译成功的关键。 配置完成后按右方向键选择Save然后OK最后Exit退出。4.2 使用scons编译工程配置保存后直接在BSP目录下执行scons命令开始编译scons如果一切顺利你将看到大量的编译输出信息最后以LINK rtthread.elf和生成rtthread.bin、rtthread.hex等文件结束并显示生成文件的大小。编译过程详解与排错scons做了什么它会读取当前目录下的SConstruct和SConscript文件根据.config配置文件递归地编译所有选中的内核源码、组件、驱动和软件包最后调用交叉工具链的链接器arm-none-eabi-ld将所有目标文件链接成最终的rtthread.elf可执行文件并利用objcopy工具生成可以直接烧录的二进制.bin或十六进制.hex文件。常见错误1arm-none-eabi-gcc: not found这明确说明环境变量PATH没有设置正确或者工具链路径有误。请返回第3.2节仔细检查~/.bashrc的修改和source命令是否执行。常见错误2fatal error: rtconfig.h: No such file or directory这通常是因为没有成功运行scons --menuconfig生成配置文件。.config文件是menuconfig的输出而rtconfig.h是由scons根据.config自动生成的头文件。确保先执行scons --menuconfig并保存。常见错误3编译过程中提示某个头文件找不到这可能是该BSP依赖的某个软件包package没有下载。RT-Thread使用pkgs --update命令来拉取和更新软件包。在BSP目录下执行# 首先需要进入RT-Thread的Env环境如果已安装Env工具 # 如果未安装Env可以尝试使用源码中的python脚本 python3 ../tools/pkgs.py --update或者更简单的方法是在menuconfig中暂时关掉你暂时用不到的软件包先确保内核和基础驱动能编译通过。4.3 烧录与运行验证编译成功后在BSP目录下会生成rtthread.bin文件。接下来就是将其烧录到STM32开发板。烧录工具在Ubuntu下常用的烧录工具是stlink针对ST-Link调试器或openocd。安装ST-Link工具sudo apt-get install -y stlink-tools或者安装OpenOCD功能更强大sudo apt-get install -y openocd连接开发板用USB线将ST-Link调试器连接到Ubuntu主机和STM32开发板。确保系统识别了设备lsusb命令应能看到ST-Link设备。烧录bin文件使用st-flash工具进行烧录假设ST-Link设备号为/dev/ttyUSB0具体需根据ls /dev/ttyUSB*查看sudo st-flash --reset write rtthread.bin 0x08000000这条命令的含义是向STM32 Flash的起始地址0x08000000写入rtthread.bin文件并在完成后复位芯片。查看串口输出烧录完成后将开发板的串口通常是UART1连接板载的USB转串口芯片通过USB线连接到电脑。在Ubuntu上使用串口终端工具如minicom或picocom查看输出。 安装并配置minicomsudo apt-get install minicom sudo minicom -s在配置界面中设置正确的串口设备如/dev/ttyUSB0或/dev/ttyACM0波特率通常为115200数据位8停止位1无校验。保存退出后重新上电或复位开发板。如果一切正常你将在终端上看到RT-Thread的启动Logo和命令提示符msh 。输入list_device命令可以查看当前注册的设备应该能看到你使能的串口设备。5. 进阶配置与深度开发环境搭建成功运行第一个示例只是起点。一个高效的RT-Thread开发环境还需要代码编辑、调试和软件包管理等功能。5.1 集成开发环境IDE的选择与配置在Ubuntu 14.04上虽然可以安装较新版本的VSCode但可能会面临依赖库版本问题。更稳定的选择是Eclipse GNU ARM插件安装Eclipse for C/C Developers。安装GNU ARM Eclipse插件用于管理ARM GCC工具链和提供调试支持。将RT-Thread的BSP目录导入为Makefile项目因为scons最终也是调用makefile风格的命令。这种方式配置相对复杂但集成度高。Vim / Emacs Ctags/Cscope对于命令行爱好者这是最轻量、最强大的选择。配合.clang-format和bear用于生成编译数据库工具可以实现很好的代码补全和跳转。sudo apt-get install ctags cscope bear cd ~/workspace/rt-thread/rt-thread/bsp/stm32/stm32f407-atk-explorer bear -- scons # 生成 compile_commands.json 文件然后在Vim中配置YCM或coc.nvim等插件读取compile_commands.json即可获得精准的代码补全。RT-Thread Studio的局限性官方的RT-Thread Studio IDE是基于Eclipse的但其安装包对较新的系统库依赖较强在Ubuntu 14.04上直接运行可能会失败。如果非要用可能需要解决大量的库依赖冲突不推荐在此旧系统上尝试。5.2 软件包中心Package Center的使用RT-Thread最大的优势之一是其丰富的软件包生态系统。在Ubuntu 14.04的命令行环境下我们可以通过menuconfig和pkgs工具来管理。在menuconfig中选择软件包再次运行scons --menuconfig进入RT-Thread online packages菜单。这里分类列出了物联网、系统、外设、工具等各类软件包如cJSON、WebClient、LwIP、FreeModbus等。选择你需要的包保存退出。下载与更新软件包退出menuconfig后在BSP目录下执行python3 ../../tools/pkgs.py --update这个命令会读取新的.config将选中的软件包从Git仓库克隆或更新到本地packages文件夹下。软件包的版本管理每个软件包在packages目录下都是一个独立的Git子模块。你可以进入特定软件包目录用git log查看提交历史甚至切换到特定的版本以确保兼容性。对于生产项目锁定软件包版本至关重要。5.3 调试配置使用OpenOCD与GDB打印日志只能解决部分问题真正的复杂问题需要源码级调试。安装并配置OpenOCD确保已安装openocd。你需要一个对应你开发板型号的OpenOCD配置文件.cfg文件。对于STM32F4 Discovery系列通常使用stlink-v2.cfg和stm32f4x.cfg。在BSP目录下创建一个debug.cfg文件内容类似source [find interface/stlink-v2.cfg] source [find target/stm32f4x.cfg] reset_config srst_only启动OpenOCD服务器在一个终端中进入BSP目录运行openocd -f debug.cfg如果成功OpenOCD会启动一个GDB服务器默认监听端口3333。使用ARM GDB进行调试在另一个终端中启动GDBcd ~/workspace/rt-thread/rt-thread/bsp/stm32/stm32f407-atk-explorer arm-none-eabi-gdb rtthread.elf在GDB命令行中连接OpenOCD服务器并加载程序(gdb) target remote localhost:3333 (gdb) monitor reset halt (gdb) load (gdb) continue现在你就可以设置断点、单步执行、查看变量和内存了。将这套命令写成.gdbinit文件放在BSP目录下可以实现自动化调试。6. 环境维护、常见问题与迁移思考在这样一个旧系统上维护开发环境肯定会遇到一些特有的挑战。6.1 依赖库版本冲突与解决最典型的问题是你需要为一个新BSP或软件包安装新的系统库例如某个软件包依赖libssl1.1但Ubuntu 14.04的官方源里只有libssl1.0.0。强行安装高版本可能会破坏系统其他组件的依赖。解决方案优先使用RT-Thread软件包很多功能如TLS/SSL已有RT-Thread的软件包实现如mbedtls它们不依赖宿主系统的库而是自带源码或移植好的库编译后直接链接到固件中。这是嵌入式开发的常规做法。从源码编译并本地安装如果宿主机工具确实需要某个新库比如更新版本的cmake可以下载其源码编译后安装到/usr/local或~/local目录并通过修改PATH和LD_LIBRARY_PATH环境变量来优先使用本地版本。使用容器技术这是最干净、最推荐的长期解决方案。在Ubuntu 14.04主机上安装Docker然后创建一个基于Ubuntu 18.04或20.04的容器在容器内构建RT-Thread环境。这样既能享受新系统的软件包又完全隔离了宿主环境。Dockerfile可以精确描述环境构成实现团队共享和持续集成。6.2 性能优化与编译加速RT-Thread工程特别是开启了大量软件包后编译时间可能较长。在性能相对较弱的旧系统或虚拟机上可以采取以下措施启用scons并行编译scons命令默认是单线程的。使用-jN参数指定并行任务数N通常设置为CPU核心数的1-2倍。scons -j4使用ccache缓存安装ccache工具它可以缓存编译结果在多次编译相同代码时极大提升速度。sudo apt-get install ccache在scons命令前加上ccacheccache scons -j4或者设置环境变量export CCccache arm-none-eabi-gcc。清理与重建策略scons -c用于清理编译产物。但有时配置更改后清理不彻底会导致奇怪错误。最彻底的方法是删除build文件夹如果存在和scons生成的临时文件然后重新编译。6.3 向新系统迁移的路径虽然本文聚焦于Ubuntu 14.04但为未来考虑了解迁移路径是必要的。当你需要将开发环境迁移到更新的系统如Ubuntu 22.04时关注以下几点工具链新系统可以使用更新、性能更好的ARM GCC工具链如11.3或12.3。注意测试编译出的固件在目标硬件上的运行情况特别是优化级别-O2等是否引入异常。构建系统确保新系统上的scons和python版本与RT-Thread兼容。RT-Thread对新版本Python的支持通常很好。依赖包新系统上安装libncurses等开发库的命令不变但版本会更新一般不会有兼容性问题。最稳妥的方式将整个RT-Thread源码目录、BSP目录以及项目代码打包。在新系统上按照本文类似的步骤重新配置和编译。只要工具链版本和核心配置一致编译出的二进制文件应该是相同的。在Ubuntu 14.04上搭建RT-Thread环境更像是一次“考古”与“工程”的结合。它要求你对工具链、库依赖和构建过程有更清晰的理解因为自动化工具能提供的帮助有限。但一旦成功搭建这个环境将是极其稳定和可靠的尤其适合那些需要长期维护、不容有环境变动的项目。整个过程的核心无非就是精确控制三个变量系统库、交叉工具链、源码版本。只要牢牢锁定这三者无论是在多旧或多新的系统上你都能复现出一个可用的编译环境。