Report Issues

Before submitting issues, we recommend a high-level triage so that your issues can be effectively diagnosed.

In Ubuntu on Genio,

  • Canonical publishes and maintains Ubuntu.

  • Canonical maintains the Ubuntu Linux kernel.

  • Canonical maintains the Ubuntu archive.

  • MediaTek provides bootloader and firmware for Genio EVKs.

  • MediaTek provides installable Genio packages to enable Genio SoC for Ubuntu.

  • Developers and users may install additional third-party packages.

Therefore,

  • Ubuntu bugs and issues should be directed toward Canonical’s Ubuntu support channels.

  • All the non-MediaTek hardware-related issues should be submitted to the Ubuntu community or Canonical:

    • If you have a commercial project with Canonical, you should report issues to Canonical via Launchpad.

    • If you do not have a commercial project with Canonical, you might want to reach out to the Ubuntu community

  • Issues related to third-party software that are additionally installed should be supported by its maintainers or resellers.

  • Genio bootloader, firmware, and Genio package issues should be directed toward MediaTek.

The following sections provide further details reporting bootloader, firmware and Genio package issues to MediaTek.

MediaTek On-Line

Please report bootloader, firmware and Genio package issues via MediaTek On-Line.

If you do not currently possess a MediaTek Online account, it is likely that your company or team has not yet become a licensee of the MediaTek Genio platform.

In such a situation, we recommend reaching out to the following entities to initiate the process of becoming a licensee of the MediaTek Genio platform:

Report Issues on MediaTek On-Line

If you are a customer of MediaTek and you think the issue is caused by

  • MediaTek bootloader,

  • MediaTek Genio SoC firmware, or

  • Genio packages,

please submit your issues via MediaTek On-Line.

The kernel driver issues require further clarification:

  • If the issue is caused by Ubuntu Linux kernel driver, please report kernel issues to Canonical, the maintainer of Ubuntu Linux kernel.

  • If the issue is also reproducible on official releases of IoT Yocto , please report issues to MediaTek, which maintains IoT Yocto Linux kernel.

Although most of the Genio SoC hardware drivers in the Ubuntu Linux kernel are derived from the driver implementation in MediaTek IoT Yocto , MediaTek does not maintain the Ubuntu Linux kernel and does not maintain the userland programs such as Gnome desktop.

As a result, driver issues that are reproduced using IoT Yocto can be analyzed more effectively by MediaTek, and will be prioritized by the MediaTek team.

When reporting issues via MediaTek Online, please describe your problem and background context with the following information:

1. Genio EVK Model

We strongly recommend customers report issues based on official Genio EVK models, since problems that are reproducible with Genio EVKs can be investigated much more effectively and efficiently.

Currently, these EVK models are supported:

  • Genio 350 EVK

  • Genio 510 EVK

  • Genio 700 EVK

  • Genio 1200 EVK

Please provide the full model name on the EVK board, e.g. AIoT-Genio 700-EVK-P1V2.

Along with the EVK model, please provide the official image version used to reproduce the issue.

If the problem is only reproducible with your hardware design, we suggest you provide relevant information on design differences to make further issue investigation feasible.

2. Version Info

When reporting issues, please provide the version info of the relevant components so the problem could be effectively identified.

IoT Yocto

If the issue is reproducible using IoT Yocto, please provide the version string of the IoT Yocto image that can be used to reproduce the issue. It should have the following format:

Yocto.<Year>.<Quarter>(.<ver>)

For example, Yocto.23.0.1 or Yocto.23.1.

Bootloader Firmware

If the issue is related to bootloader firmware, please report the boot firmware (board asset) archive name, such as:

  • baoshan-g1200-evk-boot-assets-x01-20231005-133.tar.xz

  • ubuntu-board-assets-genio-1200-evk-v23.1.2.tar.gz

Genio Packages

If the issue is released to a package installed from the MediaTek Genio PPA , Please provide the version info of the MediaTek Genio package. You could obtain the package version info with dpkg -s <genio-package-name>:

dpkg -s linux-firmware-mediatek-genio | grep Version
Version: 3-3-0ubuntu1mtk1

Ubuntu Image & Ubuntu Kernel

If the issue can only be reproduced on Ubuntu and Ubuntu kernel, and it is related to Genio SoC firmware, Please provide the Ubuntu version info.

The Ubuntu version string should follow the format below:

Ubuntu-<family>-<lsb_release>-<uname>

For example,

Ubuntu-Desktop-22.04.3-5.15.0-1025-mtk

The <Family> are Ubuntu releases, it should be one of:

  • Desktop

  • Server

The lsb_release string should be obtained by providing the version string of lsb_release -d -s command. For example,

lsb_release -d -s
Ubuntu 22.04.3 LTS

The lsb_release string in the case above is 22.04.3

The uname string should be the output of uname -r command:

uname -r
5.15.0-1025-mtk

3. Reproduce Steps and Logs

Please provide the steps to configure the hardware and the inputs or commands that can reproduce the issue.

When reporting firmware or kernel related issues, it is very helpful to provide the following logs:

  • Boot firmware output logs captured from UART0 port.

  • Kernel Logs

  • Relevant system service logs

You can capture kernel log in the current boot with sudo dmesg.

you can also capture kernel log with system log using journalctl, but please keep in mind that journalctl logs may persist across reboots, so you need might need to filter the logs first. Please refer to the journal manual page for details.

Report Ubuntu Linux Certification and Integration Issues

If you have a project with Canonical, you should report project-specific Ubuntu issues via Launchpad.net:

You should obtain the project id <your-project> from Canonical representativies.

Report Other Ubuntu Linux Issues

If you do not have a project with Canonical regarding Ubuntu on Genio, you might want to find community support on

For example,

  • The issue is caused related to a software package that is part of the Ubuntu archive, e.g. Firefox, Genome Desktop, …

  • You want to change or update a Ubuntu Desktop behavior.

  • You want to alter the behavior in the Ubuntu Server release.

If you believe that you’ve found an issue in Ubuntu Linux and you’d like to report it, please refer to Ubuntu documentation to report bugs and issues:

If the problem is related to a 3rd party package, please contact the seller or maintainer of the software package since neither MediaTek nor Canonical could analyze and fix issues caused by 3rd party software.