SuperAPI AI 工具集

fw-toolchain

部署与运维

查看项目

更新于 10-15 21:48

技能介绍

用途:决定固件构建的交叉工具链由谁托管,并在三大工具链族中锚定版本,避免头文件、libc、链接器与目标环境不匹配导致产物不可复现。

主要能力:按任务类型分流——OpenWrt 用户态交叉编译走 Workflow A;ESP32 工具链由 ESP-IDF 自带工具链管理托管,不手动安装;OpenWrt 内核/镜像由 buildroot/IB 托管;版本不一致排障与可复现构建走 Workflow C 加 version-pinning。强调三版本轴(本机工具链、项目锁定、上游 latest)不可混用,托管矩阵为第一契约。

使用方式:先做预检,如 uname -m、command -v aarch64-linux-gnu-gcc、rustup target list --installed、idf.py --version。Workflow A 中在 Linux 宿主或容器安装发行版交叉 gcc(如 apt-get install gcc-aarch64-linux-gnu),Rust 项目执行 rustup target add aarch64-unknown-linux-musl,并在 .cargo/config.toml 指定 linker,最后用 file 核验产物架构与静态链接形态。

适用场景:aarch64 静态二进制交叉编译、ESP32 工具链缺失纠正、工具链版本漂移排障、团队可复现构建抽检。

限制:不做工程骨架、镜像构建、无板验证、真机验收与发布门禁,分别移交 esp32-idf、openwrt-image-build、fw-emulation、fw-hil-testing、fw-release-gate。禁止手工拼 sysroot、禁止绕过 IDF 手动安装 ESP 工具链、禁止在 macOS 宿主硬凑 Linux 交叉编译。基线日期为 2026-09-02,后续版本行为以官方源为准。