1.. SPDX-License-Identifier: GPL-2.0+
2
3U-Boot for Amlogic Q200
4=======================
5
6Q200 is a reference board manufactured by Amlogic with the following
7specifications:
8
9 - Amlogic S912 ARM Cortex-A53 octo-core SoC @ 1.5GHz
10 - ARM Mali T860 GPU
11 - 2/3GB DDR4 SDRAM
12 - 10/100/1000 Ethernet
13 - HDMI 2.0 4K/60Hz display
14 - 2 x USB 2.0 Host, 1 x USB 2.0 Device
15 - 16GB/32GB/64GB eMMC
16 - 2MB SPI Flash
17 - microSD
18 - SDIO Wifi Module, Bluetooth
19 - IR receiver
20
21U-Boot compilation
22------------------
23
24.. code-block:: bash
25
26    $ export CROSS_COMPILE=aarch64-none-elf-
27    $ make khadas-vim2_defconfig
28    $ make
29
30Image creation
31--------------
32
33Amlogic doesn't provide sources for the firmware and for tools needed
34to create the bootloader image, so it is necessary to obtain them from
35the git tree published by the board vendor:
36
37.. code-block:: bash
38
39    $ wget https://releases.linaro.org/archive/13.11/components/toolchain/binaries/gcc-linaro-aarch64-none-elf-4.8-2013.11_linux.tar.xz
40    $ wget https://releases.linaro.org/archive/13.11/components/toolchain/binaries/gcc-linaro-arm-none-eabi-4.8-2013.11_linux.tar.xz
41    $ tar xvfJ gcc-linaro-aarch64-none-elf-4.8-2013.11_linux.tar.xz
42    $ tar xvfJ gcc-linaro-arm-none-eabi-4.8-2013.11_linux.tar.xz
43    $ export PATH=$PWD/gcc-linaro-aarch64-none-elf-4.8-2013.11_linux/bin:$PWD/gcc-linaro-arm-none-eabi-4.8-2013.11_linux/bin:$PATH
44    $ git clone https://github.com/BayLibre/u-boot.git -b n-amlogic-openlinux-20170606 amlogic-u-boot
45    $ cd amlogic-u-boot
46    $ make gxm_q200_v1_defconfig
47    $ make
48    $ export FIPDIR=$PWD/fip
49
50Go back to mainline U-Boot source tree then :
51
52.. code-block:: bash
53
54    $ mkdir fip
55
56    $ cp $FIPDIR/gxl/bl2.bin fip/
57    $ cp $FIPDIR/gxl/acs.bin fip/
58    $ cp $FIPDIR/gxl/bl21.bin fip/
59    $ cp $FIPDIR/gxl/bl30.bin fip/
60    $ cp $FIPDIR/gxl/bl301.bin fip/
61    $ cp $FIPDIR/gxl/bl31.img fip/
62    $ cp u-boot.bin fip/bl33.bin
63
64    $ $FIPDIR/blx_fix.sh \
65    	fip/bl30.bin \
66    	fip/zero_tmp \
67    	fip/bl30_zero.bin \
68    	fip/bl301.bin \
69    	fip/bl301_zero.bin \
70    	fip/bl30_new.bin \
71    	bl30
72
73    $ python $FIPDIR/acs_tool.pyc fip/bl2.bin fip/bl2_acs.bin fip/acs.bin 0
74
75    $ $FIPDIR/blx_fix.sh \
76    	fip/bl2_acs.bin \
77    	fip/zero_tmp \
78    	fip/bl2_zero.bin \
79    	fip/bl21.bin \
80    	fip/bl21_zero.bin \
81    	fip/bl2_new.bin \
82    	bl2
83
84    $ $FIPDIR/gxl/aml_encrypt_gxl --bl3enc --input fip/bl30_new.bin
85    $ $FIPDIR/gxl/aml_encrypt_gxl --bl3enc --input fip/bl31.img
86    $ $FIPDIR/gxl/aml_encrypt_gxl --bl3enc --input fip/bl33.bin
87    $ $FIPDIR/gxl/aml_encrypt_gxl --bl2sig --input fip/bl2_new.bin --output fip/bl2.n.bin.sig
88    $ $FIPDIR/gxl/aml_encrypt_gxl --bootmk \
89    		--output fip/u-boot.bin \
90    		--bl2 fip/bl2.n.bin.sig \
91    		--bl30 fip/bl30_new.bin.enc \
92    		--bl31 fip/bl31.img.enc \
93    		--bl33 fip/bl33.bin.enc
94
95and then write the image to SD with:
96
97.. code-block:: bash
98
99    $ DEV=/dev/your_sd_device
100    $ dd if=fip/u-boot.bin.sd.bin of=$DEV conv=fsync,notrunc bs=512 skip=1 seek=1
101    $ dd if=fip/u-boot.bin.sd.bin of=$DEV conv=fsync,notrunc bs=1 count=444
102