View source for IoTGateway/BSP/Android/Android BSP User Guide 7.1.2 for rk

== <span style="color:#0070c0">Android BSP Version</span> ==

Android 7.1.2

== <font color="#0070c0">Build Environment on Host</font> ==

Currently, we adopt [https://www.docker.com/ Docker] as build environment.

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:
<syntaxhighlight lang="bash">docker pull advrisc/u16.04-imx6abv5:20170523 </syntaxhighlight>
== <span style="color:#0070c0">Run Docker example</span> ==

Step1 Run docker container (example)
<syntaxhighlight lang="bash"> $ docker run -it --name android_n7 -v /home/bsp/myandroid:/home/adv/BSP:rw advrisc/u16.04-imx6abv5:20170523 /bin/bash
</syntaxhighlight>Step2 In container, change the user. (example)

<syntaxhighlight lang="bash"> adv@7cc0fa834366:~$ sudo chown adv:adv -R BSP
</syntaxhighlight>
== <span style="color:#0070c0">Getting Android Source Code</span> ==

<span style="font-size:medium">'''<span style="font-family: times new roman,times,serif"><small>To pull down the Android source tree to your working directory from the repositories as specified in the default manifest</small></span>'''</span>
<syntaxhighlight lang="bash">$ mkdir myandroid
$ mkdir bin
$ cd myandroid/
$ curl https://storage.googleapis.com/git-repo-downloads/repo > ../bin/repo
--------------------------------------------------------------------------------------------------
some time will be get the error message error [Errno 101] Network is unreachable
you can try
$ git clone https://gerrit-googlesource.lug.ustc.edu.cn/git-repo
$ cp -a git-repo/repo ../bin 
--------------------------------------------------------------------------------------------------
$ chmod a+x ../bin/repo
$ ../bin/repo init -u https://gitlab.wise-paas.com/Rockchip/android-manifest.git -b android-7.1.2
or
$ ../bin/repo init -u https://gitlab.wise-paas.com/Rockchip/android-manifest.git -b android-mid
or for deviceON + imm
$ ../bin/repo init -u https://gitlab.wise-paas.com/Rockchip/android-manifest.git -b android-imm
or for DS211
$ ../bin/repo init -u https://gitlab.wise-paas.com/Rockchip/android-manifest.git -b android-7.1.2_r6_ds211
or for Chengdu Airport
$ ../bin/repo init -u https://gitlab.wise-paas.com/Rockchip/android-manifest.git -b android-7.1.2_r6_ds211cd
$ ../bin/repo sync
</syntaxhighlight>

== <span style="color:#0070c0">Build Instructions</span> ==


<syntaxhighlight lang="bash">$ 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
</syntaxhighlight>
== <span style="color:#0070c0">Build U-boot</span> ==


<syntaxhighlight lang="bash">$ cd u-boot
$ make rk3399_box_defconfig
$ make ARCHV=aarch64 -j12
</syntaxhighlight>
== <span style="color:#0070c0">Build Kernel</span> ==

=== Build for DS-100 platform ===


<syntaxhighlight lang="bash">$ cd kernel
$ make ARCH=arm64 rockchip_ds100_defconfig
$ make ARCH=arm64 rk3399-ds100.img -j16
</syntaxhighlight>
=== Build for DS-100Lite platform ===


<syntaxhighlight lang="bash">$ cd kernel
$ make ARCH=arm64 rockchip_ds100l_defconfig
$ make ARCH=arm64 rk3399-ds100l.img -j16
</syntaxhighlight>
=== Build for DS-211 platform ===


<syntaxhighlight lang="bash">$ cd kernel
$ make ARCH=arm64 rockchip_ds211_defconfig
$ make ARCH=arm64 rk3399-ds211.img -j16
</syntaxhighlight>
== <span style="color:#0070c0">Build Android</span> ==


<syntaxhighlight lang="bash">$ source build/envsetup.sh 
$ lunch rk3399_box-userdebug 
$ make -j4 2>&1 | tee build-log.txt
</syntaxhighlight>
== <span style="color:#0070c0">Push all image to rockdev folder</span> ==


<syntaxhighlight lang="bash">$ ./mkimage.sh
</syntaxhighlight>All image in rockdev/Image-rk3399_box ./mkimage.sh at previous step will repack boot.img and system.img, and copy other related image files to the rockdev/Image-rk3399_box/ directory. The common image files are listed below:

<syntaxhighlight lang="bash"># 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.
# trust.img ：File about sleep
# RK3399MiniLoaderAll_V1.05.bin ：Loader
# uboot.img ：uboot
</syntaxhighlight>


== <span style="color:#0070c0">ADB</span> ==

1. Download adb tool in Windows system. Download path&nbsp;: *[[:File:Platform-tools-latest-windows.zip|Platform-tools-windows]]

2. Check ADB&nbsp;: adb devices

3. ADB Connect&nbsp;: adb shell

== <span style="color:#0070c0">Create OTA zip</span> ==

'''<big>Step1</big>''' After Build Android, you will be create image for OTA update.
<syntaxhighlight lang="bash">$ ./mkimage.sh ota
</syntaxhighlight> '''<big>Step2</big>''' Package the update.zip<syntaxhighlight lang="bash">$ make otapackage
</syntaxhighlight> '''<big>Step3</big>'''Rename the out/target/product/rk3399_box/rk3399_box-ota-eng.adv.zip to update.zip<syntaxhighlight lang="bash">$mv out/target/product/rk3399_box/rk3399_box-ota-eng.adv.zip update.zip
</syntaxhighlight>
'''<big>Step4</big>'''Copy the update.zip to SD or USB disk. 

'''<big>Step5</big>'''Follow Android update.



== <span style="color:#0070c0">How to do about update DS100 and DS100L Platform?</span> ==

Download AndroidTool_Release_v2.42.zip and DriverAssitant_v4.5.zip

[https://github.com/ADVANTECH-Rockchip/rk3399_tools/tree/android_7.1.2 https://github.com/ADVANTECH-Rockchip/rk3399_tools/tree/android_7.1.2]

Step1 Connect with the OTG port and PC.

DS100Lite

[[File:Otg ds100.jpeg|400px|Otg_ds100.jpeg]]

DS100

[[File:20180719 181034.jpg|500px|20180719_181034.jpg]]

Step2 Double click DriverInstall.

[[File:DriverAssitant.jpg|700px|DriverAssitant.jpg]]

Step3 ADB or Debug console, send command "reboot bootloader"

[[File:242.jpg|700px|242.jpg]]

Step4 Select the image path.

[[File:2422.jpg|700px|2422.jpg]]

Step5 Finish the update

[[File:24222.jpg|700px|24222.jpg]]

== <span style="color:#0070c0">How to do about test LAN1 and LAN2?</span> ==

DS100&nbsp;: LAN1 support DHCP , LAN2 support Static IP

LAN2 setting static ip example


<syntaxhighlight lang="bash">$ ip rule add from all lookup main pref 9999
$ ifconfig eth1 172.12.1.2 netmask 255.255.0.0
</syntaxhighlight>


== <span style="color:#0070c0">How to do about update form USB or SD card?</span> ==

Step1 Create the OTA update.zip


<syntaxhighlight lang="bash">$ cd ~/rk3399/
$ make -j4
$ make otapackage -j4
$ ./mkimage.sh ota
</syntaxhighlight>Step2 Rename rk3399/out/target/product/rk3399_box/rk3399_box-ota-eng.adv.zip to update.zip Step3 Copy to the SD or USB disk

<syntaxhighlight lang="bash">$ mv rk3399_box-ota-eng.adv.zip update.zip</syntaxhighlight> Step4 Insert the USB to DS100 or DS100Lite


[[File:OTG1.JPG|400px|OTG1.JPG]]



Step5 Choose the Install



Step6

[[File:OTG2.JPG|400px|OTG2.JPG]]



Step7

[[File:OTG3.JPG|400px|OTG3.JPG]]

==  ==

== <span style="color:#0070c0">SD Card Update Solution</span> ==

RK3399 provide the tools for create the SD Card Update Solution.

'''<big>Step1</big>''' Download tool '''<big>Linux_rockdev_2015-06-17_for_RK3399.zip</big>''' and '''<big>SD_Firmware_Tool._v1.46.zip</big>'''.

Download path&nbsp;: [https://github.com/ADVANTECH-Rockchip/rk3399_tools/tree/android_7.1.2 https://github.com/ADVANTECH-Rockchip/rk3399_tools/tree/android_7.1.2]

'''<big>Step2</big>''' Copy the Linux_rockdev_2015-06-17_for_RK3399.zip to Linux OS PC and Unzip it. You will get the rockdev folder.


<syntaxhighlight lang="bash">$ unzip Linux_rockdev_2015-06-17_for_RK3399.zip
$ cd rockdev
$ sudo chmod -R 755 *
</syntaxhighlight>'''<big>Step3</big>''' Create the new system image and boot image and revoery image. "./mkimage.sh ota"

<syntaxhighlight lang="bash">$ cd ~/rk3399/
$ make -j4
$ ./mkimage.sh ota
</syntaxhighlight> '''<big>Step4</big>''' Copy the "MiniLoaderAll.bin parameter.txt uboot.img trust.img misc.img kernel.img resource.img boot.img recovery.img system.img" to rockdev/Image '''<big>Step5</big>''' Modify the MiniLoader.bin path. (./rkImageMaker -RK330C Image/MiniLoaderAll.bin Image/update.img update.img -os_type:androidos || pause)<syntaxhighlight lang="bash">$ cd rockdev
$ vim mkupdate.sh
</syntaxhighlight> '''<big>Step6</big>''' Run mkupdate.sh<syntaxhighlight lang="bash">$ ./mkupdate.sh

</syntaxhighlight> '''<big>Step7</big>''' Get ok message&nbsp;: Making update.img OK.
[[File:Mkupdate.jpg|600px|Mkupdate.jpg]]



'''<big>Step8</big>''' Unzip SD_Firmware_Tool._v1.46.zip in Windows OS and Copy the update.img to SD_Firmware_Tool



'''<big>Step9</big>''' Please follow the picture (Red word). &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;

Step1 Choose the SD device.

Step2 Choose the "firmware update"

Step3. Choose the update.img path

Step4. Create the update SD

[[File:Sd tool.jpg|400px|Sd tool.jpg]]



'''<big>Step10</big>''' Create the Update SD card Success

[[File:Sd tool success.jpg|400px|Sd tool success.jpg]]

'''<big>Step11</big>''' Please power off in DS100Lite.

'''<big>Step12</big>''' Insert the SD card.

[[File:SD.JPG|400px|SD.JPG]]

'''<big>Step13</big>''' Power on in DS100Lite.

'''<big>Step14</big>''' Installing system update

[[File:UPDATE.JPG|400px|UPDATE.JPG]]

'''<big>Step15</big>''' Please Remove the SD Card when DS100Lite show the message "Doing Action succeeded. please remove the sdcard......".

[[File:REMOVE SD.JPG|400px|REMOVE_SD.JPG]]

'''<big>Step16</big>''' Reset DS100Lite.

== <span style="color:#0070c0">Modules</span> ==

== <span style="color:#0070c0">Change Host/Client in OTG port?</span> ==

*[[IoTGateway/BSP/Android/Change_HOST/Client_Mode_in_OTG_port|Change HOST/Client Mode in OTG port]]

[[File:Ds100.png|800px|Ds100.png]]

[[File:Ds100l.png|800px|Ds100l.png]]
[[Category:Pages with broken file links]]