Armbian Linux Build Framework For ThirdReality LinuxBox Dev Edition

Armbian source code for Third Reality Linux Box Dev Edition.

Buy it on Third Reality Shop

Table of contents

• Compile firmware
• Flash firmware
• Tricks
• Upstream Armbian README

WIKI content

• How-to-Compile-firmware
• How-to-burn-the-image-to-LinuxBox

Relative Project

• LinuxBox Finder: A set of tools for configuring Linux Box via BLE.
• LinuxBox Installer: HomeAssistant Installer for Third Reality Linux Box Dev Edition
• LinuxBox Supervisor: supervisor For LinuxBox

Compile firmware

This branch is based on Armbian 24.11 with Linux kernel 6.6.158 and Debian bookworm.

Download

git clone git@github.com:thirdreality/LinuxBox.git -b hubv3-6.6.y

Build environment

The build runs on the Armbian build framework, so the host must meet its requirements:

• x86_64 / aarch64 machine
• at least 2GB of memory and ~35GB of disk space
• Ubuntu Jammy 22.04.x for native building, or any Docker capable Linux for containerised building
• Superuser rights (configured sudo or root access)
• An up-to-date system (outdated Docker binaries, for example, can cause trouble)

On the first run, compile.sh installs the missing host dependencies automatically.

For details of the generic Armbian build framework, see README-armbian.md.

Compile

Run in the root directory of the repository.

cd LinuxBox; ./make-armbian-build-release.sh -b hubv3

Options:

• -b board: hubv3 or hubv3l (default hubv3)
• -r release version, e.g. v2.14.01.55 (default is the version in the script)

The compiled generated firmware is located:

output/images/thirdreality_<board>_armbian_24.11_bookworm_6.6.158_v2.x.x.burn.img.zip

Here is a pre-compiled image. If you don't have time to compile the image yourself and don't mind if it's slightly outdated, you can give it a try:

• hubv3:
• hubv3l:

More detail information please check How-to-Compile-firmware

Flash firmware

To prepare the burning environment on the computer:

1. Download and extract the file Aml_Burn_Tool.zip.
2. If this is your first time using the tool, click on Setup_Aml_Burn_Tool_V3.1.0.exe to install necessary drivers.
3. Next, navigate to the v2 folder and run Aml_Burn_Tool.exe.
4. Unzip the compiled *.burn.img.zip and load the *.burn.img firmware file.
5. Click on Start to initiate the burn process.
6. Press and hold the button circled in the image below, then connect the black line to your computer and start flashing. You can release the button when you start flashing.

More detail information please check the wiki: How-to-burn-the-image-to-LinuxBox

Tricks for using LinuxBox

HomeAssistant

Thirdreality dev team supply a new way to install home assistant core in 8-10 minutes.

Check it in WIKI: Tricks-for-Homeassistant

License

This software is published under the GPL-2.0 License license.