# Allwinner-H616

文档：https://wiki.yang17.top/products/github/allwinner-h616/
项目来源：https://github.com/JasonYANG170/Allwinner-H616
分类：软件项目
更新时间：2026-07-09T02:35:33.000Z

🔥 Linux SDK for Allwinner H616, based on armbian-build

Allwinner H616 Armbian Build

基于 Armbian 构建框架的 Allwinner H616 开发板支持。

支持的开发板

开发板
状态
说明

Yuzuki Chameleon
支持
主要测试板

BigTreeTech CB1
支持
需要单独配置

构建环境

推荐使用 Ubuntu 22.04 LTS。

系统要求

CPU: 4核以上

内存: 8GB 以上

磁盘: 50GB 以上可用空间

网络: 需要访问 GitHub

安装依赖

sudo apt update
sudo apt install -y \
 git \
 ccache \
 device-tree-compiler \
 dwarves \
 gcc-arm-linux-gnueabihf \
 qemu-user-static \
 u-boot-tools \
 libssl-dev

快速开始

1. 克隆仓库

git clone https://github.com/JasonYANG170/Allwinner-H616.git
cd Allwinner-H616

2. 克隆 Armbian 构建框架

git clone --depth=1 https://github.com/armbian/build armbian-build

3. 复制配置文件

# 复制板级配置
cp config/boards/yuzuki-chameleon.csc armbian-build/config/boards/

# 复制 XR829 扩展
cp extensions/xr829-wifi.sh armbian-build/extensions/

# 复制固件文件
mkdir -p armbian-build/packages/blobs/sunxi/h616/xr829
cp packages/blobs/sunxi/h616/xr829/* armbian-build/packages/blobs/sunxi/h616/xr829/

4. 构建镜像

cd armbian-build
sudo ./compile.sh \
 BOARD=yuzuki-chameleon \
 BRANCH=current \
 RELEASE=bookworm \
 BUILD_DESKTOP=no

GitHub Actions 自动构建

本项目支持通过 GitHub Actions 自动构建镜像。

触发构建

推送到 main 或 develop 分支

手动触发 Actions

创建 Pull Request

手动触发

在 GitHub 仓库页面：

点击 "Actions" 标签

选择 "Build Armbian Image"

点击 "Run workflow"

选择开发板、内核分支和发行版

点击 "Run workflow"

构建参数

参数
可选值
默认值
说明

BOARD
yuzuki-chameleon, bigtreetech-cb1
yuzuki-chameleon
开发板名称

BRANCH
legacy, current, edge
current
内核分支

RELEASE
bookworm, bullseye
bookworm
发行版

内核版本

分支
内核版本
说明

legacy
6.12
长期支持版

current
6.18
当前稳定版

edge
7.0
开发版

项目结构

Allwinner-H616/
├── .github/workflows/ # GitHub Actions 工作流
├── config/boards/ # 板级配置文件
├── extensions/ # Armbian 扩展
├── packages/ # 固件和包文件
├── armbian-build/ # Armbian 构建框架 (自动生成)
├── MIGRATION.md # 迁移说明
└── README.md # 本文件

WiFi 驱动支持

XR829 WiFi+BT

XR829 是 Xradio Technology 的 WiFi+BT 二合一芯片，集成在部分 H616 开发板上。

自动集成

通过 Armbian 扩展系统自动安装：

固件文件到 /lib/firmware/

模块配置到 /etc/modprobe.d/

蓝牙相关包

手动安装（遗留方式）

如果需要手动安装驱动（例如现有镜像）：

sudo cp packages/blobs/sunxi/h616/xr829/* /lib/firmware/
sudo mv /lib/firmware/sdd_xr829_40M.bin /lib/firmware/xr829.bin

版本信息

组件
版本

Armbian Build Framework
26.08.0-trunk

内核
6.18 (current)

U-Boot
v2026.07-rc4

发行版
Debian Bookworm

参考资料

Armbian 官方文档

Allwinner H616 开发

Armbian 构建系统

XR829 驱动

许可证

本项目基于 GPL-2.0 许可证。

贡献

欢迎贡献！请参阅 CONTRIBUTING.md 了解详情。

致谢

Armbian - 构建框架

Allwinner - 芯片支持

YuzukiHD - Yuzuki Chameleon 开发板

BigTreeTech - BigTreeTech CB1 开发板