查看英文说明 | View English description
Github Actions 是 Microsoft 推出的一项服务，它提供了性能配置非常不错的虚拟服务器环境，基于它可以进行构建、测试、打包、部署项目。对于公开仓库可免费无时间限制地使用，且单次编译时间长达 6 个小时，这对于编译 Armbian 来说是够用的（我们一般在3小时左右可以完成一次编译工作）。分享只是为了交流经验，不足的地方请大家理解，请不要在网络上发起各种不好的攻击行为，也不要恶意使用 GitHub Actions。
- Armbian 构建及使用方法
- 目录
- 1. 注册自己的 Github 的账户
- 2. 设置隐私变量 GITHUB_TOKEN
- 3. Fork 仓库并设置 GH_TOKEN
- 4. 个性化 Armbian 固件定制文件说明
- 5. 编译固件
- 6. 保存固件
- 7. 下载固件
- 8. 安装 Armbian 到 EMMC
- 9. 编译 Armbian 内核
- 10. 更新 Armbian 内核
- 11. 安装常用软件
- 12. 常见问题
- 12.1 每个盒子的 dtb 和 u-boot 对应关系表
- 12.2 LED 屏显示控制说明
- 12.3 如何恢复原安卓 TV 系统
- 12.4 设置盒子从 USB/TF/SD 中启动
- 12.5 禁用红外接收器
- 12.6 启动引导文件的选择
- 12.7 网络设置
- 12.8 如何添加开机启动任务
- 12.9 如何更新系统中的服务脚本
- 12.10 如何获取 eMMC 上的安卓系统分区信息
- 12.11 如何制作 u-boot 文件
- 12.12 内存大小识别错误
- 12.13 如何反编译 dtb 文件
- 12.14 如何修改 cmdline 设置
- 12.15 如何添加新的支持设备
- 12.16 如何解决写入 eMMC 时 I/O 错误的问题
注册自己的账户，以便进行固件个性化定制的继续操作。点击 github.com 网站右上角的 Sign up 按钮，根据提示注册自己的账户。
设置 Github 隐私变量 GITHUB_TOKEN 。在固件编译完成后，我们需要上传固件到 Releases ，我们根据 Github 官方的要求设置这个变量，方法如下：
Personal center: Settings > Developer settings > Personal access tokens > Generate new token ( Name: GITHUB_TOKEN, Select: public_repo )。其他选项根据自己需要可以多选。提交保存，复制系统生成的加密 KEY 的值，先保存到自己电脑的记事本，下一步会用到这个值。图示如下：
现在可以 Fork 仓库了，打开仓库 https://github.com/ophub/amlogic-s9xxx-armbian ，点击右上的 Fork 按钮，复制一份仓库代码到自己的账户下，稍等几秒钟，提示 Fork 完成后，到自己的账户下访问自己仓库里的 amlogic-s9xxx-armbian 。在右上角的 Settings > Secrets > Actions > New repostiory secret ( Name: GH_TOKEN, Value: 填写刚才GITHUB_TOKEN的值 )，保存。并在左侧导航栏的 Actions > General > Workflow permissions 下选择 Read and write permissions 并保存。图示如下：
固件编译的流程在 .github/workflows/build-armbian.yml 文件里控制，在 workflows 目录下还有其他 .yml 文件，实现其他不同的功能。编译固件时采用了 Armbian 官方的当前代码进行实时编译，相关参数可以查阅官方文档。
- name: Compile Armbian [ ${{ env.ARMBIAN_BOARD }} ]
id: compile
run: |
cd build/
sudo ./compile.sh RELEASE=${{ env.ARMBIAN_RELEASE }} BOARD=odroidn2 BRANCH=current BUILD_ONLY=default HOST=armbian EXPERT=yes \
BUILD_DESKTOP=no BUILD_MINIMAL=no KERNEL_CONFIGURE=no CLEAN_LEVEL="make,debs" COMPRESS_OUTPUTIMAGE="sha"
echo "build_tag=Armbian_${{ env.ARMBIAN_RELEASE }}_$(date +"%m.%d.%H%M")" >> ${GITHUB_OUTPUT}
echo "status=success" >> ${GITHUB_OUTPUT}固件编译的方式很多，可以设置定时编译，手动编译，或者设置一些特定事件来触发编译。我们先从简单的操作开始。
在自己仓库的导航栏中，点击 Actions 按钮，再依次点击 Build armbian > Run workflow > Run workflow ，开始编译，等待大约 3 个小时，全部流程都结束后就完成编译了。图示如下：
在 .github/workflows/build-armbian.yml 文件里，使用 Cron 设置定时编译，5 个不同位置分别代表的意思为 分钟 (0 - 59) / 小时 (0 - 23) / 日期 (1 - 31) / 月份 (1 - 12) / 星期几 (0 - 6)(星期日 - 星期六)。通过修改不同位置的数值来设定时间。系统默认使用 UTC 标准时间，请根据你所在国家时区的不同进行换算。
schedule:
- cron: '0 17 * * *'默认固件的配置信息记录在 model_database.conf 文件里，将需要编译固件的 BUILD 值设置为 yes，其中的 BOARD 名字要求唯一。
在本地编译时通过 -b 参数指定，在 github.com 的 Actions 里编译时通过 armbian_board 参数指定。
一般情况下只需要编译具有通用性的固件即可，同家族的其他盒子可以参考配置文件信息表，通过修改 /boot/uEnv.txt 中的 dtb 值进行使用。
固件保存的设置也在 .github/workflows/build-armbian.yml 文件里控制。我们将编译好的固件通过脚本自动上传到 github 官方提供的 Releases 里面。
- name: Upload Armbian image to Release
uses: ncipollo/release-action@main
if: ${{ env.PACKAGED_STATUS }} == 'success' && !cancelled()
with:
tag: Armbian_${{ env.ARMBIAN_RELEASE }}_${{ env.PACKAGED_OUTPUTDATE }}
artifacts: ${{ env.PACKAGED_OUTPUTPATH }}/*
allowUpdates: true
token: ${{ secrets.GH_TOKEN }}
body: |
These are the Armbian OS image
* OS information
Default username: root
Default password: 1234
Install command: armbian-install
Update command: armbian-update从仓库首页右下角的 Release 版块进入，选择和自己盒子型号对应的固件。图示如下：
Amlogic 和 Rockchip 的安装方法不同。不同的设备具有不同的存储，有的设备使用外置 microSD 卡，有的带有 eMMC，有的支持使用 NVMe 等多种存储介质，根据设备不同，分别介绍其安装方法。首先在 Releases 里下载自己设备的 Armbian 系统，解压缩成 .img 格式备用。根据自己的设备，使用下面小结中不同的安装方法。
当安装完成后，将 Armbian 设备接入路由器，设备开机2分钟后，到路由器里查看设备名称为 Armbian 的 IP，使用 SSH 工具连接进行管理设置。默认用户名为 root，默认密码为 1234，默认端口为 22
登录 Armbian 系统 (默认用户: root, 默认密码: 1234) → 输入命令：
armbian-install| 可选参数 | 默认值 | 选项 | 说明 |
|---|---|---|---|
| -m | no | yes/no | 使用 Mainline u-boot |
| -a | yes | yes/no | 使用 ampart 分区表调整工具 |
| -l | no | yes/no | List. 显示全部设备列表 |
举例: armbian-install -m yes -a no
每个设备的安装方法不同，分别介绍如下。
Radxa-Rock5B 有 microSD/eMMC/NVMe 等多种存储介质可以选择，相应的安装方法也不同。下载 rk3588_spl_loader_v1.08.111.bin 和 spi_image.img 文件备用。下载 RKDevTool 工具及驱动备用。下载 Rufus 或者 balenaEtcher 写盘工具备用。
使用 Rufus 或者 balenaEtcher 等工具将 Armbian 系统镜像写入 microSD 里，然后把写好固件的 microSD 插入设备即可使用。
- 使用 USB 转 eMMC 读卡器安装：将 eMMC 模块与电脑连接，使用 Rufus 或者 balenaEtcher 等工具将 Armbian 系统镜像写入 eMMC 里，然后把写好固件的 eMMC 插入设备即可使用。
- 使用 Maskrom 模式安装：关闭开发板电源。按住金色按钮。将 USB-A 转 C 型电缆插入 ROCK 5B C 型端口，另一端插入 PC。松开金色按钮。检查 USB 设备提示找到一个 MASKROM 设备。右键单击列表的空白区域，然后选择加载
rock-5b-emmc.cfg配置文件（配置文件和 RKDevTool 在同一个目录下）。将rk3588_spl_loader_v1.08.111.bin和Armbian.img按下图所示设置，选择写入即可。
ROCK-5B 在主板上有一个 SPI 闪存，将引导加载程序安装到 SPI 闪存可以支持 SoC maskrom 模式不直接支持的其他启动介质（如 SATA、USB3 或 NVMe）。使用 NVMe 需要先写入 SPI 文件。方法如下：
关闭开发板电源。删除可启动设备，如MicroSD卡，eMMC模块等。按住金色（或某些开发板修订版上的银色）按钮。将 USB-A 转 C 型电缆插入 ROCK-5B C 型端口，另一端插入 PC。松开金色按钮。检查 USB 设备找到一个 MASKROM 设备。在列表框中右键选择加载配置，然后在资源管理文件夹中选择配置文件（配置文件和 RKDevTool 在同一个目录下），根据下图选择 rk3588_spl_loader_v1.08.111.bin 和 spi_image.img 文件，点击写入即可，如下图所示：
- 使用读卡器安装：将 M.2 NVMe SSD 插入 M.2 NVMe SSD 到 USB3.0 读卡器，以连接到主机。使用 Rufus 或者 balenaEtcher 等工具将 Armbian 系统镜像写入 NVMe 里，然后把写好固件的 NVMe 插入设备即可使用。
- 使用 microSD 卡安装：将 Armbian 系统镜像写入 microSD 卡，将 microSD 卡插入设备并启动，上传
Armbian.img镜像文件到 microSD 卡，使用dd命令将 Armbian 镜像写入 NVMe 中，命令如下：
dd if=armbian.img of=/dev/nvme0n1 bs=1M status=progress使用 Rufus 或者 balenaEtcher 等工具将 Armbian 系统镜像写入 microSD 里，然后把写好固件的 microSD 插入设备即可使用。
- 下载 RKDevTool 工具及驱动，解压并安装 DriverAssitant 驱动程序，打开 RKDevTool 工具备用。
- R68s 在关机状态下，先插入 USB 双公头线，然后按住 Recovery 键并插上 12V 电源，两秒之后松开 Recovery 键，刷机工具会
发现一个 LOADER 设备。 - 在 RKDevTool 工具操作界面的空白处点右键，添加项。
- 地址是
0x00000000，名字是armbian，路径点击右侧选择armbian.img系统文件。 - 选择添加的 armbian 一行外，
取消其他行的选择，点击执行写入即可。 - 补充说明：如果 eMMC 中写入了其他系统，请先在高级功能里擦除，再写入 Armbian 系统。如果无法擦除，先重新写入一次
MiniLoaderAll.bin引导文件，然后再次进入MASKROM写入 Armbian 系统。MiniLoaderAll.bin 引导文件设置：地址0xCCCCCCCC, 名字Loader, 路径选择 RKDevTool 刷机工具 Image 目录下的MiniLoaderAll.bin文件。
方法转载自 milton 的教程。刷机需要进入 Maskrom 模式。先断开所有连接，通过短接 CLK 和 GND（使用 TTL 的 GND, 或者旁边小按钮的 GND 均可）这两个触点，然后将 USB 连接到 PC 就会检测到 MASKROM 设备了。短接点位置如下：
打开 RKDevTool 刷机工具，右键添加项。
- 地址
0xCCCCCCCC, 名字Boot, 路径选择rk3328_loader_v1.14.249.bin。 - 地址
0x00000000, 名字system, 路径选择要刷的Armbian.img固件。
点击执行写入即可。
方法转载自 cc747 的教程。刷机需要进入 Maskrom 模式。使我家云处于断电状态，拔掉所有线。用 USB 双公头线，一头插入我家云的 USB2.0 接口，一头插入电脑。用回形针插进 Reset 孔，并按压住不松开。插入电源线。等待几秒钟，直到 RKDevTool 框的下方出现发现一个LOADER设备后才松开回形针。将 RKDevTool 切换到高级功能点击进入Maskrom按钮，提示发现一个MASKROM设备。右键添加项。
- 地址
0xCCCCCCCC, 名字Boot, 路径选择rk3328_loader.bin。 - 地址
0x00000000, 名字system, 路径选择要刷的Armbian.img固件。
点击执行写入即可。
支持在 Ubuntu20.04/22.04 或 Armbian 系统中编译内核。支持本地编译，也支持使用 GitHub Actions 云编译，具体方法详见 内核编译说明。
登录 Armbian 系统 → 输入命令：
# 使用 root 用户运行 (sudo -i)
# 如果不指定其他参数，以下更新命令将更新到当前同系列内核的最新版本。
armbian-update| 可选参数 | 默认值 | 选项 | 说明 |
|---|---|---|---|
| -k | auto latest | 内核名称 | 设置更新内核名称 |
| -v | stable | stable/dev | 指定内核版本分支 |
| -m | no | yes/no | 使用主线 u-boot |
举例: armbian-update -k 5.15.50 -v dev -m yes
如果当前目录下有成套的内核文件，将使用当前目录的内核进行更新（更新需要的 4 个内核文件是 header-xxx.tar.gz, boot-xxx.tar.gz, dtb-amlogic-xxx.tar.gz, modules-xxx.tar.gz。其他内核文件不需要，如果同时存在也不影响更新，系统可以准确识别需要的内核文件）。如果当前目录没有内核文件，将从服务器查询并下载同系列的最新内核进行更新。在设备支持的可选内核里可以自由更新，如从 5.10.125 内核更新为 5.15.50 内核。
登录 Armbian 系统 → 输入命令：
armbian-software使用 armbian-software -u 命令可以更新本地的软件中心列表。根据用户在 Issue 中的需求反馈，逐步整合常用软件，实现一键安装/更新/卸载等快捷操作。包括 docker 镜像、桌面软件、应用服务 等。详见更多说明。
在 Armbian 的使用中，一些可能遇到的常见问题汇总如下。
请查阅说明
请查阅说明
通常使用 armbian-ddbr 备份恢复，或者使用 Amlogic 刷机工具恢复原安卓 TV 系统。
建议您在全新的盒子里安装 Armbian 系统前，先对当前盒子自带的原安卓 TV 系统进行备份，以便在需要恢复系统时使用。请从 TF/SD/USB 启动 Armbian 系统，输入 armbian-ddbr 命令，然后根据提示输入 b 进行系统备份，备份文件的存放路径为 /ddbr/BACKUP-arm-64-emmc.img.gz ，请下载保存。在需要恢复安卓 TV 系统时，将之前备份的文件上传至 TF/SD/USB 设备的相同路径下，输入 armbian-ddbr 命令，然后根据提示输入 r 进行系统恢复。
-
一般情况下，重新插入电源，如果可以从 USB 中启动，只要重新安装即可，多试几次。
-
如果接入显示器后，屏幕是黑屏状态，无法从 USB 启动，就需要进行盒子的短接初始化了。先将盒子恢复到原来的安卓系统，再重新刷入 Armbian 系统。首先下载 amlogic_usb_burning_tool 系统恢复工具并安装好。准备一条 USB 双公头数据线，准备一个 曲别针。
-
以 x96max+ 为例，在盒子的主板上确认 短接点 的位置，下载盒子的 Android TV 固件包。其他常见设备的安卓 TV 系统固件及对应的短接点示意图也可以在此下载查看。
操作方法：
1. 打开刷机软件 USB Burning Tool:
[ 文件 → 导入固件包 ]: X96Max_Plus2_20191213-1457_ATV9_davietPDA_v1.5.img
[ 选择 ]：擦除 flash
[ 选择 ]：擦除 bootloader
点击 [ 开始 ] 按钮
2. 使用 [ 曲别针 ] 将盒子主板上的 [ 两个短接点进行短接连接 ]，
并同时使用 [ USB 双公头数据线 ] 将 [ 盒子 ] 与 [ 电脑 ] 进行连接。
3. 当看到 [ 进度条开始走动 ] 后，拿走曲别针，不再短接。
4. 当看到 [ 进度条 100% ], 则刷机完成，盒子已经恢复成 Android TV 系统。
点击 [ 停止 ] 按钮, 拔掉 [ 盒子 ] 和 [ 电脑 ] 之间的 [ USB 双公头数据线] 。
5. 如果以上某个步骤失败，就再来一次，直至成功。
如果进度条没有走动，可以尝试插入电源。通长情况下不用电源支持供电，只 USB 双公头的供电即可满足刷机要求。
当完成恢复出厂设置，盒子已经恢复成 Android TV 系统，其他安装 Armbian 系统的操作，就和你之前第一次安装系统时的要求一样了，再来一遍即可。
- 把刷好固件的 USB/TF/SD 插入盒子。
- 开启开发者模式: 设置 → 关于本机 → 版本号 (如: X96max plus...), 在版本号上快速连击 5 次鼠标左键, 看到系统显示
开启开发者模式的提示。 - 开启 USB 调试模式: 系统 → 高级选选 → 开发者选项 (设置
开启USB调试为启用)。启用ADB调试。 - 安装 ADB 工具：下载 adb 并解压，将
adb.exe，AdbWinApi.dll，AdbWinUsbApi.dll三个文件拷⻉到c://windows/目录下的system32和syswow64两个文件夹内，然后打开cmd命令面板，使用adb --version命令，如果有显示就表示可以使用了。 - 进入
cmd命令模式。输入adb connect 192.168.1.137命令（其中的 ip 根据你的盒子修改，可以到盒子所接入的路由器设备里查看），如果链接成功会显示connected to 192.168.1.137:5555 - 输入
adb shell reboot update命令，盒子将重启并从你插入的 USB/TF/SD 启动，从浏览器访问固件的 IP 地址，或者 SSH 访问即可进入固件。
默认情况下启用对红外接收器的支持，但如果您将电视盒用作服务器，那么您可能希望禁用 IR 内核模块以防止错误地关闭您的盒子。 要完全禁用 IR，请添加以下行：
blacklist meson_ir至 /etc/modprobe.d/blacklist.conf 并重启。
-
目前已知的设备中，只有
T95(s905x)/T95Z-Plus(s912)/BesTV-R3300L(s905l-b)等少数设备需要使用/bootfs/extlinux/extlinux.conf文件，已经在固件里默认添加了。其他设备如果需要，可以将固件写入 USB 后，双击打开boot分区，将固件自带的/boot/extlinux/extlinux.conf.bak文件名称中的.bak删除即可使用。当写入 eMMC 时armbian-install会自动检查，如果存在extlinux.conf文件，会自动创建。 -
其他设备只需要
/boot/uEnv.txt即可启动，不要修改extlinux.conf.bak文件。
网络配置文件 /etc/network/interfaces 的内容如下：
source /etc/network/interfaces.d/*
# Network is managed by Network manager
# You can choose one of the following two IP setting methods:
# Use # to disable another setting method
# 01. Enable dynamic DHCP to assign IP
auto eth0
iface eth0 inet dhcp
hwaddress ether 12:34:56:78:9A:BC
# 02. Enable static IP settings(IP is modified according to the actual)
#auto eth0
#allow-hotplug eth0
#iface eth0 inet static
#address 192.168.1.100
#netmask 255.255.255.0
#gateway 192.168.1.6
#dns-nameservers 192.168.1.6
# 03. Docker install OpenWrt and communicate with each other
#allow-hotplug eth0
#no-auto-down eth0
#auto eth0
#iface eth0 inet manual
#
#auto macvlan
#iface macvlan inet dhcp
# hwaddress ether 12:34:56:78:9a:bc
# pre-up ip link add macvlan link eth0 type macvlan mode bridge
# post-down ip link del macvlan link eth0 type macvlan mode bridge
#
#auto lo
#iface lo inet loopback默认采用 DHCP 动态 分配 IP 的策略（方法1），由 Armbian 所接入的网络路由器自动分配 IP。如果想改为静态 IP，可以把设置方法 1 禁用或删除，启用方法 2 的静态 IP 设置。
source /etc/network/interfaces.d/*
auto eth0
iface eth0 inet dhcp其中的 IP 和网关和 DNS 根据自己的网络情况修改。
source /etc/network/interfaces.d/*
auto eth0
allow-hotplug eth0
iface eth0 inet static
address 192.168.1.100
netmask 255.255.255.0
gateway 192.168.1.1
dns-nameservers 192.168.1.1其中的 MAC 地址根据自己的需要修改。
source /etc/network/interfaces.d/*
allow-hotplug eth0
no-auto-down eth0
auto eth0
iface eth0 inet manual
auto macvlan
iface macvlan inet dhcp
pre-up ip link add macvlan link eth0 type macvlan mode bridge
post-down ip link del macvlan link eth0 type macvlan mode bridge
auto lo
iface lo inet loopback新建或修改网络连接前的准备工作
查看设备中有哪些网络接口可以用来建立网络连接。
nmcli device | grep -E "^[e].*|^[w].*|^[D].*|^[T].*" | awk '{printf "%-19s%-19s\n",$1,$2}'
执行命令后返回内容, DEVICE 列显示网络接口名称, TYPE 列显示网络接口类型。
其中 eth0 = 第1块有线网卡的名称, eth1 = 第2块有线网卡的名称, 以此类推, 无线网卡同理。
DEVICE TYPE
eth0 ethernet
eth1 ethernet
eth2 ethernet
eth3 ethernet
wlan0 wifi
wlan1 wifi
查看设备现有哪些网络连接, 包含使用中和未使用的连接。
*) 在新建网络连接时, 不建议使用已经存在的连接名称。
nmcli connection show | grep -E ".*|^[N].*" | awk '{printf "%-19s%-19s\n", $1,$3}'
执行命令后返回内容, NAME 列显示现有网络连接名称, TYPE 列显示网络接口类型。
其中 ethernet = 有线网卡, wifi = 无线网卡, bridge = 网桥
NAME TYPE
cnc ethernet
lan ethernet
lte ethernet
tel ethernet
docker0 bridge
titanium wifi
cpe wifi
在网络接口 eth0 上新建网络连接并立即生效 (动态 IP 地址 - IPv4 / IPv6)。
# Set ENV
MYCON=ether1 # 新建网络连接名称
MYETH=eth0 # 网络接口名称 = eth0 / eth1 / eht2 / eth3
IPV6AGM=stable-privacy # IPv6 地址状态模式 = stable-privacy / eui64
# Add ETH
nmcli connection add \
con-name $MYCON \
type ethernet \
ifname $MYETH \
autoconnect yes \
ipv6.addr-gen-mode $IPV6AGM
nmcli connection up $MYCON
ip -c -br address
在网络接口 eth0 上新建网络连接并立即生效 (静态 IP 地址 - IPv4)。
# Set ENV
MYCON=ether1 # 网络连接名称
MYETH=eth0 # 网络接口名称 = eth0 / eth1 / eht2 / eth3
IP=192.168.67.167/24 # HOST IP 地址, 其中 24 是子网掩码 对应 255.255.255.0
GW=192.168.67.1 # 网关
DNS=119.29.29.29,223.5.5.5 # DNS 服务器地址
# Chg CON
nmcli connection add \
con-name $MYCON \
type ethernet \
ifname $MYETH \
autoconnect yes \
ipv4.method manual \
ipv4.addresses $IP \
ipv4.gateway $GW \
ipv4.dns $DNS
nmcli connection up $MYCON
ip -c -br address
在网络接口 wlan0 上新建网络连接并立即生效 (动态 IP 地址 - IPv4 / IPv6)。
# Set ENV
MYCON=ssid # 新建网络连接名称, 建议使用 WiFi SSID 来指定连接名称
MYSSID=ssid # WiFi SSID 区分大小写
MYPSWD=passwd # WiFi 密码
MYWSKM=wpa-psk # 安全性选择 WPA-WPA2 = wpa-psk or WPA3 = sae （无线路由器或 AP 中查看是哪一种加密方式）
MYWLAN=wlan0 # 网络接口名称 = wlan0 / wlan1
IPV6AGM=stable-privacy # IPv6 地址状态模式 = stable-privacy / eui64
# Add WLAN
nmcli connection add \
con-name $MYCON \
type wifi \
ifname $MYWLAN \
autoconnect yes \
ipv6.addr-gen-mode $IPV6AGM \
wifi.ssid $MYSSID \
wifi-sec.key-mgmt $MYWSKM \
wifi-sec.psk $MYPSWD
nmcli connection up $MYCON
ip -c -br address
修改无线网络连接 ssid 中的 WiFi SSID or PASSWD 并立即生效。
# Set ENV
MYCON=ssid # 无线网络连接名称
MYSSID=ssid # WiFi SSID 区分大小写
MYPSWD=passwd # WiFi 密码
MYWSKM=wpa-psk # 安全性选择 WPA-WPA2 = wpa-psk or WPA3 = sae
# Add WLAN
nmcli connection modify $MYCON \
wifi.ssid $MYSSID \
wifi-sec.key-mgmt $MYWSKM \
wifi-sec.psk $MYPSWD
nmcli connection up $MYCON
ip -c -br address
在网络连接 ether1 上修改 IP 地址分配方式为 静态 IP 地址 并立即生效。
*适用 有线连接 / 无线连接
# Set ENV
MYCON=ether1 # 网络连接名称
IP=192.168.67.167/24 # HOST IP 地址, 其中 24 是子网掩码 对应 255.255.255.0
GW=192.168.67.1 # 网关
DNS=119.29.29.29,223.5.5.5 # DNS 服务器地址
# Chg CON
nmcli connection modify $MYCON \
ipv4.method manual \
ipv4.addresses $IP \
ipv4.gateway $GW \
ipv4.dns $DNS
nmcli connection up $MYCON
ip -c -br address
在网络连接 ether1 上修改 IP 地址分配方式为 DHCP 获取动态 IP 地址 并立即生效。
*适用 有线连接 / 无线连接
# Set ENV
MYCON=ether1 # 网络连接名称
# Chg CON
nmcli connection modify $MYCON \
ipv4.method auto \
ipv6.method auto
nmcli connection up $MYCON
ip -c -br address
在网络连接 ether1 上修改(克隆) MAC 地址并立即生效, 以解决局域网 MAC 地址冲突问题。
*适用 有线连接 / 无线连接
# Set ENV
MYCON=ether1 # 网络连接名称, 注意匹配网络接口类型
MYTYPE=ethernet # 网络接口类型 = 有线网卡 / 无线网卡 = ethernet / wifi
MYMAC=12:34:56:78:9A:BC # 新的 MAC 地址
# Chg CON
nmcli connection modify ${MYCON} \
${MYTYPE}.cloned-mac-address ${MYMAC}
nmcli connection up ${MYETH}
ip -c -br address
- 新建或修改部分网络参数, 网络连接可能会被断开, 并重新连接网络。
- 由于软硬件环境不同（盒子, 系统, 网络设备等）, 生效所需时间
1-15秒左右, 更长时间未生效的建议检查软硬件环境。
系统中已经添加了自定义开机启动任务脚本文件，在 Armbian 系统中的路径是 /etc/custom_service/start_service.sh 文件，可以根据个人需求在该脚本中自定义添加相关任务。
使用 armbian-sync 命令可以一键将本地系统中的全部服务脚本更新到最新版本。
我们将 Armbian 系统写入 eMMC 系统时，需要首先确认设备的安卓系统分区表，确保将数据写入至安全区域，尽量不要破坏安卓系统分区表，以免造成系统无法启动等问题。如果写入了不安全的区域，会无法启动，或出现类似下面的错误：
如果你使用的是 2022.11 之后本仓库中发布的 Armbian，你可以复制粘贴以下命令来获得一个记录完整分区信息的网址（设备本身并不需要联网）
ampart /dev/mmcblk2 --mode webreport 2>/dev/null
ampart 的 webreport 模式为 2023.02.03 发布的 v1.2 版本引入的，如果你使用上面的命令无输出，则可能为不支持直接输出网址的旧版，你可以转而使用下面这条命令：
echo "https://7ji.github.io/ampart-web-reporter/?dsnapshot=$(ampart /dev/mmcblk2 --mode dsnapshot 2>/dev/null | head -n 1)&esnapshot=$(ampart /dev/mmcblk2 --mode esnapshot 2>/dev/null | head -n 1)"
得到的网址将会类似于下面这样：
https://7ji.github.io/ampart-web-reporter/?esnapshot=bootloader:0:4194304:0%20reserved:37748736:67108864:0%20cache:113246208:754974720:2%20env:876609536:8388608:0%20logo:893386752:33554432:1%20recovery:935329792:33554432:1%20rsv:977272832:8388608:1%20tee:994050048:8388608:1%20crypt:1010827264:33554432:1%20misc:1052770304:33554432:1%20instaboot:1094713344:536870912:1%20boot:1639972864:33554432:1%20system:1681915904:1073741824:1%20params:2764046336:67108864:2%20bootfiles:2839543808:754974720:2%20data:3602907136:4131389440:4&dsnapshot=logo::33554432:1%20recovery::33554432:1%20rsv::8388608:1%20tee::8388608:1%20crypt::33554432:1%20misc::33554432:1%20instaboot::536870912:1%20boot::33554432:1%20system::1073741824:1%20cache::536870912:2%20params::67108864:2%20data::-1:4
将这个网址复制到你的浏览器打开，即可看到格式清晰明了的 DTB 分区信息和 eMMC 分区信息：
当你需要分享分区信息给其他人时（比如，发布到本仓库以来汇报某一新设备的情况，或者寻求他人的帮助），尽量分享网址本身，而不是截图。如果介意网址太长，可以借用一些免费的短网址工具。
- 一方面，网页上的分区信息在每次访问时都会动态生成，对于某些分区是否能写入的标注，以及表格的格式等都可能会更新。
- 另一方面，从截图中其他人也不能方便地复制分区参数做计算等。
另外，也不需要额外地将参数整理到表格文件，网页上表格的布局已经特意设计为仅需复制粘贴就可以导入到 Excel 或者 LibreOffice Calc 中。
DTB 表是安卓 DTB 中记录的每个盒子固件希望的分区布局，这一布局里一般会以一个大小为自动填充的 data 分区为结尾，所以同固件（也必然包括同型号）的盒子，这里的布局必然是相同的。盒子上实际的分区布局会因为 eMMC 的容量不同而各有差别，但总是由 DTB 的分区布局所决定的（即已知 DTB 分区布局 +eMMC 准确大小，必然可推知 eMMC 分区情况。 上面的 DTB 分区信息和 eMMC 分区信息并非来自同一个盒子，你看出来了吗？）。
eMMC 表是盒子上实际的 eMMC 分区布局。其中每一行表示一块存储区域，这一存储区域既可能是一个分区，也可能是分区间的空隙（因为晶晨的诡异决策，每个分区之间都至少有 8M 的空隙，计划留作他用，结果到最新的 S905X4 都没有用上，十分浪费空间）。对应分区的行中，字体为黑色，且偏移和掩码栏均有数值；对应空隙的行中，字体为灰色，偏移和掩码栏没有数值，且分区名为 gap 。
eMMC 表中，每一块存储区域的最后一栏为可写入的情况，绿色且 yes 表示这一区域可以写入，红色且 no 表示这一区域绝对不可以写入，黄色且有标注则表示某前提的下可以写入，或者只有部分可以写入。
以上表为例，bootloader 分区对应的 0+4M (0M~4M)绝对不可写入，其后的 32M 空隙（4M~36M）可以写入，reserved 分区对应的 36M+64M (36M~100M)绝对不可写入，其后的空隙一直到 env 前的空隙（100M~836M）都可以写入，env 的1M往后（837M一直到结尾）在不需要安卓启动 logo 的情况下都可以写入，则 eMMC 上所有可写入的范围为：
- 4M~36M
- 100M~836M
- 837M~结尾
在需要安卓启动 logo 的情况下，额外的，logo分区对应的 852M + 32M (852M~884M)不能写入，则 eMMC 上所有的可写入范围为：
- 4M~36M
- 100M~836M
- 837M~852M
- 884M~结尾
如果你的设备在使用 armbian-install 且 -a 参数（使用 ampart 调整 eMMC 分区布局）为 yes（默认值）的情况下失败，则你的盒子不能使用最优化的布局（即把 DTB 分区信息调整为只有 data ，再由此生成 eMMC 分区信息，然后将所有还存在的分区均向前挪动，如此一来，117M 向后的空间便均可使用），你需要在 armbian-install 中修改对应的分区信息。
此文件中，声明分区布局的关键参数有三个：BLANK1, BOOT, BLANK2。其中 BLANK1 表示从 eMMC 开头算起的不能使用的大小；BOOT 表示在 BLANK1 以后创建的用来存放内核、DTB 等的分区的大小，最好不要小于 256M，BLANK2 表示 BOOT 以后不能使用的大小；在此之后的空间会全部用来创建 ROOT 分区，储存整个系统中 /boot 挂载点以外的数据。三者均应为整数，且单位为MiB (1 MiB = 1024 KiB = 1024^2 Byte)
讨论上一段中不需要 logo 分区的情况，我们自然希望将所有能使用的空间全部使用，但是 4M~36M 的区域由于太小，不能用作 BOOT，所以只能将它算在不能用的 BLANK1 里面。而 100M~836M 的区域，用作 BOOT 绰绰有余，则可以将这 736M 全部分配给 BOOT。此后再有 836M~837M 的不能使用区域，便算给 BLANK2 ，那么应该使用的参数就应该如下（下文仅以 s905x3 为例，若你的 SoC 为其他，需要修改其他的对应代码块）：
# Set partition size (Unit: MiB)
elif [[ "${AMLOGIC_SOC}" == "s905x3" ]]; then
BLANK1="100"
BOOT="736"
BLANK2="1"u-boot 文件是引导系统正常启动的重要文件。
提取需要使用 HxD 软件。可以从 官网下载链接 或 备份下载链接 获取安装。
在 cmd 面板中依次执行以下命令提取相关文件，并下载到本地电脑。
# 使用 adb 工具进入盒子
adb connect 192.168.1.111
adb shell
# 导出 bootloader 命令
dd if=/dev/block/bootloader of=/data/local/bootloader.bin
# 导出 dtb 命令
cat /dev/dtb >/data/local/mybox.dtb
# 导出 gpio 命令
cat /sys/kernel/debug/gpio >/data/local/mybox_gpio.txt
# 依次把 bootloader、dtb 和 gpio 文件都下载到本地电脑C盘根目录下的 mybox 文件夹
adb pull /data/local/bootloader.bin C:\mybox
adb pull /data/local/mybox.dtb C:\mybox
adb pull /data/local/mybox_gpio.txt C:\mybox主线 u-boot 最重要的是 acs.bin，用于初始化内存的部分，原厂 u-boot 位于固件最前面的 4MB 位置。使用刚才获得的 bootloader.bin 文件提取 acs.bin 文件。
打开 HxD 软件，打开上面导出的 bootloader.bin 文件，右键 - 选择范围，起始位置 F200，长度 1000，选十六进制。
复制选择的结果，然后新建文件，插入式粘贴，警告忽略，另存为 acs.bin 文件。
如果是锁了 bootloader 的话这个区域的代码是是乱码就没用了。正常的应该像上图中这样有很多 0 ，有 cfg 会连续出现几次，中间会出现 ddr 相关的字样，这种正常代码就是可以使用的。
制作 u-boot 需要 https://github.com/unifreq/amlogic-boot-fip 和 https://github.com/unifreq/u-boot 这两个源码库，编译自己盒子的两个 u-boot 文件。
在 amlogic-boot-fip 源码里面每个机型只有 acs.bin 这个文件是不同的，其它的文件都可以通用。
制作 u-boot 的方法详见 https://github.com/unifreq/u-boot/tree/master/doc/board/amlogic 里的具体说明，选择自己设备的型号进行编译测试。
根据 unifreq 的方法制作 u-boot 需要用到盒子的 acs.bin，dts 和 config 文件。其中安卓系统导出来的 dts 不能直接转换成 Armbian 的格式，需要自己编写一个对应的 dts 文件。根据自己设备具体硬件上的区别部分，比如开关、led、电源控制、tf卡、sdio wifi模块等，使用内核源码库中相似的 dts 文件进行修改制作。
以制作 X96Max Plus 的 u-boot 为例：
~/make-uboot
├── amlogic-boot-fip
│ ├── x96max-plus # 自己创建目录
│ │ ├── asc.bin # 自己制作源文件
│ │ └── other-copy-files... # 复制其他目录的文件
│ │
│ ├── other-source-directories...
│ └── other-source-files...
│
└── u-boot
├── configs
│ └── x96max-plus_defconfig # 自己制作源文件
├── arch
│ └── arm
│ └── dts
│ ├── meson-sm1-x96-max-plus-u-boot.dtsi # 自己制作源文件
│ ├── meson-sm1-x96-max-plus.dts # 自己制作源文件
│ └── Makefile # 编辑
├── fip
│ ├── u-boot.bin # 生成文件
│ └── u-boot.bin.sd.bin # 生成文件
├── u-boot.bin # 生成文件
│
├── other-source-directories...
└── other-source-files...- 下载 amlogic-boot-fip 源码。在根目录创建 x96max-plus 目录，里面的文件除了自己制作的
asc.bin文件外，其他文件可以从其他目录下复制。 - 下载 u-boot 源码。制作对应的 x96max-plus_defconfig 文件放入 configs 目录。制作对应的 meson-sm1-x96-max-plus-u-boot.dtsi 和 meson-sm1-x96-max-plus.dts 文件放入 arch/arm/dts 目录，并编辑此目录中的 Makefile 文件，添加
meson-sm1-x96-max-plus.dtb文件的索引。 - 进入 u-boot 源码目录根目录下，根据文档 https://github.com/unifreq/u-boot/blob/master/doc/board/amlogic/x96max-plus.rst 中的步骤操作。
最终生成的文件有两类：在 u-boot 根目录下的 u-boot.bin 文件是 /boot 目录下使用的不完整版 u-boot（对应仓库中的 overload 目录）；在 fip 目录下的 u-boot.bin 和 u-boot.bin.sd.bin 是 /usr/lib/u-boot/ 目录下使用的完整版 u-boot 文件（对应仓库中的 bootloader 目录），完整版的两个文件相差 512 字节，大的那个是填充了 512 字节的 0 在前面。
💡提示：在写入 eMMC 进行测试前，请先查看 12.3 的救砖方法。务必掌握短接点位置，有原厂 .img 格式的安卓系统文件，并进行过短接刷机测试，确保救砖方法都已经掌握的情况下再进行写入测试。
如果内存大小识别不正确（4G内存识别为1-2G是不正常，识别为3.7G是正常），可以尝试手动复制一份 /boot/UBOOT_OVERLOAD 文件（注意是复制一份，不要改名，改名后安装与更新等操作后将无法启动），在 USB 中使用时另存为 /boot/u-boot.ext，在 eMMC 中使用时另存为 /boot/u-boot.emmc。
除了想尝试解决内存的问题外，不要手动复制 u-boot 文件，添加不正确会导致无法启动以及出现各种问题。
有些新设备不在目前的支持列表（或有变异体），可以通过反编译，调整相关参数进行尝试。
# 安装依赖
sudo apt-get update
sudo apt-get install -y device-tree-compiler
# 1. 反编译命令（使用 dtb 文件生成 dts 源码）
dtc -I dtb -O dts -o xxx.dts xxx.dtb
# 2. 编译命令（使用 dts 编译生成 dtb 文件）
dtc -I dts -O dtb -o xxx.dtb xxx.dts在 Amlogic 设备中，可以在 /boot/uEnv.txt 文件中进行添加/修改/删除等设置。在 Rockchip 设备中在 /boot/armbianEnv.txt 文件中进行设置。每次更改后要重启才能生效。
比如 Home Assistant Supervisor 应用只支持 docker cgroup v1 版本，而目前 docker 默认安装的都是最新的 v2 版本。如需切换至 v1 版本，可以在 cmdline 中添加 systemd.unified_cgroup_hierarchy=0 参数设置，重启后就可以切换至 docker cgroup v1 版本。
为一个设备构建 Armbian 系统，需要用到设备配置文件、boot 文件、u-boot 文件、流程控制文件共 4 部分，具体添加方法介绍如下：
在配置文件 /etc/model_database.conf 里面，根据设备的测试支持情况，添加对应的配置信息。其中 BUILD 的值是 yes 的是默认构建的部分设备，对应的 BOARD 值 必须唯一，这些盒子可以直接使用默认构建的 Armbian 系统。
默认值是 no 的没有打包，这些设备使用时需要下载相同 FAMILY 的 Armbian 系统，在写入 USB 后，可以在电脑上打开 USB 中的 boot 分区，修改 /boot/uEnv.txt 文件中 FDT 的 dtb 名称，适配列表中的其他设备。
Amlogic 系列的设备，共用 /boot 启动文件。
Rockchip 系列的设备，为每个设备添加以 BOARD 命名的独立 /boot 启动文件目录，对应的文件放在此目录中。
Amlogic 系列的设备，共用 bootloader 文件和 u-boot 文件，如果有新增的文件，分别放入对应的目录。其中的 bootloader 文件在系统构建时会自动添加至 Armbian 系统的 /usr/lib/u-boot 目录，u-boot 文件会自动添加至 /boot 目录。
Rockchip 系列的设备，为每个设备添加以 BOARD 命名的独立 u-boot 文件目录，对应的系列文件放在此目录中，构建 Armbian 时将直接写入对应的系统镜像文件中。
在 yml 工作流控制文件 的 armbian_board 中添加对应的 BOARD 选项，支持在 github.com 的 Actions 中进行使用。
有些设备可以从 USB/SD/TF 正常启动 Armbian 使用，但是写入 eMMC 时会报 I/O 写入错误，例如 Issues 中的案例，报错内容如下：
[ 284.338449] I/O error, dev mmcblk2, sector 0 op 0x1:(WRITE) flags 0x800 phys_seg 1 prio class 2
[ 284.341544] Buffer I/O error on dev mmcblk2, logical block 0, lost async page write
[ 284.446972] I/O error, dev mmcblk2, sector 0 op 0x1:(WRITE) flags 0x800 phys_seg 1 prio class 2
[ 284.450074] Buffer I/O error on dev mmcblk2, logical block 0, lost async page write
[ 284.497746] I/O error, dev mmcblk2, sector 0 op 0x1:(WRITE) flags 0x800 phys_seg 1 prio class 2
[ 284.500871] Buffer I/O error on dev mmcblk2, logical block 0, lost async page write这种情况下可以调整所使用的 dtb 的工作模式速度和频率，来稳定对存储的读写支持。使用 sdr 模式时，频率是速度的 2 倍，使用 ddr 模式时，频率等于速度。如下：
sd-uhs-sdr12
sd-uhs-sdr25
sd-uhs-sdr50
sd-uhs-ddr50
sd-uhs-sdr104
max-frequency = <208000000>;以内核源码的 dts 文件中的代码片段举例：
/* SD card */
&sd_emmc_b {
status = "okay";
bus-width = <4>;
cap-sd-highspeed;
sd-uhs-sdr12;
sd-uhs-sdr25;
sd-uhs-sdr50;
max-frequency = <100000000>;
};
/* eMMC */
&sd_emmc_c {
status = "okay";
bus-width = <8>;
cap-mmc-highspeed;
max-frequency = <100000000>;
};一般情况下，把 &sd_emmc_c 的频率由 max-frequency = <200000000>; 下调为 max-frequency = <100000000>; 即可解决问题。如果不行可继续下调到 50000000 进行测试，并通过调整 &sd_emmc_b 来对 USB/SD/TF 进行设置，也可以使用 sd-uhs-sdr 进行限速。你可以通过修改 dts 文件并 编译 得到测试文件，也可以通过 12.13 节 中介绍的方法对已有的 dtb 文件进行反编译修改生成测试文件。反编译 dtb 文件修改时使用十六进制的值，其中十进制的 200000000 对应的十六进制为 0xbebc200，十进制的 100000000 对应的十六进制为 0x5f5e100，十进制的 50000000 对应的十六进制为 0x2faf080，十进制的 25000000 对应的十六进制为 0x17d7840。