瑞芯微 Rockchip 开发指南

编制日期 2026-10-14

从 MaskROM 抓 logs 到 SDK 构建、启动链、存储分区与量产烧录 —— 面向嵌入式工程师的 Cortex-A Linux 路线手册

这份文档面向已经在做 MCU（STM32 / ESP32 / GD32）开发的工程师：你熟悉 main()、寄存器和外设初始化，但瑞芯微 RK 系列跑的是 完整 Linux + ARM TrustZone + 多级 Bootloader —— 点不亮不再是「程序没烧进去」，而要先分清它停在了 BootROM、DDR 初始化、Trust 还是内核。本文所有型号、分区、命令均核对自 Rockchip 开源 Wiki、厂商 Wiki 与公开 TRM / Datasheet，并把存储支持矩阵、parameter.txt、MaskROM 烧录、GPIO 编号这些最容易踩坑的地方逐个拆开讲。核对不到的数值一律标注「以官方 Wiki / 手册为准」，不做臆测。

阅读路径

1 · 文档导读与阅读路径

瑞芯微不是「一块跑 Linux 的 MCU」。它是 Cortex-A 应用处理器 + TrustZone 安全世界 + 五段式启动链 + 完整发行版根文件系统 的组合。这句话决定了本文所有章节的编排方式。

报告总结

本文解决的是「拿到一块 RK 板子 / 一颗 RK 芯片之后，怎么把它从点不亮带到能出货」这条链路上的具体问题：挑型号、搭 SDK、读懂启动链、设计分区、打包烧录、改设备树、接外设、调 NPU 与多媒体、做 OTA、做安全启动、做低功耗与热设计、画硬件、上产线，最后落到与 XTX 存储芯片协同的器件选型。

读者路径

• 硬件工程师：第 2 章选型 → 第 7 章存储 → 第 16 章硬件设计 → 附录 A。
• 驱动 / BSP 工程师：第 5 章 SDK → 第 6 章启动链 → 第 9 章设备树 → 第 10 章外设。
• 系统 / 量产工程师：第 8 章烧录 → 第 13 章 OTA → 第 14 章安全 → 第 17 章产线。
• 器件 / 选型工程师：第 3 章控制器 → 第 7 章介质矩阵 → 第 19 章速查。

1.1 不覆盖什么

RK 生态很大，本文明确不写：Android Framework 与应用开发、Python / Shell 语法教学、通用 Linux 服务器运维、RK 之外的竞品对比评测、以及第三方发行版（Armbian、OpenWrt、Ubuntu Core）的专属配置流程。这些内容要么与 RK 无关，要么官方文档已经写得足够好。

1.2 事实来源与版本标注约定

瑞芯微的 SDK 以 repo manifest 为单位发布，不同板卡厂商、不同分支之间的内核版本、分区表、工具链都可能不同。本文以 opensource.rock-chips.com Wiki、公开 TRM / Datasheet、以及主流板卡厂商公开 Wiki（Firefly、Radxa、Khadas、Luckfox、Neardi 等）为准。三点提醒：

1.3 命令与代码的书写约定

• 命令行输入一律以 $ 开头表示普通用户，sudo 显式标注提权；# 开头是一行注释说明，不是 root 提示符。
• 路径统一使用 Linux 正斜杠。<sdk>、<dev> 这类尖括号是占位符，替换时不保留尖括号。
• 设备树片段为了可读性做了缩进整理，实际文件里的缩进请以 SDK 源码为准。

1.4 MCU 工程师转 Rockchip 最容易卡住的四件事

2 · RK 家族全景与选型

瑞芯微的产品编号看起来杂乱（RK / RV / PX 混在一起），实际上分界线非常清晰：RK3xxx / RK35xx 是通用应用处理器，RV11xx 是视觉与 IPC，RK33xx 偏语音与入门，RK18xx / RK3399Pro 是带 NPU 的老一代 AI 芯片。第一步选错档位，后面怎么做都是徒劳。

2.1 五条产品线怎么分

官方把产品划分为若干条线，分界线不是主频，而是目标应用与配套软件栈：旗舰档跑 8K 多屏与边缘大模型；主流档做工业网关、HMI、NVR；入门与语音档做智能音箱与低成本终端；视觉档自带 AI-ISP 服务 IPC 与电池摄像头；经典存量档则是仍在大量出货、但新设计一般不再首选的老型号。

来源：Rockchip 公开产品资料 / 厂商平台矩阵整理

2.2 旗舰档：RK3588 系列

RK3588 是当前瑞芯微的旗舰：四核 Cortex-A76 + 四核 Cortex-A55 的 big.LITTLE 组合，六核（三核架构）NPU 最高 6 TOPS，8K 视频编解码，四通道 LPDDR4/4X/5。它有三个主要衍生型号，区分点是封装、接口数量与温度范围，而不是算力。

2.3 承上启下：RK3576

RK3576 定位在 RK3568 与 RK3588 之间：CPU 换成四核 Cortex-A72 + 四核 Cortex-A53（最高 2.2 GHz），NPU 直接给到 6 TOPS 并支持 Transformer 类算子，视频能力为 4K@120 解码 / 4K@60 编码。对多数「要 AI 但不需要 8K」的项目，它是性价比更高的一档。

2.4 主流档：RK3568 / RK3566 / RK3562

这一档是出货量最大、生态最成熟的一档，也是新项目最常落入的区间。三者是同一代架构的成本梯度：RK3568 接口最全，RK3566 精简掉 SATA / PCIe 与部分高速口，RK3562 进一步降到四核 A53 与 0.8 TOPS。

2.5 入门与语音档：RK3308 / RK3326 / RK3328

这一档的共同点是：CPU 用 Cortex-A35 或 A53，主频与带宽有限，但接口刚好够用、功耗与 BOM 都很低。RK3308 更是把音频做到了极致 —— 多路 I2S/TDM、PDM、SPDIF、HDMI ARC，外加硬件 VAD（语音激活检测），是智能音箱的经典选择。

2.6 视觉与边缘 AI 档：RV11xx / RK1808

RV 前缀是瑞芯微的视觉产品线：自带 AI-ISP、MIPI-CSI、H.264/H.265 硬编解码，面向 IPC、电池摄像头、门铃与车载视觉。RK1808 则是瑞芯微第一代带独立 NPU（3.0 TOPS）的芯片，现在多见于存量项目与协处理器方案。

2.7 经典存量档：RK3399 / RK3288 / PX30

2.8 选型决策树

• 要 8K 多屏、边缘大模型、多路 4K NVR、机器人主控 → RK3588（或按封装/温度选 S / J / M）。
• 要 AI 但预算敏感，4K 就够 → RK3576。
• 工业网关、HMI、商用显示、自助终端 → RK3568；纯显示与轻终端 → RK3566。
• 智能音箱、语音模组、离线唤醒 → RK3308 / RK3308H1。
• 电池摄像头、门铃、IPC → RV1106 / RV1103 / RV1126B。
• 低成本掌机 / 小屏终端 / 老项目维护 → RK3326 / RK3328 / RK3399。

2.9 和 STM32 / ESP32 / 树莓派怎么选

3 · 内核与架构：Cortex-A + NPU + 多媒体

理解 RK 的第一件事，是看清一颗 RK SoC 内部到底塞了多少东西。CPU 只是其中一个子系统，旁边并排着 NPU、GPU、VPU、ISP、显示控制器、存储控制器，以及三颗不跑 Linux 的 Cortex-M0。

3.1 一个 RK SoC 内部有什么

以 RK3588 为例，官方 Datasheet 把它拆成：微处理器子系统（4×A76 + 4×A55 + DSU + 3 MB 共享 L3）、内部存储（BootROM、PMU SRAM、Share Memory）、外部存储接口（LPDDR、eMMC、SD/MMC、FSPI）、系统组件（MCU、GIC、CRU、PMU、Timer、PWM、Watchdog、DMAC、安全系统、Mailbox、解压引擎）、视频编解码、显示、图像信号处理，以及一整套高速外设。

来源：Rockchip RK3588 Datasheet / 公开资料整理

3.2 CPU 子系统：big.LITTLE 与 DSU

3.3 NPU：RK 最有辨识度的一块

瑞芯微从 RK1808 开始内置自研 NPU，到 RK3588 / RK3576 已经做到 6 TOPS。它支持 INT4 / INT8 / INT16 / FP16（部分型号标称还支持 BF16 / TF32）混合运算，兼容 TensorFlow、PyTorch、Caffe、MXNet 等框架导出的模型。

3.4 多媒体引擎：VPU / RGA / ISP

3.5 存储控制器一览

这是本文作者最关心的一节 —— 存储控制器的数量和类型，直接决定了器件能落在哪里。

3.6 三个 Cortex-M0 与电源域

RK3588 内部集成三颗 Cortex-M0：一颗在 VD_PMU 电源域（16 KB Cache + 16 KB TCM），一颗在 VD_NPU（16 KB Cache + 64 KB TCM），一颗在 PD_CENTER（32 KB TCM）。它们服务于电源管理、NPU 协处理与系统控制，不是给应用开发者写硬实时逻辑用的。

• 45 个独立电源域（RK3588）：可以按场景关掉不用的模块，这是低功耗设计的基础。
• 18 个 PLL：时钟树非常灵活，也意味着设备树里的时钟配置出错概率更高。
• Crypto 引擎：支持 SHA-1/256/512、MD5、SM3、HMAC、AES、DES/TDES、SM2/SM4 与 PKA（RSA/ECC 最高 4096 bit），是安全启动的硬件基础。

4 · 开发环境与 SDK 获取

瑞芯微 Linux SDK 只支持在 Linux 主机上编译，且由几十个 git 仓库组成，用 repo 统一管理。这一章解决「代码从哪来、在哪编、编之前要装什么」。

4.1 三种拿到 SDK 的方式

4.2 编译主机：只支持 Linux

来源：Rockchip Linux SDK 开发指南 / 厂商 Wiki 整理

4.3 依赖包与工具链

官方给出的一揽子依赖（不同 SDK 版本略有差异，这里按主流 Linux SDK 给出）：

$ sudo apt-get update
$ sudo apt-get install git ssh make gcc libssl-dev liblz4-tool expect \
    expect-dev g++ patchelf chrpath gawk texinfo diffstat binfmt-support \
    qemu-user-static live-build bison flex fakeroot cmake \
    gcc-multilib g++-multilib unzip device-tree-compiler \
    ncurses-dev libgucharmap-2-90-dev bzip2 expat gpgv2 \
    cpp-aarch64-linux-gnu libgmp-dev libmpc-dev bc python-is-python3 \
    libstdc++-12-dev repo

交叉工具链放在 SDK 的 prebuilts/ 下，u-boot 与 kernel 用它；rootfs 侧则由 Buildroot / Debian / Yocto 各自的工具链负责，不需要手动指定。

4.4 repo 与多仓库管理

一个完整的 Linux SDK 由几十个 git 仓库组成（kernel、u-boot、rkbin、buildroot、debian、yocto、device、external、app、docs、tools…），用 repo 按 manifest 统一拉取与切换分支。

# 初始化（以厂商提供的 manifest 为准）
$ repo init --no-clone-bundle -u <manifest 仓库地址> -b <分支> -m <manifest.xml>

# 同步代码
$ .repo/repo/repo sync -c --no-tags
$ .repo/repo/repo start <分支名> --all

# 后续更新
$ .repo/repo/repo sync -c --no-tags

$ readlink -f .repo/manifest.xml
/home/<user>/proj/.repo/manifests/rk3588/rk3588_linux_release_20230301_v1.0.6e.xml

4.5 目标板侧的准备

• 一根能跑 1500000 波特率 的 USB 串口线（CP2104 / FT232 等，CH340 在部分高波特率下不稳）
• 一根数据线（不是充电线）用于 USB OTG 烧录与 ADB
• 确认板载存储介质：eMMC / SD 卡槽 / SPI NOR 焊位，以及对应的 boot 按键位置
• 确认 RECOVERY（或 MASKROM）按键与短接点，这是进烧录模式的物理入口
• Windows 上先装 DriverAssitant（Rockchip USB 驱动），再打开 RKDevTool
• Linux 上配好 udev 规则，否则每次烧录都要 sudo

# /etc/udev/rules.d/99-rk-rockusb.rules
SUBSYSTEM=="usb", ATTR{idVendor}=="2207", MODE="0666", GROUP="users"
# 生效
$ sudo udevadm control --reload-rules && sudo udevadm trigger