.. include:: ../substitutions.rst

Display (OLDI)
==============

The phyCORE-AM62x SOM supports one 24-bit RGB parallel video output (VOUT) that can be used with Parallel MIPI DPI 2.0 (Digital Pixel Interface) or BT.656/BT.1120 interface. The phyCORE-AM62x SOM also brings out two OLDI display ports, each with up to four data lanes and one clock lane to support 21/28-bit serialized RGB pixel data and synchronization transmissions. The first port, OLDI0, consists of OLDI0_A0-3/CLK0 and corresponds to odd pixels, while the second port, OLDI1, consists of OLDI0_A4-7/CLK1 and corresponds to even pixels. This guide will show you how to show 3 different LCD touch displays connected to the OLDI0 interface of the phyCORE-AM62x. For more information on the OLDI interface, see section 8.2 in the `Hardware Manual <https://www.phytec.com/product/phycore-am62x/#section-hardware-documentation>`_.

.. image:: ../../images/phycore-am62x/pb-07124_display.webp
   :width: 800px
   :alt: phyCORE-AM62x Display


Requirements
------------

The development kit supports 3 different 10" displays: Lincoln, Glyn and Powertip. The displays are custom solutions from each partner.

**Lincoln 10" LVDS Display**

* `KLCD-185-000 <https://www.phytec.com/product/lincoln-10-lvds-display/>`_: A PHYTEC Accessory Kit

  * Included in the kit:

    * Lincoln Technology Solutions, 10.1" PCAP LCD (LCD185-101CTL1AGNTTR1.2)
    * Display adapter PCB (PCB-L0136R1.2)
    * 1x `8" 40-pin FFC/FPC cable (opposite-side terminals, 0.5mm pitch) <https://www.digikey.com/en/products/detail/molex/0151660440/3281321>`_
    * 5V 1A USB-C power adapter

**GLYN 10" LVDS Display**

* KLCD-AC200-000 (`Contact Sales <https://www.phytec.com/contact/>`_): A PHYTEC Accessory Kit

  * Included in the kit:

    * Glyn 10" touch display (G-ETML1010G3DRA*K0)
    * PHYTEC adapter board DH-029
    * 1x `8" 40-pin FFC/FPC cable (same-side terminals, 0.5mm pitch) <https://www.digikey.com/en/products/detail/molex/0152660439/3161173>`_
    * 12V Phoenix 2-pin power adapter

**Powertip 10.1" LVDS Display**

* KLCD-AC209-000 (`Contact Sales <https://www.phytec.com/contact/>`_): A PHYTEC Accessory Kit

  * Included in the kit:

    * Powertip 10.1" touch display (PH128800T-006-ZHC01)
    * PHYTEC adapter board KSP-0100-AC209A0
    * 1x `8" 40-pin FFC/FPC cable (same-side terminals, 0.5mm pitch) <https://www.digikey.com/en/products/detail/molex/0152660439/3161173>`_
    * 12V Phoenix 2-pin power adapter

.. note::
   Be sure that you are not using a headless BSP image as this does not support the display interface.


Connecting the Display
----------------------

* Power off the development kit and disconnect the power supply.

* Connect the display to the development kit's X55 connector via the 40pin FFC ribbon cable.

    #. Open the X55 connector by pulling the black tab backwards toward the center of the carrier board.
    #. Insert the ribbon cable into the connector, with the blue tape facing outward.
    #. Once the ribbon cable has been seated into the connector, pull the black tab back towards it's closed position. You should hear a small click when the connector has completely closed.

.. image:: ../../images/phycore-am62x/pb-07124_LCD185_connection.webp
   :width: 500px
   :alt: phyCORE-AM62x Development Kit Connected to the Lincoln Display

.. image:: ../../images/phycore-am62x/pb-07124-display-ac200-kit-callout.webp
   :width: 500px
   :alt: phyCORE-AM62x Development Kit Connected to the Glyn Display

.. image:: ../../images/phycore-am62x/pb-07124-display-ac209A-kit-callout.webp
   :width: 500px
   :alt: phyCORE-AM62x Development Kit Connected to the Powertip Display

* Connect the external power supply to the display adapter.


Loading the Display
-------------------

* Power on the development kit and hit any key to stop in U-Boot.

* Load the device tree overlay needed for operating the display.

.. code-block:: console
   :substitutions:

   #For the Lincoln LCD185 display
   |uboot-prompt| setenv overlays |intf-display-lcd185-overlay|
   # For the Glyn AC200 display
   |uboot-prompt| setenv overlays |intf-display-ac200-overlay|
   # For the Powertip AC209A display
   |uboot-prompt| setenv overlays |intf-display-ac209a-overlay|

* **Glyn AC200 and Powertip AC209 displays only**. These displays are single lane LVDS, the optargs variable needs to be turned OFF fw_devlink for these displays to function.

.. code-block:: console
   :substitutions:

   |uboot-prompt| setenv optargs fw_devlink=off

* Boot into Linux

.. code-block:: console
   :substitutions:

   |uboot-prompt| saveenv
   |uboot-prompt| boot

.. note::
   For more information about overlays see chapter :ref:`ConfiguringTheBootloader-62`.

* While the kit is booting, the PHYTEC logo with a loading bar should appear followed by a green and blue qt6demo app screen.

.. note::
   The qtdemo can be interacted with on the LCD by plugging a keyboard or mouse usb hub into the development kit.

* The demo can be stopped by running the following command:

.. code-block:: console
   :substitutions:

   |target-prompt| systemctl stop qtphy