.. include:: /keyword.rst

.. _display-g1200-evk:

============
|G1200-EVK|
============

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

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

Display Interfaces on |G1200-EVK-REF-BOARD|
============================================

|IOT-YOCTO| supports five display interfaces on |G1200-EVK-REF-BOARD|: 

* :ref:`DSI0 <G1200-evk-dsi-setup>`
* :ref:`HDMI TX <G1200-evk-hdmi-setup>`
* :ref:`DisplayPort(DP) <G1200-evk-dp-setup>` through USB Type-C port
* :ref:`Embedded Display Port(eDP) <G1200-evk-edp-setup>` with eDP Panel ``INNOLUX HK173VB-01B``
* :ref:`LVDS <G1200-evk-lvds-setup>` with LVDS Panel ``KOE TX18D204VM0BAA``

The board can be used headless or in single, dual and triple display configurations.

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

VDOSYS0-main and VDOSYS0-sub provide individual 3840x2160, 30Hz refresh rate and can be merged into one 3840x2160, 60Hz refresh rate display pipeline. 
VDOSYS1 provides 3840x2160, 60Hz refresh rate.

In the case of dual display combinations, VDOSYS0-main and VDOSYS0-sub are merged into one pipeline, together with VDOSYS1 to connect two connectors.
In the case of triple display combinations, VDOSYS0-main, VDOSYS0-sub, and VDOSYS1 are independent pipelines to connect three connectors.

Default `rity-demo-image` enables dual display DSI0 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.

.. _G1200-evk-dsi-setup:
.. _G1200-evk-hdmi-setup:
.. _G1200-evk-dp-setup:
.. list-table:: G1200 EVK Display Ports
   :widths: 50 35 50
   :header-rows: 1

   * - .. figure:: /_asset/sw_rity_display_G1200-evk_display_interfaces_front.png
     - .. figure:: /_asset/sw_rity_display_G1200-evk_display_interfaces_front_dsi.jpg
     - .. figure:: /_asset/sw_rity_display_G1200-evk_display_interfaces_back.png
   * - top view without DSI panel installed (showing DPoC, eDP, HDMI TX, HDMI RX)
     - side view with DSI panel installed
     - bottom view without DSI panel installed (showing LVDS, DSI0, DSI1)

.. note::

    - DSI1 port (LCM2) is still not supported on |IOT-YOCTO| in v25.x.
    - The LVDS connector is not supported in the v25.x migration. Please refer to the v24.1 implementation. LVDS shares the same data lanes as the eDP connector, so only one of them can be used at a time.

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

Starting from v25, none of the EVK default DTS files enable any display interfaces; loading the relevant DTBOs is required to enable them.
For the G1200 EVK, the default configuration loads ``display-dsi.dtbo`` and ``display-hdmi.dtbo``.

.. code-block:: bash

    $ genio-flash -i rity-demo-image
	Genio Tools: v1.7.0a1
	Yocto Image:
        ...
        machine:  genio-1200-evk
        overlays: ['display-hdmi.dtbo', 'video.dtbo', 'display-dsi.dtbo', 'apusys.dtbo']

If you do not need ``display-dsi.dtbo``, use the unload-dtbo option to remove the default ``display-dsi.dtbo``

.. code-block:: bash

    $ genio-flash -i rity-demo-image --unload-dtbo display-dsi.dtbo
	Genio Tools: v1.7.0a1
	Yocto Image:
        ...
        machine:  genio-1200-evk
        overlays: ['display-hdmi.dtbo', 'video.dtbo', 'apusys.dtbo']

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
   * - ``display-dsi.dtbo`` + ``display-hdmi.dtbo``
     - :ref:`DSI0 + HDMI <G1200-evk-dsihdmi>`

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

   * - `dtbo`
     - Description
   * - No need `dtbo`
     - :ref:`Headless <G1200-evk-headless>`

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

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

.. _G1200-evk-dual-dt:

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

   * - `dtbo`
     - Description
   * - ``display-dsi.dtbo`` + ``display-edp.dtbo``
     - :ref:`DSI0 + eDP <G1200-evk-dsiedp>`
   * - ``display-dsi.dtbo`` + ``display-dp.dtbo``
     - :ref:`DSI0 + DP <G1200-evk-dsidp>`
   * - ``display-edp.dtbo`` + ``display-hdmi.dtbo``
     - :ref:`eDP + HDMI <G1200-evk-edphdmi>`
   * - ``display-edp.dtbo`` + ``display-dp.dtbo``
     - :ref:`eDP + DP <G1200-evk-edpdp>`
   * - ``display-hdmi.dtbo`` + ``display-dp.dtbo``
     - :ref:`HDMI + DP <G1200-evk-hdmidp>`

.. _G1200-evk-triple-dt:

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

   * - `dtbo`
     - Description
   * - ``display-dsiedphdmi.dtbo``
     - :ref:`DSI0 + eDP + HDMI <G1200-evk-dsiedphdmi>`
   * - ``display-dsiedpdp.dtbo``
     - :ref:`DSI0 + eDP + DP <G1200-evk-dsiedpdp>`
   * - ``display-dsihdmidp.dtbo``
     - :ref:`DSI0 + HDMI + DP <G1200-evk-dsihdmidp>`
   * - ``display-edphdmidp.dtbo``
     - :ref:`eDP + HDMI + DP <G1200-evk-edphdmidp>`

.. _G1200-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 G1200 EVK.

Flash the board with:

.. code-block:: bash

    $ genio-flash -i rity-demo-image
	Genio Tools: v1.7.0a1
	Yocto Image:
        ...
        machine:  genio-1200-evk
        overlays: ['display-hdmi.dtbo', 'video.dtbo', 'display-dsi.dtbo', 'apusys.dtbo']

As shown in the example above, both ``display-dsi.dtbo`` and ``display-hdmi.dtbo`` are loaded by default.

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-1200-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.

.. _G1200-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, unload the overlay file ``display-dsi.dtbo`` and ``display-hdmi.dtbo`` during flashing process:

.. prompt:: bash

    genio-flash -i rity-demo-image --unload-dtbo display-dsi.dtbo --unload-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 --unload-dtbo display-dsi.dtbo --unload-dtbo display-hdmi.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-1200-evk:~# modeprint mediatek
    Starting test
    Resources

    count_connectors : 0
    count_encoders   : 0

.. _G1200-evk-dsi:

DSI0
----

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

.. prompt:: bash

    genio-flash -i rity-demo-image --unload-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 --unload-dtbo display-hdmi.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-1200-evk:~# modeprint mediatek
    Starting test
    Resources

    count_connectors : 1
    count_encoders   : 1
    count_crtcs      : 3
    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.

.. _G1200-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 --unload-dtbo display-dsi.dtbo --unload-dtbo display-hdmi.dtbo --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 --unload-dtbo display-dsi.dtbo --unload-dtbo display-hdmi.dtbo --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-1200-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           : 380x210 (mm)
            count_modes    : 1
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 31
    Mode: "3840x2160" 3840x2160 60

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

.. _G1200-evk-hdmi:

HDMI
----

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

.. prompt:: bash

    genio-flash -i rity-demo-image --unload-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 --unload-dtbo display-dsi.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-1200-evk:~# modeprint mediatek
    Starting test
    Resources

    count_connectors : 1
    count_encoders   : 1
    count_crtcs      : 3
    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.

.. _G1200-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 --unload-dtbo display-dsi.dtbo --unload-dtbo display-hdmi.dtbo --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 --unload-dtbo display-dsi.dtbo --unload-dtbo display-hdmi.dtbo --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-1200-evk:~# modeprint mediatek
    Starting test
    Resources

    count_connectors : 1
    count_encoders   : 1
    count_crtcs      : 3
    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.

.. _G1200-evk-dsiedp:

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

You can configure the DSI0 + eDP combination with:

.. prompt:: bash

    genio-flash -i rity-demo-image --unload-dtbo display-hdmi.dtbo --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 --unload-dtbo display-hdmi.dtbo --load-dtbo display-edp.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-1200-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           : 380x210 (mm)
            count_modes    : 1
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 33
    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 eDP.

.. _G1200-evk-dsidp:

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

You can configure the DSI0 + eDP combination with:

.. prompt:: bash

    genio-flash -i rity-demo-image --unload-dtbo display-hdmi.dtbo --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 --unload-dtbo display-hdmi.dtbo --load-dtbo display-dp.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-1200-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    : 26
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 33
    Mode: "3840x2160" 3840x2160 60
    Mode: "3840x2160" 3840x2160 50
    ...

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.

.. _G1200-evk-edphdmi:

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

You can configure the eDP + HDMI combination with:

.. prompt:: bash

    genio-flash -i rity-demo-image --unload-dtbo display-dsi.dtbo --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 --unload-dtbo display-dsi.dtbo --load-dtbo display-edp.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-1200-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           : 380x210 (mm)
            count_modes    : 1
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 31
    Mode: "3840x2160" 3840x2160 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 4K(3840 x 2160) with 60Hz refresh rate for eDP, and
4K(3840 x 2160) with 60Hz refresh rate for HDMI.

.. _G1200-evk-edpdp:

eDP + DP
--------

You can configure the eDP + DP combination with:

.. prompt:: bash

    genio-flash -i rity-demo-image --unload-dtbo display-dsi.dtbo --unload-dtbo display-hdmi.dtbo --load-dtbo display-edp.dtbo --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 --unload-dtbo display-dsi.dtbo --unload-dtbo display-hdmi.dtbo --load-dtbo display-edp.dtbo --load-dtbo display-dp.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-1200-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           : 380x210 (mm)
            count_modes    : 1
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 31
    Mode: "3840x2160" 3840x2160 60
    Connector: DP-1
            id             : 34
            encoder id     : 33
            conn           : connected
            size           : 600x340 (mm)
            count_modes    : 26
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 33
    Mode: "3840x2160" 3840x2160 60
    Mode: "3840x2160" 3840x2160 50
    ...

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

.. _G1200-evk-hdmidp:

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

You can configure the HDMI + DP combination with:

.. prompt:: bash

    genio-flash -i rity-demo-image --unload-dtbo display-dsi.dtbo --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 --unload-dtbo display-dsi.dtbo --load-dtbo display-dp.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-1200-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    : 26
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 33
    Mode: "3840x2160" 3840x2160 60
    Mode: "3840x2160" 3840x2160 50
    ...

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

.. note::
    - For the triple display overlay, since there is an extra pipe setting for each encoder, we keep the original triple display overlay mechanism instead of loading three single-connector overlays. Unload both the DSI and HDMI DTBOs, and load the triple display DTBO.
    - As you can see, the ``mediatek,indicated-display-path`` tag is added to each encoder node in the overlay.

.. _G1200-evk-dsiedphdmi:

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

To enable DSI0 + eDP + HDMI, load the overlay file ``display-dsiedphdmi.dtbo`` during flashing process:

.. prompt:: bash

    genio-flash -i rity-demo-image --unload-dtbo display-dsi.dtbo --unload-dtbo display-hdmi.dtbo --load-dtbo display-dsiedphdmi.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 --unload-dtbo display-dsi.dtbo --unload-dtbo display-hdmi.dtbo --load-dtbo display-dsiedphdmi.dtbo kernel mmc0boot1

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

.. code-block:: text

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

    count_connectors : 3
    count_encoders   : 3
    count_crtcs      : 3
    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           : 380x210 (mm)
            count_modes    : 1
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 33
    Mode: "3840x2160" 3840x2160 60
    Connector: HDMI-A-1
            id             : 36
            encoder id     : 35
            conn           : connected
            size           : 930x390 (mm)
            count_modes    : 30
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 35
    Mode: "3440x1440" 3440x1440 72
    Mode: "3840x2160" 3840x2160 60
    ...

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

.. _G1200-evk-dsiedpdp:

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

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

.. prompt:: bash

    genio-flash -i rity-demo-image --unload-dtbo display-dsi.dtbo --unload-dtbo display-hdmi.dtbo --load-dtbo display-dsiedpdp.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 --unload-dtbo display-dsi.dtbo --unload-dtbo display-hdmi.dtbo --load-dtbo display-dsiedpdp.dtbo kernel mmc0boot1

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

.. code-block:: text

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

    count_connectors : 3
    count_encoders   : 3
    count_crtcs      : 3
    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           : 380x210 (mm)
            count_modes    : 1
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 33
    Mode: "3840x2160" 3840x2160 60
    Connector: DP-1
            id             : 36
            encoder id     : 35
            conn           : connected
            size           : 700x390 (mm)
            count_modes    : 27
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 35
    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 DSI0,
4K(3840 x 2160) with 30Hz refresh rate for eDP, and 4K(3840 x 2160) with 60Hz refresh rate for DP.

.. _G1200-evk-dsihdmidp:

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

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

.. prompt:: bash

    genio-flash -i rity-demo-image --unload-dtbo display-dsi.dtbo --unload-dtbo display-hdmi.dtbo --load-dtbo display-dsihdmidp.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 --unload-dtbo display-dsi.dtbo --unload-dtbo display-hdmi.dtbo --load-dtbo display-dsihdmidp.dtbo kernel mmc0boot1

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

.. code-block:: text

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

    count_connectors : 3
    count_encoders   : 3
    count_crtcs      : 3
    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           : 930x390 (mm)
            count_modes    : 30
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 33
    Mode: "3440x1440" 3440x1440 72
    Mode: "3840x2160" 3840x2160 60
    ...
    Connector: DP-1
            id             : 36
            encoder id     : 35
            conn           : connected
            size           : 700x390 (mm)
            count_modes    : 27
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 35
    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 DSI0,
4K(3840 x 2160) with 60Hz refresh rate for HDMI, and 4K(3840 x 2160) with 30Hz refresh rate for DP.

.. _G1200-evk-edphdmidp:

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

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

.. prompt:: bash

    genio-flash -i rity-demo-image --unload-dtbo display-dsi.dtbo --unload-dtbo display-hdmi.dtbo --load-dtbo display-edphdmidp.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 --unload-dtbo display-dsi.dtbo --unload-dtbo display-hdmi.dtbo --load-dtbo display-edphdmidp.dtbo kernel mmc0boot1

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

.. code-block:: text

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

    count_connectors : 3
    count_encoders   : 3
    count_crtcs      : 3
    count_fbs        : 0

    Connector: eDP-1
            id             : 32
            encoder id     : 31
            conn           : connected
            size           : 380x210 (mm)
            count_modes    : 1
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 31
    Mode: "3840x2160" 3840x2160 60
    Connector: HDMI-A-1
            id             : 34
            encoder id     : 33
            conn           : connected
            size           : 930x390 (mm)
            count_modes    : 30
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 33
    Mode: "3440x1440" 3440x1440 72
    Mode: "3840x2160" 3840x2160 60
    ...
    Connector: DP-1
            id             : 36
            encoder id     : 35
            conn           : connected
            size           : 700x390 (mm)
            count_modes    : 27
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 35
    Mode: "3840x2160" 3840x2160 60
    Mode: "3840x2160" 3840x2160 30
    ...

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

.. _G1200-evk-edp-setup:

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

The prebuilt `rity-demo-image supports` ``INNOLUX HK173VB-01B`` panel with an eDP cable, as shown below:

.. figure:: /_asset/sw_rity_display_G1200_evk_eDP-cable.jpg
    :align: center
    :width: 35%

Please always use this associated cable to connect to the panel. Connect either side to the |G1200-EVK-REF-BOARD| board
and to the panel. Make sure to remove the jumper on the |G1200-EVK-REF-BOARD| board to enable the eDP path, as shown below:

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

.. _G1200-evk-lvds-setup:

Hardware Setup for LVDS
========================

The prebuilt `rity-demo-image` supports ``KOE TX18D204VM0BAA`` panel with a LVDS cable, as shown below:

.. figure:: /_asset/sw_rity_display_G1200_evk_LVDS-cable.jpg
    :align: center
    :width: 35%

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

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

Make sure to connect a jumper on the |G1200-EVK-REF-BOARD| board to enable LVDS path, as shown below:
	
.. figure:: /_asset/sw_rity_display_G1200_evk_LVDS-jumper.jpg
    :align: center
    :width: 25%

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

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

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

- The drivers for the panels are located under ``drivers/gpu/drm/panel``, such as:

    * DSI ``STARTEK KD070FHFID078``: `drivers/gpu/drm/panel/panel-startek-kd070fhfid078.c <https://gitlab.com/mediatek/aiot/bsp/linux/-/blob/mtk-v6.6/drivers/gpu/drm/panel/panel-startek-kd070fhfid078.c>`_
    * eDP common driver: `drivers/gpu/drm/panel/panel-edp.c <https://gitlab.com/mediatek/aiot/bsp/linux/-/blob/mtk-v6.6/drivers/gpu/drm/panel/panel-edp.c>`_

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

    * DSI: `drivers/phy/mediatek/phy-mtk-mipi-dsi.c <https://gitlab.com/mediatek/aiot/bsp/linux/-/blob/mtk-v6.6/drivers/phy/mediatek/phy-mtk-mipi-dsi.c>`_
    * DP/eDP: `drivers/phy/mediatek/phy-mtk-dp.c <https://gitlab.com/mediatek/aiot/bsp/linux/-/blob/mtk-v6.6/drivers/phy/mediatek/phy-mtk-dp.c>`_
    * HDMI: `drivers/phy/mediatek/phy-mtk-hdmi-mt8195.c <https://gitlab.com/mediatek/aiot/bsp/linux/-/blob/mtk-v6.6/drivers/phy/mediatek/phy-mtk-hdmi-mt8195.c>`_

- The drivers for the USB Type-C associated modules are located under ``drivers/usb/typec``, such as:

    * ``IT5205`` (altmode mux): `drivers/usb/typec/mux/it5205fn.c <https://gitlab.com/mediatek/aiot/bsp/linux/-/blob/mtk-v6.6/drivers/usb/typec/mux/it5205fn.c>`_
    * ``MT6360`` (PD for USB Type-C): `drivers/usb/typec/tcpm/tcpci_mt6360.c <https://gitlab.com/mediatek/aiot/bsp/linux/-/blob/mtk-v6.6/drivers/usb/typec/tcpm/tcpci_mt6360.c>`_

Please note that support for MT8395 on |IOT-YOCTO| starts from the ``mtk-v5.15`` kernel and the Yocto ``kirkstone`` branch.
On v25.x, we are using the ``mtk-v6.6`` kernel and the Yocto ``scarthgap`` branch.

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