| Neil Armstrong | 84e5e8e | 2020-06-11 10:53:49 +0200 | [diff] [blame] | 1 | .. SPDX-License-Identifier: GPL-2.0+ |
| 2 | |
| 3 | U-Boot for Khadas VIM |
| 4 | ====================== |
| 5 | |
| 6 | Khadas VIM is an Open Source DIY Box manufactured by Shenzhen Wesion |
| 7 | Technology 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 | |
| 21 | U-Boot compilation |
| 22 | ------------------ |
| 23 | |
| 24 | .. code-block:: bash |
| 25 | |
| 26 | $ export CROSS_COMPILE=aarch64-none-elf- |
| 27 | $ make khadas-vim_defconfig |
| 28 | $ make |
| 29 | |
| 30 | Image creation |
| 31 | -------------- |
| 32 | |
| Neil Armstrong | 2ea9868 | 2022-03-02 10:42:22 +0100 | [diff] [blame] | 33 | For simplified usage, pleaser refer to :doc:`pre-generated-fip` with codename `khadas-vim` |
| 34 | |
| Neil Armstrong | 84e5e8e | 2020-06-11 10:53:49 +0200 | [diff] [blame] | 35 | Amlogic doesn't provide sources for the firmware and for tools needed |
| 36 | to create the bootloader image, so it is necessary to obtain them from |
| 37 | the git tree published by the board vendor: |
| 38 | |
| 39 | .. code-block:: bash |
| 40 | |
| 41 | $ wget https://releases.linaro.org/archive/13.11/components/toolchain/binaries/gcc-linaro-aarch64-none-elf-4.8-2013.11_linux.tar.xz |
| 42 | $ wget https://releases.linaro.org/archive/13.11/components/toolchain/binaries/gcc-linaro-arm-none-eabi-4.8-2013.11_linux.tar.xz |
| 43 | $ tar xvfJ gcc-linaro-aarch64-none-elf-4.8-2013.11_linux.tar.xz |
| 44 | $ tar xvfJ gcc-linaro-arm-none-eabi-4.8-2013.11_linux.tar.xz |
| 45 | $ 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 |
| 46 | $ git clone https://github.com/khadas/u-boot -b Vim vim-u-boot |
| 47 | $ cd vim-u-boot |
| 48 | $ make kvim_defconfig |
| 49 | $ make CROSS_COMPILE=aarch64-none-elf- |
| 50 | $ export FIPDIR=$PWD/fip |
| 51 | |
| 52 | Go back to mainline U-Boot source tree then : |
| 53 | |
| 54 | .. code-block:: bash |
| 55 | |
| 56 | $ mkdir fip |
| 57 | |
| 58 | $ cp $FIPDIR/gxl/bl2.bin fip/ |
| 59 | $ cp $FIPDIR/gxl/acs.bin fip/ |
| 60 | $ cp $FIPDIR/gxl/bl21.bin fip/ |
| 61 | $ cp $FIPDIR/gxl/bl30.bin fip/ |
| 62 | $ cp $FIPDIR/gxl/bl301.bin fip/ |
| 63 | $ cp $FIPDIR/gxl/bl31.img fip/ |
| 64 | $ cp u-boot.bin fip/bl33.bin |
| 65 | |
| 66 | $ $FIPDIR/blx_fix.sh \ |
| 67 | fip/bl30.bin \ |
| 68 | fip/zero_tmp \ |
| 69 | fip/bl30_zero.bin \ |
| 70 | fip/bl301.bin \ |
| 71 | fip/bl301_zero.bin \ |
| 72 | fip/bl30_new.bin \ |
| 73 | bl30 |
| 74 | |
| 75 | $ python $FIPDIR/acs_tool.pyc fip/bl2.bin fip/bl2_acs.bin fip/acs.bin 0 |
| 76 | |
| 77 | $ $FIPDIR/blx_fix.sh \ |
| 78 | fip/bl2_acs.bin \ |
| 79 | fip/zero_tmp \ |
| 80 | fip/bl2_zero.bin \ |
| 81 | fip/bl21.bin \ |
| 82 | fip/bl21_zero.bin \ |
| 83 | fip/bl2_new.bin \ |
| 84 | bl2 |
| 85 | |
| 86 | $ $FIPDIR/gxl/aml_encrypt_gxl --bl3enc --input fip/bl30_new.bin |
| 87 | $ $FIPDIR/gxl/aml_encrypt_gxl --bl3enc --input fip/bl31.img |
| 88 | $ $FIPDIR/gxl/aml_encrypt_gxl --bl3enc --input fip/bl33.bin |
| 89 | $ $FIPDIR/gxl/aml_encrypt_gxl --bl2sig --input fip/bl2_new.bin --output fip/bl2.n.bin.sig |
| 90 | $ $FIPDIR/gxl/aml_encrypt_gxl --bootmk \ |
| 91 | --output fip/u-boot.bin \ |
| 92 | --bl2 fip/bl2.n.bin.sig \ |
| 93 | --bl30 fip/bl30_new.bin.enc \ |
| 94 | --bl31 fip/bl31.img.enc \ |
| 95 | --bl33 fip/bl33.bin.enc |
| 96 | |
| 97 | and then write the image to SD with: |
| 98 | |
| 99 | .. code-block:: bash |
| 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 |