📚

教程系列

从空机器到 RK3506 主线启动到 UART 登录的完整可复现路径

学习路线图

rk-forge 的 bring-up 弧线分五个阶段，按下面的顺序读最顺：先把板子启动起来，再让它持久登录（rootfs），接着把外设一个个点亮，然后补上 SD 卡这条第二条启动路，最后用 forge 编排器把整条链收成一个命令。

🚀

Phase 1

引导启动

Boot

主线 U-Boot + Kernel

路线图：为什么是 RK3506，为什么 mainline-first→工具链：arm-linux-gnueabihf→U-Boot 与 rkbin：在闭源 blob 的咽喉上拔河→内核：补上那块属于我们的板级设备树→

📦

Phase 2

根文件系统

RootFS

从 panic 到 login

路线图：rootfs 这条最深的路→buildroot：出一份正规的最小 rootfs→init 时序：switch_root 到 login 的两道暗门→UBIFS 与 loader 弱写 saga：bringup 最深的一关→

🔌

Phase 3

外设

Peripherals

从能启动到能用

路线图：把板子从"能启动"变成"能用"→Ethernet + SPI + MMC/SD：三个纯接线的外设→USB：USB2PHY 的两套寄存器和那个父节点坑→WiFi（RTL8733BU）：把 out-of-tree 驱动搬进 7.1→I2C/UART：RK3506 的 RMIO 交叉开关→Audio（ES8388 + SAI1）：点亮数字音频链路→

💾

Phase 4

SD 卡启动

SD Boot

第二条启动路

路线图：SD 卡，第二条启动路→SD-1：手动引导 SD 卡到 shell→SD-2：autoboot，上电零输入到 shell→

🛠️

Phase 5

forge 编排器

Orchestrator

把命令收成一个

forge：把一长串命令收成一个编排器→

教程目录

引导启动

01路线图：为什么 mainline-first→02工具链：arm-linux-gnueabihf→03U-Boot 与 rkbin→04内核：板级设备树→

根文件系统

01路线图：rootfs 最深的路→02buildroot 最小 rootfs→03init 时序→04UBIFS 与 loader 弱写 saga→

外设

01路线图：从启动到能用→02Ethernet + SPI + MMC/SD→03USB（USB2PHY + DWC2）→04WiFi（RTL8733BU）→05I2C/UART（RMIO 交叉开关）→06Audio（ES8388 + SAI1）→

SD 卡启动

01路线图：第二条启动路→02SD-1：手动引导→03SD-2：autoboot→

forge 编排器

01forge：收成一个编排器→

遇到问题？

RK3506 这条链踩了一路坑——rkbin SPL 的隐性契约、SPI-NAND 读写 saga、reserved-memory abort、USB2PHY、out-of-tree WiFi……全都老老实实记在 踩坑日记 的七篇里，每条挂着串口原文。提交 GitHub Issue 也欢迎。