NXP Semiconductors Android i.MX 8M Mini 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_2.0.0-ga, 04/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.............................................. ...............18
6 Working with the i.MX 8QuadXPlus
MEK Board............................................................. 25
7 Revision History......................... ............................ 30

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
Working with the i.MX 8M Mini EVK Board
Android™ Quick Start Guide, Rev. P9.0.0_2.0.0-ga, 04/2019
2 NXP Semiconductors

Figure 2. i.MX 8M Mini EVK with audio board
Figure 3. i.MX 8M Mini SAS cable with DSI-to-HDMI adapter
Working with the i.MX 8M Mini EVK Board
Android™ Quick Start Guide, Rev. P9.0.0_2.0.0-ga, 04/2019
NXP Semiconductors 3

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 the i.MX CSI MIPI Camera to the "Camera" port.
• The QCOM 1PJ Wi-Fi/Bluetooth module is used on the i.MX 8M Mini EVK
LPDDR4 Board.
• The BCM 1MW Wi-Fi/Bluetooth module is used on the i.MX 8M Mini EVK
DDR4 Board.
Working with the i.MX 8M Mini EVK Board
Android™ Quick Start Guide, Rev. P9.0.0_2.0.0-ga, 04/2019
4 NXP Semiconductors

3.2 Board images
The table below describes the location in the board partitions of the software images in android_p9.0.0_2.0.0-
ga_image_8mmevk.tar.gz.
Table 1. Board images
Image name Download target
/u-boot-imx8mm.imx 33 KB offset of MMC for a board with LPDDR4 on it.
/u-boot-imx8mm-ddr4.imx 33 KB offset of MMC for a board with DDR4 on it.
/u-boot-imx8mm-evk-uuu.imx Bootloader used by UUU for the i.MX 8M Mini board with
LPDDR4 on it. It is not flashed to MMC.
/u-boot-imx8mm-ddr4-evk-uuu.imx Bootloader used by UUU for the i.MX 8M Mini board with
DDR4 on it. 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 LPDDR4 and
MIPI-to-HDMI output and Direct Stream Digital (DSD)
playback.
/vbmeta-imx8mm-ddr4.img vbmeta_a and vbmeta_b partitions to support DDR4 and
MIPI-to-HDMI output.
/vbmeta-imx8mm-m4.img vbmeta_a and vbmeta_b partitions to support LPDDR4,
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 LPDDR4 and
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 LPDDR4, MIPI-to-
HDMI output, and DSD playback.
/dtbo-imx8mm-ddr4.img dtbo_a and dtbo_b paritions to support DDR4 and MIPI-to-
HDMI output.
/dtbo-imx8mm-m4.img dtbo_a and dtbo_b paritions to support LPDDR4, MIPI-to-
HDMI output, and audio playback based Cortex-M4
FreeRTOS.
/dtbo-imx8mm-mipi-panel.img dtbo_a and dtbo_b paritions to support LPDDR4 and MIPI
panel output.
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.
Working with the i.MX 8M Mini EVK Board
Android™ Quick Start Guide, Rev. P9.0.0_2.0.0-ga, 04/2019
NXP Semiconductors 5

To achieve more flexibility, two script files are provided to invoke UUU to automatically flash all Android images.
• uuu_imx_android_flash.sh for Linux OS
• uuu_imx_android_flash.bat for Windows OS
For this release, these two scripts are validated on UUU 1.2.91 version. Download corresponding version from github:
• For Linux OS, download the file named "uuu".
• For Windows OS, download the file named "uuu.exe".
Because the two script files will direclty invoke UUU, make sure that UUU is in a path contained by the system environment
variable of "PATH".
Perform the following steps to download the board images:
1. Download the UUU binary file from github as described before. Install UUU into a directory contained by the system
environment variable of "PATH".
2. Make the board enter serial download mode.
• For Rev. B boards, change the first two bits of board's sw1101 to 10 (from 1-2 bit) to enter serial download
mode.
• For Rev. C boards, change the first four bits of board's sw1101 to 1010 (from 1-4 bit) to enter serial download
mode.
3. Power on the board. Use the USB cable on the board OTG port to connect your PC with the board.
4. Decompress release_package/android_p9.0.0_2.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 board, related options are described as follows
Table 2. 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 Cortex-M4 image. If this option is not used,
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", "mipi-panel", "ddr4". 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.
Table continues on the next page...
Working with the i.MX 8M Mini EVK Board
Android™ Quick Start Guide, Rev. P9.0.0_2.0.0-ga, 04/2019
6 NXP Semiconductors

Table 2. Options for uuu_imx_android_flash tool
(continued)
Option Description
-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.
-daemon Run UUU in Daemon mode. This option is used to
flash multiple boards of the same type.
-i If the script is executed with this option, no images
will be flashed. The script loads U-Boot to RAM and
executes to fastboot mode. this option is used for
development.
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 in administrator mode. The corresponding command is as
follows:
> .\uuu_imx_android_flash.bat -f imx8mm -a -e
When the command above is executed, the default images will be flashed into eMMC slot a for i.MX 8M Mini.
NOTE
• To flash the SD card, execute the tool with "-t sd". To flash eMMC, it does
not need to use -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 -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 with LPDDR4 on board, it does not need
to use -d option.
• To test MIPI-DSI to HDMI output with DDR4 on board, execute the tool
with "-d ddr4".
• To test MIPI panel output with LPDDR4 on board, execute the tool with "-d
mipi-panel".
• To test MIPI-to-HDMI output and audio playback based on Cortex-M4
FreeRTOS with LPDDR4 on board, execute the tool with "-m" and "-d m4".
• uuu_imx_android_flash.bat generates a temporary file under the current
working directory. Make sure you have Write permission under the current
working directory.
• If uuu_imx_android_flash.bat is used to flash images on a remote server
through samba, you need to map the remote resource to the local environment
first. Take the following command as an example:
> net use z: \\10.193.108.179\daily_images
"z" in the command represents an available drive letter. It can be other
available drive letter.
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.
Working with the i.MX 8M Mini EVK Board
Android™ Quick Start Guide, Rev. P9.0.0_2.0.0-ga, 04/2019
NXP Semiconductors 7

8. Change boot device as eMMC or SD card.
For Rev. B boards:
• Change sw1101 to 01110010 and change sw1102 to 00101010 if you want to boot from eMMC.
• Change sw1101 to 01000110 and change sw1102 to 00110100 if you want to boot from SD card.
For Rev. C boards:
• Change sw1101 to 0110110010 and change sw1102 to 0001010100 if you want to boot from eMMC.
• Change sw1101 to 0110110010 and change sw1102 to 0001101000 if you want to boot from SD card.
3.4 Booting
After downloading the images, reboot the board using the power on/off switch.
3.4.1 Booting with Single MIPI-to-HDMI or MIPI panel display
In the U-Boot prompt, set the U-Boot environment variables as follows:
• i.MX 8M Mini EVK LPDDR4 Board:
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 androidboot.wifivendor=qca androidboot.wificountrycode=CN
U-Boot > saveenv
• i.MX 8M Mini EVK DDR4 Board:
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 androidboot.wifivendor=bcm androidboot.wificountrycode=CN
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 Single MIPI-to-HDMI display and audio playback
based on Cortex-M4 FreeRTOS
In the U-Boot prompt, set the U-Boot environment variables as follows:
• i.MX 8M Mini EVK LPDDR4 Board:
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 androidboot.wifivendor=qca androidboot.wificountrycode=CN
U-Boot > setenv bootcmd "bootmcu && boota mmc0" # for SD boot
U-Boot > setenv bootcmd "bootmcu && boota mmc1" # for emmc boot
U-Boot > saveenv
• i.MX 8M Mini EVK DDR4 Board:
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 androidboot.wifivendor=bcm androidboot.wificountrycode=CN
Working with the i.MX 8M Mini EVK Board
Android™ Quick Start Guide, Rev. P9.0.0_2.0.0-ga, 04/2019
8 NXP Semiconductors

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:
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
Working with the i.MX 8M Quad EVK Board
Android™ Quick Start Guide, Rev. P9.0.0_2.0.0-ga, 04/2019
NXP Semiconductors 9

4.1 Board hardware
The figures below show the different components of the i.MX 8M Quad EVK board.
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_2.0.0-ga, 04/2019
10 NXP Semiconductors