.. include:: /keyword.rst

===============================
|IOT-YOCTO| v23.2 - 2023 Dec 29
===============================

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

.. _yocto-v23.2:

|IOT-YOCTO| **v23.2** release supports Genio SoC families based on Yocto Kirkstone and Linux 5.15.
This page provides an overview of the major changes and new features in **v23.2**. 

Supported Boards
================

This release supports following boards based on MT8365(Genio 350), MT8370(Genio 510), MT8390(Genio 700), and MT8395(Genio 1200) MediaTek SoC families:

.. list-table::
    :header-rows: 1

    * - Board Name
      - :ref:`MACHINE name for bitbake <machine-name-for-bitbake>`
    * - :doc:`Genio 350-EVK </hw/i350-evk>`
      - * ``genio-350-evk``
    * - :doc:`Genio 510-EVK </hw/g510-evk>`
      - * ``genio-510-evk``
    * - :doc:`Genio 700-EVK </hw/g700-evk>`
      - * ``genio-700-evk``
    * - :doc:`Genio 1200-EVK </hw/g1200-evk>`
      - * ``genio-1200-evk`` (EMMC boot)
        * ``genio-1200-evk-ufs`` (UFS boot)

Supported Software Features & Specs
===================================


Please go to `IoT Yocto Feature Table (v23.2) <https://download.mediatek.com/aiot/download/release-note/v23.2/v23.2_IoT_Yocto_Feature_Table_v1.0.4.pdf>`_ to check the software support status for the |IOT-YOCTO| v23.2 release.

.. figure:: /_asset/sw_yocto_release-notes_feature-table.png
    :align: center
    :scale: 50%

    A Segment of IoT Yocto Feature Table (v23.2)
	
.. _prebuilt-image-download-v23.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?Mes=type1&Code=kirkstone_k5.15_v23.2_genio-350-evk_private_231227055018>`__", ``0a01f563c6a9b92b3b23e3b43c4139f2``
    ":doc:`Genio 350-EVK </hw/i350-evk>`", "`download public image <https://download.mediatek.com/aiot/page/download.html?Mes=type1&Code=kirkstone_k5.15_v23.2_genio-350-evk_public_231227032503>`__", ``f6c3456cfae52c94a23f6dce3d88b593``
    ":doc:`Genio 510-EVK </hw/g510-evk>`", "`download private image <https://download.mediatek.com/aiot/page/download.html?Mes=type1&Code=kirkstone_k5.15_v23.2_genio-510-evk_private_231227054744>`__", ``20a0964c1f3a0db3f8df0d61995a1ac7``
    ":doc:`Genio 510-EVK </hw/g510-evk>`", "`download public image <https://download.mediatek.com/aiot/page/download.html?Mes=type1&Code=kirkstone_k5.15_v23.2_genio-510-evk_public_231227032205>`__", ``4fec01f46efb916257e8757c2ce2bd77``
    ":doc:`Genio 700-EVK </hw/g700-evk>`", "`download private image <https://download.mediatek.com/aiot/page/download.html?Mes=type1&Code=kirkstone_k5.15_v23.2_genio-700-evk_private_231227054304>`__", ``3e0f8b725d9f2874bbb098bf4adf7519``
    ":doc:`Genio 700-EVK </hw/g700-evk>`", "`download public image <https://download.mediatek.com/aiot/page/download.html?Mes=type1&Code=kirkstone_k5.15_v23.2_genio-700-evk_public_231227031609>`__", ``0b79171034deafbe43269838ceb59f68``
    ":doc:`Genio 1200-EVK </hw/g1200-evk>`", "`download private image <https://download.mediatek.com/aiot/page/download.html?Mes=type1&Code=kirkstone_k5.15_v23.2_genio-1200-evk_private_231227054038>`__", ``f864d42ab7fe56aea133b59f55c7b1aa``
    ":doc:`Genio 1200-EVK </hw/g1200-evk>`", "`download public image <https://download.mediatek.com/aiot/page/download.html?Mes=type1&Code=kirkstone_k5.15_v23.2_genio-1200-evk_public_231227030225>`__", ``ed10733e4211f28fd2ac74374885c2f3``
    
    

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

.. _private-image-v23.2:

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

|IOT-YOCTO| v23.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, require access to `private repositories <https://gitlab.com/mediatek/aiot/nda>`_ in the GitLab group. In v23.2 release, the private image provides these additional features on top of the public configuration:

    - Security features on all Genio platforms, including:

      - 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
    - Xtensa-ANN support on Genio 350
    - MT7663 proprietary Wi-Fi driver on Genio 350
    - MT7663 BlueDroid support and proprietary Bluetooth driver on Genio 350

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 **v23.2** release, use the tag ``rity-kirkstone-v23.2`` to download Yocto Kirkstone recipes for all Genio boards,
including Genio 350 EVK, Genio 510 EVK, Genio 700 EVK, and Genio 1200 EVK:

.. prompt:: bash $ auto

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

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`` 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 Kirkstone updated to **4.0.13**
* Linux Kernel kept in 5.15.42
* ATF version kept in v2.6
* U-Boot version kept in v2022.10
* OPTEE version kept in 3.19
* Mali GPU driver version kept in DDK r43



Major Changes
=================
 
* A new platform MT8370(Genio 510) is now supported in **v23.2** release. The features are fully aligned with MT8390(Genio 700).
* NeuroPilot (Genio 510, Genio 700, Genio 1200) is now supported in the **Public** images. The NeuroPilot software license changes from MTK Proprietary License to :ref:`AIoT SLA <license-ref>`.
* Standard V4L2 Camera Sensor Interface (Genio 510, Genio 700, Genio 1200) is now supported in the **Public** images.


New Features
============

.. contents:: v23.2 List of New Features
    :local:
    :depth: 1

Standard V4L2 Camera Sensor (Genio 510, Genio 700, Genio 1200)
--------------------------------------------------------------

The Genio 510, Genio 700, and Genio 1200 now support the standard V4L2 camera sensor interface.
The Genio 350 already supports this feature from the v21.3 release. 
Starting from the **v23.2** release, the entire Genio family now supports the standard V4L2 camera sensor interface for YUV sensors.

* Supports YUV sensors only, do no support Raw sensors
* The feature was developed and verified with the Camera D6 board (AP1320+A0830)
* Software for all Genio platforms also supports multi-sensor (YUV+YUV) configuration 
* The CSI ports design for G510-EVK and G700-EVK supports multi-sensor 
* The CSI ports design for G1200-EVK does not support multi-sensor, due to shared reset and control pin design among different CSI ports

For details, please refer to :doc:`/sw/yocto/app-dev/camera/camera-common`.


LVDS Panel (Genio 350)
----------------------

The Genio 350 now supports the LVDS interface.

* The LVDS and DSI features are mutually exclusive on Genio-350 due to shared pins.
* The feature was developed with an external cable covert daughter board with an LVDS panel (`AUO g156xtn01.0`), which is not included in the Genio 350-EVK set.

For details, please refer to :ref:`G350-EVK LVDS section <G350-evk-lvds>`.


eDP Boot Logo (Genio 510, Genio 700, Genio 1200)
------------------------------------------------

The Genio 510, Genio 700, and Genio 1200 now support the eDP boot logo feature.

* A boot logo will be shown in the bootloader stage
* This feature requires an additional patch from MediaTek to be enabled

For details, please refer to :ref:`Boot logo section <display_bootlogo>`.


IT6510 POC (Genio 510, Genio 700, Genio 1200)
---------------------------------------------

The Genio 510, Genio 700, and Genio 1200 now offer basic support for the IT6510, a DP to CSI bridge IC.

* It allows these platforms to support multiple DP inputs as video input sources through the CSI port
* This is a POC feature. The reference driver is integrated, and the basic functionalities have been verified 
* Users requires to develop their drivers and other software modules based on their user scenarios

For details, please refer to :ref:`IT6510 section <camera_it6510>`.


GStreamer kmssink Element (All Genio Platforms)
-------------------------------------------------

The `kmssink` element of GStreamer is integrated into the **v23.2** release.

* `kmssink` serves as an engineering and debugging tool; it is not fully verified for all display scenarios.


UART DMA Mode (All Genio Platforms)
-----------------------------------

UART now supports DMA mode as default configuration.


UVC Gadget (G510, G700, G1200)
------------------------------

The Genio 510, Genio 700, and Genio 1200 now support UVC Gadget drivers. 

* The UVC Gadget feature includes a driver that offers partial support for webcam functionality, serving as a reference for testing purposes rather than constituting a complete webcam feature set.
* Verification was performed using `wlhe/uvc-gadget <https://github.com/wlhe/uvc-gadget>`_ to ensure functionality and compatibility.

For details, please refer to :ref:`UVC gadget section <peripheral-uvc-gadget>`

`genio-tools` for Ubuntu 22.04 
------------------------------

The `genio-tool` now supports running on the Ubuntu 22.04 environment.


Yocto Build Environment for Ubuntu 22.04 
----------------------------------------

The Yocto Build Environment has been verified on Ubuntu 22.04.


Platform-Specific Feature Support Status
----------------------------------------

For configurations and supported features of each Genio SoC, visit the link below:

.. toctree::
    :titlesonly:

    Genio 350 <v23.2-feature-status/v23.2-feature-status-g350>
    Genio 510 <v23.2-feature-status/v23.2-feature-status-g510>
    Genio 700 <v23.2-feature-status/v23.2-feature-status-g700>
    Genio 1200 <v23.2-feature-status/v23.2-feature-status-g1200>