Skip to content

guide_zh

Jump to bottom
Finn.Zhang edited this page Jul 7, 2026 · 4 revisions

Cix Linux Opensource

English | 简体中文 |

权限要求

  • 25Q4 版本编译需要在特权模式下进行（root 用户或具有 sudo 权限）
  • 26Q2 及之后版本默认使用docker环境编译。

支持平台

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

一、环境初始化

1. 安装基础依赖

一次性安装所有必需的系统和编译工具：

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. 配置 Git 用户信息

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

3. 安装 Repo 工具

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

注意：repo 工具依赖 python3，上述步骤已安装 python-is-python3 确保 python 命令可用。

二、代码下载与工作空间设置

1. 创建并初始化工作空间

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

2. 同步代码

repo sync

同步最后一个仓库时耗时可能较长，且受网络波动影响，请耐心等待直至完成。

三、编译环境准备

1. 加载环境变量

source ./build-scripts/envtool.sh

2. 初始化环境

说明：

  • 25Q4 版本：需要执行以下命令完成初始化： 
    export USER=root （仅在 root 用户下执行）
newer_env
  • 26Q2 及之后版本：非 root 用户无需额外配置，只要当前用户具有 docker 权限即可正常初始化。建议不要直接使用 root 用户运行编译流程。 26Q2 及之后版本默认使用docker环境编译，已无需执行 newer_env，可直接进入下一步。

3. 下载编译资源

source ./build-scripts/envtool.sh
updateres
  • 资源包体积较大，下载时间较长属正常现象
  • 如果执行过程中报错提示"资源不完整"或解压失败，请重复执行该命令，直到成功为止

四、执行编译

1. 开始编译

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

2. 编译产物

编译成功后，生成的镜像文件位于：

./output/cix_evb/images/

主要产物说明：

  • linux-fs.sdcard：系统镜像
  • cix_debian.iso：修改后的 Debian 安装 ISO
  • cix_flash_all_O6.bin：星睿 O6 BIOS 镜像

镜像烧写说明：

  • linux-fs.sdcard：可通过 NVMe 烧写器，在 Ubuntu 环境下使用 dd 命令烧写到 NVMe SSD 中；也可以使用 Windows 工具进行烧录。
  • cix_debian.iso：一般用于制作安装盘（U 盘），然后插入板子进行系统安装。
  • cix_flash_all_O6.bin：可到 Radxa 官方网站下载工具进行烧写：https://dl.radxa.com/orion/o6/

说明文档下载：

Clone this wiki locally