The Raspberry Pi Touch Display is an LCD display which connects to the Raspberry Pi through the DSI connector. In some situations, it allows for the use of both the HDMI and LCD displays at the same time (this requires software support).
The DSI display is designed to work with Raspberry Pi models that have mounting holes in a HAT footprint. Model A/B boards are supported, but require additional mounting hardware to fit the HAT-dimensioned stand-offs on the display PCB.
The DSI connector on the Model A/B boards does not have the I2C connections required to talk to the touchscreen controller and DSI controller. You can work around this by using the additional set of jumper cables provided with the display kit to wire up the I2C bus on the GPIO pins to the display controller board.
Using the jumper cables, connect SCL/SDA on the GPIO header to the horizontal pins marked SCL/SDA on the display board. We also recommend that you power the Model A/B via the GPIO pins using the jumper cables.
For the GPIO header pinout, see this diagram.
DSI display autodetection is disabled by default on these boards. To enable detection, add the following line to /boot/config.txt:
ignore_lcd=0
Power the setup via the PWR IN micro-USB connector on the display board. Do not power the setup via the Pi's micro-USB port: the input polyfuse's maximum current rating will be exceeded as the display consumes approximately 400mA.
NB: With the display connected to the GPIO I2C pins, the GPU will assume control of the respective I2C bus. The host operating system should not access this I2C bus, as simultaneous use of the bus by both the GPU and Linux will result in sporadic crashes.
LCD displays have an optimum viewing angle, and depending on how the screen is mounted it may be necessary to change the orientation of the display to give the best results. By default, the Raspberry Pi Touch Display and Raspberry Pi are set up to work best when viewed from slightly above, for example on a desktop. If viewing from below, you can physically rotate the display, and then tell the system software to compensate by running the screen upside down.
To flip the display, add, anywhere in the file \boot\config.txt, the following line:
lcd_rotate=2
This will vertically flip the LCD and the touch screen, compensating for the physical orientation of the display.
You can also rotate the display by adding the following to the config.txt file.
display_lcd_rotate=x, wherexcan be one of the folllowing:
| display_hdmi_rotate | result |
|---|---|
| 0 | no rotation |
| 1 | rotate 90 degrees clockwise |
| 2 | rotate 180 degrees clockwise |
| 3 | rotate 270 degrees clockwise |
| 0x10000 | horizontal flip |
| 0x20000 | vertical flip |
Note that the 90 and 270 degree rotation options require additional memory on the GPU, so these will not work with the 16MB GPU split.
Additionally, you have the option to change the rotation of the touchscreen independently of the display itself by adding a dtoverlay instruction in config.txt, for example:
dtoverlay=rpi-ft5406,touchscreen-swapped-x-y=1,touchscreen-inverted-x=1
The options for the touchscreen are:
| DT parameter | Action |
|---|---|
| touchscreen-size-x | Sets X resolution (default 800) |
| touchscreen-size-y | Sets Y resolution (default 600) |
| touchscreen-inverted-x | Invert X coordinates |
| touchscreen-inverted-y | Invert Y coordinates |
| touchscreen-swapped-x-y | Swap X and Y cordinates |
Read our troubleshooting steps, tips, and tricks here: Raspberry Pi Touch Display troubleshooting.
- 800×480 RGB LCD display
- 24-bit colour
- Industrial quality: 140-degree viewing angle horizontal, 130-degree viewing angle vertical
- 10-point multi-touch touchscreen
- PWM backlight control and power control over I2C interface
- Metal-framed back with mounting points for Raspberry Pi display conversion board and Raspberry Pi
- Backlight lifetime: 20000 hours
- Operating temperature: -20 to +70 degrees centigrade
- Storage temperature: -30 to +80 degrees centigrade
- Contrast ratio: 500
- Average brightness: 250 cd/m2
- Viewing angle (degrees):
- Top - 50
- Bottom - 70
- Left - 70
- Right - 70
- Outer dimensions: 192.96 × 110.76mm
- Viewable area: 154.08 × 85.92mm
- Download mechanical drawing (PDF, 592kb)
- Additional drawing including radius and thickness of glass
