.. include:: /keyword.rst

.. _display-g700-evk:

===============
|G510-G700-EVK|
===============

This page provides board-specific information on the display interfaces of the |G700-EVK-REF-BOARD|.
For common display and compositor information, please visit the :ref:`Display page <display-page>`.

.. important::
    
    All the bash commands shown here are based on |G700-EVK|. For |G510-EVK|, users can follow the same step to do the whole setup with changing the naming term from `700` to `510`.

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

Display Interfaces on |G510-G700-EVK-REF-BOARD|
===============================================

|IOT-YOCTO| supports four display interfaces on |G510-G700-EVK-REF-BOARD|: 

* :ref:`DSI0 <G700-evk-dsi-setup>` with DSI Panel ``STARTEK KD070FHFID015`` on |G700-EVK-REF-BOARD| and DSI Panel ``STARTEK KD070FHFID078`` on |G510-EVK-REF-BOARD|
* :ref:`HDMI <G700-evk-hdmi-setup>`
* :ref:`DisplayPort(DP) <G700-evk-dp-setup>` through USB Type-C port
* :ref:`Embedded Display Port(eDP) <G700-evk-edp-setup>` with eDP Panel ``AUO G156han03``
* :ref:`DSI0 to LVDS <G700-evk-lvds-setup>` with LVDS Panel ``KOE TX18D204VM0BAA``

The display system has two different pipelines - VDOSYS0 and VDOSYS1 - that can be used for any of the dual display combinations.
These pipelines are abstracted as different `crtc` in the DRM framework.

VDOSYS0 provides 3840x2160, 30Hz refresh rate, and VDOSYS1 provides 3840x2160, 60Hz refresh rate.

Default `rity-demo-image` enables dual display DSI and HDMI. Other display combinations can be enabled by loading
the `device tree overlay <https://u-boot.readthedocs.io/en/latest/usage/fdt_overlays.html>`_ during the flash programming process.

.. _G700-evk-dsi-setup:
.. _G700-evk-hdmi-setup:
.. _G700-evk-dp-setup:
.. list-table:: G510/G700 EVK Display Ports
   :widths: 50 50 50
   :header-rows: 1

   * - .. figure:: /_asset/sw_rity_display_G700-evk_display_interfaces_front.png
     - .. figure:: /_asset/sw_rity_display_G700-evk_display_interfaces_front_dsi.jpg
     - .. figure:: /_asset/sw_rity_display_G700-evk_display_interfaces_back_dsi.png
   * - top view without DSI panel installed (showing eDP, HDMI, DPoC)
     - top view with DSI panel installed
     - bottom view with DSI panel installed (showing DSI0, DSI1)

.. note::

    - DSI1 port (LCM2) is still not supported on |IOT-YOCTO| in v23.2.
    - The LVDS connector shares the same data lanes with the DSI0 connector, so only one of them can be used at the same time.

Lists of Display Device Tree Overlay
====================================

Here are lists of all available display combination device tree overlays and description link of each one:

.. list-table:: Default Display
   :widths: 30 30
   :header-rows: 1

   * - `dtbo`
     - Description
   * - No need `dtbo`
     - :ref:`DSI0 + HDMI <G700-evk-dsihdmi>`

.. list-table:: Headless Device Tree Overlay
   :widths: 30 30
   :header-rows: 1

   * - `dtbo`
     - Description
   * - ``display-headless.dtbo``
     - :ref:`Headless <G700-evk-headless>`

.. list-table:: Single Display Device Tree Overlays
   :widths: 30 30
   :header-rows: 1

   * - `dtbo`
     - Description
   * - ``display-dsi.dtbo``
     - :ref:`DSI0 <G700-evk-dsi>`
   * - ``display-dsi2lvds.dtbo``
     - :ref:`DSI0 to LVDS <G700-evk-dsi2lvds>`
   * - ``display-edp.dtbo``
     - :ref:`eDP <G700-evk-edp>`
   * - ``display-hdmi.dtbo``
     - :ref:`HDMI <G700-evk-hdmi>`
   * - ``display-dp.dtbo``
     - :ref:`DP <G700-evk-dp>`


.. _G700-evk-dual-dt:

.. list-table:: Dual Display Device Tree Overlays
   :widths: 30 30
   :header-rows: 1

   * - `dtbo`
     - Description
   * - ``display-dsiedp.dtbo``
     - :ref:`DSI0 + eDP <G700-evk-dsiedp>`
   * - ``display-dsidp.dtbo``
     - :ref:`DSI0 + DP <G700-evk-dsidp>`
   * - ``display-lvdsedp.dtbo``
     - :ref:`LVDS + eDP <G700-evk-lvdsedp>`
   * - ``display-lvdshdmi.dtbo``
     - :ref:`LVDS + HDMI <G700-evk-lvdshdmi>`
   * - ``display-lvdsdp.dtbo``
     - :ref:`LVDS + DP <G700-evk-lvdsdp>`
   * - ``display-edphdmi.dtbo``
     - :ref:`eDP + HDMI <G700-evk-edphdmi>`
   * - ``display-edpdp.dtbo``
     - :ref:`eDP + DP <G700-evk-edpdp>`
   * - ``display-hdmidp.dtbo``
     - :ref:`HDMI + DP <G700-evk-hdmidp>`

.. _G700-evk-dsihdmi:

DSI0 + HDMI
-----------

**DSI0 + HDMI** are the default dual display interfaces for the prebuilt `rity-demo-image`.
A DSI panel is pre-connected to G510/G700 EVK.

To restore the device tree setting back to the `default device tree <https://gitlab.com/mediatek/aiot/bsp/linux/-/blob/mtk-v5.15-dev/arch/arm64/boot/dts/mediatek/genio-700-evk.dts>`_ 
of the |G510-G700-EVK| board, flash the board with:

.. prompt:: bash

    genio-flash -i rity-demo-image

.. note::

    - ``gpu-mali.dtbo`` is needed for showing Weston Desktop. If ``gpu-mali.dtbo`` is not loaded, a text-based user interface would be seen.
    - In v23.2 ``gpu-mali.dtbo`` and ``video.dtbo`` are be default loaded when flashing with ``genio-flash``. No extra ``--load-dtbo`` needed for ``gpu-mali.dtbo``.

After boot into the console you can use ``modeprint mediatek`` command to check if both DSI0 and HDMI ports have been properly configured:

.. code-block:: text

    root@genio-700-evk:~# modeprint mediatek
    Starting test
    Resources

    count_connectors : 2
    count_encoders   : 2
    count_crtcs      : 2
    count_fbs        : 0

    Connector: DSI-1
            id             : 32
            encoder id     : 31
            conn           : connected
            size           : 95x151 (mm)
            count_modes    : 1
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 31
    Mode: "1200x1920" 1200x1920 60
    Connector: HDMI-A-1
            id             : 34
            encoder id     : 33
            conn           : connected
            size           : 600x340 (mm)
            count_modes    : 33
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 33
    Mode: "3840x2160" 3840x2160 60
    Mode: "3840x2160" 3840x2160 60
    ...

The associated display data pipeline can process up to 2.5K(2560 x 1600) with 60Hz refresh rate for DSI0, and
4K(3840 x 2160) with 60Hz refresh rate for HDMI.

.. _G700-evk-headless:

Headless
--------

Headless means that Yocto works without enabling any physical display connector.
There is a virtual display at ``/dev/dri/renderD128`` prepared for offline rendering.

To enable Headless, load the overlay file ``display-headless.dtbo`` during flashing process:

.. prompt:: bash

    genio-flash -i rity-demo-image --load-dtbo display-headless.dtbo

If you don't want to re-flash the entire root file system, you can simply update the overlay configuration with:

.. prompt:: bash

    genio-flash -i rity-demo-image --load-dtbo display-headless.dtbo kernel mmc0boot1

After boot into the console you will see the following error log which is because there is no physical display for Weston desktop rendering

.. code-block:: text

    [FAILED] Failed to start Weston, a compositor, as a system service.
    See 'systemctl status weston.service' for details.

You can use ``modeprint mediatek`` command to check if headless has been properly configured by checking if connector count equals 0:

.. code-block:: text

    root@genio-700-evk:~# modeprint mediatek
    Starting test
    Resources

    count_connectors : 0
    count_encoders   : 0

.. _G700-evk-dsi:

DSI0
----

To enable DSI0 as the only display connector, load the overlay file ``display-dsi.dtbo`` during flashing process:

.. prompt:: bash

    genio-flash -i rity-demo-image --load-dtbo display-dsi.dtbo

If you don't want to re-flash the entire root file system, you can simply update the overlay configuration with:

.. prompt:: bash

    genio-flash -i rity-demo-image --load-dtbo display-dsi.dtbo kernel mmc0boot1

After boot into the console you can use ``modeprint mediatek`` command to check if DSI0 port have been properly configured:

.. code-block:: text

    root@genio-700-evk:~# modeprint mediatek
    Starting test
    Resources

    count_connectors : 1
    count_encoders   : 1
    count_crtcs      : 2
    count_fbs        : 0

    Connector: DSI-1
            id             : 32
            encoder id     : 31
            conn           : connected
            size           : 95x151 (mm)
            count_modes    : 1
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 31
    Mode: "1200x1920" 1200x1920 60

The associated display data pipeline can process up to 2.5K(2560 x 1600) with 60Hz refresh rate for DSI0.

.. _G700-evk-dsi2lvds:

DSI0 to LVDS
------------

To enable DSI0 to LVDS as the only display connector, load the overlay file ``display-dsi2lvds.dtbo`` during flashing process:

.. prompt:: bash

    genio-flash -i rity-demo-image --load-dtbo display-dsi2lvds.dtbo

If you don't want to re-flash the entire root file system, you can simply update the overlay configuration with:

.. prompt:: bash

    genio-flash -i rity-demo-image --load-dtbo display-dsi2lvds.dtbo kernel mmc0boot1

.. note::

    - Since LVDS shares the same data lanes with DSI0, the connector seen in ``modeprint`` is ``DSI-1``.
    - For other LVDS usage in multi display device tree overlays, e.g. LVDS + eDP, the file name of `dtbo` should look like ``display-dsi2lvdsedp.dtbo``,
      but to keep it short, we strip ``dsi2`` from the file name, thus it becomes ``display-lvdsedp.dtbo``.
      The same rule applies to other device tree overlay files supporting multi-display.

After boot into the console you can use ``modeprint mediatek`` command to check if LVDS (in DSI-1) port have been properly configured:

.. code-block:: text

    root@genio-700-evk:~# modeprint mediatek
    Starting test
    Resources

    count_connectors : 1
    count_encoders   : 1
    count_crtcs      : 2
    count_fbs        : 0

    Connector: DSI-1
            id             : 32
            encoder id     : 31
            conn           : connected
            size           : 87x155 (mm)
            count_modes    : 1
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 31
    Mode: "1920x1080" 1920x1080 60

The associated display data pipeline can process up to FHD(1920 x 1080) with 60Hz refresh rate for LVDS.

.. _G700-evk-edp:

eDP
---

To enable eDP as the only display connector, load the overlay file ``display-edp.dtbo`` during flashing process:

.. prompt:: bash

    genio-flash -i rity-demo-image --load-dtbo display-edp.dtbo

If you don't want to re-flash the entire root file system, you can simply update the overlay configuration with:

.. prompt:: bash

    genio-flash -i rity-demo-image --load-dtbo display-edp.dtbo kernel mmc0boot1

After boot into the console you can use ``modeprint mediatek`` command to check if eDP port have been properly configured:

.. code-block:: text

    root@genio-700-evk:~# modeprint mediatek
    Starting test
    Resources

    count_connectors : 1
    count_encoders   : 1
    count_crtcs      : 2
    count_fbs        : 0

    Connector: eDP-1
        id             : 32
        encoder id     : 31
        conn           : connected
        size           : 340x190 (mm)
        count_modes    : 1
        count_props    : 5
        props          : 1 2 5 6 4
        count_encoders : 1
        encoders       : 31
    Mode: "1920x1080" 1920x1080 60

The associated display data pipeline can process up to 2.5K(2560 x 1600) with 60Hz refresh rate for eDP.

.. _G700-evk-hdmi:

HDMI
----

To enable HDMI as the only display connector, load the overlay file ``display-hdmi.dtbo`` during flashing process:

.. prompt:: bash

    genio-flash -i rity-demo-image --load-dtbo display-hdmi.dtbo

If you don't want to re-flash the entire root file system, you can simply update the overlay configuration with:

.. prompt:: bash

    genio-flash -i rity-demo-image --load-dtbo display-hdmi.dtbo kernel mmc0boot1

After boot into the console you can use ``modeprint mediatek`` command to check if HDMI port have been properly configured:

.. code-block:: text

    root@genio-700-evk:~# modeprint mediatek
    Starting test
    Resources

    count_connectors : 1
    count_encoders   : 1
    count_crtcs      : 2
    count_fbs        : 0

    Connector: HDMI-A-1
            id             : 32
            encoder id     : 31
            conn           : connected
            size           : 700x390 (mm)
            count_modes    : 39
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 31
    Mode: "3840x2160" 3840x2160 60
    Mode: "3840x2160" 3840x2160 60
    ...

The associated display data pipeline can process up to 4K(3840 x 2160) with 60Hz refresh rate for HDMI.

.. _G700-evk-dp:

DP
--

To enable DP as the only display connector, load the overlay file ``display-dp.dtbo`` during flashing process:

.. prompt:: bash

    genio-flash -i rity-demo-image --load-dtbo display-dp.dtbo

If you don't want to re-flash the entire root file system, you can simply update the overlay configuration with:

.. prompt:: bash

    genio-flash -i rity-demo-image --load-dtbo display-dp.dtbo kernel mmc0boot1

After boot into the console you can use ``modeprint mediatek`` command to check if DP port have been properly configured:

.. code-block:: text

    root@genio-700-evk:~# modeprint mediatek
    Starting test
    Resources

    count_connectors : 1
    count_encoders   : 1
    count_crtcs      : 2
    count_fbs        : 0

    Connector: DP-1
            id             : 32
            encoder id     : 31
            conn           : connected
            size           : 700x390 (mm)
            count_modes    : 27
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 31
    Mode: "3840x2160" 3840x2160 60
    Mode: "3840x2160" 3840x2160 30
    ...

The associated display data pipeline can process up to 4K(3840 x 2160) with 60Hz refresh rate for DP.

.. _G700-evk-dsiedp:

DSI0 + eDP
----------

You can configure the DSI0 + eDP combination with:

.. prompt:: bash

    genio-flash -i rity-demo-image --load-dtbo display-dsiedp.dtbo

If you don't want to re-flash the entire root file system, you can simply update the overlay configuration with:

.. prompt:: bash

    genio-flash -i rity-demo-image --load-dtbo display-dsiedp.dtbo kernel mmc0boot1

After boot into the console you can use ``modeprint mediatek`` command to check if both DSI0 and eDP ports have been properly configured:

.. code-block:: text

    root@genio-700-evk:~# modeprint mediatek
    Starting test
    Resources

    count_connectors : 2
    count_encoders   : 2
    count_crtcs      : 2
    count_fbs        : 0

    Connector: DSI-1
            id             : 32
            encoder id     : 31
            conn           : connected
            size           : 95x151 (mm)
            count_modes    : 1
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 31
    Mode: "1200x1920" 1200x1920 60
    Connector: eDP-1
            id             : 34
            encoder id     : 33
            conn           : connected
            size           : 340x190 (mm)
            count_modes    : 1
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 33
    Mode: "1920x1080" 1920x1080 60

The associated display data pipeline can process up to 2.5K(2560 x 1600) with 60Hz refresh rate for DSI0, and
2.5K(2560 x 1600) with 60Hz refresh rate for eDP.

.. _G700-evk-dsidp:

DSI0 + DP
---------

To enable DSI0 + DP, load the `dtbo` file ``display-dsidp.dtbo`` during flashing process:

.. prompt:: bash

    genio-flash -i rity-demo-image --load-dtbo display-dsidp.dtbo

If you don't want to re-flash the entire root file system, you can simply update the overlay configuration with:

.. prompt:: bash

    genio-flash -i rity-demo-image --load-dtbo display-dsidp.dtbo kernel mmc0boot1

After boot into the console you can use ``modeprint mediatek`` command to check if both DSI0 and DP ports have been properly configured:

.. code-block:: text

    root@genio-700-evk:~# modeprint mediatek
    Starting test
    Resources

    count_connectors : 2
    count_encoders   : 2
    count_crtcs      : 2
    count_fbs        : 0

    Connector: DSI-1
            id             : 32
            encoder id     : 31
            conn           : connected
            size           : 95x151 (mm)
            count_modes    : 1
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 31
    Mode: "1200x1920" 1200x1920 60
    Connector: DP-1
            id             : 34
            encoder id     : 33
            conn           : connected
            size           : 600x340 (mm)
            count_modes    : 33
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 33
    Mode: "3840x2160" 3840x2160 60
    Mode: "3840x2160" 3840x2160 60
    ...

The associated display data pipeline can process up to 2.5K(2560 x 1600) with 60Hz refresh rate for DSI0, and
4K(3840 x 2160) with 60Hz refresh rate for DP.

.. _G700-evk-lvdsedp:

LVDS + eDP
----------

You can configure the LVDS + eDP combination with:

.. prompt:: bash

    genio-flash -i rity-demo-image --load-dtbo display-lvdsedp.dtbo

If you don't want to re-flash the entire root file system, you can simply update the overlay configuration with:

.. prompt:: bash

    genio-flash -i rity-demo-image --load-dtbo display-lvdsedp.dtbo kernel mmc0boot1

After boot into the console you can use ``modeprint mediatek`` command to check if both LVDS (in DSI-1) and eDP ports have been properly configured:

.. code-block:: text

    root@genio-700-evk:~# modeprint mediatek
    Starting test
    Resources

    count_connectors : 2
    count_encoders   : 2
    count_crtcs      : 2
    count_fbs        : 0

    Connector: DSI-1
            id             : 32
            encoder id     : 31
            conn           : connected
            size           : 87x155 (mm)
            count_modes    : 1
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 31
    Mode: "1920x1080" 1920x1080 60
    Connector: eDP-1
            id             : 34
            encoder id     : 33
            conn           : connected
            size           : 340x190 (mm)
            count_modes    : 1
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 33
    Mode: "1920x1080" 1920x1080 60

The associated display data pipeline can process up to FHD(1920 x 1080) with 60Hz refresh rate for LVDS, and
2.5K(2560 x 1600) with 60Hz refresh rate for eDP.

.. _G700-evk-lvdshdmi:

LVDS + HDMI
-----------

To enable LVDS + HDMI, load the `dtbo` file ``display-lvdshdmi.dtbo`` during flashing process:

.. prompt:: bash

    genio-flash -i rity-demo-image --load-dtbo display-lvdshdmi.dtbo

If you don't want to re-flash the entire root file system, you can simply update the overlay configuration with:

.. prompt:: bash

    genio-flash -i rity-demo-image --load-dtbo display-lvdshdmi.dtbo kernel mmc0boot1

After boot into the console you can use ``modeprint mediatek`` command to check if both LVDS (in DSI-1) and HDMI ports have been properly configured:

.. code-block:: text

    root@genio-700-evk:~# modeprint mediatek
    Starting test
    Resources

    count_connectors : 2
    count_encoders   : 2
    count_crtcs      : 2
    count_fbs        : 0

    Connector: DSI-1
            id             : 32
            encoder id     : 31
            conn           : connected
            size           : 87x155 (mm)
            count_modes    : 1
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 31
    Mode: "1920x1080" 1920x1080 60
    Connector: HDMI-A-1
            id             : 34
            encoder id     : 33
            conn           : connected
            size           : 700x390 (mm)
            count_modes    : 39
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 33
    Mode: "3840x2160" 3840x2160 60
    Mode: "3840x2160" 3840x2160 60
    ...

The associated display data pipeline can process up to 2.5K(2560 x 1600) with 60Hz refresh rate for LVDS, and
4K(3840 x 2160) with 60Hz refresh rate for HDMI.

.. _G700-evk-lvdsdp:

LVDS + DP
---------

To enable LVDS + DP, load the `dtbo` file ``display-lvdsdp.dtbo`` during flashing process:

.. prompt:: bash

    genio-flash -i rity-demo-image --load-dtbo display-lvdsdp.dtbo

If you don't want to re-flash the entire root file system, you can simply update the overlay configuration with:

.. prompt:: bash

    genio-flash -i rity-demo-image --load-dtbo display-lvdsdp.dtbo kernel mmc0boot1

After boot into the console you can use ``modeprint mediatek`` command to check if both LVDS (in DSI-1) and DP ports have been properly configured:

.. code-block:: text

    root@genio-700-evk:~# modeprint mediatek
    Starting test
    Resources

    root@genio-700-evk:~# modeprint mediatek
    Starting test
    Resources

    count_connectors : 2
    count_encoders   : 2
    count_crtcs      : 2
    count_fbs        : 0

    Connector: DSI-1
            id             : 32
            encoder id     : 31
            conn           : connected
            size           : 87x155 (mm)
            count_modes    : 1
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 31
    Mode: "1920x1080" 1920x1080 60
    Connector: DP-1
            id             : 34
            encoder id     : 33
            conn           : connected
            size           : 700x390 (mm)
            count_modes    : 27
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 33
    Mode: "3840x2160" 3840x2160 60
    Mode: "3840x2160" 3840x2160 30
    ...

The associated display data pipeline can process up to 2.5K(2560 x 1600) with 60Hz refresh rate for LVDS, and
4K(3840 x 2160) with 60Hz refresh rate for DP.

.. _G700-evk-edphdmi:

eDP + HDMI
----------

To enable Embedded DP and the AUO G156HAN03 panel, load the overlay file:

.. prompt:: bash

    genio-flash -i rity-demo-image --load-dtbo display-edphdmi.dtbo

If you don't want to re-flash the entire root file system, you can simply update the overlay configuration with:

.. prompt:: bash

    genio-flash -i rity-demo-image --load-dtbo display-edphdmi.dtbo kernel mmc0boot1

After boot into the console you can use ``modeprint mediatek`` command to check if both eDP and HDMI ports have been properly configured:

.. code-block:: text

    root@genio-700-evk:~# modeprint mediatek
    Starting test
    Resources

    count_connectors : 2
    count_encoders   : 2
    count_crtcs      : 2
    count_fbs        : 0

    Connector: eDP-1
            id             : 32
            encoder id     : 31
            conn           : connected
            size           : 340x190 (mm)
            count_modes    : 1
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 31
    Mode: "1920x1080" 1920x1080 60
    Connector: HDMI-A-1
            id             : 34
            encoder id     : 33
            conn           : connected
            size           : 600x340 (mm)
            count_modes    : 33
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 33
    Mode: "3840x2160" 3840x2160 60
    Mode: "3840x2160" 3840x2160 60
    ...

The associated display data pipeline can process up to 2.5K(2560 x 1600) with 60Hz refresh rate for eDP, and
4K(3840 x 2160) with 60Hz refresh rate for HDMI.

.. _G700-evk-edpdp:

eDP + DP
--------

You can configure the eDP + DP combination with:

.. prompt:: bash

    genio-flash -i rity-demo-image --load-dtbo display-edpdp.dtbo

If you don't want to re-flash the entire root file system, you can simply update the overlay configuration with:

.. prompt:: bash

    genio-flash -i rity-demo-image --load-dtbo display-edpdp.dtbo kernel mmc0boot1

After boot into the console you can use ``modeprint mediatek`` command to check if both eDP and DP ports have been properly configured:

.. code-block:: text

    root@genio-700-evk:~# modeprint mediatek
    Starting test
    Resources

    count_connectors : 2
    count_encoders   : 2
    count_crtcs      : 2
    count_fbs        : 0

    Connector: eDP-1
            id             : 32
            encoder id     : 31
            conn           : connected
            size           : 340x190 (mm)
            count_modes    : 1
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 31
    Mode: "1920x1080" 1920x1080 60
    Connector: DP-1
            id             : 34
            encoder id     : 33
            conn           : connected
            size           : 600x340 (mm)
            count_modes    : 33
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 33
    Mode: "3840x2160" 3840x2160 60
    Mode: "3840x2160" 3840x2160 60
    ...

The associated display data pipeline can process up to 2.5K(2560 x 1600) with 60Hz refresh rate for eDP, and
4K(3840 x 2160) with 60Hz refresh rate for DP.

.. _G700-evk-hdmidp:

HDMI + DP
---------

To enable HDMI + DP, load the `dtbo` file ``display-hdmidp.dtbo`` during flashing process:

.. prompt:: bash

    genio-flash -i rity-demo-image --load-dtbo display-hdmidp.dtbo

If you don't want to re-flash the entire root file system, you can simply update the overlay configuration with:

.. prompt:: bash

    genio-flash -i rity-demo-image --load-dtbo display-hdmidp.dtbo kernel mmc0boot1

After boot into the console you can use ``modeprint mediatek`` command to check if both HDMI and DP ports have been properly configured:

.. code-block:: text

    root@genio-700-evk:~# modeprint mediatek
    Starting test
    Resources

    count_connectors : 2
    count_encoders   : 2
    count_crtcs      : 2
    count_fbs        : 0

    Connector: HDMI-A-1
            id             : 32
            encoder id     : 31
            conn           : connected
            size           : 600x340 (mm)
            count_modes    : 33
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 31
    Mode: "3840x2160" 3840x2160 60
    Mode: "3840x2160" 3840x2160 60
    ...

    Connector: DP-1
            id             : 34
            encoder id     : 33
            conn           : connected
            size           : 600x340 (mm)
            count_modes    : 33
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 33
    Mode: "3840x2160" 3840x2160 60
    Mode: "3840x2160" 3840x2160 60
    ...

.. note::
    Due to the limitation of display data pipelines, the associated display data pipeline is limited to 4K(3840 x 2160)
    with **30Hz** refresh rate for HDMI, while 4K(3840 x 2160) with 60Hz refresh rate for DP.

.. _G700-evk-edp-setup:

Hardware Setup for eDP
=======================

The prebuilt `rity-demo-image` supports AUO G156HAN03 panel with a eDP cable, as shown below:

.. figure:: /_asset/sw_rity_display_G700_eDP-cable.jpg
    :align: center
    :width: 55%

Please always use this associated cable to connect to the panel. Connect either side to the |G510-G700-EVK| board
and to the panel, as shown below:

.. figure:: /_asset/sw_rity_display_G700_eDP-install.jpg
    :align: center
    :width: 35%

.. _G700-evk-lvds-setup:

Hardware Setup for DSI0 to LVDS
===============================

The prebuilt `rity-demo-image` supports ``DSI0`` to ``IT6122 Converter Daughter Board`` to ``KOE TX18D204VM0BAA panel``.

.. note::

    - The IT6122 Converter Daughter Board doesn't not come with the |G510-G700-EVK| set. Please contact MTK CPM to obtain one.

An example of the daughter board is shown below:

.. figure:: /_asset/sw_rity_display_G700_DSI_to_LVDS_DTB.jpg
    :align: center
    :width: 35%

To install the daughter board, turn both the EVK and the daughter board to the back side, then replace the pre-connected DSI panel LCM0 and CTP0 cables with those on the daughter board.

.. figure:: /_asset/sw_rity_display_G700_DSI_to_LVDS_install_DTB.jpg
    :align: center
    :width: 35%

Turn both the EVK and the daughter board to the front side, then connect the LVDS cable to the daughter board.

.. figure:: /_asset/sw_rity_display_G700_DSI_to_LVDS_install_panel.jpg
    :align: center
    :width: 35%

A complete setup example is provided below. Note that the DSI panel in the example is not connected to the EVK.

.. figure:: /_asset/sw_rity_display_G700_DSI_to_LVDS_install_example.jpg
    :align: center
    :width: 35%

Related Kernel Source Files
============================

- The `Genio 700 EVK board dts file <https://gitlab.com/mediatek/aiot/bsp/linux/-/blob/mtk-v5.15-dev/arch/arm64/boot/dts/mediatek/genio-700-evk.dts>`_ is located in the kernel path ``arch/arm64/boot/dts/mediatek/genio-700-evk.dts``.

- The `Genio 510 EVK board dts file <https://gitlab.com/mediatek/aiot/bsp/linux/-/blob/mtk-v5.15-dev/arch/arm64/boot/dts/mediatek/genio-510-evk.dts>`_ is located in the kernel path ``arch/arm64/boot/dts/mediatek/genio-510-evk.dts``.

- The driver for display data path and interfaces are located under the ``drivers/gpu/drm/mediatek``, the same as other DRM drivers.

- The driver for PHY hardware are located under the ``drivers/phy/mediatek`` path, such as:

    * `drivers/phy/mediatek/phy-mtk-dp.c <https://gitlab.com/mediatek/aiot/bsp/linux/-/blob/mtk-v5.15-dev/drivers/phy/mediatek/phy-mtk-dp.c>`_
    * `drivers/phy/mediatek/phy-mtk-hdmi-mt8195.c <https://gitlab.com/mediatek/aiot/bsp/linux/-/blob/mtk-v5.15-dev/drivers/phy/mediatek/phy-mtk-hdmi-mt8195.c>`_

- The USB Type-C associated drivers:

    * IT5205 driver are located in ``drivers/usb/typec/mux/it5205fn.c``
    * The MT6360 driver for USB Type-C are located in ``drivers/usb/typec/tcpm/tcpci_mt6360.c`` 

Please note that the support for MT8370/MT8390 on |IOT-YOCTO| starts from ``mtk-v5.15`` kernel and the Yocto ``kirkstone`` branch.

The `device tree overlay files <https://gitlab.com/mediatek/aiot/rity/meta-mediatek-bsp/-/tree/kirkstone/recipes-kernel/dtbo/genio-700-evk>`_ are not located in the kernel source.
Instead, these overlay files are managed in the Yocto meta layer ``meta-mediatek-bsp``'s ``kirkstone/recipes-kernel/dtbo/genio-700-evk`` directory.