amlogic: Remove ARCH= references from documentation
[oweals/u-boot.git] / board / amlogic / u200 / README
1 U-Boot for Amlogic U200
2 =======================
3
4 U200 is a reference board manufactured by Amlogic with the following
5 specifications:
6
7  - Amlogic S905D2 ARM Cortex-A53 quad-core SoC
8  - 2GB DDR4 SDRAM
9  - 10/100 Ethernet (Internal PHY)
10  - 1 x USB 3.0 Host
11  - eMMC
12  - SDcard
13  - Infrared receiver
14  - SDIO WiFi Module
15  - MIPI DSI Connector
16  - Audio HAT Connector
17  - PCI-E M.2 Connector
18
19 Schematics are available from Amlogic on demand.
20
21 Currently the u-boot port supports the following devices:
22  - serial
23  - Ethernet
24  - Regulators
25  - Clock controller
26
27 u-boot compilation
28 ==================
29
30  > export CROSS_COMPILE=aarch64-none-elf-
31  > make u200_defconfig
32  > make
33
34 Image creation
35 ==============
36
37 Amlogic doesn't provide sources for the firmware and for tools needed
38 to create the bootloader image, so it is necessary to obtain them from
39 the git tree published by the board vendor:
40
41  > wget https://releases.linaro.org/archive/13.11/components/toolchain/binaries/gcc-linaro-aarch64-none-elf-4.8-2013.11_linux.tar.xz
42  > wget https://releases.linaro.org/archive/13.11/components/toolchain/binaries/gcc-linaro-arm-none-eabi-4.8-2013.11_linux.tar.xz
43  > tar xvfJ gcc-linaro-aarch64-none-elf-4.8-2013.11_linux.tar.xz
44  > tar xvfJ gcc-linaro-arm-none-eabi-4.8-2013.11_linux.tar.xz
45  > 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
46  > git clone https://github.com/BayLibre/u-boot.git -b buildroot-openlinux-20180418 amlogic-u-boot
47  > cd amlogic-u-boot
48  > make g12a_u200_v1_defconfig
49  > make
50  > export UBOOTDIR=$PWD
51
52 Download the latest Amlogic Buildroot package, and extract it :
53  > wget http://openlinux2.amlogic.com:8000/ARM/filesystem/Linux_BSP/buildroot_openlinux_kernel_4.9_fbdev_20180706.tar.gz
54  > tar xfz buildroot_openlinux_kernel_4.9_fbdev_20180706.tar.gz buildroot_openlinux_kernel_4.9_fbdev_20180706/bootloader
55  > export BRDIR=$PWD/buildroot_openlinux_kernel_4.9_fbdev_20180706
56  > export FIPDIR=$BRDIR/bootloader/uboot-repo/fip
57
58 Go back to mainline U-Boot source tree then :
59  > mkdir fip
60
61  > wget https://github.com/BayLibre/u-boot/releases/download/v2017.11-libretech-cc/blx_fix_g12a.sh -O fip/blx_fix.sh
62  > cp $UBOOTDIR/build/scp_task/bl301.bin fip/
63  > cp $UBOOTDIR/build/board/amlogic/g12a_u200_v1/firmware/acs.bin fip/
64  > cp $BRDIR/bootloader/uboot-repo/bl2/bin/g12a/bl2.bin fip/
65  > cp $BRDIR/bootloader/uboot-repo/bl30/bin/g12a/bl30.bin fip/
66  > cp $BRDIR/bootloader/uboot-repo/bl31_1.3/bin/g12a/bl31.img fip/
67  > cp $FIPDIR/g12a/ddr3_1d.fw fip/
68  > cp $FIPDIR/g12a/ddr4_1d.fw fip/
69  > cp $FIPDIR/g12a/ddr4_2d.fw fip/
70  > cp $FIPDIR/g12a/diag_lpddr4.fw fip/
71  > cp $FIPDIR/g12a/lpddr4_1d.fw fip/
72  > cp $FIPDIR/g12a/lpddr4_2d.fw fip/
73  > cp $FIPDIR/g12a/piei.fw fip/
74  > cp u-boot.bin fip/bl33.bin
75
76  > sh fip/blx_fix.sh \
77         fip/bl30.bin \
78         fip/zero_tmp \
79         fip/bl30_zero.bin \
80         fip/bl301.bin \
81         fip/bl301_zero.bin \
82         fip/bl30_new.bin \
83         bl30
84
85  > sh fip/blx_fix.sh \
86         fip/bl2.bin \
87         fip/zero_tmp \
88         fip/bl2_zero.bin \
89         fip/acs.bin \
90         fip/bl21_zero.bin \
91         fip/bl2_new.bin \
92         bl2
93
94  > $FIPDIR/g12a/aml_encrypt_g12a --bl30sig --input fip/bl30_new.bin \
95                                         --output fip/bl30_new.bin.g12a.enc \
96                                         --level v3
97  > $FIPDIR/g12a/aml_encrypt_g12a --bl3sig --input fip/bl30_new.bin.g12a.enc \
98                                         --output fip/bl30_new.bin.enc \
99                                         --level v3 --type bl30
100  > $FIPDIR/g12a/aml_encrypt_g12a --bl3sig --input fip/bl31.img \
101                                         --output fip/bl31.img.enc \
102                                         --level v3 --type bl31
103  > $FIPDIR/g12a/aml_encrypt_g12a --bl3sig --input fip/bl33.bin --compress lz4 \
104                                         --output fip/bl33.bin.enc \
105                                         --level v3 --type bl33
106  > $FIPDIR/g12a/aml_encrypt_g12a --bl2sig --input fip/bl2_new.bin \
107                                         --output fip/bl2.n.bin.sig
108  > $FIPDIR/g12a/aml_encrypt_g12a --bootmk \
109                 --output fip/u-boot.bin \
110                 --bl2 fip/bl2.n.bin.sig \
111                 --bl30 fip/bl30_new.bin.enc \
112                 --bl31 fip/bl31.img.enc \
113                 --bl33 fip/bl33.bin.enc \
114                 --ddrfw1 fip/ddr4_1d.fw \
115                 --ddrfw2 fip/ddr4_2d.fw \
116                 --ddrfw3 fip/ddr3_1d.fw \
117                 --ddrfw4 fip/piei.fw \
118                 --ddrfw5 fip/lpddr4_1d.fw \
119                 --ddrfw6 fip/lpddr4_2d.fw \
120                 --ddrfw7 fip/diag_lpddr4.fw \
121                 --level v3
122
123 and then write the image to SD with:
124
125  > DEV=/dev/your_sd_device
126  > dd if=fip/u-boot.bin.sd.bin of=$DEV conv=fsync,notrunc bs=512 skip=1 seek=1
127  > dd if=fip/u-boot.bin.sd.bin of=$DEV conv=fsync,notrunc bs=1 count=444