1.. SPDX-License-Identifier: GPL-2.0+
2
3U-Boot for Khadas VIM2
4=======================
5
6Khadas VIM2 is an Open Source DIY Box manufactured by Shenzhen Wesion
7Technology Co., Ltd with the following specifications:
8
9 - Amlogic S912 ARM Cortex-A53 octo-core SoC @ 1.5GHz
10 - ARM Mali T860 GPU
11 - 2/3GB DDR4 SDRAM
12 - 10/100/1000 Ethernet
13 - HDMI 2.0 4K/60Hz display
14 - 40-pin GPIO header
15 - 2 x USB 2.0 Host, 1 x USB 2.0 Type-C OTG
16 - 16GB/32GB/64GB eMMC
17 - 2MB SPI Flash
18 - microSD
19 - SDIO Wifi Module, Bluetooth
20 - Two channels IR receiver
21
22U-Boot compilation
23------------------
24
25.. code-block:: bash
26
27    $ export CROSS_COMPILE=aarch64-none-elf-
28    $ make khadas-vim2_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    $ git clone https://github.com/khadas/u-boot -b khadas-vim-v2015.01 vim-u-boot
46    $ cd vim-u-boot
47    $ make kvim2_defconfig
48    $ make
49    $ export FIPDIR=$PWD/fip
50
51Go back to mainline U-Boot source tree then :
52
53.. code-block:: bash
54
55    $ mkdir fip
56
57    $ cp $FIPDIR/gxl/bl2.bin fip/
58    $ cp $FIPDIR/gxl/acs.bin fip/
59    $ cp $FIPDIR/gxl/bl21.bin fip/
60    $ cp $FIPDIR/gxl/bl30.bin fip/
61    $ cp $FIPDIR/gxl/bl301.bin fip/
62    $ cp $FIPDIR/gxl/bl31.img fip/
63    $ cp u-boot.bin fip/bl33.bin
64
65    $ $FIPDIR/blx_fix.sh \
66    	fip/bl30.bin \
67    	fip/zero_tmp \
68    	fip/bl30_zero.bin \
69    	fip/bl301.bin \
70    	fip/bl301_zero.bin \
71    	fip/bl30_new.bin \
72    	bl30
73
74    $ python $FIPDIR/acs_tool.pyc fip/bl2.bin fip/bl2_acs.bin fip/acs.bin 0
75
76    $ $FIPDIR/blx_fix.sh \
77    	fip/bl2_acs.bin \
78    	fip/zero_tmp \
79    	fip/bl2_zero.bin \
80    	fip/bl21.bin \
81    	fip/bl21_zero.bin \
82    	fip/bl2_new.bin \
83    	bl2
84
85    $ $FIPDIR/gxl/aml_encrypt_gxl --bl3enc --input fip/bl30_new.bin
86    $ $FIPDIR/gxl/aml_encrypt_gxl --bl3enc --input fip/bl31.img
87    $ $FIPDIR/gxl/aml_encrypt_gxl --bl3enc --input fip/bl33.bin
88    $ $FIPDIR/gxl/aml_encrypt_gxl --bl2sig --input fip/bl2_new.bin --output fip/bl2.n.bin.sig
89    $ $FIPDIR/gxl/aml_encrypt_gxl --bootmk \
90    		--output fip/u-boot.bin \
91    		--bl2 fip/bl2.n.bin.sig \
92    		--bl30 fip/bl30_new.bin.enc \
93    		--bl31 fip/bl31.img.enc \
94    		--bl33 fip/bl33.bin.enc
95
96and then write the image to SD with:
97
98.. code-block:: bash
99
100    $ DEV=/dev/your_sd_device
101    $ dd if=fip/u-boot.bin.sd.bin of=$DEV conv=fsync,notrunc bs=512 skip=1 seek=1
102    $ dd if=fip/u-boot.bin.sd.bin of=$DEV conv=fsync,notrunc bs=1 count=444
103