100ask roc-rk3399-pc

来自百问网嵌入式Linux wiki
Wiki讨论 | 贡献2019年7月29日 (一) 12:09的版本
视频链接地址: 开发板购买地址:
资料光盘下载地址: 配套视频wiki教程:
裸机程序wiki 驱动程序wiki

接口布局和尺寸

正面视图
背面视图
尺寸视图
roc-rk3399-pc 开发板参数列表
主控芯片
  • Rockchip RK3399 (28纳米HKMG制程)
处理器
  • 六核ARM® 64位处理器,主频高达1.8GHz
  • 基于big.LITTLE大小核架构,双核Cortex-A72(大核)+四核Cortex-A53(小核)
图形处理器
  • ARM Mali-T860 MP4 四核GPU
  • 支持OpenGL ES1.1/2.0/3.0/3.1, OpenVG1.1, OpenCL, DX11
  • 支持AFBC(帧缓冲压缩)
视频处理器
  • 支持4K VP9 and 4K 10bits H265/H264 视频解码,高达60fps
  • 1080P 多格式视频解码 (WMV, MPEG-1/2/4, VP8)
  • 1080P 视频编码,支持H.264,VP8格式
  • 视频后期处理器:反交错、去噪、边缘/细节/色彩优化
电源管理
  • RK808-D PMU芯片
内存
  • 4GB LPDDR4 双通道64位RAM
存储器
  • 板载SPI flash(16M Byte)
  • 16GB/32GB/128GB 高速eMMC(可选)
  • 支持MicroSD (TF) 卡、U盘扩展
  • 支持扩展板M.2 M-Key 扩展SSD
以太网
  • 千兆以太网(RJ45接口)
WiFi/蓝牙
  • 通过扩展板 M.2 E-Key接口(提供SDIO 3.0信号)
显示
  • HDMI2.0支持4K 60Hz显示,支持HDCP 1.4/2.2
  • DisplayPort 1.2(最高支持4K 60Hz)
  • 支持eDP 1.3
  • 支持MIPI-DSI(双通道)
  • 支持双屏显示(Type-C + HDMI),支持 4K + 2K输出
音频
  • 1 x HDMI音频输出、DP音频输出
摄像头
  • 双路MIPI CSI接口(同时支持双路摄像头)
USB
  • USB 2.0 Host × 3
  • Type-C × 2
调试
  • 调试串口 × 1,用于开发调试
按键
  • Recovery × 1
  • Power × 1
红外
  • 1路红外接收头,支持红外遥控功能
RTC
  • RTC实时时钟 x 1,板载电池座
电源
  • POE+(802.3 AT,输出功率 30W)
  • Type-C PD 2.0电源控制芯片、支持宽电压输入(5V-15V)
  • 双节电池供电(7.4V锂电)
双Type-C
  • 支持 4K@60fps输出(不支持同时输出)
  • TypeC0接口:支持 DisplayPort 1.2 + Power Delivery 2.0+ USB3.0 OTG +USB2.0 Host、
  • 使用一根Type-C线,即可同时实现的板子供电和DP输出。
  • TypeC1 接口:支持DisplayPort 1.2 + USB3.0 HOST+ USB2.0 HOST, 支持对外供电

快速入门

准备工作 资料光盘简介

要使用你的roc-rk3399-pc开发板,请提前准备好以下资源:

  • 一台可以上网的windows电脑
  • roc-rk3399-pc开发板
  • microSD卡/TF卡: Class10或以上的 8GB SDHC卡
  • 一个12v/2A的TYPE C接口电源适配器
  • VMware-player-15.1.5.exe
  • Vmware ubuntu 18.04 64位虚拟机镜像
  • win32diskimager-1.0.0-install.exe
  • MobaXterm_Portable_v11.0.zip
00_UserManual
二级目录
100ask_am335x硬件手册.pdf
100ask_am335x初级用户手册.pdf
100ask_am335x高级用户开发手册_v1.pdf
01_tools
二级目录
100ask-vmware_ubuntu18.04.7z Windows下编译开发环境,主要适用模块应用开发
FileZilla_3.22.1_win32-setup.exe Windows下ftp工具,传输文件到Ubuntu系统中
HP USB Disk Storage Format Tool 2.0.6.EXE
MobaXterm_Portable_v11.0.zip
npp.7.6.1.Installer.exe
qt-creator-opensource-linux-x86_64-4.8.0.run
SD Card Formatter 5.0.1 Setup.exe
VMware-workstation-full-15.1.0-13591040.exe
win32diskimager-1.0.0-install.exe
02_images
二级目录
nandflash_system 三级目录
100ask-am335x.dtb
MLO
rootfs.ubi
u-boot.img
uEnv.txt
zImage
sdcard sdcard.img
03_examples
二级目录
001_hello 三级目录
05_hardware
二级目录
Bottom plate 三级目录
100ask_am335x_v12.pdf
100ask_am335x__顶层元件图.pdf
Core board ET-som335X原理图.pdf
Extend_modules ET-som335X原理图.pdf
06_datasheet
二级目录
Bottom plate 三级目录
ADM2483.pdf
ADuM1201.pdf
AO4485.PDF
AR8035.pdf
B0505S-1WR3.pdf
MMSZ5242BT1中文资料.pdf
MP1470GJ-Z.PDF
S8550.PDF
sn74lvc1g08.pdf
SP3232EEN-L.PDF
TJA1050T.pdf
tlv320aic3106.pdf
USB2514B.pdf 四级目录
Core board CPU AM335x ARM Cortex-A8 Microprocessors (MPUs) Silicon Errata (Revs 2.0, 1.0).pdf
AM335x ARM Cortex-A8 Microprocessors (MPUs) Technical Reference Manual.pdf
AM335x ARM Cortex-A8 Microprocessors (MPUs)中文版.pdf
AM335x Sitara Processors.pdf
DDR3L SDRAM MT41K256M16HA-125E_Micron.pdf
Nand Flash H27U4G8F2DTR-BC.pdf
PMU tps65217.pdf
RTC RX8025.pdf
07_bsp_sdk
二级目录
100ask_am335x 三级目录
buildroot2018.tar.gz
linux-4.9.168.tar.gz
ToolChain.tar.gz
uboot2016.06.tar.gz

如需自行安装配置vmware ubuntu开发环境请参考Ubuntu开发环境配置

编译100ask linux sdk系统

获取源码

类别 国内coding仓库 国外github仓库
u-boot https://dev.tencent.com/u/weidongshan/p/100ask_roc-rk3399_uboot https://github.com/100askTeam/roc-rk3399-uboot
linux kernel https://dev.tencent.com/u/weidongshan/p/100ask_roc-rk3399_kernel https://github.com/100askTeam/roc-rk3399-kernel
根文件系统 https://dev.tencent.com/u/weidongshan/p/100ask_roc-rk3399_buildroot https://github.com/100askTeam/roc-rk3399-buildroot

git邮箱账号和用户名配置

git config --global user.email "you@example.com"
git config --global user.name "Your Name"

初次使用,需要配置用户名和密码才可以进行代码同步,用户名和密码根据自己情况设定,也可以随意设定

  • repo工具配置

考虑到代码仓库过多,特使用repo工具管理代码

book@100ask:~$  git clone  https://git.dev.tencent.com/codebug8/repo.git
book@100ask:~$  mkdir -p 100ask_roc-rk3399-pc && cd 100ask_roc-rk3399-pc
book@100ask:~/100ask_roc-rk3399-pc $ ../repo/repo init -u https://dev.tencent.com/u/weidongshan/p/manifests/git -b linux-sdk -m rk3399/roc-rk3399-pc_linux_release.xml --no-repo-verify
book@100ask:~/100ask_roc-rk3399-pc $  ../repo/repo sync -j4

上面使用的repo管理为国内coding仓库 http://wiki.t-firefly.com/zh_CN/ROC-RK3399-PC/

设置工具链

交叉编译工具链主要是用于在ubuntu主机上编译并声称可以在其它平台上运行的系统。设置交叉编译工具主要是设置PATH, ARCH和CROSS_COMPILE三个环境变量,下面介绍具体设置方法。

  • 永久生效

如需永久修改,请修改用户配置文件, Ubuntu系统下,修改如下:

vim ~/.bashrc

在行尾添加或修改:

export ARCH=arm64
export CROSS_COMPILE=aarch64-linux-gnu-
export PATH=$PATH:/home/book/100ask_roc-rk3399-pc/ToolChain-6.3.1/gcc-linaro-6.3.1-2017.05-x86_64_aarch64-linux-gnu/bin
  • 临时生效

执行完“export”命令后,该设置只对当前终端有效

book@100ask:~$ export PATH=$PATH:/home/book/100ask_roc-rk3399-pc/ToolChain-6.3.1/gcc-linaro-6.3.1-2017.05-x86_64_aarch64-linux-gnu/bin
book@100ask:~$ export ARCH=arm64
book@100ask:~$ export CROSS_COMPILE=aarch64-linux-gnu-
  • 手动指定

Make编译时指定ARCH架构 CROSS_COMPILE交叉编译工具链

book@100ask:~$ export PATH=$PATH:/home/book/100ask_roc-rk3399-pc/ToolChain-6.3.1/gcc-linaro-6.3.1-2017.05-x86_64_aarch64-linux-gnu/bin
book@100ask:~$ make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu-  [命令]

编译u-boot

不同的开发板对应不同的配置文件,配置文件位于 u-boot的configs/ 目录,下面以Roc-rk3399-pc开发板为例,说明u-boot的编译过程:

book@100ask:~$ cd ~/100ask_roc-rk3399-pc/uboot2019.01
book@100ask: ~/100ask_roc-rk3399-pc/uboot2019.01$ make distclean
book@100ask: ~/100ask_roc-rk3399-pc/uboot2019.01$ make 100ask_roc-rk3399-pc_defconfig
book@100ask: ~/100ask_roc-rk3399-pc/uboot2019.01$ make
book@100ask: ~/100ask_roc-rk3399-pc/uboot2019.01$ ./make.sh trust
book@100ask: ~/100ask_roc-rk3399-pc/uboot2019.01$ ./make.sh uboot
book@100ask: ~/100ask_roc-rk3399-pc/uboot2019.01$ ./make.sh loader
  • nfs启动系统
=> setenv serverip 192.168.1.132
=> setenv ipaddr 192.168.1.112
=> tftpboot 0x01f00000 rk3399-roc-pc.dtb; tftpboot 0x02080000 Image; setenv bootargs root=/dev/nfs nfsroot=192.168.1.132:/home/book/rootfs,vers=3  rw ip=192.168.1.120; booti 0x02080000 - 0x01f00000

编译linux kernel

book@100ask:~/100ask_roc-rk3399-pc$ cd linux-4.4
book@100ask:~/100ask_roc-rk3399-pc/linux-4.4$ make mrproper
book@100ask:~/100ask_roc-rk3399-pc/linux-4.4$ make 100ask_roc-rk3399-pc_defconfig
book@100ask:~/100ask_roc-rk3399-pc/linux-4.4$ make Image
book@100ask:~/100ask_roc-rk3399-pc/linux-4.4$ make dtbs
  • 编译内核模块
book@100ask:~/100ask_roc-rk3399-pc/linux-4.4$ make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- modules
  • 安装内核模块到nfs根文件系统
book@100ask:~/100ask_roc-rk3399-pc/linux-4.4$ sudo make ARCH=arm64 INSTALL_MOD_PATH=/media/rootfs  modules_install

编译根文件系统

配置文件 含义
100ask_roc-rk3399-pc_defconfig 默认文件系统版本
book@100ask:~/100ask_roc-rk3399-pc$ cd buildroot2018.02
book@100ask:~/100ask_roc-rk3399-pc/buildroot2018.02$ make clean
book@100ask:~/100ask_roc-rk3399-pc/buildroot2018.02$ make 100ask_roc-rk3399-pc_defconfig
book@100ask:~/100ask_roc-rk3399-pc/buildroot2018.02$ make menuconfig
book@100ask:~/100ask_roc-rk3399-pc/buildroot2018.02$ make –jN		 /* N表示CPU的线程数,比如可以写4、8等以加快编译速度 */

编译后生成文件介绍

 
buildroot2018.02	
	├── output
		├── images	
			├── idbloader.img				<--u-boot镜像
			├── nfs_rootfs					<--打包并压缩的根文件系统,适用于NFSROOT启动	
			   └── rootfs.tar.gz	
			├── rk3288-firefly.dtb  			<--设备树文件
			├── rootfs.ext2
			├── rootfs.ext4 -> rootfs.ext2		<--ext2格式根文件系统
			├── rootfs.tar					<--打包后的根文件系统
			├── sdcard.img					<--完整的SD卡系统镜像
			├── trust.img					<--u-boot镜像
			├── u-boot.bin
			├── u-boot-dtb.img
			├── uboot.img					<--u-boot镜像
			└── zImage					<--内核镜像

sd卡启动

1.安装资料光盘下01_tools/SD Card Formatter 5.0.1 Setup.exe软件,安装完成后打开!
2.使用SdCardFormatter格式化SD卡,格式化步骤如下如所示!

100ask am335x SD P 004.png 100ask am335x SD P 005.png 100ask am335x SD P 006.png
(1)选择要格式化的SD卡,选中Quick format,点击Format (2)在弹出的对话框中点击是(Y) (3)等待格式化完成,在弹出的对话框中点击确定

3.安装资料光盘下01_tools/ win32diskimager-1.0.0-install.exe软件,安装完成后打开!
4.使用wind32diskimage烧写编译后的系统镜像,烧写步骤如下所示!

100ask am335x SD p 001.png 100ask am335x SD p 002.png 100ask am335x SD p 003.png
(1)选中需要烧写的SD卡设备,点击文件图标选择系统镜像文件,最后点击写入按钮开始烧写 (2)此时弹出烧写对话框,点击Yes按钮,继续烧写, 等待任务进度执行到100%) 烧写成功后,弹出写入成功,此时点击OK

编译firefly linux-sdk系统

编译前配置

下载sdk

  • 配置文件 roc-rk3399-pc.mk:
./build.sh roc-rk3399-pc.mk

文件路径在device/rockchip/rk3399/roc-rk3399-pc.mk

如果配置文件生效会连接到device/rockchip/.BoardConfig.mk,检查该文件可以验证是否配置成功

注意:roc-rk3399-pc.mk为编译生成buildroot固件的配置文件.同时用户也可以通过参考该配置生成新的配置文件来适配自己所需要的固件。

  • 重要配置介绍:(如果需要diy固件,可能需要修改下列配置信息)
# Uboot defconfig
export RK_UBOOT_DEFCONFIG=roc-rk3399-pc   编译uboot配置文件
# Kernel defconfig
export RK_KERNEL_DEFCONFIG=firefly_linux_defconfig   编译kernel配置文件
# Kernel dts
export RK_KERNEL_DTS=rk3399-roc-pc   编译kernel用到的dts
# parameter for GPT table
export RK_PARAMETER=parameter-ubuntu.txt   分区信息(十分重要)
# packagefile for make update image 
export RK_PACKAGE_FILE=rk3399-ubuntu-package-file   打包配置文件
# rootfs image path
export RK_ROOTFS_IMG=xxxx/xxxx.img   根文件系统镜像路径

注意,十分重要!!

默认配置编译buildroot固件,如果想编译其他固件(如ubuntu固件)请执行一下操作:

全自动编译

在配置和搭建环境的工作都做好的前提下:

./build.sh

全自动编译的固件默认会编译一遍buildroot根文件系统。生成固件目录rockdev/,同时会在IMAGE中备份。

部分编译

编译kernel

./build.sh kernel

编译u-boot

./build.sh uboot

生成recovery

recovery分区可省略,若有需要: 编译recovery:

./build.sh recovery

编译rootfs

编译buildroot

./build.sh rootfs

编译ubuntu18.04

ubuntu18.04,可以通过云盘下载:

把得到的镜像放到sdk的根目录处:

  • 1. 解压ubuntu18.04系统镜像
tar -xvf rk3399_ubuntu18.04_LXDE.img.tgz
  • 2. 解压后的文件放到sdk根目录下
mkdir ubunturootfs
mv rk3399_ubuntu18.04_LXDE.img ubunturootfs/
  • 3. 修改roc-rk3399-pc.mk文件
vim device/rockchip/rk3399/roc-rk3399-pc.mk
  • 4. 把RK_ROOTFS_IMG属性改成ubuntu文件系统镜像得路径(也就是rk3399_ubuntu18.04_LXDE.img)
RK_ROOTFS_IMG=ubunturootfs/rk3399_ubuntu18.04_LXDE.img

注意:ubuntu根文件系统镜像存放路径不能错

  • 5. 运行 ./mkfirmware.sh 会自动更新 rockdev/rootfs.img 的链接

固件打包

同步更新各部分镜像

每次打包固件前先确保rockdev/目录下文件链接是否正确: ls -l

├── boot.img -> ~/project/linux_sdk/kernel/boot.img
├── idbloader.img -> ~/project/linux_sdk/u-boot/idbloader.img
├── linaro-rootfs.img
├── MiniLoaderAll.bin -> ~/project/linux_sdk/u-boot/rk3399_loader_v1.14.115.bin
├── misc.img -> ~/project/linux_sdk/device/rockchip/rockimg/wipe_all-misc.img
├── oem.img
├── parameter.txt -> ~/project/linux_sdk/device/rockchip/rk3399/parameter-ubuntu.txt
├── recovery.img -> ~/project/linux_sdk/buildroot/output/rockchip_rk3399_recovery/images/recovery.img
├── rootfs.img -> ~/project/linux_sdk/ubunturootfs/rk3399_ubuntu18.04_LXDE.img
├── trust.img -> ~/project/linux_sdk/u-boot/trust.img
├── uboot.img -> ~/project/linux_sdk/u-boot/uboot.img
└── userdata.img

可以运行./mkfirmware.sh更新链接

./mkfirmware.sh

提示:若不是编译全部的分区镜像,在运行./mkfirmware时,会遇到如下类似情况: error: /home/ljh/proj/linux-sdk/buildroot/output/rockchip_rk3399_recovery/images/recovery.img not found! 表示recovery分区没有编译出镜像,其他的情况类似,如oem.img、userdata.img 上文提到,这些属于可省略分区镜像,可以不用理会。

打包统一固件

注意:打包前请确认tools/linux/Linux_Pack_Firmware/rockdev/package-file是否正确。打包会根据此文件进行分区打包。此文件链接会在./build.sh roc-rk3399-pc.mk 命令时更新,如果配置不对请返回[配置]一节重新配置一次。

整合统一固件

./build.sh updateimg

分区介绍

parameter

parameter.txt包含了固件的分区信息十分重要,你可以在device/rockchip/rk3399目录下找到一些parameter.txt文件,下面以parameter-debian.txt为例子做介绍:

FIRMWARE_VER: 8.1                                                                                                                             
MACHINE_MODEL: RK3399
MACHINE_ID: 007 
MANUFACTURER: RK3399
MAGIC: 0x5041524B
ATAG: 0x00200800
MACHINE: 3399
CHECK_MASK: 0x80
PWR_HLD: 0,0,A,0,1
TYPE: GPT 
CMDLINE:   mtdparts=rk29xxnand:0x00002000@0x00004000(uboot),0x00002000@0x00006000(trust),0x00002000@0x00008000(misc),0x00010000@0x0000a000(boot),0x00010000@0x0001a000(recovery),0x00010000@0x0002a000(backup),0x00020000@0x0003a000(oem),0x00700000@0x0005a000(rootfs),-@0x0075a000(userdata:grow)
uuid:rootfs=614e0000-0000-4b53-8000-1d28000054a9

CMDLINE属性是我们关注的地方。以uboot为例 0x00002000@0x00004000(uboot)0x00004000为uboot分区的起始位置0x00002000为分区的大小。后面的分区规则相同。用户可以根据自己需要增减或者修改分区信息,但是请最少保留uboot,trust,boot,rootfs分区,这是机器能正常启动的前提条件。parameter-ubuntu.txt中使用的就是这样的最简分区方案。

分区介绍:

uboot 分区: 烧写 uboot 编译出来的 uboot.img.
trust 分区: 烧写 uboot 编译出来的 trust.img
misc 分区: 烧写 misc.img。开机检测进入recovery模式.(可省略)
boot 分区: 烧写 kernel 编译出来的 boot.img.包含kernel和设备树信息
recovery 分区: 烧写 recovery.img.(可省略)
backup 分区: 预留,暂时没有用。后续跟 android 一样作为 recovery 的 backup 使用.(可省略)
oem 分区: 给厂家使用,存放厂家的 app 或数据。只读。代替原来音箱的 data 分区。挂载在/oem 目录.(可省略)
rootfs 分区: 存放 buildroot 或者 debian 编出来的 rootfs.img,只读.
userdata 分 区 : 存 放 app 临 时 生 成 的 文 件 或 者 是 给 最 终 用 户 使 用 。 可 读 写 , 挂 载 在
/userdata 目录下.(可省略)

package-file

此文件应当与parameter保持一致,用于固件打包。可以在tools/linux/Linux_Pack_Firmware/rockdev下找到相关文件。以rk3399-ubuntu-package-file为例介绍:

# NAME          Relative path
#
#HWDEF          HWDEF
package-file    package-file
bootloader      Image/MiniLoaderAll.bin
parameter    Image/parameter.txt  
trust           Image/trust.img
uboot           Image/uboot.img
boot            Image/boot.img
rootfs:grow     Image/rootfs.img
backup          RESERVED

以上是SDK编译后生成的镜像文件。根据parameter.txt只打包自己用到的img文件。

编译android固件

编译android 7.1固件

ROC-RK3399-PC产品编译方法

HDMI显示编译

./FFTools/make.sh  -d rk3399-roc-pc -j8 -l ROC_RK3399_PC-userdebug
./FFTools/mkupdate/mkupdate.sh -l ROC_RK3399_PC-userdebug

手动编译ROC-RK3399-PC

  • 编译前执行如下命令配置环境变量:
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
  • 编译kernel:
cd ~/proj/firefly-rk3399/kernel/
make ARCH=arm64 firefly_defconfig
make -j8 ARCH=arm64 rk3399-roc-pc.img
  • 编译uboot:
cd ~/proj/firefly-rk3399/u-boot/
make rk3399_box_defconfig
make ARCHV=aarch64 -j8
  • 编译android:
cd ~/proj/firefly-rk3399/
source build/envsetup.sh
lunch ROC_RK3399_PC-userdebug
make -j8
./mkimage.sh
  • 打包成统一固件 update.img

编译完可以用Firefly官方的脚本打包成统一固件,执行如下命令:

./FFTools/mkupdate/mkupdate.sh update 

打包完成后将在rockdev/Image-ROC_RK3399_PC/下生成统一固件:update.img

在 Windows 下打包统一固件 update.img 也很简单,将编译生成的文件拷贝到 AndroidTool 的 rockdev\Image 目录中,然后运行 rockdev 目录下的 mkupdate.bat 批处理文件即可创建 update.img 并存放到 rockdev\Image 目录里。

  • 生成tf卡启动的固件

编译完可以用Firefly官方的脚本打包成统一固件,执行如下命令:

./FFTools/mkupdate/mkupdate.sh sdboot  

打包完成后将在rockdev/Image-ROC_RK3399_PC/下生成sdboot固件:SDBOOT-ROC_RK3399_PC_Android7.1.2_MP_181229.img

用瑞芯微 SD_Firmware_Tool 工具创建sd卡启动,首先选择设备,在功能模式选择sd启动,然后选择上传生成的固件,最后点击创建,界面如下图:

_images/android_compile_android1.png

烧写分区映像

编译的时候执行 ./mkimage.sh 会重新打包 boot.img 和 system.img, 并将其它相关的映像文件拷贝到目录 rockdev/Image-ROC_RK3399_PC/ 中。以下列出一般固件用到的映像文件:

   boot.img :Android 的初始文件映像,负责初始化并加载 system 分区。
   kernel.img :内核映像。
   misc.img :misc 分区映像,负责启动模式切换和急救模式的参数传递。
   parameter.txt :emmc的分区信息
   recovery.img :急救模式映像。
   resource.img :资源映像,内含开机图片和内核的设备树信息。
   system.img :Android 的 system 分区映像,ext4 文件系统格式。
   trust.img :休眠唤醒相关的文件
   rk3399_loader_v1.08.106.bin :Loader文件
   uboot.img :uboot文件

请参照 如何升级固件 一文来烧写分区映像文件。

如果使用的是 Windows 系统,将上述映像文件拷贝到 AndroidTool (Windows 下的固件升级工具)的 rockdev\Image 目录中,之后参照升级文档烧写分区映像即可,这样的好处是使用默认配置即可,不用修改文件的路径。

update.img 方便固件的发布,供终端用户升级系统使用。一般开发时使用分区映像比较方便。

编译android 8.1固件

使用 Firefly 脚本编译

  • 编译内核
./FFTools/make.sh -k -j8
  • 编译 U-Boot
./FFTools/make.sh -u -j8
  • 编译 Android

./FFTools/make.sh -a -j8

  • 编译全部

如下指令会编译出内核, U-Boot 以及 Android:

./FFTools/make.sh -j8

不使用脚本编译

编译之前请先执行如下命令配置好环境变量:

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
  • 编译内核
make ARCH=arm64 firefly_defconfig
make -j8 ARCH=arm64 rk3399-roc-pc.img
  • 编译 U-Boot
make rk3399_defconfig
make ARCHV=aarch64 -j8
  • 编译 Android
source build/envsetup.sh
lunch ROC_RK3399_PC-userdebug
make installclean
make -j8
./mkimage.sh

打包 RK 固件

  • 在 Linux 下打包固件

编译完成后使用 Firefly 官方脚本即可打包所有的分区映像成 RK固件:

./FFTools/mkupdate/mkupdate.sh update

最终生成的文件是 rockdev/Image-ROC_RK3399_PC/update.img.

  • 在 Windows 下打包固件

在 Windows 下打包 RK 固件 update.img 也是很简单的:

  1. 拷贝所有在 rockdev/Image-ROC_RK3399_PC/ 目录下编译好的文件到 AndroidTool 的 rockdev\Image 目录下。
  2. 运行在 AndroidTool 的 rockdev 目录下的 mkupdate.bat 文件。
  3. 在 rockdev\Image 目录将会生成 update.img。

分区映像

update.img 是发布给最终用户的固件,方便升级开发板。而在实际开发中,更多的时候是修改并烧写单个分区映像文件,这样做大大节省开发时间。

下表总结了在各个编译阶段所生成的分区映像文件:


|------------------|---------------------|-----------| | Stage | Product | Partition | |------------------|---------------------|-----------| | Compiling Kernel | kernel/kernel.img | kernel | | | kernel/resource.img | resource | |------------------|---------------------|-----------| | Compiling U-Boot | u-boot/uboot.img | uboot | |------------------|---------------------|-----------| | ./mkimage.sh | boot.img | boot | | | system.img | system | |------------------|---------------------|-----------|


注意,执行 ./mkimage.sh 后, boot.img 和 system.img 将会被重新编译并打包到目录 out/target/product/ROC_RK3399_PC/ 下,所有生成的映像文件将会拷贝到目录 rockdev/Image-ROC_RK3399_PC/` 下。

如下是映像文件列表:

   boot.img: Android 的 initramfs 映像,包含Android根目录的基础文件系统,它负责初始化和加载系统分区。
   system.img: ext4 文件系统格式的 Android 文件系统分区映像。
   kernel.img: 内核映像。
   resource.img: Resource 映像, 包含启动图片和内核设备树。
   misc.img: misc 分区映像, 负责启动模式的切换和急救模式参数的传递。
   recovery.img: Recovery 模式映像。
   rk3399_loader_v1.12.112.bin: Loader 文件。
   uboot.img: U-Boot 映像文件。
   trust.img: Arm trusted file (ATF) 映像文件。
   parameter.txt: 分区布局和内核命令行。
   vendor.img: TODO
   oem.img: TODO
   baseparameter.img: TODO