• sales

    +86-0755-88291180

Raspberry Pi Touch Display 2 User Guide

Specifications

- Resolution: 1280×720 pixels, 24-bit RGB display

- Active area: 155×88 mm

- Dimensions: 7 inches diagonal

- Powered directly by the host Raspberry Pi, no separate power supply required

- Supports up to five simultaneous touch points


The Touch Display 2 is compatible with all models of Raspberry Pi from Raspberry Pi 1B+ onwards, except Raspberry Pi Zero and Zero 2 W, which lack a DSI connector.


Install


1. Connecting the Touch Display 2 to the Raspberry Pi

To connect a Touch Display 2 to a Raspberry Pi, use a Flat Flexible Cable (FFC) and a GPIO connector. The FFC you’ll use depends upon your Raspberry Pi model:

- for Raspberry Pi 5, use the included 22-way to 15-way FFC

- for any other Raspberry Pi model, use the included 15-way to 15-way FFC


Steps

1、Disconnect your Raspberry Pi from power.

2、Lift the retaining clips on either side of the FFC connector on the Touch Display 2.

3、Insert one 15-way end of your FFC into the Touch Display 2 FFC connector, with the metal contacts facing upwards, away from the Touch Display 2.

      - TIP:If you use the 22-way to 15-way FFC, the 22-way end is the smaller end of the cable. Insert the larger end of the cable into the Touch Display 2.

4、While holding the FFC firmly in place, simultaneously push both retaining clips down on the FFC connector of the Touch

Display 2.

5、Lift the retaining clips on either side of the DSI connector of your Raspberry Pi. This port should be marked with some variation of the term DISPLAY or DISP. If your Raspberry Pi has multiple DSI connectors, prefer the port labelled 1.

6、Insert the other end of your FFC into the Raspberry Pi DSI connector, with the metal contacts facing towards the Ethernet and USB-A ports.

7、While holding the FFC firmly in place, simultaneously push both retaining clips down on the DSI connector of the Raspberry Pi.

8、Plug the GPIO connector cable into the port marked J1 on the Touch Display 2.

9、Connect the other (three-pin) end of the GPIO connector cable to pins 2, 4, and 6 of the Raspberry Pi’s GPIO. Connect the red cable (5V power) to pin 2, and the black cable (ground) to pin 6. Viewed from above, with the Ethernet and USB-A ports facing down, these pins are located at the top right of the board, with pin 2 in the top right-most position.

The GPIO connection to the Touch Display 2

      - TIP:If pin 6 isn’t available, you can use any other open GND pin to connect the black wire. If pin 2 isn’t available, you can use any other 5V pin to connect the red wire, such as pin 4.


10、Optionally, use the included M2.5 screws to mount your Raspberry Pi to the back of the Touch Display 2.

  • Align the four corner stand-offs of your Raspberry Pi with the four mount points that surround the FFC connector and J1 port on the back of the Touch Display 2, taking special care not to pinch the FFC.
  • Insert the screws into the four corner stand-offs and tighten until your Raspberry Pi is secure.

11、Reconnect your Raspberry Pi to power. It may take up to one minute to initialise the Touch Display 2 connection and begin displaying to the screen.


Use an on-screen keyboard

Raspberry Pi OS Bookworm and later include the 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.


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.


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.


TIP: 

In Raspberry Pi OS releases prior to Bookworm, use matchbox-keyboard instead. If you use the wayfire desktop compositor, use wvkbd instead.


Change screen orientation

If you want to physically rotate the display, or mount it in a specific position, select Screen Configuration from the Preferences menu. Right-click on the touch display rectangle (likely DSI-1) in the layout editor, select Orientation, then pick the best option to fit your needs.


Rotate screen without a desktop

To set the screen orientation on a device that lacks a desktop environment, edit the /boot/firmware/cmdline.txt configuration file to pass an orientation to the system. Add the following entry to the end of cmdline.txt:


video=DSI-1:1280x720@60,rotate=<rotation-value>


Replace the <rotation-value> placeholder with one of the following values, which correspond to the degree of rotation relative to the default on your display:

- 0

- 90

- 180

- 270

For example, a rotation value of 90 rotates the display 90 degrees to the right. 180 rotates the display 180 degrees, or upside-down.


NOTE:

It is not possible to rotate the DSI display separately from the HDMI display with cmdline.txt. When you use DSI and HDMI simultaneously, they share the same rotation value.


Touch Display 2 device tree option reference

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

DT parameterAction

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. Boolean values default to true when present, but you can set them to false using the suffix "=0". Integer values require a value, e.g. sizey=240. For instance, to set the X resolution to 400 pixels and invert both X and Y coordinates, use the following line:

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

After-sales

Monday-Friday (9:30-6:30) Saturday (9:30-5:30)

Mobile: +86  13434470212

Email: services01@spotpear.com