5.5inch 1440x2560 LCD
| ||
| ||
Note: This product defaults to portrait display with a resolution (H×V) of 1440×2560. You can switch to landscape display by modifying the software settings.
Introduction
This product is a universal 5.5inch HDMI interface IPS display with a 1440×2560 resolution and a fully bonded capacitive touch panel.
It supports Raspberry Pi 5/CM5/4/CM4 and can also serve as a computer monitor.
Features
- 5.5inch IPS display with a hardware resolution of 1440 × 2560
- 10-point capacitive touch control with toughened glass panel, hardness up to 6H
- Adopts Optically bonded touch process for better use
- Supports Raspberry Pi OS / Ubuntu / Kali and Retropie when working with Raspberry Pi 4B
- Supports Windows 11/10/8.1/8/7 when working as a computer monitor
- Supports HDMI audio output with 3.5mm jack and 4PIN header
Onboard Resources
Working with Raspberry Pi
Raspberry Pi OS / Ubuntu / Kali and Retropie systems for Raspberry Pi.
When the LCD works on these systems, the resolution must be set manually, otherwise it will cause an abnormal display.
- 1. Download the latest version of the image from the Raspberry Pi website.
Download the compressed file to your PC, and extract it as .img file. - 2. Connect the TF card to the PC, format the TF card with SDFormatter software.
- 3. Open the Win32DiskImager software, select the system image prepared in step 1, and click Write to flash the system image.
- 4. After the image flashing is completed, open the config.txt file in the root directory of the TF card, add the following code at the end of the config.txt, save and safely eject the TF card, then insert the TF card into the Raspberry Pi.
hvs_priority=0x32ff gpu_mem=256 config_hdmi_boost=10 hdmi_force_hotplug=1 hdmi_group=2 hdmi_mode=87 hdmi_drive=2 hdmi_pixel_freq_limit=268500000 #pi4： hdmi_timings=1440 0 10 10 140 2560 0 11 2 2 0 0 0 50 0 206000000 3 #3B/ZERO needs to be changed to the following line of timings configuration and block dtoverlay=vc4-kms-v3d or dtoverlay=vc4-fkms-v3d #hdmi_timings=1440 0 10 10 140 2560 0 11 2 2 0 0 0 50 0 180000000 3 disable_overscan=1 framebuffer_width=1440 framebuffer_height=2560 max_framebuffer_width=1440 max_framebuffer_height=2560 extra_transpose_buffer=2
- 5. Connect the TOUCH interface of the display to the USB port of the Raspberry Pi.
- 6. Connect the HDMI interface of the display to the HDMI port of the Raspberry Pi and then power on the Raspberry Pi, it can display normally after waiting for a few seconds.
Note 1. The screen is displayed vertically by default. For convenience, you can adjust the display orientation of the screen, see Screen Rotation.
Note 2. When the Raspberry Pi is connected to multiple monitors at the same time, the touch effect will be applied to the main screen by default. If you need to specify the touch to the secondary screen, see Raspberry Pi Specified Touch Screen.
Screen Rotation
Bookworm System
GUI Interface Rotation
- 1. Open the "Screen Configuration" application;
- 2. Go to "Screen" - > "HDMI-A-1" - > "Touchscreen" and check "Waveshare Waveshare"
- 3. Go to "Screen" -> "HDMI-A-1" -> "Orientation", check the direction you need to rotate, and finally click "Apply" to complete the screen and touch synchronous rotation.
Note: Only the Bookworm system supports the above screen and touch synchronization rotation method. Bullseye and earlier versions require separate settings for screen and touch rotation.
lite Version Screen Rotation (No Desktop Environment)
Edit the startup command line file:
sudo nano /boot/firmware/cmdline.txt
Add the following parameters at the beginning of the cmdline.txt file (required to change to the actual screen resolution):
video=HDMI-A-1:400x1280M@60,rotate=90
Replaced with:
- rotate=90: rotate 90° clockwise
- rotate=180: rotate 180° clockwise
- rotate=270: rotate 90° counterclockwise
Note: HDMI shares rotation settings with other interfaces (such as DPI, DSI) and cannot be set separately.
Bullseye/Buster Systems
GUI Interface Rotation
- 1. Open the "Screen Configuration" application;
- 2. Go to "Screen" -> "HDMI-A-1" -> "Orientation", check the direction you need to rotate, and finally click "Apply" to apply the settings.
lite Version Screen Rotation
- 1. Need to modify the /boot/cmdline.txt file:
sudo nano /boot/cmdline.txt
- 2. Add the following parameters at the beginning of the cmdline.txt file (required to change to the actual screen resolution):
video=HDMI-A-1:400x1280M@60,rotate=90
Replaced with:
- rotate=90: rotate 90° clockwise
- rotate=180: rotate 180° clockwise
- rotate=270: rotate 90° counterclockwise
Note: HDMI shares rotation settings with other interfaces (such as DPI, DSI) and cannot be set separately.
- 3. Save and restart
sudo reboot
Stretch/Jessie Systems
For older systems (not using the vc4-kms-v3d or vc4-fkms-v3d drivers), please set up as follows:
- 1. Edit config.txt file
sudo nano /boot/config.txt
- 2. Add the statement at the end of the file:
display_rotate=1 #1: 90; 2: 180; 3: 270
- 2. Save the changes and then reboot the Raspberry Pi
sudo reboot
Touchscreen Rotation Settings
Some screens can be rotated by holding down the Rotate Touch button on the back to switch the touch direction. Each hold switches the direction once.
Bookworm System (Command Line Mode)
If you use the graphical interface for rotation, you can tick "Touchscreen" in the screen layout editor window to synchronize the touch rotation. Please refer to the previous introduction for how to rotate the screen. For the command line rotation method, please refer to the following text:
1. Create a udev rule file:
sudo nano /etc/udev/rules.d/99-waveshare-touch.rules
2. Add the content for the desired rotation angle (uncomment as needed):
#90°:
ENV{ID_INPUT_TOUCHSCREEN}=="1", ENV{LIBINPUT_CALIBRATION_MATRIX}="0 -1 1 1 0 0"
#180°:
#ENV{ID_INPUT_TOUCHSCREEN}=="1", ENV{LIBINPUT_CALIBRATION_MATRIX}="-1 0 1 0 -1 1"
#270°:
#ENV{ID_INPUT_TOUCHSCREEN}=="1", ENV{LIBINPUT_CALIBRATION_MATRIX}="0 1 0 -1 0 1"
3. Save and reboot
sudo reboot
Bullseye/Buster Systems
1. Install libinput
sudo apt-get install xserver-xorg-input-libinput
- If you have Ubuntu or Jetson Nano installed. The installation code is:
sudo apt install xserver-xorg-input-synaptics
2. Create the xorg.conf.d directory under /etc/X11 (if the directory already exists, proceed directly to step 3).
sudo mkdir /etc/X11/xorg.conf.d
3. Copy the 40-libinput-conf file to the directory you created just now.
sudo cp /usr/share/X11/xorg.conf.d/40-libinput.conf /etc/X11/xorg.conf.d/
4. Edit this file
sudo nano /etc/X11/xorg.conf.d/40-libinput.conf #Find the touchscreen section, add the corresponding rotation angle command in it, and save it #"90° Right touch rotation: Option "CalibrationMatrix" "0 1 0 -1 0 1 0 0 1" #180° Inverted touch rotation: #Option "CalibrationMatrix" "-1 0 1 0 -1 1 0 0 1" #270° Left touch rotation: #Option "CalibrationMatrix" "0 -1 1 1 0 0 0 0 1" Similar to the position in the following image:
5. Reboot Raspberry Pi
sudo reboot
After completing the above steps, touch will cause a rotation.
Use Touchscreen Virtual Keyboard
Raspberry Pi OS Bookworm and later versions include Squeekboard on-screen keyboard by default.
When connecting to the touch display, the on-screen keyboard will automatically appear if text input is possible, and it will automatically hide if text input is not possible.
For applications that do not support automatic text input detection, you can manually display or hide the on-screen keyboard by clicking the keyboard icon at the far right of the task bar.
You can also set the display or hide the screen keyboard through the "Display" option under "Raspberry Pi Configuration" or through the "Display" section in raspi-config.
- Note:
For versions of Raspberry Pi OS before Bookworm, use matchbox-keyboard. If you are using the wayfire desktop compositor, use wvkbd.
Touch Mode Selection
The Bookworm system supports two touch modes, which can be switched in the Screen Configuration > Touchscreen menu:
- 1. Mouse Emulation (default)
Click = Left mouse button function Long press = Right mouse button function Supports double-click Does not support swipe page and multi-touch functions
Note: This mode is suitable for scenarios that require mouse operation, such as double clicking to open the file manager and long pressing to achieve right-click functionality.
- 2. Multitouch
Supports multi-touch functionality Supports swiping pages Does not support double-click and right-click long press functions
Note: This mode is suitable for touch-optimized scenarios, such as web browsing and scrolling lists.
Raspberry Pi Specified Touch Screen
1. Enter xrandr on the Raspberry Pi terminal and check the HDMI-ID (most of them are HDMI-1) where the main screen is located;
2. Enter xinput on the Raspberry Pi terminal to check the touch ID where the main screen is located (there are 2 touch IDs, if you don't know which is the main screen, you can try both);
3. Run the command: xinput map-to-output touch ID HDMI-ID
(After matching the ID value, you can run the command to specify the touch to the main screen, such as: xinput map-to-output 7 HDMI-1)
4. Since you need to re-enter the command every time you boot up, you can add this command to the boot autostart:
sudo nano etcxdglxsessionLXDE-piautostart
Add xinput map-to-output 7 HDMI-1 (remember to change it to your own corresponding ID), and then restart it.
Interface Optimization
Due to the high resolution of the screen, it is recommended to modify the theme to a larger size for enjoying a better touch experience. This feature is not supported on all systems. The following mainly uses the Raspbian system to describe the relevant operations, and other systems are similar.
- Select Menu -> Preferences -> Appearance Settings -> Defaults -> For large screens: Set Defaults -> OK.
- Set the font size in the System.
- Right-click on the taskbar -> "Panel Settings" -> "Geometry" -> "Size".
Working with PC
Supports Windows 11 / 10 / 8.1 / 8 / 7 systems. How to use:
- 1. Connect the TOUCH interface of the display to the USB port of the PC. Wait for a moment, Windows will automatically recognize the touch function.
- 2. Connect the HDMI port of the display to the HDMI port of the PC, and wait for about 10 seconds until the display work normally. If you need to output sound, you can connect a 3.5mm headphone through the HP audio output interface.
- Note 1: When the computer is connected to multiple monitors at the same time, the touch effect will be applied to the main display by default. If you need to specify the touch to the secondary display, see Windows Specified Touch Screen.
- Note 2: The USB port of some PCs may be underpowered due to aging, so you can use the USB port on the back of the PC or connect to the power port of an external 5V 2A power adapter.
- Note 3: This product defaults to vertical display, and the resolution (H×V) is 1440 × 2560. You can enter the display settings of Windows system and rotate it to landscape display.
Windows Specified Touch Screen
Take Windows 11 as an example:
- 1. Go to Windows settings of the system, enter in the search bar and click on "Control Panel" (as shown in the figure below)
- 2. In the pop-up "Control Panel" interface, select "Hardware and Sound"
- 3. Select "Calibrate the screen for pen or touch input", then click "Settings" in the pop-up tablet settings
- 4. The text prompt shown below will appear on the screen. Please click on the touchpad with your finger and the computer will recognize it as a touch screen.
- 1. Go to Windows settings of the system, enter in the search bar and click on Calibration the screen for pen and touch input (as shown in the figure below)
- 2. In the pop-up Tablet PC Settings interface, click Settings
- 3. The text prompt shown below will appear on the screen. Please click on the touchpad with your finger and the computer will recognize it as a touch screen.
Working with Tinker Board 2
Hardware Connection
- 1. Connect the TOUCH interface of the LCD to the USB port of the Tinker Board 2.
- 2. Connect the HDMI port of the LCD to the HDMI port of the Tinker Board 2.
Software Settings
Android and Debian systems for Tinker Board 2.
1. Download the latest version of the image from the Tinker Board website
Download the compressed file to your PC, and extract it as .img file.
- 2. Connect the TF card to the PC, format the TF card with SDFormatter software.
- 3. Open the Win32DiskImager software, select the system image prepared in step 1, and click Write to flash the system image.
- 4. After the flashing is completed, insert the TF card into the Tinker Board 2 and power it on, and wait for more than 10 seconds to display it normally.
Resources
Assembly video
Related Software
Diagrams
FAQ
Add the following command to /boot/config.txt:
disable_splash=1
{{{5}}}
Replace the custom image with the image in this directory /usr/share/plymouth/themes/pix/splash.png.
{{{5}}}
Raspberry Pi Long-press Right-click Software Installation
Test environment: 2022-04-04-raspios-bullseye-armhf 32-bit system.
Models supported: Supports Waveshare DSI LCD, DPI LCD, and HDMI LCD capacitive touch screen series 32-bit systems, while 64-bit systems are not supported by default
wget https://files.waveshare.com/upload/1/18/Evdev-right-click-emulation.zip unzip Evdev-right-click-emulation.zip cd evdev-right-click-emulation sudo apt install build-essential libevdev2 libevdev-dev -y sudo cp 'out/evdev-rce' '/usr/local/bin/' sudo chmod +x '/usr/local/bin/evdev-rce'
Enter the command:
sudo evdev-rce
After running, you can touch and long press to realize the right-click function.
Set up Pi User to Run
sudo usermod -G 'input' -a pi echo 'uinput' | sudo tee -a /etc/modules sudo nano /etc/udev/rules.d/99-uinput.rules
Add following in 99-uinput.rules file.
KERNEL=="uinput", MODE="0660", GROUP="input"
Save it and run it in the terminal.
sudo udevadm control --reload-rules sudo udevadm trigger
Then reboot:
sudo reboot
Run after reboot (no sudo needed at this point).
evdev-rce
After running, you can touch and long press to realize the right-click function.
Set Startup
Enter in the terminal.
sudo mkdir ~/.config/autostart sudo nano ~/.config/autostart/right_click.desktop
Add the following in right_click.desktop.
[Desktop Entry] Version=1.0 Type=Application Name=evdev-rce GenericName=Enable long-press-to-right-click gesture Exec=env LONG_CLICK_INTERVAL=1000 LONG_CLICK_FUZZ=200 /usr/local/bin/evdev-rce Terminal=true StartupNotify=false
If you want to modify the sensitivity, you can modify the two parameters: LONG_CLICK_INTERVAL=1000, LONG_CLICK_FUZZ=200.
It depends on the system, if the system has hibernation, the screen will also be black. If it is the official system of Raspberry Pi, the default is about ten minutes without action to have hibernation.
- Make sure that the HDMI port of the PC can output normally.
- The PC only connects the LCD as a display device and does not connect other monitors.
- Connect the power cable first and then the HDMI cable.
- Some PCs need to be restarted to display properly.
Note: Windows system must be used.
1. Open Windows Settings, enter "calibration" in the search bar, and select "Calibrate screen for pen and touch input"
2. Click "Setting" in the "Display"
3. The following text prompt will appear on the screen. Please tap the touch screen with your finger, and the computer will recognize it as a touch screen.
{{{5}}}
{{{5}}}
{{{5}}}
{{{5}}}
{{{5}}}
Modify the hardware as shown in the figure below, and then connect the PWM pin to the pad pointed by the yellow arrow
Support
Technical Support
If you need technical support or have any feedback/review, please click the Submit Now button to submit a ticket, Our support team will check and reply to you within 1 to 2 working days. Please be patient as we make every effort to help you to resolve the issue.
Working Time: 9 AM - 6 PM GMT+8 (Monday to Friday)