============= 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: * `MediaTek IoT VAR(Value-Add Reseller) and Distributors `__ 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: .. code-block:: text Yocto..(.) 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 ``: .. prompt:: bash $ auto $ 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: .. code-block:: text Ubuntu--- For example, .. code-block:: text Ubuntu-Desktop-22.04.3-5.15.0-1025-mtk The ```` 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, .. prompt:: bash $ auto $ 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: .. prompt:: bash $ auto $ 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: * https://bugs.launchpad.net/ You should obtain the project id ```` 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 * `Ubuntu community forum `__ * `Ask Ubuntu `__ 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: * https://help.ubuntu.com/stable/ubuntu-help/report-ubuntu-bug.html.en * https://help.ubuntu.com/community/ReportingBugs 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.