1. 拿到板子之后资料到底该从哪里下手刚拿到正点原子RK3588开发板的人十个里有八个会先愣一下。板子做工没得说接口密密麻麻但真正让人抓狂的是——资料在哪官网页面翻了三层网盘链接失效了群里问一句“SDK在哪下”半天没人理。我前后折腾过三块RK3588的板子从最早的资料散落在各种论坛附件里到现在正点原子把文档、源码、工具链打包得相对规整中间踩的坑足够写一本小册子。这篇内容就是把我自己整理资料、搭建环境的完整路径摊开来讲。不管你是刚拆箱的新手还是已经跑过几个Demo想深入底层的老手下面这些内容都能帮你省掉至少两三个晚上的无效搜索。核心关键词就几个正点原子RK3588开发板资料下载、SDK获取、文档体系梳理、工具链配置。我会从资料的整体架构讲起然后逐个拆解文档、SDK、工具、镜像的获取方式和验证方法最后分享几个只有实际用过才会知道的细节。先说一个基本判断正点原子RK3588的资料体系大致分四块——硬件文档、软件开发包SDK、烧录与调试工具、预编译镜像。这四块缺一不可但优先级不同。新手最容易犯的错是一上来就找SDK结果下了几十个G的源码连板子怎么启动都没搞明白。合理的顺序应该是先看硬件文档确认接口和启动方式再拿预编译镜像把板子跑起来然后装工具链最后才是SDK源码的编译和定制。提示正点原子的资料更新频率比较高不同批次的板子可能对应不同的资料版本。拿到板子第一件事是看PCB丝印上的版本号比如V1.2和V1.3对应的设备树文件可能有差异这个后面会细说。2. 正点原子RK3588资料体系的四层结构2.1 硬件文档层原理图和用户手册的正确打开方式硬件文档是很多人忽略的一块觉得“我又不改硬件看原理图干嘛”。但实际调试中串口不通、USB不识别、HDMI没输出这些问题八成要靠原理图来定位。正点原子提供的硬件资料通常包括核心板原理图、底板原理图、PCB封装库、用户手册、接口定义表。用户手册是最先要翻的重点看三章启动模式配置拨码开关怎么拨、串口调试接口哪个口是调试口波特率多少、电源输入要求电压和电流范围。我见过有人用5V/2A的电源带RK3588结果跑高负载直接掉电重启还以为是系统问题。RK3588满负载功耗可以到15W以上电源至少要给到12V/3A这个在手册里写得清清楚楚但就是有人不看。原理图的使用有个技巧不要从头到尾读而是带着问题查。比如你要接一个I2C传感器先在用户手册的接口表里找到对应的I2C总线编号然后在原理图里搜索这个编号就能定位到具体的引脚和上拉电阻位置。正点原子的原理图是按功能模块分页的搜索功能用好了效率很高。2.2 SDK源码层Linux和Android两条线怎么选正点原子RK3588的SDK分为Linux SDK和Android SDK两条主线。Linux SDK基于Rockchip官方的Buildroot或Debian根文件系统Android SDK则是完整的AOSP源码树。两者都包含U-Boot、Kernel、根文件系统三大部分但目录结构和编译方式有差异。Linux SDK的典型目录结构是这样的rk3588_linux_sdk/ ├── u-boot/ ├── kernel/ ├── buildroot/ ├── debian/ ├── device/rockchip/ ├── external/ └── build.shAndroid SDK则多出frameworks/、packages/、vendor/等AOSP标准目录。选择哪条线取决于你的应用场景做工业控制、边缘计算、网络设备Linux SDK更合适裁剪灵活、启动快做人机交互、多媒体终端Android SDK的图形栈和生态更成熟。注意两个SDK的源码包都很大Linux SDK解压后约30-40GBAndroid SDK可能超过100GB。提前确认硬盘空间建议用SSD机械硬盘在编译时IO瓶颈非常明显。2.3 工具链层交叉编译器和烧录工具的分工工具链这块正点原子通常会提供预编译好的交叉编译器放在SDK的prebuilts/目录下。Linux SDK用的是aarch64-linux-gnu-系列Android SDK用的是aarch64-linux-android-系列。不建议自己去网上找编译器版本不匹配会导致链接错误而且排查起来非常痛苦。烧录工具主要是RKDevToolWindows平台和upgrade_toolLinux平台。RKDevTool是图形界面适合新手upgrade_tool是命令行适合批量烧录和自动化脚本。两个工具都需要安装Rockchip USB驱动Windows下如果驱动装不上试试关闭驱动签名强制或者换一个USB口——我遇到过前置USB口供电不足导致设备识别不稳定的情况换到主板后置口就正常了。2.4 预编译镜像层先跑起来再谈定制预编译镜像是最容易被轻视的一块。很多人觉得“我要自己编译不用预编译的”结果SDK编译报了一堆错板子还没跑起来信心先没了。我的建议是先用预编译镜像把板子跑通确认硬件没问题再动SDK。正点原子提供的预编译镜像通常包括Buildroot镜像、Debian镜像、Android镜像以及对应的分区表文件和烧录配置。烧录时注意区分整包烧录和分区烧录整包烧录会擦除所有数据分区烧录可以只更新kernel或rootfs。第一次烧录用整包后续调试用分区烧录能省不少时间。3. 从官网到本地资料下载的完整链路3.1 官网资料页面的导航逻辑正点原子官网的资料入口在“资料下载”栏目下搜索“RK3588”就能找到对应的产品页面。页面结构一般是产品简介、资料下载、视频教程、常见问题。资料下载区又分为文档资料、源码资料、工具资料、镜像资料几个标签页。这里有个细节不同标签页的资料更新日期可能不同。我遇到过文档资料更新了版本但镜像资料还是旧的导致文档里描述的功能和实际镜像对不上。所以下载时留意每个文件的更新日期尽量用同一批次的资料。网盘下载是另一个痛点。正点原子的资料主要放在百度网盘非会员下载速度感人。我的做法是先下文档和工具体积小镜像和SDK用网盘会员或者找群里的镜像站。有些热心的群友会搭建临时HTTP服务器分流但要注意文件校验下载完对比MD5值避免文件损坏导致烧录失败。3.2 SDK源码包的获取与校验SDK源码包通常以压缩分卷的形式提供比如rk3588_linux_sdk.tar.gz.001、.002、.003。下载完所有分卷后用cat命令合并再解压cat rk3588_linux_sdk.tar.gz.* rk3588_linux_sdk.tar.gz tar -xzf rk3588_linux_sdk.tar.gz解压后第一件事是校验完整性。正点原子一般会提供一个md5sum.txt文件用md5sum -c md5sum.txt检查。如果某个文件校验失败重新下载对应的分卷不要抱有侥幸心理——损坏的源码包在编译时可能报出莫名其妙的错误浪费的时间远超重新下载的时间。提示解压SDK时用tar -xzf而不是tar -xvf后者会输出大量文件名拖慢解压速度。如果硬盘空间紧张可以边解压边删除分卷包。3.3 工具链和烧录工具的版本匹配工具链的版本匹配是个隐形坑。正点原子RK3588的Linux SDK通常要求GCC 10.3或更高版本的交叉编译器如果你用了旧版的aarch64-linux-gnu-gcc编译U-Boot时可能报unrecognized command line option错误。SDK的prebuilts/gcc/目录下一般有配套的编译器直接用它不要自己另找。烧录工具也有版本要求。RKDevTool的版本要和板子的Loader版本匹配旧版工具可能识别不了新板子。正点原子资料包里通常会附带推荐版本的RKDevTool用这个版本最稳妥。如果工具识别不到设备先检查驱动再检查USB线——有些USB线只有充电功能没有数据传输能力这个坑我踩过不止一次。4. 资料到手后的环境搭建与验证4.1 串口调试环境的搭建串口是调试RK3588最基本的工具。正点原子板子上通常有一个Type-C调试口或者3Pin排针对应UART2。连接方式板子调试口接USB转串口模块模块接电脑电脑上打开串口终端Windows用MobaXterm或SecureCRTLinux用minicom或picocom。串口参数波特率1500000、数据位8、停止位1、无校验、无流控。注意RK3588的调试串口波特率是1.5M不是常见的115200。我第一次连的时候用115200看到一堆乱码还以为板子坏了。改成1500000之后U-Boot和Kernel的启动日志正常输出。# Linux下用picocom连接串口 picocom -b 1500000 /dev/ttyUSB0如果串口没有输出检查三个地方拨码开关是否在正确位置通常是eMMC启动、串口线TX/RX是否交叉、板子是否正常供电。这三个都确认了还没输出再考虑是不是Loader损坏需要重新烧录。4.2 网络与ADB连接配置板子跑起来之后网络和ADB是常用的调试通道。网络配置有两种方式有线网口和WiFi。有线网口插上网线系统通常会自动获取IP如果路由器开了DHCP。如果没有自动获取手动配置# 查看网口名称 ip link show # 手动配置IP ip addr add 192.168.1.100/24 dev eth0 ip link set eth0 upADB连接在Android系统下是标配Linux系统下需要确认adbd服务是否启动。连接方式板子的Type-C口接电脑电脑上adb devices应该能看到设备。如果看不到检查adb版本是否太旧或者板子的USB模式是否配置为Device模式。注意RK3588的Type-C口可能同时支持烧录和ADB但需要正确的配置。如果ADB识别不到试试换一个USB口或者检查设备树里usbdrd节点的配置。4.3 预编译镜像的烧录验证烧录预编译镜像用RKDevTool。步骤板子进入Loader模式按住Recovery键再上电或者通过串口发送reboot loaderRKDevTool识别到设备选择烧录配置文件和镜像点击执行。烧录完成后串口应该能看到完整的启动日志最后停在登录提示符。Linux系统默认用户名root密码rockchip或123456具体看镜像说明。Android系统首次启动会比较慢耐心等几分钟。验证硬件功能USB口插U盘看能否识别HDMI接显示器看是否有输出网口ping外网看是否通音频用aplay播放测试文件。这几个都正常说明板子和镜像都没问题可以开始SDK的编译和定制了。5. 编译SDK时最容易卡住的几个环节5.1 编译环境依赖的安装SDK编译对Ubuntu版本有要求正点原子推荐Ubuntu 20.04或22.04。18.04也能用但某些依赖包版本太旧需要手动升级。编译前先装依赖sudo apt-get install -y git ssh make gcc g libssl-dev \ liblz4-tool expect g-multilib patchelf \ libncurses5-dev libncursesw5-dev bison flex这些依赖缺一不可。我遇到过libssl-dev没装导致U-Boot编译报openssl/ssl.h: No such file装了之后又遇到bison版本太旧导致Kernel的dtc编译失败。所以依赖装完最好检查一下版本bison --version至少3.0以上。5.2 编译脚本的参数选择正点原子RK3588 SDK的编译入口是build.sh参数组合比较多。常用的几个# 查看所有可用配置 ./build.sh lunch # 选择配置文件比如rk3588_defconfig ./build.sh rk3588_defconfig # 编译U-Boot ./build.sh uboot # 编译Kernel ./build.sh kernel # 编译根文件系统 ./build.sh buildroot # 打包整包镜像 ./build.sh firmware第一次编译建议按顺序来先单独编译U-Boot确认工具链没问题再编译Kernel确认设备树配置正确最后编译根文件系统。不要一上来就./build.sh all出了问题很难定位是哪个环节的错。5.3 设备树配置的常见修改点设备树是RK3588开发中最常改的地方。正点原子的设备树文件在kernel/arch/arm64/boot/dts/rockchip/目录下板级设备树通常是rk3588-xxx.dts。常见的修改包括使能/禁用外设、修改引脚复用、调整时钟频率。比如要启用某个I2C控制器在设备树里找到对应的i2cfeab0000节点把status从disabled改成okay然后在下面添加设备子节点。修改完重新编译Kernel烧录后通过/proc/device-tree目录验证配置是否生效。提示修改设备树之前先备份原文件RK3588的设备树节点很多改错一个地方可能导致系统起不来。如果起不来串口日志会停在某个阶段根据日志定位问题节点。6. 资料管理中的几个实用习惯6.1 建立本地资料索引正点原子的资料包解压后目录很多时间一长就忘了哪个文件是干嘛的。我的做法是在资料根目录建一个INDEX.md记录每个目录的内容和关键文件路径。比如## SDK - rk3588_linux_sdk/ # Linux SDK源码 - build.sh # 编译入口 - device/rockchip/rk3588/ # 板级配置 ## 工具 - RKDevTool_v2.84/ # 烧录工具 - DriverAssitant_v5.1.1/ # USB驱动 ## 镜像 - buildroot_image/ # Buildroot镜像 - debian_image/ # Debian镜像这个索引看起来简单但半年后重新捡起项目时能帮你快速找回状态。6.2 版本管理与变更记录SDK源码建议用Git管理。正点原子的SDK本身可能不带.git目录可以自己初始化一个仓库cd rk3588_linux_sdk git init git add . git commit -m initial commit: 正点原子RK3588 Linux SDK之后每次修改设备树或驱动都提交一次写清楚改了什么。这样出问题可以回滚也能对比不同版本的差异。我吃过亏——改了一个引脚配置导致网口不通又没有记录花了半天才找到是哪个文件改错了。6.3 常见问题的快速排查清单整理一份自己的排查清单遇到问题先对照检查现象可能原因排查方法串口无输出波特率错误/拨码开关不对/供电不足确认1500000波特率检查拨码测电压烧录失败驱动未装/Loader损坏/USB线问题重装驱动换USB口换线编译报错依赖缺失/工具链版本不对检查依赖列表用SDK自带工具链系统起不来设备树配置错误/镜像损坏看串口日志重新烧录原镜像ADB识别不到USB模式不对/adb版本旧检查设备树usbdrd节点更新adb这份清单我放在桌面便签上遇到问题先扫一眼能解决八成以上的常见故障。7. 从资料下载到项目落地的个人体会正点原子RK3588的资料体系在国产开发板里算是比较完整的但“完整”不等于“好用”。资料分散在官网、网盘、论坛、群文件多个地方版本更新也不完全同步这是现实情况。我的策略是以官网资料为主群文件为辅论坛帖子作为补充。官网的资料最权威群文件可能有热心网友整理的合集论坛帖子则能提供一些官方文档没写的实战经验。另一个体会是不要追求一次把所有资料都下完。SDK源码几十个G下载加解压可能要一整天但你可能一周内都用不到。先下文档和工具把板子跑起来确定要深入开发了再下SDK。这样节奏更合理也不会因为下载卡住而影响进度。最后说一个细节正点原子的资料包里通常有一个README或者版本说明文件很多人直接跳过。但这个文件里往往写了本次更新的内容、已知问题、注意事项花五分钟读一下能避免很多“为什么文档和实际不一样”的困惑。我在RK3588上跑YOLOv8模型的时候就是先看了版本说明发现NPU驱动需要单独更新省去了自己摸索的时间。