.. include:: /keyword.rst

================================
|IOT-YOCTO| v22.2 - 2022 Dec 12
================================

.. _yocto-v22.2:

|IOT-YOCTO| v22.2 release supports two hardware configurations based on Yocto Kirkstone and Linux 5.15:

- :ref:`Genio 1200 <soc-mt8395>` lands on Linux Kernel 5.15 (``mtk-v5.15-dev``) and Yocto Kirkstone.
- :ref:`Genio 350 <soc-mt8365>` has been migrated to Linux Kernel 5.15 (``mtk-v5.15-dev``) and Yocto Kirkstone, same as Genio 1200.

.. 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 Changes in v22.2
========================

- **mtk-v5.15-dev kernel is no longer compatible with Yocto Dunfell**:

  This is due to more drivers being maintained out-of-tree in v22.2,
  and the changes are not compatible with Dunfell recipes in ``meta-mediatek-bsp``.
  If you need to use Yocto Dunfell with Genio 350, please keep using ``mtk-v5.10`` instead.

- **Partition adjustment**:

  v22.2 merges the ``home`` and ``rootfs`` partitions into a single partition.
  This allows developers to expand the rootfs partition size to install additional packages for evaluation,
  without rebuilding the entire image.

- **Additional pre-integrated packages in prebuilt images**:

  The :ref:`downloadable prebuilt images <prebuilt-image-download-v22.2>` (``rity-demo-image``) has integrated more packages for evaluation:
  
    - :doc:`Benchmark suite </tools/benchmark-suite>`
    - :doc:`Stress suite </tools/stress-suite>`
    - :doc:`ML/AI demo </tools/ai-demo-app>`
    - LTP (`xTest`)

  If you'd like to build images without these additional evaluation packages, please build the new image recipe ``rity-bsp-image`` instead.

- **`multilib` support disabled by default**:

  v22.2 now disables `multilib <https://docs.yoctoproject.org/4.0.22/dev-manual/libraries.html#combining-multiple-versions-of-library-files-into-one-image>`_
  by default. As a result, there are no ``lib64`` directory in root file system. All the libraries in ``lib`` are now 64-bit.
  You could still enable `multilib` support for your own projects if 32-bit support is required. However, all the Genio board support prebuilt binaries are available in 64-bit only.

- **Move more proprietary drivers out-of-tree and requires loading additional DTBO**:

  Drivers that do not conform to upstream Linux LTS 5.15 interfaces or behaviors are being moved outside of kernel source tree,
  to minimize impact to upstream drivers. In v22.2, the IoT Yocto's video codec driver for Genio 1200 must be enabled by loading additional DTBO file ``video.dtbo``:

  .. prompt:: bash # auto

        genio-flash --load-dtbo video.dtbo

.. _prebuilt-image-download-v22.2:

Prebuilt Images Download
========================

.. 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=kirkstone_k5.15_v22.2_i350-evk_private_221207061229&Mes=type1>`__", ``fc17b774d6fac072bb212058357aafac``
    ":doc:`Genio 350-EVK </hw/i350-evk>`", "`download public image <https://download.mediatek.com/aiot/page/download.html?Code=kirkstone_k5.15_v22.2_i350-evk_public_221208013601&Mes=type1>`__", ``13b8309a8e40b9a6d554e2c665c8b151``


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

|IOT-YOCTO| v22.2 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:`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 explicit access permissions to the `GitLab group <https://gitlab.com/mediatek/aiot/>`_. This lacks some proprietary features, and some proprietary components are provided in binary-only format.

**Private** images, on the other hand, requires access to `private repositories <https://gitlab.com/mediatek/aiot/nda>`_ in the 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
    - ISP support on |i1200-DEMO|

Source Code Download
====================

.. important::

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

To download |IOT-YOCTO| recipes for v22.2 release, use the tag ``rity-kirkstone-v22.2`` to download Yocto Kirkstone recipes for both Genio 1200 and Genio 350 boards:

.. prompt:: bash $ auto

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

To fetch source code and build images using these Yocto recipes, please refer to steps in :doc:`/sw/yocto/get-started`

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

**In v22.2 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.

Please note that there are new DTBOs added in this release:

- :ref:`List of Genio 1200 Demo Board DTBOs <genio-1200-demo-dtbo-v22.2>`
- :ref:`List of Genio 350 EVK DTBOs <genio-350-evk-dtbo-v22.2>`

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

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


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

New Features in v22.2 for MT8395(Genio 1200)
--------------------------------------------

- A reference secure boot flow support is now available for MT8395 (requires NDA).
- Wi-Fi & Bluetooth connectivity module ``AzureWave AW-XB468NF`` now supports:
  - additional BlueZ profiles (HID, HoG)
  - Wi-Fi STA mode.
- DSI display interface on Genio 1200-Demo board and related multi-display combinations (DSI+DP, DSI+HDMI) are now enabled.
- eDP display throughput increase from 2K60Hz to 4K60Hz on MT8395 / Genio 1200-Demo board.
- Additional ROS2 Yocto meta-layer support for MT8395 on Kirkstone and Kernel 5.15. This is provided as a separate layer and is not included in prebuilt images.
- Ethernet TSN test environment integration for MT8395 / Genio 1200-Demo board. A test guide documentation and pre-test report are provided (requires NDA).
- Preliminary support for MT8395 internal ISP and IMX214 sensor. The is support is in early stages and currently it only serves purpose for CSI0 interface hardware verification. (requires NDA).
  (**Note:** If MT8395 internal ISP is enabled, there will be additional 125 V4L2 devices under ``/dev``. Please refer to :ref:`V4L2 Device Node <camera-g1200-evk-v4l2-device-node>`.)
- Maximum throughput of the H.264 & H.265 hardware video encoder upgrades to 4K60 from 4K30 for MT8395.

.. _genio-1200-demo-dtbo-v22.2:

Genio 1200-Demo Board DTBOs in v22.2
------------------------------------

Certain external hardware components, and some software modules, are required to be enabled by loading `dtbo` files.
The full list of DTBOs for Genio 1200-Demo board is:

- ``video.dtbo`` : to enable hardware video encoders and decoders
- ``display-dp.dtbo`` : to enable DisplayPort (will disable the default HDMI output)
- ``display-dsi.dtbo`` : to enable DSI display path and panel
- ``display-edp4k.dtbo``: to enable 4K eDP display path and panel
- ``panel-boe-ne135fbm.dtbo`` : to enable 2K eDP display path and panel
- ``camera-imx214-csi0.dtbo`` : to enable ISP + IMX214 on CSI0 

Please refer to this page to :ref:`load DTBOs during flashing process<how-to-load-a-dtbo>`.

Notable Software Limitations for MT8395(Genio 1200) in v22.2
------------------------------------------------------------

- DisplayPort output only supports DisplayPort over Type C(DPoC), direct output from a DisplayPort connector is not supported.
- Low power performance during suspend is not fully optimized.

Feature List for Genio 1200-Demo Board in v22.2
-----------------------------------------------

These symbols represent 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.2-G1200-feature-status.csv
    :header-rows: 1
    :encoding: utf-8
    :width: 80%
    :widths: 25,55,5,5

Known Issues for Genio 1200 in v22.2
------------------------------------

.. csv-table::
    :file: /_asset/tables/v22.2-G1200-known-issues.csv
    :header-rows: 1
    :encoding: utf-8
    :width: 80%
    :widths: 20,60


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

New Features in v22.2 for MT8365(Genio 350)
-------------------------------------------

- Genio 350 has migrated to Kernel v5.15 and Yocto Kirkstone.
- H.265 hardware video encoder support enabled for Genio 350.

Genio 350-EVK Board DTBOs in v22.2
----------------------------------

Certain external hardware components, and some software modules, are required to be enabled by loading `dtbo` files.
The full list of DTBOs for Genio 350-EVK board is:

- ``video.dtbo`` : to enable hardware video encoders and decoders
- ``camera-ap1302-ar0430-single-csi0.dtbo`` : to enable single camera module on CSI0
- ``camera-ap1302-ar0430-single-csi1.dtbo`` : to enable single camera module on CSI1
- ``camera-ap1302-ar0430-dual.dtbo`` : to enable both camera modules on both CSI0 and CSI1
- ``net-ethernet.dtbo`` : to enable the Ethernet port (disables the default HDMI output)
- ``panel-startek-kd070fhfid015.dtbo`` : to enable the DSI panel

.. _genio-350-evk-dtbo-v22.2:

Please refer to this page to :ref:`load DTBOs during flashing process<how-to-load-a-dtbo>`.

Notable Software Limitations for MT8365(Genio 350) in v22.2
-----------------------------------------------------------

- Low power performance during suspend is not optimized for MT8365(Genio 350).


Feature List for Genio 350-EVK Board in v22.2
-----------------------------------------------

These symbols represent 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.2-G350-feature-status.csv
    :header-rows: 1
    :encoding: utf-8
    :width: 80%
    :widths: 25,55,5,5

Known Issues for Genio 350 in v22.2
-----------------------------------

.. csv-table::
    :file: /_asset/tables/v22.2-G350-known-issues.csv
    :header-rows: 1
    :encoding: utf-8
    :width: 80%
    :widths: 20,60