🗒️

工程笔记

raw、按天的 bring-up 流水——what worked, what didn't，原样保留

这一层是 rk-forge 的诚实底层：73 篇带日期的 bring-up 流水，原样保留——成功的、失败的、brick 时的慌乱、半成品、噪音，一个不删、不去重。它是踩坑日记（pitfalls/）和教程（tutorial/）的取证源：后两者是提炼后的结论，这里是现场。

命名约定 NN-YYYY-MM-DD-<slug>.md：序号 = 推荐阅读顺序（理解项目的递进阶段），日期 = 工作日期，slug = 一句话描述。序号主导排序。

完整 73 篇按阶段递进的阅读顺序，见左侧栏或 notes/README 的阶段表。下面挑几个里程碑入口：

07里程碑：主线 Linux 首次启动→13P1：公开 rkbin loader 攻克→20mkimage saga 交接→30WiFi RTL8733BU 移植完成→32SD 卡镜像 SD-1→36RK3568：多板框架 + 主线 boot→50RK3588：首次 boot 到 systemd→48RK3588：GPU 固件 + GNOME 桌面→57RK3588：vendor CPUFreq/DVFS 事务移植→58RK3588：WiFi RTL8723DU→rtw88 移植全记录→59RK3568：QEMU 模拟研究线立项 + M0 Day 0 绿灯→60RK3568：rk3568-lite 机器首启，4 核跑到 shell→61RK3568：virtio 存储 + rootfs 直启→62RK3568：真板 DTS 直启，CRU/PMU 影子模型→63RK3568：推干净战役，真 DTS 启动 90s→3.8s→64RK3568：U-Boot 拉起 + booti 接力内核→65RK3568：sim 资产 Python 化，Windows 一等公民→66RK3568：bootm 起 forge FIT，真板同款最后一接力→67RK3588：首台异构仿真机 + Ubuntu 真根直启→68RK3588：真板 DTS 完全平移→69RK3588：真板 DTS + Ubuntu 真根合体→70RK3588：systemd 上机，仿真里 Ubuntu 完整开机→71RK3588：VOP2 战役一，电源域级联 + PrimeCell ID→72RK3588：VOP2 战役二，DRM 管线在仿真里成立→73RK3588：VOP2 战役三，KMS 用户态解放 + gdm 上机→74RK3588：VOP2 战役四，GNOME 桌面点亮 + 冷启动地板→75RK3588：virtio-gpu 探路撤退 + 研究线纪律定音→76RK3588：Mali CSF 仿真预研（外部报告）→77RK3588：同 DTB 的 cmdline virtio 桌面路径→78RK3588：virgl 桌面加演，宿主 GL 四路验尸 + dxg 根因→79RK3588：GT911 触摸真路径战役，i2c/gpio 影子成军→80RK3588：真面板桌面，VOP2→DSI 全真管线贯通→81RK3588：vmstate 快照，9.2s 回桌面 + 迟发 hardlockup 挂账→82RK3588：panthor 战役，SCMI agent + SMCCC 根因 + GPU 影子假 MCU 直取 M0→83RK3588：panthor M1，内核侧全通（CSG/CS fixture）+ 装备升级，mesa 认出 Panfrost→84RK3588：panthor M2a，CSG 生命周期 ACK（toggle 边沿语义），超时噪音归零→85RK3588：CBA 三连——桌面负载验成色（M2b 规格到手）+ restore 锁死定界（多核 loadvm 缺陷）→86RK3588：panthor M2b 终章，wrapper-CS 解释器，fence 全通桌面渲染循环活（像素免责）→87RK3588：panthor M2c，首个真像素——glClear readback PASS，note 76 执行器证据门被推翻→88RK3588：panthor M2e，控制流指令 + 权威 AS 绑定 + 用户门铃修复（M2b 期楔死根因）→89RK3588：panthor M2f，JOB_IRQ bit19 移位根修——brownout 真凶落网，mutter 并发 glClear 4× PASS→90RK3588：panthor M2g，draw 全指令流穿执行器——CALL Length 寄存器操作数 + FBO U-tiled 破题→91RK3588：panthor M2h 侦察，readback blit 指令形态（RUN_IDVS 双件套）+ r40=FBD 寄存器地图→92RK3588：panthor M2h 达成，第一个真 blit 像素（u-interleave 数据搬运 + Clean Tile 位分家）→93RK3588：panthor M2i 侦察，SRT 链三层挖掘（16B SRE 实测格式 + GPUSRT 仪器落库，链未竟）→94RK3588：panthor M2i 达成，锚点反查破案——plane 终点实锤，blit src 升级为结构匹配→95RK3588：panthor M2j，AFBC solid-header clear + 读路径 + 子区域 readback 全链 PASS→96RK3588：panthor M2k，AFBC 写路径 + VOP 解码——基建闭环，桌面可见判定仍归 shader→97RK3588：panthor M2l 侦察，常量不在内存里（FAU 页选编码+立即数烤入），M2l=Valhall 解码→98RK3588：panthor M2l，四变体 diff 密码攻击——FS 代码定位+常量指纹+序列变化三发现→99RK3588：panthor M2l 达成——常量色 FS 执行，shader 语义像素 13/13 PASS→100RK3588：panthor M2m，桌面会话全负载活，GPLANES 定界：桌面可见=采样合成深水区→