Merge tag 'u-boot-atmel-fixes-2020.07-a' of https://gitlab.denx.de/u-boot/custodians...
[oweals/u-boot.git] / board / amlogic / s400 / README
1 U-Boot for Amlogic S400
2 =======================
3
4 S400 is a reference board manufactured by Amlogic with the following
5 specifications:
6
7  - Amlogic A113DX ARM Cortex-A53 quad-core SoC @ 1.2GHz
8  - 1GB DDR4 SDRAM
9  - 10/100 Ethernet
10  - 2 x USB 2.0 Host
11  - eMMC
12  - Infrared receiver
13  - SDIO WiFi Module
14  - MIPI DSI Connector
15  - Audio HAT Connector
16  - PCI-E M.2 Connectors
17
18 Schematics are available from Amlogic on demand.
19
20 Currently the u-boot port supports the following devices:
21  - serial
22  - eMMC
23  - Ethernet
24  - I2C
25  - Regulators
26  - Reset controller
27  - Clock controller
28  - USB Host
29  - ADC
30
31 u-boot compilation
32 ==================
33
34  > export CROSS_COMPILE=aarch64-none-elf-
35  > make s400_defconfig
36  > make
37
38 Image creation
39 ==============
40
41 Amlogic doesn't provide sources for the firmware and for tools needed
42 to create the bootloader image, so it is necessary to obtain them from
43 the git tree published by the board vendor:
44
45  > wget https://releases.linaro.org/archive/13.11/components/toolchain/binaries/gcc-linaro-aarch64-none-elf-4.8-2013.11_linux.tar.xz
46  > wget https://releases.linaro.org/archive/13.11/components/toolchain/binaries/gcc-linaro-arm-none-eabi-4.8-2013.11_linux.tar.xz
47  > tar xvfJ gcc-linaro-aarch64-none-elf-4.8-2013.11_linux.tar.xz
48  > tar xvfJ gcc-linaro-arm-none-eabi-4.8-2013.11_linux.tar.xz
49  > 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
50  > git clone https://github.com/BayLibre/u-boot.git -b n-amlogic-openlinux-20170606 amlogic-u-boot
51  > cd amlogic-u-boot
52  > make axg_s400_v1_defconfig
53  > make
54  > export FIPDIR=$PWD/fip
55
56 Go back to mainline U-boot source tree then :
57  > mkdir fip
58
59  > cp $FIPDIR/axg/bl2.bin fip/
60  > cp $FIPDIR/axg/acs.bin fip/
61  > cp $FIPDIR/axg/bl21.bin fip/
62  > cp $FIPDIR/axg/bl30.bin fip/
63  > cp $FIPDIR/axg/bl301.bin fip/
64  > cp $FIPDIR/axg/bl31.img fip/
65  > cp u-boot.bin fip/bl33.bin
66
67  > $FIPDIR/blx_fix.sh \
68         fip/bl30.bin \
69         fip/zero_tmp \
70         fip/bl30_zero.bin \
71         fip/bl301.bin \
72         fip/bl301_zero.bin \
73         fip/bl30_new.bin \
74         bl30
75
76  > $FIPDIR/acs_tool.pyc fip/bl2.bin fip/bl2_acs.bin fip/acs.bin 0
77
78  > $FIPDIR/blx_fix.sh \
79         fip/bl2_acs.bin \
80         fip/zero_tmp \
81         fip/bl2_zero.bin \
82         fip/bl21.bin \
83         fip/bl21_zero.bin \
84         fip/bl2_new.bin \
85         bl2
86
87  > $FIPDIR/axg/aml_encrypt_axg --bl3sig --input fip/bl30_new.bin \
88                                         --output fip/bl30_new.bin.enc \
89                                         --level v3 --type bl30
90  > $FIPDIR/axg/aml_encrypt_axg --bl3sig --input fip/bl31.img \
91                                         --output fip/bl31.img.enc \
92                                         --level v3 --type bl31
93  > $FIPDIR/axg/aml_encrypt_axg --bl3sig --input fip/bl33.bin --compress lz4 \
94                                         --output fip/bl33.bin.enc \
95                                         --level v3 --type bl33
96  > $FIPDIR/axg/aml_encrypt_axg --bl2sig --input fip/bl2_new.bin \
97                                         --output fip/bl2.n.bin.sig
98  > $FIPDIR/axg/aml_encrypt_axg --bootmk \
99                 --output fip/u-boot.bin \
100                 --bl2 fip/bl2.n.bin.sig \
101                 --bl30 fip/bl30_new.bin.enc \
102                 --bl31 fip/bl31.img.enc \
103                 --bl33 fip/bl33.bin.enc --level v3
104
105 and then write the image to SD with:
106
107  > DEV=/dev/your_sd_device
108  > dd if=fip/u-boot.bin.sd.bin of=$DEV conv=fsync,notrunc bs=512 skip=1 seek=1
109  > dd if=fip/u-boot.bin.sd.bin of=$DEV conv=fsync,notrunc bs=1 count=444