1.. SPDX-License-Identifier: GPL-2.0+
2
3U-Boot for Khadas VIM
4======================
5
6Khadas VIM is an Open Source DIY Box manufactured by Shenzhen Wesion
7Technology Co., Ltd with the following specifications:
8
9 - Amlogic S905X ARM Cortex-A53 quad-core SoC @ 1.5GHz
10 - ARM Mali 450 GPU
11 - 2GB DDR3 SDRAM
12 - 10/100 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 - 8GB/16GBeMMC
17 - microSD
18 - SDIO Wifi Module, Bluetooth
19 - Two channels IR receiver
20
21U-Boot compilation
22------------------
23
24.. code-block:: bash
25
26    $ export CROSS_COMPILE=aarch64-none-elf-
27    $ make khadas-vim_defconfig
28    $ make
29
30Image creation
31--------------
32
33Amlogic doesn't provide sources for the firmware and for tools needed
34to create the bootloader image, so it is necessary to obtain them from
35the git tree published by the board vendor:
36
37.. code-block:: bash
38
39    $ wget https://releases.linaro.org/archive/13.11/components/toolchain/binaries/gcc-linaro-aarch64-none-elf-4.8-2013.11_linux.tar.xz
40    $ wget https://releases.linaro.org/archive/13.11/components/toolchain/binaries/gcc-linaro-arm-none-eabi-4.8-2013.11_linux.tar.xz
41    $ tar xvfJ gcc-linaro-aarch64-none-elf-4.8-2013.11_linux.tar.xz
42    $ tar xvfJ gcc-linaro-arm-none-eabi-4.8-2013.11_linux.tar.xz
43    $ 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
44    $ git clone https://github.com/khadas/u-boot -b Vim vim-u-boot
45    $ cd vim-u-boot
46    $ make kvim_defconfig
47    $ make CROSS_COMPILE=aarch64-none-elf-
48    $ export FIPDIR=$PWD/fip
49
50Go back to mainline U-Boot source tree then :
51
52.. code-block:: bash
53
54    $ mkdir fip
55
56    $ cp $FIPDIR/gxl/bl2.bin fip/
57    $ cp $FIPDIR/gxl/acs.bin fip/
58    $ cp $FIPDIR/gxl/bl21.bin fip/
59    $ cp $FIPDIR/gxl/bl30.bin fip/
60    $ cp $FIPDIR/gxl/bl301.bin fip/
61    $ cp $FIPDIR/gxl/bl31.img fip/
62    $ cp u-boot.bin fip/bl33.bin
63
64    $ $FIPDIR/blx_fix.sh \
65    	fip/bl30.bin \
66    	fip/zero_tmp \
67    	fip/bl30_zero.bin \
68    	fip/bl301.bin \
69    	fip/bl301_zero.bin \
70    	fip/bl30_new.bin \
71    	bl30
72
73    $ python $FIPDIR/acs_tool.pyc fip/bl2.bin fip/bl2_acs.bin fip/acs.bin 0
74
75    $ $FIPDIR/blx_fix.sh \
76    	fip/bl2_acs.bin \
77    	fip/zero_tmp \
78    	fip/bl2_zero.bin \
79    	fip/bl21.bin \
80    	fip/bl21_zero.bin \
81    	fip/bl2_new.bin \
82    	bl2
83
84    $ $FIPDIR/gxl/aml_encrypt_gxl --bl3enc --input fip/bl30_new.bin
85    $ $FIPDIR/gxl/aml_encrypt_gxl --bl3enc --input fip/bl31.img
86    $ $FIPDIR/gxl/aml_encrypt_gxl --bl3enc --input fip/bl33.bin
87    $ $FIPDIR/gxl/aml_encrypt_gxl --bl2sig --input fip/bl2_new.bin --output fip/bl2.n.bin.sig
88    $ $FIPDIR/gxl/aml_encrypt_gxl --bootmk \
89    		--output fip/u-boot.bin \
90    		--bl2 fip/bl2.n.bin.sig \
91    		--bl30 fip/bl30_new.bin.enc \
92    		--bl31 fip/bl31.img.enc \
93    		--bl33 fip/bl33.bin.enc
94
95and then write the image to SD with:
96
97.. code-block:: bash
98
99    $ DEV=/dev/your_sd_device
100    $ dd if=fip/u-boot.bin.sd.bin of=$DEV conv=fsync,notrunc bs=512 skip=1 seek=1
101    $ dd if=fip/u-boot.bin.sd.bin of=$DEV conv=fsync,notrunc bs=1 count=444
102