If you just plug in the DPI Kippah, it won't work on a fresh installation of Raspbian! You must set up the special device tree overlay configuration!

However, its not too bad, check it out below!

Note these instructions are tested to work with Raspbian Bookworm as of 2024/04/2

Connect Display

The DPI Kippah has a 40-pin TFT connector. This is a semi-standard connector. A majority of 3.5", 4.3", 5.0" and 7.0" dot-clock DPI displays have this 'standard 40-pin' connector.

Check the Downloads page for an example datasheet so you can check if your display is compatible. All Adafruit 40-pin TFT TTL displays work, we do not guarantee any other displays work.

In fact, if you connect a display that does not match the right pinout, you could easily fry the display if the 20V backlight pin ends up connected to a logic pin!

To connect, gently pull on the two black 'ears' on the FPC connector, and plug in the display so the gold/silver metalic pins are facing 'up' away from the PCB.

Update & Upgrade

Start by updating and upgrading your Raspberry Pi to the latest software.

sudo apt-get update
sudo apt-get upgrade

Update configuration

Finally, we'll tell the Pi to use the attached DPI display. The following will work for our 5" and 7" 800x480 displays. Both touch and non-touch displays use the same setup here

Start by editing with

sudo nano /boot/firmware/config.txt

and add the following lines at the bottom

dtoverlay=vc4-kms-dpi-panel,kippah-7inch

For 4.3" TFT use the following:

dtoverlay=vc4-kms-dpi-generic,hactive=480,vactive=272,width-mm=95,height-mm=54

To finish installation, just run sudo reboot

Touch screen support

If you have a DPI HAT with touchscreen circuitry installed and a touch-screen display, you can easily use it for touch screen support

A microUSB cable is required (not included) connect it from the MicroUSB connector on the HAT into one of the Pi's USB port.

No additional drivers are required! The touchscreen should just work. However, you'll likely want to calibrate the screen. We have a calibration helper python script. Start by installing python-pip and pyusb.

sudo apt-get install python3-pip python3-venv
python3 -m venv env --system-site-packages
source env/bin/activate
pip3 install pyusb

Then grab the code and example gradient

cd ~
wget https://github.com/adafruit/Raspberry-Pi-Installer-Scripts/raw/main/ar1100.py
wget http://adafruit-download.s3.amazonaws.com/gradient800x480.jpg

If you are running it on a 5" display, continue as is.

If you are running it on a 7" display, edit with nano ar1100.py and change this line:

writeeeprom = CALIBRATED_5IN_800x480;

to

writeeeprom = CALIBRATED_7IN_800x480;

Then run the calibrator with:

cd ~
chmod +x ar1100.py
sudo -E PATH=$PATH python ar1100.py

Its normal for the first time you run it, it will complain "Couldn't find generic either" just run it again!

Just hit the up arrow on your keyboard and return, to rerun sudo python ar1100.py

This time it will continue, program the AR1100 with the calibration data, and give you a rainbow display. 

When done, hit Escape on your keyboard

This guide was first published on Apr 10, 2015. It was last updated on Apr 03, 2024.

This page (Installation) was last updated on Apr 03, 2024.

Text editor powered by tinymce.