7inch DSI LCD (C)
| ||
Features
- 7inch DSI touch screen with five-point capacitive touch control
- IPS display panel with a hardware resolution of 1024×600
- Toughened glass touch panel, hardness up to 6H
- 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
- Supports Bookworm/Bullseye/Buster systems when working with Raspberry Pi
- Supports software control of backlight brightness
Video Tutorial
Interface Definition
| PIN | Label |
|---|---|
| 1 | GND |
| 2 | DSI1_DN1 |
| 3 | DSI1_DP1 |
| 4 | GND |
| 5 | DSI1_CN |
| 6 | DSI1_CP |
| 7 | GND |
| 8 | DSI1_DN0 |
| 9 | DSI1_DP0 |
| 10 | GND |
| 11 | SCL0 |
| 12 | SDA0 |
| 13 | GND |
| 14 | 3V3 |
| 15 | 3V3 |
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.
Hardware Connection
Working with Pi5/CM5/CM4/CM3+/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. Use the 4PIN cable to connect to the 5V power supply and I2C1 communication interfaces of the Raspberry Pi motherboard
The installation effect is as follows:
-Pi5.jpg)
Note: The gold finger of the screen-side cable should face upward.
Working with Pi4B/3B+/3B/3A+
1. Use the 15PIN FPC cable to connect the DSI interface of display to the DSI interface of the Raspberry Pi board.
2. Install the Raspberry Pi with its back facing downwards onto the display board, and connect it to the 5V power supply and I2C1 communication interfaces via the 4PIN cable.
The installation effect is as follows:
Note: The gold finger of the screen-side cable should face downward.
Software Setting
For Trixie and Bookworm Systems
- 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_inchC,i2c1 #DSI0 Use #dtoverlay=vc4-kms-dsi-waveshare-panel,7_0_inchC,dsi0,i2c1
- 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, the touch function can be used normally.
For Buster/Bullseye Systems
Method 1: Install 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 flash the system image.
4. After the flashing 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 uname -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 #7inch DSI LCD(C) 1024×600 Driver: sudo bash ./WS_xinchDSI_MAIN.sh 70C I2C1
#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 restart, and it will be able to display and touch normally.
Method 2: Flash 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 flash the system image.
4. After the flashing 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=2,I2C_bus=1 dtoverlay=WS_xinchDSI_Touch,I2C_bus=1
5. Connect the TF card to the Raspberry Pi, start the Raspberry Pi, and wait for about 30 seconds before it can be displayed and the touch function can be used normally.
Precautions for Buster System
1. Update the system to execute the following commands
sudo apt-get update sudo apt-get full-upgrade
Note: After updating the system, some files of the originally installed driver may be overwritten, and you need to reinstall the driver to display it normally.
2. Replace the motherboard
If the driver originally installed on the Raspberry Pi 4 Model B, if the user changes the motherboard, such as changing it to the Raspberry Pi 3 Model B+, the display will not display properly.
Because Pi4 and Pi3 need to load different driver files, you need to reinstall the driver according to For Buster System on the new motherboard for it to display normally.
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", select 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 "Screen" -> "DSI-1" -> "Touchscreen" and check "10-0014 Goodix Capacitive TouchScreen";
- 3. Go to "Screen" -> "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".
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 for 0° touch direction exists by default) #90°: dtoverlay=WS_xinchDSI_Touch,invertedx,swappedxy,I2C_bus=1 #180°: dtoverlay=WS_xinchDSI_Touch,invertedx,invertedy,I2C_bus=1 #270°: dtoverlay=WS_xinchDSI_Touch,invertedy,swappedxy,I2C_bus=1 #0°: dtoverlay=WS_xinchDSI_Touch,I2C_bus=1
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:1024x600M@60,rotate=90 #Display rotation 180 degrees video=DSI-1:1024x600M@60,rotate=180 #Display rotation 270 degrees video=DSI-1:1024x600M@60,rotate=270
Set Screen Off and On
Run the following command on the Raspberry Pi terminal and the screen will be turned off:
wlr-randr --output DSI-2 --off # DSI-2 needs to be modified to the actual display in use, e.g. "DSI-1" or "HDMI-A-1"
Run the following command on the Raspberry Pi terminal and the screen will be turned on:
wlr-randr --output DSI-2 --on # DSI-2 needs to be modified to the actual display in use, e.g. "DSI-1" or "HDMI-A-1"
Note: This command is only applicable to the Labwc and Wayfire graphical interfaces and not to the X11 graphical interface.
Screen Sleep
Run the following command on the Raspberry Pi terminal and the screen will enter sleep mode:
xset dpms force off
Note: This command is only applicable to the X11 graphical interface and not to the Labwc and Wayfire graphical interfaces.
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 via the command: sudo nano /boot/config.txt):
disable_touchscreen=1
Note: After adding a command, it needs to be restarted to take effect.
Resources
Pre-built Images
- 2022-01-28-raspios-bullseye-arm64 image
- 2022-01-28-raspios-bullseye-arm32 image
- Waveshare DSI LCD - Pi4 pre-install image
- Waveshare DSI LCD - Pi3 pre-install image
Software
3D Drawing
FAQ
When powered by 5V, the operating current with backlight on is about 500mA, and the operating current with backlight off is about 100mA.
{{{5}}}
Execute the following commands:
sudo raspi-config -> Advanced Options -> Glamor -> Yes (Enabled) -> Ok -> Finish -> Yes (Reboot)
- 1. Weld the two resistors in the figure below with 0-ohm resistors.
- 2. Modify the end of the /boot/config.txt file.
I2C_bus=1 changed to I2C_bus=10
After the above modification, the original I2C1 wiring (GPIO3 and GPIO5 of RPi) needs to be disconnected.
The 1.2R shown in the diagram below is the backlight resistor, and the resistance can be increased to reduce the backlight
-FAQ.png)
{{{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)