# Enable display
Before you begin, set up your infrastructure as described in the [Qualcomm Linux Build Guide](https://docs.qualcomm.com/bundle/publicresource/topics/80-70030-254/).
## Set up HDMI display
To view the output of sample applications on your HDMI display, set up HDMI display.
See the appropriate chip product for device-specific information.
>
>
> Tab QCS6490
> Tab IQ-9075
> Tab IQ-8275
>
> - *class* tabincludedirective
>
> - >
> >
> >
> >
> >
> >
> > **Figure: HDMI setup workflow**
>
>
>
> The display subsystem provides the Weston and Wayland compositors, along with
> `libdrm` APIs, which interact with the DPU driver to render the Wayland
> client applications. Use the sample test applications to evaluate
> the basic rendering of Wayland applications and to connect to the HDMI
> display.
>
>
> ### Prerequisites
>
>
> Ensure that you configure the following settings on the device:
>
>
> 1. Set Switch 4 of DIP\_SW\_0 to OFF.
> 2. Connect the device to the HDMI display.
>
>
>
> 
>
>
> **Figure: DIP switch selection for HDMI**
>
>
> ### Verify HDMI or eDP display setup
>
>
> To verify the HDMI or embedded DisplayPort (eDP) setup, do the following:
>
> 1. Connect the display using one of the following options:
>
>
>
> >
> >
> > - HDMI cable
> > - Mini-DisplayPort cable (as applicable)
> 2. Power on the device. Weston starts automatically during boot.
> 3. Verify the display.
>
>
>
> >
> >
> > The following Weston flower pattern displays on the screen, indicating a successful setup:
> >
> >
> >
> > >
> > >
> > > 
> >
> >
> >
> > Note
> >
> > - If you are experiencing a no-display screen issue on HDMI, see [Debug HDMI display](https://docs.qualcomm.com/doc/80-70030-18/topic/debug.html#troubleshoot-hdmi-display).
> > - If you connect the HDMI cable after powering on the device, see [Troubleshoot display issue when HDMI/eDP cable is connected after boot](https://docs.qualcomm.com/doc/80-70030-18/topic/debug.html#connect-hdmi-cable-bootup).
> >
> >
> > After you have set up the HDMI display, run the following display test applications to verify the display functionality.
>
>
> ### Run the Weston simple EGL client application
>
>
> Weston simple EGL is a sample test application used to verify the composition and rendering of frames on your HDMI display. To run the application, run the following commands:
>
>
> Note
>
>
> You must enable SSH to access your host device. For instructions, see [Sign in using SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70030-254/how_to.html#use-ssh).
>
>
> mount -o remount,rw /
> Copy to clipboard
>
>
> su
> Copy to clipboard
>
>
> . /etc/profile
> Copy to clipboard
>
>
> export XDG_RUNTIME_DIR=/dev/socket/weston && mkdir -p $XDG_RUNTIME_DIR
> Copy to clipboard
>
>
> cd /usr/bin
> Copy to clipboard
>
>
> export WAYLAND_DISPLAY=wayland-1 && weston-simple-egl
> Copy to clipboard
>
>
> The following figure shows the Weston simple EGL client application running on the display monitor.
>
> 
>
> Note
>
>
> To kill the application, select **CTRL + C**.
>
>
> ### Run DRM modetest
>
>
> DRM modetest ensures that the DSI and the DPU paths are working effectively. To verify the display driver topology, run the DRM modetest.
>
>
> **Prerequisite**
>
>
> To run the DRM modetest application, first you need to generate the DRM modetest binary.
>
>
> **Generate the DRM modetest binary**
>
>
> By default, the DRM modetest binary isn’t included in the display subsystem. To generate the DRM modetest binary file, do the following:
>
>
> Note
>
>
> You must enable SSH to access your host device. For instructions, see [Sign in using SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70030-254/how_to.html#use-ssh).
>
> 1. Ensure that you have the latest software. If you don’t, see [Release Notes](https://docs.qualcomm.com/doc/80-70030-300) and [Qualcomm Linux Build Guide](https://docs.qualcomm.com/bundle/publicresource/topics/80-70030-254/introduction.html).
> 2. To generate the binary, go to the workspace <workspace> and run the following commands:
>
>
>
> >
> >
> > export SHELL=/bin/bash
> > Copy to clipboard
> >
> >
> > MACHINE=qcs6490-rb3gen2-core-kit DISTRO=qcom-wayland source setup-environment
> > Copy to clipboard
> >
> >
> > bitbake -fc install libdrm
> > Copy to clipboard
> >
> >
> > The system generates the binary at `/build-qcom-wayland/tmp-glibc/work/armv8-2a-qcom-linux/libdrm/2.4.120/image/usr/bin/modetest` directory.
> 3. To push the modetest binary file to the device, run the following commands:
>
>
>
> >
> >
> > mount -o remount,rw /usr
> > Copy to clipboard
> >
> >
> > scp /build-qcom-wayland/tmp-glibc/work/armv8-2a-qcom-linux/libdrm/2.4.120/image/usr/bin/modetest root@:/usr/bin
> > Copy to clipboard
> >
> >
> > Note
> >
> >
> > If prompted for a password, enter `oelinux123`.
>
>
>
> **Run DRM modetest application**
>
>
> To run the drm modetest application, do the following:
>
>
> Note
>
>
> You must enable SSH to access your host device. For instructions, see [Sign in using SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70030-254/how_to.html#use-ssh).
>
> 1. To kill the Weston client application, run the following commands in the device shell:
>
>
>
> >
> >
> > mount -o remount,rw /
> > Copy to clipboard
> >
> >
> > ps -A | grep weston
> > Copy to clipboard
> >
> >
> > **Sample output:**
> >
> >
> > 824 ? 00:00:12 weston
> > 1090 ? 00:00:00 weston-keyboard
> > 1092 ? 00:00:01 weston-desktop-
> > Copy to clipboard
> >
> >
> > Use the Weston process ID from the sample Weston process list to kill the Weston processes.
> 2. To kill all Weston processes, run the following command:
>
>
>
> >
> >
> > systemctl stop init_display.service
> > Copy to clipboard
> 3. To change permissions of the modetest application, run the following command:
>
>
>
> >
> >
> > chmod 0777 /usr/bin/modetest
> > Copy to clipboard
> 4. To view the connector IDs and modes, run the following command:
>
>
>
> >
> >
> > /usr/bin/modetest -c msm_drm > /opt/drm_mode.txt
> > Copy to clipboard
> 5. To verify DRM modes and connector information, pull the `/opt/drm_mode.txt` file locally on your host computer. Use the Secure Copy Protocol (SCP) to pull the `drm_mode.txt` file from the device to your host computer. For example,
>
>
>
> >
> >
> > scp -r root@:/opt/drm_mode.txt
> > Copy to clipboard
> >
> >
> > Note
> >
> >
> > When prompted for a password, enter `oelinux123`.
> >
> >
> > The output as shown in the following figure is from the
> > `/opt/drm_mode.txt` file.
> >
> > 
> 6. To fetch the connector ID and mode name, use the relevant values from the `/opt/drm_mode.txt` file:
>
>
>
> >
> >
> > modetest -c msm_drm -s :
> > Copy to clipboard
> 7. To start the modetest application, run the following sample command using the connector ID and the mode name retrieved from the `/opt/drm_mode.txt` file. For example:
>
>
>
> >
> >
> > /usr/bin/modetest -c msm_drm -s 32:1920x1080-60
> > Copy to clipboard
> >
> >
> > Note
> >
> >
> > Start the DRM test application and ignore the warning log: `Failed to set gamma: Function not implemented`.
> >
> > 
> 8. To kill the modetest application, select **CTRL + C**.
>
>
>
> >
> >
> > Note
> >
> >
> > Ensure that you [Relaunch Weston](https://docs.qualcomm.com/doc/80-70030-18/topic/debug.html#relaunch-weston).
>
> - *class* tabincludedirective
>
> - Not applicable.
>
> - *class* tabincludedirective
>
> - Not applicable.
## Set up DisplayPort
To view the output of sample applications on your DisplayPort, set up the DisplayPort.
See the appropriate chip product for information about your device.
>
>
> Tab QCS6490
> Tab IQ-9075
> Tab IQ-8275
>
> - *class* tabincludedirective
>
> - Not applicable.
>
> - *class* tabincludedirective
>
> - >
> >
> >
> >
> >
> >
> > **Figure: DisplayPort setup workflow**
> >
> > The display subsystem provides the Weston and Wayland compositors, along with
> > `libdrm`, which interact with the DPU driver to render the Wayland
> > client applications. Use the sample test applications to evaluate
> > the basic rendering of the Wayland applications and to connect to the
> > DisplayPort.
>
>
>
> ### Verify the DisplayPort setup
>
>
>
> >
> >
> > To verify the DisplayPort setup, do the following:
> >
> > 1. Connect the DisplayPort cable to the eDP0 connector as shown in the following figure.
> >
> >
> >
> > >
> > >
> > > 
> > >
> > > **Figure: DisplayPort setup**
> > 2. Power on the device. Weston launches automatically during boot.
> > 3. Verify the display.
> >
> >
> >
> > >
> > >
> > > The following Weston flower pattern displays on both DisplayPort screens, indicating successful setup.
> > >
> > >
> > >
> > > >
> > > >
> > > > 
> >
> >
> >
> > Note
> >
> >
> > If you connect the DisplayPort cable after powering on the device, see [Troubleshoot display issue when HDMI/eDP cable is connected after boot](https://docs.qualcomm.com/doc/80-70030-18/topic/debug.html#connect-hdmi-cable-bootup).
> >
> >
> > After you have set up the DisplayPort, run the following display test applications to verify the display functionality.
>
>
> ### Run the Weston simple EGL client application
>
>
>
> >
> >
> > Weston simple EGL is a sample test application used to verify the composition and rendering of frames on your DisplayPort. To run the application, run the following commands:
> >
> >
> > Note
> >
> >
> > You must enable SSH to access your host device. For instructions, see [Sign in using SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70030-254/how_to.html#use-ssh).
> >
> >
> > mount -o remount,rw /
> > Copy to clipboard
> >
> >
> > su
> > Copy to clipboard
> >
> >
> > . /etc/profile
> > Copy to clipboard
> >
> >
> > export XDG_RUNTIME_DIR=/dev/socket/weston && mkdir -p $XDG_RUNTIME_DIR
> > Copy to clipboard
> >
> >
> > cd /usr/bin
> > Copy to clipboard
> >
> >
> > export WAYLAND_DISPLAY=wayland-1 && weston-simple-egl
> > Copy to clipboard
> >
> >
> > The following figure shows the Weston simple EGL client application running on the display monitor.
> >
> > 
> >
> > Note
> >
> >
> > To kill the application, select **CTRL + C**.
>
>
> ### Run DRM modetest
>
>
>
> >
> >
> > DRM modetest ensures that the DSI and the DPU paths are working effectively. To verify the display driver topology, run the DRM modetest.
> >
> >
> > **Generate the DRM modetest binary**
> >
> >
> > Note
> >
> >
> > You must enable SSH to access your host device. For instructions, see [Sign in using SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70030-254/how_to.html#use-ssh).
> >
> >
> > By default, the DRM modetest binary isn’t included in the display subsystem. To generate the DRM modetest binary file, do the following:
> >
> > 1. Ensure that you have the latest software. If you don’t, see [Release Notes](https://docs.qualcomm.com/doc/80-70030-300) and [Qualcomm Linux Build Guide](https://docs.qualcomm.com/bundle/publicresource/topics/80-70030-254/introduction.html).
> > 2. To generate the binary, go to the workspace <workspace> and run the following commands:
> >
> >
> >
> > >
> > >
> > > export SHELL=/bin/bash
> > > Copy to clipboard
> > >
> > >
> > > MACHINE=qcs9075-iq-9075-evk DISTRO=qcom-wayland source setup-environment
> > > Copy to clipboard
> > >
> > >
> > > bitbake -fc install libdrm
> > > Copy to clipboard
> > >
> > >
> > > The system generates the binary at `/build-qcom-wayland/tmp-glibc/work/armv8-2a-qcom-linux/libdrm/2.4.120/image/usr/bin/modetest` directory.
> > 3. To push the modetest binary file to the device, run the following commands:
> >
> >
> >
> > >
> > >
> > > mount -o remount,rw /usr
> > > Copy to clipboard
> > >
> > >
> > > scp /build-qcom-wayland/tmp-glibc/work/armv8-2a-qcom-linux/libdrm/2.4.120/image/usr/bin/modetest root@:/usr/bin
> > > Copy to clipboard
> >
> >
> >
> > Note
> >
> >
> > If prompted for a password, enter `oelinux123`.
> >
> >
> >
> > **Run DRM modetest application**
> >
> >
> > To run the DRM modetest application, do the following:
> >
> >
> > Note
> >
> >
> > You must enable SSH to access your host device. For instructions, see [Sign in using SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70030-254/how_to.html#use-ssh).
> >
> > 1. To kill the Weston client application, run the following commands in the device shell:
> >
> >
> >
> > >
> > >
> > > mount -o remount,rw /
> > > Copy to clipboard
> > >
> > >
> > > ps -A | grep weston
> > > Copy to clipboard
> > >
> > >
> > > **Sample output:**
> > >
> > >
> > > 824 ? 00:00:12 weston
> > > 1090 ? 00:00:00 weston-keyboard
> > > 1092 ? 00:00:01 weston-desktop-
> > > Copy to clipboard
> > >
> > >
> > > Use the Weston process ID from the sample Weston process list to kill the Weston processes.
> > 2. To kill all Weston processes, run the following command:
> >
> >
> >
> > >
> > >
> > > systemctl stop init_display.service
> > > Copy to clipboard
> > 3. To change permissions of the modetest application, run the following command:
> >
> >
> >
> > >
> > >
> > > chmod 0777 /usr/bin/modetest
> > > Copy to clipboard
> > 4. To know the connector IDs and modes, run the following command:
> >
> >
> >
> > >
> > >
> > > /usr/bin/modetest -c msm_drm > /opt/drm_mode.txt
> > > Copy to clipboard
> > 5. To check for DRM modes and connector information, pull the `/opt/drm_mode.txt` file locally on your host computer. Use the Secure Copy Protocol (SCP) to pull the `drm_mode.txt` file from the device to your host computer. For example,
> >
> >
> >
> > >
> > >
> > > scp -r root@:/opt/drm_mode.txt
> > > Copy to clipboard
> > >
> > >
> > > Note
> > >
> > >
> > > When prompted for a password, enter `oelinux123`.
> > >
> > >
> > > The output as shown in the following figure is from the
> > > `/opt/drm_mode.txt` file.
> > >
> > > 
> > 6. To fetch the connector ID and mode name, use the relevant values from the `/opt/drm_mode.txt` file:
> >
> >
> >
> > >
> > >
> > > modetest -c msm_drm -s :
> > > Copy to clipboard
> > 7. To start the modetest application, run the following sample command using the connector ID and the mode name retrieved from the `/opt/drm_mode.txt` file. For example:
> >
> >
> >
> > >
> > >
> > > /usr/bin/modetest -c msm_drm -s 32:1920x1080-60
> > > Copy to clipboard
> > >
> > >
> > > Note
> > >
> > >
> > > Start the DRM modetest application and ignore the warning log: `Failed to set gamma: Function not implemented`.
> > >
> > > 
> > 8. To kill the modetest application, select **CTRL + C**.
> >
> >
> >
> > >
> > >
> > > Note
> > >
> > >
> > > Ensure that you [Relaunch Weston](https://docs.qualcomm.com/doc/80-70030-18/topic/debug.html#relaunch-weston).
>
> - *class* tabincludedirective
>
> - >
> >
> >
> >
> >
> >
> > **Figure: DisplayPort setup workflow**
> >
> > The display subsystem provides the Weston and Wayland compositors, along with
> > `libdrm`, which interact with the DPU driver to render the Wayland
> > client applications. Use the sample test applications to evaluate
> > the basic rendering of the Wayland applications and to connect to the
> > DisplayPort.
>
>
>
> ### Verify DisplayPort setup
>
>
>
> >
> >
> > To verify the setup, do the following:
> >
> > 1. Connect the DisplayPort cable to the eDP0 connector as shown in the following figure:
> >
> >
> >
> > >
> > >
> > > 
> > >
> > > **Figure: IQ-8275 DisplayPort setup**
> > 2. Power on the device. Weston launches automatically during boot.
> > 3. Verify the display.
> >
> >
> > The following Weston flower pattern displays on the screen, indicating a successful setup.
> >
> >
> >
> > >
> > >
> > > 
> > >
> > > Note
> > >
> > >
> > > If you connect the DisplayPort cable after powering on the device, see [Troubleshoot display issue when HDMI/eDP cable is connected after boot](https://docs.qualcomm.com/doc/80-70030-18/topic/debug.html#connect-hdmi-cable-bootup).
>
>
>
> After you have set up the DisplayPort, run the following display test applications to verify the display functionality.
>
>
> ### Run the Weston simple EGL client application
>
>
>
> >
> >
> > >
> > >
> > > Weston simple EGL is a sample test application that you can use to verify the composition and rendering of frames on the DisplayPort. To run the application, run the following commands:
> >
> >
> >
> > Note
> >
> >
> > You must enable SSH to access your host device. For instructions, see [Sign in using SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70030-254/how_to.html#use-ssh).
> >
> >
> > mount -o remount,rw /
> > Copy to clipboard
> >
> >
> > su
> > Copy to clipboard
> >
> >
> > . /etc/profile
> > Copy to clipboard
> >
> >
> > export XDG_RUNTIME_DIR=/dev/socket/weston && mkdir -p $XDG_RUNTIME_DIR
> > Copy to clipboard
> >
> >
> > cd /usr/bin
> > Copy to clipboard
> >
> >
> > export WAYLAND_DISPLAY=wayland-1 && weston-simple-egl
> > Copy to clipboard
> >
> >
> > The following figure shows the Weston simple EGL client application running on the display monitor.
> >
> > 
> >
> > Note
> >
> >
> > To kill the application, select **CTRL + C**.
>
>
> ### Run DRM modetest
>
>
> DRM modetest ensures that the DSI and the DPU paths are working effectively. To verify the display driver topology, run the DRM modetest.
>
>
> **Generate the DRM modetest binary**
>
>
>
> >
> >
> > By default, the DRM modetest binary isn’t included in the display subsystem. To generate the DRM modetest binary file, do the following:
> >
> >
> > Note
> >
> >
> > You must enable SSH to access your host device. For instructions, see [Sign in using SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70030-254/how_to.html#use-ssh).
> >
> > 1. Ensure that you have the latest software. If you don’t, see [Release Notes](https://docs.qualcomm.com/bundle/publicresource/topics/80-70030-300) and [Qualcomm Linux Build Guide](https://docs.qualcomm.com/bundle/publicresource/topics/80-70030-254/introduction.html).
> > 2. To generate the binary, go to the workspace <workspace> and run the following commands:
> >
> >
> >
> > >
> > >
> > > export SHELL=/bin/bash
> > > Copy to clipboard
> > >
> > >
> > > MACHINE=qcs8275-iq-8275-evk DISTRO=qcom-wayland source setup-environment
> > > Copy to clipboard
> > >
> > >
> > > bitbake -fc install libdrm
> > > Copy to clipboard
> > >
> > >
> > > The system generates the binary at `/build-qcom-wayland/tmp-glibc/work/armv8-2a-qcom-linux/libdrm/2.4.120/image/usr/bin/modetest` directory.
> > 3. To push the modetest binary file to the device, run the following commands:
> >
> >
> >
> > >
> > >
> > > mount -o remount,rw /usr
> > > Copy to clipboard
> > >
> > >
> > > scp /build-qcom-wayland/tmp-glibc/work/armv8-2a-qcom-linux/libdrm/2.4.120/image/usr/bin/modetest root@:/usr/bin
> > > Copy to clipboard
> > >
> > >
> > > Note
> > >
> > >
> > > If prompted for a password, enter `oelinux123`.
> >
> >
> >
> > **Run DRM modetest**
> >
> >
> > To run the DRM modetest application, do the following:
> >
> >
> > Note
> >
> >
> > You must enable SSH to access your host device. For instructions, see [Sign in using SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70030-254/how_to.html#use-ssh).
> >
> > 1. To kill the Weston client application, run the following commands in the device shell:
> >
> >
> >
> > >
> > >
> > > mount -o remount,rw /
> > > Copy to clipboard
> > >
> > >
> > > ps -A | grep weston
> > > Copy to clipboard
> > >
> > >
> > > **Sample output:**
> > >
> > >
> > > 824 ? 00:00:12 weston
> > > 1090 ? 00:00:00 weston-keyboard
> > > 1092 ? 00:00:01 weston-desktop-
> > > Copy to clipboard
> > >
> > >
> > > Use the Weston process ID from the sample Weston process list to kill the Weston processes.
> > 2. To kill all Weston processes, run the following command:
> >
> >
> >
> > >
> > >
> > > systemctl stop init_display.service
> > > Copy to clipboard
> > 3. To change permissions of the modetest application, run the following command:
> >
> >
> >
> > >
> > >
> > > chmod 0777 /usr/bin/modetest
> > > Copy to clipboard
> > 4. To know the connector IDs and modes, run the following command:
> >
> >
> >
> > >
> > >
> > > /usr/bin/modetest -c msm_drm > /opt/drm_mode.txt
> > > Copy to clipboard
> > 5. To check for DRM modes and connector information, pull the `/opt/drm_mode.txt` file locally on your host computer. Use the Secure Copy Protocol (SCP) to pull the `drm_mode.txt` file from the device to your host computer. For example,
> >
> >
> >
> > >
> > >
> > > scp -r root@:/opt/drm_mode.txt
> > > Copy to clipboard
> > >
> > >
> > > Note
> > >
> > >
> > > When prompted for a password, enter `oelinux123`.
> > >
> > >
> > > The output as shown in the following figure is from the
> > > `/opt/drm_mode.txt` file.
> > >
> > > 
> > 6. To fetch the connector ID and mode name, use the relevant values from the `/opt/drm_mode.txt` file:
> >
> >
> >
> > >
> > >
> > > modetest -c msm_drm -s :
> > > Copy to clipboard
> > 7. To start the modetest application, run the following sample command using the connector ID and the mode name retrieved from the `/opt/drm_mode.txt` file. For example:
> >
> >
> >
> > >
> > >
> > > /usr/bin/modetest -c msm_drm -s 32:1920x1080-60
> > > Copy to clipboard
> > >
> > >
> > > Note
> > >
> > >
> > > Start the DRM test application and ignore the warning log: `Failed to set gamma: Function not implemented`.
> > >
> > > 
> > 8. To kill the modetest application, select **CTRL + C**.
> >
> >
> >
> > >
> > >
> > > Note
> > >
> > >
> > > Ensure that you [Relaunch Weston](https://docs.qualcomm.com/doc/80-70030-18/topic/debug.html#relaunch-weston).
## Next steps
- [Troubleshoot display](https://docs.qualcomm.com/doc/80-70030-18/topic/debug.html#toubleshoot-display)
Last Published: Jun 25, 2026
[Previous Topic
Display overview](https://docs.qualcomm.com/bundle/publicresource/80-70030-18/topics/overview.md) [Next Topic
Display specifications](https://docs.qualcomm.com/bundle/publicresource/80-70030-18/topics/features.md)