Skip to content

Latest commit

 

History

History
141 lines (93 loc) · 10.7 KB

README.cn.md

File metadata and controls

141 lines (93 loc) · 10.7 KB
Raw

内核编译和使用说明

查看英文说明 | 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 等等。

内核存储库

在 ophub/kernel 的 Releases 里有已经编译好的内核。

本地编译

  • 在 Ubuntu 系统下运行

  1. 克隆仓库到本地 git clone --depth 1 https://github.com/ophub/amlogic-s9xxx-armbian.git

  2. 安装必要的软件包（脚本仅在 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)
  1. 进入 ~/amlogic-s9xxx-armbian 根目录，然后运行 sudo ./recompile -k 5.15.100 等指定参数命令即可编译内核。脚本会自动下载安装编译环境和内核源码并做好全部设置。打包好的内核文件保存在 compile-kernel/output 目录里。

  • 在 Armbian 系统下运行

  1. 更新本地编译环境和配置文件：armbian-kernel -u

  2. 编译内核：运行 armbian-kernel -k 5.15.100 等指定参数命令即可编译内核。脚本会自动下载安装编译环境和内核源码并做好全部设置。打包好的内核文件保存在 /opt/kernel/compile-kernel/output 目录里。

  • 本地编译参数说明

参数 含义 说明
-r Repository 指定编译内核的源代码仓库。可选择 github.com 的内核源代码仓库。例如 -r unifreq 等。可设置参数格式为 owner/repo@branch 三项组合，参数中的所有者名称 owner 为必选参数，内核源代码仓库名称 /repo 和 仓库的分支名称 @branch 为可选参数。当仅指定所有者名称 owner 参数时，将自动匹配所有者的名称为 linux-5.x.y 格式且分支为 main 的内核源代码仓库。如果仓库名称或分支名称不同，请使用组合方式指定，如 owner@branch 或 owner/repo 或 owner/repo@branch。默认值：unifreq
-k Kernel 指定 kernel 名称，如 -k 5.15.100 . 多个内核使用 _ 进行连接，如 -k 5.15.100_5.15.50
-a AutoKernel 设置是否自动采用同系列最新版本内核。当为 true 时，将自动查找在 -k 中指定的内核如 5.15.100 的同系列是否有更新的版本，如有 5.15.100 之后的最新版本时，将自动更换为最新版。设置为 false 时将编译指定版本内核。默认值：true
-m MakePackage 设置制作内核的包列表。当设置为 all ，将制作 Image, modules, dtbs 的全部文件。当设置值为 dtbs 时仅制作 3 个 dtbs 文件。默认值：all
-p AutoPatch 设置是否使用自定义内核补丁。当设置为 true 时将使用 tools/patch 目录下的内核补丁，详细说明参考内核补丁添加方法。默认值：false
-n CustomName 设置内核自定义签名。当设置为 -ophub ，生成的内核名称为 5.15.100-ophub 。设置自定义签名时请勿包含空格。默认值：-ophub
-t Toolchain 设置编译内核的工具链。可选项：clang / gcc / gcc-<version>。默认值：gcc
-c Compress 设置内核中 initrd 使用的压缩格式。可选项：xz / gzip / zstd / lzma。默认值：xz
  • sudo ./recompile : 使用默认配置编译内核。
  • sudo ./recompile -k 5.15.100 : 使用默认配置，并通过 -k 进行指定需要编译的内核版本，多个版本同时编译时使用 _ 进行连接。
  • sudo ./recompile -k 5.15.100 -a true : 使用默认配置，并通过 -a 参数设置编译内核时，是否自动升级到同系列最新内核。
  • sudo ./recompile -k 5.15.100 -n -ophub : 使用默认配置，并通过 -n 参数设置内核自定义签名。
  • sudo ./recompile -k 5.15.100 -m dtbs : 使用默认配置，并通过 -m 参数指定仅制作 dtbs 文件。
  • sudo ./recompile -k 5.15.100_6.1.10 -a true -n -ophub : 使用默认配置，并通过多个参数进行设置。

💡提示：推荐使用 unifreq 的 linux-6.1.y, linux-5.15.y, linux-5.10.y 和 linux-5.4.y 等仓库的内核源代码进行编译，他针对相关盒子添加了驱动和补丁。推荐使用 tools/config 中的模板，已经根据相关盒子进行了预配置，可以在此基础上进行个性化定制。

使用 GitHub Actions 编译内核

  1. 在 Action 页面里选择 Compile the kernel ，点击 Run workflow 按钮即可编译。

  2. 详见使用模板 compile-kernel.yml 。代码如下:

- name: Compile the kernel
  uses: ophub/amlogic-s9xxx-armbian@main
  with:
    build_target: kernel
    kernel_version: 6.1.y_5.15.y
    kernel_auto: true
    kernel_sign: -yourname

💡注意: 如果你 fork 仓库并进行了修改，使用时须将 Actions 的 用户名 改成你自己的仓库，例如：

uses: YOUR-REPO/amlogic-s9xxx-armbian@main

  • GitHub Action 输入参数说明

相关参数与本地编译命令相对应，请参考上面的说明。

参数 默认值 说明
build_target kernel 固定参数 kernel，设置编译目标为内核。
kernel_source unifreq 指定编译内核的源代码仓库。默认值为 unifreq 。功能参考 -r
kernel_version 6.1.y_5.15.y 指定 kernel 名称，如 5.15.100。功能参考 -k
kernel_auto true 设置是否自动采用同系列最新版本内核。默认值为 true。功能参考 -a
kernel_package all 设置制作内核的包列表。默认值为 all。功能参考 -m
kernel_sign -ophub 设置内核自定义签名。默认值为 -ophub。功能参考 -n
kernel_toolchain gcc 设置编译内核的工具链。默认值为 gcc。功能参考 -t
kernel_config false 默认使用 tools/config 目录下的配置模板。你可以设置编译内核的配置文件在你仓库中的存放目录，如 kernel/config_path 。该目录下存储的配置模板必须以内核的主版本命名，如config-5.10、config-5.15等。
kernel_patch false 设置自定义内核补丁目录。
auto_patch false 设置是否使用自定义内核补丁。默认值为 false。功能参考 -p
compress_format xz 设置内核中 initrd 使用的压缩格式。默认值为 xz。功能参考 -c

  • GitHub Action 输出变量说明

上传到 Releases 需要给仓库设置 Workflow 读写权限，详见使用说明。

参数 默认值 说明
${{ env.PACKAGED_OUTPUTTAGS }} 6.1.y_5.15.y 编译好的内核的名称
${{ env.PACKAGED_OUTPUTPATH }} compile-kernel/output 编译完成的内核所在文件夹的路径
${{ env.PACKAGED_OUTPUTDATE }} 04.13.1058 编译日期（月.日.时分）
${{ env.PACKAGED_STATUS }} success 编译状态：success / failure

内核使用说明

此内核可用于 Armbian 和 OpenWrt 系统。以 ophub 的项目进行举例说明。

在 Armbian 系统中使用

下面分别对在编译 Armbian 固件时集成，以及如何安装到已有的系统中使用进行说明。

  • 使用内核编译 Armbian 固件

编译 Armbian 固件支持本地化操作，也支持使用 github.com 的 Actions 在线编译。其中本地化编译时的使用方法详见：本地化打包, 使用 Actions 在线编译的方法详见：使用 GitHub Actions 进行编译

  • 将内核安装到已有的 Armbian 系统

可以使用 armbian-update 命令将编译好的内核安装到已有的 Armbian 系统中，具体操作方法详见：更新 Armbian 内核

  • 自定义编译驱动模块

在 linux 主线内核里，有些驱动尚未支持，可以自定义编译驱动模块。具体操作方法详见：编译驱动模块

在 OpenWrt 系统中使用

下面分别对在 OpenWrt 系统中编译固件时集成和安装到已有的系统中使用进行介绍。

  • 使用内核编译 OpenWrt 固件

编译 OpenWrt 固件支持本地化操作，也支持使用 github.com 的 Actions 在线编译。其中本地化编译时的使用方法详见：本地化打包, 使用 Actions 在线编译的方法详见：使用 Github Actions 进行编译

  • 将内核安装到已有的 OpenWrt 系统

可以使用 luci-app-amlogic 插件将编译好的内核安装到已有的 OpenWrt 系统中，具体操作方法详见：升级 OpenWrt