简介《Rockchip RK3229 软件开发指南 V1.03》是瑞芯微面向软件开发工程师与技术支持工程师发布的芯片开发调试技术文档针对 RK3229 平台在 Linux3.10 内核下适配 Android 6.0.1 与 7.1.2 的开发需求系统梳理了从硬件兼容性到系统配置的关键信息。文档涵盖 DDR、NAND、EMMC、WiFi/BT 及多媒体编解码支持列表SDK 软件包适用硬件说明以及 system 分区大小配置、ODEX 预编译、禁用 SELinux、Jack-server 配置、USB 默认开启 ADB、开机视频与低内存优化、DRM WIDEVINE level 1 配置等开发者特性并附工具版本更新、开机 logo 限制与序列号/Mac 烧写工具说明。资源包为 1 个 PDF 文件大小约 1.61MB单文件即完整覆盖开发流程各环节便于按章节检索查阅。目前已有 627 人学习下载适合需要快速上手 RK3229 开发与调试的工程师作为案头参考。1. 一份 2017 年的 RK3229 开发指南为什么现在还有人翻出来用手里攥着一块 RK3229 的电视盒子板子串口能出 log但 SDK 编译报错、烧写工具认不到设备、WiFi 模块加载不起来——这种场景下最省时间的做法不是去翻论坛零散帖子而是找一份当年原厂给开发工程师看的开发指南。这份《Rockchip RK3229 软件开发指南 V1.03》就是干这个的它把 SDK 获取、编译、烧写、U-Boot、内核 DTS、Android 常见配置、系统调试工具、量产工具串成一条线覆盖 Linux3.10 Android6.0.1/7.1.2 两套组合。适合谁手上还有 RK3229 存量板子要做维护、二次开发、产测工装或者想拿它当 Android 系统裁剪与嵌入式 Linux 调试的练手素材的工程师。它不是教程是查得到参数、对得上工具版本的操作底稿。2. 先看支持列表再动手DDR、NAND、eMMC、WiFi 的选型边界很多人拿到 SDK 第一件事就是make结果编译过了、烧进去起不来最后发现是 DDR 颗粒不在支持列表里。这份文档第 1 章的价值就在这——它把「能不能跑」的前置条件先摆出来而不是等你烧废三块板子再回头查。2.1 DDR 与存储颗粒符号含义比型号本身更重要RK3229 支持 DDR3、LPDDR2、LPDDR3 三类 DRAM。文档里给了一张符号表这个符号体系是后面所有支持列表的通用语言符号含义能不能用√完整测试且已量产优先选T/A完整测试可适用可用量产前建议小批验证D/A仅数据手册适用需送样测试不要直接上量产N/A不适用直接排除NAND 和 eMMC 用的是同一套符号逻辑只是 eMMC 多一条硬指标RK3229 支持 eMMC 4.51、SDIO3.0、HS200 模式。文档里明确建议选顺序读 200MB/s、顺序写 40MB/s 的颗粒这个数字不是拍脑袋——Android 系统分区读写频繁低速 eMMC 会直接把开机时间和应用启动拖垮。我一般会在选型阶段就把厂商 datasheet 的 performance 章节翻出来对一遍别等系统跑起来再用dd测。具体型号要去RKDocs/Platform support lists目录下查对应的支持列表文档文档本身只给符号规则和筛选建议不重复贴全表。2.2 WiFi/BT 与多媒体能力驱动版本是硬门槛WiFi/BT 这块有个容易被忽略的点RK3229 内核是 Linux3.10如果选的 WiFi 芯片原厂只提供更高版本内核的驱动那就不是改改 DTS 能解决的得让原厂补 3.10 的驱动。文档建议按支持列表里的型号选型本质是降低驱动适配成本。多媒体规格值得单独记一下因为它决定了你这块板子能做什么产品解码4K VP9、4K 10bit H265/H264最高 60fps1080P 多格式VC-1、MPEG-1/2/4、VP8JPEG 解码编码1080P H.264JPEG 编码KodiOMX 框架支持官方 16.1 Jarvis 和 17.0 KryptonSDK 默认集成的是基于 16.1 深度优化的 RKMC 版本支持 H265/H264/VP9 10bit60fps 硬解、ISO/MKV Framepacking MVC3D、AC3/EAC3/TrueHD/DTS 最高 7.1 声道透传如果你做的是播放器类产品RKMC 和官方 Kodi 的差异要提前想清楚RKMC 偏硬件加速和透传官方版偏插件生态二者不是简单替换关系。2.3 SDK 适用硬件与内核配置入口SDK 是基于 Android6.0.1 及之后版本的 32bit 系统适配 RK3229 Box EVB 开发板和 Box 样机板。内核配置的改动入口是RK3229-box.dts硬件设计参考文档在RKDocs/Platform support lists/RK322X 硬件设计指南下。这一步的意义在于你后面所有 DTS 修改都应该以这个文件为基线而不是自己从零写一个。3. SDK 编译与烧写从源码到固件的完整链路支持列表确认完才轮到编译。这一章是整份文档里操作密度最高的部分也是翻车最集中的地方。文档对应第 3 章覆盖 SDK 获取、编译、固件烧写、量产烧写四段。3.1 编译环境与 jack-server 配置Android 7.1 引入 jack 编译工具链后jack-server 的配置成了编译能否跑通的关键。文档 V1.02 版本专门补了这一节说明当年这个问题坑了不少人。常见做法是先确认 jack 服务端和客户端的端口配置一致再调并发数# 查看 jack 配置确认服务端端口 cat ~/.jack-settings # 典型配置项按机器内存调整 # SERVER_PORT_SERVICE8072 # SERVER_PORT_ADMIN8073 # ANDROID_JACK_VM_ARGS-Dfile.encodingUTF-8 -XX:TieredCompilation -Xmx4G逻辑说明SERVER_PORT_SERVICE和SERVER_PORT_ADMIN是 jack 服务端监听端口多用户或多任务并行编译时端口冲突会导致编译中途挂掉ANDROID_JACK_VM_ARGS里的-Xmx4G是给 jack 的 JVM 堆上限机器内存 8G 以下建议压到 2G3G否则容易触发 OOM 把编译进程杀掉。改完配置要重启 jack 服务再编译不然读的还是旧参数。3.2 分区大小、odex 预编译与 SELinux 开关这三个配置在文档 3.2.6 节属于「编译前必须定下来」的参数因为改分区往往要动 parameter 文件改完得重新烧写。system 分区大小配置直接决定你能预置多少 APK 和系统资源。odex 预编译配置影响首次开机速度——预编译成 odex 可以减少开机时的 dex 优化时间代价是 system 分区占用变大。禁用 SELinux 的方法文档也给了但要注意这只适合调试阶段量产固件不建议长期关着否则应用层的权限问题会被掩盖等到产测阶段才暴露就麻烦了。# 编译前确认分区参数文件中的 system 分区大小单位通常为扇区 grep -n system parameter.txt # 全量编译入口具体 lunch 目标以 SDK 内实际配置为准 source build/envsetup.sh lunch make -j8参数说明-j8的并发数按 CPU 核心数给一般取核心数的 11.5 倍内存不足时并发越高越容易在链接阶段被 OOM killer 干掉表现是编译到一半突然退出、没有明确报错这时候先降-j再看。3.3 固件烧写与量产烧写工具版本要对得上烧写分两档单板调试用 Android 开发工具量产用量产工具。文档 2.2 节维护了一份工具版本列表V1.03 还更新过这份列表——这不是形式主义烧写工具和固件格式不匹配时表现往往是「设备能被识别但烧写进度卡在某个百分比」或者干脆认不到 loader 设备。单板烧写的典型流程是设备进 loader 模式 → 开发工具识别 → 选择固件 → 执行升级。量产烧写则要配合产测工装文档 8.9 节有量产工具使用说明8.10 节是 Box 厂测工具。这里有个血泪经验调试阶段和量产阶段用的工具不要混调试工具带很多交互确认量产工具追求的是无人值守批量刷混用会导致产线节拍对不上。4. U-Boot 与内核配置logo、DTS、GPIO 与温控固件能烧进去只是第一步板子起不起来、外设能不能用取决于 U-Boot 和内核配置。文档第 4、5 章就是这块内容不算多但每一条都是高频改动点。4.1 U-Boot logo 配置与开机 logo 限制U-Boot 阶段就要显示开机 logo相关配置在文档 4.5 节V1.03 还补了 4.5.2 的开机 logo 限制描述。常见做法是把 logo 图片按平台要求的分辨率和格式处理好再通过打包脚本塞进 resource 分区。这里容易翻车的点是图片格式和尺寸分辨率超出显示能力、或者色彩格式不对表现是开机黑屏几秒然后直接进系统logo 一闪而过甚至完全不显示。U-Boot 编译本身不复杂关键是平台配置要对# 进入 U-Boot 目录后按平台配置编译具体 defconfig 名以 SDK 为准 make rk3229_defconfig make -j8逻辑说明rk3229_defconfig是平台默认配置编译产物需要按 SDK 的打包流程合入固件不能单独烧。改 logo 相关配置后建议先只烧 U-Boot 分区验证别每次都全量烧省时间。4.2 DTS 与 GPIO 对应关系别信引脚编号信原理图内核配置的核心是 DTS文档 5.1 节介绍 DTS5.3 节专门提醒 GPIO 对应关系。这一条值得单独说芯片手册上的 GPIO 编号、DTS 里的 bank/pin 编号、原理图上的网络标号三者经常对不上。我一般会拿原理图 RK322X 硬件设计指南交叉核对再在 DTS 里按gpioX_Y的格式写改完用万用表量电平验证而不是改完就烧。WiFi/BT 的配置也在 DTS 里涉及供电 GPIO、使能脚、SDIO 或 USB 接口的挂载关系。ARM、GPU 频率修改和温控配置在 5.4、5.5 节——频率不是越高越好RK3229 这类盒子芯片散热条件有限温控阈值设得太宽松长时间播放 4K 会触发降频甚至死机表现是「播一会儿就卡」很多人误以为是解码性能不够其实是温控在起作用。4.3 USB 默认打开 adb 调试文档 5.7 节这条对调试效率提升最直接USB 默认打开 adb意味着板子插上就能adb devices不用每次进系统设置里手动开调试。配置方式是在对应属性或 DTS 节点里打开具体位置以 SDK 为准。改完之后如果adb devices还是空列表先查 USB 口是不是 OTG 口、驱动有没有装对再怀疑配置没生效。5. Android 层配置与系统调试预置 APK、OTA、低内存与 DRM到了 Android 层改动点更碎但文档第 6、7 章基本把高频需求都覆盖了。这一章挑几个实际项目里绕不开的说。5.1 预置 APK、开机动画与新增分区预置 APK 在 6.3 节常见做法是放进packages/apps或厂商预置目录再在编译配置里声明。要注意的是预置带 so 库的 APK 时库文件要按 ABI 放对目录否则装上了也起不来。开/关机动画及铃声在 6.4 节和 U-Boot logo 一样格式和分辨率对不上就是黑屏或无声。新增分区配置在 6.6 节配合 parameter 说明6.5 节一起看。新增分区不是改一个文件就完事parameter 里要加分区定义分区表要同步文件系统挂载点也要在 fstab 里补。漏掉任何一环表现都是分区存在但挂不上或者挂上了但权限不对。5.2 OTA 升级与系统灾难恢复OTA 在 6.7 节系统灾难恢复在 6.9 节。这两块建议一起设计OTA 包签名、升级失败回滚、恢复模式入口是一套东西。文档 8.6 节还有固件签名工具量产固件必须签名否则升级校验过不去。灾难恢复的价值在于——调试阶段改坏了系统分区还能靠恢复模式救回来不用拆机短接。5.3 Android 7.1 的三个专项开机视频、低内存优化、Widevine Level 1V1.03 新增的 6.116.13 三节都是 Android 7.1 才有的配置开机视频替换静态 logo注意视频编码格式和播放时机配不好会拖慢开机低内存优化针对小内存机器调整内存回收策略和后台进程限制参数调过头会导致应用频繁被杀DRM Widevine Level 1流媒体产品绕不开Level 1 要求内容解密和渲染都在安全环境里完成配置涉及 TA、密钥注入和 OMX 组件不是改个属性就能过认证5.4 调试工具四件套adb、logcat、procrank、dumpsys文档第 7 章这四个工具是排查问题的基本盘。adb连不上先查 USB 和驱动logcat看应用崩溃和系统异常procrank看进程内存分布定位内存泄漏比dumpsys meminfo更直观dumpsys查系统服务状态。音视频问题还有专门的调试工具和文档在 7.5 节。# 按内存占用排序查看进程定位内存大户 adb shell procrank | head -20 # 抓取指定进程的 log 并落盘方便回看 adb logcat -v threadtime | grep -i 关键字逻辑说明procrank输出里重点看 PSS 和 USS 两列USS 是进程独占内存持续上涨基本就是泄漏logcat加-v threadtime能带上线程和时间戳排查时序问题比默认格式好用。6. 工具链与量产落地签名、烧号、打包与厂测的排查清单文档第 8 章是工具大全也是实际项目里最容易出「玄学问题」的地方。这一章按工具用途拆开说最后落到几条踩坑记录上。6.1 update.img 打包、固件签名与 OemToolupdate.img打包8.5 节是把各分区镜像合成一个整包打包脚本对目录结构有要求路径放错就是打包失败或包内容缺失。固件签名8.6 节在打包之后做签名密钥要保管好丢了就没法给已出货设备推 OTA。OemTool8.8 节用于制作 OEM 镜像文档特别强调镜像制作文件夹路径有要求——这个要求不是随便定的工具按固定相对路径找文件路径层级不对就报找不到资源。6.2 序列号/Mac/厂商信息烧写与 Box 厂测WNpctool8.7 节负责烧序列号、Mac 和厂商信息V1.03 更新过这个工具的使用说明。烧号前要先设工具模式模式设错会写不进或写乱。Box 厂测工具8.10 节是 V1.01 新增的用于产线功能测试配合 PCBA 测试工具8.2 节和 StressTest8.1 节组成产测闭环。DDR 测试工具8.3 节在来料检验阶段用能提前筛掉不良颗粒。6.3 常见问题排查五条踩坑记录现象一编译到一半突然退出没有明确报错。原因jack-server 的 JVM 堆上限不够或者make -j并发过高触发 OOM killer。 解决调低ANDROID_JACK_VM_ARGS的-Xmx降-j并发数重启 jack 服务后重编用dmesg确认是否有 OOM 记录。现象二烧写工具能识别设备但进度卡住不动。原因烧写工具版本与固件格式不匹配或 loader 与当前固件不配套。 解决对照文档 2.2 节的工具版本列表换工具确认 loader 是从当前 SDK 编出来的不要混用不同批次的 loader。现象三开机 logo 不显示直接进系统。原因logo 图片分辨率或色彩格式超出平台限制或打包时没进 resource 分区。 解决按 4.5.2 节的限制重新处理图片确认打包脚本输出里有 logo 资源先单烧对应分区验证。现象四WiFi 模块加载失败dmesg里看不到驱动初始化。原因WiFi 芯片驱动不是 Linux3.10 版本或 DTS 里供电/使能 GPIO 配错。 解决找原厂要 3.10 驱动按原理图核对 DTS 的 GPIO 配置用万用表量使能脚电平。现象五播放 4K 一段时间后卡顿重启恢复。原因温控阈值配置过松芯片过热降频。 解决检查 5.5 节的温控配置适当收紧降频触发点同时确认散热设计用logcat和内核 log 确认是否有降频记录。6.4 一个验证习惯改完配置先单分区验证这份文档覆盖的配置项太多全量烧写一次动辄几分钟改一个参数就全量烧时间全耗在等待上。我一般会按改动范围决定烧写粒度只改 U-Boot 相关就单烧 U-Boot 分区只改内核就单烧 boot 分区确认没问题再打整包。整包打包和签名留到版本节点做日常调试不碰。这个习惯是从一次「改了个 DTS 引脚定义全量烧完发现起不来回滚又花半小时」之后养成的。从那以后我每次改 DTS 或分区参数都强制先单分区烧写验证一遍再进整包流程。希望这份拆解能帮到你少走几段弯路。本文还有配套的精品资源点击获取
