We'll keep this repo public but archived for the curious.
A (deprecated) script for configuring Adafruit's PiTFT displays on a Raspberry Pi.
Attention RETROPIE Users:
Do not use the adafruit-pitft-helper script with RetroPie. Instead, follow the directions on this page: https://learn.adafruit.com/running-opengl-based-games-and-emulators-on-adafruit-pitft-displays/pitft-setup
- PiTFT - Assembled 320x240 2.8" TFT+Touchscreen for Raspberry Pi
- PiTFT - Assembled 480x320 3.5" TFT+Touchscreen for Raspberry Pi
- Adafruit PiTFT 2.2" HAT Mini Kit - 320x240 2.2" TFT - No Touch
Detailed installation guides:
- Guide: Adafruit PiTFT - 2.8" Touchscreen Display for Raspberry Pi
- Guide: Adafruit PiTFT 3.5" Touch Screen for Raspberry Pi
- Guide: Adafruit 2.2" PiTFT HAT - 320x240 Display
- Running OpenGL-based Games & Emulators on Adafruit PiTFT Displays
Getting Started: Kernel & Helper Script Installation
First, add Adafruit's Occidentalis package repository to your system. Occidentalis is a growing collection of useful packages and configuration defaults for installation on Raspbian systems.
If you want to bootstrap the full version of Occidentalis on a fresh, unused Pi from another computer, we offer an easy graphical tool called the Pi Finder. Once bootstrapped, you can open a terminal on your Pi and run:
sudo apt-get install raspberrypi-bootloader sudo apt-get install adafruit-pitft-helper
...which first installs a custom kernel with PiTFT support, and then the helper script itself. If you just want to install the kernel and helper without pulling down any other extra packages, you can run the following from the command line of a working Pi:
curl -SLs https://apt.adafruit.com/add | sudo bash sudo apt-get install raspberrypi-bootloader sudo apt-get install adafruit-pitft-helper
This can take a surprisingly long time to finish, especially if you're using a slower SD card, so be patient.
Please be careful! Installing a new kernel always has the potential to leave your Raspberry Pi unbootable. You should make a backup copy of your SD card before trying this, or (even better!) start with a fresh card.
adafruit-pitft-helper must be run with root privileges, and takes a parameter
specifying the type of PiTFT to configure. Invoke it like so:
sudo adafruit-pitft-helper -t 28r
For a full list of available options, check the help:
Installing PiTFT support in a Raspbian image file (experimental!)
This repository includes a small wrapper script for installing the custom kernel and PiTFT configuration in a Rasbpian image file. In order to use it, you can download and unzip a recent Raspbian image on a Raspberry Pi, then do something like the following in a terminal:
curl -SLs https://apt.adafruit.com/add | sudo bash sudo apt-get install adafruit-pitft-helper sudo adafruit-pitft-chroot-install -t 28r -i ~/2015-02-16-raspbian-wheezy.img
-t specifies the type of PiTFT just like the same option to
-i specifies the path to an image file.
You can also use
adafruit-pi-chroot to run a
inside of a Raspbian ISO image. Like the install wrapper, this relies on
These are the scripts we use to produce the Easy Install images offered in Adafruit product documentation. They may be a bit rough around the edges.
For the version supporting Raspbian Wheezy, check out the
on this repository.