1#  Zircon on iMX8M EVK
2Periodically check this file as the setup workflow will change/improve.
3
4
5Please refer to the following documents for SoC and board related information:
6
7i.MX 8M EVK Board Hardawre User's Guide:
8https://www.nxp.com/docs/en/user-guide/IMX8MDQLQEVKHUG.pdf
9
10iMX8M Technical Reference Manual:
11https://www.nxp.com/docs/en/reference-manual/IMX8MDQLQRM.pdf
12
13u-Boot Source:
14https://source.codeaurora.org/external/imx/uboot-imx/
15https://source.codeaurora.org/external/imx/uboot-imx/log/?h=imx_v2017.03_4.9.51_imx8m_ga
16
17## Flashing Zircon on eMMC:
18
19The board will boot out of eMMC by default. In order to boot Zircon, a custom u-boot binary
20is needed. The binary can be found at: go/imx8m-bootloader
21
22First step involves flashing the board with the custom u-boot binary:
23
24# Requirements:
25 + Linux Host Machine
26 + For serial console: connect USB from your host to the Micro USB port on the board
27 + For fastboot: connect USB cable from your host to the USB-C port on the board
28 + Create a file under /etc/udev/rules.d/70-nxp.rules with the following content:
29
30 SUBSYSTEM=="usb", ATTR{idVendor}=="0525", MODE="0664", GROUP="plugdev", TAG+="uaccess"
31
32
33# From Device (iMX8 EVK):
34
35+ Reboot board and in serial console press space to halt autoboot
36+ From u-boot command line do the following:
37    + fastboot 0
38
39# From Linux Host:
40 + fastboot flash bootloader0 /PATH/TO/CUSTOM/UBOOT/u-boot.imx
41 + fastboot reboot
42
43 If successful, the new U-Boot prompt should be "zircon-u-boot=>"
44
45Once the custom U-Boot has been flashed, perform the following:
46+ Reboot board and press space to halt autoboot
47+ From u-boot command line do the following:
48    + fastboot 0
49
50From the host side, go to your zircon repository and run the following command:
51+ ./scripts/flash-nxp
52
53If successful, the board will reboot into Zircon.
54