Home

Cix Linux Opensource

English | 简体中文 |

---

Prerequisites

• The 25Q4 version must be compiled in privileged mode (root user or with sudo privileges).
• For 26Q2 and later versions, the build runs in a Docker environment by default.

Supported Platforms

• CIX EVB
• Radxa Orion O6
• MG MS-R1
• BeiQi AI PC

I. Environment Setup

1. Install Dependencies

Install all required system and build tools at once:

apt update
apt install -y git curl sudo wget python3-pip python-is-python3 \
             lsb-release p7zip-full p7zip-rar bison build-essential jq

2. Configure Git

git config --global user.name "your_account_name"
git config --global user.email "your_email@example.com"

3. Install the Repo Tool

curl https://storage.googleapis.com/git-repo-downloads/repo -o repo
chmod +x repo
mv ./repo /usr/bin/

Note: The repo tool depends on python3. The python-is-python3 package installed above ensures the python command is available.

II. Code Download and Workspace Setup

1. Create and Initialize the Workspace

mkdir workspace
cd workspace
repo init -b cix_p1_k6.6_master https://github.com/cixtech/cix-manifest/

2. Sync the Code

repo sync

Syncing the last repository may take a long time and is affected by network fluctuations. Please be patient until it completes.

III. Build Environment Preparation

1. Load Environment Variables

source ./build-scripts/envtool.sh

2. Initialize the Environment

Notes:

• 25Q4 version: Run the following commands to initialize:

  export USER=root (only run under root user)
  newer_env

• 26Q2 and later versions: Non-root users do not need extra configuration; initialization works as long as the current user has Docker permissions. It is recommended not to run the build flow directly as root. For 26Q2 and later versions, Docker is used by default and newer_env is no longer required; you can proceed directly to the next step.

3. Download Build Resources

source ./build-scripts/envtool.sh
updateres

• The resource packages are large; a long download time is normal.
• If you see an error indicating "resources incomplete" or extraction fails, re-run this command until it succeeds.

IV. Build

1. Start the Build

source ./build-scripts/envtool.sh
build all

2. Build Artifacts

After a successful build, the generated image files are located at:

./output/cix_evb/images/

Main artifact descriptions:

• linux-fs.sdcard: System image
• cix_debian.iso: Modified Debian installation ISO
• cix_flash_all_O6.bin: Orion O6 BIOS image

Image flashing instructions:

• linux-fs.sdcard: Can be flashed to an NVMe SSD in an Ubuntu environment using the dd command via an NVMe programmer; it can also be flashed using Windows tools.
• cix_debian.iso: Typically used to create an installation disk (USB flash drive), which is then inserted into the board for system installation.
• cix_flash_all_O6.bin: Can be flashed using the tool downloaded from the Radxa official website: https://dl.radxa.com/orion/o6/

Documentation download:

• URL: https://developer.cixtech.com/