.. include:: /keyword.rst

================================
|IOT-YOCTO| v21.3 - 2021 Dec 22
================================

.. _yocto-v21.3:

|IOT-YOCTO| v21.3 release is based on Yocto Dunfell 3.1 and Linux Kernel 5.10 LTS releases.

.. contents::
    :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)

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

.. csv-table:: v21.3 Prebuilt Images
   :header: "Prebuilt Image", "Board", "Release"
   :widths: 5, 15, 5
   :align: center

   "`download <https://download.mediatek.com/aiot/page/download.html?Code=RITY-v21.3_i350-evk_Dunfell&Mes=type1>`_", ":doc:`Genio 350-EVK </hw/i350-evk>`", ":ref:`v21.3 <yocto-v21.3>`"

Please refer to :doc:`/sw/yocto/get-started/download-prebuilt-image` page to
extract and flash these image packages.


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 v21.3 release, fetch the ``refs/tags/rity-v21.3`` tag from the ``https://gitlab.com/mediatek/aiot/bsp/manifest`` git repository.
For example,

.. prompt:: bash $ auto

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

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.

Major Software Package Versions
===============================

* Yocto LTS Dunfell 3.1
* Linux Kernel LTS 5.10 version 5.10.73
* ATF upgraded to v2.5
* U-Boot v2021.10
* OPTEE upgraded to 3.14

Feature Support Status - MT8365
===============================

.. csv-table:: MT8365 Supported Features
    :file: /_asset/tables/v21.3-i350-feature-status.csv
    :header-rows: 1
    :width: 65%
    :widths: 30,70

Feature Support Status - MT8395
===============================

.. note::

    The support of MT8395 on |IOT-YOCTO| is under development. At the current alpha release, |IOT-YOCTO| enables the following features.

.. csv-table:: MT8395 Supported Features
    :file: /_asset/tables/v21.3-i1200-feature-status.csv
    :header-rows: 1
    :width: 65%
    :widths: 30,70


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

* `Genio 350-evk`: Instabilities with video encode/decode H.264
* `Genio 350-evk`: Unstable camera framerate
* `Genio 350-evk`: Incomplete Suspend/Resume support
* `Genio 350-evk`: HDMI resolution switch can be slow
* `Genio 350-evk`: `modetest` permission denied sometimes
* `Genio 1200-demo`: HDMI not working
* `Genio 1200-demo`: `cpufreq` node not working