Search by Tags

Setting up Displays with Torizon

 

Article updated at 17 Feb 2021
Compare with Revision




Subscribe for this article updates

Select the version of your OS from the tabs below. If you don't know the version you are using, run the command cat /etc/os-release or cat /etc/issue on the board.



Remember that you can always refer to the Torizon Documentation, there you can find a lot of relevant articles that might help you in the application development.

Torizon 5.0.0

Introduction

During the development cycle of a product with a GUI, you usually go through 3 phases when it comes to displays:

Evaluation: often, you will do a basic evaluation using a regular monitor over VGA/DVI-D/HDMI - or similar interfaces, if available. We provide an out-of-the-box experience, where you plug in the monitor and power-on the hardware.

Proof of Concept/Prototype: even with the advantages of cross-development tools and IDEs enabling a good experience for developing GUIs in a development computer, it is often common to make tests on the real end device. We sell touch screen displays that either deliver an out-of-the-box experience or a relatively easy configuration.

Development and Production: often, you want or need a custom display in your final product. The reasons are various: price, robustness, brightness, size, interface, EMI compliance, among others. Supporting a custom display is not an easy task for a beginner, mainly if you use a display with insufficient documentation and Linux support. We document how to enable a custom display, but you must expect that some effort is associated with the process.

Toradex tests and recommends using the following displays with its Computer on Modules (CoM) during early phases of development:

It is often necessary to modify the Linux Device Tree to integrate a display to the board and configure its pin and timing settings. Device Tree Overlays provide a way to alter the overall device tree without the need for re-compiling the complete Device Tree.

For the display listed previously, Toradex provides an easy way to set-up and get it running with ready-to-use device tree overlays. It also means that you can tweak the existing overlays to support other displays as well. This article lists the available Device Tree Overlays provided by Toradex and how to enable it on TorizonCore.

This article complies to the Typographic Conventions for Torizon Documentation.

Using a Monitor

All computer on modules have a default display interface enabled by default. Unless explicitly stated otherwise, the following interfaces are enabled by default:

  • Colibri Family: RGB interface, commonly connected to VGA, DVI-A, or the Unified Display Interface on our carrier boards.
    • You can use a VGA monitor, with possibly a DVI-A to VGA connector depending on the carrier board you are using.
    • With the default fixed VGA resolution, the Portainer application may seem "too big" for the display. Read Display Output, Resolution and Timings (Linux) for more information on changing the display resolution.
  • Apalis Family: HDMI interface, commonly connected to a DVI-D or the standard HDMI connector on our carrier boards.
    • You can use an HDMI or DVI monitor, depending on the carrier board you are using.
  • Verdin Family: MIPI DSI interface, commonly exposed on a board-to-board connector that can receive multiple display adapters, as our Verdin DSI to HDMI Adapter which is enabled by default, or the Verdin DSI to LVDS Adapter which would require additional configuration.
    • You can use an HDMI monitor, through the Verdin DSI to HDMI adapter.

Learn more by checking the pre-enabled Device Tree Overlays

Configure Toradex Displays

You must apply some device tree overlays to make a specific display work. We already provide all overlays for the displays from our webshop, you just have to:

After you enable the display, check the section at the end of this article on how to test the display and touch.

Find the Correspondent Device Tree Overlays

See below the list of available Device Tree Overlays provided by Toradex:

Displays

Attention: the migration to device tree overlays is currently a work-in-progress. There are some overlays or carrier board specific device trees listed in the table below that are missing. For more information, please consult the BSP Layers and Reference Images for Yocto Project Issue Tracker.

Note: Default resolution with these overlays: 800x480

See the Capacitive Touch Display 7" Parallel in the Webshop. See the Capacitive Touch Display 7" Parallel in the Toradex Developer Center.

Module Board Accessory Kernel Overlays
Apalis iMX6 Evaluation, Ixora V1.0 Capacitive Touch Adapter toradex_5.4-2.3.x-imx apalis-imx6_lcd-lt161010_overlay.dtbo, apalis-imx6_atmel-mxt_overlay.dtbo
Apalis iMX6 Ixora V1.1/1.2 toradex_5.4-2.3.x-imx apalis-imx6_lcd-lt161010_overlay.dtbo, apalis-imx6_atmel-mxt_overlay.dtbo
Apalis iMX6 Evaluation, Ixora V1.0 Capacitive Touch Adapter toradex_5.4.y apalis-imx6_parallel-rgb_overlay.dtbo, apalis-imx6_atmel-mxt_overlay.dtbo, display-lt161010_overlay.dtbo
Apalis iMX6 Ixora V1.1/1.2 toradex_5.4.y apalis-imx6_parallel-rgb_overlay.dtbo, apalis-imx6_atmel-mxt_overlay.dtbo, display-lt161010_overlay.dtbo
Apalis iMX8 Display is not supported by module
Apalis iMX8X Evaluation, Ixora V1.0 Capacitive Touch Adapter toradex_5.4-2.3.x-imx apalis-imx8x_parallel-rgb_overlay.dtbo, apalis-imx8x_atmel-mxt_overlay.dtbo, display-lt161010_overlay.dtbo
Apalis iMX8X Ixora V1.1/1.2 toradex_5.4-2.3.x-imx apalis-imx8x_parallel-rgb_overlay.dtbo, apalis-imx8x_atmel-mxt_overlay.dtbo, display-lt161010_overlay.dtbo
Colibri iMX6 Evaluation, Aster V1.0, Iris V1.1, Viola (Plus) V1.1/1.2 Capacitive Touch Adapter toradex_5.4-2.3.x-imx colibri-imx6_lcd-lt161010_overlay.dtbo, colibri-imx6_atmel-mxt-adapter_overlay.dtbo
Colibri iMX6 Aster V1.1, Iris V2.0, Viola (Plus) V1.3 toradex_5.4-2.3.x-imx colibri-imx6_lcd-lt161010_overlay.dtbo, colibri-imx6_atmel-mxt-connector_overlay.dtbo
Colibri iMX6 Evaluation, Aster V1.0, Iris V1.1, Viola (Plus) V1.1/1.2 Capacitive Touch Adapter toradex_5.4.y colibri-imx6_parallel-rgb_overlay.dtbo, colibri-imx6_atmel-mxt-adapter_overlay.dtbo, display-lt161010_overlay.dtbo
Colibri iMX6 Aster V1.1, Iris V2.0, Viola (Plus) V1.3 toradex_5.4.y colibri-imx6_parallel-rgb_overlay.dtbo, colibri-imx6_atmel-mxt-connector_overlay.dtbo, display-lt161010_overlay.dtbo
Colibri iMX6ULL 256/512MB Overlays are not supported on raw NAND based modules
Colibri iMX6ULL 1GB (eMMC) Evaluation, Aster V1.0, Iris V1.1, Viola (Plus) V1.1/1.2 Capacitive Touch Adapter toradex_5.4-2.3.x-imx colibri-imx6ull_lcd-lt161010_overlay.dtbo, colibri-imx6ull_atmel-mxt-adapter_overlay.dtbo
Colibri iMX6ULL 1GB (eMMC) Aster V1.1, Iris V2.0, Viola (Plus) V1.3 toradex_5.4-2.3.x-imx colibri-imx6ull_lcd-lt161010_overlay.dtbo, colibri-imx6ull_atmel-mxt-connector_overlay.dtbo
Colibri iMX6ULL 1GB (eMMC) Evaluation Capacitive Touch Adapter toradex_5.4.y colibri-imx6ull_parallel-rgb_overlay.dtbo, display-lt161010_overlay.dtbo, colibri-imx6ull_atmel-mxt-adapter_overlay.dtbo
Colibri iMX7 Solo 256MB/Dual 512MB Overlays are not supported on raw NAND based modules
Colibri iMX7 Dual 1GB (eMMC) Evaluation, Aster V1.0, Iris V1.1, Viola (Plus) V1.1/1.2 Capacitive Touch Adapter toradex_5.4-2.3.x-imx colibri-imx7_lcd-lt161010_overlay.dtbo, colibri-imx7_atmel-mxt-adapter_overlay.dtbo
Colibri iMX7 Dual 1GB (eMMC) Aster V1.1, Iris V2.0, Viola (Plus) V1.3 toradex_5.4-2.3.x-imx colibri-imx7_lcd-lt161010_overlay.dtbo, colibri-imx7_atmel-mxt-connector_overlay.dtbo
Colibri iMX7 Dual 1GB (eMMC) Evaluation, Aster V1.0, Iris V1.1, Viola (Plus) V1.1/1.2 Capacitive Touch Adapter toradex_5.4.y colibri-imx7_parallel-rgb_overlay.dtbo, colibri-imx7_atmel-mxt-adapter_overlay.dtbo, display-lt161010_overlay.dtbo
Colibri iMX7 Dual 1GB (eMMC) Aster V1.1, Iris V2.0, Viola (Plus) V1.3 toradex_5.4.y colibri-imx7_parallel-rgb_overlay.dtbo, colibri-imx7_atmel-mxt-connector_overlay.dtbo, display-lt161010_overlay.dtbo
Colibri iMX8X Evaluation, Aster V1.0, Iris V1.1, Viola (Plus) V1.1/1.2 Capacitive Touch Adapter toradex_5.4-2.3.x-imx colibri-imx8x_parallel-rgb_overlay.dtbo, colibri-imx8x_atmel-mxt-adapter_overlay.dtbo, display-lt161010_overlay.dtbo
Colibri iMX8X Aster V1.1, Iris V2.0, Viola (Plus) V1.3 toradex_5.4-2.3.x-imx colibri-imx8x_parallel-rgb_overlay.dtbo, colibri-imx8x_atmel-mxt-connector_overlay.dtbo, display-lt161010_overlay.dtbo
Verdin iMX8M Mini Dahlia, Development Verdin DSI to RGB Adapter Display is not (yet) supported by module
Verdin iMX8M Plus Dahlia, Development Verdin DSI to RGB Adapter Display is not (yet) supported by module

Note: Default resolution with these overlays: 1280x800

See the Capacitive Touch Display 10.1" LVDS in the Webshop. See the Capacitive Touch Display 10.1" LVDS in the Toradex Developer Center.

Module Board Accessory Kernel Overlays
Apalis iMX6 Evaluation, Ixora V1.0 Capacitive Touch Adapter toradex_5.4-2.3.x-imx apalis-imx6_lvds-lt170410_overlay.dtbo, apalis-imx6_atmel-mxt_overlay.dtbo
Apalis iMX6 Ixora V1.1/1.2 toradex_5.4-2.3.x-imx apalis-imx6_lvds-lt170410_overlay.dtbo, apalis-imx6_atmel-mxt_overlay.dtbo
Apalis iMX6 Evaluation, Ixora V1.0 Capacitive Touch Adapter toradex_5.4.y apalis-imx6_lvds_overlay.dtbo, apalis-imx6_atmel-mxt_overlay.dtbo, display-lt170410_overlay.dtbo
Apalis iMX6 Ixora V1.1/1.2 toradex_5.4.y apalis-imx6_lvds_overlay.dtbo, apalis-imx6_atmel-mxt_overlay.dtbo, display-lt170410_overlay.dtbo
Apalis iMX8 Evaluation, Ixora V1.0 Capacitive Touch Adapter toradex_5.4-2.3.x-imx apalis-imx8_lvds_overlay.dtbo, apalis-imx8_atmel-mxt_overlay.dtbo, display-lt170410_overlay.dtbo
Apalis iMX8 Ixora V1.1/1.2 toradex_5.4-2.3.x-imx apalis-imx8_lvds_overlay.dtbo, apalis-imx8_atmel-mxt_overlay.dtbo, display-lt170410_overlay.dtbo
Apalis iMX8X Evaluation, Ixora V1.0 Capacitive Touch Adapter toradex_5.4-2.3.x-imx apalis-imx8x_lvds_overlay.dtbo, apalis-imx8x_atmel-mxt_overlay.dtbo, display-lt170410_overlay.dtbo
Apalis iMX8X Ixora V1.1/1.2 toradex_5.4-2.3.x-imx apalis-imx8x_lvds_overlay.dtbo, apalis-imx8x_atmel-mxt_overlay.dtbo, display-lt170410_overlay.dtbo
Colibri iMX6 Iris v2.0 toradex_5.4-2.3.x-imx colibri-imx6_lcd-lt170410_overlay.dtbo, colibri-imx6_atmel-mxt-connector_overlay.dtbo
Colibri iMX6 Iris v2.0 toradex_5.4.y colibri-imx6_parallel-rgb-lvds_overlay.dtbo, colibri-imx6_atmel-mxt-connector_overlay.dtbo, display-dpi-lt170410_overlay.dtbo
Colibri iMX6ULL 256/512MB Overlays are not supported on raw NAND based modules
Colibri iMX6ULL 1GB (eMMC) Iris v2.0 toradex_5.4-2.3.x-imx colibri-imx6ull_atmel-mxt-connector_overlay.dtbo, colibri-imx6ull_lcd-lt170410_overlay.dtbo
Colibri iMX6ULL 1GB (eMMC) Iris v2.0 toradex_5.4.y Adding support of overlays for this module is in progress
Colibri iMX7 Solo 256MB/Dual 512MB Overlays are not supported on raw NAND based modules
Colibri iMX7 Dual 1GB (eMMC) Iris v2.0 toradex_5.4-2.3.x-imx colibri-imx7_lcd-lt170410_overlay.dtbo, colibri-imx7_atmel-mxt-connector_overlay.dtbo
Colibri iMX7 Dual 1GB (eMMC) Iris v2.0 toradex_5.4.y colibri-imx7_parallel-rgb-lvds-rgb24-single_overlay.dtbo, colibri-imx7_atmel-mxt-connector_overlay.dtbo, display-dpi-lt170410_overlay.dtbo
Colibri iMX8X Iris v2.0 toradex_5.4-2.3.x-imx colibri-imx8x_parallel-rgb-lvds_overlay.dtbo, colibri-imx8x_atmel-mxt-connector_overlay.dtbo, display-dpi-lt170410_overlay.dtbo
Verdin iMX8M Mini Dahlia, Development Verdin DSI to LVDS Adapter toradex_5.4-2.3.x-imx touch-atmel-mxt_overlay.dtbo verdin-imx8mm_sn65dsi84-lt170410_overlay.dtbo verdin-imx8mm_sn65dsi84_overlay.dtbo
Verdin iMX8M Plus Dahlia, Development Verdin DSI to LVDS Adapter toradex_5.4-2.3.x-imx touch-atmel-mxt_overlay.dtbo verdin-imx8mp_sn65dsi84-lt170410_overlay.dtbo verdin-imx8mp_sn65dsi84_overlay.dtbo
Verdin iMX8M Plus Development Verdin iMX8M Plus Mezzanine toradex_5.4-2.3.x-imx verdin-imx8mp_mezzanine-lvds-single-channel_overlay.dtbo, display-lt170410_overlay.dtbo, verdin-imx8mp_mezzanine-touch-atmel-mxt_overlay.dtbo

Note: Default resolution with these overlays: 800x480

See the Resistive Touch Display 7" Parallel in the Webshop. See the Resistive Touch Display 7" Parallel in the Toradex Developer Center.

Module Board Accessory Kernel Overlays
Apalis iMX6 Evaluation, Ixora toradex_5.4-2.3.x-imx apalis-imx6_lcd-lt161010_overlay.dtbo, apalis-imx6_stmpe-ts_overlay.dtbo
Apalis iMX6 Evaluation, Ixora toradex_5.4.y apalis-imx6_parallel-rgb_overlay.dtbo, apalis-imx6_stmpe-ts_overlay.dtbo, display-lt161010_overlay.dtbo
Apalis iMX8 Display is not supported by module
Apalis iMX8X Evaluation, Ixora toradex_5.4-2.3.x-imx apalis-imx8x_parallel-rgb_overlay.dtbo, apalis-imx8x_ad7879_overlay.dtbo, display-lt161010_overlay.dtbo
Colibri iMX6 Evaluation, Aster, Iris, Viola toradex_5.4-2.3.x-imx colibri-imx6_lcd-lt161010_overlay.dtbo, colibri-imx6_stmpe-ts_overlay.dtbo
Colibri iMX6 Evaluation, Aster, Iris, Viola toradex_5.4.y colibri-imx6_parallel-rgb_overlay.dtbo, colibri-imx6_stmpe-ts_overlay.dtbo, display-lt161010_overlay.dtbo
Colibri iMX6ULL 256/512MB Overlays are not supported on raw NAND based modules
Colibri iMX6ULL 1GB (eMMC) Evaluation, Aster, Iris, Viola toradex_5.4-2.3.x-imx colibri-imx6ull_lcd-lt161010_overlay.dtbo, colibri-imx6ull_ad7879_overlay.dtbo
Colibri iMX6ULL 1GB (eMMC) Evaluation toradex_5.4.y colibri-imx6ull_parallel-rgb_overlay.dtbo, display-lt161010_overlay.dtbo, colibri-imx6ull_ad7879_overlay.dtbo
Colibri iMX7 Solo 256MB/Dual 512MB Overlays are not supported on raw NAND based modules
Colibri iMX7 Dual 1GB (eMMC) Evaluation, Aster, Iris, Viola toradex_5.4-2.3.x-imx colibri-imx7_lcd-lt161010_overlay.dtbo, colibri-imx7_ad7879_overlay.dtbo
Colibri iMX7 Dual 1GB (eMMC) Evaluation, Aster, Iris, Viola toradex_5.4.y colibri-imx7_parallel-rgb_overlay.dtbo, colibri-imx7_ad7879_overlay.dtbo, display-lt161010_overlay.dtbo
Colibri iMX8X Evaluation, Aster, Iris, Viola toradex_5.4-2.3.x-imx colibri-imx8x_parallel-rgb_overlay.dtbo, colibri-imx8x_ad7879_overlay.dtbo, display-lt161010_overlay.dtbo
Verdin iMX8M Mini Dahlia, Development Verdin DSI to RGB Adapter Display is not (yet) supported by module
Verdin iMX8M Plus Dahlia, Development Verdin DSI to RGB Adapter Display is not (yet) supported by module

Note: Default resolution with these overlays: 1920x1080

This interface is built into some of Toradex boards. Also, Toradex provides special HDMI adapters (See column Accessory). If the set module+board is not on this list, it doesn't support an HDMI interface.

Module Board Accessory Kernel Overlays
Apalis iMX6 Evaluation, Ixora toradex_5.4-2.3.x-imx apalis-imx6_hdmi_overlay.dtbo
Apalis iMX6 Evaluation, Ixora toradex_5.4.y apalis-imx6_hdmi_overlay.dtbo
Apalis iMX8 Evaluation, Ixora toradex_5.4-2.3.x-imx apalis-imx8_hdmi_overlay.dtbo
Apalis iMX8X Evaluation, Ixora toradex_5.4-2.3.x-imx apalis-imx8x_dsihdmi_overlay.dtbo
Colibri iMX6 Evaluation, Iris toradex_5.4-2.3.x-imx colibri-imx6_hdmi_overlay.dtbo
Colibri iMX6 Aster, Viola (Plus) Colibri HDMI Adapter toradex_5.4-2.3.x-imx colibri-imx6_hdmi_overlay.dtbo
Colibri iMX6 Evaluation, Iris toradex_5.4.y colibri-imx6_hdmi_overlay.dtbo
Colibri iMX6 Aster, Viola (Plus) Colibri HDMI Adapter toradex_5.4.y colibri-imx6_hdmi_overlay.dtbo
Colibri iMX6ULL Interface is not supported by the module
Colibri iMX7 Interface is not supported by the module
Colibri iMX8X Evaluation, Iris DSI to HDMI Adapter toradex_5.4-2.3.x-imx colibri-imx8x_dsihdmi_overlay.dtbo
Colibri iMX8X Aster, Viola (Plus) Interface is not supported by the boards
Verdin iMX8M Mini Dahlia, Development Verdin DSI to HDMI Adapter toradex_5.4-2.3.x-imx verdin-imx8mm_lt8912_overlay.dtbo
Verdin iMX8M Plus Dahlia, Development toradex_5.4-2.3.x-imx verdin-imx8mp_native-hdmi_overlay.dtbo
Verdin iMX8M Plus Dahlia, Development Verdin DSI to HDMI Adapter toradex_5.4-2.3.x-imx verdin-imx8mp_lt8912_overlay.dtbo

Note: Default resolution with these overlays: 640x480

This interface is built into most of Toradex boards. If the board is not on this list, it doesn't have a VGA interface.

Module Board Kernel Overlays
Apalis iMX6 Evaluation toradex_5.4-2.3.x-imx apalis-imx6_vga_overlay.dtbo
Apalis iMX6 Evaluation toradex_5.4.y apalis-imx6_vga_overlay.dtbo
Apalis iMX8 Interface is not supported by module
Apalis iMX8X Interface is not supported by module
Colibri iMX6 Evaluation, Aster, Iris toradex_5.4-2.3.x-imx colibri-imx6_lcd-vga_overlay.dtbo
Colibri iMX6 Evaluation, Aster, Iris toradex_5.4.y colibri-imx6_parallel-rgb_overlay.dtbo, display-vga_overlay.dtbo
Colibri iMX6ULL 256/512MB Overlays are not supported on raw NAND based modules
Colibri iMX6ULL 1GB (eMMC) Evaluation, Aster, Iris toradex_5.4-2.3.x-imx colibri-imx6ull_parallel-rgb_vga_overlay.dtbo
Colibri iMX6ULL 1GB (eMMC) Evaluation toradex_5.4.y display-vga_overlay.dtbo, colibri-imx6ull_parallel-rgb_overlay.dtbo
Colibri iMX7 Solo 256MB/Dual 512MB Overlays are not supported on raw NAND based modules
Colibri iMX7 Dual 1GB (eMMC) Evaluation, Aster, Iris toradex_5.4-2.3.x-imx colibri-imx7_lcd-vga_overlay.dtbo
Colibri iMX7 Dual 1GB (eMMC) Evaluation, Aster, Iris toradex_5.4.y colibri-imx7_parallel-rgb_overlay.dtbo, display-vga_overlay.dtbo
Colibri iMX8X Evaluation, Aster, Iris toradex_5.4-2.3.x-imx colibri-imx8x_parallel-rgb_overlay.dtbo, display-vga_overlay.dtbo
Verdin iMX8M Mini Interface is not supported by module
Verdin iMX8M Plus Interface is not supported by module

Note: Default resolution with these overlays: 800x480

See the EDT 7.0" (EOL) in the Webshop. See the EDT Display in the Toradex Developer Center.

Module Board Accessory Kernel Overlays
Apalis iMX6 Evaluation, Ixora toradex_5.4-2.3.x-imx apalis-imx6_lcd-lt161010_overlay.dtbo, apalis-imx6_stmpe-ts_overlay.dtbo
Apalis iMX6 Evaluation, Ixora toradex_5.4.y apalis-imx6_parallel-rgb_overlay.dtbo, apalis-imx6_stmpe-ts_overlay.dtbo, display-edt7_overlay.dtbo
Apalis iMX8 Display is not supported by module
Apalis iMX8X Evaluation, Ixora toradex_5.4-2.3.x-imx apalis-imx8x_parallel-rgb_overlay.dtbo, apalis-imx8x_ad7879_overlay.dtbo, display-edt7_overlay.dtbo
Colibri iMX6 Evaluation, Aster, Iris, Viola toradex_5.4-2.3.x-imx colibri-imx6_lcd-lt161010_overlay.dtbo, colibri-imx6_stmpe-ts_overlay.dtbo
Colibri iMX6 Evaluation, Aster, Iris, Viola toradex_5.4.y colibri-imx6_parallel-rgb_overlay.dtbo, colibri-imx6_stmpe-ts_overlay.dtbo, display-edt7_overlay.dtbo
Colibri iMX6ULL 256/512MB Overlays are not supported on raw NAND based modules
Colibri iMX6ULL 1GB (eMMC) Evaluation, Aster, Iris, Viola toradex_5.4-2.3.x-imx colibri-imx6ull_lcd-lt161010_overlay.dtbo, colibri-imx6ull_ad7879_overlay.dtbo
Colibri iMX6ULL 1GB (eMMC) Evaluation toradex_5.4.y colibri-imx6ull_parallel-rgb_overlay.dtbo, colibri-imx6ull_ad7879_overlay.dtbo, display-edt7_overlay.dtbo
Colibri iMX7 Solo 256MB/Dual 512MB Overlays are not supported on raw NAND based modules
Colibri iMX7 Dual 1GB (eMMC) Evaluation, Aster, Iris, Viola toradex_5.4-2.3.x-imx colibri-imx7_lcd-edt7_overlay.dtbo, colibri-imx7_ad7879_overlay.dtbo
Colibri iMX7 Dual 1GB (eMMC) Evaluation, Aster, Iris, Viola toradex_5.4.y colibri-imx7_parallel-rgb_overlay.dtbo, colibri-imx7_ad7879_overlay.dtbo, display-edt7_overlay.dtbo
Colibri iMX8X Evaluation, Aster, Iris, Viola toradex_5.4-2.3.x-imx colibri-imx8x_parallel-rgb_overlay.dtbo, colibri-imx8x_ad7879_overlay.dtbo, display-edt7_overlay.dtbo
Verdin iMX8M Mini Dahlia, Development Verdin DSI to RGB Adapter Display is not (yet) supported by module
Verdin iMX8M Plus Dahlia, Development Verdin DSI to RGB Adapter Display is not (yet) supported by module

Pre-enabled Device Tree Overlays

Toradex turns on a pre-set of Device Tree Overlays to support the default display interfaces and panels.

Module Kernel Overlays Supported devices
Apalis iMX6 toradex_5.4-2.3.x-imx apalis-imx6_hdmi_overlay.dtbo HDMI Display
Apalis iMX6 toradex_5.4.y apalis-imx6_parallel-rgb_overlay.dtbo, display-edt7_overlay.dtbo, apalis-imx6_stmpe-ts_overlay.dtbo, apalis-imx6_hdmi_overlay.dtbo HDMI Display, EDT 7.0" (EOL), Resistive Touch Display 7" Parallel
Apalis iMX8 toradex_5.4-2.3.x-imx apalis-imx8_hdmi_overlay.dtbo HDMI Display
Apalis iMX8X toradex_5.4-2.3.x-imx apalis-imx8x_dsihdmi_overlay.dtbo, apalis-imx8x_parallel-rgb_overlay.dtbo, display-lt161010_overlay.dtbo, apalis-imx8x_ad7879_overlay.dtbo HDMI Display, EDT 7.0" (EOL), Resistive Touch Display 7" Parallel
Module Kernel Overlays Supported devices
Colibri iMX6 toradex_5.4-2.3.x-imx colibri-imx6_lcd-vga_overlay.dtbo colibri-imx6_stmpe-ts_overlay.dtbo VGA display, EDT 7.0" (EOL), Resistive Touch Display 7" Parallel
Colibri iMX6 toradex_5.4.y colibri-imx6_parallel-rgb_overlay.dtbo, colibri-imx6_stmpe-ts_overlay.dtbo, display-vga_overlay.dtbo VGA display, EDT 7.0" (EOL), Resistive Touch Display 7" Parallel
Colibri iMX6ULL 256/512MB By default the capacitive touch adapter, resistive touch and VESA VGA display timings are configured via regular device tree(s) as overlays are not supported on raw NAND based modules Capacitive Touch Adapter, Capacitive Touch Display 7" Parallel, Resistive Touch Display 7" Parallel, VGA display, EDT 7.0" (EOL)
Colibri iMX6ULL 1GB (eMMC) toradex_5.4-2.3.x-imx colibri-imx6ull_parallel-rgb_vga_overlay.dtbo, colibri-imx6ull_ad7879_overlay.dtbo VGA display, EDT 7.0" (EOL), Resistive Touch Display 7" Parallel
Colibri iMX6ULL 1GB (eMMC) toradex_5.4.y colibri-imx6ull_parallel-rgb_overlay.dtbo, display-vga_overlay.dtbo, colibri-imx6ull_ad7879_overlay.dtbo VGA display, EDT 7.0" (EOL), Resistive Touch Display 7" Parallel
Colibri iMX7 Solo 256MB/Dual 512MB By default the capacitive touch adapter, resistive touch and VESA VGA display timings are configured via regular device tree(s) as overlays are not supported on raw NAND based modules Capacitive Touch Adapter, Capacitive Touch Display 7" Parallel, Resistive Touch Display 7" Parallel, VGA display, EDT 7.0" (EOL)
Colibri iMX7 Dual 1GB (eMMC) toradex_5.4-2.3.x-imx colibri-imx7_lcd-vga_overlay.dtbo, colibri-imx7_ad7879_overlay.dtbo VGA display, EDT 7.0" (EOL), Resistive Touch Display 7" Parallel
Colibri iMX7 Dual 1GB (eMMC) toradex_5.4.y colibri-imx7_parallel-rgb_overlay.dtbo, colibri-imx7_ad7879_overlay.dtbo, display-vga_overlay.dtbo VGA display, EDT 7.0" (EOL), Resistive Touch Display 7" Parallel
Colibri iMX8X toradex_5.4-2.3.x-imx colibri-imx8x_parallel-rgb_overlay.dtbo, colibri-imx8x_ad7879_overlay.dtbo, display-vga_overlay.dtbo VGA display, EDT 7.0" (EOL), Resistive Touch Display 7" Parallel
Module Board Kernel Accessory Overlays Supported devices
Verdin iMX8M Mini Dahlia, Development toradex_5.4-2.3.x-imx Verdin DSI to HDMI Adapter verdin-imx8mm_lt8912_overlay.dtbo HDMI Display
Verdin iMX8M Plus Dahlia, Development toradex_5.4-2.3.x-imx * native interface, no accessory required verdin-imx8mp_native-hdmi_overlay.dtbo, HDMI Display
Verdin iMX8M Plus Dahlia, Development toradex_5.4-2.3.x-imx Verdin DSI to HDMI Adapter verdin-imx8mp_lt8912_overlay.dtbo HDMI Display

Enable and Deploy Device Tree Overlays

For instructions about how to enable the overlays, see the Device Tree Overlays on Torizon article.

Configure Other Displays with Torizon

We recommend using the device tree overlay to support a specific display to specify the exact display resolution and timings. We recommend looking at the Toradex Device Tree Overlays repository on Github for sample implementations and modify them according to your display resolution and timings. For more information on usage for overlays, check the instructions in the previous section.

Remember to check your display's datasheet. Every manufacturer provides display timings in a slightly different way.

The Horizontal period must be the sum of hback_porch + hactive + hfront_porch + hsync-len and the Vertical period must be the sum of vback_porch + vactive + vfront_porch + vsync-len. Hsync-len and vsync-len parameters are not allowed to be zero sometimes.

Check our examples for a starting point. Copy the most appropriate in the test.DTS you have created in a previous step:

LVDS display example: Capacitive Touch Display 10.1" LVDS Overlay

Parallel RGB display example: Capacitive Touch Display 7" Parallel Overlay

Other examples: Toradex Device Tree Overlays on GitHub

To deploy your customized Device Tree Overlay, check the instructions in the previous section. After you enable the display, check the section at the end of this article on how to test the display and touch.

Touch Screen Calibration

To calibrate your touch screen, please read the article Touch Screen Calibration (Torizon).

Testing Display and Touch

After enabling the Device Tree Overlays, deploying it, and rebooting the board, you can check if the Linux system can find your display. To do that on the command-line, use:

# find /sys/devices -name "edid"

You can also execute the Debian With Weston Wayland Compositor container to see a GUI with touch support:

In order to launch a container named wayland-app and start the weston-terminal, run this command:

# docker run -d --rm --name=wayland-app --user=torizon \
             -v /dev/dri:/dev/dri -v /tmp:/tmp \
             --device-cgroup-rule='c 226:* rmw' \
             torizon/weston:$CT_TAG_WESTON weston-terminal

In order to launch a container named wayland-app and start the weston-terminal, run this command:

Attention: Please, note that by executing the following line you are accepting the terms and conditions of the NXP's End-User License Agreement (EULA)

# docker run -e ACCEPT_FSL_EULA=1 -d --rm --name=wayland-app --user=torizon \
             -v /dev/dri:/dev/dri -v /dev/galcore:/dev/galcore -v /tmp:/tmp \
             --device-cgroup-rule='c 199:* rmw' --device-cgroup-rule='c 226:* rmw' \
             torizon/weston-vivante:$CT_TAG_WESTON_VIVANTE weston-terminal

Note: you are also giving access to /dev/galcore, meaning you can leverage the Vivante graphics acceleration inside the container.

After sending the command, Weston should start on the configured displays.


  • Weston with Wayland Terminal opened (Click on the upper left corner icon to open the terminal)

    Weston with Wayland Terminal opened (Click on the upper left corner icon to open the terminal)

Display Output, Resolution and Timings

TorizonCore uses the Linux Direct Rendering Manager (DRM) with Kernel Mode Setting (KMS). Learn more on the DRM/KMS section from our article Display Output, Resolution and Timings (Linux). To follow some of the instructions that use the modetest program, you can install the package libdrm-tests in one of our Debian Containers for Torizon, such as torizon/weston:

## apt update && apt install libdrm-tests

Common Display Configuration With Weston

Customers are often interested in configurations such as rotating the display by 90 degrees or using multiple displays concurrently.

Many of these configurations can be done with Weston. Read the article Working with Weston on TorizonCore to learn more.

Torizon 4.0.0

Introduction

During the development cycle of a product with a GUI, you usually go through 3 phases when it comes to displays:

Evaluation: often, you will do a basic evaluation using a regular monitor over VGA/DVI-D/HDMI - or similar interfaces, if available. We provide an out-of-the-box experience, where you just have to plug in the monitor and power-on the hardware.

Proof of Concept: even with the advantages of cross-development tools and IDEs enabling a good experience for developing GUIs in a development computer, it is often common to make tests on the real end device. We sell touch screen displays that either deliver an out-of-the-box experience or a fairly easy configuration.

Prototype and Beyond: often, you want or need a custom display in your final product. The reasons are various: price, robustness, brightness, size, interface, EMI compliance, among others. Supporting a custom display is not an easy task for a beginner, especially if you use a display with bad documentation and Linux support. We document how to enable a custom display, but you must expect that some effort is associated with the process or, alternatively, hire a partner to do the integration for you.

Toradex tests and recommends the following displays to be used with its Computer on Modules (CoM) during early phases of development:

For these displays, Toradex provides an easy way to set-up and get running, by providing ready-to-use device tree overlays. It also means that you can tweak the existing overlays to support other displays as well. This article explains how to set up displays on Torizon.

This article complies to the Typographic Conventions for Torizon Documentation.

Configure Displays and Touch Controllers provided by Toradex with Torizon

See below the list of available Device Tree Overlays provided by Toradex and how to build, validate and enable it using Developer Tools Container.

Displays

Attention: the migration to device tree overlays is currently a work-in-progress. There are some overlays or carrier board specific device trees listed in the table below that are missing. For more information, please consult the BSP Layers and Reference Images for Yocto Project Issue Tracker.

Note: Default resolution with these overlays: 800x480

See the Capacitive Touch Display 7" Parallel in the Webshop. See the Capacitive Touch Display 7" Parallel in the Toradex Developer Center.

Module Board Accessory Kernel Overlays
Apalis iMX6 Evaluation, Ixora V1.0 Capacitive Touch Adapter toradex_5.4-2.3.x-imx apalis-imx6_lcd-lt161010_overlay.dtbo, apalis-imx6_atmel-mxt_overlay.dtbo
Apalis iMX6 Ixora V1.1/1.2 toradex_5.4-2.3.x-imx apalis-imx6_lcd-lt161010_overlay.dtbo, apalis-imx6_atmel-mxt_overlay.dtbo
Apalis iMX6 Evaluation, Ixora V1.0 Capacitive Touch Adapter toradex_5.4.y apalis-imx6_parallel-rgb_overlay.dtbo, apalis-imx6_atmel-mxt_overlay.dtbo, display-lt161010_overlay.dtbo
Apalis iMX6 Ixora V1.1/1.2 toradex_5.4.y apalis-imx6_parallel-rgb_overlay.dtbo, apalis-imx6_atmel-mxt_overlay.dtbo, display-lt161010_overlay.dtbo
Apalis iMX8 Display is not supported by module
Apalis iMX8X Evaluation, Ixora V1.0 Capacitive Touch Adapter toradex_5.4-2.3.x-imx apalis-imx8x_parallel-rgb_overlay.dtbo, apalis-imx8x_atmel-mxt_overlay.dtbo, display-lt161010_overlay.dtbo
Apalis iMX8X Ixora V1.1/1.2 toradex_5.4-2.3.x-imx apalis-imx8x_parallel-rgb_overlay.dtbo, apalis-imx8x_atmel-mxt_overlay.dtbo, display-lt161010_overlay.dtbo
Colibri iMX6 Evaluation, Aster V1.0, Iris V1.1, Viola (Plus) V1.1/1.2 Capacitive Touch Adapter toradex_5.4-2.3.x-imx colibri-imx6_lcd-lt161010_overlay.dtbo, colibri-imx6_atmel-mxt-adapter_overlay.dtbo
Colibri iMX6 Aster V1.1, Iris V2.0, Viola (Plus) V1.3 toradex_5.4-2.3.x-imx colibri-imx6_lcd-lt161010_overlay.dtbo, colibri-imx6_atmel-mxt-connector_overlay.dtbo
Colibri iMX6 Evaluation, Aster V1.0, Iris V1.1, Viola (Plus) V1.1/1.2 Capacitive Touch Adapter toradex_5.4.y colibri-imx6_parallel-rgb_overlay.dtbo, colibri-imx6_atmel-mxt-adapter_overlay.dtbo, display-lt161010_overlay.dtbo
Colibri iMX6 Aster V1.1, Iris V2.0, Viola (Plus) V1.3 toradex_5.4.y colibri-imx6_parallel-rgb_overlay.dtbo, colibri-imx6_atmel-mxt-connector_overlay.dtbo, display-lt161010_overlay.dtbo
Colibri iMX6ULL 256/512MB Overlays are not supported on raw NAND based modules
Colibri iMX6ULL 1GB (eMMC) Evaluation, Aster V1.0, Iris V1.1, Viola (Plus) V1.1/1.2 Capacitive Touch Adapter toradex_5.4-2.3.x-imx colibri-imx6ull_lcd-lt161010_overlay.dtbo, colibri-imx6ull_atmel-mxt-adapter_overlay.dtbo
Colibri iMX6ULL 1GB (eMMC) Aster V1.1, Iris V2.0, Viola (Plus) V1.3 toradex_5.4-2.3.x-imx colibri-imx6ull_lcd-lt161010_overlay.dtbo, colibri-imx6ull_atmel-mxt-connector_overlay.dtbo
Colibri iMX6ULL 1GB (eMMC) Evaluation Capacitive Touch Adapter toradex_5.4.y colibri-imx6ull_parallel-rgb_overlay.dtbo, display-lt161010_overlay.dtbo, colibri-imx6ull_atmel-mxt-adapter_overlay.dtbo
Colibri iMX7 Solo 256MB/Dual 512MB Overlays are not supported on raw NAND based modules
Colibri iMX7 Dual 1GB (eMMC) Evaluation, Aster V1.0, Iris V1.1, Viola (Plus) V1.1/1.2 Capacitive Touch Adapter toradex_5.4-2.3.x-imx colibri-imx7_lcd-lt161010_overlay.dtbo, colibri-imx7_atmel-mxt-adapter_overlay.dtbo
Colibri iMX7 Dual 1GB (eMMC) Aster V1.1, Iris V2.0, Viola (Plus) V1.3 toradex_5.4-2.3.x-imx colibri-imx7_lcd-lt161010_overlay.dtbo, colibri-imx7_atmel-mxt-connector_overlay.dtbo
Colibri iMX7 Dual 1GB (eMMC) Evaluation, Aster V1.0, Iris V1.1, Viola (Plus) V1.1/1.2 Capacitive Touch Adapter toradex_5.4.y colibri-imx7_parallel-rgb_overlay.dtbo, colibri-imx7_atmel-mxt-adapter_overlay.dtbo, display-lt161010_overlay.dtbo
Colibri iMX7 Dual 1GB (eMMC) Aster V1.1, Iris V2.0, Viola (Plus) V1.3 toradex_5.4.y colibri-imx7_parallel-rgb_overlay.dtbo, colibri-imx7_atmel-mxt-connector_overlay.dtbo, display-lt161010_overlay.dtbo
Colibri iMX8X Evaluation, Aster V1.0, Iris V1.1, Viola (Plus) V1.1/1.2 Capacitive Touch Adapter toradex_5.4-2.3.x-imx colibri-imx8x_parallel-rgb_overlay.dtbo, colibri-imx8x_atmel-mxt-adapter_overlay.dtbo, display-lt161010_overlay.dtbo
Colibri iMX8X Aster V1.1, Iris V2.0, Viola (Plus) V1.3 toradex_5.4-2.3.x-imx colibri-imx8x_parallel-rgb_overlay.dtbo, colibri-imx8x_atmel-mxt-connector_overlay.dtbo, display-lt161010_overlay.dtbo
Verdin iMX8M Mini Dahlia, Development Verdin DSI to RGB Adapter Display is not (yet) supported by module
Verdin iMX8M Plus Dahlia, Development Verdin DSI to RGB Adapter Display is not (yet) supported by module

Note: Default resolution with these overlays: 1280x800

See the Capacitive Touch Display 10.1" LVDS in the Webshop. See the Capacitive Touch Display 10.1" LVDS in the Toradex Developer Center.

Module Board Accessory Kernel Overlays
Apalis iMX6 Evaluation, Ixora V1.0 Capacitive Touch Adapter toradex_5.4-2.3.x-imx apalis-imx6_lvds-lt170410_overlay.dtbo, apalis-imx6_atmel-mxt_overlay.dtbo
Apalis iMX6 Ixora V1.1/1.2 toradex_5.4-2.3.x-imx apalis-imx6_lvds-lt170410_overlay.dtbo, apalis-imx6_atmel-mxt_overlay.dtbo
Apalis iMX6 Evaluation, Ixora V1.0 Capacitive Touch Adapter toradex_5.4.y apalis-imx6_lvds_overlay.dtbo, apalis-imx6_atmel-mxt_overlay.dtbo, display-lt170410_overlay.dtbo
Apalis iMX6 Ixora V1.1/1.2 toradex_5.4.y apalis-imx6_lvds_overlay.dtbo, apalis-imx6_atmel-mxt_overlay.dtbo, display-lt170410_overlay.dtbo
Apalis iMX8 Evaluation, Ixora V1.0 Capacitive Touch Adapter toradex_5.4-2.3.x-imx apalis-imx8_lvds_overlay.dtbo, apalis-imx8_atmel-mxt_overlay.dtbo, display-lt170410_overlay.dtbo
Apalis iMX8 Ixora V1.1/1.2 toradex_5.4-2.3.x-imx apalis-imx8_lvds_overlay.dtbo, apalis-imx8_atmel-mxt_overlay.dtbo, display-lt170410_overlay.dtbo
Apalis iMX8X Evaluation, Ixora V1.0 Capacitive Touch Adapter toradex_5.4-2.3.x-imx apalis-imx8x_lvds_overlay.dtbo, apalis-imx8x_atmel-mxt_overlay.dtbo, display-lt170410_overlay.dtbo
Apalis iMX8X Ixora V1.1/1.2 toradex_5.4-2.3.x-imx apalis-imx8x_lvds_overlay.dtbo, apalis-imx8x_atmel-mxt_overlay.dtbo, display-lt170410_overlay.dtbo
Colibri iMX6 Iris v2.0 toradex_5.4-2.3.x-imx colibri-imx6_lcd-lt170410_overlay.dtbo, colibri-imx6_atmel-mxt-connector_overlay.dtbo
Colibri iMX6 Iris v2.0 toradex_5.4.y colibri-imx6_parallel-rgb-lvds_overlay.dtbo, colibri-imx6_atmel-mxt-connector_overlay.dtbo, display-dpi-lt170410_overlay.dtbo
Colibri iMX6ULL 256/512MB Overlays are not supported on raw NAND based modules
Colibri iMX6ULL 1GB (eMMC) Iris v2.0 toradex_5.4-2.3.x-imx colibri-imx6ull_atmel-mxt-connector_overlay.dtbo, colibri-imx6ull_lcd-lt170410_overlay.dtbo
Colibri iMX6ULL 1GB (eMMC) Iris v2.0 toradex_5.4.y Adding support of overlays for this module is in progress
Colibri iMX7 Solo 256MB/Dual 512MB Overlays are not supported on raw NAND based modules
Colibri iMX7 Dual 1GB (eMMC) Iris v2.0 toradex_5.4-2.3.x-imx colibri-imx7_lcd-lt170410_overlay.dtbo, colibri-imx7_atmel-mxt-connector_overlay.dtbo
Colibri iMX7 Dual 1GB (eMMC) Iris v2.0 toradex_5.4.y colibri-imx7_parallel-rgb-lvds-rgb24-single_overlay.dtbo, colibri-imx7_atmel-mxt-connector_overlay.dtbo, display-dpi-lt170410_overlay.dtbo
Colibri iMX8X Iris v2.0 toradex_5.4-2.3.x-imx colibri-imx8x_parallel-rgb-lvds_overlay.dtbo, colibri-imx8x_atmel-mxt-connector_overlay.dtbo, display-dpi-lt170410_overlay.dtbo
Verdin iMX8M Mini Dahlia, Development Verdin DSI to LVDS Adapter toradex_5.4-2.3.x-imx touch-atmel-mxt_overlay.dtbo verdin-imx8mm_sn65dsi84-lt170410_overlay.dtbo verdin-imx8mm_sn65dsi84_overlay.dtbo
Verdin iMX8M Plus Dahlia, Development Verdin DSI to LVDS Adapter toradex_5.4-2.3.x-imx touch-atmel-mxt_overlay.dtbo verdin-imx8mp_sn65dsi84-lt170410_overlay.dtbo verdin-imx8mp_sn65dsi84_overlay.dtbo
Verdin iMX8M Plus Development Verdin iMX8M Plus Mezzanine toradex_5.4-2.3.x-imx verdin-imx8mp_mezzanine-lvds-single-channel_overlay.dtbo, display-lt170410_overlay.dtbo, verdin-imx8mp_mezzanine-touch-atmel-mxt_overlay.dtbo

Note: Default resolution with these overlays: 800x480

See the Resistive Touch Display 7" Parallel in the Webshop. See the Resistive Touch Display 7" Parallel in the Toradex Developer Center.

Module Board Accessory Kernel Overlays
Apalis iMX6 Evaluation, Ixora toradex_5.4-2.3.x-imx apalis-imx6_lcd-lt161010_overlay.dtbo, apalis-imx6_stmpe-ts_overlay.dtbo
Apalis iMX6 Evaluation, Ixora toradex_5.4.y apalis-imx6_parallel-rgb_overlay.dtbo, apalis-imx6_stmpe-ts_overlay.dtbo, display-lt161010_overlay.dtbo
Apalis iMX8 Display is not supported by module
Apalis iMX8X Evaluation, Ixora toradex_5.4-2.3.x-imx apalis-imx8x_parallel-rgb_overlay.dtbo, apalis-imx8x_ad7879_overlay.dtbo, display-lt161010_overlay.dtbo
Colibri iMX6 Evaluation, Aster, Iris, Viola toradex_5.4-2.3.x-imx colibri-imx6_lcd-lt161010_overlay.dtbo, colibri-imx6_stmpe-ts_overlay.dtbo
Colibri iMX6 Evaluation, Aster, Iris, Viola toradex_5.4.y colibri-imx6_parallel-rgb_overlay.dtbo, colibri-imx6_stmpe-ts_overlay.dtbo, display-lt161010_overlay.dtbo
Colibri iMX6ULL 256/512MB Overlays are not supported on raw NAND based modules
Colibri iMX6ULL 1GB (eMMC) Evaluation, Aster, Iris, Viola toradex_5.4-2.3.x-imx colibri-imx6ull_lcd-lt161010_overlay.dtbo, colibri-imx6ull_ad7879_overlay.dtbo
Colibri iMX6ULL 1GB (eMMC) Evaluation toradex_5.4.y colibri-imx6ull_parallel-rgb_overlay.dtbo, display-lt161010_overlay.dtbo, colibri-imx6ull_ad7879_overlay.dtbo
Colibri iMX7 Solo 256MB/Dual 512MB Overlays are not supported on raw NAND based modules
Colibri iMX7 Dual 1GB (eMMC) Evaluation, Aster, Iris, Viola toradex_5.4-2.3.x-imx colibri-imx7_lcd-lt161010_overlay.dtbo, colibri-imx7_ad7879_overlay.dtbo
Colibri iMX7 Dual 1GB (eMMC) Evaluation, Aster, Iris, Viola toradex_5.4.y colibri-imx7_parallel-rgb_overlay.dtbo, colibri-imx7_ad7879_overlay.dtbo, display-lt161010_overlay.dtbo
Colibri iMX8X Evaluation, Aster, Iris, Viola toradex_5.4-2.3.x-imx colibri-imx8x_parallel-rgb_overlay.dtbo, colibri-imx8x_ad7879_overlay.dtbo, display-lt161010_overlay.dtbo
Verdin iMX8M Mini Dahlia, Development Verdin DSI to RGB Adapter Display is not (yet) supported by module
Verdin iMX8M Plus Dahlia, Development Verdin DSI to RGB Adapter Display is not (yet) supported by module

Note: Default resolution with these overlays: 1920x1080

This interface is built into some of Toradex boards. Also, Toradex provides special HDMI adapters (See column Accessory). If the set module+board is not on this list, it doesn't support an HDMI interface.

Module Board Accessory Kernel Overlays
Apalis iMX6 Evaluation, Ixora toradex_5.4-2.3.x-imx apalis-imx6_hdmi_overlay.dtbo
Apalis iMX6 Evaluation, Ixora toradex_5.4.y apalis-imx6_hdmi_overlay.dtbo
Apalis iMX8 Evaluation, Ixora toradex_5.4-2.3.x-imx apalis-imx8_hdmi_overlay.dtbo
Apalis iMX8X Evaluation, Ixora toradex_5.4-2.3.x-imx apalis-imx8x_dsihdmi_overlay.dtbo
Colibri iMX6 Evaluation, Iris toradex_5.4-2.3.x-imx colibri-imx6_hdmi_overlay.dtbo
Colibri iMX6 Aster, Viola (Plus) Colibri HDMI Adapter toradex_5.4-2.3.x-imx colibri-imx6_hdmi_overlay.dtbo
Colibri iMX6 Evaluation, Iris toradex_5.4.y colibri-imx6_hdmi_overlay.dtbo
Colibri iMX6 Aster, Viola (Plus) Colibri HDMI Adapter toradex_5.4.y colibri-imx6_hdmi_overlay.dtbo
Colibri iMX6ULL Interface is not supported by the module
Colibri iMX7 Interface is not supported by the module
Colibri iMX8X Evaluation, Iris DSI to HDMI Adapter toradex_5.4-2.3.x-imx colibri-imx8x_dsihdmi_overlay.dtbo
Colibri iMX8X Aster, Viola (Plus) Interface is not supported by the boards
Verdin iMX8M Mini Dahlia, Development Verdin DSI to HDMI Adapter toradex_5.4-2.3.x-imx verdin-imx8mm_lt8912_overlay.dtbo
Verdin iMX8M Plus Dahlia, Development toradex_5.4-2.3.x-imx verdin-imx8mp_native-hdmi_overlay.dtbo
Verdin iMX8M Plus Dahlia, Development Verdin DSI to HDMI Adapter toradex_5.4-2.3.x-imx verdin-imx8mp_lt8912_overlay.dtbo

Note: Default resolution with these overlays: 640x480

This interface is built into most of Toradex boards. If the board is not on this list, it doesn't have a VGA interface.

Module Board Kernel Overlays
Apalis iMX6 Evaluation toradex_5.4-2.3.x-imx apalis-imx6_vga_overlay.dtbo
Apalis iMX6 Evaluation toradex_5.4.y apalis-imx6_vga_overlay.dtbo
Apalis iMX8 Interface is not supported by module
Apalis iMX8X Interface is not supported by module
Colibri iMX6 Evaluation, Aster, Iris toradex_5.4-2.3.x-imx colibri-imx6_lcd-vga_overlay.dtbo
Colibri iMX6 Evaluation, Aster, Iris toradex_5.4.y colibri-imx6_parallel-rgb_overlay.dtbo, display-vga_overlay.dtbo
Colibri iMX6ULL 256/512MB Overlays are not supported on raw NAND based modules
Colibri iMX6ULL 1GB (eMMC) Evaluation, Aster, Iris toradex_5.4-2.3.x-imx colibri-imx6ull_parallel-rgb_vga_overlay.dtbo
Colibri iMX6ULL 1GB (eMMC) Evaluation toradex_5.4.y display-vga_overlay.dtbo, colibri-imx6ull_parallel-rgb_overlay.dtbo
Colibri iMX7 Solo 256MB/Dual 512MB Overlays are not supported on raw NAND based modules
Colibri iMX7 Dual 1GB (eMMC) Evaluation, Aster, Iris toradex_5.4-2.3.x-imx colibri-imx7_lcd-vga_overlay.dtbo
Colibri iMX7 Dual 1GB (eMMC) Evaluation, Aster, Iris toradex_5.4.y colibri-imx7_parallel-rgb_overlay.dtbo, display-vga_overlay.dtbo
Colibri iMX8X Evaluation, Aster, Iris toradex_5.4-2.3.x-imx colibri-imx8x_parallel-rgb_overlay.dtbo, display-vga_overlay.dtbo
Verdin iMX8M Mini Interface is not supported by module
Verdin iMX8M Plus Interface is not supported by module

Note: Default resolution with these overlays: 800x480

See the EDT 7.0" (EOL) in the Webshop. See the EDT Display in the Toradex Developer Center.

Module Board Accessory Kernel Overlays
Apalis iMX6 Evaluation, Ixora toradex_5.4-2.3.x-imx apalis-imx6_lcd-lt161010_overlay.dtbo, apalis-imx6_stmpe-ts_overlay.dtbo
Apalis iMX6 Evaluation, Ixora toradex_5.4.y apalis-imx6_parallel-rgb_overlay.dtbo, apalis-imx6_stmpe-ts_overlay.dtbo, display-edt7_overlay.dtbo
Apalis iMX8 Display is not supported by module
Apalis iMX8X Evaluation, Ixora toradex_5.4-2.3.x-imx apalis-imx8x_parallel-rgb_overlay.dtbo, apalis-imx8x_ad7879_overlay.dtbo, display-edt7_overlay.dtbo
Colibri iMX6 Evaluation, Aster, Iris, Viola toradex_5.4-2.3.x-imx colibri-imx6_lcd-lt161010_overlay.dtbo, colibri-imx6_stmpe-ts_overlay.dtbo
Colibri iMX6 Evaluation, Aster, Iris, Viola toradex_5.4.y colibri-imx6_parallel-rgb_overlay.dtbo, colibri-imx6_stmpe-ts_overlay.dtbo, display-edt7_overlay.dtbo
Colibri iMX6ULL 256/512MB Overlays are not supported on raw NAND based modules
Colibri iMX6ULL 1GB (eMMC) Evaluation, Aster, Iris, Viola toradex_5.4-2.3.x-imx colibri-imx6ull_lcd-lt161010_overlay.dtbo, colibri-imx6ull_ad7879_overlay.dtbo
Colibri iMX6ULL 1GB (eMMC) Evaluation toradex_5.4.y colibri-imx6ull_parallel-rgb_overlay.dtbo, colibri-imx6ull_ad7879_overlay.dtbo, display-edt7_overlay.dtbo
Colibri iMX7 Solo 256MB/Dual 512MB Overlays are not supported on raw NAND based modules
Colibri iMX7 Dual 1GB (eMMC) Evaluation, Aster, Iris, Viola toradex_5.4-2.3.x-imx colibri-imx7_lcd-edt7_overlay.dtbo, colibri-imx7_ad7879_overlay.dtbo
Colibri iMX7 Dual 1GB (eMMC) Evaluation, Aster, Iris, Viola toradex_5.4.y colibri-imx7_parallel-rgb_overlay.dtbo, colibri-imx7_ad7879_overlay.dtbo, display-edt7_overlay.dtbo
Colibri iMX8X Evaluation, Aster, Iris, Viola toradex_5.4-2.3.x-imx colibri-imx8x_parallel-rgb_overlay.dtbo, colibri-imx8x_ad7879_overlay.dtbo, display-edt7_overlay.dtbo
Verdin iMX8M Mini Dahlia, Development Verdin DSI to RGB Adapter Display is not (yet) supported by module
Verdin iMX8M Plus Dahlia, Development Verdin DSI to RGB Adapter Display is not (yet) supported by module

Pre-enabled Device Tree Overlays

Toradex turns on a pre-set of Device Tree Overlays to support the default display interfaces and panels.

Module Kernel Overlays Supported devices
Apalis iMX6 toradex_5.4-2.3.x-imx apalis-imx6_hdmi_overlay.dtbo HDMI Display
Apalis iMX6 toradex_5.4.y apalis-imx6_parallel-rgb_overlay.dtbo, display-edt7_overlay.dtbo, apalis-imx6_stmpe-ts_overlay.dtbo, apalis-imx6_hdmi_overlay.dtbo HDMI Display, EDT 7.0" (EOL), Resistive Touch Display 7" Parallel
Apalis iMX8 toradex_5.4-2.3.x-imx apalis-imx8_hdmi_overlay.dtbo HDMI Display
Apalis iMX8X toradex_5.4-2.3.x-imx apalis-imx8x_dsihdmi_overlay.dtbo, apalis-imx8x_parallel-rgb_overlay.dtbo, display-lt161010_overlay.dtbo, apalis-imx8x_ad7879_overlay.dtbo HDMI Display, EDT 7.0" (EOL), Resistive Touch Display 7" Parallel
Module Kernel Overlays Supported devices
Colibri iMX6 toradex_5.4-2.3.x-imx colibri-imx6_lcd-vga_overlay.dtbo colibri-imx6_stmpe-ts_overlay.dtbo VGA display, EDT 7.0" (EOL), Resistive Touch Display 7" Parallel
Colibri iMX6 toradex_5.4.y colibri-imx6_parallel-rgb_overlay.dtbo, colibri-imx6_stmpe-ts_overlay.dtbo, display-vga_overlay.dtbo VGA display, EDT 7.0" (EOL), Resistive Touch Display 7" Parallel
Colibri iMX6ULL 256/512MB By default the capacitive touch adapter, resistive touch and VESA VGA display timings are configured via regular device tree(s) as overlays are not supported on raw NAND based modules Capacitive Touch Adapter, Capacitive Touch Display 7" Parallel, Resistive Touch Display 7" Parallel, VGA display, EDT 7.0" (EOL)
Colibri iMX6ULL 1GB (eMMC) toradex_5.4-2.3.x-imx colibri-imx6ull_parallel-rgb_vga_overlay.dtbo, colibri-imx6ull_ad7879_overlay.dtbo VGA display, EDT 7.0" (EOL), Resistive Touch Display 7" Parallel
Colibri iMX6ULL 1GB (eMMC) toradex_5.4.y colibri-imx6ull_parallel-rgb_overlay.dtbo, display-vga_overlay.dtbo, colibri-imx6ull_ad7879_overlay.dtbo VGA display, EDT 7.0" (EOL), Resistive Touch Display 7" Parallel
Colibri iMX7 Solo 256MB/Dual 512MB By default the capacitive touch adapter, resistive touch and VESA VGA display timings are configured via regular device tree(s) as overlays are not supported on raw NAND based modules Capacitive Touch Adapter, Capacitive Touch Display 7" Parallel, Resistive Touch Display 7" Parallel, VGA display, EDT 7.0" (EOL)
Colibri iMX7 Dual 1GB (eMMC) toradex_5.4-2.3.x-imx colibri-imx7_lcd-vga_overlay.dtbo, colibri-imx7_ad7879_overlay.dtbo VGA display, EDT 7.0" (EOL), Resistive Touch Display 7" Parallel
Colibri iMX7 Dual 1GB (eMMC) toradex_5.4.y colibri-imx7_parallel-rgb_overlay.dtbo, colibri-imx7_ad7879_overlay.dtbo, display-vga_overlay.dtbo VGA display, EDT 7.0" (EOL), Resistive Touch Display 7" Parallel
Colibri iMX8X toradex_5.4-2.3.x-imx colibri-imx8x_parallel-rgb_overlay.dtbo, colibri-imx8x_ad7879_overlay.dtbo, display-vga_overlay.dtbo VGA display, EDT 7.0" (EOL), Resistive Touch Display 7" Parallel
Module Board Kernel Accessory Overlays Supported devices
Verdin iMX8M Mini Dahlia, Development toradex_5.4-2.3.x-imx Verdin DSI to HDMI Adapter verdin-imx8mm_lt8912_overlay.dtbo HDMI Display
Verdin iMX8M Plus Dahlia, Development toradex_5.4-2.3.x-imx * native interface, no accessory required verdin-imx8mp_native-hdmi_overlay.dtbo, HDMI Display
Verdin iMX8M Plus Dahlia, Development toradex_5.4-2.3.x-imx Verdin DSI to HDMI Adapter verdin-imx8mp_lt8912_overlay.dtbo HDMI Display

Starting the Developer Tools Container

To to build, validate and enable overlays you need to use the dtconf command inside the Developer Tools Container.

Therefore, the first step is to start the Developer Tools Container.

Enable overlay

After selecting the corresponding Device Tree Overlays for your board, module, display and touch screen controllers from the table above, you need to activate it.

To enable the overlay for your display, you need to be in the interactive shell inside the Torizon Debian Dev Tools container on the Toradex Computer on Module (CoM), as explained earlier.

The following command will list Toradex provided overlays:

## dtconf status

Once you've identified the correct overlay for your setup you may use dtconf activate <file> -c device_tree_base.dtb to apply your capacitive touch overlay. You shall specify on which "base" device-tree you will apply your overlay with the flag "-c" followed by the *.dtb file of the given device-tree.

As an example, to enable enable the 7" parallel display for Apalis iMX8QM on an Apalis Evaluation Board (as a base device-tree), we use the following command:

## dtconf activate apalis-imx8qm-display-lt170410-overlay.dts -c fsl-imx8qm-apalis-eval.dtb

Attention: Replace the .dts file with the corresponding overlay file for your setup ( Carrier Board + Module + Display/Touch Controller model), as the table showed in the previous sections.

To enable the touchscreen for the touchscreen controller of Apalis iMX8QM:

## dtconf activate apalis-imx8qm-atmel-mxt-overlay.dts -c fsl-imx8qm-apalis-eval.dtb

Note: Note for Apalis iMX6: Apalis iMX6Q requires an additional overlay when enabling the LVDS interface (apalis-imx6-lvds-overlay.dts) or the parallel RGB interface (apalis-imx6-parallel-rgb-overlay.dts)

Finally, once all overlay files have been enabled, reboot the board.

For more information about dtconf and device tree overlays, please, refer to Device Tree Overlays page.

Configure Other Displays with Torizon

To support a specific display we recommend using the device tree overlay to specify the exact display resolution and timings. We recommend you clone our repository that contains the device tree overlay samples and modify them according to your display resolution and timings. Make sure then to switch to the branch that matches the running kernel on your Torizon device.

On your development PC, clone the device-tree-overlays repository from Toradex:

$ git clone https://github.com/toradex/device-tree-overlays.git

Start the Developer Tools Container for TorizonCore on the computer on module.

Once it's running in interactive mode, create .dts file in /var folder to keep it persistant:

## vim test.dts

Check the datasheet of your display. Every manufacturer provides display timings in a slightly different way.

The Horizontal period must be the sum of hback_porch + hactive + hfront_porch + hsync-len and the Vertical period must be the sum of vback_porch + vactive + vfront_porch + vsync-len. Hsync-len and vsync-len parameters are not allowed to be zero sometimes.

Check our examples for a starting point. Copy the most appropriate in the test.dts you have created in a previous step:

LVDS display example: Capacitive Touch Display 10.1" LVDS Overlay

Parallel RGB display example: Capacitive Touch Display 7" Parallel Overlay

Other examples: Toradex Device Tree Overlays on GitHub

To deploy your customized Device Tree Overlay, check the instructions on the previous section.

Touch Screen Calibration

To calibrate your touch screen, please read the article Touch Screen Calibration (Torizon).