跳转至

Armbian常用系统定制

Note

符号说明：
SDK$：指代源码路径
console$：泛指主板的命令行控制台。
ADB$：Android Debug Bridge 命令行工具，泛指可运行 ADB 的环境

镜像源替换

  • armbian 官方镜像源
console$ cat /etc/apt/sources.list.d/armbian.sources 
Types: deb
URIs: https://apt.armbian.com
Suites: noble
Components: main noble-utils noble-desktop
Signed-By: /usr/share/keyrings/armbian-archive-keyring.gpg
  • Ubuntu 官方镜像源
console$ cat /etc/apt/sources.list.d/ubuntu.sources 
Types: deb
URIs: http://ports.ubuntu.com/
Suites: noble noble-security noble-updates noble-backports
Components: main restricted universe multiverse
Signed-By: /usr/share/keyrings/ubuntu-archive-keyring.gpg
  • Ubuntu 24.04 中科大镜像源
console$ vim /etc/apt/sources.list.d/ubuntu.sources
Types: deb
URIs: https://mirrors.ustc.edu.cn/ubuntu-ports
Suites: noble noble-updates noble-backports
Components: main restricted universe multiverse
Signed-By: /usr/share/keyrings/ubuntu-archive-keyring.gpg

Types: deb
URIs: https://mirrors.ustc.edu.cn/ubuntu-ports
Suites: noble-security
Components: main universe restricted multiverse
Signed-By: /usr/share/keyrings/ubuntu-archive-keyring.gpg
  • Debian 12 中科大镜像源
console$ vim /etc/apt/sources.list.d/debian.sources
Types: deb
URIs: http://mirrors.ustc.edu.cn/debian
Suites: bookworm bookworm-updates
Components: main contrib non-free non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg

Types: deb
URIs: http://mirrors.ustc.edu.cn/debian-security
Suites: bookworm-security
Components: main contrib non-free non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg

开机启动脚本

KICKPI 默认启动 kickpi.sh 脚本，可将开机启动的脚本（或其他服务）添加到 kickpi.sh 脚本中。

console$ cat /etc/init.d/kickpi.sh 
#!/bin/sh

LOG_FILE=/tmp/kickpi.log
depmod
dmesg -n 1
echo " kickpi.sh run finish !" >> $LOG_FILE

串口自动登陆

# serial-getty auto login
sed -i "s~\(^ExecStart=.*\)~# \1\nExecStart=-/sbin/agetty --autologin $RealUserName --keep-baud 115200,57600,38400,9600 %I \$TERM~" /usr/lib/systemd/system/serial-getty@.service

MIPI 屏显示

主板中已存在dtbo文件

/boot/dtb-6.1.115-vendor-rk35xx/rockchip/overlay/rk3576-kickpi-lcd-mipi-AT101DS40I.dtbo
/boot/dtb-6.1.115-vendor-rk35xx/rockchip/overlay/rk3576-kickpi-lcd-mipi-MX101BA1340.dtbo
/boot/dtb-6.1.115-vendor-rk35xx/rockchip/overlay/rk3576-kickpi-lcd-mipi-MX080B2140.dtbo
/boot/dtb-6.1.115-vendor-rk35xx/rockchip/overlay/rk3576-kickpi-lcd-mipi-F050008M01.dtbo

操作示例：连接型号为 MX080B2140 的 8寸屏 ，添加对应的 overlays（overlays=rk3576-kickpi-lcd-mipi-MX080B2140 添加对应的 dtbo 名称）。

$ vim /boot/armbianEnv.txt 
verbosity=1
bootlogo=true
console=both
overlay_prefix=rk35xx
fdtfile=rockchip/rk3576-kickpi-k7.dtb
rootdev=UUID=389fa6c5-33a8-4653-99ec-f532b9d5a742
rootfstype=ext4
overlays=rk3576-kickpi-lcd-mipi-MX080B2140
usbstoragequirks=0x2537:0x1066:u,0x2537:0x1068:u

4G/5G 模块

监测到4G/5G模块，开机会执行/usr/bin/quectel-CM进行拨号上网。可通过移远官方Linux软件定制 4G/5G 模块软件功能。

GCC⼯具链

  • 安装命令
apt update && apt install -y build-essential manpages-dev

Chromium 浏览器

建议采用 Chromium 浏览器，测试结果表明，其视频播放性能良好、运行流畅。

  • 安装方式
console$ sudo apt update
console$ sudo apt install chromium

FireFox 浏览器

firefox 浏览器存在 profile 问题，设备重启后无法打开浏览器。

  • 安装方式
console$ sudo apt update
console$ sudo apt install chromium
  • profile 问题

方法一

在Linux终端中输入命令，启动 Firefox 浏览器的配置文件管理界面，删除错误的 profile，新建 profile 来启动 firefox。

$ firefox -profilemanager

方法二

$ rm ~/.mozilla/firefox/ -rfv

Armbian 镜像导出与修改

1. 将文件系统镜像导出至 U 盘、SD 卡等存储介质

sudo ./ff_export_rootfs /mnt/ -t ext4

2. 确认文件系统镜像大小

// 确认对比镜像大小，导出的 ext 镜像接近7G，大于原本的armbian镜像
$ ls -lh *.img
-rwxr--r--  1 hcm  hcm  6.9G Jun 12 16:18 Armbian-unofficial_25.08.0-trunk_noble_ext4_202506121342.img
-rw-rw-r--  1 hcm  hcm  6.3G Jun 12 16:22 armbian.img

3. 若文件系统镜像大于原本的镜像容量，需要调整原本 armbian 镜像容量

调整Armbian的镜像大小为8G

$ sudo fallocate -l 9G armbian.img

确认节点生成

$ sudo losetup -P /dev/loop777 ./armbian.img

使用parted工具调整分区大小

$ sudo parted /dev/loop777
# 在parted中执行：
# Fix #选择修复
# (parted) print free  # 查看当前分区和可用空间
# (parted) resizepart 1 100% # 选择调整第一个分区
# (parted) print         # 确认分区信息
# (parted) quit          # 退出

调整文件系统大小

 # 检查文件系统（可选但推荐）
$ sudo e2fsck -f /dev/loop777p1 
# 扩展文件系统到最大
$ sudo resize2fs /dev/loop777p1

4. 挂载 armbian镜像文件系统

$ sudo mount /dev/loop777p1 orgin/

5. 挂载导出的文件系统

$  sudo mount ext4.img copy/

6. 替换文件系统

$ sudo cp -rfp copy/* orgin/

7. 卸载

sudo umount copy/
sudo umount orgin/
sudo losetup -d /dev/loop777

8. 镜像已经修改完成。以上步骤也可用rootfs.sh脚本进行更新。

RKNN 部署

系统支持部署 rknn-toolkit2，rknn_model_zoo，点击跳转至 Rockhip 官方文档。