GitHub

Allwinner-H616

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

C2026-07-09T02:35:33Z★ 0

查看原始项目 ↗

项目文档

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

参考资料

许可证

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

贡献

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

致谢

Armbian - 构建框架
Allwinner - 芯片支持
YuzukiHD - Yuzuki Chameleon 开发板
BigTreeTech - BigTreeTech CB1 开发板