View source for Android BSP User Guide for mt8395 series 11.0


== Android BSP Version ==

Android 11.0

Kernel 4.19.127

== Introduction ==

This document describes how to work with the RISC and ELAA Android 11.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 ==

=== Required equipment and software ===

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

=== Install Ubuntu ===

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

== <font color="#0070c0">Docker install and setting</font> ==

'''If you don't have docker in your system, then you can follow the below &nbsp;steps to install docker and run it first.'''

=== To install Docker Engine on your platform ===

:Please refer to&nbsp;[https://docs.docker.com/engine/installation/ Docker Installation Guide]&nbsp;for details 

=== To pull&nbsp;[https://hub.docker.com/r/advrisc/u18.04-mt8395abv1/ ubuntu 18.04 image from Docker Hub]&nbsp; ===

:<code>$ docker pull advrisc/u18.04-mt8395abv1</code> 

== Run Docker example ==

Step1 Run docker container (example)
<pre>&nbsp;$&nbsp;sudo docker run --privileged -it --name android_R11 -v /home/bsp/android-bsp:/home/adv/BSP:rw advrisc/u18.04-mt8395abv1:latest /bin/bash</pre>

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

== Getting Android Source Code ==


=== Step1&nbsp;: To get the part of unmodified BSP and unzip it ===

Download the android-bsp-alps-release-r0.mp6-aiot-v1.81.tar.gz file:[[https://www.dropbox.com/scl/fo/tptbp080ohgckjdbr3vrq/ALU41-Yzx1t7U-6BOYyK_FI/genio-1200?dl=0&preview=android-bsp-alps-release-r0.mp6-aiot-v1.81.tar.gz&rlkey=647rksjn60zyqj4i134tflsuj&subfolder_nav_tracking=1 android-bsp-alps-release-r0.mp6-aiot-v1.81.tar.gz]] and the md5sum of android-bsp-alps-release-r0.mp6-aiot-v1.81.tar.gz is '''3bf9f36721cd3a5a103e2ffa98110705'''
<pre> $ tar -zxvf android-bsp-alps-release-r0.mp6-aiot-v1.81.tar.gz
</pre>

=== Step2&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>$ cd android-bsp
$ repo init -u https://AIM-Linux@dev.azure.com/AIM-Linux/RISC-MT8395-Android11/_git/android-manifest -b adv_alps-release-r0.mp6-aiot-V1.81 -m [ release_version.xml ]
$ repo sync
</pre>
<pre class="de1">=== The release_version.xml as follows：
RSB-3810 for default_alps-release-r0.mp6-aiot-V1.81.xml (latest commit) or mt8395AB10034.xml
</pre>

== Building Android 11.0 image for EMMC ==

If your product is RSB-3810, the product name is rsb3810a1

$PRODUCT = rsb3810a1

== Build Instructions ==

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 RSB-3810, you will be send command full_mt8395_rsb3810a1-userdebug
<pre>$ lunch full_mt8395_$PRODUCT-userdebug
</pre>

'''To build all image (Need to build kernel first)'''

Perform the following command in terminal console
<pre>$ make 2>&1 | tee build-log.ext
</pre>

'''To build preloader'''

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

'''To build lk'''

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

'''To build kernel'''

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

'''To build boot image'''

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

'''To build system image'''

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

'''To build dtbo image'''

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

<span style="color:#cc0000;">'''Output directory: out/target/product/mt8395_$PRODUCT'''</span>

&nbsp;

== Burning image ==

=== 1. Get SF Flash Tool V5 ===

Download link:[https://www.dropbox.com/scl/fo/tptbp080ohgckjdbr3vrq/AGCVRbcmU_-ByCNMFjskvoc/genio-1200/Flash_Tool?dl=0&rlkey=647rksjn60zyqj4i134tflsuj&subfolder_nav_tracking=1 [Flash_Tool]]

'''Supported OS&nbsp;:'''

*Windows 7 
*Windows 10 
*Ubuntu 16.x 
*Ubuntu 18.x 

=== 2. Connect the usb type A to host computer and device&nbsp;type A port: ===

[[File:2022-11-25 173838.jpg|400px|2022-11-25 173838.jpg]]

&nbsp;

=== 3. Burning image by SF Flash Tool V5: ===

step 1 You need to download the file and below. File path:out/target/product/mt8395_rsb3810a1
<pre>MT8195_Android_scatter.txt
preloader_mt8395_rsb3810a1.bin
vbmeta.img
vbmeta_system.img
vbmeta_vendor.img
spmfw.img
pi_img.img
dpm.img
scp.img
sspm.img
mcupm.img
cam_vpu1.img 
cam_vpu2.img 
cam_vpu3.img
lk.img 
boot.img
dtbo.img
tee.img
logo.bin
super.img
userdata.img
</pre>

step 2

[[File:2022-11-25 174501.jpg|400px|2022-11-25 174501.jpg]]

(1) Select the&nbsp;'''MT8195_Android_scatter.txt''' file

(2)&nbsp;Select the'''Format All + Download'''

(3) Click the&nbsp;'''Download '''button

=== 4. Reboot the device and start to burn all&nbsp;image ===

=== 5. ADB ===

Step1&nbsp;:RSB-3810 Device setting

Setting-->Developer options-->USB debugging to "on"

Step2&nbsp;:
<pre>console:/ $ su
console:/ # setprop service.adb.tcp.port 5555
console:/ # stop adbd
console:/ # start adbd
console:/ # ifconfig
</pre>

Step3&nbsp;:adb platform-tools
<pre>D:\platform-tools>ping 172.22.28.102
D:\platform-tools>adb connect 172.22.28.102:5555
D:\platform-tools>adb root
D:\platform-tools>adb shell
</pre>

== Debug port ==

Baudrate: 921600
<div id="gtx-trans" style="position: absolute; left: 143px; top: 1273.12px;"><div class="gtx-trans-icon">&nbsp;</div> </div>