Difference between revisions of "Debian BSP User Guide for rk3399 risc series"
From ESS-WIKI
Yunjin.jiang (talk | contribs) |
Yunjin.jiang (talk | contribs) |
||
| Line 1: | Line 1: | ||
| − | + | == Android BSP Version == | |
| − | + | ||
| − | + | Android 7.1.2 | |
| − | + | ||
| − | + | Kernel 4.4.126 | |
| − | + | ||
| − | + | == Build Environment on Host == | |
| − | + | ||
| − | + | Currently, we adopt [https://www.docker.com/ Docker] as build environment. | |
| − | <pre>docker pull advrisc/u16.04-imx6abv5:20170523& | + | |
| − | + | You can get the latest version of [https://hub.docker.com/r/advrisc/u16.04-imx6abv5 advrisc/u16.04-imx6abv5] Docker image for developing Rockchip RK3399 projects. | |
| − | + | ||
| − | + | Docker command: | |
| − | <pre>& | + | <pre>docker pull advrisc/u16.04-imx6abv5:20170523 </pre> |
| + | |||
| + | == Run Docker example == | ||
| + | |||
| + | Step1 Run docker container (example) | ||
| + | <pre> $ docker run -it --name android_n7 -v /home/bsp/myandroid:/home/adv/BSP:rw advrisc/u16.04-imx6abv5:20170523 /bin/bash | ||
</pre> | </pre> | ||
| − | + | ||
| − | + | Step2 In container, change the user. (example) | |
| − | + | ||
| + | |||
<pre> adv@7cc0fa834366:~$ sudo chown adv:adv -R BSP | <pre> adv@7cc0fa834366:~$ sudo chown adv:adv -R BSP | ||
</pre> | </pre> | ||
| − | + | ||
| + | == Getting Android Source Code == | ||
<pre>$ cd ~/code | <pre>$ cd ~/code | ||
$ sudo git clone https://github.com/rockchip-linux/repo.git | $ sudo git clone https://github.com/rockchip-linux/repo.git | ||
$ mkdir rk3399_android_n7 | $ mkdir rk3399_android_n7 | ||
$ cd rk3399_android_n7 | $ cd rk3399_android_n7 | ||
| − | $ git config --global user.name | + | $ git config --global user.name "Your Name" |
$ git config --global user.email you@example.com | $ git config --global user.email you@example.com | ||
$ ../repo/repo init -u https://gitlab.wise-paas.com/RISC/android-manifest.git -b android-7.1.2 -m default.xml | $ ../repo/repo init -u https://gitlab.wise-paas.com/RISC/android-manifest.git -b android-7.1.2 -m default.xml | ||
| Line 31: | Line 38: | ||
$ | $ | ||
</pre> | </pre> | ||
| − | + | ||
| + | == Build Instructions == | ||
<pre>$ export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64 | <pre>$ export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64 | ||
$ export PATH=$JAVA_HOME/bin:$PATH | $ export PATH=$JAVA_HOME/bin:$PATH | ||
$ export CLASSPATH=.:$JAVA_HOME/lib:$JAVA_HOME/lib/tools.jar | $ export CLASSPATH=.:$JAVA_HOME/lib:$JAVA_HOME/lib/tools.jar | ||
</pre> | </pre> | ||
| − | + | ||
| + | == Build U-boot == | ||
<pre>$ cd u-boot | <pre>$ cd u-boot | ||
$ make rk3399_rsb4710a2_2G_defconfig | $ make rk3399_rsb4710a2_2G_defconfig | ||
$ make ARCHV=aarch64 | $ make ARCHV=aarch64 | ||
</pre> | </pre> | ||
| − | + | ||
| − | + | == Build Kernel == | |
| + | |||
| + | === Build for RSB4710 platform === | ||
<pre>$ cd kernel | <pre>$ cd kernel | ||
$ make ARCH=arm64 rk3399_adv_defconfig -j8 | $ make ARCH=arm64 rk3399_adv_defconfig -j8 | ||
$ make ARCH=arm64 rk3399-rsb4710-a2.img -j12 | $ make ARCH=arm64 rk3399-rsb4710-a2.img -j12 | ||
</pre> | </pre> | ||
| − | + | ||
| + | == Build Android == | ||
<pre>$ source build/envsetup.sh | <pre>$ source build/envsetup.sh | ||
$ lunch rk3399_rsb4710-userdebug | $ lunch rk3399_rsb4710-userdebug | ||
| − | $ make -j4 2& | + | $ make -j4 2>&1 | tee build-log.txt |
</pre> | </pre> | ||
| − | + | ||
| + | == Push all image to rockdev folder == | ||
<pre>$ ./mkimage.sh | <pre>$ ./mkimage.sh | ||
</pre> | </pre> | ||
| − | + | ||
| − | + | All image in rockdev/Image-rk3399_rsb4710 ./mkimage.sh at previous step will repack boot.img and system.img, and copy other related image files to the rockdev/Image-rk3399_rsb4710/ directory. The common image files are listed below: | |
| − | + | ||
| − | <pre># boot.img & | + | |
| − | # kernel.img & | + | <pre># boot.img : Android's initramfs, to initialize and mount system partition. |
| − | # misc.img & | + | # kernel.img : Kernel image. |
| − | # recovery.img & | + | # misc.img : Misc partition image, to switch boot mode and pass parameter in recovery mode. |
| − | # resource.img & | + | # recovery.img : Recovery mode image. |
| − | # system.img & | + | # resource.img : Resource image, containing boot logo and kernel's device tree info. |
| + | # system.img : System partition image with ext4 filesystem format. | ||
# uboot.img ：uboot | # uboot.img ：uboot | ||
# trust.img ：File about sleep | # trust.img ：File about sleep | ||
| Line 69: | Line 83: | ||
</pre> | </pre> | ||
| − | + | ||
| − | + | == Create OTA zip == | |
| − | + | ||
| + | '''<big>Step1</big>''' After Build Android, you will be create image for OTA update. | ||
<pre>$ ./mkimage.sh ota | <pre>$ ./mkimage.sh ota | ||
</pre> | </pre> | ||
| − | + | ||
| − | + | '''<big>Step2</big>''' Package the update.zip | |
<pre>$ make otapackage | <pre>$ make otapackage | ||
</pre> | </pre> | ||
| − | + | ||
| − | + | '''<big>Step3 </big>'''Rename the out/target/product/rk3399_rsb4710/rk3399_rsb4710-ota-eng.adv.zip to update.zip | |
<pre>$mv out/target/product/rk3399_rsb4710/rk3399_rsb4710-ota-eng.adv.zip update.zip | <pre>$mv out/target/product/rk3399_rsb4710/rk3399_rsb4710-ota-eng.adv.zip update.zip | ||
</pre> | </pre> | ||
| − | + | ||
| − | + | Note : "adv" in rk3399_rsb4710-ota-eng.adv.zip is the name of your building PC. | |
| − | + | ||
| − | + | '''<big>Step4 </big>'''Copy the update.zip to SD or USB disk. | |
| − | + | ||
| − | + | '''<big>Step5 </big>'''Follow Android update. | |
| − | + | ||
| − | + | == How to do about update RSB4710 Platform? == | |
| − | + | ||
| − | + | There are three ways to update images： | |
| − | + | ||
| − | + | === '''[[1._Using_AndroidToool.|1._Using_AndroidToool.]]''' === | |
| − | + | ||
| − | + | There is no limitation by this way. | |
| − | + | ||
| − | + | === '''[[2._Using_storage（such_sd_or_USB_disk）with_update.zip_in_it.|2._Using_storage（such sd_or_USB_disk）with_update.zip_in_it.]]''' === | |
| − | + | ||
| − | + | There are some limitations： | |
| − | + | ||
| − | + | （1）The device must be able to boot up to Android system. | |
| − | + | ||
| − | + | （2）Only update images from the same os, eg : | |
| + | |||
| + | Android6.0 upgrade to Android6.0 or Android7.1 upgrade to Android7.1. | ||
| + | |||
| + | （3）Using update.zip to upgrade. (see more detail in "Create OTA zip" on how to create update.zip) | ||
| + | |||
| + | === '''[[3._Using_bootup_sd_disk_made_by_SDDiskTool.|3._Using_bootup_sd_disk made_by SDDiskTool.]]''' === | ||
| + | |||
| + | （1）Only update images from the same os, eg : | ||
| + | |||
| + | Android6.0 upgrade to Android6.0 or Android7.1 upgrade to Android7.1. | ||
| + | |||
| + | （2）Using update.img to upgrade. | ||
Revision as of 03:19, 7 July 2020
Contents
Android BSP Version
Android 7.1.2
Kernel 4.4.126
Build Environment on Host
Currently, we adopt Docker as build environment.
You can get the latest version of advrisc/u16.04-imx6abv5 Docker image for developing Rockchip RK3399 projects.
Docker command:
docker pull advrisc/u16.04-imx6abv5:20170523
Run Docker example
Step1 Run docker container (example)
$ docker run -it --name android_n7 -v /home/bsp/myandroid:/home/adv/BSP:rw advrisc/u16.04-imx6abv5:20170523 /bin/bash
Step2 In container, change the user. (example)
adv@7cc0fa834366:~$ sudo chown adv:adv -R BSP
Getting Android Source Code
$ cd ~/code $ sudo git clone https://github.com/rockchip-linux/repo.git $ mkdir rk3399_android_n7 $ cd rk3399_android_n7 $ git config --global user.name "Your Name" $ git config --global user.email you@example.com $ ../repo/repo init -u https://gitlab.wise-paas.com/RISC/android-manifest.git -b android-7.1.2 -m default.xml $ ../repo/repo sync $ ../repo/repo forall -c git checkout -b local --track advantech-gitlab/android-7.1.2 $
Build Instructions
$ 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
Build U-boot
$ cd u-boot $ make rk3399_rsb4710a2_2G_defconfig $ make ARCHV=aarch64
Build Kernel
Build for RSB4710 platform
$ cd kernel $ make ARCH=arm64 rk3399_adv_defconfig -j8 $ make ARCH=arm64 rk3399-rsb4710-a2.img -j12
Build Android
$ source build/envsetup.sh $ lunch rk3399_rsb4710-userdebug $ make -j4 2>&1 | tee build-log.txt
Push all image to rockdev folder
$ ./mkimage.sh
All image in rockdev/Image-rk3399_rsb4710 ./mkimage.sh at previous step will repack boot.img and system.img, and copy other related image files to the rockdev/Image-rk3399_rsb4710/ directory. The common image files are listed below:
# boot.img : Android's initramfs, to initialize and mount system partition. # kernel.img : Kernel image. # misc.img : Misc partition image, to switch boot mode and pass parameter in recovery mode. # recovery.img : Recovery mode image. # resource.img : Resource image, containing boot logo and kernel's device tree info. # system.img : System partition image with ext4 filesystem format. # uboot.img ：uboot # trust.img ：File about sleep # MiniLoaderAll.bin ：Loader
Create OTA zip
Step1 After Build Android, you will be create image for OTA update.
$ ./mkimage.sh ota
Step2 Package the update.zip
$ make otapackage
Step3 Rename the out/target/product/rk3399_rsb4710/rk3399_rsb4710-ota-eng.adv.zip to update.zip
$mv out/target/product/rk3399_rsb4710/rk3399_rsb4710-ota-eng.adv.zip update.zip
Note : "adv" in rk3399_rsb4710-ota-eng.adv.zip is the name of your building PC.
Step4 Copy the update.zip to SD or USB disk.
Step5 Follow Android update.
How to do about update RSB4710 Platform?
There are three ways to update images：
1._Using_AndroidToool.
There is no limitation by this way.
2._Using_storage（such sd_or_USB_disk）with_update.zip_in_it.
There are some limitations：
（1）The device must be able to boot up to Android system.
（2）Only update images from the same os, eg :
Android6.0 upgrade to Android6.0 or Android7.1 upgrade to Android7.1.
（3）Using update.zip to upgrade. (see more detail in "Create OTA zip" on how to create update.zip)
3._Using_bootup_sd_disk made_by SDDiskTool.
（1）Only update images from the same os, eg :
Android6.0 upgrade to Android6.0 or Android7.1 upgrade to Android7.1.
（2）Using update.img to upgrade.