On this page

Add a 4 inch Waveshare display spi touch

mini11 21 June 2022 pCP 7.0.0 Projects  •  •

Waveshare 4 inch resistive display, spi Touch, 480×800, HDMI, with piCorePlayer.

4 inch display

4 inch display

Step 1 - Connect the display to your Raspberry PI
  • Plug the display directly on the GPIO pins of your RPi and connect the HDMI plug with an HDMI-adaptor.

4 inch display

If you need additional pins for other purpose, wire the pins 1, 2, 6, 19, 21, 22, 23, 26) and connect the HDMI-Plug with a HDMI Cable.

Step 2 - Prepare SD card
  • Put a fresh pCP image on to the SD card—see Burn piCorePlayer onto a SD card.
  • While the SD card is still in the laptop/pc:
    • Enter wifi credentials in wpa_supplicant.conf.sample at the end of the file and “save as” wpa_supplicant.conf.
# This is the details about your Wireless network. Configure as needed.
# Most will just need to change the ssid and psk.

        ssid="your ssid"
        psk="your password"
- Add the following lines to config.txt, in the Custom Configuration area at the end of the file (between the Begin-Custom and End-Custom lines).
#---Begin-Custom-(Do not alter Begin or End Tags)-----
hdmi_cvt 480 800 60 6 0 0 0
  • Comment out the gpu_mem=16 and lcd_rotate=2 default settings by putting an # at the beginning of the line.
  • Save your changes.

You find these two files in your Windows Explorer in root-section of the pcp_boot drive.

Step 3 - Boot Raspberry Pi
  • Put the SD card in your RPi and boot.
  • Find the IP address of the RPi, and enter this in a browser—see Determine your piCorePlayer IP address.
  • Once the RPi has booted up, this should bring up the pCP web interface.
    • On [Main Page] scroll down to “Additional functions” and click on “Extensions”. Wait for green ticks, then click on the [Available] tab.


  • In the ‘Available extensions in the piCorePlayer repository’ section.


  • Load nano.tcz extension.
  • Install Jivelite from the [Tweaks page] (this step includes an automatic backup, so accept the reboot prompt.)
  • After the reboot do not configure jivelite – we’ll do this later!
Step 4 - Make a custom jivelite.sh startup script
  • Login to your RPi via ssh (software=putty – user: tc, password: piCore) and look, if your changes of step 2 work:
  • Insert the following command:

$ cat /proc/bus/input/devices

  • You see your connected input-devices (ie. touchscreen, mouse or IR-receiver)


  • Take note of “Waveshare” and “event1” (If you do not use additional input devices (ie. IR-receiver), the input device may be event0).
Step 5 - Creating the jivelite.sh
  • Still connected by ssh, insert the following command:

$ sudo nano /mnt/mmcblk0p2/tce/jivelite.sh

  • Put into the empty file (copy and paste) the following script:

# Disable mouse pointer
# Set touch calibration file
# Jivelite interface framerate
# Set Touch input device 
export TSLIB_TSDEVICE=/dev/input/event1 # This might be event0 in some cases
# Define custom Skin size
# scale to 800x480. This could be any size to scale interface.
export JL_SCREEN_WIDTH=800
# Set custom screen resolution
/usr/sbin/fbset -xres 800 -yres 480
# Run Jivelite
while true; do
    /opt/jivelite/bin/jivelite >> /var/log/jivelite.log 2>&1
    sleep 3
  • Usually we do not need a script for that resolution in Jivelite. It is standard and many skins work with that resolution. For this purpose, we need the script to define the touchscreen as input-device and to hide the cursor.
  • Save your changes and exit nano (Ctrl+X and confirm by pressing y).

  • Make the new custom jivelite.sh script executable with:

$ sudo chmod +x /mnt/mmcblk0p2/tce/jivelite.sh

  • Go to Web-Gui of piCorePlayer, section [Tweaks] and set “Jivelite Autostart” to “no”.
  • Reboot your RPi.
Step 5 - Calibrate Touchscreen

$ sudo TSLIB_FBDEVICE=/dev/fb0 TSLIB_TSDEVICE=/dev/input/event1 /usr/local/bin/ts_calibrate

  • Click the 5 calibration points properly.
  • Make your calibration persistent:

$ pcp bu

  • Go to the WebGui of piCorePlayer, section [Tweaks] and set “Jivelite Autostart” to “yes”.
  • Reboot your RPi.
    • After the reboot, the touch of the display should work fine.
Step 6 - Configure Jivelite
  • Connect a mouse or an IR-remote to the device to configure jivelite.
  • Choose your language and in the next menu select GridSkin 800x480 or jogglerskin. Both work fine with that resolution.
  • Configure the additional settings (time, background and so on).
  • Save your changes in Jivelite Settings (Settings > piCorePlayer > Save Settings to SD-Card).

More information #

The Software and Information is provided "as is" without warranty of any kind, either express or implied, including without limitation any implied warranties of condition, uninterrupted use, merchantability, fitness for a particular purpose, or non-infringement.
Raspberry Pi is a trademark of the Raspberry Pi Foundation.