龙芯智能车从零搭建：LoongArch工具链、Linux内核编译与逐飞库集成

1. 龙芯智能车到底难在哪先搞清楚这套平台的底层逻辑很多人第一次听到“龙芯智能车”这五个字第一反应是——智能车我熟龙芯是什么其实这正是这个项目最有意思的地方。全国大学生智能车竞赛跑了二十来届从最早的飞思卡尔到后来的各类国产MCU主控平台换了一茬又一茬但绝大多数队伍用的都是ARM Cortex-M系列或者英飞凌的TriCore。龙芯平台的出现把整个技术栈从指令集层面就换掉了——它用的是LoongArch架构不是ARM也不是x86。这意味着什么意味着你从网上抄来的绝大多数底层驱动代码一行都跑不了。GPIO寄存器地址不一样中断控制器不一样定时器不一样连编译工具链都是另一套。很多队伍拿到龙芯主控板的第一天就卡住了代码写完了编译不过编译过了烧进去不跑跑起来了定时器不准。这不是能力问题是平台差异带来的系统性门槛。我前后接触过几届用龙芯平台做智能车的队伍也自己动手从零搭过一套完整的开发环境。这篇文章想做的事情很明确把“从零开始搭建龙芯智能车”这件事拆开揉碎重点讲清楚逐飞开源库怎么用、Linux内核怎么编译、LoongArch工具链怎么配这三条主线。不管你是准备参加第二十一届还是第二十二届智能车竞赛不管你做的是摄像头组、电磁组还是室外赛这套底层搭建的逻辑是通用的。先给一个全局认知龙芯智能车的软件栈大致分三层。最底下是LoongArch工具链和内核负责把C代码变成龙芯能执行的机器码并提供操作系统级的基础服务中间是逐飞开源库封装了GPIO、PWM、ADC、UART、摄像头接口等外设操作让你不用直接怼寄存器最上面才是你自己的控制算法和图像处理逻辑。很多人一上来就写PID、调摄像头结果底层没搭稳调参调到怀疑人生。正确的顺序一定是自底向上先把工具链和内核跑通再把逐飞库编进去最后才是应用层。提示龙芯平台和ARM平台最大的思维差异在于你不能假设“寄存器操作是通用的”。任何涉及底层硬件的代码都必须以龙芯的数据手册和逐飞库的实际实现为准。2. LoongArch工具链的搭建别急着敲make先把编译器选对2.1 为什么工具链是第一个拦路虎在ARM平台上你装个gcc-arm-none-eabi就完事了apt一条命令搞定。但LoongArch不一样它的工具链生态还在快速完善中不同版本之间的兼容性差异很大。我见过有队伍用了一个较老的交叉编译器结果链接逐飞库的时候报了一堆重定位错误查了两天才发现是ABI不匹配。LoongArch的工具链主要有几个来源龙芯官方维护的GCC分支、社区构建的预编译包、以及一些开发板厂商随板提供的SDK。对于智能车这种裸机或轻量级RTOS场景你需要的是loongarch64-unknown-linux-gnu或者loongarch64-linux-gnu前缀的交叉编译器。注意这里有个坑如果你的目标系统是跑Linux的比如龙芯2K系列那用gnu工具链没问题但如果你要做裸机开发可能需要newlib版本的工具链。2.2 具体安装步骤和验证方法我以在Ubuntu 22.04上搭建为例说一套实测可用的流程。首先确认你的宿主机架构x86_64的机器上跑交叉编译是最常见的组合。# 安装基础依赖 sudo apt update sudo apt install -y build-essential git bison flex libgmp-dev libmpfr-dev libmpc-dev texinfo # 获取LoongArch交叉编译器以官方预编译包为例 # 假设你已经下载了loongarch64-linux-gnu-gcc的压缩包 tar -xzf loongarch64-linux-gnu-gcc-*.tar.gz -C /opt/ export PATH/opt/loongarch64-linux-gnu/bin:$PATH # 验证 loongarch64-linux-gnu-gcc --version如果输出了GCC版本信息说明工具链基本可用。但别急着高兴还要做一个更关键的验证——编译一个最小的C程序看看能不能生成LoongArch目标文件。echo int main(){return 0;} test.c loongarch64-linux-gnu-gcc test.c -o test file testfile命令的输出应该显示ELF 64-bit LSB executable, LoongArch。如果显示的是x86或者ARM说明你的PATH里混进了别的工具链这是新手最常犯的错误之一。2.3 工具链版本选择的经验之谈这里分享一个我踩过的坑。逐飞开源库对GCC版本是有要求的太老的版本不支持某些LoongArch指令扩展太新的版本又可能改了默认的ABI行为。我的建议是优先使用逐飞官方文档推荐的工具链版本不要自己随便升级。如果文档没写那就用龙芯官方SDK里自带的那个版本兼容性最有保障。另外如果你在编译内核时遇到unknown relocation type之类的错误十有八九是工具链版本和内核源码不匹配。这时候不要硬扛换一个版本试试往往比改代码快得多。3. Linux内核编译龙芯智能车的“操作系统地基”怎么打3.1 智能车为什么要编内核有人可能会问智能车不就是跑个控制循环吗用得着Linux内核吗这个问题问得好。如果你做的是最传统的电磁组用裸机或者RTOS确实够了。但现在智能车竞赛越来越卷摄像头组要跑图像处理室外赛要接激光雷达有些队伍还想在上面跑神经网络做目标检测。这些场景下一个裁剪过的Linux内核能帮你省掉大量底层驱动的工作。龙芯2K系列芯片本身就是为了跑Linux设计的它的外设驱动在主线内核里支持得比较完善。逐飞开源库的很多功能实际上也是基于Linux的设备节点来操作的。所以“编内核”这件事本质上是为你的智能车准备一个稳定、可裁剪、驱动齐全的运行时环境。3.2 内核源码获取与配置龙芯的内核源码有几个来源龙芯官方的Linux仓库、主线内核的LoongArch分支、以及开发板厂商的BSP。对于智能车场景我建议用龙芯官方维护的版本因为它的驱动支持最全。# 克隆内核源码以龙芯官方仓库为例 git clone --depth1 https://github.com/loongson/linux.git -b loongson-5.10 cd linux # 配置交叉编译环境 export ARCHloongarch export CROSS_COMPILEloongarch64-linux-gnu- # 生成默认配置 make defconfigdefconfig生成的是一个通用配置里面包含了很多智能车用不到的东西比如蓝牙、WiFi、声卡驱动。你需要根据自己的硬件做裁剪。裁剪的原则很简单只保留你用到的外设关掉所有不确定的选项。内核越小启动越快出问题的概率越低。3.3 关键配置项和裁剪策略下面这张表是我在智能车项目里常用的裁剪对照供参考配置类别建议状态原因网络协议栈精简保留室外赛可能需要室内赛可关USB子系统按需接USB摄像头就开否则关声卡/显示关闭智能车不需要文件系统保留ext4tmpfstmpfs用于临时数据调试符号关闭减小内核体积内核日志保留但降级方便排查问题裁剪完之后用make menuconfig逐项检查特别是Device Drivers下面的内容。我见过有队伍忘了开PWM驱动结果电机死活不转查了半天以为是硬件问题。3.4 编译过程与常见报错处理# 开始编译-j后面跟你的CPU核心数 make -j$(nproc) # 编译设备树如果用到 make dtbs编译过程中最常见的报错有三类一是工具链路径不对报command not found二是缺少依赖库报fatal error: xxx.h: No such file三是内核配置冲突报undefined reference。第一类问题检查PATH第二类问题装依赖第三类问题回menuconfig里找冲突项。注意内核编译时间比较长第一次编建议用make -j1单线程跑虽然慢但报错信息更清晰。等配置稳定了再用多线程加速。编译完成后你会得到arch/loongarch/boot/vmlinuz和对应的设备树文件。这两个东西就是你智能车的“操作系统内核”后面逐飞库的很多功能都要依赖它提供的系统调用。4. 逐飞开源库的集成让外设操作不再从零造轮子4.1 逐飞库到底封装了什么逐飞开源库的核心价值是把龙芯平台上那些繁琐的寄存器操作封装成类似gpio_set_value()、pwm_set_duty()这样的函数。没有它你写一个点灯程序可能要翻几十页数据手册有了它三行代码搞定。但要注意逐飞库不是万能的。它主要覆盖的是智能车竞赛常用的外设GPIO、PWM、ADC、UART、定时器、摄像头接口DVP/MIPI、编码器接口。如果你要用一些冷门外设可能还是得自己写驱动。4.2 库的获取与目录结构逐飞库通常以源码形式提供你需要把它放到你的工程目录里和你的应用代码一起编译。典型的目录结构是这样的project/ ├── seekfree_libraries/ # 逐飞库源码 │ ├── inc/ # 头文件 │ ├── src/ # 源文件 │ └── drivers/ # 底层驱动 ├── user/ # 你的应用代码 ├── Makefile └── build/ # 编译输出集成的时候最关键的是Makefile的编写。你需要把逐飞库的源文件路径加到编译规则里同时确保头文件路径正确。4.3 Makefile编写要点与编译验证# 交叉编译器 CC loongarch64-linux-gnu-gcc # 头文件路径 INCLUDES -I./seekfree_libraries/inc -I./user # 源文件 SRCS $(wildcard ./seekfree_libraries/src/*.c) \ $(wildcard ./user/*.c) # 编译目标 TARGET smartcar OBJS $(SRCS:.c.o) $(TARGET): $(OBJS) $(CC) -o $ $^ -lpthread -lm %.o: %.c $(CC) $(INCLUDES) -c $ -o $ clean: rm -f $(OBJS) $(TARGET)这个Makefile是最简版本实际项目中你可能还需要加-O2优化、-g调试信息、以及链接特定的库。写完之后先make clean make跑一遍看看有没有编译错误。4.4 逐飞库使用中的典型坑第一个坑是初始化顺序。逐飞库的各个模块之间有依赖关系比如PWM模块依赖时钟模块先初始化。如果你顺序搞反了可能出现PWM输出频率不对的问题。我的建议是严格按照官方例程里的初始化顺序来不要自己发挥。第二个坑是中断优先级。智能车对实时性要求高摄像头采集、编码器计数、电机控制这几个中断的优先级必须合理安排。逐飞库提供了中断注册接口但优先级配置需要你自己根据实际需求来定。一般来说编码器中断优先级最高摄像头次之串口最低。第三个坑是内存管理。如果你在Linux上跑逐飞库要注意用户态和内核态的内存访问差异。逐飞库的某些接口可能假设你在裸机环境下运行直接操作物理地址。在Linux下你需要用mmap把物理地址映射到用户空间或者写一个内核模块。这一点在官方文档里往往写得比较简略需要你自己补课。5. 从编译通过到车跑起来联调阶段的排查链路5.1 上电前的静态检查代码编译通过只是第一步离车能跑还有很长的路。上电之前我习惯做一遍静态检查电源电压对不对、电机驱动接线有没有反、摄像头排线有没有插紧、下载器连接是否正常。这些看起来是废话但我见过太多队伍因为一根线插反烧了主控。5.2 最小系统验证先让LED闪起来不要一上来就跑完整的控制程序。先写一个最简单的LED闪烁程序验证工具链、内核、逐飞库这三层是通的。如果LED能按预期闪烁说明GPIO操作没问题时钟配置没问题程序下载和运行也没问题。#include seekfree.h int main() { gpio_init(LED_PIN, GPIO_OUTPUT); while(1) { gpio_set(LED_PIN, 1); delay_ms(500); gpio_set(LED_PIN, 0); delay_ms(500); } return 0; }5.3 外设逐个点亮PWM、ADC、UARTLED验证通过后按顺序验证PWM接电机或示波器看波形、ADC接电位器看读数、UART接串口助手看输出。每验证一个外设就把它从“未知”变成“已知可用”。这样当后面出问题时你可以快速排除已经验证过的部分。5.4 常见故障与排查表现象可能原因排查方法程序下载失败下载器驱动/接线检查设备管理器/换线LED不亮GPIO配置/时钟用示波器测引脚电机不转PWM配置/驱动供电测PWM波形/测电机电压串口无输出波特率/引脚复用核对数据手册摄像头无图像接口配置/时钟查逐飞库例程这张表是我自己总结的实际排查时按顺序过一遍能解决80%的问题。6. 几个容易被忽略但很关键的细节6.1 内核启动参数对智能车的影响Linux内核启动时可以通过命令行参数控制很多行为比如console指定控制台、root指定根文件系统、mem限制内存使用。对于智能车我建议把不必要的控制台输出关掉减少启动时间和运行时开销。另外如果你用的是tmpfs作为根文件系统记得在启动参数里加上rootfstypetmpfs。6.2 实时性优化让控制循环更稳Linux不是实时操作系统默认的调度策略可能导致控制循环抖动。如果你的智能车对实时性要求高可以考虑几个优化手段把控制线程的调度策略设为SCHED_FIFO、用mlockall()锁定内存防止换页、关掉内核的CONFIG_PREEMPT_NONE改成CONFIG_PREEMPT。这些操作在逐飞库的文档里不一定有但对实际跑车效果影响很大。6.3 版本管理别把时间浪费在“上次能跑”上智能车开发周期长代码改动频繁。我强烈建议从第一天就用Git管理代码每次编译通过、每次跑通一个功能都提交一次。这样当某天代码突然跑不起来时你可以快速回滚到上一个可用版本。我见过太多队伍因为改了一个参数导致全车瘫痪又没有版本记录只能从头再来。7. 关于龙芯智能车平台的一些个人体会从ARM换到龙芯最大的感受是“生态还在长”。工具链的文档不够全逐飞库的某些接口还在迭代内核配置项和主线也有差异。但反过来看这恰恰是它的价值所在——你在这个平台上踩过的每一个坑、解决的每一个问题都是别人没有的经验。我自己的习惯是每解决一个龙芯平台特有的问题就在代码注释里写清楚“为什么这样做”和“不这样做会怎样”。比如为什么某个寄存器要先写1再写0为什么某个延时不能省。这些注释在几个月后你自己回头看时价值比任何文档都大。另外不要孤立地看逐飞库和内核编译这两件事。它们本质上是同一个问题的两个面逐飞库帮你操作硬件内核帮你管理资源。当你把这两层都摸透了再往上写控制算法和图像处理心里就有底了。智能车竞赛比的不只是算法更是对整个系统栈的理解深度。龙芯平台把这个深度又往下挖了一层对愿意钻进去的人来说是好事。