7inch DSI LCD (with cam)

From Waveshare Wiki
Jump to: navigation, search
7inch DSI LCD (with cam)

7inch capacitive Touch Screen LCD for Raspberry Pi, DSI Interface with 5MP camera
7inch DSI LCD (with cam and case)

7inch capacitive Touch Screen LCD for Raspberry Pi, DSI Interface, with 5MP camera and protection case




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


  • 7inch TFT screen with a hardware resolution of 800 x 480.
  • Capacitive touch panel supports 5-point touch.
  • OV5647 Camera, 500MP, Fov72.9°, resolution 2592 x 1944.
  • Supports Pi 4B/3B+/3A+/3B/2B/B+/A+. Another adapter cable is required for CM3/3+/4
  • Driven directly through Raspberry Pi's DSI interface, refresh rate up to 60Hz.
  • Driven directly through the Raspberry Pi's CSI interface, support 1920 x 1080p@30, 1280 x 720p@60, 640 × 480p@60, 640 × 480p@90.
  • Supports Raspberry Pi OS and Ubuntu, it is driver-free.
  • Adjust the backlight by software.

User guide

Hardware connection

1) Connect the DSI interface of 7inch DSI LCD to the DSI interface of Raspberry Pi through 15PIN FPC cable.

2) Connect the CSI interface of the display to the CSI interface of the Raspberry Pi board through 15PIN FFC cable.

3) Use the 2PIN power cable to connect the power interface of the LCD to the 40PIN GPIO interface of the Raspberry Pi, as below:


4) For easy use, you can fix the Raspberry Pi on the backside of the 7inch DSI LCD with screws.
The installation effect is shown in the following figure:


Software setting

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.exe software to format the TF card.

4) Open the Win32DiskImager.exe 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.

Backlight Controlling

  • 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 touching

If you want to disable the touch function, you can modify the config.txt file, add the following line to the file and reboot


Using Camera

If you don't know the difference between the two branches of Raspberry Pi OS, you can check the following introduction #Introducing the Raspberry Pi OS fork

Raspberry Pi OS bullseye version

Bullseye image use libcamera stack, libcamera stack is used for driving cameras, and the camera interface is enabled by default.

To test the camera, you can use the following commands:

#libcamera-hello A simple "hello world" application that starts a camera preview stream and displays it on the screen.

libcamera-hello //will display a preview window for about 5 seconds.
libcamera-hello -t 0 //run the preview indefinitely, you can use Ctrl-C in the terminal to exit.

#libcamera-jpeg is a simple still image capture application for capturing high quality image
libcamera-jpeg -o test.jpg // display a preview for about 5 seconds, and then capture a full resolution JPEG image to the file test.jpg

#libcamera-still is a more sophisticated still image capture application, mainly to simulate raspistill
libcamera-still -o test.jpg //display a preview for about 5 seconds, and then capture a image to the file test.jpg

#libcamera-vid  is the video capture application. By default it uses the Raspberry Pi’s hardware H.264 encoder.
libcamera-vid -t 10000 -o test.h264 //Save a 10 second video to test.h264
vlc test.h264 //The resulting file can be played with vlc

#libcamera-raw  is like a video recording application except that it records raw Bayer frames directly from the sensor.
libcamera-raw -t 2000 -o test.raw //Save the 2s raw clip to file test.raw

For more information about the libcamera, pleaes refer to: libcamera and libcamera-apps

Note: If libcamera cannot work with some of Raspberry Pi boards, please configure as below for a try:

sudo raspi-config -> Advanced Options -> Glamor -> Yes(Enabled) -> Ok -> Finish -> Yes (Reboot)

Raspberry Pi OS buster fork with Ubuntu

The raspicam camera subsystem interface is used by default on these systems. The camera interface is enabled by default in Ubuntu. In the Raspberry Pi OS buster branch, you need to execute the following command to open the camera interface

sudo raspi-config -> Interface Options -> Camera -> Yes -> OK -> Finish -> Yes (Reboot)

The camera can be controlled with the following commands:

#raspistill is an application that runs a preview window and then acquires a high-resolution still image.
raspistill -o cam.jpg //A preview window is displayed for about 5 seconds, then the image is saved to cam.jpg
raspistill -vf -hf -o cam2.jpg //Flip Vertical and Flip Horizontal

#raspivid is a video shooting application.
raspivid -o vid.h264 //Save the 5 second video to test.h264
raspivid -o video.h264 -t 10000 //Record 10 second video
raspivid -vf -hf -o video.h264 -t 10000 //Flip Vertical and Flip Horizontal

More detailed information can be found at: Raspicam command

Raspberry Pi OS Introduction

On December 2, 2021, the Raspberry Pi OS for Raspberry Pi split into two branches, the Buster branch, and the Bullseye branch.

The Buster branch is a continuation of the old system, which is more stable and uses raspicam as the default camera subsystem.

The Bullseye branch adds some new features, including KMS as the default display driver and libcamera as the default camera subsystem.
Image download address
More detailed information can be found at:

Raspberry Pi Branch Details

Buster Release Notes

Bullseye Release Notes

Notes: The above information was updated on January 24, 2022. Due to the frequent update of the Raspberry Pi image, when you see this information, the relevant information may be out of date. The actual performance of the image shall prevail. This is for reference only.


External guides



Please configure as below and try to use the camera again.
sudo raspi-config -> Choose Advanced Options -> Glamor -> Yes(Enabled) -> OK -> Finish -> Yes(Reboot)



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)