深入瑞芯微RK3568 BSP：从Android.bp到U-Boot，带你读懂原厂SDK的目录玄机
深入瑞芯微RK3568 BSP：从Android.bp到U-Boot，带你读懂原厂SDK的目录玄机
在嵌入式开发领域，真正掌握一款芯片平台的精髓往往不在于能跑通demo，而在于理解其BSP（Board Support Package）的设计哲学。瑞芯微RK3568作为一款中高端AIoT芯片，其Android 11 BSP的目录结构就像一张精心绘制的地图，藏着从硬件抽象到系统集成的全部秘密。本文将带你以"代码考古学家"的视角，拆解那些看似普通的文件夹背后蕴含的工程智慧。
1. 原厂BSP的顶层设计逻辑
当打开RK3568的Android 11 SDK包时，扑面而来的数十个目录可能会让开发者陷入"选择困难"。实际上，这些文件夹的排布遵循着Android开源项目（AOSP）与芯片厂商的双重规范：
- AOSP标准层：
art/、bionic/、frameworks/等目录保持着与谷歌原版的高度一致，这是系统兼容性的基石 - 硬件适配层：
device/、hardware/、kernel/构成了芯片定制的核心三角区 - 厂商扩展层：
rknin/、RKTools/等瑞芯微特有目录藏着原厂的"黑科技"
提示：理解这种分层架构，能帮助开发者在修改代码时准确定位——该动AOSP标准层还是硬件适配层，往往决定着后续维护的难易程度。
2. 硬件抽象的艺术：device与hardware目录
2.1 device/rockchip/rk3568的奥秘
这个目录是RK3568开发板的"身份证"，其子目录结构值得玩味：
device/rockchip/rk3568/ ├── apps/ # 预装应用 ├── audio/ # 音频策略 ├── bootloader/ # 引导配置 ├── configs/ # 硬件参数 ├── display/ # 显示配置 ├── etc/ # 初始化脚本 ├── firmware/ # 固件镜像 ├── overlay/ # 资源覆盖 └── sepolicy/ # 安全策略特别需要注意的是overlay/frameworks/base/core/res/res/目录，这里通过资源覆盖机制实现了对AOSP默认配置的修改，比直接改动AOSP源码更优雅。
2.2 hardware/rockchip的HAL层实现
硬件抽象层（HAL）是Android系统与Linux内核之间的"翻译官"。RK3568的HAL实现有几个关键目录：
interfaces/：标准的HIDL接口定义libgralloc/：图形内存分配器librga/：2D加速器驱动libhwc/：硬件合成器
在调试显示异常问题时，经常会用到这个命令抓取HAL层状态：
adb shell dumpsys SurfaceFlinger3. 内核与驱动的秘密花园
3.1 kernel/目录的双重身份
RK3568的kernel目录实际上是一个完整的Linux内核源码树，但有几个特殊之处：
arch/arm64/boot/dts/rockchip/存放着所有开发板的设备树文件drivers/soc/rockchip/包含芯片特有的外设驱动include/uapi/linux/rk_*.h定义了用户空间与内核的交互接口
设备树与驱动的对应关系可以通过这个命令验证：
cat /proc/device-tree/compatible3.2 编译系统的演进：从Make到Soong
RK3568 BSP中同时存在两种编译系统：
| 文件类型 | 出现位置 | 作用时期 |
|---|---|---|
| Android.mk | kernel/drivers/ | 传统Make |
| Android.bp | hardware/interfaces/ | 现代Soong |
迁移到Soong编译系统后，模块依赖关系变得更加明确。例如在hardware/rockchip/Android.bp中可以看到：
cc_library_shared { name: "vendor.rockchip.hardware.example@1.0", srcs: ["Example.cpp"], shared_libs: [ "libhidlbase", "libhidltransport", ], }4. U-Boot的定制之道
4.1 board/rockchip/的开发板适配
U-Boot的board/rockchip/目录下，每个开发板都有独立的配置文件夹。以RK3568为例：
common/：通用初始化代码evb_rk3568/：评估板特定配置include/configs/：头文件定义rk3568.c：板级初始化入口
关键的DDR初始化参数藏在rk3568-dram.c文件中，修改时需特别注意时序参数：
static struct dram_cfg_param ddr_ddrconf_cfg[] = { {0x00000004, 0x0000008a}, {0x00000008, 0x00000004}, // ...更多寄存器配置 };4.2 瑞芯微的编译魔法
原厂提供的make.sh脚本简化了编译流程，但其背后实际执行的是：
./make.sh rk3568 # 配置开发板 make ARCH=arm64 # 交叉编译编译产物中，这几个文件最关键：
u-boot.bin：原始二进制镜像u-boot.dtb：设备树二进制u-boot.itb：包含设备树的FIT镜像
5. 厂商定制区的隐藏功能
5.1 RKTools的实用工具集
RKTools/目录下的工具常被开发者忽视，其实包含多个实用工具：
linux/Linux_Upgrade_Tool：底层烧录工具windows/AndroidTool：Windows平台烧写工具bin/rkdeveloptool：命令行烧录工具
使用示例：
rkdeveloptool db rk356x_spl_loader_v1.xx.bin rkdeveloptool wl 0x8000 uboot.img rkdeveloptool rd5.2 rknin的性能调优
rknin/目录存放着瑞芯微的NPU相关组件：
driver/：内核驱动模块examples/：AI模型示例runtime/：推理运行时库
典型的NPU使用流程需要先加载内核模块：
insmod /vendor/lib/modules/rknpu.ko6. 实战：添加新开发板支持
当需要为定制硬件移植BSP时，通常需要修改以下关键点：
- 设备树：在
kernel/arch/arm64/boot/dts/rockchip/添加新dts文件 - U-Boot配置：复制
board/rockchip/evb_rk3568/并修改初始化代码 - HAL适配：在
hardware/rockchip/中添加新传感器驱动 - 构建配置：在
device/rockchip/rk3568/中添加新产品定义
一个典型的开发板定义文件device/rockchip/rk3568/BoardConfig.mk包含这些关键参数：
TARGET_BOARD_PLATFORM := rk3568 BOARD_SENSOR_TYPE := virtual BOARD_HAVE_BLUETOOTH := true7. 调试技巧与常见陷阱
在深度定制过程中，这些调试方法可能会帮到你：
查看启动日志：
adb shell dmesg | grep -i error分析内存布局：
adb shell cat /proc/iomem追踪系统属性：
adb shell getprop | grep ro.hardware
常见问题包括：
- 显示异常：检查
hardware/rockchip/libgralloc/的内存分配策略 - 音频失效：验证
device/rockchip/rk3568/audio/中的策略文件 - 启动卡住：对比
u-boot/include/configs/rk3568_common.h中的初始化参数
在rk3568的开发过程中，最耗时的往往不是代码编写，而是理解原厂设计的各种隐含约定。比如vendor/rockchip/common目录下的脚本会覆盖系统默认行为，而device/rockchip/common中的配置则会影响所有Rockchip平台。