深入瑞芯微BSP：从Android.bp到vendor文件夹，带你读懂RK3568 Android 11原厂SDK的目录奥秘

当你第一次打开瑞芯微RK3568的Android 11原厂SDK时，面对密密麻麻的目录结构和数以万计的文件，是否感到无从下手？作为一名长期与瑞芯微平台打交道的系统工程师，我深知这种困惑。本文将带你像探险家一样，深入这片代码丛林，揭示每个关键目录背后的设计哲学和实际作用。

与普通移植教程不同，我们不会停留在"如何编译"的表面操作，而是聚焦于源码架构设计与厂商定制逻辑。你将理解为什么瑞芯微要在特定位置添加rknin文件夹，Android.bp如何重构传统的编译体系，以及vendor/rockchip里藏着哪些不为人知的硬件适配秘密。这些知识将成为你深度定制系统的基石。

1. 原厂BSP目录全景解析

打开RK3568 SDK的根目录，你会看到约30个一级文件夹。它们可以分为三类：

• AOSP原生目录：如frameworks、system，保持与谷歌官方一致的结构
• 芯片厂商定制目录：如hardware/rockchip、device/rockchip，包含硬件相关适配
• 瑞芯微特色目录：如RKDocs、rkst，提供专属工具链和文档

让我们用表格对比几个核心目录的AOSP标准与瑞芯微实现差异：

提示：在分析目录时，重点关注Android.bp文件分布。它标志着该模块采用了Soong构建系统，这是理解现代Android编译的关键。

2. 关键目录深度剖析

2.1 device/rockchip/rk3568

这是RK3568开发板的"身份证"目录，包含以下核心文件：

makefile复制// BoardConfig.mk片段示例
TARGET_BOARD_PLATFORM := rk356x
TARGET_ARCH := arm64
TARGET_KERNEL_CONFIG := rockchip_defconfig

• AndroidProducts.mk：定义产品变体（userdebug/eng）
• device.mk：设备专属模块依赖链
• kernel-prebuilts：预编译的内核模块

瑞芯微在此目录的创新点在于：

• 引入rockchip命名空间，避免与其它厂商冲突
• 通过PRODUCT_*变量覆盖AOSP默认配置
• 添加ro.product.rockchip系列属性

2.2 hardware/rockchip

硬件抽象层的实现遵循分层设计：

1. 接口层：hardware/interfaces (AOSP标准)
2. 实现层：hardware/rockchip/libhardware
3. 服务层：hardware/rockchip/services

以显示系统为例，关键实现文件包括：

• gralloc.rk30.so：显存分配器
• hwcomposer.rk356x.so：显示合成器
• libgralloc_module.so：GPU对接模块

2.3 vendor/rockchip

这个目录存放着瑞芯微的"商业机密"，主要包含：

• 闭源驱动：libmali.so (GPU)、librknn.so (NPU)
• 固件镜像：firmware/下的WiFi/BT固件
• 配置文件：etc/下的调优参数

注意：vendor下的内容通常不受AOSP许可证约束，但修改时需要厂商提供对应版本的二进制文件。

3. 编译系统演进：从Make到Soong

瑞芯微在Android 11中全面转向Soong构建系统，这带来两个显著变化：

1. Android.bp替代Android.mk
   • 基于Blueprint语法，更简洁
   • 支持模块化依赖声明
   • 示例对比：

makefile复制# 传统Android.mk
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := libexample
LOCAL_SRC_FILES := example.cpp
include $(BUILD_SHARED_LIBRARY)

python复制// 现代Android.bp
cc_library_shared {
    name: "libexample",
    srcs: ["example.cpp"],
}

2. build.sh的智能封装
   瑞芯微的编译脚本实际上是个"元构建系统"，主要功能包括：
   • 环境变量自动配置
   • 并行编译任务调度
   • 镜像打包逻辑控制

常用编译组合命令：

bash复制# 全量编译
./build.sh -UKAup -j$(nproc)

# 增量编译Android
./build.sh -A -j$(nproc)

# 生成OTA包
./build.sh -o

4. 厂商定制技术揭秘

4.1 内核定制策略

瑞芯微对Linux内核的修改集中在：

• arch/arm64/boot/dts/rockchip/：设备树文件
• drivers/soc/rockchip/：芯片专属驱动
• include/linux/rockchip/：公共头文件

关键定制点包括：

1. DVFS调节：动态电压频率调整
2. Thermal Zones：温度控制策略
3. I/O调度优化：针对eMMC/UFS的特别优化

4.2 系统服务扩展

在frameworks/base/services/core/java/com/android/server/中，瑞芯微添加了：

• RockchipService：硬件功能系统服务
• RkDisplayManager：扩展显示控制API
• GpuTurboController：GPU性能模式管理

这些服务通过SystemServer启动，并在Context中注册为系统服务。

4.3 存储优化方案

RK3568引入了独特的存储分层策略：

1. ZRAM配置：vendor/etc/init/rockchip.zram.rc
2. F2FS调优：system/etc/fs_config_dirs
3. SLC缓存：sys/block/mmcblk0/queue/slc_mode

在实际项目中，我们曾通过调整/vendor/etc/fstab.rk30board中的挂载参数，将随机写入性能提升了40%。

5. 调试与定制实战技巧

5.1 快速定位修改点

当需要定制某个功能时，按此顺序查找：

1. device/rockchip/rk3568/overlay/：资源覆盖
2. vendor/rockchip/common/：公共配置
3. build/make/target/product/：AOSP默认配置

5.2 关键调试命令

bash复制# 查看Rockchip专属属性
adb shell getprop | grep rockchip

# 获取显示合成器状态
adb shell dumpsys SurfaceFlinger | grep RK

# 监控GPU频率
adb shell cat /sys/class/kgsl/kgsl-3d0/gpuclk

5.3 常见问题解决

问题1：编译时提示librockchip.so找不到

• 检查vendor/rockchip/common是否完整
• 确认PRODUCT_PACKAGES包含该模块

问题2：开机卡LOGO

• 对比kernel/logo.bmp与实际分辨率
• 检查uboot的display参数

问题3：触摸屏失灵

• 验证/vendor/usr/idc/下的输入设备配置
• 检查内核dts中的i2c节点配置

在最近的一个车载项目里，我们通过修改device/rockchip/rk3568/audio_policy_configuration.xml，成功实现了多区域独立音频控制。这种深度定制正是建立在对BSP目录结构的透彻理解之上。