7.9inch HDMI LCD
Overview
| ||
Introduction
This product is a universal 7.9inch HDMI display with a resolution of 400×1280 and a capacitive touch panel. It supports Raspberry Pi and can also serve as a computer monitor.
Features
- 7.9inch IPS screen, 400 x 1280 hardware resolution
- 5-point capacitive touch control, toughened glass panel, hardness up to 6H
- When used with Raspberry Pi, it supports Raspberry Pi OS/Ubuntu/Kali and Retropie
- When used as a computer monitor, it supports Windows 11/10/8.1/8/7
- With 3.5mm audio interface, it supports HDMI audio output
Working with PC
Supports PC versions of Windows 11 / 10 / 8.1 / 8 / 7 systems.
How to use:
- 1. Connect the TOUCH interface of the LCD to the USB port of the PC. Wait for a moment, Windows will automatically recognize the touch function.
- 2. Connect the HDMI port of the LCD to the HDMI port of the PC, and wait for about 10 seconds until the LCD displays normally. If you need to output sound, you can connect a 3.5mm headphone through the HP audio output interface.
- Note 1: When the computer is connected to multiple monitors at the same time, the touch effect will be applied to the main display by default. If you need to specify the touch to the secondary display, see Windows Specified Touch Screen.
- Note 2: The USB port of some PCs may be underpowered due to aging, so you can use the USB port on the back of the PC or connect an external 5V 2A power adapter.
Windows Specified Touch Screen
Take Windows 11 as an example:
- 1. Go to Windows settings of the system, enter in the search bar and click on "Control Panel" (as shown in the figure below)
- 2. In the pop-up "Control Panel" interface, select "Hardware and Sound"
- 3. Select "Calibrate the screen for pen or touch input", then click "Settings" in the pop-up tablet settings
- 4. The text prompt shown below will appear on the screen. Please click on the touchpad with your finger and the computer will recognize it as a touch screen.
- 1. Go to Windows settings of the system, enter in the search bar and click on Calibration the screen for pen and touch input (as shown in the figure below)
- 2. In the pop-up Tablet PC Settings interface, click Settings
- 3. The text prompt shown below will appear on the screen. Please click on the touchpad with your finger and the computer will recognize it as a touch screen.
Working with Raspberry Pi
Supports Raspberry Pi OS/Ubuntu/Kali and Retropie systems for Raspberry Pi.
Download the latest version of the image from the Raspberry Pi official website.
- 1. Download the compressed file to the PC, and extract it as .img file.
- 2. Connect the TF card to the PC, format the TF card with SDFormatter software.
- 3. Open the Win32DiskImager software, select the system image prepared in step 1, and click Write to flash the system image.
- 4. After the image flashing is completed, open the config.txt file in the root directory of the TF card, add the following code at the end of the config.txt, save and safely eject the TF card, then insert the TF card into the Raspberry Pi.
hdmi_group=2 hdmi_mode=87 hdmi_timings=400 0 220 32 110 1280 0 10 10 10 0 0 0 60 0 59400000 3
- 5. Connect the TOUCH interface of the LCD to the USB port of the Raspberry Pi.
- 6. Connect the HDMI interface of the LCD to the HDMI port of the Raspberry Pi and then power on the Raspberry Pi, it can display normally after waiting for about ten seconds.
Note 1: The screen is displayed vertically by default. For convenience, you can adjust the display orientation of the screen, see Screen Rotation.
Note 2: When the Raspberry Pi 4 is connected to multiple monitors at the same time, the touch effect will be applied to the main screen by default. If you need to specify the touch to the secondary screen, see Raspberry Pi Specified Touch Screen.
Raspberry Pi Specified Touch Screen
1. Enter xrandr on the Raspberry Pi terminal and check the HDMI-ID (most of them are HDMI-1) where the main screen is located;
2. Enter xinput on the Raspberry Pi terminal to check the touch ID where the main screen is located (there are 2 touch IDs, if you don't know which is the main screen, you can try both);
3. Run the command: xinput map-to-output touch ID HDMI-ID
(After matching the ID value, you can run the command to specify the touch to the main screen, such as: xinput map-to-output 7 HDMI-1)
4. Since you need to re-enter the command every time you boot up, you can add this command to the boot autostart:
sudo nano etcxdglxsessionLXDE-piautostart
Add xinput map-to-output 7 HDMI-1 (remember to change it to your own corresponding ID), and then restart it.
Screen Rotation
Bookworm System
GUI Interface Rotation
- 1. Open the "Screen Configuration" application;
- 2. Go to "Screen" - > "HDMI-A-1" - > "Touchscreen" and check "Waveshare Waveshare"
- 3. Go to "Screen" -> "HDMI-A-1" -> "Orientation", check the direction you need to rotate, and finally click "Apply" to complete the screen and touch synchronous rotation.
Note: Only the Bookworm system supports the above screen and touch synchronization rotation method. Bullseye and earlier versions require separate settings for screen and touch rotation.
lite Version Screen Rotation (No Desktop Environment)
Edit the startup command line file:
sudo nano /boot/firmware/cmdline.txt
Add the following parameters at the beginning of the cmdline.txt file (required to change to the actual screen resolution):
video=HDMI-A-1:400x1280M@60,rotate=90
Replaced with:
- rotate=90: rotate 90° clockwise
- rotate=180: rotate 180° clockwise
- rotate=270: rotate 90° counterclockwise
Note: HDMI shares rotation settings with other interfaces (such as DPI, DSI) and cannot be set separately.
Bullseye/Buster Systems
GUI Interface Rotation
- 1. Open the "Screen Configuration" application;
- 2. Go to "Screen" -> "HDMI-A-1" -> "Orientation", check the direction you need to rotate, and finally click "Apply" to apply the settings.
lite Version Screen Rotation
- 1. Need to modify the /boot/cmdline.txt file:
sudo nano /boot/cmdline.txt
- 2. Add the following parameters at the beginning of the cmdline.txt file (required to change to the actual screen resolution):
video=HDMI-A-1:400x1280M@60,rotate=90
Replaced with:
- rotate=90: rotate 90° clockwise
- rotate=180: rotate 180° clockwise
- rotate=270: rotate 90° counterclockwise
Note: HDMI shares rotation settings with other interfaces (such as DPI, DSI) and cannot be set separately.
- 3. Save and restart
sudo reboot
Stretch/Jessie Systems
For older systems (not using the vc4-kms-v3d or vc4-fkms-v3d drivers), please set up as follows:
- 1. Edit config.txt file
sudo nano /boot/config.txt
- 2. Add the statement at the end of the file:
display_rotate=1 #1: 90; 2: 180; 3: 270
- 2. Save the changes and then reboot the Raspberry Pi
sudo reboot
Touchscreen Rotation Settings
Some screens can be rotated by holding down the Rotate Touch button on the back to switch the touch direction. Each hold switches the direction once.

Bookworm System (Command Line Mode)
If you use the graphical interface for rotation, you can tick "Touchscreen" in the screen layout editor window to synchronize the touch rotation. Please refer to the previous introduction for how to rotate the screen. For the command line rotation method, please refer to the following text:
1. Create a udev rule file:
sudo nano /etc/udev/rules.d/99-waveshare-touch.rules
2. Add the content for the desired rotation angle (uncomment as needed):
#90°:
ENV{ID_INPUT_TOUCHSCREEN}=="1", ENV{LIBINPUT_CALIBRATION_MATRIX}="0 -1 1 1 0 0"
#180°:
#ENV{ID_INPUT_TOUCHSCREEN}=="1", ENV{LIBINPUT_CALIBRATION_MATRIX}="-1 0 1 0 -1 1"
#270°:
#ENV{ID_INPUT_TOUCHSCREEN}=="1", ENV{LIBINPUT_CALIBRATION_MATRIX}="0 1 0 -1 0 1"
3. Save and reboot
sudo reboot
Bullseye/Buster Systems
1. Install libinput
sudo apt-get install xserver-xorg-input-libinput
- If you have Ubuntu or Jetson Nano installed. The installation code is:
sudo apt install xserver-xorg-input-synaptics
2. Create the xorg.conf.d directory under /etc/X11 (if the directory already exists, proceed directly to step 3).
sudo mkdir /etc/X11/xorg.conf.d
3. Copy the 40-libinput-conf file to the directory you created just now.
sudo cp /usr/share/X11/xorg.conf.d/40-libinput.conf /etc/X11/xorg.conf.d/
4. Edit this file
sudo nano /etc/X11/xorg.conf.d/40-libinput.conf #Find the touchscreen section, add the corresponding rotation angle command in it, and save it #"90° Right touch rotation: Option "CalibrationMatrix" "0 1 0 -1 0 1 0 0 1" #180° Inverted touch rotation: #Option "CalibrationMatrix" "-1 0 1 0 -1 1 0 0 1" #270° Left touch rotation: #Option "CalibrationMatrix" "0 -1 1 1 0 0 0 0 1" Similar to the position in the following image:
sudo reboot
After completing the above steps, touch will cause a rotation.
Use Touchscreen Virtual Keyboard
Raspberry Pi OS Bookworm and later versions include Squeekboard on-screen keyboard by default.
When connecting to the touch display, the on-screen keyboard will automatically appear if text input is possible, and it will automatically hide if text input is not possible.
For applications that do not support automatic text input detection, you can manually display or hide the on-screen keyboard by clicking the keyboard icon at the far right of the task bar.

You can also set the display or hide the screen keyboard through the "Display" option under "Raspberry Pi Configuration" or through the "Display" section in raspi-config.

- Note:
For versions of Raspberry Pi OS before Bookworm, use matchbox-keyboard. If you are using the wayfire desktop compositor, use wvkbd.
Touch Mode Selection
The Bookworm system supports two touch modes, which can be switched in the Screen Configuration > Touchscreen menu:

- 1. Mouse Emulation (default)
Click = Left mouse button function Long press = Right mouse button function Supports double-click Does not support swipe page and multi-touch functions
Note: This mode is suitable for scenarios that require mouse operation, such as double clicking to open the file manager and long pressing to achieve right-click functionality.
- 2. Multitouch
Supports multi-touch functionality Supports swiping pages Does not support double-click and right-click long press functions
Note: This mode is suitable for touch-optimized scenarios, such as web browsing and scrolling lists.
Backlight Control
You can control the backlight brightness by long-pressing the ON/OFF on the back of the LCD.

Note: If you increase the brightness, it may cause the display to have insufficient power through the USB port. In this case, you can solve the power supply issue by inputting 5V / 2A power through the Power port on the back of the display.
Resources
Related Resources
Software
FAQ
Touch panel + LCD thickness: 7.8mm.
Touch panel + LCD thickness + PCB board (without components): 9.8mm.
Touch panel + LCD thickness + PCB board (including HDMI port): 16.5mm.
For the old version:
As shown below, you can remove the original soldered resistor (the red one), then connect the green solder pad to the P1 pin of the Raspberry Pi.
For the new version:
As shown below, you can remove the original soldered resistor (the red one), then connect the yellow solder pad to the P1 pin of the Raspberry Pi.
{{{5}}}
Support
Technical Support
If you need technical support or have any feedback/review, please click the Submit Now button to submit a ticket, Our support team will check and reply to you within 1 to 2 working days. Please be patient as we make every effort to help you to resolve the issue.
Working Time: 9 AM - 6 PM GMT+8 (Monday to Friday)













