A script for configuring Adafruit's PiTFT displays on a Raspberry Pi.
Products:
- 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
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:
adafruit-pitft-helper -h
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
...where -t
specifies the type of PiTFT just like the same option to
adafruit-pitft-helper
, and -i
specifies the path to an image file.