1. Rockchip Android13 GKI开发入门指南第一次接触Rockchip Android13 GKI开发时我完全被各种新概念和流程搞懵了。经过几个项目的实战我总结出了这套适合新手的完整开发指南。GKIGeneric Kernel Image是Google为了解决Android内核碎片化问题推出的通用内核映像方案对于需要过GMS认证的产品来说这是必须掌握的开发技能。在Rockchip平台上进行GKI开发最大的特点就是内核和驱动模块分离。核心内核由Google统一维护我们只能通过标准接口来开发驱动模块。这种模式虽然限制了内核修改的自由度但带来了更好的兼容性和维护性。我刚开始不太适应这种开发方式但后来发现这种约束反而让驱动开发更加规范。目前Rockchip已经完成了RK3588/RK3588S、RK3568/RK3566等主流芯片的GKI适配工作。如果你是第一次接触GKI开发建议从RK3588平台开始它的文档和社区支持都比较完善。在开始具体开发前建议先准备好以下环境开发板建议使用官方EVB开发板SDK版本Android13 T版本开发主机Ubuntu 20.04 LTS及以上版本存储空间至少500GB可用空间2. 开发环境搭建与代码获取搭建GKI开发环境比传统Android开发要复杂一些。我建议先配置好代理因为需要从Google仓库下载大量代码。第一次编译时我因为网络问题反复失败了好几次后来发现使用全局代理可以解决大部分下载问题。获取代码主要分为两部分Rockchip SDK和Google upstream kernel。Rockchip SDK可以通过公司内部git仓库获取而Google kernel则需要通过repo命令下载repo init -u https://android.googlesource.com/kernel/manifest -b common-android13-5.10 repo sync -j8这里有个小技巧可以先在本地创建一个仓库镜像后续同步就会快很多。我在公司内网搭建了一个镜像服务器同步时间从原来的几小时缩短到十几分钟。编译环境配置也很关键。除了标准的Android开发工具外还需要特别注意以下几点安装最新版本的clang工具链建议r450784d及以上安装LLVM相关工具llvm-objcopy等准备足够的内存建议32GB以上配置ccache加速编译3. GKI代码结构与编译流程Rockchip的GKI代码结构与非GKI版本有显著差异。最核心的变化是引入了mkcombinedroot目录这里存放了所有预编译的KO模块和Google官方boot.img。我第一次看到这个结构时很困惑后来才明白这是GKI架构的核心设计。关键目录说明mkcombinedroot/prebuilts/boot-5.10.imgGoogle官方GKI boot镜像mkcombinedroot/vendor_ramdisk/lib/modules/预编译的KO模块存放位置mkcombinedroot/res/KO模块加载配置文件完整的编译流程如下source build/envsetup.sh lunch rk3588_t-userdebug ./build.sh -ACUKup这个编译过程会持续几个小时我第一次编译时因为没加-j参数整整等了一晚上。建议根据CPU核心数设置合适的并行编译参数比如24核机器可以用-j24。编译完成后在rockdev/Image-rk3588_t/目录下会生成完整的固件包。这里特别要注意的是GKI版本的固件包含了几个新分区vendor_boot存放vendor ramdisk和KO模块init_boot存放initramfssuper动态分区镜像4. 驱动开发与KO模块调试在GKI架构下所有硬件驱动都必须以KO模块的形式存在。这给驱动开发带来了新的挑战我刚开始移植一个触摸屏驱动时就遇到了各种问题。添加新驱动模块的标准流程将驱动代码放到kernel对应目录如drivers/input/touchscreen/添加Makefile和Kconfig配置创建或修改xxx_gki.config文件添加CONFIG_DRIVER_NAMEm将KO文件名添加到对应的.load文件.load文件的选择很有讲究我总结出以下经验必须在init阶段加载的驱动如电源管理放在vendor_ramdisk_modules.load可以在Android启动后加载的驱动放在vendor_modules.load恢复模式需要的驱动放在recovery_modules.load编译KO模块时我强烈建议使用llvm-objcopy剥离调试信息llvm-objcopy --strip-debug drivers/input/touchscreen/gt1x/gt1x-ts.ko ../mkcombinedroot/vendor_ramdisk/lib/modules/gt1x-ts.ko这样可以显著减小KO文件大小加快加载速度。我在一个项目中通过这个方法将启动时间缩短了约15%。调试KO模块时最常见的错误是符号未定义。这是因为GKI内核只暴露了有限的API接口。遇到这种情况可以检查是否使用了非标准内核API查看android/abi_gki_aarch64_rockchip文件确认可用API必要时通过Redmine向Rockchip提交API扩展需求5. 常见问题排查与解决在实际项目中我遇到过各种GKI特有的问题。这里分享几个典型案例和解决方法。案例1KO加载失败现象系统启动卡住串口日志显示Unknown symbol错误 解决方法检查驱动使用的内核API是否在ABI白名单中确认KO文件是否正确剥离了调试信息检查.load文件中模块加载顺序是否正确案例2Mali GPU驱动加载失败现象系统启动后卡在Logo界面surfaceflinger崩溃 解决方法确认PRODUCT_KERNEL_CONFIG中包含了正确的GPU配置检查vendor/rockchip/common/gpu下是否有对应平台的KO文件确保GPU KO文件版本与内核版本匹配案例3bootconfig解析失败现象系统无法启动提示Failed to parse bootconfig 解决方法在uboot阶段按CtrlP打印完整cmdline检查是否有重复的参数定义检查device和dts中的cmdline配置案例4内核编译卡在LTO优化现象编译过程长时间无响应 临时解决方案 修改gki_defconfig将CONFIG_LTO_CLANG_FULL改为CONFIG_LTO_CLANG_THIN 长期解决方案升级Ubuntu到20.04以上版本安装最新版pahole工具6. 性能优化与调试技巧经过几个GKI项目的磨练我总结出一些实用的优化技巧启动时间优化精简vendor_ramdisk_modules.load只保留必要的驱动使用llvm-objcopy --strip-debug减小KO文件大小优化KO加载顺序将关键路径驱动前置内存占用优化检查/proc/modules移除不必要的KO模块调整内核参数如vm.min_free_kbytes使用slabtop分析内核内存使用情况调试技巧在cmdline中添加printk.devkmsgon获取详细日志使用dynamic_debug动态开启驱动调试信息通过sysfs接口调整驱动参数一个特别有用的技巧是单独编译vendor_boot.img进行快速验证make installclean make vendorbootimage -j24这样只需几十秒就能完成编译大大提高了调试效率。7. GKI与非GKI的主要差异在从传统开发转向GKI开发时需要特别注意以下差异点内核修改限制GKI只能修改设备树和添加KO模块非GKI可以自由修改内核任何部分驱动开发方式GKI驱动必须编译为KO使用标准内核接口非GKI驱动可以静态编译进内核可以使用非标准接口系统分区GKI新增vendor_boot、init_boot等分区非GKI使用传统的boot、system等分区认证要求GKI强制要求通过GMS认证非GKI无强制认证要求兼容性问题GKI同一I2C总线不能注册相同地址的设备非GKI可以注册相同地址的设备在实际项目中这些差异可能会导致一些意想不到的问题。比如我曾经遇到一个摄像头驱动在非GKI版本工作正常但在GKI版本就无法使用的情况。后来发现是因为GKI版本对同一I2C总线上相同地址的设备支持有限制。8. 进阶开发与上游提交当项目需要添加新的内核接口时就需要走upstream提交流程。这个过程相当漫长我第一个接口提交花了近3个月才被合并。标准提交流程在本地生成接口patch通过Rockchip Redmine系统提交审核Rockchip工程师审核后提交给GoogleGoogle内核团队review合并到官方代码库提交patch时需要注意遵循内核编码规范提供完整的commit message包含必要的测试用例说明接口的必要性和使用场景一个典型的接口添加patch如下diff --git a/android/abi_gki_aarch64_rockchip b/android/abi_gki_aarch64_rockchip index 85bd8bc..3344cf0 100644 --- a/android/abi_gki_aarch64_rockchip b/android/abi_gki_aarch64_rockchip -2144,6 2144,15 mmc_pwrseq_register mmc_pwrseq_unregister # required by r8168.ko pci_set_mwi pci_clear_mwi proc_get_parent_data skb_checksum_help __skb_gso_segment remove_proc_subtree pci_choose_state # required by reboot-mode.ko devres_release kernel_kobj建议提前规划好接口需求因为这个流程耗时很长。我在一个网络驱动项目中因为没提前规划导致项目延期了两周。