amlogic: Remove ARCH= references from documentation
[oweals/u-boot.git] / board / amlogic / w400 / README.odroid-n2
1 U-Boot for ODROID-N2
2 ====================
3
4 ODROID-N2 is a single board computer manufactured by Hardkernel
5 Co. Ltd with the following specifications:
6
7  - Amlogic S922X ARM Cortex-A53 dual-core + Cortex-A73 quad-core SoC
8  - 4GB DDR4 SDRAM
9  - Gigabit Ethernet
10  - HDMI 2.1 4K/60Hz display
11  - 40-pin GPIO header
12  - 4 x USB 3.0 Host, 1 x USB OTG
13  - eMMC, microSD
14  - Infrared receiver
15
16 Schematics are available on the manufacturer website.
17
18 Currently the u-boot port supports the following devices:
19  - serial
20  - eMMC, microSD
21  - Ethernet
22  - I2C
23  - Regulators
24  - Reset controller
25  - Clock controller
26  - ADC
27
28 u-boot compilation
29 ==================
30
31  > export CROSS_COMPILE=aarch64-none-elf-
32  > make odroid-n2_defconfig
33  > make
34
35 Image creation
36 ==============
37
38 Amlogic doesn't provide sources for the firmware and for tools needed
39 to create the bootloader image, so it is necessary to obtain them from
40 the git tree published by the board vendor:
41
42  > wget https://releases.linaro.org/archive/13.11/components/toolchain/binaries/gcc-linaro-aarch64-none-elf-4.8-2013.11_linux.tar.xz
43  > wget https://releases.linaro.org/archive/13.11/components/toolchain/binaries/gcc-linaro-arm-none-eabi-4.8-2013.11_linux.tar.xz
44  > tar xvfJ gcc-linaro-aarch64-none-elf-4.8-2013.11_linux.tar.xz
45  > tar xvfJ gcc-linaro-arm-none-eabi-4.8-2013.11_linux.tar.xz
46  > 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
47
48  > DIR=odroid-n2
49  > git clone --depth 1 \
50        https://github.com/hardkernel/u-boot.git -b odroidn2-v2015.01 \
51        $DIR
52
53  > cd odroid-n2
54  > make odroidn2_defconfig
55  > make
56  > export UBOOTDIR=$PWD
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/hardkernel/odroidn2/firmware/acs.bin fip/
64  > cp $UBOOTDIR/fip/g12b/bl2.bin fip/
65  > cp $UBOOTDIR/fip/g12b/bl30.bin fip/
66  > cp $UBOOTDIR/fip/g12b/bl31.img fip/
67  > cp $UBOOTDIR/fip/g12b/ddr3_1d.fw fip/
68  > cp $UBOOTDIR/fip/g12b/ddr4_1d.fw fip/
69  > cp $UBOOTDIR/fip/g12b/ddr4_2d.fw fip/
70  > cp $UBOOTDIR/fip/g12b/diag_lpddr4.fw fip/
71  > cp $UBOOTDIR/fip/g12b/lpddr4_1d.fw fip/
72  > cp $UBOOTDIR/fip/g12b/lpddr4_2d.fw fip/
73  > cp $UBOOTDIR/fip/g12b/piei.fw fip/
74  > cp $UBOOTDIR/fip/g12b/aml_ddr.fw fip/
75  > cp u-boot.bin fip/bl33.bin
76
77  > sh fip/blx_fix.sh \
78         fip/bl30.bin \
79         fip/zero_tmp \
80         fip/bl30_zero.bin \
81         fip/bl301.bin \
82         fip/bl301_zero.bin \
83         fip/bl30_new.bin \
84         bl30
85
86  > sh fip/blx_fix.sh \
87         fip/bl2.bin \
88         fip/zero_tmp \
89         fip/bl2_zero.bin \
90         fip/acs.bin \
91         fip/bl21_zero.bin \
92         fip/bl2_new.bin \
93         bl2
94
95  > $UBOOTDIR/fip/g12b/aml_encrypt_g12b --bl30sig --input fip/bl30_new.bin \
96                                         --output fip/bl30_new.bin.g12a.enc \
97                                         --level v3
98  > $UBOOTDIR/fip/g12b/aml_encrypt_g12b --bl3sig --input fip/bl30_new.bin.g12a.enc \
99                                         --output fip/bl30_new.bin.enc \
100                                         --level v3 --type bl30
101  > $UBOOTDIR/fip/g12b/aml_encrypt_g12b --bl3sig --input fip/bl31.img \
102                                         --output fip/bl31.img.enc \
103                                         --level v3 --type bl31
104  > $UBOOTDIR/fip/g12b/aml_encrypt_g12b --bl3sig --input fip/bl33.bin --compress lz4 \
105                                         --output fip/bl33.bin.enc \
106                                         --level v3 --type bl33 --compress lz4
107  > $UBOOTDIR/fip/g12b/aml_encrypt_g12b --bl2sig --input fip/bl2_new.bin \
108                                         --output fip/bl2.n.bin.sig
109  > $UBOOTDIR/fip/g12b/aml_encrypt_g12b --bootmk \
110                 --output fip/u-boot.bin \
111                 --bl2 fip/bl2.n.bin.sig \
112                 --bl30 fip/bl30_new.bin.enc \
113                 --bl31 fip/bl31.img.enc \
114                 --bl33 fip/bl33.bin.enc \
115                 --ddrfw1 fip/ddr4_1d.fw \
116                 --ddrfw2 fip/ddr4_2d.fw \
117                 --ddrfw3 fip/ddr3_1d.fw \
118                 --ddrfw4 fip/piei.fw \
119                 --ddrfw5 fip/lpddr4_1d.fw \
120                 --ddrfw6 fip/lpddr4_2d.fw \
121                 --ddrfw7 fip/diag_lpddr4.fw \
122                 --ddrfw8 fip/aml_ddr.fw \
123                 --level v3
124
125 and then write the image to SD with:
126
127  > DEV=/dev/your_sd_device
128  > dd if=fip/u-boot.bin.sd.bin of=$DEV conv=fsync,notrunc bs=512 skip=1 seek=1
129  > dd if=fip/u-boot.bin.sd.bin of=$DEV conv=fsync,notrunc bs=1 count=444