5inch DSI LCD

From Waveshare Wiki
Revision as of 06:27, 29 July 2022 by Eng52 (talk | contribs) (→‎FAQ)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
5inch DSI LCD

5inch capacitive Touch Screen LCD for Raspberry Pi
DSI Interface





5inch Capacitive Touch Display for Raspberry Pi, 800 × 480, TFT Wide Angle, MIPI DSI Interface.


  • 5inch TFT screen, hardware resolution is 800 x 480.
  • Capacitive touch panel, support 5-point touch.
  • Tempered glass capacitive touch panel, hardness up to 6H.
  • Supports Pi 4B/3B+/3A+/3B/2B/B+/A+. Another adapter board CM-DSI-ADAPTER is required for CM3/3+/4.
  • DSI interface, refresh rate up to 60Hz.
  • When used with Raspberry Pi, it supports Raspberry Pi OS / Ubuntu / Kali and Retropie without a driver.
  • Supports backlight brightness control with the software.

User guide

Hardware connection

  • Using the FFC cable, connect the 5inch DSI LCD to the DSI port of the Raspberry Pi.
  • For easy use, you can fix the Raspberry Pi on the backside of the 5inch DSI LCD by screws.

Software setting

Supports Raspberry Pi OS / Ubuntu / Kali and Retropie systems for Raspberry Pi.
1) Download image from the Raspberry Pi website.

2) Download the compressed file to the PC, and unzip it to get the .img file.

3) Connect the TF card to the PC, use SDFormatter software to format the TF card.

4) Open the Win32DiskImager software, select the system image downloaded in step 2, and click ‘Write’ to write the system image.

5) After the image has finished writing, save, and quit the TF card safely.

6) Power on the Raspberry Pi and wait for a few seconds until the LCD displays normally. And the touch function can also work after the system starts.


  • On December 2, 2021, the Raspberry Pi OS was divided into two branches, the Buster branch and the Bullseye branch. The Buster branch is a continuation of the old system and is more stable. The Bullseye branch added some new features, using open source libraries and new interfaces. Since the current Bullseye branch has just been released shortly, it is not stable yet. If you are an industrial user, it is strongly recommended to use the Buster branch.
  • If you are using the Buster branch system, the DSI LCD can work with Raspberry Pi directly after connecting and powering on. But if you are using the Bullseye branch system, you need to modify the config.txt as below:

Open the config.txt file in the root directory of the TF card(/boot), comment out the following lines:


Add the following lines under [all]:


Then save the file and reboot the system:

sudo reboot
  • If you need to use the CSI camera under the Bullseye branch system. Since this branch uses the libcamera camera library by default, the library doesn't support FKMS drivers.

So in addition to the above modification, you also need to install the Raspicam camera library.

The installation method is as follows:

cd ~
sudo apt install cmake
git clone https://github.com/raspberrypi/userland
cd userland
sudo cp build/bin/* /bin/

Then execute the following command to shut down the system:


Connect the Raspberry Pi camera to the CSI interface of the Raspberry Pi, power on the Raspberry Pi again, and after the system boots, execute the following command:

Take a picture:

raspistill -o image.jpg

Take a video:

raspivid -o video.h264 -t 10000

Backlight Control

  • Open a terminal and type the following command to adjust the brightness.

Note: If the command reports the 'Permission denied' error, please switch to the 'root' user mode and execute it again.

echo X > /sys/class/backlight/rpi_backlight/brightness

X can be value in range 0~255. The backlight is darkest if you set it to 0 and the backlight is set to lightest if you set it to 255

echo 100 > /sys/class/backlight/rpi_backlight/brightness
echo 0 > /sys/class/backlight/rpi_backlight/brightness
echo 255 > /sys/class/backlight/rpi_backlight/brightness
  • We also provide a example for brightness adjusting, you can download and install it by following commands:
wget https://www.waveshare.net/w/upload/3/39/Brightness.tar.gz
tar -xzf Brightness.tar.gz
cd brightness
After connecting, you can choose Menu -> Accessories -> Brightness to open the adjustment software

Note: If you use the 2021-10-30-raspios-bullseye-armhf image or the laster version, please add the line dtoverlay=rpi-backlight to the config.txt file and reboot.

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

sudo apt-get install matchbox-keyboard

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


Please configure as below and try to use the camera again.
sudo raspi-config

Choose Advanced Options -> Glamor -> Yes(Enabled) -> OK -> Finish -> Yes(Reboot)



With 5V power, the working current of Pi 4 only is about 450mA~500mA.

With 5V power, the working current of Pi 4 + 5inch DSI LCD is about 700mA ~ 750mA (brightest).
With 5V power, the working current of Pi 4 + 5inch DSI LCD is about 550mA ~ 600mA (darkest).



It needs to make a modification of the hardware of the LCD.

1.Replace the resistor shown in the red box with a 75k resistor.
With 5V power, the working current of Pi 4 + 5inch DSI LCD is about 550mA ~ 600mA (darkest).
2.And then use the commands provided on our wiki
Use the command
echo 0 > /sys/class/backlight/rpi_backlight/brightness
to directly turn off the backlight.



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:





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.


If you require technical support, please go to the Support page and open a ticket.