在ED-HMI3010上使用Ubuntu系统

1 概述

介绍在ED-HMI3010系列产品上使用Ubuntu系统的背景和范围。

1.1 背景

ED-HMI3010系列产品在出厂时默认已安装Raspberry Pi OS，如果用户在收到产品后想更换操作系统为Ubuntu系统，在直接烧录为Ubuntu系统后，会导致部分功能无法使用(LCD 屏不显示)。为了解决这个问题，我司支持在线安装Firmware包，使ED-HMI3010系列更好的兼容Ubuntu系统，确保所有功能均可以使用。

1.2 适用范围

本应用适用的产品型号和Ubuntu系统如下表。

产品型号软件范围
ED-HMI3010-070C Ubuntu Desktop 24.04 LTS (64-bit) Ubuntu 24.04
Ubuntu Desktop 23.10 (64-bit) Ubuntu 23.10
ED-HMI3010-101C

2 应用指导

介绍在ED-HMI3010系列产品上使用Ubuntu系统的操作步骤。

2.1 操作流程

  1. SD卡烧录
  2. 首次启动配置
  3. 安装Kernel和Firmware包

2.2 SD卡烧录

建议使用Raspberry Pi官方烧录工具来烧录SD卡，工具下载路径如下：

前提条件：

  • 已完成烧录工具的下载并安装至Windows电脑。
  • 已准备一个读卡器。
  • 已下载Ubuntu镜像文件至Windows电脑。

操作步骤：

操作步骤以windows系统为例进行说明。

  1. 从ED-HMI3010中拔出Micro SD卡。

  2. 将Micro SD卡插入读卡器，再将读卡器插入Windows电脑。

  3. 打开SD Card Formatter，选择待格式化的盘符，单击右下方“Format”进行格式化。

image-20241011153629436
  1. 在弹出的提示框中，单击“是”。
image-20241011153703827
  1. 格式化完成后，在提示框中单击 “确定”。
image-20241011153726269

  1. 关闭SD Card Formatter。

  2. 打开Raspberry Pi Imager，单击“CHOOSE OS”，在弹出的窗格中选择“Use custom”。

image-20241224175135571

  1. 根据提示，在自定义路径下选择已获取的Ubuntu镜像文件，并返回至烧录主界面。

  2. 单击“CHOOSE STORAGE”，在“Storage”界面选择待烧录的SD卡，并返回至烧录主界面。

image-20241224175422265
  1. 单击“NEXT”，在弹出的“Use OS customization？”提示框中选择“NO”。
image-20241224175810254
  1. 在弹出的“Warning”提示框中选择“YES”，开始写入镜像。
image-20241224180354884
  1. 待镜像写入完成后，会进行文件的验证。
image-20241224181134573
  1. 验证完成后，弹出“Write Successful”提示框，单击“CONTINUE”完成烧录。
image-20241224181152173

  1. 关闭Raspberry Pi Imager，从读卡器中拔出Micro SD卡。

  2. 将Micro SD卡插入ED-HMI3010中，再重新给设备上电。

2.3 首次启动配置

介绍用户首次启动系统时的相关配置。

2.3.1 Ubuntu Desktop 23.10 LTS (64-bit)

烧录Ubuntu Desktop 23.10 LTS (64-bit)镜像后，系统首次启动时，需要完成初始化配置。

前提条件：

  • 已获取可以正常使用的显示器（带 HDMI 接口）、鼠标、键盘和电源适配器。
  • 已获取可以正常使用的HDMI线。
  • 已获取可以正常使用的网线。

操作步骤：

  1. 将设备通过网线接入网络，通过HDMI线连接显示器，并且连接鼠标、键盘和电源适配器。

  2. 给设备上电，系统将会开始启动，正常启动后进入“System Configuration”界面，按需设置系统语言，再单击“Continue”。

image-20240719161925222
  1. 在弹出的窗格中设置键盘布局，再单击“Continue”。
image-20240719161937028
  1. 选择对应的区域，单击“Continue”。
image-20240719114448500
  1. 设置用户名和密码，勾选“Log in automatically”，再单击“Continue”。
image-20240719162058039
  1. 初始化设置完成后，进入系统配置界面。
image-20240719162112580
  1. 系统配置完成后自动进入系统桌面。

2.3.2 Ubuntu Desktop 24.04 LTS (64-bit)

烧录Ubuntu Desktop 24.04 LTS (64-bit)镜像后，系统首次启动时，需要完成初始化配置。

前提条件：

  • 已获取可以正常使用的显示器（带 HDMI 接口）、鼠标、键盘和电源适配器。
  • 已获取可以正常使用的HDMI线。
  • 已获取可以正常使用的网线。

操作步骤：

  1. 将设备通过网线接入网络，通过HDMI线连接显示器，并且连接鼠标、键盘和电源适配器。

  2. 给设备上电，系统将会开始启动，正常启动后进入“System Configuration”界面，按需设置系统语言，再单击“Continue”。

image-20240719114338625
  1. 在弹出的窗格中设置键盘布局，再单击“Continue”。
image-20240719114422838
  1. 在弹出的窗格中单击“Continue”跳过WiFi连接。
image-20240719114439884
  1. 选择对应的区域，单击“Continue”。
image-20240719114448500
  1. 设置用户名和密码，勾选“Log in automatically”，再单击“Continue”。
image-20240719114458517
  1. 初始化设置完成后，进入系统配置界面。
image-20240719114612457
  1. 系统配置完成后自动进入系统桌面。

2.4 安装Kernel和Firmware包

在ED-HMI3010系列产品上完成启动配置后可通过安装Firmware来配置系统，使系统能够正常使用。下文介绍在Ubuntu上安装Firmware包的具体操作。

前提条件：

  • 设备已正常启动并接入网络。
  • 已完成Ubuntu镜像的烧录和启动配置。

操作步骤：

  1. 根据下表提供的下载路径将对应的Kernel包和Firmware包下载至本地目录，并将其拷贝至ED-HMI3010（已安装Ubuntu系统）的任意目录下。
类型名称
Kernel包 linux-image-6.8.0-1005-raspi_6.8.0-1005.5+ed_arm64.deb
linux-modules-6.8.0-1005-raspi_6.8.0-1005.5+ed_arm64.deb
Firmware包 ed-hmi3010-070c-ubuntu-firmware_1.20240612.2_arm64.deb
ed-hmi3010-101c-ubuntu-firmware_1.20240612.1_arm64.deb
  1. 打开终端命令窗格，执行如下命令，安装Kernel包。
sudo dpkg -i linux*6.8.0-1005*.deb
image-20240719145324981
  1. 在命令窗格依次执行如下命令，添加edatec apt源。
sudo snap install curl
curl -sS https://apt.edatec.cn/pubkey.gpg | sudo apt-key add -
sudo echo "deb https://apt.edatec.cn/raspbian stable main" | sudo tee /etc/apt/sources.list.d/edatec.list
1111133
  1. 在命令窗格依次执行如下命令，切换Kernel。
sudo apt update
curl -s 'https://apt.edatec.cn/downloads/20250103/kernel-change-ubuntu.sh' | sudo bash -s  "6.8.0-1005-raspi"
567814838
  1. 执行如下命令，禁止Ubuntu Kernel更新。
sudo dpkg -l | grep linux-image | awk '{print $2}' | grep ^linux | while read line; do sudo apt-mark hold $line; done
image-20240719145342211
  1. 执行如下命令，安装Firmware包。
  • ED-HMI3010-070C
sudo dpkg -i ed-hmi3010-070c-ubuntu-firmware_1.20240612.2_arm64.deb
image-20240719163425604
  • ED-HMI3010-101C
sudo dpkg -i ed-hmi3010-101c-ubuntu-firmware_1.20240612.1_arm64.deb
image-20240719163436062
  1. 拔掉HDMI线断开与显示器的连接，再将设备断电重启。