在标准的Raspberry Pi OS (Trixie)上使用7英寸和10.1英寸的ED-HMI

1 概述

介绍在标准的Raspberry Pi OS (Trixie)上使用7英寸和10.1英寸的ED-HMI产品的背景和适用范围。

1.1 背景

EDATEC的7英寸和10.1英寸ED-HMI产品现已支持标准Raspberry Pi OS (Trixie)原生驱动。​ 当系统内核版本为6.18.38及以上时，用户仅需通过直接修改config.txt配置文件，即可使能LCD显示屏并使其正常工作，无需额外安装EDATEC的BSP包。这一改进显著拓宽了ED-HMI的应用场景，能够更灵活地满足不同用户的多样化需求。

1.2 适用范围

本应用适用于EDATEC所有的7寸和10.1寸的ED-HMI产品，兼容的OS版本和对应的产品型号如下：

软件范围产品型号
标准的Raspberry Pi OS（Trixie，系统内核版本为6.18.38及以上）ED-HMI2002-070C
ED-HMI2020-070C
ED-HMI2120-070C
ED-HMI2220-070C
ED-HMI3010-070C
ED-HMI3020-070C
ED-HMI3120-070C
ED-HMI2002-101C
ED-HMI2020-101C
ED-HMI2120-101C
ED-HMI2220-101C
ED-HMI2630-101C
ED-HMI3010-101C
ED-HMI3020-101C
ED-HMI3120-101C
ED-HMI3630-101C

2 应用指导

介绍在标准的Raspberry Pi OS (Trixie)上使用7英寸和10.1英寸的ED-HMI产品的具体操作。

2.1 查看系统内核版本

前提条件：

  • 已完成标准的Raspberry Pi OS (Trixie)的烧录。
  • ED-HMI设备已正常启动，且已外接一台显示器。

操作步骤：

  1. 打开设备终端命令窗格，执行如下命令，查看当前系统的内核版本。
uname -r
  1. 查看返回值，确定系统的内核版本是否为6.18.38及以上。
  • 若返回信息显示6.18.38+rpt-rpi-v8或者6.18.39+rpt-rpi-v8，则表示系统内核为6.18.38及以上。
  • 若返回信息显示6.18.34+rpt-rpi-v8，或者更小的版本值，则表示系统内核为6.18.38以下。

2.2 配置说明

不同的系统内核版本对应不同的操作方法，下文分别进行说明。

2.2.1 标准的Raspberry Pi OS（Trixie，系统内核版本为6.18.38及以下）

前提条件：

  • ED-HMI设备已正常启动，且已外接一台显示器。
  • 已确定系统内核版本为6.18.38以下。

操作步骤：

  1. 打开设备终端命令窗格，执行如下命令，创建并打开/etc/apt/sources.list 文件（软件源）。
sudo nano /etc/apt/sources.list
  1. 删除/etc/apt/sources.list 文件中的所有内容，并添加以下内容。
deb https://mirrors.tuna.tsinghua.edu.cn/debian trixie main contrib non-free-firmware
deb https://mirrors.tuna.tsinghua.edu.cn/debian-security trixie-security main contrib non-free-firmware
deb https://mirrors.tuna.tsinghua.edu.cn/debian trixie-updates main contrib non-free-firmware
  1. 输入ctrl+o保存文件，再按Enter，最后输入ctrl+x退出文件编辑模式。
  2. 执行如下命令，创建并打开/etc/apt/sources.list.d/raspi.list文件（系统更新源）。
sudo nano /etc/apt/sources.list.d/raspi.list
  1. 删除/etc/apt/sources.list.d/raspi.list文件中的所有内容，并添加以下内容。
deb https://mirrors.tuna.tsinghua.edu.cn/raspberrypi trixie main
  1. 输入ctrl+o保存文件，再按Enter，最后输入ctrl+x退出文件编辑模式。
  2. 执行如下命令，下载新版本的内核。
sudo apt update && sudo apt install linux-image-rpi-v8 linux-image-rpi-2712
  1. 执行如下命令，查看已下载的内核版本，如下图所示的内核版本为6.18.45。
ls /boot/
step-8
  1. 执行如下命令，更新内核版本为6.18.45。
curl -s 'https://apt.edatec.cn/downloads/202403/kernel-change.sh' | sudo bash -s 6.18.45+rpt-rpi-2712
step-9
  • 其中6.18.45+rpt-rpi-2712是变量，针对不同的产品型号，对应的取值不同，具体说明如下表：
产品型号执行的命令
ED-HMI3120-070C
ED-HMI3010-070C
ED-HMI3020-070C
ED-HMI3120-101C
ED-HMI3630-101C
ED-HMI3010-101C
ED-HMI3020-101C		curl -s 'https://apt.edatec.cn/downloads/202403/kernel-change.sh' | sudo bash -s 6.18.X+rpt-rpi-2712
ED-HMI2120-070C
ED-HMI2220-070C
ED-HMI2002-070C
ED-HMI2020-070C
ED-HMI2120-101C
ED-HMI2630-101C
ED-HMI2220-101C
ED-HMI2002-101C
ED-HMI2020-101C		curl -s 'https://apt.edatec.cn/downloads/202403/kernel-change.sh' | sudo bash -s 6.18.X+rpt-rpi-v8
注："6.18.X"为步骤8中查询到的系统内核版本
  1. 执行如下命令，重启设备使配置生效。
sudo reboot
  1. 执行如下命令，查看系统内核版本（确定内核版本为6.18.45）。
uname -r
step-10
  1. 执行如下命令，打开/boot/firmware/config.txt文件。
sudo nano /boot/firmware/config.txt
  1. 在/boot/firmware/config.txt文件末尾[all]处根据具体的设备型号，添加对应的信息。
产品型号添加信息
ED-HMI3120-070Cdtoverlay=vc4-kms-dsi-edatec-panel-070c,i2c4,interrupt=7
ED-HMI2120-070C
ED-HMI2220-070C		dtoverlay=vc4-kms-dsi-edatec-panel-070c,interrupt=7
ED-HMI2002-070C
ED-HMI3010-070C		dtoverlay=vc4-kms-dsi-edatec-panel-070c,interrupt=2
ED-HMI2020-070Cdtoverlay=vc4-kms-dsi-edatec-panel-070c,interrupt=16
ED-HMI3020-070Cdtoverlay=vc4-kms-dsi-edatec-panel-070c,interrupt=17
ED-HMI3120-101C
ED-HMI3630-101C		dtoverlay=vc4-kms-dsi-edatec-panel-101c,i2c4,interrupt=7
ED-HMI2120-101C
ED-HMI2630-101C
ED-HMI2220-101C		dtoverlay=vc4-kms-dsi-edatec-panel-101c,interrupt=7
ED-HMI2002-101C
ED-HMI3010-101C		dtoverlay=vc4-kms-dsi-edatec-panel-101c,interrupt=2
ED-HMI2020-101Cdtoverlay=vc4-kms-dsi-edatec-panel-101c,interrupt=16
ED-HMI3020-101Cdtoverlay=vc4-kms-dsi-edatec-panel-101c,interrupt=17
  • 如下图的示例中的产品型号为ED-HMI3020-070C。
step-10
  1. 输入ctrl+o保存文件，再按Enter，最后输入ctrl+x退出文件编辑模式。
  2. 执行如下命令，重启设备使配置生效。
sudo reboot
  1. 设备正常启动后，ED-HMI的屏幕可以正常显示。

2.2.2 标准的Raspberry Pi OS（Trixie，系统内核版本为6.18.38及以上）

前提条件：

  • ED-HMI设备已正常启动，且已外接一台显示器。
  • 已确定系统内核为6.18.38以上。

操作步骤：

  1. 执行如下命令，打开/boot/firmware/config.txt文件。
sudo nano /boot/firmware/config.txt
  1. 在/boot/firmware/config.txt文件末尾[all]处根据具体的设备型号，添加对应的信息。
产品型号添加信息
ED-HMI3120-070Cdtoverlay=vc4-kms-dsi-edatec-panel-070c,i2c4,interrupt=7
ED-HMI2120-070C
ED-HMI2220-070C		dtoverlay=vc4-kms-dsi-edatec-panel-070c,interrupt=7
ED-HMI2002-070C
ED-HMI3010-070C		dtoverlay=vc4-kms-dsi-edatec-panel-070c,interrupt=2
ED-HMI2020-070Cdtoverlay=vc4-kms-dsi-edatec-panel-070c,interrupt=16
ED-HMI3020-070Cdtoverlay=vc4-kms-dsi-edatec-panel-070c,interrupt=17
ED-HMI3120-101C
ED-HMI3630-101C		dtoverlay=vc4-kms-dsi-edatec-panel-101c,i2c4,interrupt=7
ED-HMI2120-101C
ED-HMI2630-101C
ED-HMI2220-101C		dtoverlay=vc4-kms-dsi-edatec-panel-101c,interrupt=7
ED-HMI2002-101C
ED-HMI3010-101C		dtoverlay=vc4-kms-dsi-edatec-panel-101c,interrupt=2
ED-HMI2020-101Cdtoverlay=vc4-kms-dsi-edatec-panel-101c,interrupt=16
ED-HMI3020-101Cdtoverlay=vc4-kms-dsi-edatec-panel-101c,interrupt=17
step-10
  1. 输入ctrl+o保存文件，再按Enter，最后输入ctrl+x退出文件编辑模式。
  2. 执行如下命令，重启设备使配置生效。
sudo reboot
  1. 设备正常启动后，ED-HMI的屏幕可以正常显示。