imx-forge

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）。

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

💬 技术交流

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

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

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

📖 学习路径

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

🤝 贡献

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

📄 开源协议

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