7inch DSI LCD (H)
Features
- 7inch DSI touch screen, ten-point capacitive touch control
- IPS display panel with hardware resolution of 1280×720
- Toughened glass capacitive touch panel, hardness up to 6H
- Optical bonding toughened glass panel, clearer picture quality
- Using AF anti-fingerprint process, not easy to get fingerprints and easy to clean
- Support Pi5/CM5/4B/CM4/3B+/3A+/3B/CM3+/CM3
- Directly drive the LCD by the DSI interface on the Raspberry Pi, with up to 60Hz refreshing rate
- When used with Raspberry Pi, it is compatible with Bookworm system
- Supports software control of backlight brightness
Video Tutorial
Electrical Specifications
| Parameters | Minimum Value | Standard Value | Maximum Value | Unit | Note |
| Input voltage | 4.75 | 5.00 | 5.30 | V | Note 1 |
| Input current | - | 0.5 | TBD | A | Note 2 |
| Operating temperature | 0 | 25 | 60 | ℃ | Note 3 |
| Storage temperature | -10 | 25 | 70 | ℃ | Note 3 |
•Note 1: Input voltages exceeding the maximum or improper operation may cause permanent damage to the device.
•Note 2: The input current needs to be ≥ 0.5A, otherwise it will cause the startup failure or display abnormality, and staying in an abnormal state for a long time may cause permanent damage to the device.
•Note 3: Please do not store the display panel in a high-temperature and high-humidity environment for a long time. The display panel should operate within its limits, otherwise it may be damaged.
Interfaces
Working with Raspberry Pi
Pi5/CM5/CM4/CM3+/CM3 Hardware Connection
1. Use the "FFC Cable 22PIN 200mm (opposite direction)" to connect the DSI port of the display to the 22PIN DSI port of the Raspberry Pi motherboard. 2. Use the "GPIO cable" to connect the power connector of the display to the 5V GND pin header of the Raspberry Pi motherboard.
3. Secure the Raspberry Pi to the display with M2.5 screws.
The installation effect is as follows:
Note: Make sure that the DSI cable is connected in correct direction and 5V power is supplied through the GPIO pins.
Pi4B/3B+/3B/3A+ Hardware Connection
1. Use the "DSI-Cable-12cm" cable to connect the DSI port of the display to the 15PIN DSI port of the Raspberry Pi motherboard. 2. Use the "GPIO cable" to connect the power connector of the display to the 5V GND pin header of the Raspberry Pi motherboard.
3. Secure the Raspberry Pi to the display with M2.5 screws.
The installation effect is as follows:
Note: Make sure that the DSI cable is connected in correct direction and 5V power is supplied through the GPIO pins.
Method 1: Flash Latest Bookworm System
1. Connect the TF card to the PC, download and use Raspberry Pi Imager to flash the corresponding system image.
2. 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.
Note: Since Pi5/CM5/CM4/CM3+/CM3 has two mipi DSI interfaces, please note that the correct DSI interfaces and commands are used, DSI1 is recommended by default.
dtoverlay=vc4-kms-v3d #DSI1 Use dtoverlay=vc4-kms-dsi-waveshare-panel,7_0_inchH #DSI0 Use #dtoverlay=vc4-kms-dsi-waveshare-panel,7_0_inchH,dsi0
3. Insert the TF card into the Raspberry Pi, power on the Raspberry Pi, and generally wait for about 30 seconds to enter the display state. The touch function can be used normally after the system boots.
Adjust Backlight Brightness
Graphical Interface Backlight Adjustment
The following steps are based on the Trixie system:
- 1. Click the menu in the upper left corner, then go to Preferences → Control Center, and select Screens;
- 2. Go to "Screen" -> "DSI-2" -> "Brightness", check and adjust the desired backlight brightness, and finally click Apply to save the settings.
You can also use the graphical backlight adjustment tool provided by Waveshare:
wget https://files.waveshare.com/wiki/common/Brightness.zip unzip Brightness.zip cd Brightness sudo chmod +x install.sh ./install.sh
After the installation is completed, you can open the demo in the Start Menu -> Accessories -> Brightness, as shown below:
Adjust Backlight Brightness Using Terminal
echo X | sudo tee /sys/class/backlight/*/brightness
Where X represents any number from 0 to 255. 0 means the darkest backlight, and 255 means the brightest backlight. For example:
echo 100 | sudo tee /sys/class/backlight/*/brightness echo 0 | sudo tee /sys/class/backlight/*/brightness echo 255 | sudo tee /sys/class/backlight/*/brightness
Trixie/Bookworm Display Rotation
GUI Interface Rotation
The following steps are based on the Trixie system:
- 1. Click the menu in the upper left corner, then go to Preferences → Control Center, and select Screens;
- 2. Go to Screens -> DSI-1 -> Touchscreen and check "10-0014 Goodix Capacitive TouchScreen";
- 3. Go to Screens -> DSI-2 -> Orientation, check the direction you need to rotate, and finally click "Apply" to complete the display and touch synchronous rotation.
- In the Bookworm system, this setting entry is located at Screen Configuration → Screen.
lite Version Display Rotation
sudo nano /boot/firmware/cmdline.txt #Add the display resolution and rotation commands at the beginning of the cmdline.txt file to take effect after a reboot #For example, the DSI-1 display has a 720x1280 resolution and the display rotation is 90 degrees video=DSI-1:720x1280e,rotate=90 #For example, the DSI-1 display has a 720x1280 resolution and the display rotation is 180 degrees video=DSI-1:720x1280e,rotate=180 #For example, the DSI-1 display has a 720x1280 resolution and the display rotation is 270 degrees video=DSI-1:720x1280e,rotate=270
Notes:
- 1. Based on actual display resolution.
- 2. If using Pi5/CM5, use the actual DSI display number identified, for example, "DSI-2".
- 3. It is not possible to rotate DSI monitor and HDMI monitor separately using cmdline.txt. When you use both DSI and HDMI simultaneously, they share the same rotation value.
Touch Rotation
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 new file named 99-waveshare-touch.rules
sudo nano /etc/udev/rules.d/99-waveshare-touch.rules
2. Add the following lines 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
Touch Mode Selection
The Trixie and Bookworm systems support 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 page swiping and multi-touch functionality
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 long-press right-click functions
Note: This mode is suitable for touch-optimized scenarios, such as web browsing and scrolling lists.
Use Touchscreen Virtual Keyboard
Raspberry Pi OS Bookworm and later versions include Squeekboard on-screen keyboard by default.
- The keyboard system will automatically pop up when text input is available and automatically hide when text input is not available.
- It can also be shown or hidden manually via the keyboard icon in the top right corner of the taskbar
You can also permanently set the display or hiding of the on-screen keyboard through the menu Preferences → Control Centre → Display in the upper left corner.
In the Bookworm system, you can set the keyboard to be displayed or hidden via Raspberry Pi Configuration → Display or raspi-config → Display.
- Note:
For older versions of Raspberry Pi OS before Bookworm, please use matchbox-keyboard. If you are using the wayfire desktop compositor, use wvkbd.
Resources
3D Diagram
2D Diagrams
FAQ
Replace the image in the directory (/usr/share/plymouth/themes/pix/splash.png) with your customized image
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)