.. include:: /keyword.rst

================================
|IOT-YOCTO| v22.1 - 2022 Aug 03
================================

.. _yocto-v22.1:

|IOT-YOCTO| v22.1 release provides two hardware configurations supported by separate software configurations:

- :ref:`Genio 1200 <soc-mt8395>` lands on Linux Kernel 5.15 (``mtk-v5.15-dev``) and Yocto Kirkstone.
- :ref:`Genio 350 <soc-mt8365>` is supported by Linux Kernel 5.10 (``mtk-v5.10``) and Yocto Dunfell, same as the previous release.

We plan to upgrade the support for Genio 350 to Kernel 5.15 and Yocto Kirkstone in future releases.

.. contents:: Sections
    :local:
    :depth: 1

Supported Hardware
==================

This release supports following boards based on MT8365(Genio 350) and MT8395(Genio 1200) MediaTek SoC families:

* :doc:`Genio 350-EVK </hw/i350-evk>`
* Genio 1200-Demo Board (deprecated in v23.1)

Notable New Features and Changes in v22.1
=========================================

- MT8395 SoC and |i1200-DEMO| board support on Linux kernel version 5.15, notably:

    - AI Processor Unit (APU) support through MediaTek Neuron SDK for MT8395
    - Hardware video decoder and encoder support for MT8395
    - HDMI & DisplayPort support for MT8395
    - Wi-Fi & Bluetooth connectivity with external M.2 MT7921 PCIe module (AzureWave AW-XB468NF) for |i1200-DEMO| board

- In this release, the template configuration is builds **Public** images that skips access controlled repositories. Please update the NDA_BUILD config if you have access to proprietary source packages.

Prebuilt Images
===============

.. csv-table:: 
    :header: "Board", "Prebuilt Image", "MD5 Checksum"
    :widths: 8, 20, 10
    :align: left
    
    ":doc:`Genio 350-EVK </hw/i350-evk>`", "`download private image <https://download.mediatek.com/aiot/page/download.html?Code=dunfell_k5.10_v22.1_i350-evk_private_220801082311&Mes=type1>`__", ``7ba00c50b4eb5482dc66fe887a4d732c``
    ":doc:`Genio 350-EVK </hw/i350-evk>`", "`download public image <https://download.mediatek.com/aiot/page/download.html?Code=dunfell_k5.10_v22.1_i350-evk_public_220801082651&Mes=type1>`__", ``3a56f9cbafeb8285856662833c8ce3c8``


Public & Private Prebuilt Images
--------------------------------

|IOT-YOCTO| v22.1 is available in two different packages groups:

- You don't need a GitLab account to download both private and public prebuilt images, but you need to agree to the :ref:`AIoT Software License Agreement <license-ref>`.
- You don't need a GitLab account to build the public image configurations.
- You need a GitLab account and contracts to MediaTek to access and build the private image.

**Public** images are built with packages that are available without access permissions to AIoT GitLab group. This lacks some proprietary features and also some proprietary components are provided in binary-only format.

**Private** images, on the other hand, requires access to private repositories in AIoT GitLab group. In this release, the private image provides these additional features on top of the public configuration:

    - Xtensa-ANN support on |i350-EVK|
    - Neuron SDK support on |i1200-DEMO|
    - MT7663 proprietary Wi-Fi driver on |i350-EVK|
    - eFuse writer

Software Packages
=================

.. important:: 

	Please read and agree :ref:`AIoT Software License Agreement <license-ref>` before accessing or using |IOT-YOCTO| software.
	If you do not agree to the terms and conditions of :ref:`AIoT Software License Agreement <license-ref>`, you must not access or use the software.

To download |IOT-YOCTO| recipes for v22.1 release, determine the SoC and board hardware you'd like to use first:

Genio 1200
----------

For MT8395 & |i1200-DEMO|, use the following manifest:

.. prompt:: bash $ auto

    $ repo init -u https://gitlab.com/mediatek/aiot/bsp/manifest.git -b refs/tags/rity-kirkstone-v22.1

Genio 350
---------

For MT8365 & |i350-EVK|, use the following manifest:

.. prompt:: bash $ auto

    $ repo init -u https://gitlab.com/mediatek/aiot/bsp/manifest.git -b refs/tags/rity-dunfell-v22.1


Private (NDA) configuration
---------------------------

**In v22.1 release configures to public image by default** (``NDA_BUILD = "0"``).
To build the private image configuration, set the configuration flag ``NDA_BUILD = "1"`` in ``local.conf``:

.. prompt:: bash $ auto

    $ echo NDA_BUILD = \"1\" >> ${BUILD_DIR}/conf/local.conf

Before building with the ``bitbake`` commands.

Please refer to :doc:`/sw/yocto/get-started` for detailed steps.


Tools
=====

``genio-tools`` is released to load built images to the development boards. Please refer to :doc:`/sw/yocto/get-started` and :doc:`/tools/genio-tools` for detailed usage.


Feature Support Status - MT8365(Genio 350)
==========================================

* Yocto LTS Dunfell 3.1
* Linux Kernel based on LTS version 5.10.113
* ATF upgraded to v2.6
* U-Boot upgraded to v2022.01
* OPTEE upgraded to 3.16

These symbol represents the supporting status:

* ``V``: function enabled by software and available on hardware board.
* ``O``: software integrated but cannot validate due to hardware board limitation.
* ``--``: not supported in this release; development on-going.

.. csv-table:: MT8365 Supported Features
    :file: /_asset/tables/v22.1-i350-feature-status.csv
    :header-rows: 1
    :encoding: utf-8
    :width: 65%
    :widths: 30,55,15

Feature Support Status - MT8395(Genio 1200)
===========================================

* Yocto LTS Kirkstone 4.0.2
* Linux Kernel based on LTS version 5.15.37
* ATF upgraded to v2.6
* U-Boot upgraded to v2022.04
* OPTEE upgraded to 3.16

These symbol represents the supporting status:

* ``V``: function enabled by software and available on hardware board.
* ``O``: software integrated but cannot validate due to hardware board limitation.
* ``--``: not supported in this release; development on-going.

.. csv-table:: MT8395 Supported Features
    :file: /_asset/tables/v22.1-i1200-feature-status.csv
    :header-rows: 1
    :encoding: utf-8
    :width: 65%
    :widths: 30,55,15

Notable Software Limitations for MT8395
---------------------------------------

- Video encoder only support to 4K 30fps
- Embedded Display Port only support up to 2K 60fps
- MIPI-DSI display interfaces are not supported
- USB Peripheral/Host dual-role requires timeout when switching roles

Fixed Issues from v22.0.1
=========================
- Genio 1200-demo: HDMI does not work when eDP is enabled
- Genio 1200-demo: Display Port over USB-C port does not work

Known Issues
============

* `Genio 350-evk`: Instabilities with video encode/decode H.264
* `Genio 350-evk`: Unstable camera frame rate
* `Genio 350-evk`: HDMI resolution switch can be slow
* `Genio 350-evk`: `modetest` permission denied sometimes
* `Genio 350-evk`: AIOT-1241: Incomplete Suspend/Resume support
* `Genio 1200-demo`: AIOT-1283: UART1 is occupied by firmware and not available for use
* `Genio 1200-demo`: AIOT-1224: DisplayPort audio playback does not resume after suspend/resume operations
* `Genio 1200-demo`: AIOT-1260: Occasionally Weston may fail to start when connected to HDMI display output
* `Genio 1200-demo`: AIOT-1216: DisplayPort may fail to connect to monitors with Type-C receptacles
* `Genio 1200-demo`: AIOT-1266: DisplayPort may fail to show display output after unplugging and replugging the cable
* `Genio 1200-demo`: AIOT-1223: System console may freeze when suspend-resume under heavy stress
* `Genio 1200-demo`: AIOT-1268: `infra_ao_gce` clock kernel warning when entering suspend Mode
* `Genio 1200-demo`: AIOT-1248: H264 decode failed for resolution < 720P with `avimux`