NXP Semiconductors Android User manual

1 Overview
This document guides you through the processes of
downloading and running this release package. It only
explains how to download and run the default release image
with default configuration. For details on using the release
package, see the Android™ User's Guide (AUG) included in
this release package.
2 Hardware Requirements
The hardware requirements for using this release package are
as follows:
Supported system-on-chips (SoCs):
• i.MX 8M Mini
• i.MX 8M Quad
• i.MX 8QuadMax
• i.MX 8QuadXPlus
Supported boards:
• EVK board and Platform
• MEK board and Platform
NXP Semiconductors Document Number: AQSUG
Rev. P9.0.0_1.0.0-ga, 01/2019
Android™ Quick Start Guide
Contents
1 Overview....................................................................1
2 Hardware Requirements............................................ 1
3 Working with the i.MX 8M Mini EVK
Board......................................................................... 2
4 Working with the i.MX 8M Quad EVK
Board......................................................................... 9
5 Working with the i.MX 8QuadMax
MEK Board.............................................. ...............19
6 Working with the i.MX 8QuadXPlus
MEK Board............................................................. 27
7 Revision History......................... ............................ 35

3 Working with the i.MX 8M Mini EVK Board
3.1 Board hardware
The figures below show the different components of the i.MX 8M Mini EVK board.
Figure 1. i.MX 8M Mini EVK board
Figure 2. i.MX 8M Mini EVK with audio board
Working with the i.MX 8M Mini EVK Board
Android™ Quick Start Guide, Rev. P9.0.0_1.0.0-ga, 01/2019
2 NXP Semiconductors

Figure 3. i.MX 8M Mini SAS cable with DSI-to-HDMI adapter
Figure 4. i.MX MIPI panel
Figure 5. i.MX MIPI camera
NOTE
• To test the MIPI-DSI to HDMI display, use the i.MX mini SAS cable to connect
the DSI-to-HDMI adapter to the "HDMI DSI" port.
• To test the MIPI panel display, conect the i.MX MIPI panel to the "HDMI DSI"
port.
• To test the camera, connect two i.MX MIPI cameras to the "MIPI Camera0" and
"MIPI Camera1" ports at the same time.
Working with the i.MX 8M Mini EVK Board
Android™ Quick Start Guide, Rev. P9.0.0_1.0.0-ga, 01/2019
NXP Semiconductors 3

3.2 Board images
The table below describes the location in the board partitions of the software images in android_p9.0.0_1.0.0-
ga_image_8mmevk.tar.gz.
Table 1. Board images
Image name Download target
/u-boot-imx8mm.imx 33 KB offset of MMC.
/u-boot-imx8mm-evk-uuu.imx Bootloader used by UUU for the i.MX 8M Mini board. It is
not flashed to MMC.
/imx8mm_m4_demo.img 5120 KB offset of MMC.
/partition-table.img 0 offset of MMC. If the actually size of the SD card is larger
than 13 GB, use the default partition-table.img.
/partition-table-7GB.img 0 offset of MMC. If the actually size of the SD card is larger
than 7 GB, use this image as partition-table.img.
/partition-table-28GB.img 0 offset of MMC. If the actually size of the SD card is larger
than 28 GB, use this image as partition-table.img.
/boot.img boot_a and boot_b partitions.
/vbmeta-imx8mm.img vbmeta_a and vbmeta_b partitions to support MIPI-to-HDMI
output and Direct Stream Digital (DSD) audio playback.
/vbmeta-imx8mm-m4.img vbmeta_a and vbmeta_b partitions to support MIPI-to-HDMI
output and audio playback based on Cortex-M4 FreeRTOS.
/vbmeta-imx8mm-mipi-panel.img vbmeta_a and vbmeta_b partitions to support MIPI panel
output.
/system.img system_a and system_b partitions.
/vendor.img vendor_a and vendor_b partitions.
/dtbo-imx8mm.img dtbo_a and dtbo_b paritions to support MIPI-to-HDMI
output and DSD audio playback.
/dtbo-imx8mm-m4.img dtbo_a and dtbo_b paritions to support MIPI-to-HDMI
output and audio playback based Cortex-M4 FreeRTOS
/dtbo-imx8mm-mipi-panel.img dtbo_a and dtbo_b paritions to support MIPI panel output
The table below describes the Universal Update Utility (UUU) scripts in android_p9.0.0_1.0.0-
ga_image_8mmevk.tar.gz.They are used with the UUU binary file to download the images above into the board. For detailed
information on how to download images with UUU, see Section 3.3 "Board images".
Table 2. UUU scripts
UUU script name Function
uuu-android-mx8mm-evk-emmc.lst Used with the UUU binary file to download image files into
eMMC. The m4_os partition is not flashed.
uuu-android-mx8mm-evk-sd.lst Used with the UUU binary file to download image files into the
SD card. The m4_os partition is not flashed.
uuu-android-mx8mm-evk-emmc-m4.lst Used with the UUU binary file to download image files into
eMMC. The m4_os partition is flashed.
uuu-android-mx8mm-evk-sd-m4.lst Used with the UUU binary file to download image files into the
SD card. The m4_os partition is flashed.
Working with the i.MX 8M Mini EVK Board
Android™ Quick Start Guide, Rev. P9.0.0_1.0.0-ga, 01/2019
4 NXP Semiconductors

3.3 Flashing board images
The board image files can be flashed into the target board using Universal Update Utility (UUU).
For the UUU binary file, download it from github: uuu release page on github. You can download the latest version (1.2.31
for now).
• For Linux OS, download the file named "uuu".
• For Windows OS, download the file named "uuu.exe".
You can put these files in a path containing the system environment variable "PATH", and then directly call uuu in
command line or shell terminal.
There are two ways as follows to use UUU to flash images:
• Directly invoke UUU with the lst scripts in the command line to flash images.
• Use the uuu_imx_android_flash shell script and Windows batch file to invoke UUU and fastboot tool to flash images.
uuu_imx_android_flash is a new tool, which is more flexible. If the users are not familiar with this tool, the way to use UUU
with the lst scripts is still maintained, and it will be removed in the future.
The two ways are described as follows. Users can choose either of it to flash images.
3.3.1 Directly invoking UUU with the lst scripts in command line to
flash images
For detailed information on the UUU lst scripts used in this way, see Section 3.2 "Board images".
NOTE
UUU uses the integrated fastboot tool to flash images. Make sure you have fastboot
driver software installed on your computer.
Perform the following steps to flash the board images:
1. Download the UUU binary file from github as described above.
2. Change the first two bits of the board's sw1101 to 10 (1-2 bit) to enter serial download mode.
3. Power on the board. Connect the PC with the board using the USB cable on the board's OTG port.
4. Decompress release_package/android_p9.0.0_1.0.0-ga_image_8mmevk.tar.gz, which contains the image files and
UUU scripts. Choose the correct UUU script file as shown in the following table.
Target device and boot storage UUU script file
i.MX 8M Mini EVK eMMC uuu-android-mx8mm-evk-emmc.lst
i.MX 8M Mini EVK SD uuu-android-mx8mm-evk-sd.lst
To test MIPI-DSI to HDMI output and audio playback based on Cortex-M4 FreeRTOS, choose one of the UUU scripts
shown in the following table.
Target device and boot storage UUU script file
i.MX 8M Mini EVK eMMC uuu-android-mx8mm-evk-emmc-m4.lst
i.MX 8M Mini EVK SD uuu-android-mx8mm-evk-sd-m4.lst
Working with the i.MX 8M Mini EVK Board
Android™ Quick Start Guide, Rev. P9.0.0_1.0.0-ga, 01/2019
NXP Semiconductors 5

NOTE
• If your SD card is 16 GB or the on-board eMMC is used as the boot device,
to test the MIPI-DSI to HDMI output, you do not need to change the
"partition-table.img" part of the UUU script.
• If your SD card is 32 GB, rename partition-table.img to partition-
table-28GB.img in the corresponding UUU script.
• If your SD card is 8 GB, rename partition-table.img to partition-
table-7GB.img in the corresponding UUU script.
• To test MIPI-DSI to HDMI output, you do not need to rename boot-
imx8mm.img and vbmeta-imx8mm.img in the UUU scipt.
• To test the MIPI panel output, rename boot-imx8mm.img and vbmeta-
imx8mm.img to boot-imx8mm-mipi-panel.img and vbmeta-imx8mm-mipi-
panel.img in the corresponding UUU script.
5. Use UUU and the proper script file to flash image files.
Execute the following command to invoke the UUU binary file and UUU scripts to flash the image files.
• On a Linux system, open the shell terminal. Execute the command below. ${uuu_script_path} is the file path
(including the name of the UUU script) of the UUU script that is used. It can be a relative path or an absolute
path.
> sudo uuu ${uuu_script_path}
• On a Windows system, open the command line interface. Execute the command below. ${uuu_script_path}
is the absolute file path (including the name of the UUU script) of the UUU script.
> uuu.exe ${uuu_script_path}
6. Wait for the script file execution to complete. If there are no errors, you will get information on the command window
as follows:
C:\Users\user_01\tools\uuu>uuu.exe C:\Users\user_01\images\android_p9.0.0_1.0.0-
ga_image_8mmevk\uuu-android-mx8mm-evk-emmc.lst
uuu (Universal Update Utility) for nxp imx chips -- libuuu_1.2.24-0-g0d63ca3
Powershell: Enjoy auto [tab] command complete by run below command or put into
Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1
Register-ArgumentCompleter -CommandName uuu -ScriptBlock {param($commandName,
$parameterName,$wordToComplete,$commandAst,$fakeBoundParameter); C:\Users\user_01\tools
\uuu>uuu.exe -autocomplete $parameterName }
Success 1 Failure 0
2:2 22/22 [Done ] FB: done
As you can see, it is on the Windows system, and the absolute file path of the UUU script is used. For the output
information on the command complete feature, it is recommendations given by UUU itself. This feature is not used
here.
7. Power off the board.
8. Change the boot device as eMMC or SD card.
• To boot from eMMC, change sw1101 to 01110010 and change sw1102 to 00101010.
• To boot from SD card, change sw1101 to 01000110 and change sw1102 to 00110100.
3.3.2 Using the uuu_imx_android_flash tool to invoke UUU and
fastboot tool to flash images
The uuu_imx_android_flash shell script and windows batch file are provided to flash Android images with much more
flexibility.
Working with the i.MX 8M Mini EVK Board
Android™ Quick Start Guide, Rev. P9.0.0_1.0.0-ga, 01/2019
6 NXP Semiconductors

Perform the following steps to download the board images:
1. Download the UUU binary file from github as described above. Install fastboot into a directory contained by the system
environment variable of "PATH".
2. Change the first two bits of board's sw1101 to 10 (1-2 bit) to enter serial download mode.
3. Power on the board. Connect the PC with the board using the USB cable on the board OTG port.
4. Decompress release_package/android_p9.0.0_1.0.0-ga_image_8mmevk.tar.gz, which contains the image files and
uuu_imx_android_flash tool.
5. Execute the uuu_imx_android_flash tool to flash images.
The uuu_imx_android_flash tool can be executed with options to get help information and specify the images to be
flashed. For i.MX 8M Mini, related options are described as follows:
Table 3. Options for uuu_imx_android_flash
tool
Option Description
-h Displays the help information of this tool.
-f
soc_name
Specifies the SoC information. For i.MX 8M Mini, it should be "imx8mm". This option is
mandatory.
-a Only flashes slot a. If this option and "-b" option are not used, slots a and b are both
flashed.
-b Only flashes slot b. If this option and "-a" option are not used, slots a and b are both
flashed.
-c
card_size
Specifies which partition table image file to flash. For i.MX 8M Mini, it can be followed
with "7" or "28". If this option is not used, default "partition-table.img" is flashed.
-m Flashes the Arm Cortex-M4 image. If this option is not used, the Cortex-M4 image is not
flashed.
-d
dev
Specifies some images with "dev" in its name. For i.MX 8M Mini, it can be "m4", or "mipi-
panel". If this option is not used, default dtbo and vbmeta images are flashed.
-e Erases user data after images are flashed.
-D
directory
Specifies the directory in which there are the images to be flashed. If this option is not
used, images in the current working directory are flashed.
-t
target_dev
Specifies the target device. For i.MX 8M Mini, it can be "emmc" and "sd". If this option is
not used, images are flashed to eMMC.
Obviously, "-m" and "-d m4" should be used together.
• On Linux system, open the shell terminal. For example, you can execute a command as follows:
> sudo ./uuu_imx_android_flash.sh -f imx8mm -a -e
• On Windows system, open the command line interface, the corresponding command is as follows:
> .\uuu_imx_android_flash.bat -f imx8mm -a -e
When the command above is executed, the default images are flashed into the eMMC slot a for i.MX 8M Mini.
• To flash the SD card, execute the tool with "-t sd". To flash eMMC, it does not need to use the -t option.
• If your SD card is 16 GB or the on-board eMMC is used as the boot device, it does not need to use the -c option.
• If your SD card is 32 GB, execute the tool with "-c 28".
• If your SD card is 8 GB, execute the tool with "-c 7".
• To test MIPI-DSI to HDMI output, it does not need to use the -d option.
Working with the i.MX 8M Mini EVK Board
Android™ Quick Start Guide, Rev. P9.0.0_1.0.0-ga, 01/2019
NXP Semiconductors 7

• To test MIPI panel output, execute the tool with "-d mipi-panel".
• To test support MIPI-to-HDMI output and audio playback based on Cortex-M4 FreeRTOS, execute the tool with
"-m" and "-d m4".
6. Wait for the uuu_imx_android_flash execution to complete. If there is not any error, you will get information on the
command window indicating that images are already flashed.
7. Power off the board.
8. Change boot device as eMMC or SD card.
• To boot from eMMC, change sw1101 to 01110010 and change sw1102 to 00101010.
• To boot from the SD card, change sw1101 to 01000110 and change sw1102 to 00110100.
3.4 Booting
After downloading the images, reboot the board using the power on/off switch.
3.4.1 Booting with MIPI-to-HDMI or MIPI panel display
In the U-Boot prompt, set the U-Boot environment variables as follows:
U-Boot > setenv bootargs console=ttymxc1,115200 earlycon=ec_imx6q,0x30890000,115200 init=/
init androidboot.console=ttymxc1 consoleblank=0 androidboot.hardware=freescale cma=800M
androidboot.primary_display=imx-drm firmware_class.path=/vendor/firmware
transparent_hugepage=never
U-Boot > saveenv
With the settings above, the Android platform does not start the shell console. To disable selinux, append
"androidboot.selinux=permissive" to the U-Boot's bootargs. Boot environment variables are as follows:
U-Boot > setenv append_bootargs androidboot.selinux=permissive
U-Boot > saveenv
3.4.2 Booting with MIPI-DSI to HDMI display and audio playback
based on Cortex-M4 FreeRTOS
In the U-Boot prompt, set the U-Boot environment variables as follows:
U-Boot > setenv bootargs console=ttymxc1,115200 earlycon=ec_imx6q,0x30890000,115200 init=/
init androidboot.console=ttymxc1 consoleblank=0 androidboot.hardware=freescale cma=800M
androidboot.primary_display=imx-drm firmware_class.path=/vendor/firmware
transparent_hugepage=never
U-Boot > setenv bootcmd "bootmcu && boota mmc0" # for SD boot
U-Boot > setenv bootcmd "bootmcu && boota mmc1" # for emmc boot
U-Boot > saveenv
NOTE
To use other boot images, do not add "bootmcu" to "bootcmd". The following command
can recover bootcmd:
U-Boot > setenv bootcmd "boota mmc0" # for SD boot
U-Boot > setenv bootcmd "boota mmc1" # for emmc boot
U-Boot > saveenv
With the settings above, the Android platform does not start the shell console. To disable selinux, append
"androidboot.selinux=permissive" to the U-Boot's bootargs. Boot environment variables are as follows:
Working with the i.MX 8M Mini EVK Board
Android™ Quick Start Guide, Rev. P9.0.0_1.0.0-ga, 01/2019
8 NXP Semiconductors

U-Boot > setenv append_bootargs androidboot.selinux=permissive
U-Boot > saveenv
3.5 Board reboot
After you have completed download and setup, reboot the board and wait for the Android platform to boot up.
Figure 6. Android Pie image
4Working with the i.MX 8M Quad EVK Board
4.1 Board hardware
The figures below show the different components of the i.MX 8M Quad EVK board.
Working with the i.MX 8M Quad EVK Board
Android™ Quick Start Guide, Rev. P9.0.0_1.0.0-ga, 01/2019
NXP Semiconductors 9

Figure 7. i.MX 8M Quad EVK board
Working with the i.MX 8M Quad EVK Board
Android™ Quick Start Guide, Rev. P9.0.0_1.0.0-ga, 01/2019
10 NXP Semiconductors