We use some essential cookies to make our website work.

We use optional cookies, as detailed in our cookie policy, to remember your settings and understand how you use our website.

树莓派 官方文档

Touch Display 2 触摸屏

About

touch display 2 hero
The Raspberry Pi Touch Display 2

The Touch Display 2 connects to a Raspberry Pi using a DSI connector and GPIO connector. Raspberry Pi OS provides touchscreen drivers with support for five-finger multitouch and an on-screen keyboard, providing full functionality without the need to connect a keyboard or mouse.

Specifications

  • 1280×720px resolution, 24-bit RGB display

  • 155×88mm active area

  • 7" diagonal

  • powered directly by the host Raspberry Pi, requiring no separate power supply

  • supports up to five points of simultaneous multi-touch

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.

The Touch Display 2 box contains the following parts (in left to right, top to bottom order in the image below):

  • Touch Display 2

  • eight M2.5 screws

  • 15-way to 15-way FFC

  • 22-way to 15-way FFC for Raspberry Pi 5

  • GPIO connector cable

Parts included in the Touch Display 2 box
Parts included in the Touch Display 2 box

Install

A Raspberry Pi 5 connected and mounted to the Touch Display 2
A Raspberry Pi 5 connected and mounted to the Touch Display 2

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

Once you have determined the correct FFC for your Raspberry Pi model, complete the following steps to connect your Touch Display 2 to your Raspberry Pi:

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

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

    2. 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:720x1280@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 parameter Action

sizex

Sets X resolution (default 720)

sizey

Sets Y resolution (default 1280)

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