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

libre-computer-project/libretech-builder-simple