Difference between revisions of "8inch DSI LCD"

From Waveshare Wiki
Jump to: navigation, search
Line 24: Line 24:
 
<div class="tabbertab" title="Resources">
 
<div class="tabbertab" title="Resources">
  
=='''Resources'''==
+
==Resources==
  
 
=== Software ===
 
=== Software ===

Revision as of 03:18, 26 May 2022

8inch DSI LCD
8inch DSI LCD

{{{name2}}}

{{{name3}}}

{{{name4}}}

{{{name5}}}

Introduction

8inch Capacitive Touch Display for Raspberry Pi, 800×480, MIPI DSI Interface

Features

  • 8inch capacitive touch 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.

Featured Design

8inch-DSI-LCD-Manual-design.jpg
  1. LCD FFC cable anti-interference design, more stable for industrial applications.
  2. VCOM voltage adjustment for optimizing display effect.
  3. Power supply via pogo pins, eliminating messy cables connection.
  4. Two types of 5V output headers, for connecting cooling fans or other low-power devices.
  5. Reversed the camera hole on the touch panel for the external camera.
  6. Large front panel design, makes it easy to match user-defined cases or to be integrated into sorts of devices.
  7. Adopts SMD nuts for holding and fixing the board, a more compact structure.

Hardware connection

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

1) Use the 15PIN FPC cable to connect the DSI interface of the 8-inch DSI LCD to the DSI interface of Raspberry Pi.
2) For ease of use, you can attach the Raspberry Pi to the back of the 8-inch DSI LCD fixed with screws, and assemble the copper pillars.
The connection is as below: (The Raspberry Pi GPIO interface will power the LCD through the Pogo pin).

8inch-DSI-LCD-Manual-02.jpg

Working with Pi 5/CM4/CM3+/CM3

1. Use a DSI-Cable-12cm cable to connect the 8-inch DSI LCD to the 22-pin DSI1 interface on the Raspberry Pi board.
2. For convenience, securely fasten the Raspberry Pi 5 to the back of the 8-inch DSI LCD using screws, and assemble it with standoffs.
The installation effect is shown in the diagram below: (The Raspberry Pi will power the LCD through pogo pins)
8inch DSI LCD RPI5.jpg

Software Settings

Raspberry Pi OS Imager Insallation

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.
4.3inch-DSI-LCD-Pi5-03.png
  • 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. 
dtoverlay=vc4-kms-v3d
#DSI1 Use
dtoverlay=vc4-kms-dsi-7inch
#DSI0 Use
#dtoverlay=vc4-kms-dsi-7inch,dsi0
  • 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
./install.sh

After installation, you can open it: Menu -》Accessories -》Brightness:

43H-800480-IPS07.GIF

In addition, you can also input the following commands to control the backlight brightness:

echo X | sudo tee /sys/class/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/class/backlight/*/brightness
echo 0 | sudo tee /sys/class/backlight/*/brightness
echo 255 | sudo tee /sys/class/backlight/*/brightness

Bookworm Touchscreen Rotation

  • 1. Open "Screen Configuration" application:

DSI-LCD-Bookworm-Rotate-01.png

  • 2. Enter "Screen" -> "DS-1" -> "Touchscreen", and select "6-0038 generic ft5x06(79)".

DSI-LCD-Bookworm-Rotate-02.png

  • 3. Click "Apply", and then close the current window. Reboot according to the pop-up prompts to complete the specified touchscreen;

DSI-LCD-Bookworm-Rotate-03.png
DSI-LCD-Bookworm-Rotate-05.png

  • 4. Enter "Screen" -> "DS-1"->"Orientation", and select the rotation direction. Then click on "Apply".

DSI-LCD-Bookworm-Rotate-04.png
Note: Only the Bookworm system supports the above-synchronized rotation method, for Bullseye and Butser systems, after displaying the rotation, you need to set the touch rotation additionally.

Bullseye/Buster Display Rotation

  • 1. Open "Screen Configuration" application:

DSI-LCD-Bullseye-Rotate-02.png

  • 2. Enter "Screen"->"DS-1"->"Orientation", select the rotation direction, and then click on "Apply".

DSI-LCD-Bullseye-Rotate-03.pngDSI-LCD-Bullseye-Rotate-04.png

Stretch/Jessie Display Rotation

For some older systems, which do not use the vc4-kms-v3d or vc4-fkms-v3d driver modes, the display rotation method is as follows:

  • 1. Add statements to the config.txt file (the config file is located in the root directory of the TF card, i.e. /boot):
display_rotate=1 #1:90;2: 180; 3: 270
  • 2. Just save and reboot the Raspberry Pi:
sudo reboot

Touch Rotation

Some systems show inconsistent touch direction after rotation, requiring touch rotation as below:
1. Install libinput

sudo apt-get install xserver-xorg-input-libinput

2. If the system you installed is an Ubuntu system, or Jetson Nano, the installation command is:

sudo apt install xserver-xorg-input-synaptics

3. .Create the xorg.conf.d directory under /etc/X11/ (if this directory already exists, this goes directly to step 3):

sudo mkdir /etc/X11/xorg.conf.d

4. Copy "40-libinput-conf" file to the directory just created:

sudo cp /usr/share/X11/xorg.conf.d/40-libinput.conf /etc/X11/xorg.conf.d/

5. Edit:

sudo nano /etc/X11/xorg.conf.d/40-libinput.conf 
#Find the touchscreen part, add the corresponding commands to rotate, and then save:  
#90°Right touch rotation: 
Option "CalibrationMatrix" "0 1 0 -1 0 1 0 0 1"
#180° Inverted touch rotation:
#Option "CalibrationMatrix" "-1 0 1 0 -1 1 0 0 1"
#270° Left rotation:
#Option "CalibrationMatrix" "0 -1 1 1 0 0 0 0 1"
As shown below:

Touch roate.jpg
6. Reboot the Raspberry Pi:

sudo reboot

The touch will be rotated after completing the above steps.

Sleep

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 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 the system. (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):

disable_touchscreen=1

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

FAQ

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

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

{{{3}}}
{{{4}}}

{{{5}}}



Support