7inch DSI LCD (E)
Features
- 7inch DSI touch screen, supports ten-point capacitive touch control
- Wide color gamut IPS display panel, hardware resolution of 1280×800, color gamut of 68% NTSC
- Optical bonding toughened glass panel, clearer picture quality
- Equipped with 6H hardness tempered glass touch cover
- Compatible with Raspberry Pi 5/4B/CM4/3B+/3A+/3B/CM3+/CM3
- Directly drive the LCD through the Raspberry Pi's DSI interface, with a refresh rate of up to 60Hz
- When used with Raspberry Pi, it is compatible with Bookworm/Bullseye/Buster systems
- Supports software to adjust the brightness of the backlight
Hardware connection
Working with Raspberry Pi 5
1. Use the DSI-Cable-12cm cable to connect the DSI port of the display to the 22PIN DSI1 port of the Raspberry Pi motherboard. 2. Secure the Raspberry Pi to the display with M2.5 screws, ensuring that the spring pins make good contact with the Raspberry Pi.
The installation effect is as follows:
Note: Ensure that the DSI cable is connected in the correct direction and supplies 5V power to the display via the spring pins.
Working with Raspberry Pi4B/3B+/3B/3A+
1. Use a double-headed 15PIN FPC cable to connect the DSI interface of the display to the DSI interface of the Raspberry Pi motherboard. 2. Secure the Raspberry Pi to the display with M2.5 screws, ensuring that the spring pins make good contact.
The installation effect is as follows:
Note: Ensure that the DSI cable is connected in the correct direction and supplies 5V power to the display via the spring pins.
Working with CM4/CM3
1. Use the DSI-Cable-12cm cable to connect the DSI port of the display to the 22PIN DSI1 port of the Raspberry Pi motherboard. 2. Using the 4PIN PH2.0 cable, connect the 5V and GND of the display to the 5V and GND pins of the Raspberry Pi respectively. (I2C0 touch communication is used by default, if you switch to I2C1 touch communication, you need to connect SDA1 and SCL1 pins additionally)
The installation effect is as follows:
Note: Ensure that the DSI cable is connected in the correct direction and supplies 5V power to the display via the cable.
Software settings
For Bookworm and Bullseye system
- 1. Connect the TF card to the PC, download and use Raspberry Pi Imager to burn the corresponding system image.
- 2. After the image burning 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/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,8_0_inch #DSI0 Use #dtoverlay=vc4-kms-dsi-waveshare-panel,8_0_inch,dsi0
- 3. Insert the TF card into the Raspberry Pi, power on the Raspberry Pi, and wait for a few seconds normally to enter the display. After the system starts, it can be touched normally.
For Buster system
Method 1: Install the driver manually
1. Download the latest version of the image from the Raspberry Pi official website, download the compressed file to your 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 burn the system image.
4. After the burning is completed, connect the TF card to the Raspberry Pi, start the Raspberry Pi, and log in to the terminal of the Raspberry Pi (you can connect the Raspberry Pi to the HDMI display or use ssh to log in remotely).
#Step 1: Download and enter the Waveshare-DSI-LCD driver folder git clone https://github.com/waveshare/Waveshare-DSI-LCD cd Waveshare-DSI-LCD
#Step 2: Enter name -a on the terminal to view the kernel version, and cd it to the corresponding file directory #6.1.21 then run the following command cd 6.1.21
#Step 3: Please determine the bits of the current system you are using. For a 32-bit system, proceed to the 32 directory, and for a 64-bit system, proceed to the 64 directory cd 32 #cd 64
#Step 4: Enter your corresponding model command to install the driver, pay attention to the selection of the I2C dip switches #10.1inch DSI LCD(C) 1280×800 Driver: sudo bash ./WS_xinchDSI_MAIN.sh 80C I2C0
#Step 5: Wait for a few seconds, when the driver installation is complete and no error is displayed, restart and load the DSI driver to use it normally sudo reboot #Note: The steps above require that the Raspberry Pi can connect to the internet normally
5. Wait for the system to reboot, it will be able to display and touch normally.
Method 2: Burn the pre-installed image
1. Select your corresponding Raspberry Pi version image, download and unzip it as .img file
Raspberry Pi 4B/CM4 version download: Waveshare DSI LCD - Pi4 pre-installed image
Raspberry 3B/3B+/CM3 Version Download: Waveshare DSI LCD - Pi3 pre-installed image
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 burn the system image.
4. After the burning is completed, open the config.txt file in the root directory of the TF card, add the following code under [all], save and safely eject the TF card.
dtoverlay=WS_xinchDSI_Screen,SCREEN_type=8,I2C_bus=10 dtoverlay=WS_xinchDSI_Touch,invertedx,swappedxy,I2C_bus=10
5. Connect the TF card to the Raspberry Pi, start the Raspberry Pi, and wait for about 30 seconds for it to be displayed and touched normally.
Adjusting Backlight Brightness
- 1. Open the "Screen Configuration" application;
- 2. Go to "Screen" -> "DSI-2" -> "Brightness", check the backlight brightness you need to set, and finally click "Apply" to complete the backlight setting.
Waveshare also provides a corresponding demo (the demo is only used for Bookworm and Bullseye systems), users can download, install and use in the following way:
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:
In addition, you can also control the brightness of the backlight by entering the following command on the 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
Bookworm touch screen rotation
- 1. Open the Screen Configuration application;
- 2. Go to Screen - > DSI-1 - > Touchscreen and check 10-0014 Goodix Capacitive TouchScreen;
- 3.Click Apply, then close the current window, and reboot according to the pop-up prompts to complete the specified touch screen;
- 4.Go to Screen > DSI-1 - - > Orientation, check the direction you need to rotate, and finally click Apply to complete the display and touch synchronous rotation.
Note: Only the Bookworm system supports the above synchronization rotation method. For the Bullseye and Butser systems, manual separate settings for touch rotation are required after displaying the rotation.
Adjusting Backlight Brightness
- 1. Open the "Screen Configuration" application;
- 2. Go to "Screen" -> "DSI-2" -> "Brightness", check the backlight brightness you need to set, and finally click "Apply" to complete the backlight setting.
Waveshare also provides a corresponding demo (the demo is only used for Bookworm and Bullseye systems), users can download, install and use in the following way:
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:
In addition, you can also control the brightness of the backlight by entering the following command on the 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
Bookworm touch screen rotation
- 1. Open the Screen Configuration application;
- 2. Go to Screen - > DSI-1 - > Touchscreen and check 10-0014 Goodix Capacitive TouchScreen;
- 3.Click Apply, then close the current window, and reboot according to the pop-up prompts to complete the specified touch screen;
- 4.Go to Screen > DSI-1 - - > Orientation, check the direction you need to rotate, and finally click Apply to complete the display and touch synchronous rotation.
Note: Only the Bookworm system supports the above synchronization rotation method. For the Bullseye and Butser systems, manual separate settings for touch rotation are required after displaying the rotation.
Bullseye/Buster display rotation
- 1. Open the Screen Configuration application;
- 2.Go to Screen > DS-1 - - > Orientation, check the direction you need to rotate, and finally click Apply to complete the display rotation.
Bullseye/Buster touch rotation
sudo nano /boot/config.txt # The command to modify the touch rotation angle at the end of the config.txt file will take effect after restarting (the command with 0° touch direction exists by default) #0°: dtoverlay=WS_xinchDSI_Touch,invertedx,swappedxy #90°: dtoverlay=WS_xinchDSI_Touch,invertedx,invertedy #180°: dtoverlay=WS_xinchDSI_Touch,invertedy,swappedxy #270°: dtoverlay=WS_xinchDSI_Touch
lite version display rotation
sudo nano /boot/cmdline.txt #Add a command to display the rotation angle at the beginning of the cmdline.txt file, and save it to take effect after restarting #Display rotation 90 degrees video=DSI-1:1280x800M@60,rotate=90 #Display rotation 180 degrees video=DSI-1:1280x800M@60,rotate=180 #Display rotation 270 degrees video=DSI-1:1280x800M@60,rotate=270
Screen sleep
Run the following command on the Raspberry Pi terminal and the screen will go to sleep:
xset dpms force off
Disable touch
At the end of the config.txt file, add the following command corresponding to disabling touch (the config file is located in the root directory of the TF card, which can also be accessed by the command: sudo nano /boot/config.txt):
disable_touchscreen=1
Note: After adding a command, it needs to be restarted to take effect.
Resources
3D Drawings
2D Drawings
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)