1. 代码开发工具链落地:把一套 SoC 源码从压缩包编到可烧录产物
代码开发工具链的部署,最怕的不是命令多,而是工具链和源码包没对齐。拿到一套 SoC SDK 压缩包时,很多人第一反应是进目录执行构建脚本,结果半小时后卡在“找不到编译器”或者“链接阶段 ABI 不一致”。这类问题通常不是代码写错,而是交叉编译工具链、源码模块包、板级配置三者没有按同一套目录约定放好。
这一篇围绕某 63 系列 SoC 的默认配置全编译来讲:从两套交叉编译链的准备,到源码包解压,再到依赖安装、环境变量设置和构建脚本调用。适合需要从源码构建固件、又不想每次换机器都重新踩一遍坑的嵌入式开发人员。下面所有目录名、脚本名都用代称,实际落地时按手里源码包的清单替换。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 代码开发工具准备:两套交叉编译链的用途与目录规划
2.1 为什么不是一套工具链走天下
这套源码编译环境里,交叉编译链不是一个,而是两套。第一套是裸机/RTOS 方向,包名里通常带 eabi,用来编 boot、RTOS 以及一些不跑完整用户态的程序。第二套是带硬浮点的用户态方向,包名里通常带 hf,用来编需要 C 库、动态链接和硬浮点调用约定的用户态程序。
这两套不能随便互换。裸机/RTOS 工具链面向没有完整操作系统环境的代码,用户态硬浮点工具链面向有 C 库和 ABI 约定的程序。你把该用 hf 的模块丢给 eabi 编,常见结果是编译阶段看着能过,链接阶段报浮点调用约定或 ABI 不匹配;反过来把 boot 代码丢给用户态工具链,也可能因为启动代码、库依赖对不上而失败。这类问题不像语法错误那样直白,日志里往往只给你一句链接失败,第一次遇到很容易怀疑源码本身。
材料里还有一个第三个工具链变量,指向的是和裸机/RTOS 同一套 eabi 目录。我的处理方式是:boot/RTOS 和这个第三变量共用 eabi 路径,用户态硬浮点单独用 hf 路径。目录名统一成 toolchains/eabi-12.2 和 toolchains/hf-12.2,后面所有环境变量都只认这两个绝对路径,避免脚本里出现半截相对路径。
提示:工具链版本以源码包发布说明为准。材料里出现的是 12.2 这一版,换版本前先确认构建脚本没有写死目录名。
2.2 解压工具链并建立可复用目录
假设两个工具链压缩包已经放在 ~/bigger_disk/soc_sdk/toolchains 下。不要直接在下载目录里解压再挪,后面环境变量全用绝对路径,目录一挪就容易出现“明明解压了却找不到”的假象。先把当前目录固定到工具链目录:
bash复制cd ~/bigger_disk/soc_sdk/toolchains
# 下面两个变量换成你手里实际的压缩包名
EABI_PKG="eabi-toolchain-12.2.tar.xz"
HF_PKG="hf-toolchain-12.2.tar.xz"
tar xvf "$EABI_PKG"
tar xvf "$HF_PKG"
# 解压后目录名不一致时,统一重命名,后续脚本只认这两个路径
mv eabi-toolchain-12.2 eabi-12.2
mv hf-toolchain-12.2 hf-12.2
# 只删当前目录下确认无用的压缩包,不要用宽泛通配符跨目录删
rm -f "$EABI_PKG" "$HF_PKG"
tar xvf 会逐条打印解压出来的文件,第一次执行时不要嫌日志长,扫一眼顶层目录名是否和预期一致。mv 这一步是为了把工具链目录名固定下来,因为构建脚本里的环境变量通常是一整条路径,目录名差一个字符就会找不到编译器。最后的 rm -f 只删两个变量指向的压缩包,比 rm -rf toolchains/*.tar.xz 稳,后者一旦当前目录不是 toolchains,通配符展开范围可能超出预期。
解压完成后,目录里应该能看到两套工具链各自的 bin 子目录。不要急着编源码,先做一次自检。
2.3 工具链自检与版本一致性
自检不是形式主义。构建脚本报“找不到编译器”时,先确认工具链本身的 gcc 能不能执行,比直接翻脚本快得多。用下面两条命令分别检查裸机/RTOS 和用户态硬浮点工具链:
bash复制"$HOME/bigger_disk/soc_sdk/toolchains/eabi-12.2/bin/"*-gcc --version
"$HOME/bigger_disk/soc_sdk/toolchains/hf-12.2/bin/"*-gcc --version
这里用 *-gcc 是因为交叉工具链前缀可能带目标三元组,直接写死前缀反而容易错。命令输出里重点看两件事:一是可执行文件路径确实落在你刚解压的 toolchains/eabi-12.2 或 toolchains/hf-12.2 下;二是两套工具链的版本号一致,不要一个 12.2 一个更早版本。版本不一致时,最隐蔽的表现是单个模块能编过,整包链接时符号版本对不上。
如果这一步就报“没有那个文件或目录”,优先检查压缩包是否完整、解压时是否中断,而不是先去改构建脚本。工具链目录权限一般不需要额外处理,但如果你是在共享构建机上解压到别人建的目录,确认当前用户对 bin 下文件有执行权限。
3. 源码包解压:从总包到模块包,目录别搞反
3.1 先看清单再解压,避免模块包覆盖
拿到的源码总包解压后不是一份完整源码树,而是一组按模块切分的 .tgz。材料里出现的模块包括应用参考、应用样例、DSP 编译器、文件系统库、内核、SoC 支持、RTOS、SDIO 和 bootloader。实际包名可能带版本号,下面用代称表示,你替换成清单里的真实文件名即可。
| 模块包代称 | 我处理时的顺序 | 注意点 |
|---|---|---|
sdk_appref_74967.tgz |
先解压 | 应用参考,通常被其他模块引用 |
sdk_appsample_74967.tgz |
先解压 | 样例目录,确认是否覆盖同名目录 |
sdk_dspcompiler_74967.tgz |
次之 | 工具类模块,解压后看是否有可执行文件 |
sdk_libfat_74967.tgz |
次之 | 文件系统库,注意和内核模块的依赖顺序 |
sdk_kernel_74967.tgz |
中间 | 内核源码,解压耗时较长 |
sdk_soc_74967.tgz |
中间 | SoC 支持包,和板级配置关联最大 |
sdk_rtos_74967.tgz |
中间 | RTOS 源码,和裸机工具链配套 |
sdk_sdio_74967.tgz |
后置 | SDIO 相关模块,按需解压 |
sdk_bootloader_74967.tgz |
后置 | 启动引导模块,和 boot 工具链配套 |
这张表不是让你背文件名,而是提醒一件事:这些包解压到同一层目录时,可能有同名文件或同名子目录。先解压应用参考和样例,再解压内核、SoC、RTOS,最后解压 bootloader 和 SDIO,出现覆盖时至少能从解压日志里看出是哪个包覆盖了哪个路径。不要用 tar xvf *.tgz 一把梭,通配符展开顺序受 shell 影响,出问题时日志顺序也对不上。
3.2 批量解压与清理压缩包
假设总包已经解压到 ~/bigger_disk/soc_sdk/source_packages,下面这些模块包都放在该目录。执行解压时人在 soc_sdk 根目录:
bash复制cd ~/bigger_disk/soc_sdk
tar xvf source_packages/sdk_appref_74967.tgz
tar xvf source_packages/sdk_appsample_74967.tgz
tar xvf source_packages/sdk_dspcompiler_74967.tgz
tar xvf source_packages/sdk_libfat_74967.tgz
tar xvf source_packages/sdk_kernel_74967.tgz
tar xvf source_packages/sdk_soc_74967.tgz
tar xvf source_packages/sdk_rtos_74967.tgz
tar xvf source_packages/sdk_sdio_74967.tgz
tar xvf source_packages/sdk_bootloader_74967.tgz
# 确认上面全部解压成功后再删压缩包目录
ls source_packages
rm -rf source_packages
tar xvf 的 v 不是可有可无的装饰。第一次解压时靠它确认每个包解压出的顶层目录,后面编译报“找不到某模块”时也能回看日志。rm -rf source_packages 删的是压缩包存放目录,不是解压出来的源码目录,执行前一定先 ls 确认当前目录和 source_packages 里都只有压缩包。血泪经验是:有人在 soc_sdk 根目录执行了带通配符的清理命令,把刚解压的源码目录一起带走,后面编译脚本报缺文件,查了半天以为是源码包损坏。
3.3 目录布局与后续脚本相对路径
解压完成后,soc_sdk 根目录下大致是 toolchains、source_packages(如果还没删)、各模块源码目录,以及后面要用的 release/soc63 构建入口。构建脚本默认按相对路径找工具链和源码,所以 pwd 的位置很关键。材料里环境变量用 pwd 拼工具链路径,这意味着你必须在 soc_sdk 根目录执行 export,不能在 release/soc63 里执行。
我一般先跑一遍目录检查:
bash复制cd ~/bigger_disk/soc_sdk
pwd
ls -d toolchains/eabi-12.2 toolchains/hf-12.2
ls -d release/soc63
三条命令分别确认根目录、两套工具链目录、构建入口目录。只要其中一个不存在,先别往下走。目录布局稳定之后,后面换机器时可以把整个 soc_sdk 目录打包搬走,工具链和源码包都在里面,比在系统目录里东拼西凑可靠。
4. 用代码开发工具跑通全编译:依赖、环境变量与构建参数
4.1 依赖包一次装全,别等打包阶段才报错
全编译不只是调编译器,后面还会用到打包、文件系统镜像、文档生成和校验工具。材料给出的依赖清单比较长,我的建议是首次构建一次装全,不要等到某个阶段报“command not found”再回来补:
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、flex、bison 是编译和语法分析基础;mtd-utils、squashfs-tools、fakeroot 偏镜像打包和权限模拟;libc6-i386、g++-multilib、lib32z1 是 32 位兼容和交叉链接常用依赖;libssl-dev、javacc、texlive-full、libxml2-utils 在文档、校验或代码生成阶段可能被调用。texlive-full 体积大,但首次装全比编到一半再补要省时间。
如果构建机不能联网,先把清单在可联网环境里准备好离线包,再搬到构建机。不要只装 g++ 就开跑,全编译脚本经常在最后打包阶段才暴露缺工具,前面几十分钟编译都白等。
4.2 环境变量必须指向解压后的绝对路径
材料里明确提到:如果不用 export 配置环境变量,交叉编译链会从 /tools/arm/gcc/ 目录下去找。这个回退路径在多数构建机上并不存在,于是脚本报找不到编译器。正确做法是在 soc_sdk 根目录下把三个变量指向刚解压的绝对路径:
bash复制cd ~/bigger_disk/soc_sdk
export SOC_TOOLCHAIN_BOOT_RTOS="$(pwd)/toolchains/eabi-12.2"
export SOC_TOOLCHAIN_USER_HF="$(pwd)/toolchains/hf-12.2"
export SOC_TOOLCHAIN_MCU="$(pwd)/toolchains/eabi-12.2"
三个变量的分工要记清:BOOT_RTOS 给 boot 和 RTOS 用,USER_HF 给用户态硬浮点模块用,MCU 这个第三变量和裸机/RTOS 共用同一套 eabi 目录。$(pwd) 依赖你当前在 soc_sdk 根目录,所以 cd 那一步不能省。变量值必须是绝对路径,别写成 ./toolchains/eabi-12.2,因为构建脚本可能切换工作目录,相对路径会失效。
设置完用 env | grep SOC_TOOLCHAIN 检查一遍,确认三个变量都展开成了实际存在的目录。后面每次开新终端都要重新 export,除非你把它们写进构建脚本或 shell 启动文件。
4.3 编译入口与产物检查
环境变量就位后,进构建入口执行全编译:
bash复制cd release/soc63
./build_soc63
# 需要并行编译时按脚本支持传参,材料示例是 -r -j4
./build_soc63 -j4
./build_soc63 是默认全编译入口。材料里说脚本默认编译配置是某评估板的 FCSPI 组合,换目标板时可以直接改脚本默认配置,也可以按脚本支持的调用参数传进去。-j4 是并行度,按构建机 CPU 核数和内存调,不是越大越好;-r 不要凭感觉加,材料只给出这种调用形式,具体含义先看脚本内的 usage 或注释,别把别的项目的参数习惯套过来。
产物检查看三处:脚本退出码是否为 0;编译日志最后一段有没有报错;release/soc63 目录下产物的时间戳是否是本次构建。材料说编译完成后会在该目录下生成文件,具体文件名以脚本输出为准,不要背文件名。第一次构建建议保留完整日志:
bash复制cd ~/bigger_disk/soc_sdk/release/soc63
./build_soc63 2>&1 | tee build_$(date +%Y%m%d_%H%M%S).log
tee 既在终端看进度,又落一份日志。后面排查“到底哪一步缺依赖”时,直接搜 not found、No such file、cannot find,比翻终端滚屏靠谱。
5. 编译环境避坑排查:五个让构建中断的细节
5.1 报找不到编译器:环境变量没进当前 shell
现象:构建日志前几行提示编译器路径不存在,或者脚本回退到 /tools/arm/gcc/ 后直接失败。
原因:没有执行 export,或者 export 是在另一个终端、另一个目录下执行的。材料明确写了,不用环境变量时脚本会去 /tools/arm/gcc/ 找工具链,这个路径通常不是你的解压目录。
解决:回到 soc_sdk 根目录重新 export 三个变量,先 env | grep SOC_TOOLCHAIN 确认值,再分别执行两套工具链的 *-gcc --version。如果变量值里出现相对路径或空目录,说明 pwd 不在预期位置,重新 cd 后覆盖导出。
5.2 链接阶段 ABI 不匹配:两套工具链用反
现象:单个模块编译能过,整包链接时报浮点调用约定、ABI 或库依赖不一致;或者 boot 镜像编完,用户态程序跑不起来。
原因:把该用 USER_HF 的用户态模块指到了 BOOT_RTOS 的 eabi 目录,或者反过来把 boot/RTOS 指到了 hf 目录。两套工具链的用途在材料里分得很清楚,混用不会在编译第一步暴露,常在链接阶段翻车。
解决:按变量用途重新核对,BOOT_RTOS 和 MCU 指向 eabi-12.2,USER_HF 指向 hf-12.2。不要为了省事把三个变量都指到同一套工具链,除非源码包说明明确允许。
5.3 打包或文档阶段缺命令:依赖只装了一半
现象:编译阶段跑得很顺,到镜像打包、文档生成或校验阶段报某个命令找不到。
原因:只装了 g++ 和 cmake,漏了 mtd-utils、squashfs-tools、fakeroot、javacc、texlive-full 这类后置工具。
解决:按材料给的依赖清单一次装全,尤其注意 32 位兼容包 libc6-i386、g++-multilib、lib32z1。已经编到一半才缺包时,装完不用从头清理,但要把失败阶段对应的日志留下来,确认不是缺包之外还有路径问题。
5.4 源码树被清空:清理命令跑错目录
现象:第二次编译突然报缺源文件,source_packages 没了,连某个 sdk_* 源码目录也不见了。
原因:执行 rm -rf 时当前目录不对,或者用了宽泛通配符把解压目录一起匹配进去。材料里的 rm -rf source_packages 本身只删压缩包目录,但前提是你在 soc_sdk 根目录,且源码目录不在 source_packages 里面。
解决:清理前先 pwd 和 ls,确认要删的只是压缩包目录。压缩包解压出来的源码目录单独保留,不要为了省磁盘把源码和压缩包一起清。删工具链压缩包也一样,进到 toolchains 目录后用 rm -f 指定两个文件,别在根目录用 rm -rf toolchains/*.tar.xz 这类跨层通配符。
5.5 能编过但板子不对:默认板级配置没改
现象:构建脚本退出码为 0,产物也生成了,但烧到目标板后外设没响应或启动异常。
原因:脚本默认编译配置是某评估板的 FCSPI 组合,目标板不是同一套板级配置时,编出来的镜像自然对不上。材料说可以在脚本里直接改,也可以加调用参数。
解决:先看脚本里的默认配置和 usage,确认当前目标板该用哪套 FCSPI 组合。改脚本前备份原始文件,改完用 diff 看只动了板级配置,别把工具链路径或其他默认项一起改掉。换板调试时先编最小配置验证,再逐步加回外设模块。
6. 把构建环境固化成脚本:一次自检、一次干净编译
环境变量每次开新终端重敲,迟早会漏。我的习惯是在 soc_sdk 根目录放一个 env.sh,只负责导出和自检,不掺构建逻辑:
bash复制#!/usr/bin/env bash
set -euo pipefail
ROOT="$(cd "$(dirname "$0")" && pwd)"
export SOC_TOOLCHAIN_BOOT_RTOS="$ROOT/toolchains/eabi-12.2"
export SOC_TOOLCHAIN_USER_HF="$ROOT/toolchains/hf-12.2"
export SOC_TOOLCHAIN_MCU="$ROOT/toolchains/eabi-12.2"
"$SOC_TOOLCHAIN_BOOT_RTOS/bin/"*-gcc --version >/dev/null
"$SOC_TOOLCHAIN_USER_HF/bin/"*-gcc --version >/dev/null
cd "$ROOT/release/soc63"
./build_soc63 -j4
set -euo pipefail 让脚本在变量未定义、命令失败或管道失败时立刻退出;ROOT 用脚本所在目录反推,避免依赖执行时的当前目录;两条 *-gcc --version 是编译前自检,输出丢到 /dev/null 但失败会退出;最后才进 release/soc63 调构建入口。-j4 按机器调整,第一次跑建议先不加并行参数,确认默认配置能过再提速。
从那以后我每次拿到新的源码包,都强制先走一遍“工具链自检 + 目录清单 + 依赖清单”,再执行全编译。这套动作不花多少时间,但能挡掉大部分“编到一半才发现环境不对”的翻车。希望帮到你。
