View source for IoTGateway/BSP/Android/User Guide 10.0.0 For i.MX8

=  =

== Contents ==

&nbsp;[[http://ess-wiki.advantech.com.tw/view/IoTGateway/BSP/Android/Android_BSP_User_Guide_10.0.0# hide]]&nbsp;

*[http://ess-wiki.advantech.com.tw/view/IoTGateway/BSP/Android/Android_BSP_User_Guide_10.0.0#Android_BSP_Version 1&nbsp;Android BSP Version]
*[http://ess-wiki.advantech.com.tw/view/IoTGateway/BSP/Android/Android_BSP_User_Guide_10.0.0#Introduction 2&nbsp;Introduction]
*[http://ess-wiki.advantech.com.tw/view/IoTGateway/BSP/Android/Android_BSP_User_Guide_10.0.0#Setup_Ubuntu_Host_Computer 3&nbsp;Setup Ubuntu Host Computer]
**[http://ess-wiki.advantech.com.tw/view/IoTGateway/BSP/Android/Android_BSP_User_Guide_10.0.0#Required_equipment_and_software 3.1&nbsp;Required equipment and software]
**[http://ess-wiki.advantech.com.tw/view/IoTGateway/BSP/Android/Android_BSP_User_Guide_10.0.0#Install_Ubuntu 3.2&nbsp;Install Ubuntu]
*[http://ess-wiki.advantech.com.tw/view/IoTGateway/BSP/Android/Android_BSP_User_Guide_10.0.0#Run_Docker_example 4&nbsp;Run Docker example]
**[http://ess-wiki.advantech.com.tw/view/IoTGateway/BSP/Android/Android_BSP_User_Guide_10.0.0#Install_docker_and_Use_docker 4.1&nbsp;Install docker and Use docker]
**[http://ess-wiki.advantech.com.tw/view/IoTGateway/BSP/Android/Android_BSP_User_Guide_10.0.0#To_pull_Docker_image_from_Docker_Hub 4.2&nbsp;To pull Docker image from Docker Hub]
*[http://ess-wiki.advantech.com.tw/view/IoTGateway/BSP/Android/Android_BSP_User_Guide_10.0.0#Getting_Android_Source_Code 5&nbsp;Getting Android Source Code]
**[http://ess-wiki.advantech.com.tw/view/IoTGateway/BSP/Android/Android_BSP_User_Guide_10.0.0#Related_version_information: 5.1&nbsp;Related version information:]
*[http://ess-wiki.advantech.com.tw/view/IoTGateway/BSP/Android/Android_BSP_User_Guide_10.0.0#Building_Android_10.0.0.C2.A0image_for_SD_card 6&nbsp;Building Android 10.0.0&nbsp;image for SD card]
**[http://ess-wiki.advantech.com.tw/view/IoTGateway/BSP/Android/Android_BSP_User_Guide_10.0.0#Build_Instructions 6.1&nbsp;Build Instructions]
*[http://ess-wiki.advantech.com.tw/view/IoTGateway/BSP/Android/Android_BSP_User_Guide_10.0.0#Burning_image 7&nbsp;Burning image]
**[http://ess-wiki.advantech.com.tw/view/IoTGateway/BSP/Android/Android_BSP_User_Guide_10.0.0#SD_card_boot 7.1&nbsp;SD card boot]

== Android BSP Version[[http://ess-wiki.advantech.com.tw/wiki/index.php?title=IoTGateway/BSP/Android/Android_BSP_User_Guide_9.0.0&action=edit&section=1 edit]] ==

Android 10.0.0_r35

== Introduction[[http://ess-wiki.advantech.com.tw/wiki/index.php?title=IoTGateway/BSP/Android/Android_BSP_User_Guide_9.0.0&action=edit&section=2 edit]] ==

This document describes how to work with the RISC and ELAA Android 10.0.0&nbsp;Board Support Package (BSP) release. The BSP includes bootloaders; the Android Linux kernel and root file system; and tools and documentation to ease the development, deployment, and execution of Android-based systems.

== Setup Ubuntu Host Computer[[http://ess-wiki.advantech.com.tw/wiki/index.php?title=IoTGateway/BSP/Android/Android_BSP_User_Guide_9.0.0&action=edit&section=3 edit]] ==

=== Required equipment and software[[http://ess-wiki.advantech.com.tw/wiki/index.php?title=IoTGateway/BSP/Android/Android_BSP_User_Guide_9.0.0&action=edit&section=4 edit]] ===

*Ubuntu 18.04 LTS 64bit for Android build host OS
*130G bytes free disk spaces for build image

=== Install Ubuntu[[http://ess-wiki.advantech.com.tw/wiki/index.php?title=IoTGateway/BSP/Android/Android_BSP_User_Guide_9.0.0&action=edit&section=5 edit]] ===

*IMPORTANT! You must be able to log in as root or use sudo to have root permissions during the installation.

Go to&nbsp;[http://releases.ubuntu.com/16.04/ [1]] and download 64-bit PC (AMD64) desktop image:&nbsp;[http://releases.ubuntu.com/16.04/ubuntu-16.04.6-desktop-amd64.iso [2]] for the installation.

== Run Docker example[[http://ess-wiki.advantech.com.tw/wiki/index.php?title=IoTGateway/BSP/Android/Android_BSP_User_Guide_9.0.0&action=edit&section=6 edit]] ==

Step1 Run docker container (example)
<pre>&nbsp;$&nbsp;docker run -it --name android_q10 -v /home/bsp/myandroid:/home/adv/BSP:rw advrisc/u18.04-rk3399abv10 /bin/bash</pre>

Step2 In container, change the user. (example)
<pre> adv@7cc0fa834366:~$ sudo chown adv:adv -R BSP</pre>

=== Install docker and Use docker[[http://ess-wiki.advantech.com.tw/wiki/index.php?title=IoTGateway/BSP/Android/Android_BSP_User_Guide_9.0.0&action=edit&section=7 edit]] ===

Please use docker environment to compiler Android 10.0.0

*Android 10.0.0 Docker
*Image Repository&nbsp;: advrisc/u18.04-rk3399abv10
*Image Tag&nbsp;: lastest

Reference:&nbsp;[http://ess-wiki.advantech.com.tw/view/IoTGateway/Docker [3]]

=== To pull Docker image from Docker Hub[[http://ess-wiki.advantech.com.tw/wiki/index.php?title=IoTGateway/BSP/Android/Android_BSP_User_Guide_9.0.0&action=edit&section=8 edit]] ===

*docker pull advrisc/advrisc/u18.04-rk3399abv10
*docker run --name imx8ABV10 -it advrisc/u18.04-rk3399abv10&nbsp;/bin/bash

== Getting Android Source Code[[http://ess-wiki.advantech.com.tw/wiki/index.php?title=IoTGateway/BSP/Android/Android_BSP_User_Guide_9.0.0&action=edit&section=9 edit]] ==

=== Related version information:[[http://ess-wiki.advantech.com.tw/wiki/index.php?title=IoTGateway/BSP/Android/Android_BSP_User_Guide_9.0.0&action=edit&section=10 edit]] ===

*Android 10.0.0_r35
*kernel Yocto-3.0
*U-Boot Yocto-3.0

Step1&nbsp;: To pull down the Android source tree to your working directory from the repositories as specified in the default manifest
<pre>$ git config --global user.name "Your Name" 
$ git config --global user.email you@example.com</pre>
<pre>$ mkdir myandroid
</pre>

$ mkdir bin

$ cd myandroid/ $ curl [https://storage.googleapis.com/git-repo-downloads/repo https://storage.googleapis.com/git-repo-downloads/repo] > ../bin/repo

$ chmod a+x ../bin/repo $ ../bin/repo init -u [https://github.com/ADVANTECH-Corp/android-manifest.git https://github.com/ADVANTECH-Corp/android-manifest.git] -b&nbsp;q10.0.0_2.3.0-ga release_version.xml

$ ../bin/repo sync
<pre class="de1">=== The release_version.xml  as follows：
ROM3720 for adv_android-10.0.0_2.3.0.xml
</pre>

Step2: Patch to Android Q10.0.0.0
<pre>$ cd ~/myandroid/vendor/nxp-opensource/uboot-imx/
</pre>

$ patch -p1 < ../../../patches_android-10.0.0_r35/10001-Linux_Yocto_5.4.24_2.1.0-to-android-10.0.0_r35.patch

$ cd ~/myandroid/vendor/nxp-opensource/kernel_imx/

$ patch -p1 < ../../../patches_android-10.0.0_r35/10001-Uboot_Yocto_5.4.24_2.1.0-to-android-10.0.0_r35.patch

$ cd myandroid

== Building Android 10.0.0&nbsp;image for SD card[[http://ess-wiki.advantech.com.tw/wiki/index.php?title=IoTGateway/BSP/Android/Android_BSP_User_Guide_9.0.0&action=edit&section=11 edit]] ==

If your product is ROM-3720, the product name is rom3720_a1

$PRODUCT = rsb3720_a1



=== Build Instructions[[http://ess-wiki.advantech.com.tw/wiki/index.php?title=IoTGateway/BSP/Android/Android_BSP_User_Guide_9.0.0&action=edit&section=12 edit]] ===

Set the $JAVA_HOME environment variable
<pre>$ export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64/
</pre>

Set up the environment for building. This only configures the current terminal.
<pre>$ source build/envsetup.sh
</pre>

Execute the Android lunch command. In this example, the setup is for the production image of Advantech RISC platfrom device with user type. If you devices is ROM3720, you will be send command rom3720_a1-userdebug
<pre>$ lunch $PRODUCT-userdebug
</pre>

'''To build boot loader'''

Perform the following command in terminal console
<pre>$ ./imx-make.sh bootloader -j8
</pre>

:

The two files, u-boot_crc.bin & u-boot_crc.bin.crc, will be located in directory, ./out/target/product/product_name

'''To build boot image'''

Perform the following command in terminal console
<pre>$ make bootimage -j8
</pre>

'''To build dtbo&nbsp;image (kernel device tree)'''

Perform the following command in terminal console
<pre>$ make dtboimage -j8
</pre>

'''To build system image'''

Perform the following command in terminal console
<pre>$ make -j8
</pre>

== Burning image[[http://ess-wiki.advantech.com.tw/wiki/index.php?title=IoTGateway/BSP/Android/Android_BSP_User_Guide_9.0.0&action=edit&section=13 edit]] ==

=== SD card boot[[http://ess-wiki.advantech.com.tw/wiki/index.php?title=IoTGateway/BSP/Android/Android_BSP_User_Guide_9.0.0&action=edit&section=14 edit]] ===

'''Go to those built&nbsp;image file directory'''

For daily build
<pre>$ cd ~/image/
</pre>

For local build
<pre>$ cd ~/out/target/product/PRODUCT_NAME/
</pre>

'''Enter flash command'''

For ROM-3720
<pre>$ sudo ./fsl-sdcard-partition.sh -super -f imx8mp /dev/sdX (X&nbsp;: SD card device drive)
</pre>