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

$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

Table of contents

Other NXP Semiconductors Computer Hardware manuals

NXP Semiconductors

NXP Semiconductors AXIOM M52259DEMOCOM Installation manual

NXP Semiconductors

NXP Semiconductors Motorola DSP56602 User manual

NXP Semiconductors

NXP Semiconductors freescale MPC837xE-RDS User manual

NXP Semiconductors

NXP Semiconductors FRDM-MCXN947 User manual

NXP Semiconductors

NXP Semiconductors LX2160ARDBGSG User manual

NXP Semiconductors

NXP Semiconductors UM11673 User manual

NXP Semiconductors

NXP Semiconductors i.MX 8M Mini LPDDR4 EVK User manual

NXP Semiconductors

NXP Semiconductors MCIMX93-EVKCM User manual

NXP Semiconductors

NXP Semiconductors MCIMX93-EVK User manual

NXP Semiconductors

NXP Semiconductors 8MNANOD3L-EVK User manual

NXP Semiconductors

NXP Semiconductors MCU-SMHMI-UG User manual

NXP Semiconductors

NXP Semiconductors QorIQ T2080 User manual

NXP Semiconductors

NXP Semiconductors MCX-N5 EVK Series User manual

NXP Semiconductors

NXP Semiconductors UM10694 User manual

NXP Semiconductors

NXP Semiconductors MCU-Link Pro User manual

NXP Semiconductors

NXP Semiconductors OM11058 User manual

NXP Semiconductors

NXP Semiconductors KW45B41Z-EVK User manual

NXP Semiconductors

NXP Semiconductors i.MX6ULL User manual

NXP Semiconductors

NXP Semiconductors RD9Z1-638BJBEVM User manual

NXP Semiconductors

NXP Semiconductors MR-CANHUBK344 Instructions for use

NXP Semiconductors

NXP Semiconductors TWR-PXS2010 User manual

NXP Semiconductors

NXP Semiconductors AN12398 User manual

NXP Semiconductors

NXP Semiconductors K32W061 User manual

NXP Semiconductors

NXP Semiconductors i.MX 8M User manual

Popular Computer Hardware manuals by other brands

EMC2

EMC2 VNX Series Hardware Information Guide

Panasonic

Panasonic DV0PM20105 Operation manual

Mitsubishi Electric

Mitsubishi Electric Q81BD-J61BT11 user manual

Gigabyte

Gigabyte B660M DS3H AX DDR4 user manual

Raidon

Raidon iT2300 Quick installation guide

National Instruments

National Instruments PXI-8186 user manual

Hauppauge

Hauppauge WinTV-HVR-2250 Quick installation guide

Kontron

Kontron CP6002 user guide

Manhattan

Manhattan 702843 user manual

Aphex

Aphex 230 instruction manual

AMD

AMD Phenom II Product data sheet

Intel

Intel NUC 12 Pro user guide

dbx

dbx Zone Pro 1260 user manual

Galaxy

Galaxy GHDX2-2430S-24F4D Installation and hardware reference manual

Intel

Intel AXXRMFBU4 Quick installation user's guide

Kontron

Kontron DIMM-PC/MD product manual

ST X-NUCLEO-SAFEA1B How to use

STEINWAY LYNGDORF

STEINWAY LYNGDORF SP-1 installation manual