.. include:: /keyword.rst


.. _RITY:

=====================
|IOT-YOCTO| Overview
=====================

Based on the Yocto project, |IOT-YOCTO| provides board support packages(BSP) for Genio evaluation kits and development boards.

Derived from open source projects, |IOT-YOCTO| aims to conform to upstream interfaces and designs when applicable, including:

* Most components in the BSP, including bootloader and Linux kernel, are forked from corresponding open source upstream projects and closely tracked to keep updated with the upstream.
* Some supporting packages, based on the collection of Yocto project, are patched for compatibility.
* Certain hardware drivers and supporting software are provided as proprietary packages that allow redistribution to be used with MediaTek Genio chipsets. Please read the license terms before using these components.

The following diagram shows software components used in |IOT-YOCTO|. Please note that the support status of each software component depends on SoC and board capabilities.

.. figure:: /_asset/sw_rity_architecture.svg
    :align: center
    :width: 100%

    Major components in IoT Yocto

Key Features
============

|IOT-YOCTO| includes the following components and features:

Boot Loader and Kernel
^^^^^^^^^^^^^^^^^^^^^^

* `Linux kernel forked from kernel.org LTS branch <https://gitlab.com/mediatek/aiot/bsp/linux>`__
* `Trusted-Firmware-A <https://gitlab.com/mediatek/aiot/bsp/trusted-firmware-a>`__
* `U-Boot <https://gitlab.com/mediatek/aiot/bsp/u-boot>`__

For versions of each component in each release, please refer to the :doc:`release notes <releases>`.

Components
^^^^^^^^^^

Based on **Yocto** project recipes, |IOT-YOCTO| provides BSP support with following software components:

* **Display**: `libdrm`/DRI support with Wayland display backend.
* **Graphics**: GPU driver with OpenGL ES support.
* **AI**: Tensorflow-lite integration and runtime inference libraries.
* **Audio**: supported through ALSA framework.
* **Video**: hardware video codec with V4L2 interface and GStreamer integration, supported by proprietary user-space driver and services.
* **Image**:  hardware JPEG codec with V4L2 interface and GStreamer integration, supported by proprietary user-space driver and services.
* **HDMI-RX**: supports video data and audio packet data reception according to the HDMI standard specification.
* **Camera**: external OnSemi AP1302 ISP with V4L2 interface, GStreamer integration, and `libcamera` integration.
* **Security**: OP-TEE integration.
* **Wi-Fi**:

    * External MT7663 connectivity module support with proprietary Wi-Fi driver and network manager integration.
    * External MT7921 connectivity module support with open source Wi-Fi driver and network manager integration.

* **Bluetooth**:
    * External MT7663 connectivity module support with proprietary Bluetooth driver and BlueDroid integration.
    * External MT7921 connectivity module support with open source Bluetooth driver and BlueZ integration.

Tools
^^^^^

* Flash programming tool is supported for Genio evaluation kits.

Getting Access to |IOT-YOCTO|
==============================
   
|IOT-YOCTO| is currently hosted on |GITLAB|. 

Most packages and Yocto recipes in |IOT-YOCTO| are available for access without registration.
For example, the Linux kernel fork for |IOT-YOCTO| is hosted in https://gitlab.com/mediatek/aiot/bsp/linux.
You can access it without a GitLab account.

However, certain proprietary packages are permission controlled, and require different license agreements.
These packages are currently located under |AIOT-NDA| namespace. You can enable these proprietary packages
during the build process using a :ref:`configuration flag NDA_BUILD<build-with-nda>`. 

For more details, please refer to the chapter here :ref:`gitlab-account-setup`.