需求规格说明书

Transcription

1 密级状态 : 绝密 ( ) 秘密 ( ) 内部 ( ) 公开 ( ) RK3326_ANDROID8.1_SDK 发布说明 ( 技术部, 第二系统产品部 ) 文件状态 : [ ] 正在修改 [ ] 正式发布 当前版本 : V1.00 作者 : 吴良清 / 蓝斌元 完成日期 : 审核 : 黄祖芳 完成日期 : Fuzhou Rockchips Semiconductor Co., Ltd ( 版本所有, 翻版必究 )

2 版本历史 版本号作者修改日期修改说明备注 V1.00 吴良清 / 蓝斌元 正式发布

3 目录 1 概述 主要支持功能 SDK 获取说明 获取 SDK 补充说明 SDK 编译说明 JDK 安装 编译模式 代码编译 uboot 编译步骤 kernel 编译步骤 Android 编译及固件生成步骤 刷机说明... 6 附录 A 编译开发环境搭建...7 附录 B SSH 公钥操作说明...11 附录 B-1 SSH 公钥生成 附录 B-2 使用 key-chain 管理密钥 附录 B-3 多台机器使用相同 ssh 公钥...12 附录 B-4 一台机器切换不同 ssh 公钥...13 附录 B-5 密钥权限管理...14 附录 B-6 Git 权限申请说明...14

4 1 概述 本 SDK 是基于谷歌 Android8.1 64bit 系统, 适配瑞芯微 RK3326 和 PX30 两款芯片的软 件包, 适用基于 RK3326/PX30 平台开发的产品 2 主要支持功能 参数 数据通信 应用程序 模块名 Wi-Fi USB 以太网卡 USB SDCARD Launcher3 APK 安装器 浏览器 计算器 日历 相机 闹钟 下载 电子邮件 资源管理器 GMS 应用 音乐 录音 设置 视频播放器 3 SDK 获取说明 3.1 获取 SDK SDK 通过瑞芯微代码服务器对外发布 其编译开发环境, 参考附录 A 编译开发环境搭建 客户向瑞芯微技术窗口申请 SDK, 需同步提供 SSH 公钥进行服务器认证授权, 获得授权后即可同步代码 关于瑞芯微代码服务器 SSH 公钥授权, 请参考附录 B SSH 公钥操作说明 RK3326_ANDROID8.1_SDK 下载地址如下 : repo init --repo-url=ssh://git@ -u ssh://g it@ -m Rk3326_Android_Oreo_rel ease.xml 注,repo 是 google 用 Python 脚本写的调用 git 的一个脚本, 主要是用来下载 管理 Android 项目的软件仓库, 其下载地址如下 : git clone ssh:// git@ 1

5 为方便客户快速获取 SDK 源码, 瑞芯微技术窗口通常会提供对应版本的 SDK 初始压缩包 以 Rk3326_Android_Oreo_release_ tar.gz 为例, 拷贝到该初始化包后, 通过如下命令可检出源码 : mkdir RK3326 tar zxvf Rk3326_Android_Oreo_release_ tar.gz -C RK3326 cd RK3326.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

6 4.2 编译模式 SDK 默认以 userdebug 模式编译 使用 adb 时, 需要先执行 adb root 使 shell 获取 root 权限, 进而执行其它像 adb remount adb push 等操作 4.3 代码编译 uboot 编译步骤 cd u-boot make clean make mrproper./make.sh evb-rk3326 适用于 RK3326 芯片 或者./make.sh evb-px30 适用于 PX30 芯片 编译完, 会生成 trust.img rk3326_loader_v bin(rk3326)/px30_loader_v bin(px30) uboot.img 三个文件 该 rk3326_loader_v bin(rk3326)/px30_loader_v bin(px30) 可兼容 DDR 类型及容量 kernel 编译步骤 1) RK3326 平板样机配置与编译如下 : 使用的 dts 是 : arch/arm64/boot/dts/rockchip/rk lp3-v10.dts cd kernel make ARCH=arm64 rockchip_defconfig make ARCH=arm64 rk lp3-v10.img 3

7 2) RK3326 Smart Display 的 EVB 开发板 RK_EVB_AI_VA_RK3326 配置与编译如下 : 使用的 dts 是 : arch/arm64/boot/dts/rockchip/rk3326-evb-ai-va-v10.dts cd kernel make ARCH=arm64 rockchip_defconfig make ARCH=arm64 rk3326-evb-ai-va-v10.img 3) PX30 的 EVB 开发板配置与编译如下 : 使用的 dts 是 : arch/arm64/boot/dts/rockchip/px30-evb-ddr3-v10.dts cd kernel make ARCH=arm64 rockchip_defconfig make ARCH=arm64 px30-evb-ddr3-v10.img 4) RK3326 的 EVB 开发板配置与编译如下 : 使用的 dts 是 : arch/arm64/boot/dts/rockchip/rk3326-evb-lp3-v10.dts cd kernel make ARCH=arm64 rockchip_defconfig make ARCH=arm64 rk3326-evb-lp3-v10.img 编译完成后,kernel 根目录, 生成 kernel.img,resource.img 两个镜像文件 Android 编译及固件生成步骤客户按实际编译环境配置好 JDK 环境变量后, 按照以下步骤配置完后, 执行 make 即可 $ source build/envsetup.sh $ lunch You're building on Linux Lunch menu... pick a combo: 1. aosp_arm-eng 2. aosp_arm64-eng 3. aosp_mips-eng 4. aosp_mips64-eng 4

8 5. aosp_x86-eng 6. aosp_x86_64-eng 7. rk3326_evb-userdebug 8. rk3326_evb-user 9. rk3326_mid-userdebug 10. rk3326_mid-user 如果是平板选择 rk3326_mid-userdebug, 输入对应序号 9 如果是 RK3326 PX30 RK3326 Smart Display 的 EVB 选择 rk3326_evb-userdebug, 输入对应序号 7 $ make -j4 完成编译后, 执行 SDK 根目录下的 mkimage.sh 脚本生成固件, 所有烧写所需的镜像将都会拷贝于 rockdev/image-rk3326_mid 或 rockdev/image-rk3326_evb 目录 rockdev/image-rk3326_mid 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 5

9 vendor.img 得到所有镜像文件后, 为了方便烧写及量产, 通常可手动将这些单独的镜像通过脚本打包成 为 update.img 4.4 刷机说明 SDK 提供烧写工具, 如下图所示, 版本为 2.54 编译生成相应的固件后, 进入 loader 模式, 即可进行刷机 对于已烧过其它固件的机器, 请选择低格设备, 擦除 idb, 然后进行刷机 注 : 烧写工具必须使用 2.54 及以上版本的工具, 量产工具使用 1.6 及以上版本 ;linux 下的 烧写工具使用 1.31 及以上版本 6

10 附录 A 编译开发环境搭建 1. Initializing a Build Environment This section describes how to set up your local work environment to build the Android source files. You must use Linux or Mac OS; building under Windows is not currently supported. For an overview of the entire code-review and code-update process, see Life of a Patch. Note: All commands in this site are preceded by a dollar sign ($) to differentiate them from output or entries within files. You may use the Click to copy feature at the top right of each command box to copy all lines without the dollar signs or triple-click each line to copy it individually without the dollar sign. 2. Choosing a Branch Some requirements for the build environment are determined by the version of the source code you plan to compile. For a full list of available branches, see Build Numbers. You can also choose to download and build the latest source code (called master), in which case you will simply omit the branch specification when you initialize the repository. After you have selected a branch, follow the appropriate instructions below to set up your build environment. 3. Setting up a Linux build environment These instructions apply to all branches, including master. The Android build is routinely tested in house on recent versions of Ubuntu LTS (14.04) and Debian testing. Most other distributions should have the required build tools available. For Gingerbread (2.3.x) and newer versions, including the master branch, a 64-bit environment is required. Older versions can be compiled on 32-bit systems. 7

11 Note: See Requirements for the complete list of hardware and software requirements, then follow the detailed instructions for Ubuntu and Mac OS below. 4. Installing the JDK The master branch of Android in the Android Open Source Project (AOSP) comes with prebuilt versions of OpenJDK below prebuilts/jdk/ so no additional installation is required. Older versions of Android require a separate installation of the JDK. On Ubuntu, use OpenJDK. See JDK Requirements for precise versions and the sections below for instructions. For Ubuntu >= Run the following: sudo apt-get update sudo apt-get install openjdk-8-jdk For Ubuntu LTS There are no available supported OpenJDK 8 packages for Ubuntu The Ubuntu OpenJDK 8 packages have been used successfully with Ubuntu Newer package versions (e.g. those for 15.10, 16.04) were found not to work on using the instructions below. 1. Download the.deb packages for 64-bit architecture from old-releases.ubuntu.com: openjdk-8-jre-headless_8u45-b14-1_amd64.deb with SHA256 0f5aba8db b51e a4d8809f f83e214ab56c0 openjdk-8-jre_8u45-b14-1_amd64.deb with SHA256 9ef76c4562d39432b69baf6c18f199707c5c56a5b df908b7d74e

12 openjdk-8-jdk_8u45-b14-1_amd64.deb with SHA256 6e47215cf6205aa829e6a0a bd29d1f428a4006a80c9db371c2fc3c4c 2. Optionally, confirm the checksums of the downloaded files against the SHA256 string listed with each package above. For example, with the sha256sum tool: sha256sum {downloaded.deb file} 3. Install the packages: sudo apt-get update Run dpkg for each of the.deb files you downloaded. It may produce errors due to missing dependencies: sudo dpkg -i {downloaded.deb file} To fix missing dependencies: sudo apt-get -f install Update the default Java version - optional Optionally, for the Ubuntu versions above update the default Java version by running: sudo update-alternatives --config javasudo update-alternatives --config javac Note: If, during a build, you encounter version errors for Java, see Wrong Java version for likely causes and solutions. Installing required packages (Ubuntu 14.04) You will need a 64-bit version of Ubuntu. Ubuntu is recommended. sudo apt-get install git-core gnupg flex bison gperf build-essential zip curl 9

13 zlib1g-dev gcc-multilib g++-multilib libc6-dev-i386 lib32ncurses5-dev x11proto-core-dev libx11-dev lib32z-dev ccache libgl1-mesa-dev libxml2-utils xsltproc unzip Note: To use SELinux tools for policy analysis, also install the python-networkx package. Note: If you are using LDAP and want to run ART host tests, also install the libnss-sss:i386 package. 5. Configuring USB Access Under GNU/linux systems (and specifically under Ubuntu systems), regular users can't directly access USB devices by default. The system needs to be configured to allow such access. The recommended approach is to create a file /etc/udev/rules.d/51-android.rules (as the root user) and to copy the following lines in it. <username> must be replaced by the actual username of the user who is authorized to access the phones over USB. # adb protocol on passion (Rockchip products) SUBSYSTEM=="usb", ATTR{idVendor}=="2207", ATTR{idProduct}=="0010", MODE="0600", OWNER="<username>" Those new rules take effect the next time a device is plugged in. It might therefore be necessary to unplug the device and plug it back into the computer. This is known to work on both Ubuntu Hardy Heron (8.04.x LTS) and Lucid Lynx (10.04.x LTS). Other versions of Ubuntu or other variants of GNU/linux might require different configurations. References : 10

14 附录 B SSH 公钥操作说明 附录 B-1 SSH 公钥生成 使用如下命令生成 : ssh-keygen -t rsa -C "user@host" 请将 user@host 替换成您的邮箱地址 命令运行完成会在你的目录下生成 key 文件 管理员 请妥善保存生成的私钥文件 id_rsa 和密码, 并将 id_rsa.pub 发邮件给 SDK 发布服务器的 附录 B-2 使用 key-chain 管理密钥 推荐您使用比较简易的工具 keychain 管理密钥 具体使用方法如下 : 11

15 1. 安装 keychain 软件包 : $sudo aptitude install keychain 2. 配置使用密钥 : $vim ~/.bashrc 增加下面这行 : eval `keychain --eval ~/.ssh/id_rsa` 其中,id_rsa 是私钥文件名称 以上配置以后, 重新登录控制台, 会提示输入密码, 只需输入生成密钥时使用的密码即可, 若无密码可不输入 另外, 请尽量不要使用 sudo 或 root 用户, 除非您知道如何处理, 否则将导致权限以及密钥管理混乱 附录 B-3 多台机器使用相同 ssh 公钥 即可 在不同机器使用, 可以将你的 ssh 私钥文件 id_rsa 拷贝到要使用的机器的 ~/.ssh/id_rsa 在使用错误的私钥会出现如下提示, 请注意替换成正确的私钥 添加正确的私钥后, 就可以使用 git 克隆代码, 如下图 12

16 添加 ssh 私钥可能出现如下提示错误 Agent admitted failture to sign using the key 在 console 输入如下命令即可解决 ssh-add ~/.ssh/id_rsa 附录 B-4 一台机器切换不同 ssh 公钥 可以参考 ssh_config 文档配置 ssh ~$ man ssh_config 通过如下命令, 配置当前用户的 ssh 配置 ~$ cp /etc/ssh/ssh_config ~/.ssh/config ~$ vi.ssh/config 如图, 将 ssh 使用另一个目录的文件 ~/.ssh1/id_rsa 作为认证私钥 通过这种方法, 可以切换不同的的密钥 13

17 附录 B-5 密钥权限管理 载权限 服务器可以实时监控某个 key 的下载次数 IP 等信息, 如果发现异常将禁用相应的 key 的下 请妥善保管私钥文件 并不要二次授权与第三方使用 附录 B-6 Git 权限申请说明 参考上述章节, 生成公钥文件, 发邮件至 申请开通 SDK 代码下载权限 14