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.
You can also use adafruit-pi-chroot
to run a chroot
ed shell
inside of a Raspbian ISO image. Like the install wrapper, this relies on
kpartx
.
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 wheezy
branch
on this repository.