Using 7-inch and 10.1-inch ED-HMI on Standard Raspberry Pi OS (Trixie)

1 Overview

Introduces the background and scope of using 7-inch and 10.1-inch ED-HMI products on standard Raspberry Pi OS (Trixie).

1.1 Background

EDATEC's 7-inch and 10.1-inch ED-HMI products now support native drivers on standard Raspberry Pi OS (Trixie). When the system kernel version is 6.18.38 or higher, users only need to directly modify the config.txt configuration file to enable the LCD display and make it work properly, without the need to install additional EDATEC BSP packages. This improvement significantly broadens the application scenarios of ED-HMI, allowing it to more flexibly meet the diverse needs of different users.

1.2 Scope of Application

This application applies to all 7-inch and 10.1-inch ED-HMI products from EDATEC. The compatible OS versions and corresponding product models are as follows:

Software ScopeProduct Models
Standard Raspberry Pi OS (Trixie, kernel version 6.18.38 or higher)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 Application Guide

Describes the specific operations for using 7-inch and 10.1-inch ED-HMI products on standard Raspberry Pi OS (Trixie).

2.1 Check System Kernel Version

Preparation:

  • Standard Raspberry Pi OS (Trixie) has been successfully flashed to ED-HMI.
  • The ED-HMI device has started normally and an external monitor is connected.

Steps:

  1. Open a terminal window on the device and execute the following command to check the current system kernel version.
uname -r
  1. Check the output to determine if the system kernel version is 6.18.38 or higher.
  • If the output shows 6.18.38+rpt-rpi-v8 or 6.18.39+rpt-rpi-v8, it means the system kernel is 6.18.38 or higher.
  • If the output shows 6.18.34+rpt-rpi-v8 or shows a lower version number, it means the system kernel is below 6.18.38.

2.2 Configuration Instructions

Different system kernel versions correspond to different operation methods, which are described separately below.

2.2.1 Standard Raspberry Pi OS (Trixie, Kernel Version Below 6.18.38)

Preparation:

  • The ED-HMI device has started normally and an external monitor is connected.
  • It has been confirmed that the system kernel version is below 6.18.38.

Steps:

  1. Execute the following command to download the new kernel version.
sudo apt update && sudo apt install linux-image-rpi-v8 linux-image-rpi-2712
  1. Execute the following command to view the downloaded kernel version. The kernel version shown in the image below is 6.18.45.
ls /boot/
step-8
  1. Execute the following command to update the kernel version to 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
  • Where 6.18.45+rpt-rpi-2712 is a variable. Different product models have different corresponding values, as detailed in the table below:
Product ModelCommand
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
Note: "6.18.X" refers to the system kernel version queried in step 2.
  1. Execute the following command to restart the device and apply the configuration.
sudo reboot
  1. Execute the following command to check the system kernel version (confirm the kernel version is 6.18.45).
uname -r
step-10
  1. Execute the following command to open the /boot/firmware/config.txt file.
sudo nano /boot/firmware/config.txt
  1. At the end of the /boot/firmware/config.txt file under [all], add the corresponding information according to the specific device model.
Product ModelInformation to Add
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
  • The example in the image below shows the product model ED-HMI3020-070C.
step-10
  1. Press Ctrl+O to save the file, then press Enter, and finally press Ctrl+X to exit the file editing mode.
  2. Execute the following command to restart the device and apply the configuration.
sudo reboot
  1. After the device starts normally, the ED-HMI screen will display correctly.

2.2.2 Standard Raspberry Pi OS (Trixie, Kernel Version 6.18.38 or Higher)

Preparation:

  • The ED-HMI device has started normally and an external monitor is connected.
  • It has been confirmed that the system kernel is 6.18.38 or higher.

Steps:

  1. Execute the following command to open the /boot/firmware/config.txt file.
sudo nano /boot/firmware/config.txt
  1. At the end of the /boot/firmware/config.txt file under [all], add the corresponding information according to the specific device model.
Product ModelInformation to Add
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. Press Ctrl+O to save the file, then press Enter, and finally press Ctrl+X to exit the file editing mode.
  2. Execute the following command to restart the device and apply the configuration.
sudo reboot
  1. After the device starts normally, the ED-HMI screen will display correctly.