rk-forge 把主线 Linux 7.1 + U-Boot 2026.07 跑到三块 Rockchip 板上,围绕每块板搭一条从驱动 bring-up 到应用层的全栈车道。不是发行版镜像 / Armbian / Yocto / 厂商 BSP——交付的是可复现构建链 + 有序补丁库 + 教程,不是成品。
- 主线优先:kernel / U-Boot 走上游,只集成不重造;
rkbin是唯一闭源依赖(当靶子、追踪消除)。 - 真板诚实:每项能力挂真板证据,跑通说跑通、没通标没通,状态不刷绿。
- 追全开源:逐层消灭闭源 blob,走向全开源(北极星)。
python3 src/forge/cli.py doctor --board aes # 检查 host 依赖 + 交叉工具链(缺啥给 apt 命令)
python3 src/forge/cli.py all --board aes # setup → build → pack → assemble → board/aes/out/update.img默认板 aes(RK3506B);构建其它板加 --board=rk3568-atk / rk3588-topeet(自动选工具链 / 存储 / rootfs profile);OpenWrt 加 --rootfs=openwrt。完整步骤、烧录上板、常见坑见 QUICK_START.md 与 document/tutorial/。
| 想找什么 | 去哪 |
|---|---|
| 怎么用 / 教程 | document/tutorial/ |
| 每板规划与进度(ROADMAP) | document/planning/ |
| 主线 vs vendor 差距、验证了什么 | document/sdk-diff.md |
| 闭源 blob 清单与消除路径 | document/blobs.md |
| 踩过的坑 | document/pitfalls/ |
| 真板日志 / 时间线 | document/logs/ · document/notes/ |
| 定位与设计原则 | document/blueprint.md |
| 架构与构建 | document/architecture.md |
| 贡献指南 | CONTRIBUTING.md |
scripts/ forge.sh(单一入口)+ lib/ + build-*/pack-* .sh + apply-series.sh + 纯 Python 打包器
patches/<board>/{linux,uboot}/series 按板隔离的有序补丁序列(git format-patch 的 [PATCH] 主题)
board/ 各板构建工作区 + 配置(aes · rk3568-atk · rk3588-topeet)
third_party/ rkbin(pinned submodule)· buildroot · src/<board>/(主线源码树)
reference/ 各板 vendor SDK(参照/萃取池,非构建依赖)
config/ forge.env · toolchain.conf(声明式配置)
document/ tutorial · planning · sdk-diff · blobs · pitfalls · logs · notes
这是当前布局;正在就地重构为更清晰的形状(无
config/目录、board/→boards/自含board.yaml+patches/、产物归到根out/)。目标结构见 document/architecture.md。
MIT,详见 LICENSE。源自 GPL SDK 的补丁保留 GPL-2.0 并在补丁头标注。rkbin 为 Rockchip 专有固件,仅以 pinned 子模块引用,不拷入本仓库、不再分发。