5inch DSI LCD (B)

From Waveshare Wiki
Revision as of 09:59, 28 March 2023 by Eng52 (talk | contribs)
Jump to: navigation, search
5inch DSI LCD (B)

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, 800 x 480 hardware resolution.
  • 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 DSI-Cable-15cm 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.
  • Backlight adjustable via software.

User Guide

Hardware connection

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

Software setting

Supports Raspberry Pi OS / Ubuntu / Kali and Retropie systems for Raspberry Pi.
1) Download the 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, and 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 programming is completed, open the config.txt file in the root directory of the TF card, add the following code at the end of config.txt, save and eject 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.

Backlight control

The backlight brightness can be controlled by entering the following command in the terminal:

echo X > /sys/class/backlight/10-0045/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 > /sys/class/backlight/10-0045/brightness
echo 0 > /sys/class/backlight/10-0045/brightness
echo 255 > /sys/class/backlight/10-0045/brightness

In addition, Waveshare provides a corresponding application (which is only available for the Raspberry Pi OS system), which users can download and install in the following way:

wget https://www.waveshare.com/w/upload/f/f4/Brightness.zip
unzip Brightness.zip
cd Brightness
sudo chmod +x install.sh

Once the installation is finished, the program can be opened from the Start Menu -> Accessories -> Brightness, as follows:

Sleep mode

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

xset dpms force off

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 and can also be accessed via the command: sudo nano /boot/config.txt):


Note: A reboot is required to take effect after adding the command.


3D Drawing




Please configure it 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).




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.