.. 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 overlay dtbos and description link of each dtbo.

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

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

.. list-table:: Headless dtbo
   :widths: 30 30
   :header-rows: 1

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

.. list-table:: Single Display dtbos
   :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>`

.. list-table:: Dual Display dtbos
   :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 dtbos, 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 dtbo 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 doest 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.