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

.. _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 v23.1.
    - The LVDS connector shares the same data lanes with the eDP 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 `dtbo`.

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

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

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

   * - `dtbo`
     - Description
   * - ``display-headless.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-edp2lvds.dtbo``
     - :ref:`eDP to LVDS <G1200-evk-edp2lvds>`
   * - ``display-hdmi.dtbo``
     - :ref:`HDMI <G1200-evk-hdmi>`
   * - ``display-dp.dtbo``
     - :ref:`DP <G1200-evk-dp>`

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

   * - `dtbo`
     - Description
   * - ``display-dsiedp.dtbo``
     - :ref:`DSI0 + eDP <G1200-evk-dsiedp>`
   * - ``display-dsilvds.dtbo``
     - :ref:`DSI0 + LVDS <G1200-evk-dsilvds>`
   * - ``display-dsidp.dtbo``
     - :ref:`DSI0 + DP <G1200-evk-dsidp>`
   * - ``display-edphdmi.dtbo``
     - :ref:`eDP + HDMI <G1200-evk-edphdmi>`
   * - ``display-edpdp.dtbo``
     - :ref:`eDP + DP <G1200-evk-edpdp>`
   * - ``display-lvdshdmi.dtbo``
     - :ref:`LVDS + HDMI <G1200-evk-lvdshdmi>`
   * - ``display-lvdsdp.dtbo``
     - :ref:`LVDS + DP <G1200-evk-lvdsdp>`
   * - ``display-hdmidp.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-dsilvdshdmi.dtbo``
     - :ref:`DSI0 + LVDS + HDMI <G1200-evk-dsilvdshdmi>`
   * - ``display-dsilvdsdp.dtbo``
     - :ref:`DSI0 + LVDS + DP <G1200-evk-dsilvdsdp>`
   * - ``display-dsihdmidp.dtbo``
     - :ref:`DSI0 + HDMI + DP <G1200-evk-dsihdmidp>`
   * - ``display-edphdmidp.dtbo``
     - :ref:`eDP + HDMI + DP <G1200-evk-edphdmidp>`
   * - ``display-lvdshdmidp.dtbo``
     - :ref:`LVDS + HDMI + DP <G1200-evk-lvdshdmidp>`

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

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-1200-evk.dts>`_ 
of the |G1200-EVK-REF-BOARD| 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.1 ``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-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, 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-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, 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-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 --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-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-edp2lvds:

eDP to LVDS
-----------

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

.. prompt:: bash

    genio-flash -i rity-demo-image --load-dtbo display-edp2lvds.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

.. note::

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

After boot into the console you can use ``modeprint mediatek`` command to check if LVDS (in eDP-1) 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           : 170x100 (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.

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

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

.. 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-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-dsilvds:

DSI0 + LVDS
-----------

To enable DSI0 + LVDS, load the overlay file ``display-dsilvds.dtbo`` during flashing process:

.. prompt:: bash

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

After boot into the console you can use ``modeprint mediatek`` command to check if both DSI0 and LVDS (in eDP-1) 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           : 170x100 (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
FHD(1920 x 1080) with 60Hz refresh rate for LVDS

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

To enable Embedded DP + ``INNOLUX HK173VB-01B`` panel + HDMI, load the overlay file ``display-edphdmi.dtbo`` during flashing process:

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

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

.. 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-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-lvdshdmi:

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

To enable LVDS + ``KOE TX18D204VM0BAA`` panel + HDMI, load the overlay 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 eDP-1) 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           : 170x100 (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 FHD(1920 x 1080) with 60Hz refresh rate for LVDS, and
4K(3840 x 2160) with 60Hz refresh rate for HDMI

.. _G1200-evk-lvdsdp:

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

To enable LVDS + DP, load the overlay 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 eDP-1) 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           : 170x100 (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    : 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 FHD(1920 x 1080) with 60Hz refresh rate for LVDS, and
4K(3840 x 2160) with 60Hz refresh rate for DP

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

.. _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 --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 --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 --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 --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-dsilvdshdmi:

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

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

.. prompt:: bash

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

After boot into the console you can use ``modeprint mediatek`` command to check if DSI0, LVDS (in eDP-1) 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           : 170x100 (mm)
            count_modes    : 1
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 33
    Mode: "1920x1080" 1920x1080 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,
FHD(1920 x 1080) with 60Hz refresh rate for LVDS, and 4K(3840 x 2160) with 60Hz refresh rate for HDMI.

.. _G1200-evk-dsilvdsdp:

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

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

.. prompt:: bash

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

After boot into the console you can use ``modeprint mediatek`` command to check if DSI0, LVDS (in eDP-1) 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           : 170x100 (mm)
            count_modes    : 1
            count_props    : 5
            props          : 1 2 5 6 4
            count_encoders : 1
            encoders       : 33
    Mode: "1920x1080" 1920x1080 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,
FHD(1920 x 1080) with 60Hz refresh rate for LVDS, 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 --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 --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 --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 --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-lvdshdmidp:

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

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

.. prompt:: bash

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

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

.. code-block:: text

    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           : 170x100 (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           : 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 FHD(1920 x 10800) with 60Hz refresh rate for LVDS,
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 `board dts file <https://gitlab.com/mediatek/aiot/bsp/linux/-/blob/mtk-v5.15-dev/arch/arm64/boot/dts/mediatek/genio-1200-evk.dts>`_ is located in the kernel path ``arch/arm64/boot/dts/mediatek/genio-1200-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 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-1200-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-1200-evk`` directory.