1. 把 QB63XX 的 Quasar 源码编出第一版:代码开发工具链的落地顺序
拿到一块 EVM63XX 开发板和一份 Quasar 24.1 标准包,多数人的第一个动作是进目录敲编译脚本,然后被一句“找不到交叉编译链”顶回来。这套代码开发工具链的落地顺序其实是死的:工具链解压到哪、环境变量 export 成什么、宿主依赖装没装全,顺序错一步,后面的报错就全是玄学。下面按我实际跑通的次序写:两套 arm-gnu-toolchain 各管什么、九个 quasar 包怎么解、三个 QUASAR_ARM_TOOL_CHAIN_* 变量怎么指、build_63XX_quasar 的参数怎么给,以及单核 14P 和双核 19U 两块板在同一份默认配置下要先确认什么。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 代码开发工具链准备:两套 arm-gnu-toolchain 与一串宿主依赖
2.1 两套工具链的分工:none-eabi 管裸机,gnueabihf 管 Linux
随包资料里写得很明确,63XX 系列要装两套交叉编译链。第一套是 arm-gnu-toolchain-12.2.rel1-x86_64-arm-none-eabi,标注用途是 BOOT 和 RTOS 构建;第二套是 arm-gnu-toolchain-12.2.rel1-x86_64-arm-none-linux-gnueabihf,标注用途是 Linux 硬浮点构建。两个包的版本号完全一样,只有最后那段目标三元组不同,下载页面上同一个 12.2.rel1 版本对多种宿主架构都提供包,x86_64 这个后缀要先看清楚,点错成别的架构就得整包重下。
下载来源按资料给出的 Arm GNU Toolchain 官方下载页走,文件名必须和上面两个完全对得上:arm-gnu-toolchain-12.2.rel1-x86_64-arm-none-eabi.tar.xz 和 arm-gnu-toolchain-12.2.rel1-x86_64-arm-none-linux-gnueabihf.tar.xz。名字对不上就别往下走,后面 export 拼路径时是按包名原样拼的,差一个字符就是找不到目录。
两套的分工不是可选项。none-eabi 面向裸机,工具链里没有 Linux 的系统调用层和 glibc,用它产出的是能直接烧进板子的 boot 与 RTOS 侧镜像;none-linux-gnueabihf 走 Linux 的硬浮点 ABI,内核和用户态程序都靠它编。两者的差别不只是“能不能编过”,编译产物里的浮点调用约定和运行库依赖都不一样。
| 工具链包 | 资料标注用途 | 实际编哪一部分 |
|---|---|---|
| arm-gnu-toolchain-12.2.rel1-x86_64-arm-none-eabi | for BOOT and RTOS build | boot 与 RTOS 侧的裸机镜像 |
| arm-gnu-toolchain-12.2.rel1-x86_64-arm-none-linux-gnueabihf | for Linux hard floating build | Linux 内核与硬浮点用户态 |
混用的后果很直接:拿 eabi 那套去编 Linux 侧代码,链接阶段就会因为找不到 libc 侧的启动符号停住;反过来拿 gnueabihf 编裸机 boot,产物会带进本不该有的运行库依赖。这也是为什么后面的环境变量要分成 NL、LINUX_HF、M3 三个,而不是图省事只设一个。
2.2 解压到固定目录:路径要能被 pwd 拼出来
工具链不能随便找个地方一放了事。后面 export 用的是 `pwd`/toolchains/... 这种拼法,也就是说工具链必须落在编译根目录下的 toolchains 子目录里,位置一换,export 就得跟着改。资料里给的存放位置是 ~/bigger_disk/QBit/toolchains,目录名带 bigger_disk 看着就是特意挑的大盘——两套工具链解压后各占一块空间,放系统盘迟早要清。
bash复制mkdir -p ~/bigger_disk/QBit/toolchains
cd ~/bigger_disk/QBit/toolchains
tar xvf arm-gnu-toolchain-12.2.rel1-x86_64-arm-none-eabi.tar.xz
tar xvf arm-gnu-toolchain-12.2.rel1-x86_64-arm-none-linux-gnueabihf.tar.xz
# 当前已经在本目录内,直接按通配删即可;
# 写成 toolchains/*.tar.xz 会多一层路径,匹配不到任何文件
rm -f *.tar.xz
tar xvf 三个字母:x 是解压,v 是把解压出来的文件列表打出来,方便核对顶层目录名,f 表示后面跟的是文件名而不是从标准输入读。解压出来的顶层目录就是包名去掉 .tar.xz 后缀,记牢这个名字,第 4 章 export 时一个字符都不能改。
清理压缩包这一步,资料里的写法是在 toolchains 目录内执行 rm -rf toolchains/*.tar.xz,此时路径多了一层,实际删不到东西。要么回到上一级执行 rm -rf toolchains/*.tar.xz,要么就在当前目录写 rm -f *.tar.xz。我倾向后者,-f 跟文件、-r 才需要递归,手别抖。
2.3 宿主依赖:apt 那串包不是凑数
bash复制sudo apt-get install g++ mtd-utils squashfs-tools fakeroot libc6-i386 \
g++-multilib lib32z1 libssl-dev cmake flex bison javacc texlive-full \
libxml2-utils
这一长串是整个构建流程的前置条件,缺任意一个,构建就会在对应阶段断掉,而且报错位置往往离真正缺的包很远。按能力分组看会清楚很多:
| 分组 | 包 | 大致用途 |
|---|---|---|
| 宿主编译 | g++、cmake | 编译宿主机侧的构建工具与代码生成器 |
| 32 位兼容 | libc6-i386、g++-multilib、lib32z1 | 给构建流程里的 32 位预编译工具兜底 |
| 镜像打包 | mtd-utils、squashfs-tools、fakeroot | 生成只读根文件系统与烧录镜像 |
| 语法与代码生成 | flex、bison、javacc、libxml2-utils | 词法语法分析与 XML 相关生成步骤 |
| 加密 | libssl-dev | 签名、摘要相关的构建环节 |
| 文档 | texlive-full | 生成文档,这一组体积最大 |
32 位兼容那三个包尤其容易被跳过,觉得自己机器是 64 位就不需要。构建流程里只要有一个宿主工具是 32 位编译出来的,少了 libc6-i386、lib32z1,表现就是某个可执行文件跑不起来,终端里一句 Exec format error 或者直接提示无法执行二进制文件,看着跟交叉编译毫无关系,很容易往错的方向查。
提示:
texlive-full装完占的空间不小,动手之前先df -h看一眼根分区余量,别装到一半磁盘满。
这套命令是 Debian/Ubuntu 系的写法,换到别的发行版要按同等能力找包,包名不一样但要求是一样的。安装完成后不需要重启,但建议新开一个终端再继续,避免旧会话里残留的 PATH 影响判断。
3. 源码包解压:九个 quasar 包与 release/63XX 入口
3.1 九个包分别管什么
从原厂拿到的源码包是 Quasar 24.1 Standard Packages.zip,解开之后是九个 tgz,名字全部以 quasar_ 开头,版本后缀统一是 74967。这个后缀一致很重要——说明九个包是同一批次出的,拿两个不同批次的包混着解,很容易出现对不上的情况。九个包按名字看大致是这么分工的:
| 包名 | 大致职责 |
|---|---|
| quasar_appref_74967.tgz | 应用参考代码 |
| quasar_appsample_74967.tgz | 应用示例 |
| quasar_dspcompiler_74967.tgz | DSP 相关的编译工具 |
| quasar_libfat_74967.tgz | FAT 文件系统库 |
| quasar_linuxkernel_74967.tgz | Linux 内核源码 |
| quasar_linuxqbit_74967.tgz | 面向该主控的 Linux 侧适配 |
| quasar_rtos_74967.tgz | RTOS 侧源码 |
| quasar_SDIO_74967.tgz | SDIO 相关 |
| quasar_uboot_74967.tgz | U-Boot |
少了任何一个都会在对应阶段卡住:缺 uboot 就没有 bootloader 那一层,缺 linuxkernel 就没有内核,构建脚本跑到那一阶段会直接停下来。所以在解压阶段宁可一次全解,也别挑着解——挑着解省下的那点空间,后面排查时要用几倍时间还回去。
3.2 解压命令与目录骨架
九个包存放在 ~/bigger_disk/QBit/source_packages 下,解压到 ~/bigger_disk/QBit 这一层,也就是和 toolchains 平级。
bash复制cd ~/bigger_disk/QBit
tar xvf source_packages/quasar_appref_74967.tgz
tar xvf source_packages/quasar_appsample_74967.tgz
tar xvf source_packages/quasar_dspcompiler_74967.tgz
tar xvf source_packages/quasar_libfat_74967.tgz
tar xvf source_packages/quasar_linuxkernel_74967.tgz
tar xvf
