Adafruit Industries 5 Display Kippah Portable Raspberry Pi User manual

5" Display Kippah Portable Raspberry Pi

Created by Ruiz Brothers

Last updated on 2021-03-07 07:41:10 PM EST

2 4

4 4 5 5 6 6 6 7 7

8

9

9 10 12 13 13 15 18

18 18 18 19 19

20

20 20 20 20

21

21 22 23 24

25

25 25 26 27 28 28

30

30 30 31 31 32 32

Guide Contents

Guide Contents Overview

Portable Pi Touch screen UPDATE Kippah Sauce PowerBoost 1000C Built-in Audio (Optional) 3D Printing Prerequisite Guides Parts Tools and Supplies

Circuit Diagram

The Circuit Diagram

Installation Connect Display Update & Upgrade Install and Try raspi-gpio Install Device Tree Blob Update configuration Touch screen support 3D Printing

Customize Design Materials Tolerances Bed Leveling Clean up

Assembly

Wiring Testing Mounting Process

Slide Switch

Prep Wires Tin Wires and Switch Connect Wires to Switch Slide Switch

Audio Cable

Measure and Cut Strip It! Tin Wire Extend Ground Insulate Groud Audio Cable

Amplifier

Prep Wires Tin Wires Connect Wires to Amp Solder Audio Cable to Amp Connect Speaker to Amp Audio Circuit

33

33 33 34 34

35

35 36 37 38

39

39 39 40 40 41 42

43

43 43 44 44 45 45 46 46 47

48

48 48 48 49 49 50 51 51 51 52

Kippah

Prep Wires Tin Kippah and Wires Connect wires to Kippah Wired Kippah

Powerboost 1000C

Install Switch Machine Screws Install Screws Connect Switch to PowerBoost 1000C

Mounting Components

Install Amp Connect PAM8302 to PowerBoost 1000C Install Speaker Plug Audio Cable Install Raspberry Pi Circuit Checkpoint

Kippah Display

Install 40-pin FPC cable Install Kippah Connect Kippah to PowerBoost 1000C Install Display Mount Display Connect Extension to Display Connect 40-pin cable to Extension Plug in Battery Test Circuit

Closing it up

Cable Management Ports Fasten Shut Closed Up Portable Kippah Pi Tripod Adapter Mountable Pi Use and Commence Pi What's that orange keyboard? Made This? Let us know!

Overview

Portable Pi

There are many applications where a portable Raspberry Pi can be really useful. In most general usecases, it's convenient to have a Raspberry Pi, display and battery contained in a nice package. In this project, we'll put together a portable Raspberry Pi with a battery and display. This project is relatively simple to put together and only requires a few wired connections.

Touch screen UPDATE

New version of enclosure now works with 5" 40-pin TFT Display with Touchscreen and Adafruit DPI TFT Kippah for Raspberry Pi with Touch Support

http://www.adafruit.com/product/1596 (https://adafru.it/iDa) http://www.adafruit.com/product/2453 (https://adafru.it/iDb)

Follow the Kippah Touch tutorial (https://adafru.it/kED) for setting up the software. The 3D printed parts are on thingiverse (labled v2).

Kippah Sauce

This project utilizes the Adafruit DPI Display Kippah "hat-like" board to drive a 5" TFT display without the extra cost and baggage of an HDMI decoder. Kippah gives you nice ultra-fast 18-bit color display. This works great with the 5" displays at 800x480. This display is 'native' so it gets all the graphics accelleration capabilities, instant refresh, etc. you would get from an HDMI display.

PowerBoost 1000C

The PowerBoost 1000C provides 5V @ 1A of regulated power to the Raspberry Pi, Kippah and PAM8302 amplifier. On board charging let's you recharge a lipo battery over microUSB. In this project we are able to comfortably fit a 2500mAh lipo battery in the 3D printed enclosure.

Built-in Audio (Optional)

There's enough room in the enclosure to fit a thin plastic speaker and a mono Class D audio amplifier. We can wire up an audio cable (3.5mm jack) to the amp and plug it into the audio jack on the Raspberry Pi. This portion can be optional, but the keep in mind there's no access to the audio jack on this 3D printed enclosure.

 In most cases (with terminal), there is noticeable audio interference. The interference is minimized with the use of startx and emulationstation.

3D Printing

This project enclosure was designed specially to fit the components listed in the sidebar and below. The parts unfortunately will not fit on smaller print beds (like the Printrbot Simple). To print the parts, you'll need access to a printer with a minimum build plate of 100mm x 168mm x 30mm.

No 3D printer? You could send the parts to be printed by a service like 3D Hubs, MakerXYZ or shapeways. You could also try checking out your local hacker/maker space or library.

Prerequisite Guides

Check out the guides below to get a better understanding of the Kippah and the Raspberry Pi 2 or B+ (The enclosure is compatible with both).

Adafruit DPI Display Kippah (https://adafru.it/iD8) Introducing Raspberry Pi 2 (https://adafru.it/iD9) Introducing Raspberry Pi B+ (https://adafru.it/dP7)

Parts

Adafruit DPI Display Kippah Raspberry Pi 2 Raspberry Pi B+ 5" TFT display 40-pin PowerBoost 100C PAM8302 Amplifier Thin plastic speaker 2500mAh lithium polymer battery Slide switch Right-angle 3.5mm stereo plug to pigtail cable

3/8" to 1/4" Adapter Screw (http://adafru.it/2392) Swivel-Head Pan Tilt (http://adafru.it/2464)

Tools and Supplies

3D Printer Filament Wire Strippers/Cutters 30/26AWG silicone-coated stranded wire Soldering Iron Solder Helping-third hands Panavise Jr. 6 #2-56 3/8 flat Phillips machine screws 8 #4-40 3/8 flat Phillips machine screws

Circuit Diagram

The Circuit Diagram

The slide switch connects to the EN and GND pins on the PowerBoost1000C.

Connect 5V and GND on the Kippah to the 5V and GND pins on the PowerBoost 1000C.

The Vin and GND pins audio amplifier will connect to a set of positive+ and negative- pins on PowerBoost1000C.

The speaker connects to the positive+ and negatives- audio out pin on the PAM8302 amplifier.

Stereo audio cable plugs into the audio jack on the Raspberry Pi and connects to A+ and A- on the amp.

The 5" TFT display connects to a 40-pin FPC extention connector. An included 40-pin cable connects from the Kippah to the extension to the 5" display.

JST cable from the lipo battery connects directly to the JST port on the PowerBoost1000C.

Installation

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!

 We've only tested this device tree overlay/firmware with Raspbian. Since its a bit of a hack, it doesn't work with the native pre-boot 'NooBS' screen. However, it does come up immediately with Raspbian (e.g. you get to see the rainbow square screen)

 Note these instructions are tested to work with Raspbian Stretch as of 2019/04/11

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

We want to get the most recent recent kernel and firmware, so run

sudo apt-get install rpi-update

and then

sudo rpi-update

Then reboot with sudo reboot

Install and Try raspi-gpio

To help us debug/make sure we have the right device tree blob, we'll use a tool called raspi-gpio

Install it with

sudo apt-get install raspi-gpio

Then you can run it with

sudo raspi-gpio get

When you run it this time, you'll see the first 'bank' of GPIO pins set to, essentially

GPIO nn: level=1 fsel=0 alt= func=INPUT

Install Device Tree Blob

Now download and install the DPI device tree blob (tip o' the hat to

aBUGsworstnightmare (https://adafru.it/mFi)) from github by running:

cd ~ wget https://raw.githubusercontent.com/adafruit/Adafruit-DPI-Kippah/master/dt-blob.bin sudo cp dt-blob.bin /boot/

in your Pi's command line, to change directories to the home directory, download the blob, then copy it in

/boot

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/config.txt

and add the following lines at the bottom

# Disable spi and i2c, we need these pins. dtparam=spi=off dtparam=i2c_arm=off

# Set screen size and any overscan required overscan_left=0 overscan_right=0 overscan_top=0 overscan_bottom=0 framebuffer_width=800 framebuffer_height=480

# enable the DPI display enable_dpi_lcd=1 display_default_lcd=1

# Enable DPI overlay dtoverlay=dpi24

# set up the size to 800x480 dpi_group=2 dpi_mode=87

# set up the hsync/vsync/clock polarity and format dpi_output_format=454661

# set up the size to 800x480 hdmi_timings=800 0 40 48 88 480 0 13 3 32 0 0 0 60 0 32000000 6

For 4.3" TFT use the following:

# Disable spi and i2c, we need these pins. dtparam=spi=off dtparam=i2c_arm=off

# Set screen size and any overscan required overscan_left=0 overscan_right=0 overscan_top=0 overscan_bottom=0 framebuffer_width=480 framebuffer_height=272

# enable the DPI display enable_dpi_lcd=1 display_default_lcd=1

# set up the size to 480x272 dpi_group=2 dpi_mode=87

# set up the hsync/vsync/clock polarity and format dpi_output_format=520197

# set up the size to 480x272 hdmi_timings=480 0 40 48 88 272 0 13 3 32 0 0 0 60 0 32000000 3

This sets up the screen, if you ever want to temporarily 'undo the DPI Hat install' just delete these lines

enable_dpi_lcd=1 display_default_lcd=1

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 drivers are required! However, you'll likely want to calibrate the screen. We have a calibration helper python script. Start by installing python-pip and pyusb version 1.0.0b1

sudo apt-get install python-pip sudo pip install pyusb==1.0.0b1

Then grab the code and example gradient

cd ~ wget http://adafru.it/ar1100py mv ar1100py 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 python ar1100.py

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

Adafruit Industries 5 Display Kippah Portable Raspberry Pi User manual

Specifications and Main Features

Frequently Asked Questions

User Manual