View source for Building UCM-iMX8M-Mini Android r1.1

= Prerequisites =
Make sure that the necessary packages have been installed.<br/>
<pre>sudo apt-get install xz-utils make flex lib32z1 zip curl</pre>
Install {{filename|repo}} tool:
<pre>mkdir ~/bin
curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
chmod a+x ~/bin/repo
export PATH=${PATH}:~/bin</pre>

= Getting Android source code =
==NXP sources==
* Download the NXP Android sources from this location: [https://www.nxp.com/webapp/sps/download/license.jsp?colCode=P9.0.0_1.0.0_GA_ANDROID_SOURCE&appType=file2&DOWNLOAD_ID=null&lang_cd=en imx-p9.0.0_1.0.0-ga.tar.gz]

* Untar the image:
<pre>tar -C ~/ -xf imx-p9.0.0_1.0.0-ga.tar.gz</pre>

* Download and setup source:
<pre>source ~/imx-p9.0.0_1.0.0-ga/imx_android_setup.sh
export A=$(pwd)</pre>
* Follow the instructions in the <b><i>~/imx-p9.0.0_1.0.0-ga/README</i></b> and make sure that the build environment is ready.

==CompuLab sources==
*Clone this repository
<pre>mkdir ~/compulab-imx8-android
git clone https://github.com/compulab-yokneam/imx8-android.git ~/compulab-imx8-android
export C=~/compulab-imx8-android/p9</pre>

==Apply the patches==
*U-boot
<pre>git -C ${A}/vendor/nxp-opensource/uboot-imx checkout -b compulab-imx8-android p9.0.0_1.0.0-ga
git -C ${A}/vendor/nxp-opensource/uboot-imx am ${C}/vendor/nxp-opensource/uboot-imx/*.patch</pre>
*Kernel
<pre>git -C ${A}/vendor/nxp-opensource/kernel_imx checkout -b compulab-imx8-android p9.0.0_1.0.0-ga
git -C ${A}/vendor/nxp-opensource/kernel_imx am ${C}/vendor/nxp-opensource/kernel_imx/*.patch</pre>
*Board
<pre>git -C ${A}/device/fsl checkout -b compulab-imx8-android p9.0.0_1.0.0-ga
git -C ${A}/device/fsl am ${C}/device/fsl/*.patch</pre>

Set the machine configuration to <b>ucm-imx8m-mini</b>:
<pre>export MACHINE=ucm_imx8m_mini SOC=imx8mm</pre>
{{important|1=Underscore in the MACHINE name is not a typo.}}

==Build Android==
*Go to Android build directory and issue:
<pre>cd ${A}
source build/envsetup.sh
lunch ${MACHINE}-userdebug
make 2>&1 | tee build-log.txt</pre>
When the build process is complete, check the {{filename|build-log.txt}} file errors.

==Create a bootable SD-card==

{{note|1=This sample is for an 8G-card.}}
* Obtain a USB card reader and a micro-SD сard. Any commercially available micro-SD card of <b>8GB</b> (or larger) may be used for the installation.
* Plug the USB SD card reader into the host PC. Insert the micro-SD сard into the сard reader. From now we assume the device name of the MMC/SD card on your Linux PC is {{filename|/dev/sdX}}.
* Prepare the uSD card:
<pre>sudo dd if=/dev/zero bs=1M count=16 of=/dev/sdX
sudo partprobe /dev/sdx</pre>
* In the Android build directory issue the following commands:
<pre>export MACHINE=ucm_imx8m_mini SOC=imx8mm
cd out/target/product/${MACHINE}
sudo ./fsl-sdcard-partition.sh -c 7 -f ${SOC} /dev/sdX</pre>

[[Category:Android]]
[[Category:UCM-iMX8M-Mini]]