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!