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