# Enable the display
Before you begin, set up your infrastructure as described in the [Qualcomm Linux Build Guide](https://docs.qualcomm.com/bundle/publicresource/topics/80-80022-254/). Setting up the infrastructure using the Qualcomm Linux Build Guide ensures that all required display drivers, middleware, and compositor components are correctly built and configured.
## Set up the HDMI display
To view the output of sample applications on your HDMI display, set up the HDMI display.
See the appropriate chip product for device-specific information.
>
>
> Tab QCS6490
> Tab IQ-615
>
> - *class* tabincludedirective
>
> - >
> >
> >
> >
> >
> >
> > **Figure: HDMI setup workflow**
>
>
>
> The display subsystem provides the Weston and Wayland compositors, along with
> `libdrm` APIs, all of 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.
>
>
> ### Prerequisite
>
>
> - Connect the device to the HDMI display.
>
>
> ### Verify the HDMI display setup
>
> 1. Connect the display using an HDMI cable.
>
>
> 
>
>
> **Figure: HDMI cable connection**
> 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-80022-18/topic/troubleshoot_display_issues.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-80022-18/topic/troubleshoot_display_issues.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-80022-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=/run/user/1000 && 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 the DRM modetest application
>
>
> DRM modetest ensures that the DSI and the DPU paths are working effectively. To verify the display driver topology, run the DRM modetest.
>
>
> 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-80022-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 weston.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 -M msm > /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 -M msm -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 -M msm -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-80022-18/topic/troubleshoot_display_issues.html#relaunch).
>
> - *class* tabincludedirective
>
> - >
> >
> >
> >
> >
> >
> > **Figure: HDMI 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.
>
>
>
> ### Prerequisites
>
> 1. Set switch SW7 to OFF.
> 2. Connect the device to the HDMI display as shown in the following figure:
>
>
> 
>
>
> **Figure: HDMI setup workflow**
>
>
> ### Verify the HDMI display setup
>
>
>
> >
> >
> > 1. Connect the display using an HDMI cable.
> > 2. Power on the device. Weston starts automatically during boot.
> > 3. Verify the display.
> >
> >
> >
> > >
> > >
> > > The following Weston flower pattern displays on both DisplayPort screens, indicating successful setup.
> > >
> > > 
> >
> >
> >
> > Note
> >
> > - If you are experiencing a no-display screen issue on HDMI, see [Debug HDMI display](https://docs.qualcomm.com/doc/80-80022-18/topic/troubleshoot_display_issues.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-80022-18/topic/troubleshoot_display_issues.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 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-80022-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=/run/user/1000 && 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**.
> >
> >
> >
> >
> > >
> > >
> > > DRM modetest ensures that the DSI and DPU paths are working effectively. To verify the display driver topology, run the DRM modetest.
> > >
> > >
> > > 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-80022-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 weston.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 -M msm > /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 -M msm -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 -M msm -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-80022-18/topic/troubleshoot_display_issues.html#relaunch).
## Set up the 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
> Tab IQ-615
>
> - *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
>
>
>
> >
> >
> > 1. Connect the DisplayPort cable to either of the connectors as shown in the following figures:
> >
> >
> >
> > >
> > >
> > > - DisplayPort over Type-C connector
> > > - Embedded DisplayPort (eDP) connector
> > >
> > > 
> > >
> > > **Figure: DisplayPort setup**
> > > 
> > >
> > > **Figure: eDP 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-80022-18/topic/troubleshoot_display_issues.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-80022-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=/run/user/1000 && 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 the DRM modetest application
>
>
>
> >
> >
> > DRM modetest ensures that the DSI and DPU paths are working effectively. To verify the display driver topology, run the DRM modetest.
> >
> >
> > 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-80022-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 weston.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 -M msm > /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 -M msm -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 -M msm -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-80022-18/topic/troubleshoot_display_issues.html#relaunch).
>
> - *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
>
>
>
> >
> >
> > 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-80022-18/topic/troubleshoot_display_issues.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-80022-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=/run/user/1000 && 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 the DRM modetest application
>
>
>
> >
> >
> > DRM modetest ensures that the DSI and DPU paths are working effectively. To verify the display driver topology, run the DRM modetest.
> >
> >
> > 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-80022-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 weston.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 -M msm > /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 -M msm -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 -M msm -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-80022-18/topic/troubleshoot_display_issues.html#relaunch).
>
> - *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
>
>
>
> >
> >
> > 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-80022-18/topic/troubleshoot_display_issues.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-80022-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=/run/user/1000 && 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 the DRM modetest application
>
>
> DRM modetest ensures that the DSI and DPU paths are working effectively. To verify the display driver topology, run the DRM modetest.
>
>
>
> >
> >
> > 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-80022-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 weston.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 -M msm > /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 -M msm -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 -M msm -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-80022-18/topic/troubleshoot_display_issues.html#relaunch).
>
> - *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
>
>
>
> >
> >
> > 1. Connect the DisplayPort cable to the DisplayPort connector as shown in the following figure:
> >
> >
> > 
> >
> >
> > **Figure: DisplayPort connection**
> > 2. Power on the device. Weston starts automatically during boot.
> > 3. Verify the display.
> >
> >
> >
> > >
> > >
> > > The following Weston flower pattern displays on both DisplayPort screens, indicating successful setup.
> > >
> > >
> > >
> > > >
> > > >
> > > > 
> >
> >
> >
> > 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-80022-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=/run/user/1000 && 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 the DRM modetest application
>
>
>
> >
> >
> > DRM modetest ensures that the DSI and the DPU paths are working effectively. To verify the display driver topology, run the DRM modetest.
> >
> >
> > 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-80022-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 weston.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 -M msm > /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 -M msm -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 -M msm -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-80022-18/topic/troubleshoot_display_issues.html#relaunch).
## Next steps
- [Troubleshoot display issues](https://docs.qualcomm.com/doc/80-80022-18/topic/troubleshoot_display_issues.html#troubleshoot-display)
Last Published: May 13, 2026
[Previous Topic
Display overview](https://docs.qualcomm.com/bundle/publicresource/80-80022-18/topics/overview.md) [Next Topic
Display specifications](https://docs.qualcomm.com/bundle/publicresource/80-80022-18/topics/display_specifications.md)