Waveshare Pi-4B-3B 7 Inch IPS Display with Capacitive Touch Panel User Guide
- June 1, 2024
- WAVESHARE
Table of Contents
- Overview
- Hardware Connection
- Software Setting
- Resources
- FAQ
- Support
- References
- Read User Manual Online (PDF format)
- Download This Manual (PDF format)
- DSI1 Use
- DSI0 Use
- dtoverlay=vc4-kms-dsi-waveshare-panel,7_0_inchC,i2c1,dsi0
- Step 1: Download and enter the Waveshare-DSI-LCD driver folder git clone
- Step 2: Enter “uname -a” in the terminal to view the kernel version and “cd”
- 6.1.21 then run the following command
- Step 3: Please check the bits of your system, enter the 32 directory for
- cd 64
- Step 4: Enter your corresponding model command to install the driver, pay
- 7inch DSI LCD (C) 1024×600 driver:
- Step 5: Wait for a few seconds, when the driver installation is complete and
Waveshare Pi-4B-3B 7 Inch IPS Display with Capacitive Touch Panel
Overview
Features
- 7-inch DSI display with 5-point capacitive touch.
- IPS panel with a hardware resolution of 1024×600.
- Toughened glass capacitive touch panel with 6H hardness.
- Support Pi5/4B/CM4/3B+/3A+/3B/CM3+/CM3.
- Drive the LCD directly through the DSI interface of the Raspberry Pi, with a refreshing rate of up to 60Hz.
- When working with the Raspberry Pi, it supports Bookworm/Bullseye/Buster.
- Brightness is adjustable by software.
Hardware Connection
Working with Pi4B/3B+/3B/3A+
- Connect the DSI interface of the LCD to the DSI interface of the Raspberry Pi with a 15PIN FPC cable.
- Install the Raspberry Pi with its back facing down onto the base board of the LCD screen, and connect it to 5V power supply and I2C1 communication using 4-pin DuPont cables.
7inch DSI LCD C Wiring.jpg
The final connection is shown below:
Working with Pi5/CM4/CM3+/CM3
- Use the “DSI-Cable-12cm” ribbon cable to connect the LCD screen’s DSI interface to the Raspberry Pi’s 22PIN DSI1 interface.
- Connect to the Raspberry Pi’s 5V power supply and I2C1 communication using a 4-pin DuPont cable.
Software Setting
For Bookworm and Bullseye System
-
1. Insert the TF card into the PC, download and use Raspberry Pi Imager to program the corresponding image.
-
2. After programming the image, open the “config.txt” file located in the root directory of the TF card. Add the following code at the end of config.txt, save the file, and safely eject the TF card.
-
Note: As Pi 5/CM4/CM3+/CM3 has two MIPI DSI interfaces, please ensure to use the correct DSI interface and command. DSI1 is recommended by default.
dtoverlay=vc4-kms-v3dDSI1 Use
dtoverlay=vc4-kms-dsi-waveshare-panel,7_0_inchC,i2c1
DSI0 Use
dtoverlay=vc4-kms-dsi-waveshare-panel,7_0_inchC,i2c1,dsi0
-
3. Insert the TF card into the Raspberry Pi, power on the Raspberry Pi, and wait for a few seconds. After the system boots up, you should be able to enter the display interface and the LCD should touch normally
For Buster System
Method 1: Install Manually
-
Download the image of the newest version Raspberry Pi , download the compressed file to the PC, and extract the .imp file.
-
Connect TF card to PC, use SD Formatter to format TF card.
-
Open Win32DiskImager software, select the system image prepared in step 1 and click write to burn the system image.
-
After the programming 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 an HDMI display or log in remotely with ssh).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” in the terminal to view the kernel version and “cd”
to the corresponding file directory
6.1.21 then run the following command
cd 6.1.21
Step 3: Please check the bits of your system, enter the 32 directory for
32-bit systems, and enter the 64 directory for 64-bit systems cd 32
cd 64
Step 4: Enter your corresponding model command to install the driver, pay
attention to the selection of the I2C DIP switch
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 prompted, restart and load the DSI driver and it can be u
sed normally
sudo reboot
Note: The above steps need to ensure that the Raspberry Pi can be connected to the Internet normally. -
Wait for the system to restart, it will be able to display and touch normally.
Method 2: Program Pre-install Image
-
Select your corresponding Raspberry Pi version image, download and decompress it as “.img” file.
Raspberry Pi 4B/CM4 version download: Waveshare DSI LCD – Pi4 pre-install image
Raspberry Pi 3B/3B+/CM3 version download: Waveshare DSI LCD – Pi3 pre-install image -
Connect the TF card to the PC and use SDFormatter to format the TF card.
-
Open Win32DiskImager software, choose the system image prepared in the first step, and then click “write” to write the system image.
-
After the programming is finished, open the config.txt file in the root directory of the TF card, add the following code under [all], save and eject the TF card safely.
dtoverlay=WS xinchDSI Screen, SCREEN_ type=2,I2C_bus=1
dtoverlay=WS_xinchDSI_Touch,I2C_bus=1 -
Connect the TF card to the Raspberry Pi, and start the Raspberry Pi, wait for about 30 seconds to display and touch normally.
Buster System Notices
-
Update the system and run the following commands:
sudo apt-get update
sudo apt-get full-upgrade
Note: After updating the system, some diver files installed before may be covered, and you need to install the driver again so that it can display normally. -
Replace the main board
If the driver installed was for the Raspberry Pi 4 Model B and the user decides to change the mainboard, for example, to the Raspberry Pi 3 Model B+, it may result in the display screen not showing properly.
This is because the Pi 4 and Pi 3 require loading different driver files. To ensure proper display functionality on the new mainboard, the user needs to reinstall the drivers according to the instructions # For Buster System.
Backlight Control
WaveShare provides the corresponding demo for the application (only supports Bookworm and Bullseye systems). Users can install it by the following commands:
wget https://www.waveshare.com/w/upload/f/f4/Brightness.zip
unzip Brightness.zip
cd Brightness
sudo chmod +x install.sh
./install.sh
After installation, you can open it: Menu -》Accessories -》Brightness:
In addition, you can also input the following commands to control the
backlight brightness:
echo X | sudo tee /sys/devices/platform//////backlight//brightness
Where X indicates any number from 0 to 255. 0 means the backlight is the
darkest, and 255 means the backlight is the brightest. For example:
echo 100 | sudo tee /sys/devices/platform//////backlight//brightness
echo 0 | sudo tee /sys/devices/platform//////backlight//brightness
echo 255 | sudo tee /sys/devices/platform//////backlight//brightness
Sleep Mode
Run the following commands to enter the sleep mode:
xset dpms force off
Disable Touch
At the end of the “config.txt” file, add the following commands to disable touching (the config file is located in the TF card root directory, or you can find it by “sudo nano /boot/config.txt”):
disable_ touchscreen=1
Note: this command takes effect after rebooting.
Resources
Pre-built image
- 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
Question: What is the power consumption of the 7inch DSI LCD (C)?
Answer:
When powered by 5V, the operating current of the backlight on is about 500mA,
and the operating current of the backlight off is about 100mA.
Question: Why do I get an error when using the 2021-10-30-raspios-bullseye- armhf version of the system with the camera?
Answer:
Execute the following commands:
sudo raspi-config -> Advanced Options -> Glamor -> Yes (Enabled) -> Ok ->
Finish -> Yes (Reboot)
Question: How to switch I2C1 communication of 7inch DSI LCD (C) to I2C0?
Answer:
-
1. Weld two resistors in the figure below with 0-ohm resistance.
-
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.
Question: How to lower the LCD brightness?
Answer:
The 1.2R shown in the diagram is a backlight resistor, and increasing its
value can reduce the backlight
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 AM GMT+8 (Monday to
Friday)