Reference

Last revision 2025/12/09

Driver

The screen supports Windows, Linux and MACOS (The other operation systems the screen might support have not been tested yet). You can configure the output resolution through setup on Windows and MAC, and through command on Linux.

On Windows

When using the screen module as an independent display, the system will employ adaptive configuration normally. But please notice: when using in multi-screen display, if you want to use the touch-control function, you need to set the screen module as the main display, as shown below.

Set as Main Display

Set Resolution

On MacOS

The touchscreen can not be used on MacOS. When only using as a display, you don't need to do any configuration normally.

On Raspberry Pi (Linux)

  • The adapter included in the package is only suitable for Raspberry Pi. For other systems, you need to buy yourself the corresponding adapter.

You need to reset resolution to avoid touch deviation caused by resolution difference between Raspberry Pi and the Touchscreen when you use 5.5" FHD touchscreen. (Insufficient power supply will affect the touching sensitivity.)

  • Screen display resolution configuration

In the terminal, enter /boot/config.txt, add the following code to the end:

	hdmi_ignore_edid=0xa5000080
	max_framebuffer_height=1920
	#max_framebuffer_width=1920
	config_hdmi_boost=10
	hdmi_driver=2
	hdmi_group=2
	hdmi_force_hotplug=1
	hdmi_mode=87
	hdmi_timings=1080 0 48 32 80 1920 0 12 8 12 0 0 0 48 0 144386000 3
	display_rotate=0

The parameters in Raspberry Pi 4B is as below:

  • Now it only supports HDMI0 port.
  • If the original comfig.txt contains the parameter “dtoverlay=vc4-fkms-v3d”, please comment it, which means add the “***#***” to the forehead, so that is changes to “***#dtoverlay=vc4-fkms-v3d***”
    #hdmi_ignore_edid=0xa5000080
	max_framebuffer_height=1920
	#max_framebuffer_width=1920
	config_hdmi_boost=10
	hdmi_driver=2
	hdmi_group=2
	hdmi_force_hotplug=1
	hdmi_mode=87
	hdmi_timings=1080 0 48 32 80 1920 0 12 8 12 0 0 0 48 0 144386000 3
	display_rotate=0
	
    [pi4]
	# Enable DRM VC4 V3D driver on top of the dispmanx display stack
	# dtoverlay=vc4-fkms-v3d
	# max_framebuffers=2

display_rotate=0, 1, 2, 3 (representing to rotate the screen 0°, 90°, 180°, 270° respectively)

  • Touchscreen Parameter Configuration

1.Download DFRobot_RaspberryPi_TouchScreen_Firmware to the host, default to the file Downloads. Press Ctrl+Alt+T simultaneously to open the terminal as shown below:

DFR0524-RPI-1.png

2.Enter /home/pi/Downloads, then input the command unzip DFRobot_RaspberryPi_TouchScreen_Firmware-master.zip to extract the file

3.Enter the folder DFRobot_RaspberryPi_TouchScreen_Firmware-master/5.5 HDMI_DISPLAY, then input sudo python touch_rotate.py and the value of display-rotate in config.txt. Now you just need to wait for the restart of the Raspberry Pi. As shown below:

DFR0524-RPI-2.png

  • V1.0 adopts HDMI C-type interface, V2.0 uses HDMI A-type interface.
  • Since HDMI interface has limited power supply ability, V2.0 only supports USB power supply.
  • Due to the difference of the touchscreen drivers on various systems, we have tested that, On MacOS, the product can be only used as a display, touchscreen is not available.
  • The structure of the current touchscreen is only perfectly suitable for Raspberry Pi, for connecting with other host devices, you need to buy a suitable HDMI cable.
  • Not support for using on Raspberry Pi Zero

Was this article helpful?

TOP