5inch DSI LCD (B)

From Waveshare Wiki
Jump to: navigation, search
5inch DSI LCD (B)

5inch Capacitive Touch Screen LCD for Raspberry Pi, DSI Interface





  • 5inch IPS display screen, 800 x 480 hardware resolution.
  • Capacitive touch panel, support 5-point touch.
  • Toughened glass capacitive touch panel, hardness up to 6H.
  • Supports Pi5/4B/CM4/3B+/3A+/3B/CM3/CM3+/2B/B+/A+.
  • Directly drive the LCD by the DSI interface on the Raspberry Pi, with up to 60Hz refreshing rate.
  • When working with Raspberry Pi, support Raspberry Pi OS / Ubuntu / Kali and Retropie, driver-free.
  • When working with VisionFive, support Debian, single-point control, and driver-free.
  • When working with Tinker Board 2, support Linux/Android, five-point control, and driver-free.
  • When working with Core3566, support Debian/Ubuntu, five-point control, and driver-free.
  • Support brightness adjustable through software control.

Hardware Connection

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

  • Use an FFC cable to connect the 5-inch DSI LCD to the 15-pin DSI interface on the Raspberry Pi board.
  • For easy use, you can fix the Raspberry Pi on the backside of the 5-inch DSI LCD with screws.

Work with Pi 5/CM4/CM3+/CM3

  • Use a DSI-Cable-12cm cable to connect the 5-inch DSI LCD to the 22-pin DSI1 interface on the Raspberry Pi board.
  • For convenience, you can secure the Raspberry Pi 5 to the back of the 5-inch DSI LCD using screws and assemble standoffs as shown in the following diagram:

Software Setting

Raspberry Pi OS Imager Installation

For Raspberry Pi OS/Ubuntu/Kali and Retropie system:

  • 1. Connect the TF card to the PC, download and use Raspberry Pi Imager to program the corresponding system.
  • 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. 
#DSI1 Use
#DSI0 Use
  • 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://www.waveshare.com/w/upload/f/f4/Brightness.zip
unzip Brightness.zip
cd Brightness
sudo chmod +x 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


Run the following commands on the Raspberry Pi terminal, and the screen will 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 corresponding to disabling touch (the config file is located in the root directory of the TF card, and can also be accessed through the command: sudo nano /boot/config.txt):


Note: After adding the command, it needs to be restarted to take effect.


3D Drawing



Using a 5V power supply, the maximum brightness operating current is about 250mA and the minimum brightness operating current is about 150mA.



The default state is to support software adjustment, it is recommended to view #Backlight Control, you can also weld PWM to control the backlight as follows:
As shown in the figure below, first remove the original soldered resistor, and then connect the pad (left pad) of the resistor to the P1 pin of the Raspberry Pi, and you can use GPIO to control the backlight.

  • gpio -g pwm 18 0
  • gpio -g mode 18 pwm (the occupied pins are PWM pins)
  • gpio pwmc 1000
  • Control brightness:
  • gpio -g pwm 18 X (X is between 0 and 1024, 0 is the darkest, and 1024 is the brightest)
  • PS: In order to ensure a good customer experience, the default factory minimum brightness is the visible state. If you need to completely turn off the backlight to achieve a black screen effect, please manually change the 100K resistor as shown below to a 68K resistor(Chip resistor 68K 0603 ±1%) :





The hardware connection between DSI LCD and Pi5:
(1) A DSI cable (official Raspberry Pi cable or Waveshare Pi5-Display-Cable-200mm) for Pi 5 is required. Please ensure the proper orientation with the SODIMM.
(2) Priority usage for Pi5's DSI1 interface.

If use the DSI0 interface, you need to add "dtoverlay=vc4-kms-dsi-7inch,dsi0" in the config.txt file

4.3inch DSI LCD-faq-20.png
2. Check the DSI LCD version.
(1) The latest DSI LCD version compatible with Pi5 is Rev2.2, which can be directly used.
(2) If you purchased the product earlier, such as the Rev2.1 version (or older), due to the power detection mechanism of Pi5, it may misidentify the capacitors on the DSI LCD as a false short-circuit state, preventing the system from booting. In this situation, you can manually remove the large capacitors at the four positions marked in red circles in the image below.
5inch DSI LCD-B-faq-21.png
3. Software Setup:
For the Pi5, use the Bookworm system. (Please note, Pi5 currently only supports Bookworm, not Bullseye or Buster).
(1) Go to the Raspberry Pi official website: https://www.raspberrypi.com/software/operating-systems/. Download the latest version of the Bookworm image. Download the compressed file to your PC and extract it to obtain the .img file.
(2) Connect the microSD card (TF card) to your PC and use the SDFormatter software to format the microSD card.
(3) Open the Win32DiskImager software. Select the system image prepared in Step 1 and click 'Write' to burn the system image.
(4) After the writing process is complete, open the 'config.txt' file in the root directory of the microSD card. Add the following code at the end of 'config.txt', save it, and safely eject the microSD card.


(5) Insert the TF card into the Raspberry Pi, power it, and then enter after waiting for a few seconds. Then, the system boots and can be touched.

Note that if use the DSI0 interface at the same time, you need to add the additional commands: "dtoverlay=vc4-kms-dsi-7inch,dsi0"



Since the first-generation Raspberry Pi released, Waveshare has been working on designing, developing, and producing various fantastic touch LCDs for the Pi. Unfortunately, there are quite a few pirated/knock-off products in the market. They're usually some poor copies of our early hardware revisions, and comes with none support service.

To avoid becoming a victim of pirated products, please pay attention to the following features when purchasing:


(Click to enlarge)

Beware of knock-offs

Please note that we've found some poor copies of this item in the market. They are usually made of inferior materials and shipped without any testing.

You might be wondering if the one you're watching or you've purchased in other non-official stores is original, feel free to contact us.


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)