1 Overview

This document introduces the background and scope of using Ubuntu on the ED-HMI3020 series.

  • Background

    The ED-HMI3020 series products come with an operating system that includes BSP (Board Support Package) pre-installed. It has added BSP support, created default users, enabled SSH, and supports BSP online upgrades, ensuring safety and reliability. Users can confidently use this operating system.

    If users wish to use Ubuntu after receiving the product, switching the operating system to Ubuntu may cause some features to become unavailable (e.g., the LCD screen not displaying). To solve this problem, we support the installation of firmware packages online, making the ED-HMI3020 series more compatible with Ubuntu and ensuring that all features work properly. Currently, we support the installation of kernel and firmware packages on Ubuntu for this purpose.

  • Scope

    This document applies to the ED-HMI3020-070C and ED-HMI3020-101C models.

Product ModelSoftware Scope
ED-HMI3020-070C Ubuntu Desktop 24.04 LTS (64-bit)
Ubuntu Desktop 23.10 (64-bit)
ED-HMI3020-101C

2 Application Guide

This section introduces the steps for using the standard Raspberry Pi OS on the ED-HMI3020 series.

2.1 Procedure

  • SD Card Flashing
  • Initial Setup Configuration
  • Install Kernel Package
  • Install Firmware Package
  • Check Firmware Installation Success
  • Reboot Device

2.2 SD Card Flashing

Raspberry Pi Imager: https://downloads.raspberrypi.org/imager/imager_latest.exe

Prerequisites:

  • The flashing tool has been downloaded and installed on a Windows computer.
  • An SD card is available.
  • A card reader is available.

Steps:

The following steps are provided using a Windows system as an example.

  1. Insert the SD card into the card reader, then insert the card reader into the computer.

  2. Open Raspberry Pi Imager, click "CHOOSE OS," and select "Other general-purpose OS" in the pop-up window.

image-20240719105743556
  1. In the pop-up window, select "Ubuntu."
image-20240719105755335
  1. In the pop-up window, select "Ubuntu Desktop 24.04 LTS (64-bit)" (or "Ubuntu Desktop 23.10 (64-bit)").
image-20240719105803488
  1. Click "CHOOSE STORAGE," select the SD card in the storage interface, and return to the flashing screen.
image-20240719105824492
  1. Click "NEXT," and select "YES" in the pop-up prompt.
image-20240719105832882
  1. Start writing the image.
image-20240719105841254
  1. Once the image is written, the files will be verified.
image-20240719105849929
  1. After verification, a "Write Successful" prompt will appear. Click "CONTINUE" to complete.
image-20240719105911122
  1. Close Raspberry Pi Imager and remove the card reader.
  2. Insert the SD card into the ED-HMI3020 and power on the device again.

2.3 Initial Setup Configuration

Guidance for configuring the system during the first startup on the ED-HMI3020 series.

2.3.1 Ubuntu Desktop 23.10 LTS (64-bit)

When flashing the Ubuntu Desktop 23.10 LTS (64-bit) image, the system requires initial configuration during the first startup.

Prerequisites:

  • A working monitor (with HDMI interface), mouse, keyboard, and power adapter are available.
  • A working HDMI cable is available.

Steps:

  1. Disconnect the network cable, connect the monitor via HDMI, and connect the mouse, keyboard, and power adapter.

  2. Power on the device, and the system will start. Once booted, "System Configuration" will pop up, allowing you to choose your language.

image-20240719161925222
  1. Click "Continue," and in the pop-up window, select your keyboard layout.
image-20240719161937028
  1. Click your location, then click "Continue."
image-20240719114448500
  1. Set the username and password, select "Log in automatically," then click "Continue."
image-20240719162058039
  1. System configuration in progress.
image-20240719162112580
  1. After configuration, the system will automatically enter the desktop.

2.3.2 Ubuntu Desktop 24.04 LTS (64-bit)

When flashing the Ubuntu Desktop 24.04 LTS (64-bit) image, the system requires initial configuration during the first startup.

Prerequisites:

  • A working monitor (with HDMI interface), mouse, keyboard, and power adapter are available.
  • A working HDMI cable is available.

Steps:

  1. Disconnect the network cable, connect the monitor via HDMI, and connect the mouse, keyboard, and power adapter.

  2. Power on the device, and the system will start. Once booted, "System Configuration" will pop up, allowing you to choose your language.

image-20240719114338625
  1. Click "Continue," and in the pop-up window, select your keyboard layout.
image-20240719114422838
  1. Click "Continue," and in the pop-up window, click "Continue" to skip the WiFi connection.
image-20240719114439884
  1. Click your location, then click "Continue."
image-20240719114448500
  1. Set the username and password, select "Log in automatically," then click "Continue."
image-20240719114458517
  1. System configuration in progress.
image-20240719114612457
  1. After configuration, the system will automatically enter the desktop.

2.4 Install Firmware Package

Guide for installing firmware packages on standard Raspberry Pi OS, compatible with Raspberry Pi OS (bookworm). After flashing the bookworm image to the ED-HMI3020 series, you can configure the system by adding the edatec apt source, installing kernel packages, firmware packages, and disabling Raspberry Pi kernel updates to ensure the system functions properly.

Prerequisites:

  • The Ubuntu image has been flashed and the initial configuration is complete.

Steps:

  1. Download the corresponding Linux packages and ED-HMI packages.
Linux PackagesFirmware Packages
linux-image-6.8.0-1005-raspi_6.8.0-1005.5+ed_arm64.deb (required)
linux-modules-6.8.0-1005-raspi_6.8.0-1005.5+ed_arm64.deb (required)
linux-headers-6.8.0-1005-raspi_6.8.0-1005.5+ed_arm64.deb (optional)
linux-raspi-headers-6.8.0-1005_6.8.0-1005.5+ed_arm64.deb (optional) 		ed-hmi3020-070c-ubuntu-firmware_1.20240612.2_arm64.deb
ed-hmi3020-101c-ubuntu-firmware_1.20240612.1_arm64.deb
  1. Open the terminal and run the following command to install the Linux packages
sudo dpkg -i linux*6.8.0-1005*.deb
image-20240719145324981

TIP

linux-image-6.8.0-1005-raspi_6.8.0-1005.5+ed_arm64.deb and linux-modules-6.8.0-1005-raspi_6.8.0-1005.5+ed_arm64.deb are required
linux-headers-6.8.0-1005-raspi_6.8.0-1005.5+ed_arm64.deb and linux-raspi-headers-6.8.0-1005_6.8.0-1005.5+ed_arm64.deb are optional and only needed if you need to recompile driver modules.

  1. Run the following command to disable Ubuntu kernel updates
sudo dpkg -l | grep linux-image | awk '{print $2}' | grep ^linux | while read line; do sudo apt-mark hold $line; done
image-20240719145342211
  1. Run the following command to install the firmware package
  • ED-HMI3020-070C
sudo dpkg -i ed-hmi3020-070c-ubuntu-firmware_1.20240612.2_arm64.deb
image-20240719145813630
  • ED-HMI3020-101C
sudo dpkg -i ed-hmi3020-101c-ubuntu-firmware_1.20240612.1_arm64.deb
image-20240719145824014
  1. Shut down, disconnect the power, unplug the HDMI cable, and power on again.