查看英文说明 | View English description
此内核可用于 Armbian
和 OpenWrt
系统。例如 amlogic-s9xxx-armbian, amlogic-s9xxx-openwrt, flippy-openwrt-actions 和 unifreq/openwrt_packit 等项目。可以在编译固件时集成,也可以安装到已有的系统中使用。
你可以根据需要对内核的配置进行调整,如添加驱动和补丁。也可以根据心情编译具有特殊意义的个性化签名内核,如 5.10.95-happy-new-year
, 5.10.96-beijing-winter-olympics
, 5.10.99-valentines-day
等等。
-
克隆仓库到本地
git clone --depth 1 https://github.com/ophub/amlogic-s9xxx-armbian.git
-
安装必要的软件包(脚本仅在 x86_64 Ubuntu-20.04/22.04 下做过测试)
sudo apt-get update -y
sudo apt-get full-upgrade -y
# For Ubuntu-22.04
sudo apt-get install -y $(cat compile-kernel/tools/script/ubuntu2204-build-armbian-depends)
- 进入
~/amlogic-s9xxx-armbian
根目录,然后运行sudo ./recompile -d -k 5.10.125
等指定参数命令即可编译内核。脚本会自动下载安装编译环境和内核源码并做好全部设置。打包好的内核文件保存在compile-kernel/output
目录里。
-
更新本地编译环境和配置文件:
armbian-kernel -u
-
编译内核:运行
armbian-kernel -d -k 5.10.125
等指定参数命令即可编译内核。脚本会自动下载安装编译环境和内核源码并做好全部设置。打包好的内核文件保存在/opt/kernel/compile-kernel/output
目录里。
参数 | 含义 | 说明 |
---|---|---|
-d | Defaults | 使用默认配置 |
-k | Kernel | 指定 kernel 名称,如 -k 5.10.125 . 多个内核使用 _ 进行连接,如 -k 5.10.125_5.15.50 |
-a | AutoKernel | 设置是否自动采用同系列最新版本内核。当为 true 时,将自动查找在 -k 中指定的内核如 5.10.125 的同系列是否有更新的版本,如有 5.10.125 之后的最新版本时,将自动更换为最新版。设置为 false 时将编译指定版本内核。默认值:true |
-p | PackageList | 设置编译内核的包列表。默认值为 all ,将编译 Image, modules, dtbs 的全部文件。当设置值为 dtbs 时仅编译 3 个 dtbs 文件。 |
-n | CustomName | 设置内核自定义签名。默认值为 -ophub ,生成的内核名称为 5.10.125-ophub 。设置自定义签名时请勿包含空格。 |
-r | Repository | 指定编译内核的源代码仓库。默认为 unifreq 。可选择 kernel.org 的源码和 github.com 的内核源代码仓库。例如 -r kernel.org 或 -r unifreq 等。当使用 github.com 的内核源代码仓库时,可设置参数格式为 owner/repo@branch 三项组合,参数中的所有者名称 owner 为必选参数,内核源代码仓库名称 /repo 和 仓库的分支名称 @branch 为可选参数。当仅指定所有者名称 owner 参数时,将自动匹配所有者的名称为 linux-5.x.y 格式且分支为 main 的内核源代码仓库。如果仓库名称或分支名称不同,请使用组合方式指定,如 owner@branch 或 owner/repo 或 owner/repo@branch |
sudo ./recompile -d
: 使用默认配置编译内核。sudo ./recompile -d -k 5.10.125
: 使用默认配置,并通过-k
进行指定需要编译的内核版本,多个版本同时编译时使用_
进行连接。sudo ./recompile -d -k 5.10.125 -a true
: 使用默认配置,并通过-a
参数设置编译内核时,是否自动升级到同系列最新内核。sudo ./recompile -d -k 5.10.125 -n -ophub
: 使用默认配置,并通过-n
参数设置内核自定义签名。sudo ./recompile -d -k 5.10.125 -r kernel.org
: 使用默认配置,并通过-r
参数设置内核源代码仓库。sudo ./recompile -d -k 5.10.125 -p dtbs
: 使用默认配置,并通过-p
参数指定仅编译 dtbs 文件。sudo ./recompile -d -k 5.10.125_5.15.50 -a true -n -ophub -r kernel.org
: 使用默认配置,并通过多个参数进行设置。
💡提示:推荐使用 unifreq
的 5.10, 5.15 等仓库的内核源代码进行编译,他针对相关盒子添加了驱动和补丁。推荐使用 tools/config 中的模板,已经根据相关盒子进行了预配置,可以在此基础上进行个性化定制。
-
在 Action 页面里选择
Compile the kernel
,点击Run workflow
按钮即可编译。 -
详见使用模板 compile-kernel.yml 。代码如下:
- name: Compile the kernel
uses: ophub/amlogic-s9xxx-armbian@main
with:
build_target: kernel
kernel_version: 5.10.125_5.15.50
kernel_auto: true
kernel_sign: -yourname
💡注意: 如果你 fork
仓库并进行了修改,使用时须将 Actions 的 用户名
改成你自己的仓库,并根据说明中的第 2-3 条 添加 TOKEN,例如:
uses: YOUR-REPO/amlogic-s9xxx-armbian@main
相关参数与本地编译命令
相对应,请参考上面的说明。
参数 | 默认值 | 说明 |
---|---|---|
build_target | kernel | 固定参数 kernel ,设置编译目标为内核。 |
kernel_version | 5.10.125_5.15.50 | 指定 kernel 名称,如 5.10.125 。功能参考 -k |
kernel_auto | true | 设置是否自动采用同系列最新版本内核。默认值为 true 。功能参考 -a |
kernel_package | all | 设置编译内核的包列表。默认值为 all 。功能参考 -p |
kernel_sign | -ophub | 设置内核自定义签名。默认值为 -ophub 。功能参考 -n |
kernel_repo | unifreq | 指定编译内核的源代码仓库。默认值为 unifreq 。功能参考 -r |
kernel_config | 无 | 默认使用 tools/config 目录下的配置模板。你可以设置编译内核的配置文件在你仓库中的存放目录,如 kernel/config_path 。该目录下存储的配置模板必须以内核的主版本命名,如config-5.10 、config-5.15 等。 |
上传到 Releases
需要给仓库添加 GITHUB_TOKEN
和 GH_TOKEN
并设置 Workflow 读写权限
,详见使用说明。
参数 | 默认值 | 说明 |
---|---|---|
${{ env.PACKAGED_OUTPUTTAGS }} | 5.10.125_5.15.50 | 编译好的内核的名称 |
${{ env.PACKAGED_OUTPUTPATH }} | compile-kernel/output | 编译完成的内核所在文件夹的路径 |
${{ env.PACKAGED_OUTPUTDATE }} | 04.13.1058 | 编译日期(月.日.时分) |
${{ env.PACKAGED_STATUS }} | success | 编译状态:success / failure |
此内核可用于 Armbian
和 OpenWrt
系统。以 ophub 的项目进行举例说明。
下面分别对在编译 Armbian 固件时集成,以及如何安装到已有的系统中使用进行说明。
编译 Armbian 固件支持本地化操作,也支持使用 github.com 的 Actions 在线编译。其中本地化编译时的使用方法详见:本地化打包, 使用 Actions 在线编译的方法详见:使用 GitHub Actions 进行编译
可以使用 armbian-update
命令将编译好的内核安装到已有的 Armbian 系统中,具体操作方法详见:更新 Armbian 内核
下面分别对在 OpenWrt 系统中编译固件时集成和安装到已有的系统中使用进行介绍。
编译 OpenWrt 固件支持本地化操作,也支持使用 github.com 的 Actions 在线编译。其中本地化编译时的使用方法详见:本地化打包, 使用 Actions 在线编译的方法详见:使用 Actions 进行编译
可以使用 luci-app-amlogic 插件将编译好的内核安装到已有的 OpenWrt 系统中,具体操作方法详见:升级 OpenWrt