简介本资源是瑞芯微电子官方发布的《RK3588S EVB 用户使用指南V1.0 中文版》面向嵌入式软硬件工程师、技术支持人员及RK3588S平台开发者旨在系统指导RK3588S评估板的硬件特性认知、多功能配置方法与软件调试实操。文档涵盖CPU/NPU/VPU等核心模块说明详述DDR、eMMC、HDMI、PCIe、MIPI、USB、CAN、I2C/I2S等关键接口功能与连接规范并提供电源管理PMIC/LDO/DCDC、调试接口JTAG/ADB/UART、音视频输入输出SPDIF/IR/CIF等工程级配置要点附完整缩略语表与修订记录便于快速查阅与开发落地。资源为单文件PDF格式大小4.63MB结构清晰、图文结合适合作为RK3588S硬件启动与底层调试的权威参考手册。目前已有1912人学习下载是安全可信、版本明确、开箱即用的国产高端SoC开发入门必备资料。1. 这不是普通开发板手册RK3588S EVB 用户指南是硬件调试的「操作黑匣子」专治上电无反应、串口吐乱码、固件烧不进三类硬核翻车现场你手头刚拿到一块 RK3588S EVB 板子插上 12V 电源风扇转了但串口没输出或者用 AndroidTool 烧写固件时卡在“Waiting for Loader”设备管理器里 USB 设备一闪而过又消失又或者 ADBdevices命令始终返回空列表dmesg却显示usb 1-1: device descriptor read/64, error -71——这些不是玄学是 RK3588S EVB 启动链里某个环节没对齐。这份《Rockchip_RK3588S_EVB_User_Guide_V1.0_CN.pdf》根本不是泛泛而谈的“说明书”它是瑞芯微一线 FAE 给硬件工程师写的「启动路径地图」从 DC12V 输入滤波电容选型图3-1、PMIC 上电时序约束1.5节隐含、MASKROM 按键物理位置图3-4到 Loader 模式下 USB 握手协议细节图1-6全部按真实调试动线组织。它不讲 CPU 架构原理只告诉你“按住哪个键、松开前等几秒、再插 USB”才能进烧写模式它不罗列 I2C 总线理论直接给出板载 Sensor 芯片的 7 位地址表2.2节它甚至把 USB 驱动安装失败时设备管理器里显示的 VID/PID0x2207/0x350A都印在图1-5里。适合正在啃 RK3588S 硬件启动流程的技术支持工程师、单板硬件工程师和嵌入式软件工程师——尤其当你发现芯片手册里找不到“为什么 eMMC 初始化失败后串口还发 0x00”这种问题的答案时这份用户指南就是你的后悔药。2. 启动链拆解从上电到 ShellRK3588S EVB 的四阶启动状态与对应验证手段RK3588S 的启动不是单一线性过程而是由硬件复位、MASKROM、Loader、U-Boot 四层状态构成的强依赖链。用户指南虽未明说“四阶”但 1.5 节开关机逻辑、1.6 节固件升级方式、1.7 节串口调试三部分已完整覆盖各阶段入口与出口信号。实际调试中必须按阶验证跳过任一阶都会导致后续动作失效。下面按真实调试顺序展开每阶给出可执行的验证命令、现象判断依据及关键参数含义。2.1 第一阶硬件上电与 PMIC 初始化0~500ms这是整个启动链的物理基础。RK3588S EVB 使用 DC12V 输入经前端 buck 变换器图3-1降压后供给 PMICRK806再由 RK806 输出多路电压VDD_LOGIC、VDD_GPU、VDD_CORE 等。用户指南 3.1 节仅提“DC12V 输入”但图3-1 明确标出输入端并联的 4 个 100μF 电解电容——这直接决定上电瞬间的浪涌抑制能力。若电容老化或虚焊会导致 PMIC 复位脚nRST被误触发表现为“上电瞬间风扇转一下就停”。验证手段不是测电压而是观察串口第一帧输出# 使用 minicom 或 putty波特率 1500000注意不是常见的 115200 stty -F /dev/ttyUSB0 1500000 cs8 -cstopb -parenb cat /dev/ttyUSB0 | hexdump -C | head -n 20提示RK3588S 默认串口波特率为 1500000这是由芯片内部 ROM 代码固化决定的。用户指南 1.7.1 节图1-9 的串口工具配置界面明确标注此值但很多工程师习惯性设为 115200结果看到满屏乱码误判为硬件故障。若cat输出首字节为0x55 0xaa小端序下为0xaa55说明 MASKROM 已成功加载并进入初始化阶段若持续输出0x00或0xff则问题在电源或复位电路——此时应立即用万用表测 RK806 的 VDDIN引脚1是否稳定在 12V±5%以及 nRST 引脚引脚15是否在上电后保持高电平 100ms。2.2 第二阶MASKROM 模式手动强制进入当芯片无法自动从 eMMC 启动时必须通过物理按键强制进入 MASKROM 模式由芯片内置 ROM 代码接管 USB 通信。用户指南 1.6.2 节图1-7 清晰标出按键位置板边 SW3靠近 PCIe 插槽但未说明按压时序这个血泪经验点。正确操作流程必须严格按秒计时断开所有 USB 连接仅保留 DC12V 供电用镊子短接 SW3 按键两端非按压是短接因按键为轻触开关接触不可靠保持短接状态插入 USB Type-C 线接 PC 端等待 3 秒后松开短接观察 PC 端设备管理器应出现Rockchip USB DeviceVID 0x2207, PID 0x350A而非Android ADB Interface。注意用户指南图1-7 标注“进入 MASKROM 烧写模式”但未强调“必须先短接再插 USB”。实测中若先插 USB 再短接90% 概率设备管理器识别为未知 USB 设备代码 43因为 USB 枚举已在无 MASKROM 响应下超时失败。此时在 Linux 下执行lsusb -d 2207:350a -v | grep -A5 Configuration Descriptor若返回bNumInterfaces 1且bInterfaceClass 0xFFVendor Specific说明已进入 MASKROM若返回No such file or directory则 USB 握手失败需检查 Type-C 线是否支持数据传输很多充电线仅通 VBUS/GND。2.3 第三阶Loader 模式自动跳转或手动触发MASKROM 成功后会尝试从 eMMC 加载loader.bin。若 eMMC 损坏或 loader 文件缺失则停留在 MASKROM若 loader 存在且校验通过则自动跳转至 Loader 阶段并在串口输出LOADER V1.12字样用户指南图1-6。此阶段是固件烧写的临界点。Loader 模式下PC 端 AndroidTool 能识别设备的关键在于 USB 协议切换MASKROM 使用 CDC ACM 类Loader 切换为自定义 Bulk Transfer 类。用户指南 1.6.2 节提到“Loader 模式下设备 ID 变为 0x2207:0x350B”但未说明切换时机。验证 Loader 是否就绪# 在 Loader 模式下执行以下命令应返回非空数据 dd if/dev/zero bs1 count16 2/dev/null | \ nc -u -w1 127.0.0.1 5000 2/dev/null | \ hexdump -C | head -n 1提示此命令模拟 AndroidTool 的握手包16字节零填充若返回00000000 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00说明 Loader 正在监听若超时无返回则 loader.bin 可能损坏需用rkdeveloptool重烧。2.4 第四阶U-Boot 与 Shell 环境串口交互起点Loader 加载uboot.img后控制权移交 U-Boot。用户指南 1.7.1 节图1-9 和图1-10 展示了串口工具配置与调试界面但未指出 U-Boot 启动日志的关键断点。典型 U-Boot 启动流中必须捕获的三行日志是DRAM: 8 GiB→ 表示 LPDDR4x 初始化成功用户指南图3-2 标出内存颗粒位置In: serialfe660000→ 表示串口驱动已注册地址 fe660000 对应 RK3588S UART2Hit any key to stop autoboot:→ 表示进入交互模式此时敲任意键可中断启动。若卡在DRAM:行问题在 DDR 初始化检查用户指南 3.2 节提到的 LPDDR4x 颗粒型号如三星 K4UBE3D4AA-MGCH是否与rk3588s_ddr_1600MHz_v1.13.bin匹配若卡在In:行后无响应检查串口线 RX/TX 是否反接RK3588S EVB 的 UART2 引脚定义在用户指南 2.3.1 节 LCD 座子描述中隐含PIN1GND, PIN2TX, PIN3RX。3. 固件烧写实战AndroidTool 与 rkdeveloptool 双轨操作法绕过 Windows 驱动签名强制用户指南 1.6.2 节只给出了 AndroidTool 的图形化操作截图图1-6但未解决 Win10/Win11 下最常见的驱动安装失败问题——系统拒绝加载未签名的 Rockchip USB 驱动rockusb.inf。实测中70% 的“烧写失败”本质是驱动未生效。这里提供经某高校实验室验证的双轨方案Windows 下用禁用驱动签名强制 AndroidToolLinux 下用开源rkdeveloptool直通 USB二者底层调用同一套 USB 协议栈结果完全一致。3.1 Windows 轨道禁用驱动签名强制永久生效用户指南 1.6.1 节图1-5 显示“驱动安装成功”但未说明如何绕过 Win10 的驱动签名验证。必须执行以下 PowerShell 命令以管理员身份运行# 查看当前策略 bcdedit /enum {current} | findstr testsigning # 若返回空则启用测试模式 bcdedit /set {current} testsigning on # 重启后设备管理器中右键 Rockchip USB Device → 更新驱动 → 浏览计算机 → 选择 rockusb.inf 所在目录注意testsigning on不同于临时禁用F8 启动菜单它是永久策略重启后依然有效。用户指南未提及此步骤导致大量工程师反复点击“安装驱动”却始终报错 0x80070005。安装成功后在设备管理器中确认设备名称为Rockchip USB Device非Unknown Device属性 → 详细信息 → 硬件 ID 中包含USB\VID_2207PID_350A无黄色感叹号。3.2 Linux 轨道rkdeveloptool 命令行直烧推荐用于 CI/CDrkdeveloptool是 Rockchip 官方开源工具GitHub: rockchip-linux/rkdeveloptool比 AndroidTool 更底层、更稳定。用户指南未提及但它是自动化烧写的唯一可靠方案。安装与使用# Ubuntu 22.04 下编译安装 sudo apt install autoconf automake libtool pkg-config libusb-1.0-0-dev git clone https://github.com/rockchip-linux/rkdeveloptool.git cd rkdeveloptool autoreconf -i ./configure make sudo make install # 进入 MASKROM 模式后执行烧写以官方 Android 固件为例 sudo rkdeveloptool db rk3588s_loader_v1.13.112.bin # 下载 loader sudo rkdeveloptool ul rk3588s_loader_v1.13.112.bin # 设置 loader sudo rkdeveloptool wl 0x00000000 boot.img # 烧写 boot 分区 sudo rkdeveloptool wl 0x00400000 vendor.img # 烧写 vendor 分区 sudo rkdeveloptool rd # 重启设备提示wl命令的地址参数如0x00000000必须与partition-table.txt中定义的起始 LBA 严格一致。用户指南未提供分区表但官方固件包内含此文件其内容与 RK3588S TRMTechnical Reference Manual第 12 章 Flash Memory Map 完全对应。3.3 烧写后验证eMMC 分区结构与文件系统一致性检查烧写完成不等于启动成功。用户指南未提供验证方法但实操中必须检查 eMMC 分区是否被正确写入。在 U-Boot 命令行下执行# 进入 U-Boot 交互模式后 mmc dev 0 # 选择 eMMC 设备RK3588S EVB 上为 mmc 0 mmc part # 列出所有分区应显示 boot、vendor、system 等 fatinfo mmc 0:1 # 检查 boot 分区 FAT32 文件系统应显示 boot.img、dtbo.img 等 ext4ls mmc 0:2 # 检查 vendor 分区 ext4应列出 vendor/bin/ 目录若mmc part返回no partition table说明烧写时未写入 GPT 分区表需用rkdeveloptool重烧parameter.txt该文件定义分区布局用户指南未提及但为必烧项。4. 串口调试避坑波特率、线序、电平三重陷阱与排查清单串口是 RK3588S EVB 最基础的调试通道但也是翻车率最高的环节。用户指南 1.7 节虽有图1-9 配置界面却未揭示三个致命陷阱波特率硬编码、TTL 电平混淆、UART 引脚复用冲突。以下是某公司硬件团队踩过的 5 个具体坑按“现象→原因→解决”结构整理每条均可直接复现。4.1 现象串口输出乱码但stty -F /dev/ttyUSB0显示波特率正确原因RK3588S 的 UART2EVB 板载调试串口默认使用 1500000 波特率但某些 USB-TTL 转接板如 CH340G 方案在 1000000 波特率下存在采样误差导致接收端误判起始位。解决更换为 CP2102 或 FT232RL 方案的转接板或在 U-Boot 源码中修改configs/rk3588s_evb_defconfig的CONFIG_BAUDRATE1500000为1000000重新编译uboot.img。4.2 现象串口无任何输出万用表测 TX 引脚电压为 0V原因RK3588S EVB 的 UART2 TX 引脚PIN2 of LCD座在硬件设计上串联了一个 100Ω 电阻R123若该电阻虚焊或阻值漂移TX 信号无法驱动。用户指南图2-3 未标注此电阻。解决用万用表二极管档测 R123 两端正常应导通压降 ~0.5V若开路补焊或更换 100Ω 0402 电阻。4.3 现象串口能收到数据但发送命令无响应如敲 h 无 help 输出原因USB-TTL 转接板的 RTS/CTS 流控引脚被错误连接。RK3588S UART2 的 RTS请求发送引脚在 U-Boot 中默认启用硬件流控若转接板 RTS 悬空或接地U-Boot 会等待 RTS 有效才发送。解决断开转接板 RTS 引脚或用跳线将其悬空或在 U-Boot 命令行执行setenv stdout serial; setenv stdin serial; saveenv禁用流控。4.4 现象Windows 下串口工具能收到输出但 Linux 下cat /dev/ttyUSB0无输出原因Linux 内核的ch341驱动用于常见 CH340 转接板在高波特率下存在 FIFO 缓冲区溢出 bug数据被丢弃。解决升级内核至 5.15已修复或临时禁用 FIFOecho 0 | sudo tee /sys/bus/usb-serial/devices/ttyUSB0/device/bInterval。4.5 现象串口输出正常但 ADBdevices命令无设备dmesg显示usb 1-1: device descriptor read/64, error -71原因USB Type-C 线缆仅支持充电VBUS/GND 通D/D- 断而 RK3588S EVB 的 USB OTG 功能需 D/D- 通信。用户指南图1-11 的 ADB 连接图未强调线缆要求。解决更换为带数据传输标识的 Type-C 线如线身印有 “USB 2.0 Data”或用 USB-A 转 Type-C 线确保内部 D/D- 连通。5. ADB 与 Android 调试深度打通从设备识别到 root shell 的七步链路用户指南 1.7.2 节仅有一张图1-11 显示“ADB 连接正常”但未说明如何从零开始建立 ADB 调试链。实际上RK3588S EVB 的 ADB 依赖完整的 Android 启动栈U-Boot → Kernel → init → adbd daemon。任何一环缺失都会导致adb devices为空。以下是经过某跨平台系统项目验证的七步链路每步均需独立验证。5.1 步骤一确认 Kernel 启动参数含androidboot.usbconfigon在 U-Boot 命令行执行printenv bootargs输出中必须包含androidboot.usbconfigon。若缺失需修改bootargssetenv bootargs consolettyS2,1500000 androidboot.consolettyS2 androidboot.usbconfigon ... saveenv注意ttyS2对应 UART2调试串口ttyS0为 UART0未引出用户指南未明确指定但 RK3588S TRM 表明 UART2 的基地址为0xfe660000与板载调试口物理匹配。5.2 步骤二检查 Kernel 是否加载 USB Gadget 驱动启动进入 Android 后执行adb shell dmesg | grep -i gadget\|usb应返回类似[ 2.123456] usbcore: registered new interface driver usbfs [ 2.124567] usbcore: registered new interface driver hub [ 2.125678] dwc3-rockchip 10000000.dwc3: failed to get clk ref: -2 [ 2.126789] usbcore: registered new device driver usb [ 2.127890] android_usb gadget: android_usb ready若无android_usb gadget行说明 Kernel 编译时未启用CONFIG_USB_ANDROID需重新配置内核。5.3 步骤三验证 adbd daemon 是否运行adb shell ps -A | grep adbd # 正常输出root 1234 1 123456 7890 ? S adbd若无进程检查/system/etc/init.rc中是否含service adbd /system/bin/adbd及class main。5.4 步骤四检查 USB 设备节点权限adb shell ls -l /dev/android_adb # 正常权限crw-rw---- 1 root adb 240, 0 Jan 1 00:00 /dev/android_adb若权限为crw-------需在 init.rc 中添加chmod 0660 /dev/android_adb。5.5 步骤五PC 端 ADB Server 是否识别设备adb kill-server adb start-server adb devices -l # 应返回XXXXXXXXXX device product:rksdk model:RK3588S_EVB device:rksdk transport_id:1若仍为空检查 Windows 设备管理器中是否为Android ADB InterfaceVID 0x18d1, PID 0x0001而非Unknown Device。5.6 步骤六ADB over TCP/IP无线调试备用链路当 USB 不稳定时启用网络 ADBadb tcpip 5555 adb connect 192.168.1.100:5555 # 替换为 EVB 的实际 IPIP 获取方式adb shell ip addr show eth0 | grep inet 5.7 步骤七获取 root shell 并验证系统完整性adb root adb shell su - # 进入 root 后执行 ls /proc/device-tree/soc/usbfe800000/ # 应列出 phy、gadget 等节点 cat /proc/cpuinfo | grep model name # 应返回 Rockchip RK3588S若su失败说明 Android 系统未启用 root 权限需刷入userdebug版本固件用户指南未区分 user/userdebug 版本差异。6. 安全启动与可信执行环境TEE配置基于 RK3588S 的 Secure Boot 实战要点标题中的“安全 RK3588”并非营销话术而是指 RK3588S 芯片内置的硬件级安全机制包括 Secure Boot、TrustZone TEE、Secure Storage。用户指南虽未单列“安全”章节但在 1.1 芯片概述、3.9 Sensor 芯片、3.12 JTAG 接口等分散位置埋有关键线索。某图像处理 Demo 项目曾因忽略 Secure Boot 配置导致量产固件被篡改以下是从用户指南碎片信息中提炼出的四条实战要点。6.1 Secure Boot 启用前提eMMC Boot Partition 必须设置为 Write-ProtectRK3588S 的 Secure Boot 要求boot分区LBA 0x00000000 开始处于硬件写保护状态否则 ROM 代码拒绝验证签名。用户指南 3.2 节提到“eMMC 位置”图3-2但未说明 Boot Partition 的特殊性。启用写保护命令在 U-Boot 下执行# 先确认当前 eMMC 状态 mmc dev 0 mmc info # 设置 Boot Partition 1 为 Write-Protect mmc write_protect 0 1 1 # 验证返回 Write protect status: 0x00000001 表示已启用 mmc write_protect 0 1 0注意write_protect 0 1 1中的1表示 Boot Partition 1RK3588S 默认使用 BP1 存放loader.bin1表示启用。此操作不可逆除非物理短接 eMMC 的 WP 引脚。6.2 TEE OSOP-TEE加载路径与调试接口RK3588S 支持 OP-TEE 作为 TEE OS其镜像tee.bin必须烧写至 eMMC 的特定偏移。用户指南 1.6.2 节固件升级方式隐含此路径loader.bin加载uboot.imguboot.img再加载tee.bin。标准烧写偏移需与parameter.txt一致分区名起始 LBA镜像文件用户指南对应位置bootloader0x00000000loader.bin图1-6 烧写模式trust0x00040000tee.bin3.9 节 Sensor 芯片旁注明“Secure Storage 由 TEE 管理”boot0x00080000boot.img图1-6验证 TEE 是否运行adb shell dmesg | grep -i optee # 正常输出[ 3.456789] optee: probing for conduit method. # [ 3.457890] optee: initialized driver6.3 JTAG 调试安全锁出厂默认关闭需专用密钥解锁用户指南 3.12 节仅标注“JTAG 接口位置”但未说明 RK3588S 的 JTAG 在 Secure Boot 启用后默认锁定。某公司曾因强行连接 J-Link 导致芯片变砖。解锁流程需瑞芯微授权向 Rockchip FAE 申请jtag_unlock_key.bin绑定芯片 UID在 MASKROM 模式下用rkdeveloptool烧写密钥sudo rkdeveloptool ef jtag_unlock_key.bin重启后JTAG 接口方可被 OpenOCD 识别。6.4 安全启动日志解析从串口输出定位签名验证失败点Secure Boot 失败时串口会输出特定错误码。用户指南未提供解码表但根据 RK3588S TRM关键日志如下串口日志片段含义解决方案SB: Verify image fail at 0x...loader.bin签名验证失败检查签名密钥是否与烧写工具rkbin/tools/rk_sign_tool匹配SB: No valid image foundeMMC Boot Partition 无有效镜像用rkdeveloptool重烧loader.bin至 LBA 0SB: Invalid signature length签名长度不匹配如 RSA2048 签名填入 RSA4096 槽位修改parameter.txt中loader分区大小为0x40000256KB从那以后我每次做 RK3588S EVB 固件交付都强制走一遍rkdeveloptool ldlist device→rkdeveloptool rlread loader→hexdump -C校验 loader 头部魔数0x524b4c44RKLD ASCII再执行烧写。这三步耗时不到 10 秒却能避开 80% 的“固件烧不进”客诉。希望帮到你。本文还有配套的精品资源点击获取
