doc/board/amlogic/odroid-c4.rst

   1 .. SPDX-License-Identifier: GPL-2.0+
   2
   3 U-Boot for ODROID-C4
   4 ====================
   5
   6 ODROID-C4 is a single board computer manufactured by Hardkernel
   7 Co. 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
  20 Schematics are available on the manufacturer website.
  21
  22 U-Boot compilation
  23 ------------------
  24
  25 .. code-block:: bash
  26
  27     $ export CROSS_COMPILE=aarch64-none-elf-
  28     $ make odroid-c4_defconfig
  29     $ make
  30
  31 Image creation
  32 --------------
  33
  34 Amlogic doesn't provide sources for the firmware and for tools needed
  35 to create the bootloader image, so it is necessary to obtain them from
  36 the 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
  56 Go 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
 128 and 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