2022年11月10日星期四

Armbian for Amlogic TV Boxes

Armbian 

Armbian(中文名:岸边) 系统是基于 Debian/Ubuntu 而构建的专门用于 ARM 芯片的轻量级 Linux 系统。Armbian 系统精益、干净,并且 100% 兼容并继承了 Debian/Ubuntu 系统的功能和丰富的软件生态,可以安全稳定地运行在 TF/SD/USB 及设备的 eMMC 里。

现在你可以将电视盒子的安卓 TV 系统更换为 Armbian 系统,让他成为一台功能强大的服务器。本项目为 AmlogicRockchip 和 Allwinner 盒子构建 Armbian 系统。支持写入 eMMC 中使用,支持更新内核等功能。使用方法详见Armbian 使用文档

最新的 Armbian 固件可以在 Releases 中下载。欢迎 Fork 并进行个性化定制。如果对你有用,可以点仓库右上角的 Star 表示支持。

Armbian 固件说明

芯片设备可选内核Armbian 固件
a311dKhadas-VIM3全部aml_a311d.img
s922xBeelink-GT-KingBeelink-GT-King-ProUgoos-AM6-PlusODROID-N2X88-King全部aml_s922x.img
s905x3X96-Max+HK1-BoxVontar-X3H96-Max-X3Ugoos-X3TX3(QZ)TX3(BZ)X96-AirX96-Max+_A100A95XF3-AirTencent-Aurora-3Pro(s905x3-b)X96-Max+Q1X96-Max+100W全部aml_s905x3.img
s905x2X96Max-4GX96Max-2GMECOOL-KM3-4GTanix-Tx5-MaxA95X-F2全部aml_s905x2.img
s912Tanix-TX8-MaxTanix-TX9-Pro(3G)Tanix-TX9-Pro(2G)Tanix-TX92Nexbox-A1Nexbox-A95X-A2A95XH96-Pro-PlusVORKE-Z6-PlusMecool-M8S-PRO-LVontar-X92T95Z-PlusOctopus-PlanetPhicomm-T1全部aml_s912.img
s905dMECOOL-KI-ProPhicomm-N1全部aml_s905d.img
s905xHG680PB860HTBee-BoxT95TX9Q96-mini(s905l-b)全部aml_s905x.img
s905wX96-MiniTX3-MiniW95X96W/FunTV全部aml_s905w.img
s905Beelink-Mini-MX-2GSunvell-T95MMXQ-Pro+4K全部aml_s905.img
s905l3aE900V22C/DCM311-1a-YSTM401AM411AUNT403AUNT413AZTE-B863AV3.2-M全部aml_s905l3a.img
s905lb/3bM302A/M304AE900V22EBesTV-R3300L(s905l-b)全部aml_s905l2.img
aml_s905lb-r3300l.img
s905l2/3MGV2000MGV3000Wojia-TV-IPBS9505CM311-1(s905l3)HG680-LC(s905l3)全部aml_s905l2.img
rk3588Radxa-Rock5BHinLink-H88Krk3588rockchip_boxname.img
rk3568FastRhino-R66SFastRhino-R68SHinLink-H66KHinLink-H68K6.x.yrockchip_boxname.img
rk3399EAIDK-610KING3399TN33996.x.yrockchip_boxname.img
rk3328beikeyunl1pro全部rockchip_boxname.img
allwinnervplus(h6)全部allwinner_boxname.img

💡提示:当前 s905 的盒子只能在 TF/SD/USB 中使用,其他型号的盒子同时支持写入 EMMC 中使用。更多信息请查阅支持的设备列表说明

安装及升级 Armbian 的相关说明

选择和你的盒子型号对应的 Armbian 固件,使用 Rufus 或者 balenaEtcher 等工具将固件写入 USB 里,然后把写好固件的 USB 插入盒子。

安装 Armbian 到 EMMC

  1. Rockchip 平台的安装方法请查看说明文档中的 8.2章节

  2. Amlogic 和 Allwinner 平台,登录 Armbian 系统 (默认用户: root, 默认密码: 1234) → 输入命令:

armbian-install
可选参数默认值选项说明
-mnoyes/no使用 Mainline u-boot
-ayesyes/no使用 ampart 分区表调整工具
-lnoyes/noList. 显示全部设备列表

举例: armbian-install -m yes -a no

更新 Armbian 内核

登录 Armbian 系统 → 输入命令:

# 使用 root 用户运行 (sudo -i)
# 如果不指定参数,将更新为最新版本。
armbian-update
可选参数默认值选项说明
-k最新版内核名称设置更新内核名称
-vstablestable/rk3588/dev指定内核版本分支
-mnoyes/no使用主线 u-boot
-byesyes/no更新内核时自动备份当前系统使用的内核
-r""""[救援] 使用 USB 中的系统内核更新 eMMC

举例: armbian-update -k 5.15.50 -v dev -m yes

如果当前目录下有成套的内核文件,将使用当前目录的内核进行更新(更新需要的 4 个内核文件是 header-xxx.tar.gzboot-xxx.tar.gzdtb-xxx.tar.gzmodules-xxx.tar.gz。其他内核文件不需要,如果同时存在也不影响更新,系统可以准确识别需要的内核文件)。如果当前目录没有内核文件,将从服务器查询并下载同系列的最新内核进行更新。在设备支持的可选内核里可以自由更新,如从 5.10.125 内核更新为 5.15.50 内核。

更新内核时会自动备份当前系统使用的内核,存储路径在 /ddbr/backup 目录里,如果不需要可以删除。

💡 因特殊原因导致的更新不完整等问题,造成系统无法从 eMMC 启动时,可以从 USB 中启动任意内核版本的 Armbian 系统,运行 armbian-update -r 命令可以把 USB 中的系统内核更新至 eMMC 中,实现救援的目的。

安装常用软件

登录 Armbian 系统 → 输入命令:

armbian-software

使用 armbian-software -u 命令可以更新本地的软件中心列表。根据用户在 Issue 中的需求反馈,逐步整合常用软件,实现一键安装/更新/卸载等快捷操作。包括 docker 镜像桌面软件应用服务 等。详见更多说明

修改 Armbian 配置

登录 Armbian 系统 → 输入命令:

armbian-config

为 Armbian 创建 swap

如果你在使用 docker 等内存占用较大的应用时,觉得当前盒子的内存不够使用,可以创建 swap 虚拟内存分区,将磁盘空间的一定容量虚拟成内存来使用。下面命令输入参数的单位是 GB,默认为 1

登录 Armbian 系统 → 输入命令:

armbian-swap 1

控制 LED 显示

登录 Armbian 系统 → 输入命令:

armbian-led

根据 LED 屏显示控制说明 进行调试。

在 TF/SD/USB 中使用 Armbian

激活 TF/SD/USB 的剩余空间,请登录 Armbian 系统 → 输入命令:

armbian-tf

根据提示输入 e 将剩余空间扩容至当前系统分区和文件系统,输入 c 将创建新的第 3 分区。

或者手动分配剩余空间

备份/还原 EMMC 原系统

支持在 TF/SD/USB 中对盒子的 EMMC 分区进行备份/恢复。建议您在全新的盒子里安装 Armbian 系统前,先对当前盒子自带的安卓 TV 系统进行备份,以便日后在恢复电视系统等情况下使用。

请从 TF/SD/USB 启动 Armbian 系统 → 输入命令:

armbian-ddbr

根据提示输入 b 进行系统备份,输入 r 进行系统恢复。

在 Armbian 中编译内核

在 Armbian 中编译内核的用法详见 编译内核 说明文档。登录 Armbian 系统 → 输入命令:

armbian-kernel -u
armbian-kernel -k 5.10.125

更多使用说明

将本地系统中的全部服务脚本更新到最新版本,可以登录 Armbian 系统 → 输入命令:

armbian-sync

在 Armbian 的使用中,一些可能遇到的常见问题详见 documents

本地化打包

  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 根目录,在根目录下创建文件夹 build/output/images ,并上传 Armbian 镜像文件 ( 如:Armbian_21.11.0-trunk_Odroidn2_current_5.15.50.img ) 到 ~/amlogic-s9xxx-armbian/build/output/images 目录里。原版 Armbian 镜像文件名称中的发行版本号(如:21.11.0)和内核版本号(如:5.15.50)请保留,它将在重构后用作 Armbian 固件的名称。

  2. 进入 ~/amlogic-s9xxx-armbian 根目录,然后运行 sudo ./rebuild -b s905x3 -k 5.10.125 命令即可生成指定 board 的 Armbian 镜像文件。生成的文件保存在 build/output/images 目录里。

本地化打包参数说明

参数含义说明
-bBoard指定电视盒子型号,如 -b s905x3 . 多个型号使用 _ 进行连接,如 -b s905x3_s905d . 使用 all 表示全部型号。型号代码详见 model_database.conf 中的 BOARD 设置。
-kKernel指定 kernel 名称,如 -k 5.10.125 . 多个内核使用 _ 进行连接,如 -k 5.10.125_5.15.50
-aAutoKernel设置是否自动采用同系列最新版本内核。当为 true 时,将自动在内核库中查找在 -k 中指定的内核如 5.10.125 的同系列是否有更新的版本,如有 5.10.125 之后的最新版本时,将自动更换为最新版。设置为 false 时将编译指定版本内核。默认值:true
-vVersion指定内核 版本分支 名称,如 -v stable_rk3588 。指定的名称须与分支目录名称相同。默认使用 stable_rk3588 分支版本。
-rKernelRepository指定内核仓库地址,如 -r https://github.com/ophub/kernel/tree/main/pub 。默认使用 ophub/kernel 的内核仓库。
-sSize对固件的 ROOTFS 分区大小进行设置,默认大小为 2560MiB, 固件大小必须大于 2048MiB. 例如: -s 2560
-tRootfsType对固件的 ROOTFS 分区的文件系统类型进行设置,默认为 ext4 类型,可选项为 ext4 或 btrfs 类型。例如: -t btrfs
-nCustomName设置固件名称中的签名部分。默认值为空。可根据需要添加签名如 _server_gnome_desktop 或 _ophub 等,设置自定义签名时请勿包含空格。
-gGH_TOKEN可选项。设置 ${{ secrets.GH_TOKEN }},用于 api.github.com 查询。默认值:无
  • sudo ./rebuild : 使用默认配置,对全部型号的电视盒子进行打包。
  • sudo ./rebuild -b s905x3 -k 5.10.125 : 推荐使用. 使用默认配置进行相关内核打包。
  • sudo ./rebuild -b s905x3_s905d -k 5.10.125_5.15.50 : 使用默认配置,进行多个内核同时打包。使用 _ 进行多内核参数连接。
  • sudo ./rebuild -b s905x3 -k 5.10.125 -s 2560 : 使用默认配置,指定一个内核,一个型号进行打包,固件大小设定为2560MiB。
  • sudo ./rebuild -b s905x3 -v dev -k 5.10.125 : 使用默认配置,指定型号,指定版本分支,指定内核进行打包。
  • sudo ./rebuild -b s905x3_s905d 使用默认配置,对多个型号的电视盒子进行全部内核打包, 使用 _ 进行多型号连接。
  • sudo ./rebuild -k 5.10.125_5.15.50 : 使用默认配置,指定多个内核,进行全部型号电视盒子进行打包, 内核包使用 _ 进行连接。
  • sudo ./rebuild -k 5.10.125_5.15.50 -a true : 使用默认配置,指定多个内核,进行全部型号电视盒子进行打包, 内核包使用 _ 进行连接。自动升级到同系列最新内核。
  • sudo ./rebuild -t btrfs -s 2560 -k 5.10.125 : 使用默认配置,设置文件系统为 btrfs 格式,分区大小为 2560MiB, 并指定内核为 5.10.125 ,对全部型号电视盒子进行打包。

使用 GitHub Actions 进行编译

  1. 关于 Workflows 文件的配置在 build-armbian.yml 文件里。

  2. 全新编译:在 Actions 页面里选择 Build armbian ,根据 Armbian 官方支持的 OS 版本,可以选择 Ubuntu 系列:jammy,或者 Debian 系列:bullseye 等。点击 Run workflow 按钮即可编译。更多参数的设置方法可以在 Armbian 官方文档 里查阅。

  3. 再次编译:如果 Releases 中有已经编译好的 Armbian_.*-trunk_.*.img.gz 文件,你只是想再次制作其他不同 board 的盒子,可以跳过 Armbian 源文件的编译,直接进行二次制作。在 Actions 页面中选择 Use Releases file to build armbian ,点击 Run workflow 按钮即可二次编译。

  4. 使用其他 Armbian 固件,如 Armbian 官方固件下载网站 armbian.tnahosting.net 提供的 odroidn2 固件,仅在流程控制文件 rebuild-armbian.yml 中引入本仓库的脚本进行 Armbian 重构,即可适配其他盒子的使用。在 Actions 页面里选择 Rebuild armbian ,输入 Armbian 的网络下载地址如 https://dl.armbian.com/*/Armbian_*.img.xz ,或者在流程控制文件 rebuild-armbian.yml 中通过 armbian_path 参数设定重构文件的加载路径。代码如下:

- name: Rebuild Armbian
  uses: ophub/amlogic-s9xxx-armbian@main
  with:
    build_target: armbian
    armbian_path: build/output/images/*.img
    armbian_board: s905d_s905x3_s922x_s905x
    armbian_kernel: 5.10.125_5.15.50
    gh_token: ${{ secrets.GH_TOKEN }}

GitHub Actions 输入参数说明

关于 GitHUB RELEASES_TOKEN 的相关设置可参考:RELEASES_TOKEN。相关参数与本地打包命令相对应,请参考上面的说明。

参数默认值说明
armbian_path设置原版 Armbian 文件的路径,支持使用当前工作流中的文件路径如 build/output/images/*.img ,也支持使用网络下载地址如: https://dl.armbian.com/*/Armbian_*.img.xz
armbian_boards905d_s905x3设置打包盒子的 board ,功能参考 -b
armbian_kernel5.10.125_5.15.50设置内核 版本,功能参考 -k
auto_kerneltrue设置是否自动采用同系列最新版本内核,功能参考 -a
version_branchstable_rk3588指定内核 版本分支 名称,功能参考 -v
kernel_repoophub/kernel指定内核仓库地址,功能参考 -r
armbian_size2560设置固件 ROOTFS 分区的大小,功能参考 -s
armbian_fstypeext4设置固件 ROOTFS 分区的文件系统类型,功能参考 -t
armbian_sign设置固件名称中的签名部分,功能参考 -n
gh_token可选项。设置 ${{ secrets.GH_TOKEN }}。功能参考 -g

GitHub Actions 输出变量说明

上传到 Releases 需要给仓库添加 ${{ secrets.GITHUB_TOKEN }} 和 ${{ secrets.GH_TOKEN }} 并设置 Workflow 读写权限,详见使用说明

参数默认值说明
${{ env.PACKAGED_OUTPUTPATH }}out打包后的固件所在文件夹的路径
${{ env.PACKAGED_OUTPUTDATE }}04.13.1058打包日期(月.日.时分)
${{ env.PACKAGED_STATUS }}success打包状态:success / failure

Armbian 固件默认信息

名称
默认 IP从路由器获取 IP
默认账号root
默认密码1234

挂载EMMC:

示例:
mkdir -p /mnt/emmc/boot
mkdir -p /mnt/emmc/system
mount /dev/mmcblk2p1 /mnt/emmc/boot
mount /dev/mmcblk2p2 /mnt/emmc/system

修改/boot/uEnv.txt文件:
FDT=/dtb/amlogic/meson-g12a-x96-max.dtb

挂载img镜像:
losetup -f -P --show os.img
mount /dev/loop0p1 /mnt/emmc/boot
mount /dev/loop0p2 /mnt/emmc/system

挂载网络硬盘:
apt install cifs-utils
apt install smbclient

mount -t cifs -o username=admin,password=1234,gid=0,uid=0, //192.168.1.52/Data /mnt/SMB