Raspberry Pi 5-inch Display Tutorial

Product Features

• Hardware resolution of 800 x 480
• Capacitive touch control
• Compatible and can be directly plugged into any version of Raspberry Pi (Raspberry Pi Generation 1B and Raspberry Pi Zero require a separate HDMI cable)
• Driver provided (supports Raspbian\Ubuntu\Kali and Retropie systems)
• When used for display only, it does not take up any I/O resources (when using touch function, it takes up I/O)
• Supports backlight control, more power saving
• Sunken gold craftsmanship, fine craftsmanship

New features of the latest version V2:

• Improved backlight driver program, lower power consumption (V1 version power consumption is on the high side)
• Improve the screw locking method, more scientific and reliable (V1 version of the screws installed between the sandwich, fall off and re-installation, a lot of work)
• Improve PCB silkscreen, labeling LCD occupied pins (V1 version is not intuitive enough)
• CE, ROHS certification (V1 version no CE, ROHS certification)

Note: Many cottage manufacturers copy the old V1 version.

Quick Start

Hardware Connections

• Raspberry Pi pins out 40 GPIO pins, while the screen pins out 26 pins, when connecting, pay attention to the corresponding screen pins and Raspberry Pi pins.

• Raspberry Pi Model B and Raspberry Pi Zero need a separate HDMI cable for connection.

3.Turn the Backlight on the back of the LCD to ON.
You can enable the touch function in two ways: Method 1, install the driver for Raspbian/Ubuntu Mate/Kali or Retropie system. Method two, use the image with pre-installed driver.

Note: This product can only be used for Raspberry Pi, not for PC. For example, if you connect the LCD to a computer via HDMI cable, then the LCD will not display anything.

Method 1, Install the driver

Please download the latest version of the image from RockBee official website (https://rockbee.cc/pages/raspberry-pi-os).

1) Download the image file to your computer and unzip it to get the .img file.

2) Connect the TF card to your computer, open Win32DiskImager.exe software, select the .img file prepared in step 1, and click write to burn the image.

3) After the burning is completed, use the writing pad to open the config.txt file in the root directory of the TF card, add the following code at the end of config.txt to save and safely eject the TF card.

max_usb_current=1
hdmi_group=2
hdmi_mode=87
hdmi_cvt 800 480 60 6 0 0 0
hdmi_drive=1

Note: For Raspberry Pi 4, you also need to comment out dtoverlay=vc4-fkms-V3D.

（4） Connect the TF card to the Raspberry Pi and start the Raspberry Pi, log into the Raspberry Pi's terminal (you can connect the Raspberry Pi to an HDMI monitor or log in remotely with ssh).

（5）Download the relevant driver code through the network, and then execute the corresponding installation commands, and make sure that you can connect to the Internet normally during the whole process.

Reboot and touch can be used (in order to facilitate the use of the screen can be adjusted to display the direction, see # set the display direction).

Method 2, use the pre-installed driver image

Here we provide a pre-installed driver image, unzip it and write the image to the TF card (open Win32DiskImager.exe software, select the .img file, click “write” to burn the image). Then insert the card into the Raspberry Pi and it's ready to use.

Setting Display Orientation

After installing the touch driver, you can modify the screen rotation direction by running the following command.

Installation of calibration software for calibration

• This LCD can be calibrated using the xinput-calibrator program.
• Run the following command to install it:

1. sudo apt-get install xinput-calibrator

• Click the Menu key on the taskbar and select Preferences -> Calibrate Touchscreen.
• Follow the display prompts to perform touch calibration.
• To save these touch values, you need to create a new 99-calibration.conf file in the following path (no need to create a new one if it already exists)

1. /etc/X11/xorg.conf.d/99-calibration.conf

• Save the touch parameters (the data below may be different for different LCDs) to 99-calibration.conf, and you're done!
• 

Installing the Virtual Keyboard

1. Execute the following commands to install the appropriate software

1. sudo apt-get update
2. sudo apt-get install matchbox-keyboard
3. sudo nano /usr/bin/toggle-matchbox-keyboard.sh

2. Copy the following to toggle-matchbox-keyboard.sh, save and exit

1. #!/bin/bash
2. #This script toggle the virtual keyboard
3. PID=`pidof matchbox-keyboard`
4. if [ ! -e $PID ]; then
5. killall matchbox-keyboard
6. else
7. matchbox-keyboard &
8. fi

3. Execute the following command

1. sudo chmod +x /usr/bin/toggle-matchbox-keyboard.sh
2. sudo mkdir /usr/local/share/applications
3. sudo nano /usr/local/share/applications/toggle-matchbox-keyboard.desktop

4. Copy the following to toggle-matchbox-keyboard.desktop, save and exit

1. [Desktop Entry]
2. Name=Toggle Matchbox Keyboard
3. Comment=Toggle Matchbox Keyboard`
4. Exec=toggle-matchbox-keyboard.sh
5. Type=Application
6. Icon=matchbox-keyboard.png
7. Categories=Panel;Utility;MB
8. X-MB-INPUT-MECHANSIM=True

5. Execute the following command, note that this step must be done with “pi” user privileges, if you use administrator privileges, the file will not be found

sudo nano /etc/xdg/lxpanel/LXDE-pi/panels/panel

6. Find a command similar to the following (icons may vary somewhat between versions)

1. Plugin {
2. type = launchbar
3. Config {
4. Button {
5. id=lxde-screenlock.desktop
6. }
7. Button {
8. id=lxde-logout.desktop
9. }
10. }

7. Add the following code to add a new Button item as follows

1. Button {
2. id=/usr/local/share/applications/toggle-matchbox-keyboard.desktop
3. }

8. Reboot the system with the following command, and you will see an additional virtual keyboard icon in the upper left corner

1. sudo reboot

Interface Definitions

The following pins labeled “NC” indicate that the LCD does not occupy the pin and can be used by the user for other applications.