Difference between revisions of "7inch DSI LCD (with cam)"

From Waveshare Wiki
Jump to: navigation, search
m (Text replacement - "default={{#urlget:amazon|default}}" to "default={{#ifeq: {{#urlget:amazon|0}}|{{#urlget:Amazon|0}}| default|}}")
m (Text replacement - "{{#urlget:amazon|default}}=display" to "{{#ifeq: {{#urlget:amazon|0}}|{{#urlget:Amazon|0}}| default|}}=display")
Line 9: Line 9:
|category=[[:Category:OLEDs / LCDs|OLEDs / LCDs]], [[:Category:LCD|LCD]], [[:Category:Raspberry Pi LCD|Raspberry Pi LCD]]
|category=[[:Category:OLEDs / LCDs|OLEDs / LCDs]], [[:Category:LCD|LCD]], [[:Category:Raspberry Pi LCD|Raspberry Pi LCD]]
|{{#ifeq: {{#urlget:amazon|0}}|{{#urlget:Amazon|0}}| default|}}=display
|website_cn=[https://www.waveshare.net/shop/ 中文官网]
|website_cn=[https://www.waveshare.net/shop/ 中文官网]
|website_en=[https://www.waveshare.com/7inch-dsi-lcd-with-cam.htm 7inch DSI LCD (with cam)], [https://www.waveshare.com/7inch-dsi-lcd-with-cam-and-case.htm 7inch DSI LCD (with cam and case)]
|website_en=[https://www.waveshare.com/7inch-dsi-lcd-with-cam.htm 7inch DSI LCD (with cam)], [https://www.waveshare.com/7inch-dsi-lcd-with-cam-and-case.htm 7inch DSI LCD (with cam and case)]

Revision as of 11:38, 12 May 2022

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. 800x480 hardware resolution
  • Capacitive touch panel, support 5-point touch
  • OV5647 Camera, 500MP, Fov72.9°, resolution 2592x1944
  • 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 [email protected], [email protected], 640×[email protected], 640×[email protected]
  • Supports Raspberry Pi OS and Ubuntu.
  • Support backlight adjusts 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 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.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 RASPBERRY-PI-OS-BUSTER-BULLSEYE-04-01.png
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)




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 tickets.