iMX8模块Ubuntu移植

By Toradex胡珊逢

本文将介绍如何将 Ubuntu 系统移植到 Toradex Apalis iMX8 计算机模块上。该方法也同样使用与其他使用 eMMC 作为存储介质的模块，例如 Colibri、Verdin 模块。撰写文章时 Toradex 发布的最新 Linux BSP 是 5.2.0，Ubuntu 为 20.04 LTS 和 20.10。为了获得更好的支持，建议使用新的Linux BSP。这里涉及的 Ubuntu 分为两类，Ubuntu 20.04 Base 是不带任何图形界面的 console 镜像。Ubuntu 20.10 desktop 使用了 Ubuntu 自带的桌面环境，如Gnome。

首先在电脑上安装 qemu-user-static 软件仿真 arm64 运行环境。

$ sudo apt install qemu-user-static

Ubuntu 20.04 Base

首先下载 Apalis iMX8 模块的 Linux BSP。
https://artifacts.toradex.com/artifactory/tdxref-oe-prod-frankfurt/dunfell-5.x.y/release/7/apalis-imx8/tdx-xwayland/tdx-reference-minimal-image/oedeploy/Apalis-iMX8_Reference-Minimal-Image-Tezi_5.2.0+build.7.tar

解压文件。

$ tar vxf Apalis-iMX8_Reference-Minimal-Image-Tezi_5.2.0+build.7.tar

提取 Linux BSP 中的文件系统到 rootfs 目录，里面包含一些模块的驱动和固件，稍后需要用到。

$ mkdir rootfs

$ cd Apalis-iMX8_Reference-Minimal-Image-Tezi_5.2.0+build.7

$ sudo tar vxf Reference-Minimal-Image-apalis-imx8.tar.xz -C ../rootfs

下载 arm64 格式的 Ubuntu base 20.04.2 文件系统。

http://cdimage.ubuntu.com/ubuntu-base/releases/20.04.2/release/ubuntu-base-20.04.2-base-arm64.tar.gz

解压 Ubuntu 文件系统到ubuntu 文件夹中。

$ mkdir ubuntu

$ sudo tar vxf ubuntu-base-20.04.2-base-arm64.tar.gz -C ubuntu/

执行下面脚本 ch-mount.sh，切换到 Ubuntu 目录中运行并安装软件。

$ chmod +x ./ch-mount.sh

$ sudo ./ch-mount.sh -m ubuntu/

设置 DNS 服务器，在线安装一些基本组件。这里页可以自行添加所需的其他软件。

# echo nameserver 8.8.8.8 > /etc/resolv.conf

# apt update

# apt upgrade

# apt install language-pack-en-base sudo ssh net-tools \

network-manager netplan.io iputils-ping rsyslog \

bash-completion htop resolvconf dialog \

vim nano alsa-utils gcc \

less resolvconf autoconf autopoint libtool \

bison flex libglib2.0-dev libpango1.0-dev libatk1.0-dev kmod pciutils -y

添加用户，如用户名ubuntu，并为ubuntu 和 root 用户设置密码。

# useradd -s '/bin/bash' -m -G adm,sudo ubuntu

# passwd ubuntu

# passwd root

设置主机名称。

# echo 'apalis-imx8' > /etc/hostname

将ttymxc0 用于默认的调试串口。

# systemctl enable serial-getty@ttymxc0.service

清除缓存。

# apt autoclean

# exit

卸载 ubuntu 目录。

$ sudo ./ch-mount.sh -u ubuntu/

这里采用netplan 作为有线网络管理工具。将相应的 yaml 配置文件复制到 ubuntu/etc/netplan 目录。这里提供两个配置文件供参考，分别为动态和静态IP 设置。

$ sudo cp 00-installer-config.yaml ubuntu/etc/netplan/

将 Linux BSP 中的内核驱动、固件和 fstab 复制到 Ubuntu 文件系统中。

$ sudo mkdir -p ubuntu/lib/modules

$ sudo cp -Ppr rootfs/lib/modules/* ubuntu/lib/modules/

$ sudo cp -Ppr rootfs/lib/firmware/* ubuntu/lib/firmware/

$ sudo rm ubuntu/etc/fstab

$ sudo cp rootfs/etc/fstab ubuntu/etc/

重新打包 Ubuntu 文件系统，用于Toradex Easy Installer 安装。

$ cd ubuntu/

$ sudo tar cvf ../ubuntu.tar .

$ xz -T0 ubuntu.tar

将生成的 ubuntu.tar.xz 复制到之前解压的 Apalis-iMX8_Reference-Minimal-Image-Tezi_5.2.0+build.7 目录中

$ cp ubuntu.tar.xz Apalis-iMX8_Reference-Minimal-Image-Tezi_5.2.0+build.7

修改 image.json 文件。

filename 为生成的 ubuntu.tar.xz。

uncompressed_size 为 ubuntu 目录大小，单位 MB，可以使用下面命令查看。

$ sudo du -sm ubuntu

至此，可以将 Apalis-iMX8_Reference-Minimal-Image-Tezi_5.2.0+build.7 复制到 U 盘进行安装。

Ubuntu 20.10 desktop

解压文件。

$ tar vxf Apalis-iMX8_Reference-Minimal-Image-Tezi_5.2.0+build.7.tar

提取 Linux BSP 中的文件系统到 rootfs 目录，里面包含一些模块的驱动和固件，稍后需要用到。

$ mkdir rootfs

$ cd Apalis-iMX8_Reference-Minimal-Image-Tezi_5.2.0+build.7

$ sudo tar vxf Reference-Minimal-Image-apalis-imx8.tar.xz -C ../rootfs

这里使用 Ubuntu 首次针对 raspi Arm64 处理器发布的 Ubuntu 20.10 桌面系统。下载镜像文件并解压。

$ wget https://cdimage.ubuntu.com/releases/20.10/release/ubuntu-20.10-preinstalled-desktop-arm64+raspi.img.xz

$ xz -d ubuntu-20.10-preinstalled-desktop-arm64+raspi.img.xz

ubuntu-20.10-preinstalled-desktop-arm64+raspi.img 原本是为 raspi 直接烧录 SD 使用，其中包括了 u-boot、Linux kernel、device tree 等文件，但我们只需要使用其文件系统即可。使用 fdisk 命令查看 img 文件中文件系统位置。

$ fdisk -l ubuntu-20.10-preinstalled-desktop-arm64+raspi.img

Disk ubuntu-20.10-preinstalled-desktop-arm64+raspi.img: 8.15 GiB, 8750736384 bytes, 17091282 sectors

Units: sectors of 1 * 512 = 512 bytes

Sector size (logical/physical): 512 bytes / 512 bytes

I/O size (minimum/optimal): 512 bytes / 512 bytes

Disklabel type: dos

Disk identifier: 0xb6b5c3c7

Device Boot Start End Sectors Size Id Type

ubuntu-20.10-preinstalled-desktop-arm64+raspi.img1 * 2048 526335 524288 256M c W95 FAT32 (LBA)

ubuntu-20.10-preinstalled-desktop-arm64+raspi.img2 526336 17091247 16564912 7.9G 83 Linux

img2 是 Ubuntu 文件系统，其起始偏移地址为 526336，注意这里的单位是 sector。换算为字节是 526336 * 512 = 269484032。使用 mount 命令挂载时 offset=269484032

$ mkdir ubuntu

$ sudo mount -o loop,offset=269484032 ubuntu-20.10-preinstalled-desktop-arm64+raspi.img ubuntu/

删除以下文件。

$ cd ubuntu

$ sudo rm -rf boot

$ sudo rm etc/fstab

$ sudo rm -rf lib/modules/*

$ cd ..

执行下面脚本 ch-mount.sh，切换到 ubuntu 目录中运行。

$ chmod +x ./ch-mount.sh

$ sudo ./ch-mount.sh -m ubuntu/

将ttymxc0 用于默认的调试串口。

# systemctl enable serial-getty@ttymxc0.service

删除下面软件。

# apt remove u-boot-rpi flash-kernel

# exit

卸载 ubuntu 目录。

$ sudo ./ch-mount.sh -u ubuntu/

将 Linux BSP 中的内核驱动、固件和 fstab 复制到 Ubuntu 文件系统中。

$ sudo cp -Ppr rootfs/lib/modules/* ubuntu/lib/modules/

$ sudo cp -Ppr rootfs/lib/firmware/* ubuntu/lib/firmware/

$ sudo rm ubuntu/etc/fstab

$ sudo cp rootfs/etc/fstab ubuntu/etc/

注释掉 fstab 中 /dev/boot-part 挂载路径。

$ vi ubuntu/etc/fstab

# stock fstab - you probably want to override this with a machine specific one

/dev/root / auto noatime 1 1

#/dev/boot-part /boot auto noatime,noauto 0 0

重新打包 Ubuntu 文件系统，用于Toradex Easy Installer 安装。

$ cd ubuntu/

$ sudo tar cvf ../ubuntu-desktop.tar .

$ xz -T0 ubuntu-desktop.tar

将生成的 ubuntu-desktop.tar 复制到之前解压的 Apalis-iMX8_Reference-Minimal-Image-Tezi_5.2.0+build.7 目录中

$ cp ubuntu-desktop.tar Apalis-iMX8_Reference-Minimal-Image-Tezi_5.2.0+build.7

修改 image.json 文件。

filename 为生成的 ubuntu-desktop.tar。

uncompressed_size 为 ubuntu 目录大小，单位 MB，可以使用下面命令查看。

$ sudo du -sm ubuntu

至此，可以将 Apalis-iMX8_Reference-Minimal-Image-Tezi_5.2.0+build.7 复制到 U 盘进行安装。在安装完毕后需要连接 HDMI 显示器、键盘和鼠标。首次启动时，Ubuntu 系统会进入用户设置界面，如时区、用户名和密码等配置。期间可能会遇到错误，但可以关闭错误窗口。然后在调试串口中使用刚才设置的用户名和密码登录，运行 sudo reboot 重新启动即可。