How to Compile firmware

How to Compile the Firmware

This page shows the procedure to compile the source code of the ThirdReality LinuxBox Dev edition.

1. Download the source code from GitHub

Supported OS: Debian 12, Ubuntu 22.04

git clone git@github.com:thirdreality/LinuxBox.git

Here is a similar log:

Cloning into 'LinuxBox'...
remote: Enumerating objects: 84723, done.
remote: Total 84723 (delta 0), reused 0 (delta 0), pack-reused 84723 (from 1)
Receiving objects: 100% (84723/84723), 497.58 MiB | 1.13 MiB/s, done.
Resolving deltas: 100% (56121/56121), done.
Updating files: 100% (11012/11012), done.

2. Quick way to compile the source code

cd LinuxBox
./make_armbian_for_hubv3.sh

Here is part of the compile log:

** Board selected: [ trhubv3 ]
** Destination selected: [  ]
** HomeAssistant supported: [ no ]
cp: cannot stat '/root/github/LinuxBox/custom/*.deb': No such file or directory
[ o.k. ] This script will try to update
[ o.k. ] Create example config file using template [ config-default.conf ]
[ o.k. ] Using config file [ /root/github/LinuxBox/userpatches/config-hubv3-images.conf ]

3. Custom way to compile the source code

./compile.sh hubv3-images BOARD=${board} BRANCH=current RELEASE=bookworm \
        BUILD_MINIMAL=no BUILD_DESKTOP=no KERNEL_ONLY=no KERNEL_CONFIGURE=no \
        COMPRESS_OUTPUTIMAGE=sha,gpg,img INSTALL_HEADERS=no WIREGUARD=no

If an SSH key error occurs, you can use the following command:

git config --global core.sshCommand "ssh -i /home/<user>/.ssh/id_rsa"

More usage please refer to Armbian Document

4. About the output image

LinuxBox/output/images/*.burn.image

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:

linuxbox-image-5.10.247.v1.14.01.21.img

Thank you!