This guide assumes you have a A+, B+, Pi 2 or Pi 3. See below for tips on using an older Pi.
You should have a good power supply, the official Raspberry Pi 2A or 2.5A supplies are a sound choice.
You should have a recent Raspbian or NOOBS SD card, or update your existing card to make sure everything goes smoothly.
You'll need the latest software and the Raspbian OS in order to drive the screen. Make sure you have a network connection and type this into Terminal:
curl https://get.pimoroni.com/uptodate | bash
On your A+, B+, Pi 2, or Pi 3 you will need to connect the main display ribbon cable between the display driver board and your Pi. This cable looks just like a Pi camera cable, and fits into the connector on the edge of the board nearest the SD card slot.
At the driver board end, the gold contacts on the ribbon cable should face upwards away from the LCD panel. The ribbon should then loop around and plug into the Pi, which is mounted on the back of the assembly.
You have three choices when it comes to powering the screen;
Using the red and black jump wires supplied in the screen kit, you can connect the 5V and GND pins from the driver board to the GPIO of your Pi.
This is a quick and easy way to get started, however you wont be able to connect HATs to your Pi!
We sell a microB USB splitter cable which will let you connect one power supply to both the display board and your Pi.
If you're using a plethora of power hungry USB devices and a power hungry HAT you might want to use two power supplies. This is possible to do, but it can be tricky to turn them on at exactly the same time so the Pi and LCD can talk to each other and initialise properly.
If you're using our stand, you'll have to rotate the screen. We've orientated it so that the Pi power, AV and HDMI ports are facing upwards, to keep the sleek low profile look, and the GPIO is at the bottom so you can wrap a ribbon cable underneath for easy access to GPIO via Black HAT Hack3r.
You can rotate the LCD by editing /boot/config.txt and adding the line: lcd_rotate=2 to the top.
You can do this by booting up your Pi, going into the Raspberry menu, picking "Accessories" and then "Terminal".
If you get a black screen, it likely means your DSI cable ( the one between the Pi and the driver board ) isn't seated correctly. Turn off your Pi and display and double-check the cable is pushed firmly into each connector, and that the gold contacts face upwards on the driver board side.
If your screens looks weird and fades out the picture like an old CRT TV when you turn off your Pi- don't worry, this is perfectly normal!
These features are supported in the hardware, we're told, and software support is coming soon. This article will be updated to reflect whatever brightness/power control goodness is introduced.
There are a couple of options for this. So far I've seen:
Suggested on the Pi forums by Hove is Florence: http://xmodulo.com/onscreen-virtual-keyboard-linux.html. Install with:
sudo apt-get install florence
Suggested by Alex ( the almighty @raspitv ), and scattered on various blogs, is Matchbox, which you can install like so:
sudo apt-get install matchbox-keyboard
And then find in Accessories > Keyboard.
Find some screenshots ( of it on a smaller LCD ) here: http://ozzmaker.com/2014/06/30/virtual-keyboard-for-the-raspberry-pi/
As Clive demonstrates below, you can make a much more compact setup by flipping your Pi and mounting it with the ports facing towards the back of the LCD. However, the current GPIO ribbon cables we use wont fit between the two metal risers, so you wont be able to easily break your GPIO out in this configuration.
If you're going for a permanent setup, then you can just solder the power cables to the underside of the GPIO.
Image pinched from Clive Beale: https://www.raspberrypi.org/blog/dont-try-this-at-home-how-not-to-hack-the-raspberry-pi-display/
( And have the touchscreen actually work! )
Gasp! Okay, I can see why you'd want to do this! I couldn't put it better than the great step-by-step forum post here: https://www.raspberrypi.org/forums/viewtopic.php?f=108&t=120793
You can find a technical drawing with dimensions of the display and mount hole locations here: https://github.com/raspberrypi/documentation/tree/master/hardware/display
Use this guide: https://github.com/mrichardson23/rpi-kivy-screen
Need something for this project? You can use the links below to add products to your Pimoroni Shop basket for easy checkout.
Dual microB USB Power Cable
Official Raspberry Pi Universal Power Supply (Pi 3 & Zero Only)
Mini Black HAT Hack3r
Fully Assembled £11.40
Mini Black HAT Hack3r
Solder Yourself Kit £9.00
Mini Black HAT Hack3r
PCB only £4.50
Black HAT Hack3r
Raspberry Pi 7" Touchscreen Display