538604261b84978ed90e35021ff9360c79d94a99
[oweals/u-boot.git] / board / amlogic / p212 / README.libretech-ac
1 U-Boot for LibreTech AC
2 =======================
3
4 LibreTech AC is a single board computer manufactured by Libre Technology
5 with the following specifications:
6
7  - Amlogic S805X ARM Cortex-A53 quad-core SoC @ 1.2GHz
8  - ARM Mali 450 GPU
9  - 512MiB DDR4 SDRAM
10  - 10/100 Ethernet
11  - HDMI 2.0 4K/60Hz display
12  - 40-pin GPIO header
13  - 4 x USB 2.0 Host
14  - eMMC, SPI NOR Flash
15  - Infrared receiver
16
17 Schematics are available on the manufacturer website.
18
19 Currently the U-Boot port supports the following devices:
20  - serial
21  - eMMC
22  - Ethernet
23  - USB
24
25 U-Boot compilation
26 ==================
27
28  > export ARCH=arm
29  > export CROSS_COMPILE=aarch64-none-elf-
30  > make libretech-ac_defconfig
31  > make
32
33 Image creation
34 ==============
35
36 Amlogic doesn't provide sources for the firmware and for tools needed
37 to create the bootloader image, so it is necessary to obtain them from
38 the git tree published by the board vendor:
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/BayLibre/u-boot.git -b libretech-ac amlogic-u-boot
46  > cd amlogic-u-boot
47  > wget https://raw.githubusercontent.com/BayLibre/u-boot/libretech-cc/fip/blx_fix.sh
48  > make libretech_ac_defconfig
49  > make
50  > export UBOOTDIR=$PWD
51
52 Download the latest Amlogic Buildroot package, and extract it :
53  > wget http://openlinux2.amlogic.com:8000/ARM/filesystem/Linux_BSP/buildroot_openlinux_kernel_4.9_fbdev_20180418.tar.gz
54  > tar xfz buildroot_openlinux_kernel_4.9_fbdev_20180418.tar.gz buildroot_openlinux_kernel_4.9_fbdev_20180418/bootloader
55  > export BRDIR=$PWD/buildroot_openlinux_kernel_4.9_fbdev_20180418
56
57 Go back to mainline U-Boot source tree then :
58  > mkdir fip
59
60  > cp $UBOOTDIR/build/scp_task/bl301.bin fip/
61  > cp $UBOOTDIR/build/board/amlogic/libretech_ac/firmware/bl21.bin fip/
62  > cp $UBOOTDIR/build/board/amlogic/libretech_ac/firmware/acs.bin fip/
63  > cp $BRDIR/bootloader/uboot-repo/bl2/bin/gxl/bl2.bin fip/
64  > cp $BRDIR/bootloader/uboot-repo/bl30/bin/gxl/bl30.bin fip/
65  > cp $BRDIR/bootloader/uboot-repo/bl31/bin/gxl/bl31.img fip/
66  > cp u-boot.bin fip/bl33.bin
67
68  > sh $UBOOTDIR/blx_fix.sh \
69         fip/bl30.bin \
70         fip/zero_tmp \
71         fip/bl30_zero.bin \
72         fip/bl301.bin \
73         fip/bl301_zero.bin \
74         fip/bl30_new.bin \
75         bl30
76
77  > $BRDIR/bootloader/uboot-repo/fip/acs_tool.pyc fip/bl2.bin fip/bl2_acs.bin fip/acs.bin 0
78
79  > sh $UBOOTDIR/blx_fix.sh \
80         fip/bl2_acs.bin \
81         fip/zero_tmp \
82         fip/bl2_zero.bin \
83         fip/bl21.bin \
84         fip/bl21_zero.bin \
85         fip/bl2_new.bin \
86         bl2
87
88  > $BRDIR/bootloader/uboot-repo/fip/gxl/aml_encrypt_gxl --bl3enc --input fip/bl30_new.bin
89  > $BRDIR/bootloader/uboot-repo/fip/gxl/aml_encrypt_gxl --bl3enc --input fip/bl31.img
90  > $BRDIR/bootloader/uboot-repo/fip/gxl/aml_encrypt_gxl --bl3enc --input fip/bl33.bin
91  > $BRDIR/bootloader/uboot-repo/fip/gxl/aml_encrypt_gxl --bl2sig --input fip/bl2_new.bin --output fip/bl2.n.bin.sig
92  > $BRDIR/bootloader/uboot-repo/fip/gxl/aml_encrypt_gxl --bootmk \
93                 --output fip/u-boot.bin \
94                 --bl2 fip/bl2.n.bin.sig \
95                 --bl30 fip/bl30_new.bin.enc \
96                 --bl31 fip/bl31.img.enc \
97                 --bl33 fip/bl33.bin.enc
98
99 and then write the image to SD with:
100
101  > DEV=/dev/your_sd_device
102  > dd if=fip/u-boot.bin.sd.bin of=$DEV conv=fsync,notrunc bs=512 skip=1 seek=1
103  > dd if=fip/u-boot.bin.sd.bin of=$DEV conv=fsync,notrunc bs=1 count=444