# TL3568-EVM（RK3568）完整刷机包 · Linux 6.12 + Debian 12

生成日期：2026-10-10 · 打包：2026-10-22

---

## 这套东西为什么不是一个文件

RK3568 板子的固件是**分区集合**，不是单文件镜像。板子的 eMMC 被 `parameter.txt` 切成
`uboot / misc / boot / recovery / backup / rootfs / oem / amp / userdata` 九个分区，
每个分区单独一个 img。

所谓"完整固件"，指的是**够把板子刷成能开机的一套文件**。对这台板子，只有 **2 个分区**需要动：

| 分区 | 起始扇区 | 大小 | 本包文件 |
|---|---|---|---|
| boot | `0x00008000` | 64 MiB | `boot-6.12.img`（46 MB，内核+DTB+资源段）|
| rootfs | `0x00058000` | 6144 MiB | `rootfs-bookworm.img`（4.0 GiB，Debian 12）|

uboot / recovery / misc / oem 等**不用动**——板子上已有且可用。

---

## 文件清单

| 文件 | 大小 | 必需 | 说明 |
|---|---|---|---|
| `boot-6.12.img` | 46 MB | ★ | 内核 6.12.69，U-Boot FIT 格式 |
| `rootfs-bookworm.img` | 4.0 GiB | ★ | Debian 12，apt 可用，无桌面 |
| `rk3568-tl3568-evm.dtb` | 197 KB | 备用 | 已含在 boot.img 内 |
| `Image` | 42 MB | 备用 | 裸内核，已含在 boot.img 内 |
| `modules-6.12.tar.gz` | 515 KB | ★ | cc33xx WiFi/蓝牙 4 个 .ko |
| `MiniLoaderAll.bin` | 470 KB | 仅救砖 | loader 模式识别不到设备时才用 |
| `parameter.txt` | 515 B | 仅救砖 | 分区表，重刷时配套 |
| `*.sha256` | — | 校验 | |
| `README-kernel.md` / `README-rootfs.md` | — | 说明 | 原始交付说明 |

---

## 刷机（两次写入，顺序别反）

板子按住 **RECOVERY** 键上电，USB 接 OTG 口进 loader 模式：

```bash
sudo rkdeveloptool ld                          # 应显示 Maskrom/Loader 设备
```

**① 先刷 boot（内核）**

```bash
sudo rkdeveloptool wl 0x8000 boot-6.12.img
```

**② 再刷 rootfs（系统）**

```bash
sudo rkdeveloptool wl 0x58000 rootfs-bookworm.img
```

**③ 重启**

```bash
sudo rkdeveloptool rd
```

> ⚠️ rootfs 是 4.0 GiB，写 eMMC 大约 2~5 分钟，中途别拔线。
> 写坏 rootfs 不影响 boot；写坏 boot 只会停在 U-Boot，都能重刷。

---

## 刷完必做

**1. 扩容 rootfs 到分区上限（6144 MiB）**

```bash
resize2fs /dev/disk/by-partlabel/rootfs
```

**2. 装 WiFi/蓝牙模块**

模块目录是 **`/system/lib/modules/`**，不是 `/lib/modules/`：

```bash
mkdir -p /system/lib/modules
tar xzf modules-6.12.tar.gz -C /system/lib/modules/
```

开机由 `rk-wifi-bt.service` 自动加载。

**3. 验证**

```bash
uname -a          # 应显示 6.12.69-g470f9dccbdc4-dirty
apt update        # 中科大源，应能通
```

---

## 回滚

原厂 Buildroot 全套固件（9 个分区，1.4 GB）保存在本机：

```
/mnt/sdb/RK开发/08_RK3568/firmware/extracted/RKDevTool_Release/jac-260317/
```

刷回原厂：进 loader 模式，用 RKDevTool（Windows）加载 `parameter.txt` + 全部分区 img，
或逐条 `rkdeveloptool wl <扇区> <img>`。

---

## 已知坑

1. **只刷 boot 不开机**——内核和 rootfs 必须配对：6.12 内核配 Debian rootfs；
   原厂 Buildroot 的 rootfs 配原厂 boot 5.10。
2. **模块版本必须匹配**：`.ko` 的 vermagic 必须是 `6.12.69-g470f9dccbdc4-dirty`，
   用别的内核编的模块加载会 `invalid module format`。
3. **屏和触摸驱动在内核里**（builtin），换 rootfs 不掉；WiFi/蓝牙是外挂模块，要自己装。
4. **trixie（Debian 13）未验证**：systemd 257 强制 cgroup v2，本内核未开
   `CGROUP_PIDS`/`CGROUP_BPF`/`PSI`，先别用。