Getting started with Raspberry Pi Touch Display 2
Raspberry Pi Touch Display 2 is a portrait orientation touchscreen LCD display designed for interactive projects like tablets, entertainment systems, and information dashboards. Here, our documentation lead Nate Contino shows you how to connect a Touch Display 2 to your Raspberry Pi, use an on-screen keyboard, and change your screen orientation.
Touch Display 2 connects to a Raspberry Pi using a DSI connector and a GPIO connector. Raspberry Pi OS provides touchscreen drivers with support for five-finger multi-touch 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×88 mm active area
- 7-inch diagonal display
- Powered directly by the host Raspberry Pi, requiring no separate power supply
- Supports up to five points of simultaneous multi-touch
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 Figure 1 image):
- Touch Display 2
- 8 × M2.5 screws
- 15-way to 15-way FFC
- 22-way to 15-way FFC for Raspberry Pi 5
- GPIO connector cable
Install
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.
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 your Raspberry Pi (see Figure 2 below).
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 your Raspberry Pi’s GPIO. Connect the red cable (5 V 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 (see Figure 3 below).
10. Optionally, use the included M2.5 screws to mount your Raspberry Pi to the back of the Touch Display 2:
11. 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.
12. Insert the screws into the four corner stand‑offs and tighten until your Raspberry Pi is secure.
13. 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-hand 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.
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 the 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 clockwise. 180 rotates the display 180 degrees, or upside-down.
Note: It’s not possible to rotate the DSI display separately from the HDMI one with cmdline.txt. When you use DSI and HDMI simultaneously, they share the same rotation value.
This tutorial is an excerpt from the Raspberry Pi Documentation. Our extensive documentation covers all of our hardware, software, accessories, and microcontrollers as well as Raspberry Pi OS. If you still have questions, try posting on our forums, which are full of Raspberry Pi enthusiasts and some of the finest nerds on the planet.
The post Getting started with Raspberry Pi Touch Display 2 appeared first on Raspberry Pi.
from News - Raspberry Pi https://ift.tt/PW9G8tk
Comments
Post a Comment