Getting Started

Last revision 2025/12/25

This article provides a comprehensive guide to installing a display driver on Raspberry Pi, covering driver installation, hardware connections, display orientation, and backlight settings for optimal use.

Getting Started

Before connecting the display, the Raspberry Pi needs to install the driver for this screen.

The current display driver supports the following Raspberry Pi kernel versions (only 64-bit systems are supported): 6.1.x.x and 6.6.x.x.

To check the Raspberry Pi system kernel version, enter the command uname -r in the command line terminal.

Driver Installation Steps:

  1. Download the deb package and install it on the Raspberry Pi system.

    Click to download: dfrobot-8-8-inch-dsi-20240322.zip

  2. Open the command line terminal and install the dependencies by executing the following command:

    sudo apt install -y make raspberrypi-kernel-headers
    
  3. Install the deb package, ensuring that superuser privileges are used for installation.

    sudo dpkg -i dfrobot-8-8-inch-dsi-20240322.deb
    
  4. After installation, reboot the system.

    sudo reboot
    

Wirings and Settings

Hardware Connection

After the software driver installation is complete, proceed with connecting the display.

Taking the Raspberry Pi 4B as an example, the hardware connection diagram is as follows:

FIT0941-wiring diagram

  • Step 1: Connect the display and Raspberry Pi.

    FIT0941-Connect the display and Raspberry Pi

  • Step 2: Install Raspberry Pi 4B.

    Align the four mounting holes on the Raspberry Pi with the PCB standoffs on the driver board, and secure them with installation screws. Note: After installation, please check if the spring plunger is correctly aligned with the 5V and GND pins on the Raspberry Pi.

  • Step 3: Power the Raspberry Pi or display driver board.

Display Orientation Settings

Initial Display Orientation Setup

  • Step 1: Click on the Start menu → Preferences → Screen Configuration → Layout → Screens → DSI-1 → Touchscreen → GT911 Touchscreen (This step is only required for the initial display orientation setup).

  • Step 2: Click on the Start menu → Preferences → Screen Configuration → Layout → Screens → DSI-1 → Orientation

 Select the desired display rotation angle in the Orientation section:
normal = 0°
right = 90°
inverted = 180°
left = 270°
  • Step 3: After selecting the desired rotation, click on Apply. A dialog box will appear, connect a mouse and click OK, otherwise the settings will not take effect. Then close the dialog box.

  • Step 4: A dialog box will prompt for a restart, click OK to restart and apply the settings (This step is only required for the initial display orientation setup).

Adjusting Display Orientation Again

  • Step 1: Click on the Start menu → Preferences → Screen Configuration → Layout → Screens → DSI-1 → Orientation.
  • Step 2: After selecting the desired rotation, click on Apply. A dialog box will appear, connect a mouse and click OK, otherwise the settings will not take effect. Then close the dialog box to complete the setup.

Backlight Settings

This product supports software backlight adjustment and is set to the highest brightness by default.

To adjust the backlight brightness, you can use the following command:

sudo su  # Switch to superuser first
echo 255 > /sys/class/backlight/dfrobot/brightness  # The backlight adjustment range is 0-255

Was this article helpful?

TOP