Easy Install

The PiTFT requires kernel support and a couple other things to make it a nice stand-alone display. We have a detailed step-by-step setup for hackers who want to tweak, customize or understand the PiTFT setup. If you just want to get going, check out the following for easy-install instructions!

Ready to go image

If you want to start with a fresh image, we have two for Raspbian.  There's the larger 'classic Jessie' image that will boot into X by default, and requires a 8G image, it has a lot more software installed. There's also the smaller 'Jessie Lite' that will boot into the command line, and can be burned onto a 2G card! Click below to download and install into a new SD card. Unzip and follow the classic SD card burning tutorials

This image is customized for the CAPACITIVE touch 2.8" TFT, also known as PID #1983! Not for PID #1601

DIY Installer script

If you don't want to download an image, you can run our installation package helper from inside your existing Raspbian install. It will download the kernel add-ons, and configure your Pi for PiTFT joy

The helper is available for perusal here if you are interested in how it works

Step 1. Expand Filesystem

Start by expanding the filesystem This is required!!!

sudo raspi-config
(expand filesystem)
sudo reboot

Step 2. Install new Kernel

Then, once the filesys is expanded, download and install t he new kernel by running the following commands:

curl -SLs https://apt.adafruit.com/add-pin | sudo bash
sudo apt-get install -y raspberrypi-bootloader adafruit-pitft-helper raspberrypi-kernel

The first command adds apt.adafruit.com to your repository list, so you can grab code directly from Adafruit's servers, and tells apt that it should give a very high priority to packages installed there.

The next line does the actual download and installation, it'll take a while because there's a lot of software to replace for PiTFT support.

It's normal for the Pi to pause and/or take a while at this step for many minutes, theres a lot of kernel software to replace

Step 3. Enable & Configure the PiTFT

OK now the kernel and helper are installed, all you have to do is run the helper which will configure the kernel device tree overlays and add the few configurations to make the console show up, etc.

sudo adafruit-pitft-helper -t 28c

This will install the "2.8 Capacitive" type of PiTFT into the current install.

At the end you will be prompted on whether you want the text console to appear on the PiTFT. Answer Y or N depending on your personal desires!

You will also be prompted on whether you want one of the tactile buttons to act as an 'on off' switch. Answer Y or N depending on your personal desires!

Thats it!

Run sudo reboot to try out your fancy new PiTFT :)

Last updated on 2016-10-23 at 10.44.12 AM Published on 2014-07-21 at 05.51.08 PM