PiScreen Driver Install Instructions

Bellow you will instructions for installing the appropriate drivers for PiScreen on a Raspberry Pi running Raspbian. These have been tested on all models of the Raspberry Pi. (including the Pi 2)

These instructions are based on a vanilla install of 2015-05-05-raspbian-wheezy.img. They should work for almost all versions of Raspian. If installing drivers onto an existing Raspbian image, Please Bakup All Data or make a copy of your SD Card.

1. Initial Config of a New Raspberry Pi Install

After booting your Raspberry Pi for the first time on 2015-02-16-raspbian-wheezy.img, we will need to perform the normal tasks of setting up our Raspberry Pi. E.g expand filesystem, enable SSH, overclocking, etc...

pi@raspberrypi ~ $ sudo raspi-config
pi@raspberrypi ~ $ sudo rpi-update
pi@raspberrypi ~ $ sudo reboot

2. Update

We now want to update our software and OS;

pi@raspberrypi ~ $ sudo apt-get update
pi@raspberrypi ~ $ sudo apt-get upgrade
pi@raspberrypi ~ $ sudo reboot

3. Enable PiScreen Drivers

Open /boot/config.txt

pi@raspberrypi ~ $ sudo nano /boot/config.txt

For PiScreen 1;
Add this line to the bottom


(You can try and go at a higher speed on the SPI, which will increase FPS. look for the value of 16000000 above and change it to 24000000 or even 32000000.If you are noticing funny colors after the change, then decrease the speed)

For PiScreen 2;
Add this line to the bottom


Now reboot

pi@raspberrypi ~ $ sudo reboot

Once your Raspberry Pi comes back up, PiScreen should change from white to black.

4. Perform a quick test

We will use fbi to display an image.

pi@raspberrypi ~ $ sudo apt-get install fbi
pi@raspberrypi ~ $ wget https://ozzmaker.com/piscreen/image-test.gif
pi@raspberrypi ~ $ sudo fbi -noverbose -T 1 -a -d /dev/fb1 image-test.gif

If the image doesnt look right, try chaning the speed in step 5 from speed=16000000 to speed=8000000.



5. Extra step for Jessie

By default, Jessie will automatically load X out the HDMI port which will then blank out PiScreen which will make it look like it isnt working.

If you want X to automatically load onto PiScreen. Open up the framebuffer conf file;

pi@raspberrypi ~ $ sudo nano /usr/share/X11/xorg.conf.d/99-fbturbo.conf

Change the below line;
Option "fbdev" "/dev/fb0"
Option "fbdev" "/dev/fb1"

Or, if you would like to disable X from starting automatically, just run sudo raspi-config and look for the option to disable it.


If all is working, you may want to look at these pages;





Blip, blop, bloop...