密级状态:绝密(
) 秘密(
) 内部( )
公开(√ )
福州瑞芯微电子股份有限公司
RK3288(W-Version)_ANDROID8.1_SD
K 发布说明
(技术部,第二系统产品部)
文件状态:
当前版本:
V1.00
[
] 正在修改
作
者:
陈锦森
[√] 正式发布
完成日期:
2018-05-08
审
核:
刘益星、陈海燕
完成日期:
2018-05-08
福州瑞芯微电子股份有限公司
Fuzhou Rockchips Semiconductor Co . , Ltd
(版本所有,翻版必究)
福州瑞芯微电子股份有限公司
版 本 历 史
版本号
作者
修改日期
修改说明
备注
V1.00
陈锦森
2018.05.08 初始版本
福州瑞芯微电子股份有限公司
目 录
1 概述........................................................................................................................................................... 1
2 主要支持功能........................................................................................................................................... 1
3 SDK 获取说明.......................................................................................................................................... 1
3.1 获取 SDK......................................................................................................................................1
3.2 补充说明....................................................................................................................................... 2
4 SDK 编译说明.......................................................................................................................................... 2
4.1 JDK 安装....................................................................................................................................... 2
4.2 编译模式....................................................................................................................................... 3
4.3 代码编译....................................................................................................................................... 3
4.3.1 uboot 编译步骤.............................................................................................................. 3
4.3.2 kernel 编译步骤............................................................................................................. 3
4.3.3 Android 编译及固件生成步骤.......................................................................................3
4.4 刷机说明....................................................................................................................................... 5
附录 A 编译开发环境搭建.........................................................................................................................6
附录 B SSH 公钥操作说明......................................................................................................................10
附录 B-1 SSH 公钥生成................................................................................................................. 10
附录 B-2 使用 key-chain 管理密钥............................................................................................ 10
附录 B-3 多台机器使用相同 ssh 公钥.........................................................................................11
附录 B-4 一台机器切换不同 ssh 公钥.........................................................................................12
附录 B-5 密钥权限管理..................................................................................................................13
附录 B-6 Git 权限申请说明............................................................................................................13
福州瑞芯微电子股份有限公司
1 概述
本 SDK 是基于谷歌 Android8.1 最新系统,只适配瑞芯微 RK3288(W 版本芯片),只适用
于 RK3288(W 版本芯片)平台及基于其上所有开发产品,旧 RK3288 芯片不支持 8.1 系统。
注:本 SDK 软件包仅支持 RK3288(W 版本芯片),不支持旧 RK3288 芯片。
2 主要支持功能
参数
数据通信
应用程序
模块名
Wi-Fi、USB 以太网卡、USB、SDCARD
Launcher3、APK 安装器、浏览器、计算器、日历、相机、闹钟、下载、
电子邮件、资源管理器、GMS 应用、音乐、录音、设置、视频播放器
3 SDK 获取说明
3.1 获取 SDK
SDK 通过瑞芯微代码服务器对外发布。其编译开发环境,参考附录 A 编译开发环境搭建。
客户向瑞芯微技术窗口申请 SDK,需同步提供 SSH 公钥进行服务器认证授权,获得授权后
即可同步代码。关于瑞芯微代码服务器 SSH 公钥授权,请参考附录 B SSH 公钥操作说明。
RK3288(W-Version)_ANDROID8.1_SDK 下载地址如下:
repo init --repo-url=ssh://git@www.rockchip.com.cn:2222/repo-release/tools/
repo.git -u ssh://git@www.rockchip.com.cn:2222/Android_oreo_stable/platform/rk
3288/manifests.git -m Rk3288_Android_Oreo_release.xml
注:repo 是 google 用 Python 脚本写的调用 git 的一个脚本,主要是用来下载、管理 Android
项目的软件仓库,其下载地址如下:
git clone ssh:// git@www.rockchip.com.cn:2222/repo-release/tools/repo
1
为方便客户快速获取 SDK 源码,瑞芯微技术窗口通常会提供对应版本的 SDK 初始压缩包。
以 Rk3288_Android_Oreo_release_201805012.tar.gz 为例,拷贝到该初始化包后,通
福州瑞芯微电子股份有限公司
过如下命令可检出源码:
mkdir RK3288
tar zxvf Rk3288_Android_Oreo_release_201805012.tar.gz -C RK3288
cd RK3288
.repo/repo/repo sync -l
.repo/repo/repo sync
3.2 补充说明
Android8.1 SDK 已不再支持 UMS 功能,平台设备皆使用合并分区;
Android8.1 SDK 已支持全盘加密功能;
Android8.1 SDK 已支持 Verified boot 的功能;
4 SDK 编译说明
4.1 JDK 安装
Android8.1 系统编译依赖于 JAVA 8。编译之前需安装 OpenJDK。
安装命令如下。
sudo apt-get install openjdk-8-jdk
配置 JAVA 环境变量,例如,安装路径为/usr/lib/jvm/java-8-openjdk-amd64,可在终
端执行如下命令配置环境变量。
export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64
export PATH=$JAVA_HOME/bin:$PATH
export CLASSPATH=.:$JAVA_HOME/lib:$JAVA_HOME/lib/tools.jar
2
福州瑞芯微电子股份有限公司
4.2 编译模式
SDK 默认以 userdebug 模式编译。
使用 adb 时,需要先执行 adb root 使 shell 获取 root 权限,进而执行其它像 adb remount、
adb push 等操作。
4.3 代码编译
4.3.1 uboot 编译步骤
cd u-boot
make clean
make rk3288_secure_defconfig
./mkv7.sh
编译完,会生成 trust.img、rk3288_loader_vx_xx_xxx.bin、uboot.img 三个文件。
4.3.2 kernel 编译步骤
RK3288(W Version) EVB 样机配置与编译如下:
cd kernel
make ARCH=arm rockchip_defconfig
make ARCH=arm rk3288-evb-android-rk808-edp.img -j12
编译完成后,kernel 根目录,生成 kernel.img,resource.img 两个镜像文件。
4.3.3 Android 编译及固件生成步骤
客户按实际编译环境配置好 JDK 环境变量后,按照以下步骤配置完后,执行 make 即可。
$ source build/envsetup.sh
$ lunch
You're building on Linux
Lunch menu... pick a combo:
1. aosp_arm-eng
3
福州瑞芯微电子股份有限公司
2. aosp_arm64-eng
3. aosp_mips-eng
4. aosp_mips64-eng
5. aosp_x86-eng
6. aosp_x86_64-eng
7. rk3288-userdebug
8. rk3288-user
选择 rk3288-userdebug,输入对应序号 7。
$ make -j12
完成编译后,执行 SDK 根目录下的 mkimage.sh 脚本生成固件,所有烧写所需的镜像将都
会拷贝于 rockdev/Image-rk3288 目录。
rockdev/Image-rk3288
├── boot.img
├── kernel.img
├── MiniLoaderAll.bin
├── misc.img
├── oem.img
├── parameter.txt
├── pcba_small_misc.img
├── pcba_whole_misc.img
├── recovery.img
├── resource.img
├── system.img
├── trust.img
├── uboot.img
└── vendor.img
4
得到所有镜像文件后,为了方便烧写及量产,通常可手动将这些单独的镜像通过脚本打包成
福州瑞芯微电子股份有限公司
为 update.img。
4.4 刷机说明
SDK 提供烧写工具,如下图所示,版本为 2.47。编译生成相应的固件后,进入 loader 模式,
即可进行刷机。对于已烧过其它固件的机器,请选择低格设备,擦除 idb,然后进行刷机。
注:烧写工具必须使用 2.47 及以上版本的工具,量产工具使用 1.6 及以上版本;linux 下的
烧写工具使用 1.31 及以上版本。
5