mirror of
https://github.com/AsahiLinux/u-boot
synced 2024-12-04 10:30:32 +00:00
4ae9747804
As already documented in this README, several binaries must be glued together in order to boot the device. Extend the documentation to cover the prebuilt binaries (saving you the hassle of installing ancient cross-compilers), and also mention the open source replacements for the encryption tool (which is especially useful if you want to avoid requiring 32-bit x86 binaries in your build system). Signed-off-by: Daniel Drake <drake@endlessm.com> Cc: Neil Armstrong <narmstrong@baylibre.com> Signed-off-by: Neil Armstrong <narmstrong@baylibre.com>
135 lines
4.2 KiB
Text
135 lines
4.2 KiB
Text
U-Boot for LibreTech CC
|
|
=======================
|
|
|
|
LibreTech CC is a single board computer manufactured by Libre Technology
|
|
with the following specifications:
|
|
|
|
- Amlogic S905X ARM Cortex-A53 quad-core SoC @ 1.5GHz
|
|
- ARM Mali 450 GPU
|
|
- 2GB DDR3 SDRAM
|
|
- 10/100 Ethernet
|
|
- HDMI 2.0 4K/60Hz display
|
|
- 40-pin GPIO header
|
|
- 4 x USB 2.0 Host
|
|
- eMMC, microSD
|
|
- Infrared receiver
|
|
|
|
Schematics are available on the manufacturer website.
|
|
|
|
Currently the U-Boot port supports the following devices:
|
|
- serial
|
|
- eMMC, microSD
|
|
- Ethernet
|
|
- I2C
|
|
- Regulators
|
|
- Reset controller
|
|
- Clock controller
|
|
- USB Host
|
|
- ADC
|
|
|
|
U-Boot compilation
|
|
==================
|
|
|
|
> export ARCH=arm
|
|
> export CROSS_COMPILE=aarch64-none-elf-
|
|
> make libretech-cc_defconfig
|
|
> make
|
|
|
|
Image creation
|
|
==============
|
|
|
|
To boot the system, u-boot must be combined with several earlier stage
|
|
bootloaders:
|
|
|
|
* bl2.bin: vendor-provided binary blob
|
|
* bl21.bin: built from vendor u-boot source
|
|
* bl30.bin: vendor-provided binary blob
|
|
* bl301.bin: built from vendor u-boot source
|
|
* bl31.bin: vendor-provided binary blob
|
|
* acs.bin: built from vendor u-boot source
|
|
|
|
These binaries and the tools required below have been collected and prebuilt
|
|
for convenience at <https://github.com/BayLibre/u-boot/releases/>
|
|
|
|
Download and extract the libretech-cc release from there, and set FIPDIR to
|
|
point to the `fip` subdirectory.
|
|
|
|
> export FIPDIR=/path/to/extracted/fip
|
|
|
|
Alternatively, you can obtain the original vendor u-boot tree which
|
|
contains the required blobs and sources, and build yourself.
|
|
Note that old compilers are required for this to build. The compilers here
|
|
are suggested by Amlogic, and they are 32-bit x86 binaries.
|
|
|
|
> wget https://releases.linaro.org/archive/13.11/components/toolchain/binaries/gcc-linaro-aarch64-none-elf-4.8-2013.11_linux.tar.xz
|
|
> wget https://releases.linaro.org/archive/13.11/components/toolchain/binaries/gcc-linaro-arm-none-eabi-4.8-2013.11_linux.tar.xz
|
|
> tar xvfJ gcc-linaro-aarch64-none-elf-4.8-2013.11_linux.tar.xz
|
|
> tar xvfJ gcc-linaro-arm-none-eabi-4.8-2013.11_linux.tar.xz
|
|
> 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
|
|
> git clone https://github.com/BayLibre/u-boot.git -b libretech-cc amlogic-u-boot
|
|
> cd amlogic-u-boot
|
|
> make libretech_cc_defconfig
|
|
> make
|
|
> export FIPDIR=$PWD/fip
|
|
|
|
Once you have the binaries available (either through the prebuilt download,
|
|
or having built the vendor u-boot yourself), you can then proceed to glue
|
|
everything together. Go back to mainline U-Boot source tree then :
|
|
|
|
> mkdir fip
|
|
|
|
> cp $FIPDIR/gxl/bl2.bin fip/
|
|
> cp $FIPDIR/gxl/acs.bin fip/
|
|
> cp $FIPDIR/gxl/bl21.bin fip/
|
|
> cp $FIPDIR/gxl/bl30.bin fip/
|
|
> cp $FIPDIR/gxl/bl301.bin fip/
|
|
> cp $FIPDIR/gxl/bl31.img fip/
|
|
> cp u-boot.bin fip/bl33.bin
|
|
|
|
> $FIPDIR/blx_fix.sh \
|
|
fip/bl30.bin \
|
|
fip/zero_tmp \
|
|
fip/bl30_zero.bin \
|
|
fip/bl301.bin \
|
|
fip/bl301_zero.bin \
|
|
fip/bl30_new.bin \
|
|
bl30
|
|
|
|
> $FIPDIR/acs_tool.pyc fip/bl2.bin fip/bl2_acs.bin fip/acs.bin 0
|
|
|
|
> $FIPDIR/blx_fix.sh \
|
|
fip/bl2_acs.bin \
|
|
fip/zero_tmp \
|
|
fip/bl2_zero.bin \
|
|
fip/bl21.bin \
|
|
fip/bl21_zero.bin \
|
|
fip/bl2_new.bin \
|
|
bl2
|
|
|
|
> $FIPDIR/gxl/aml_encrypt_gxl --bl3enc --input fip/bl30_new.bin
|
|
> $FIPDIR/gxl/aml_encrypt_gxl --bl3enc --input fip/bl31.img
|
|
> $FIPDIR/gxl/aml_encrypt_gxl --bl3enc --input fip/bl33.bin
|
|
> $FIPDIR/gxl/aml_encrypt_gxl --bl2sig --input fip/bl2_new.bin --output fip/bl2.n.bin.sig
|
|
> $FIPDIR/gxl/aml_encrypt_gxl --bootmk \
|
|
--output fip/u-boot.bin \
|
|
--bl2 fip/bl2.n.bin.sig \
|
|
--bl30 fip/bl30_new.bin.enc \
|
|
--bl31 fip/bl31.img.enc \
|
|
--bl33 fip/bl33.bin.enc
|
|
|
|
and then write the image to SD with:
|
|
|
|
> DEV=/dev/your_sd_device
|
|
> dd if=fip/u-boot.bin.sd.bin of=$DEV conv=fsync,notrunc bs=512 skip=1 seek=1
|
|
> dd if=fip/u-boot.bin.sd.bin of=$DEV conv=fsync,notrunc bs=1 count=444
|
|
|
|
Note that Amlogic provides aml_encrypt_gxl as a 32-bit x86 binary with no
|
|
source code. Should you prefer to avoid that, there are open source reverse
|
|
engineered versions available:
|
|
|
|
1. gxlimg <https://github.com/repk/gxlimg>, which comes with a handy
|
|
Makefile that automates the whole process.
|
|
2. meson-tools <https://github.com/afaerber/meson-tools>
|
|
|
|
However, these community-developed alternatives are not endorsed by or
|
|
supported by Amlogic.
|