imx-forge

这是一个包含模板的仓库，包含imx6ull-chips、uboot、kernel、rootfs补丁，以实现快速应用

  • 语言C
  • 大小32.1 MB
  • 更新7月8日
在 GitHub 打开

README

2026-09 起，内核全面切到上游主线：NXP linux-imx 内核轨正式退役。 笔者在这里！！！需要提示的是 imx-forge正在进行深度的教程二次优化，还请谨慎参考，预计大致到国庆后完成大部分文档的维护

仓库不再构建、不再维护 linux-imx 内核，所有脚本与教程统一收敛到主线内核（mainline Linux，当前 v7.1，真板实测启动）。文档里涉及 imx 内核的地方只留参考引用（NXP 官方仓库链接与 git 历史）；照着旧教程操作时，内核路径一律以 third_party/linux_mainline + out/linux 为准。U-Boot 同样已收敛到上游主线（third_party/uboot-mainline，pin v2026.10）。

██╗███╗   ███╗██╗  ██╗      ███████╗ ██████╗ ██████╗  ██████╗ ███████╗
██║████╗ ████║╚██╗██╔╝      ██╔════╝██╔═══██╗██╔══██╗██╔════╝ ██╔════╝
██║██╔████╔██║ ╚███╔╝ █████╗█████╗  ██║   ██║██████╔╝██║  ███╗█████╗
██║██║╚██╔╝██║ ██╔██╗ ╚════╝██╔══╝  ██║   ██║██╔══██╗██║   ██║██╔══╝
██║██║ ╚═╝ ██║██╔╝ ██╗      ██║     ╚██████╔╝██║  ██║╚██████╔╝███████╗
╚═╝╚═╝     ╚═╝╚═╝  ╚═╝      ╚═╝      ╚═════╝ ╚═╝  ╚═╝ ╚═════╝ ╚══════╝

面向 NXP i.MX6ULL 的嵌入式 Linux 开发工坊 —— 从工具链到驱动的完整学习路径

CI Tag Latest Stable License Contributors Docker WSL2 QQ

💬 技术交流

IMX-Forge 技术交流 QQ 群二维码

QQ 交流群：645248275

搭建环境卡住、内核跑不起来、驱动写了没反应……欢迎进群与作者和同学们一起踩坑。

💬 点击加入群聊 · 或手机 QQ 扫描上方二维码

✨ 为什么选择 IMX-Forge？

  • 🐳 开箱即用的开发环境 — 预装 ARM GNU Toolchain 15.2.rel1 的 Docker 镜像，5 分钟就绪，无需配置工具链 PATH；WSL2 深度友好（Mirrored 网络 + USB 直通）。
  • 🔧 主线内核单轨 — 直接基于 Mainline 7.1 构建（linux-imx vendor 轨已移除），真板实测启动。
  • 📚 完整的 0→1 学习路径 — 工具链 → U-Boot → 内核 → Rootfs → 驱动 → 实战，每步都有文档与示例，不再是"略去一万字"的坑人教程。
  • ✅ CI/CD 全覆盖 — 每次提交自动验证 U-Boot、Linux 内核与 rootfs 构建，ccache 加速。

🌐 在线阅读：https://awesome-embedded-learning-studio.github.io/imx-forge/

🚀 快速开始

git clone --recurse-submodules https://github.com/Awesome-Embedded-Learning-Studio/imx-forge.git
cd imx-forge

# 拉取预构建镜像（Ubuntu 24.04 + 工具链 + 全部依赖，约 2GB）
docker pull ghcr.io/awesome-embedded-learning-studio/imx-forge:latest
docker run -it --rm -v $(pwd):/workspace ghcr.io/awesome-embedded-learning-studio/imx-forge:latest

# 一键构建完整系统（默认 eMMC 镜像）
./scripts/release-all.sh
更多选项
  • 锁定版本：docker pull ghcr.io/awesome-embedded-learning-studio/imx-forge:v1.0.0（首个轻量可用版；历史 v0.5 仅作路线图里程碑）。
  • SD/eMMC 双介质：./scripts/release-all.sh --boot-media both。
  • Qt6 rootfs（默认不含，增量补不浪费前面的编译）：
    ./scripts/build_helper/build-buildroot.sh --with-qt6    # 增量补 Qt6 到 out/release-latest/rootfs
./scripts/release-all.sh --continue --stage 5           # 用带 Qt6 的 rootfs 重打包镜像
    详见 release-all.sh 文档。
  • 本地构建镜像 / 国内加速：cd docker && docker build -t imx-forge:latest .（国内可用 Dockerfile.cn）；ghcr.io 拉取慢见 Docker 镜像加速。

v1.0.0 的 SD 卡启动与 UUU + UMS eMMC 启动流程，已由仓库主作者 CharlieChen114514 在正点原子阿尔法 i.MX6ULL 开发板上完成实验验证。

📖 详细配置：QUICK_START.md · Docker 指南 · WSL2 教程

📖 学习路径

阶段 主题 内容 状态
🌱 Linux 基础预备营 35 章 Ubuntu 实用教程，补齐嵌入式必备功课 ✅ 新增
0️⃣ Docker 基础 Docker 基础知识与 IMX-Forge 开发指南 ✅
🛠️ 开发工作流 WSL2、clangd 交叉索引、VSCode tasks 模板 ✅
1️⃣ 工具链 ARM GNU Toolchain 15.2 安装与配置 ✅
2️⃣ U-Boot U-Boot 原理、编译、移植、Logo 定制 ✅
3️⃣ 内核开发 设备树、内核配置、驱动开发、网络启动 ✅
4️⃣ Rootfs BusyBox、inittab、NFS 挂载、应用集成 ✅
🏗️ Buildroot 构建 现行 rootfs 方案：br2-external、自定义包、Qt6 集成 ✅
5️⃣ 驱动开发 字符设备、设备树、pinctrl/gpio、platform、input 子系统 ✅ 持续扩展
🖥️ QEMU 板级模拟 没有板子也能跑：外设模型 + e2e 断言体检 ✅ 新增
6️⃣ 实战演练 完整系统构建与调试 ✅
🏁 工程实战 light-meter：从空 CMakeLists 到真板产品 ✅ 新增

当前完整支持 正点原子阿尔法 i.MX6ULL；其它板卡（野火等）欢迎提交 PR。项目规划见 todo。

🤝 贡献

欢迎 报告 Bug · 提出功能 · 提交代码。完整指南与补丁命名规范（[mainline] / [uboot]）见 CONTRIBUTING.md。感谢 所有贡献者。

📄 开源协议

MIT —— 详见 LICENSE。若补丁源自 GPL 授权的上游 U-Boot，则保留其原始 GPL-2.0 许可证。

用 🔥 和无数串口终端堆出来的工程。希望我们可以更方便地自定义自己的 i.MX6ULL 系统。

⭐ Star · 🍴 Fork · 💬 QQ 群 · 📢 Issues

评论

暂无评论