1.. SPDX-License-Identifier: GPL-2.0+
2
3U-Boot for ODROID-C4
4====================
5
6ODROID-C4 is a single board computer manufactured by Hardkernel
7Co. Ltd with the following specifications:
8
9 - Amlogic S905X3 Arm Cortex-A55 quad-core SoC
10 - 4GB DDR4 SDRAM
11 - Gigabit Ethernet
12 - HDMI 2.1 display
13 - 40-pin GPIO header
14 - 4x USB 3.0 Host
15 - 1x USB 2.0 Host/OTG (micro)
16 - eMMC, microSD
17 - UART serial
18 - Infrared receiver
19
20Schematics are available on the manufacturer website.
21
22U-Boot compilation
23------------------
24
25.. code-block:: bash
26
27    $ export CROSS_COMPILE=aarch64-none-elf-
28    $ make odroid-c4_defconfig
29    $ make
30
31Image creation
32--------------
33
34Amlogic doesn't provide sources for the firmware and for tools needed
35to create the bootloader image, so it is necessary to obtain them from
36the git tree published by the board vendor:
37
38.. code-block:: bash
39
40    $ wget https://releases.linaro.org/archive/13.11/components/toolchain/binaries/gcc-linaro-aarch64-none-elf-4.8-2013.11_linux.tar.xz
41    $ wget https://releases.linaro.org/archive/13.11/components/toolchain/binaries/gcc-linaro-arm-none-eabi-4.8-2013.11_linux.tar.xz
42    $ tar xvfJ gcc-linaro-aarch64-none-elf-4.8-2013.11_linux.tar.xz
43    $ tar xvfJ gcc-linaro-arm-none-eabi-4.8-2013.11_linux.tar.xz
44    $ 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
45
46    $ DIR=odroid-c4
47    $ git clone --depth 1 \
48       https://github.com/hardkernel/u-boot.git -b odroidg12-v2015.01 \
49       $DIR
50
51    $ cd odroid-c4
52    $ make odroidc4_defconfig
53    $ make
54    $ export UBOOTDIR=$PWD
55
56Go back to mainline U-Boot source tree then :
57
58.. code-block:: bash
59
60    $ mkdir fip
61
62    $ wget https://github.com/BayLibre/u-boot/releases/download/v2017.11-libretech-cc/blx_fix_g12a.sh -O fip/blx_fix.sh
63    $ cp $UBOOTDIR/build/scp_task/bl301.bin fip/
64    $ cp $UBOOTDIR/build/board/hardkernel/odroidc4/firmware/acs.bin fip/
65    $ cp $UBOOTDIR/fip/g12a/bl2.bin fip/
66    $ cp $UBOOTDIR/fip/g12a/bl30.bin fip/
67    $ cp $UBOOTDIR/fip/g12a/bl31.img fip/
68    $ cp $UBOOTDIR/fip/g12a/ddr3_1d.fw fip/
69    $ cp $UBOOTDIR/fip/g12a/ddr4_1d.fw fip/
70    $ cp $UBOOTDIR/fip/g12a/ddr4_2d.fw fip/
71    $ cp $UBOOTDIR/fip/g12a/diag_lpddr4.fw fip/
72    $ cp $UBOOTDIR/fip/g12a/lpddr3_1d.fw fip/
73    $ cp $UBOOTDIR/fip/g12a/lpddr4_1d.fw fip/
74    $ cp $UBOOTDIR/fip/g12a/lpddr4_2d.fw fip/
75    $ cp $UBOOTDIR/fip/g12a/piei.fw fip/
76    $ cp $UBOOTDIR/fip/g12a/aml_ddr.fw fip/
77    $ cp u-boot.bin fip/bl33.bin
78
79    $ sh fip/blx_fix.sh \
80    	fip/bl30.bin \
81    	fip/zero_tmp \
82    	fip/bl30_zero.bin \
83    	fip/bl301.bin \
84    	fip/bl301_zero.bin \
85    	fip/bl30_new.bin \
86    	bl30
87
88    $ sh fip/blx_fix.sh \
89    	fip/bl2.bin \
90    	fip/zero_tmp \
91    	fip/bl2_zero.bin \
92    	fip/acs.bin \
93    	fip/bl21_zero.bin \
94    	fip/bl2_new.bin \
95    	bl2
96
97    $ $UBOOTDIR/fip/g12a/aml_encrypt_g12a --bl30sig --input fip/bl30_new.bin \
98    					--output fip/bl30_new.bin.g12a.enc \
99    					--level v3
100    $ $UBOOTDIR/fip/g12a/aml_encrypt_g12a --bl3sig --input fip/bl30_new.bin.g12a.enc \
101    					--output fip/bl30_new.bin.enc \
102    					--level v3 --type bl30
103    $ $UBOOTDIR/fip/g12a/aml_encrypt_g12a --bl3sig --input fip/bl31.img \
104    					--output fip/bl31.img.enc \
105    					--level v3 --type bl31
106    $ $UBOOTDIR/fip/g12a/aml_encrypt_g12a --bl3sig --input fip/bl33.bin --compress lz4 \
107    					--output fip/bl33.bin.enc \
108    					--level v3 --type bl33 --compress lz4
109    $ $UBOOTDIR/fip/g12a/aml_encrypt_g12a --bl2sig --input fip/bl2_new.bin \
110    					--output fip/bl2.n.bin.sig
111    $ $UBOOTDIR/fip/g12a/aml_encrypt_g12a --bootmk \
112    		--output fip/u-boot.bin \
113    		--bl2 fip/bl2.n.bin.sig \
114    		--bl30 fip/bl30_new.bin.enc \
115    		--bl31 fip/bl31.img.enc \
116    		--bl33 fip/bl33.bin.enc \
117    		--ddrfw1 fip/ddr4_1d.fw \
118    		--ddrfw2 fip/ddr4_2d.fw \
119    		--ddrfw3 fip/ddr3_1d.fw \
120    		--ddrfw4 fip/piei.fw \
121    		--ddrfw5 fip/lpddr4_1d.fw \
122    		--ddrfw6 fip/lpddr4_2d.fw \
123    		--ddrfw7 fip/diag_lpddr4.fw \
124    		--ddrfw8 fip/aml_ddr.fw \
125    		--ddrfw9 fip/lpddr3_1d.fw \
126    		--level v3
127
128and then write the image to SD with:
129
130.. code-block:: bash
131
132    $ DEV=/dev/your_sd_device
133    $ dd if=fip/u-boot.bin.sd.bin of=$DEV conv=fsync,notrunc bs=512 skip=1 seek=1
134    $ dd if=fip/u-boot.bin.sd.bin of=$DEV conv=fsync,notrunc bs=1 count=444
135