7inch DSI LCD (B)

Features

• 7-inch DSI touch screen, 5-point capacitive touch control.
• IPS screen with a hardware resolution of 800 x 480.
• Support Pi5/4B/CM4/3B+/3A+/3B/CM3/CM3+/2B/B+/A+.
• Support drives the LCD directly via the DSI interface of the Raspberry Pi, and the refresh rate is up to 60Hz.
• When working with Raspberry Pi, it supports Raspberry Pi OS/Ubuntu/Kali and Retropie, driver-free.
• When working with VisionFive2, it supports Debian, single-point control, and driver-free.
• When working with Tinker Board 2, it supports Linux/Android, up to five-point touch control, and is driver-free.
• When working Core3566, it supports Debian/Ubuntu, up to five-point touch control, and is driver-free.
• Support brightness adjusted by the software.

Hardware Connection

Working with Pi 4B/3B+/3A+/3B/2B/B+/A+

1. Connect the 7-inch DSI LCD to the 15PIN DSI interface of Raspberry Pi with the FFC cable.
2. Connect the power port to the 40PIN GPIO header with a 2PIN power cable.

3. For ease of use, the Raspberry Pi can be fixed on the back of the 7-inch DSI LCD with screws and install with standoffs.
The final installation is shown below:

Working with Pi 4B/3B+/3A+/3B/2B/B+/A+

1. Connect the 7inch DSI LCD to the 22PIN DSI1 interface of the Raspberry Pi with DSI-Cable-12cm.
2. Use the 2PIN power cable to connect the LCD's power port to the 40PIN GPIO headers of the Raspberry Pi.

3. For convenience, you can fix the Raspberry Pi 5 on the back of the 7-inch DSI LCD with screws, and assemble the standoffs.

Software Setting

It is used for Raspberry Pi OS/Ubuntu/Kali and Retropie systems.
1. Please click Raspberry Pi official website to download the newest image. Download the compressed file to the PC and unzip it to get the .img file.

2. After installing the imager, open the "config.txt" file on the TF card root directory, add the following codes at the end of "config.txt", and then safely remove the TF card.

Note: as there are two MIPI DSI interfaces on the Pi5/CM4/CM3+/CM3, please pay attention to using the correct DSI interface and commands, and the DSI1 interface is recommended. 

dtoverlay=vc4-kms-v3d
#DSI1 Use
dtoverlay=vc4-kms-dsi-7inch
#DSI0 Use
#dtoverlay=vc4-kms-dsi-7inch,dsi0

3. Insert the TF card into the Raspberry Pi, power it up, and wait for a few seconds for the display. Once the system boots up, you should be able to interact with it normally, including touchscreen functionality.

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://files.waveshare.com/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/class/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/class/backlight/*/brightness
echo 0 | sudo tee /sys/class/backlight/*/brightness
echo 255 | sudo tee /sys/class/backlight/*/brightness

Bookworm Touchscreen Rotation

• 1. Open "Screen Configuration" application:
  

• 2. Enter "Screen" -> "DS-1" -> "Touchscreen", and select "6-0038 generic ft5x06(79)".
  

• 3. Click "Apply", and then close the current window. Reboot according to the pop-up prompts to complete the specified touchscreen;

• 4. Enter "Screen" -> "DS-1"->"Orientation", and select the rotation direction. Then click on "Apply".
  

Note: Only the Bookworm system supports the above-synchronized rotation method, for Bullseye and Butser systems, after displaying the rotation, you need to set the touch rotation additionally.

Bullseye/Buster Display Rotation

• 1. Open "Screen Configuration" application:
  

• 2. Enter "Screen"->"DS-1"->"Orientation", select the rotation direction, and then click on "Apply".
  

Stretch/Jessie Display Rotation

For some older systems, which do not use the vc4-kms-v3d or vc4-fkms-v3d driver modes, the display rotation method is as follows:

• 1. Add statements to the config.txt file (the config file is located in the root directory of the TF card, i.e. /boot)：

display_rotate=1 #1：90；2: 180； 3: 270

• 2. Just save and reboot the Raspberry Pi:

sudo reboot

Touch Rotation

Some systems show inconsistent touch direction after rotation, requiring touch rotation as below:
1. Install libinput

sudo apt-get install xserver-xorg-input-libinput

2. If the system you installed is an Ubuntu system, or Jetson Nano, the installation command is:

sudo apt install xserver-xorg-input-synaptics

3. .Create the xorg.conf.d directory under /etc/X11/ (if this directory already exists, this goes directly to step 3):

sudo mkdir /etc/X11/xorg.conf.d

4. Copy "40-libinput-conf" file to the directory just created:

sudo cp /usr/share/X11/xorg.conf.d/40-libinput.conf /etc/X11/xorg.conf.d/

5. Edit:

sudo nano /etc/X11/xorg.conf.d/40-libinput.conf 
#Find the touchscreen part, add the corresponding commands to rotate, and then save:  
#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 rotation:
#Option "CalibrationMatrix" "0 -1 1 1 0 0 0 0 1"
As shown below:

6. Reboot the Raspberry Pi:

sudo reboot

The touch will be rotated after completing the above steps.

Sleep

Run the following commands on the Raspberry Pi terminal and the screen enter sleep mode:

xset dpms force off

The above command is only for Bullseye and Buster systems.

Disable Touch

At the end of the config.txt file, add the following commands to disable the touch. The config file is located in the root directory of the TF card and can also be accessed by the command: sudo nano /boot/config.txt.

disable_touchscreen=1

Note: You should reboot it after adding the commands.

FAQ

Question:What is the power consumption of the 7inch DSI LCD?

 Answer:

5V 500mA

{{{5}}}

Question:When using the Bookworm system with Pi5, encountering an issue where the DSI LCD is not displaying. How can this be resolved?

 Answer:

Check the system version using "uname --all". If it's kernel version 6.6.20, run "sudo rpi-update pulls/6050" to fix it.
Note: Take care to back up any important data in your image before updating in case there is a regression.

{{{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)

Submit Now