This is an advanced guide to customising some of the optional features on the PiScreen display board for Raspberry Pi. For setup instructions, see the PiScreen QuickStart Guide instead.

Solder Jumpers

The PiScreen has nine solder jumpers on the back that allow you to change the behaviour of the board:

Some jumpers are closed by default and can be cut with a scalpel to open them. Some jumpers are open by default and can be closed by using a soldering iron to bridge the gap.

Cutting some of the closed solder jumpers will require new wires to be soldered on the board, in order for the PiScreen to continue functioning.

 

For a succinct summary of the connections, see the PiScreen Schematic PDF

 

 Jumper From To Closed? Purpose
SJ1 Pi GPIO 23

Onboard OLED Connector pin 4,

MicroSD Card Detect

Open

(No Connection)

Close this jumper to be able to read Card Detect status from the MicroSD card on the onboard connector (currently not supported.)
SJ2 Pi GPIO 23

Remote OLED connector pin 4,

MicroSD Card Detect

Open

(No Connection)

Close this jumper to be able to read Card Detect status from the MicroSD card on the remote connector (currently not supported.)
SJ3 Pi GPIO 24 Onboard OLED Connector pin 10, Reset (RST) Closed Cut this jumper and solder a new wire to move the onboard OLED Reset (RST) signal to a different GPIO.
SJ4 Pi GPIO 24 Remote OLED Connector pin 10, Reset (RST) Closed Cut this jumper and solder a new wire to move the remote OLED Reset (RST) signal to a different GPIO.
SJ5 Pi GPIO 25 Onboard & Remote OLED connectors pin 9, DNC Closed Cut this jumper and solder a new wire to move the OLED DNC signal (both connectors) to a different GPIO.
SJ6

Pi GPIO 8

(SPI CE0)

Onboard OLED connector pin 8, OLED CS Closed Cut this jumper and solder a new wire to move the onboard OLED CS signal to a different GPIO (probably CE1.)
SJ7

Pi GPIO 8

(SPI CE0)

Remote OLED connector pin 8, OLED CS Closed Cut this jumper and solder a new wire to move the remote OLED CS signal to a different GPIO (probably CE1.)
SJ8

Pi GPIO 9

(SPI CE1)

Onboard OLED connector pin 4, MicroSD CS

Open

(No Connection)

Solder this jumper to connect SPI CE1 to the onboard OLED connector's MicroSD card CS line. Access to the OLED's MicroSD card from the Pi is not supported, but if you want to attempt it then here is a starting point.
SJ9 Pi GPIO 9 (SPI CE1) Remote OLED connector pin 4, MicroSD CS

Open

(No Connection)

Solder this jumper to connect SPI CE1 to the remote OLED connector's MicroSD card CS line. Access to the OLED's MicroSD card from the Pi is not supported, but if you want to attempt it then here is a starting point.

 

 

 

Running Two Screens

If you connect one OLED128 to the onboard connector and one to the remote connector, the display output will be identical on both screens (the Pi only sees one single screen.)

 

Intrepid/advanced users may have noticed that by cutting SJ7 and soldering the remote OLED connector CS pin (pin 8) to GPIO 9 (SPI CE1), it would be possible to have one Chip Select for each PiScreen (local on CE0, remote on CE1) and drive them separately as two individual screens. This may be possible, but it's unsupported and may require changes to the fbtft module. If you attempt this, please let us know how you go on the forum!