1 Overview

This section describes the background and scope of using Ubuntu on the ED-HMI3010 series.

  • Background

    The ED-HMI3010 series products are shipped with an operating system with BSP installed by default, which has added support for BSP, created users, enabled SSH, and supported BSP online upgrade, and has security and reliability, so users can use this operating system with confidence.

    If you want to use Ubuntu after receiving the product and change the operating system to Ubuntu, some of the functions cannot be used (LCD screen does not display). In order to solve this problem, our company supports online installation of Firmware package to make ED-HMI3010 series more compatible with Ubuntu, and ensure that all functions can be used. At present, we support Ubuntu system by installing kernel and firmware package online to realize the support of Ubuntu.

  • Scope of Application

    This application is applicable to ED-HMI3010-070C and ED-HMI3010-101C.

ProductSoftware
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 Application Guide

This section describes the operation procedures for using the standard Raspberry Pi OS on ED-HMI3010 series products.

2.1 Operation Procedure

  • SD card flash
  • First boot configuration
  • Install Kernel package
  • Install the Firmware package.
  • Check if the Firmware package is installed successfully
  • Reboot the device

2.2 SD card flash

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

Prerequisites:

  • The download and installation of the flash tool to a Windows PC has been completed.
  • An SD card has been prepared.
  • A card reader has been prepared.

Operating Procedures:

The operation steps are illustrated with the Windown system as an example.

  1. Insert the SD card into the card reader, and 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 pane.

image-20241224175135571
  1. Select the Ubuntu image you want to flash and click "Open".
image-20241224175213615

  1. Select "Ubuntu Desktop 24.04 LTS (64-bit) (or Ubuntu Desktop 23.10 (64-bit)" in the pop-up pane. 5. Click "CHOOSE STORAGE" and select the SD card you want to burn in the memory card screen.

  2. Click "CHOOSE STORAGE", select the SD card to be flashed in the memory card screen, and return to the flash screen.

image-20241224175422265
  1. Click "NEXT" and select "NO" in the popup box.
image-20241224175810254
  1. Select "YES" in the popup box.
image-20241224175905749
  1. Enter the user password in the pop-up dialog box and click Authenticate to confirm.
image-20241224175936852
  1. Start flashing the image.
image-20241224180354884
  1. When the image write is complete, the file is verified.
image-20241224181134573
  1. Verification is complete, the pop-up "burning success" prompt box, click "CONTINUE" to complete the flash.
image-20241224181152173

  1. Close the Raspberry Pi Imager and remove the card reader.

  2. Stick the SD card into the ED-HMI3010 and re-power it up again

2.3 First time boot configuration

This section describes how to configure the system for the first time.

2.3.1 Ubuntu Desktop 23.10 LTS (64-bit)

Flash Ubuntu Desktop 23.10 LTS (64-bit) image, the initialization configuration needs to be completed when the system is booted for the first time.

Prerequisites:

  • A working monitor (with HDMI connector), mouse, keyboard, and power adapter have been obtained.
  • A functioning HDMI cable has been obtained.

Procedures:

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

  2. Power on the device, the system will start to boot, after the normal startup pop-up "System Configuration", select the language you need.

image-20240719161925222
  1. Click "Continue" and select the keyboard layout in the pop-up pane.
image-20240719161937028
  1. Click on the area and click "Continue".
image-20240719114448500
  1. Set the user name and password, check "Log in automatically" and click "Continue".
image-20240719162058039
  1. System configuration in progress.
image-20240719162112580
  1. The system automatically enters the desktop when configuration is complete.

2.3.2 Ubuntu Desktop 24.04 LTS (64-bit)

To flash the Ubuntu Desktop 24.04 LTS (64-bit) image, the initial configuration needs to be completed when the system boots for the first time.

Prerequisites:

  • A working monitor (with HDMI port), mouse, keyboard, and power adapter have been obtained.
  • A functioning HDMI cable has been obtained.

Procedures:

  1. Disconnect the device's network cable, connect the monitor through the HDMI cable, and connect the mouse, keyboard, and power adapter.

  2. Power on the device, the system will start booting, after normal booting pop-up "System Configuration", select your desired language.

image-20240719114338625
  1. Click "Continue" and select the keyboard layout in the pop-up pane.
image-20240719114422838
  1. Click "Continue" in the pop-up pane to skip the WIFI connection.
image-20240719114439884
  1. Click on the area and click "Continue".
image-20240719114448500
  1. Set the user name and password, check "Log in automatically" and click "Continue".
image-20240719114458517
  1. In system configuration.
image-20240719114612457
  1. The system automatically enters the desktop when configuration is complete.

2.4 Installing Firmware Packages

This section describes how to install Firmware package on Ubuntu. You can configure the system to work properly by downloading and installing linux packages, downloading and installing firmware packages, and disabling raspberry kernel updates after flashing the corresponding Ubuntu23.10 or Ubuntu24.04 image on ED-HMI3010 series.

Prerequisites:

Have completed the flash and boot configuration of the Ubuntu image.

Operation steps: 1.

  1. Download the corresponding linux packages and firmware packages.
TypeMecessaryOptional
linux deb 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 		linux-headers-6.8.0-1005-raspi_6.8.0-1005.5+ed_arm64.deb
linux-raspi-headers-6.8.0-1005_6.8.0-1005.5+ed_arm64.deb
firmware deb ed-hmi3010-070c-ubuntu-firmware_1.20240612.2_arm64.deb
ed-hmi3010-101c-ubuntu-firmware_1.20240612.1_arm64.deb
  1. Open a terminal and execute the following command to install the linux package
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 need to be recompiled for driver module needs to be installed;

  1. Execute 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. Execute the following command to install the firmware package
  • 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. Turn off the power, disconnect the power, unplug the HDMI cable, and re-power on the power.