.. include:: /keyword.rst =============================== |IOT-YOCTO| v25.1 - 2025 Dec 30 =============================== .. contents:: Sections :local: :depth: 1 .. _yocto-v25.1: |IOT-YOCTO| **v25.1** release supports Genio SoC families based on Yocto Scarthgap and Linux 6.6.y LTS branch. This page provides an overview of the major changes in **v25.1**. Supported Boards ================ This release introduces support for `MT8371(Genio 520/G520) `__ and `MT8391(Genio 720/G720) `__ SoC family. This release also supports the following boards based on MT8365(Genio 350/G350), MT8370(Genio 510/G510), MT8390(Genio 700/G700), MT8395(Genio 1200/G1200) MediaTek SoC families. .. list-table:: :header-rows: 1 * - Board Name - :ref:`MACHINE name for bitbake ` * - :doc:`Genio 350-EVK(P1V3) ` - * ``genio-350-evk`` * - :doc:`Genio 510-EVK(P1V2) ` - * ``genio-510-evk`` * - :doc:`Genio 700-EVK(P1V4) ` - * ``genio-700-evk`` * - :doc:`Genio 520/720-EVK(P2V3) ` :bdg-primary:`NEW` - * ``genio-720-evk-ufs`` (UFS boot) * ``genio-720-evk-norboot-ufs`` (SPI NOR flash boot, UFS as system storage) * ``genio-720-evk`` (EMMC boot) Note: Genio 520 EVK shares the same MACHINE configuration as Genio 720 EVK (``genio-720-*``). * - :doc:`Genio 1200-EVK(P1V2) ` - * ``genio-1200-evk`` (EMMC boot) * ``genio-1200-evk-ufs`` (UFS boot) .. _feature_table_v25.1: Supported Software Features & Specs =================================== Please go to `IoT Yocto Feature Table (v25.1) `_ to check the software support status for the |IOT-YOCTO| v25.1 release. You may find the following materials in this document: * Feature Table: Supported software feature list of IoT Yocto for each platform * Bootloader Driver: Supported drivers for each boot stage * Build Flavor: Supported build flavors and included packages * Specification: Supported software specifications for USB, Display, Video-in (Camera, HDMI-RX), Video Codecs, MDP (multimedia data format converter and resizer), JPEG, Audio, Wi-Fi and Bluetooth * Benchmark Suites: Supported benchmark tools and their versions * Stress Suite: Supported stress tools and their versions * Suspend & Resume Table: Suspend and resume behavior of each driver * DTBO List: List of DTBO (Device Tree Blob Overlay) * Bin & License Release Modules: List of proprietary modules and their licenses .. figure:: /_asset/sw_yocto_release-notes_feature-table_v25.1.jpg :target: https://download.mediatek.com/aiot/download/release-note/v25.1/v25.1_IoT_Yocto_Scarthgap_Feature_Table_v1.0.pdf :align: center :width: 65% A Segment of IoT Yocto Feature Table (v25.1) .. _prebuilt-image-download-v25.1: Prebuilt Images Download ======================== As part of the IoT Yocto v25.1 release, the following prebuilt images are provided for evaluation and debugging purposes. They are not suitable for production use. Demo Images ----------- These demo images are built from the ``rity-demo-image`` recipe using the private (``NDA_BUILD=1``) configuration. They are configured to help you evaluate, debug, and develop your own product images. These images are not suitable for production use, as they have various debugging options enabled. .. csv-table:: :header: "Board", "Boot Config", "Download Link", "MD5 Checksum" :widths: 15, 10, 20, 8 :align: left ":doc:`G1200-EVK(P1V2) `", "eMMC boot", "`⬇️ genio-1200-evk_private_251230072807.tar.gz `__", "28d3b65191c0d0f71c4627e4e1202c5d" ":doc:`G1200-EVK(P1V2) `", "UFS boot", "`⬇️ genio-1200-evk-ufs_private_251230074106.tar.gz `__", "b10457d627f44e00d6ab09a7dfc7801f" ":doc:`G350-EVK(P1V3) `", "eMMC boot", "`⬇️ genio-350-evk_private_251230070905.tar.gz `__", "a4368d4fd6fc23002f016d9aa11eac4b" ":doc:`G510-EVK(P1V2) `", "eMMC boot", "`⬇️ genio-510-evk_private_251230071517.tar.gz `__", "06bd62d8dd31874efcea2f7419dfcb2b" ":doc:`G520-EVK/G720-EVK(P2V3) `", "eMMC boot", "`⬇️ genio-720-evk_private_251230074423.tar.gz `__", "b843dbe74d1a3f6377b66de8f23f7158" ":doc:`G520-EVK/G720-EVK(P2V3) `", "SPI NOR boot to UFS storage", "`⬇️ genio-720-evk-norboot-ufs_private_251230080952.tar.gz `__", "78ce758af037a46b8291df6126e4e8e8" ":doc:`G520-EVK/G720-EVK(P2V3) `", "UFS boot", "`⬇️ genio-720-evk-ufs_private_251230075712.tar.gz `__", "4bff81fa363684ae457a55ff680d2a10" ":doc:`G700-EVK(P1V4) `", "eMMC boot", "`⬇️ genio-700-evk_private_251230070517.tar.gz `__", "ce22db1f5d2018328efee52448932a7e" Browser Images -------------- These images are built from the ``rity-browser-image`` recipe with :doc:`Chromium browser ` installed and with the private (``NDA_BUILD=1``) configuration enabled. They are configured to help you evaluate, debug, and develop your own product images. These images are not suitable for production use, as they have various debugging options enabled. .. csv-table:: :header: "Board", "Boot Config", "Download Link", "MD5 Checksum" :widths: 15, 10, 25, 8 :align: left ":doc:`G1200-EVK(P1V2) `", "eMMC boot", "`⬇️ genio-1200-evk_private_251230075345_browser.tar.gz `__", "6d759f904e4205829255f866437c715d" ":doc:`G520-EVK/G720-EVK(P2V3) `", "UFS boot", "`⬇️ genio-720-evk-ufs_private_251230082240_browser.tar.gz `__", "903ccab3608795c1f092b51f6a0d11b1" ":doc:`G700-EVK(P1V4) `", "eMMC boot", "`⬇️ genio-700-evk_private_251230072154_browser.tar.gz `__", "fe88b982236fd52e1c77350647f2930c" Public & Private Build Configuration ------------------------------------ |IOT-YOCTO| has a configuration ``NDA_BUILD`` that controls if the recipe fetches software from access-controlled "private" repositories. These private repositories are located under the https://gitlab.com/mediatek/aiot/nda URL namespace, hence the name NDA_BUILD. All the prebuilt images provided in this v25.1 release are built using ``NDA_BUILD = "1"`` configuration. These images are also referred as private build images. By setting ``NDA_BUILD = "0"``, you could still build an IoT Yocto image with packages that are available without explicit access permissions to the `GitLab NDA namespace `__. We call this a public build image. In the public build configuration, some proprietary components are provided in binary-only format, and certain proprietary features are excluded, for example: - Security features are excluded, e.g. - eFuse writer and custom data field access - RPMB access API - ISP for RAW sensors and YUV sensors support on Genio 510, Genio 700 and Genio 1200 are excluded. Starting from v24.0 release, we no longer provide prebuilt public images for download and evaluation, as their features are a subset of the private images. The public build configuration is still supported, so developers can build images themselves using the ``NDA_BUILD = "0"`` configuration. You may find the NDA features, binary-released modules and their licensing in :ref:`IoT Yocto Feature Table (v25.1) `. .. note:: - You don't need a GitLab account to download the prebuilt images, but you need to agree to the :ref:`Software License Agreement `. - You don't need a GitLab account to build the public image configurations. - You need a GitLab account and contracts with MediaTek to access and build the private image. Source Code Download ==================== .. important:: Please read and agree to the :ref:`Software License Agreement ` before accessing or using |IOT-YOCTO| software. If you do not agree to the terms and conditions of the :ref:`Software License Agreement `, you must not access or use the software. To download and build |IOT-YOCTO| recipes, please use the ``rity-scarthgap-v25.1`` tag for the repo manifest file: .. prompt:: bash $ auto $ repo init -u https://gitlab.com/mediatek/aiot/bsp/manifest.git -b refs/tags/rity-scarthgap-v25.1 To fetch source code and build images using these Yocto recipes, please refer to steps in :doc:`/sw/yocto/get-started/build-code`. Tools ===== `Genio Tools v1.7 `__ is released to support |soc-mt8371| and |soc-mt8391| in addition to previously supported Genio SoCs. Please update Genio Tools to load built images to |G520-G720-EVK| boards. Please refer to :doc:`/sw/yocto/get-started` and :doc:`/tools/genio-tools` for detailed usage. Major Software Package Versions =============================== * Yocto LTS updated from Scarthgap 5.0.8 to 5.0.12 * Linux kernel updated from 6.6.37 to 6.6.92 * ATF version kept at v2.6 * U-Boot version kept at v2022.10 * OP-TEE version kept at 3.19 * Mali GPU DDK version kept at r48 Major Changes ============= Genio 520 and Genio 720 Support ------------------------------- IoT Yocto v25.1 introduces support for |soc-mt8371| and |soc-mt8391|, with the following notable features: - **Shared BSP** - The Genio 520 and Genio 720 SoCs are pin-to-pin compatible. In addition, the Genio 720 BSP is also compatible with Genio 520. As a result, both |G520-G720-EVK| share the same ``MACHINE`` configuration in the IoT Yocto recipes in ``meta-mediatek-bsp``. - **Automatic DRAM size detection** - Genio 520 and Genio 720 support both LP4X and LP5(X) DRAM. The BSP bootloader supports runtime detection of DRAM type and size, making it possible to reuse the same bootloader binary across different board designs with varying DRAM sizes and types. - **Multiple boot storage options** - |G520-G720-EVK| can be configured to boot from UFS, eMMC, or serial NOR flash. While the BSP drivers are shared, separate binary images must be built for each boot storage option. This is due to differences in bootloader headers and storage block sizes. There are some limitations and known issues regarding the support for Genio 520 and 720: - **DPoC** on Genio 520/720 is not supported in this release. - DisplayPort and eDP output are supported. While the Type-C PD functions are supported, DisplayPort alt mode and full support for DPoC are still under development. - Note that Genio 520/720 SoC do not have **HDMI** display interface. Please visit `Genio Developer Center `__ and download data sheet for a complete list of SoC hardware features. - The team plans to provide DPoC support for |G520-G720-EVK| in the upcoming v25.1.1 release. - **ISP** on Genio 520/720 is not supported in this release. - While the MIPI-CSI interface on Genio 520/720 supports IMX258 RAW sensor data transfer, the ISP hardware pipeline is not supported. - **Boot logo** and bootloader display driver on Genio 520/720 are not supported in this release. For details, please refer to the :ref:`feature table` document. General BSP Feature Changes --------------------------- v25.1 also brings updates to other Genio SoCs, EVKs, and some software features: * New or Updated Features - **EBBR** boot flow is now supported on |G520-G720-EVK| using serial NOR as boot storage. - **ONNX Runtime** is now integrated into IoT Yocto: - ONNX Runtime runs on CPU on Genio 510/700/1200. - ONNX Runtime supports NPU hardware acceleration on Genio 520/720. - CANBUS bridge **MCP2518** on Genio 1200 EVK and |G520-G720-EVK| is re-enabled in this release. - (3rd Party) **Chromium browser** is re-enabled in this release. Also: - Chromium updated from 132.0.6834.6 to 138.0.7204.293. - Chromium browser now integrates with PipeWire framework. - (3rd Party) SerDes **MAX96724** EVK support is integrated in this release. - (3rd Party) **ASIX ax88179** Gigabit Ethernet driver is integrated in this release. * EOL Features - **ncc-tflite**: The on-device Neuron SDK compiler ``ncc-tflite`` is now deprecated and removed from IoT Yocto images. We encourage customers to use the ``ncc-tflite`` compiler running on Ubuntu OS(x86_64). * Developing Features - **UVC Gadget** is not supported in v25.1 release. - **Ethernet TSN** is not verified in v25.1 release. * Out of Scope Features - IoT Yocto does not provide an out-of-box battery management and charging control framework. Since battery management policies are highly application scenario oriented, we encourage customers to adopt 3rd party battery charging solutions. - While ONNX runtime is supported in this release, the full-scale ONNX framework is not. Notable Known Issues ==================== * [AUTO00769395][Audio][DPoC] Noise on speaker-test after re-connecting to different DPoC monitors * [AUTO00771343][Genio510] MAX9286 may fail to open under rapid close and re-open scenario * [AUTO00773839][Display] DRM overlay plane content offset with negative plane coordinates