libretech-builder-simple
Purpose
Builds bootloaders for Libre Computer boards.
Prerequisites
Linux machine or virtual machine
Usage
#install pre-requisites via apt or yum
sudo ./setup.sh
git clone --single-branch --depth 1 https://github.com/libre-computer-project/libretech-builder-simple.git
./build.sh BOARD_TARGET
Board Targets
- all-h3-cc-h3
- all-h3-cc-h5
- aml-s805x-ac
- aml-s905x-cc
- aml-s905x-cc-v2
- aml-s905d-pc
- roc-rk3328-cc
- roc-rk3399-pc
Bootloader Flashing
Default output directory is out/ and is set by LBS_OUT_PATH in configs/build.
Output bootloader needs to be written to the bootloader offset disk sector.
sudo dd if=out/BOARD_TARGET of=/dev/null bs=512 seek=BOOTLOADER_OFFSET
Replace "BOARD_TARGET", "null", "BOOTLOADER_OFFSET" with the proper file, block device, and bootloader offset respectively. Be careful not to overwrite the wrong block device!
Bootloader Flashing to SPI
For boards with SPI NOR, there is a separate board bootloader target ending with -spiflash. To flash SPI NOR, dump the output image to a MMC device and the board will boot and flash the SPI NOR.
sudo dd if=out/BOARD_TARGET-spiflash of=/dev/null bs=1M
Advanced Configuration
u-boot
#To configure u-boot, set LBS_UBOOT_MENUCONFIG=1.
LBS_UBOOT_MENUCONFIG=1 ./build.sh BOARD_TARGET
Amlogic
Amlogic ATF is not open source so pre-compiled binaries for specific boards are available in this repository.
There is an open source implementation of BL31 available in the upstream ATF repository. It can be enabled by changing the AML_ENCRYPT=gxl to AML_GXLIMG=1 in the board configuration file.
More Information
ARM Trusted Firmware
ARM Trusted Firmware Documentation ARM Trusted Firmware Design
U-Boot
U-Boot Documentation U-Boot Usage