Raspberry Pi Touch Display 2

From Waveshare Wiki
Jump to: navigation, search

Features

  • 7inch DSI touch screen, supports five-point capacitive touch control
  • IPS display panel with a hardware resolution of 720×1280
  • Compatible with Raspberry Pi 5/CM5/4B/CM4/3B+/3A+/3B/CM3+/CM3
  • Directly drive the LCD through the Raspberry Pi's DSI interface, with a refresh rate of up to 60Hz
  • When used with Raspberry Pi, it is compatible with Trixie/Bookworm system
  • Support adjusting backlight brightness through software

Hardware Connection

Working with Raspberry Pi 5

1. Use the "Pi5 DSI FFC cable" to connect the DSI port of the display to the 22PIN DSI1 port of the Raspberry Pi motherboard.
2. Use the "GPIO cable" to connect the power connector of the display to the pin header of the Raspberry Pi motherboard.
3. Secure the Raspberry Pi to the display with M2.5 screws.

The installation effect is as follows:
DSC 0208.jpg

Note: Make sure that the DSI cable is connected in the correct direction and 5V power is supplied through the GPIO pins.

Working with Raspberry Pi4B/3B+/3B/3A+

1. Use the "Pi4 DSI FFC cable" to connect the DSI port of the display to the DSI port of the Raspberry Pi motherboard.
2. Use the "GPIO cable" to connect the power connector of the display to the pin header of the Raspberry Pi motherboard.
3. Secure the Raspberry Pi to the display with M2.5 screws.

The installation effect is as follows:
DSC 0209.jpg

Note: Make sure that the DSI cable is connected in the correct direction and 5V power is supplied through the GPIO pins.

Software Setting

Working with Trixie/Bookworm

  • 1. Connect the TF card to the PC, download and use Raspberry Pi Imager to flash the corresponding system image.

800x480-DSI-LCD-0.png
Note: Step 2 is only required for CM4 / CM5. If you are using other Raspberry Pi models, you can skip step 2 directly.

  • 2. After the image flashing is completed, open the config.txt file in the root directory of the TF card, add the following code at the end of the config.txt.
dtoverlay=vc4-kms-v3d 
#For DSI1 usage 
dtoverlay=vc4-kms-dsi-ili9881-7inch 
#For DSI0 usage 
#dtoverlay=vc4-kms-dsi-ili9881-7inch,dsi0
  • 3. Insert the TF card into the Raspberry Pi, power on the Raspberry Pi, and wait for a few seconds normally to enter the display. After the system starts, the touch function can be used normally.

Touch screen virtual keyboard

Raspberry Pi OS Bookworm and later versions include Squeekboard on-screen keyboard by default. When a touch display is attached, the on-screen keyboard should automatically show when it is possible to enter text and automatically hide when it is not possible to enter text.
Image-3.png
For applications which do not support text entry detection, use the keyboard icon at the right end of the taskbar to manually show and hide the keyboard.
Image-4.png
You can also permanently show or hide the on-screen keyboard in the Display tab of Raspberry Pi Configuration or the Display section of raspi-config.
Note: In Raspberry Pi OS releases prior to Bookworm, use matchbox-keyboard instead. If you use the wayfire desktop compositor, use wvkbd instead.

Adjust Backlight Brightness

Graphical Interface Backlight Adjustment

The following steps are based on the Trixie system:

  • 1. Click the menu in the upper left corner, then go to "Preferences" → "Control Center", and select "Screens";

8inch dsi lcd -1.png

  • 2. Go to "Screen" -> "DSI-2" -> "Brightness", select and adjust the desired backlight brightness, and finally click "Apply" to save the settings.

8inch dsi lcd -2.png

In the Bookworm system, this setting entry is located at "Screen Configuration" → "Screen".

Use Waveshare Backlight Adjustment Application

You can also use the graphical backlight adjustment tool provided by Waveshare: 

wget https://files.waveshare.com/wiki/common/Brightness.zip
unzip Brightness.zip
cd Brightness
sudo chmod +x install.sh
./install.sh

After the installation is completed, you can open the demo in the Start Menu -> Accessories -> Brightness, as shown below:

43H-800480-IPS-CT-details-13.gif

Adjust Backlight Brightness Using Terminal

echo X | sudo tee /sys/class/backlight/*/brightness

Where X represents any number from 0 to 255. 0 means the darkest backlight, and 255 means the brightest backlight. 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

Trixie/Bookworm Display Rotation

GUI interface rotation
The following steps are based on the Trixie system:

  • 1. Click the menu in the upper left corner, then go to Preferences → Control Center, and select Screens;

8inch dsi lcd -5.png

  • 2. Go to Screen - > DSI-1 - > Touchscreen and check "10-0014 Goodix Capacitive TouchScreen";

8inch dsi lcd -6.png

  • 3. Go to Screen -> DSI-2 -> Orientation, check the direction you need to rotate, and finally click "Apply" to complete the display and touch synchronous rotation.

8inch dsi lcd -7.png

  • In the Bookworm system, this setting entry is located at Screen Configuration → Screen.

Touch Display 2 Device Tree Option Reference

The vc4-kms-dsi-ili9881-7inch overlay supports the following options:

DT parameter Action
sizex Sets X resolution (default 1280)
sizey Sets Y resolution (default 720)
invx Invert X coordinates
invy Invert Y coordinates
swapxy Swap X and Y coordinates
disable_touch Disables the touch overlay totally

To specify these options, add them, separated by commas, to your dtoverlay line in /boot/firmware/config.txt.
For instance, to invert both X and Y coordinates, use the following line: 

dtoverlay=vc4-kms-dsi-ili9881-7inch,invx,invy

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

Safety Instructions

To avoid any malfunction or damage to this product, please follow the following instructions:

  • Turn off your Raspberry Pi computer and disconnect the external power supply before connecting the device.
  • If the cable falls off, pull the locking device on the connector forward, insert the ribbon cable with the metal contacts facing you, and push the locking device back into place.
  • This device should be operated in a dry environment between 0-50℃.
  • Do not expose the device to water or humid environments during operation, nor place it on conductive surfaces.
  • Do not expose it to any overheated environment.
  • Be careful not to fold or tighten the ribbon cable.
  • Be careful when screwing in the parts. Misalignment of threads may cause irreparable damage and void the warranty.
  • Please be careful during transportation to avoid mechanical or electrical damage to printed circuit boards and connectors.
  • Store in a cool and dry place.
  • Avoid sudden temperature changes, otherwise it may lead to the accumulation of moisture inside the device.
  • The screen is fragile and may break.

Resources

FAQ

Question: How to replace Raspberry Pi boot logo image?

 Answer:

Replace the image in the directory (/usr/share/plymouth/themes/pix/splash.png) with your customized image


Support



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 PM GMT+8 (Monday to Friday)

Retrieved from "https://www.waveshare.com/w/index.php?title=Raspberry_Pi_Touch_Display_2&oldid=109056"