Compile Talos Linux Image from Source Code

1. Setting Up the Compilation Environment

1.1 Installing Docker (If Not Installed)

If Docker is not installed on your system, follow these steps to install it:

# Update package index
sudo apt update

# Install required dependencies
sudo apt install -y ca-certificates curl gnupg

# Add Docker's official GPG key
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo tee /etc/apt/keyrings/docker.asc > /dev/null
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add Docker repository
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# Update package index
sudo apt update

# Install Docker CE and Buildx
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin

# Start Docker service
sudo systemctl start docker

1.2 Logging into ghcr.io

echo "Your Personal Access Token" | docker login ghcr.io -u YourGitHubUsername --password-stdin

Ensure that you have selected read:packages and write:packages permissions.

Replace USERNAME in build.sh with your GitHub username:

# export USERNAME=buyuliang
export USERNAME=xxx

2. Compilation

2.1 Compiling

After entering the container, execute the following command to start the compilation process:

./build.sh

3. Flashing the Compiled Output

After compilation, the installer-arm64.tar file will be available in the output directory:

output/_out/
└── installer-arm64.tar

For Metal builds, note that the construction command must be executed on a physical machine and cannot be run in a virtual machine. The final output will be a RAW image:

_out/
└── metal-arm64.raw.xz # xz-compressed raw image

3.1 Preparing the Flashing Tool

Download and install rkdeveloptool for flashing firmware:

git clone https://github.com/mixtile-rockchip/rkdeveloptool.git

Follow the README instructions to install

3.2 Entering Flash Mode

Connect the device to the PC and enter flash mode (usually by holding a specific button while powering on). Then check if the device is detected:

rkdeveloptool list

3.3 Flashing the RAW Image

rkdeveloptool db output/uboot/rk3588_spl_loader_xxxx.bin
rkdeveloptool wl 0 metal-arm64.raw

3.4 Restarting the Device

Once flashing is complete, reboot the device with the following command:

rkdeveloptool rd

At this point, the entire compilation and flashing process is complete. The device should boot and run the newly flashed firmware successfully.

Note: Some PD adapters may be restarted. Adapters with non-PD protocol and 5V/3A support are recommended