5.5inch HDMI AMOLED
| ||
| ||
Notices
Note: Since the AMOLED glass panel is very fragile without the protection of a case, special care is required during development to avoid damage. When plugging or unplugging the HDMI and USB cables, hold the PCBA board (circuit board) firmly first, and then proceed with plugging or unplugging. Do not apply excessive pressure to the glass panel.
Introduction
5.5inch AMOLED display, with a resolution of 1080 × 1920 and a capacitive touch panel, which supports Raspberry Pi and can also be used as a computer monitor.
【Note】: The screws used for holes are M2.5*4. And the screws you are using cannot be longer than 4mm, otherwise, it will damage the AMOLED panel.
Features
- 5.5inch AMOLED, 1080 x 1920 resolution.
- 5-point capacitive touch control with tempered glass panel, hardware up to 6H.
- When works with Raspberry Pi, supports Raspberry Pi OS/Ubuntu/Kali/Retropie.
- When works as a computer monitor, supports Windows 11/10/8.1/8/7.
- 3.5mm audio jack, supports HDMI audio output.
Video
Working with Windows PC
When working with PC, 5.5-inch HDMI AMOLED can support Windows 7/ 8/ 8.1 /10 /11.
1. Connect the TOUCH interface of the LCD to the USB interface of the PC. Wait for a while, the windows will automatically recognize the touch function.
2. If you use HDMI, you need to connect the HDMI interface of the LCD to the HDMI port of the PC. About 10s later, you can see the LCD display properly. If you need to output sound, you can insert 3.5mm earphones into HP ports.
Note:
1) When the computer is connected to multiple monitors at the same time, the touch effect of the 5.5-inch AMOLED will be applied to the main screen by default. If you need to specify the touch to the secondary screen, see #Calibration touch on Win 10 PC.
2) Sometimes, the USB ports of the PC do have not enough power to power 5.5-inch HDMI AMOLED, in this case, you can connect an external 5V/2A power adapter to the power port of 5.5-inch HDMI AMOLED.
3) This product is in portrait mode by default, and the resolution (H × V) is 1080 × 1920. You can enter the display settings of the Windows system and rotate it to landscape display.
Calibration touch on Win 10 PC
Take the windows10 system as an example:
- 1. Enter the Windows settings of the system, type in the search bar, and click "Calibrate the screen for pen or touch input" (as shown in the picture below).
- 2. Click "Setup" in the pop-up "Tablet PC Settings" interface:
- 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.
【Note】If the touch screen is blank, press the "Enter" key, and the text prompt will switch to the touch screen. (The screen which displays the text prompt will be used as a touch screen!)
Working with Raspberry Pi
When working with Raspberry Pi, 5.5-inch HDMI AMOLED can support various systems like Raspberry Pi OS/Ubuntu Mate/Kail/Retropie. Herein we take Raspbain as an example.
When AMOLED works on systems such as Raspberry Pi OS, the resolution must be manually set. Otherwise, it will cause abnormal display.
Please download the latest version of the image on the Raspberry Pi official website.
1) Download the compressed file to the PC, and unzip it to get the .img file.
2) Connect the TF card to the PC, and use SDFormatter software to format the TF card.
3) Open the Win32DiskImager software, select the system image downloaded in step 1, and click 'Write' to write the system image.
4) After the image has finished writing, open the config.txt file in the root directory of the TF card. Add the following code at the end of config.txt, then save and quit the TF card safely.
max_framebuffer_height=1920 config_hdmi_boost=10 hdmi_group=2 hdmi_force_hotplug=1 hdmi_mode=87 hdmi_timings=1080 1 26 4 50 1920 1 8 2 6 0 0 0 60 0 135580000 3
5) Plug the TF card into your Raspberry Pi.
6) Connect the Touch interface of the LCD to one USB port of the Raspberry Pi.
7) Connect the HDMI interface of the LCD to the HDMI interface of the Raspberry Pi.
8) Power on Raspberry Pi, and wait for a few seconds until the LCD displays normally.
【Note】The LCD is vertically displayed by default. You can refer to #Orientation Setting to change the orientation.
Display Rotation
Update the system
Raspberry Pi OS Bullseye branch needs to update the software version, and you can skip this step if using other systems.
sudo apt-get update sudo apt-get full-upgrade
Raspberry Pi OS and Kali display rotation
First, check whether the KMS or FKMS driver is loaded on the system you are using.
Check method: In /boot/config.txt, check whether the line dtoverlay=vc4-kms-v3d or dtoverlay=vc4-fkms-v3d is turned on.
- If KMS or FKMS driver is turned on:
Use the following command for display rotation:
sudo nano /etc/xdg/lxsession/LXDE-pi/autostart #Add the command corresponding to the display rotation angle at the end of the autostart file, and it will take effect after rebooting the system. #0: rotate 0 degrees; 1: rotate 270 degrees; 2: rotate 180 degrees; 3: rotate 90 degrees xrandr -o 1
- If KMS or FKMS driver is not turned on:
Use the following command for display rotation:
sudo nano /boot/config.txt #Add the command corresponding to the display rotation angle at the end of the autostart file, and it will take effect after rebooting the system. #0: rotate 0 degrees; 1: rotate 90 degrees; 2: rotate 180 degrees; 3: rotate 270 degrees display_rotate=3
Touch Rotation
With the operation above. The screen could rotate in the display. However, the touch works improperly. To rotate the touch as a display, you could do as below:
- Hardware Rotate Touch: Press and hold the Touch Rotate button on the bottom panel, and each long press will rotate the touch direction by 90 degrees.
- If there are special circumstances that cannot be rotated by hardware, please refer to the following steps to rotate the touch:
1. Install libinput
sudo apt-get install xserver-xorg-input-libinput
If the system you installed is Ubuntu or Jetson Nano. 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 part of the touchscreen, add the following statement inside, and then save the file.
Option "CalibrationMatrix" "0 1 0 -1 0 1 0 0 1"
Similar to the picture below:
5. Save and reboot your Pi:
sudo reboot
After completing these steps. The LCD could rotate 90 degrees both display and touch.
Note:
90 degree: Option "CalibrationMatrix" "0 1 0 -1 0 1 0 0 1"
180 degree: Option "CalibrationMatrix" "-1 0 1 0 -1 1 0 0 1"
270 degree: Option "CalibrationMatrix" "0 -1 1 1 0 0 0 0 1"
Screen Saver
AMOLED screen has many advantages like high contrast, wide color range, wide view angle, and so on. However, it is easy to face a burn-in problem if displaying the same content for a long time. As we test, the AMOLED cannot be restored if it displays the same static image for more than 168 hours because of the burn-in problem. In this case, we recommend you set a screen saver and do not let the AMOLED display the same static image for a long time (cannot be longer than 1h).
You can install screen saver with the command below:
sudo apt-get install xscreensaver
EDID Sequence Parameters
If the system of the main control board can automatically recognize the EDID for display, there is no need to additionally set related timing parameters.
Otherwise, you can refer to the following EDID settings:
| Pixel Clock | H Addressable | H Blanking | V Addressable | V Blanking | H Front Porch | H Sync Width | V Front Porch | V Sync Width | H Image Size | V Image Size | H Border | V Border |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 137.52 | 1080 | 120 | 1920 | 16 | 32 | 32 | 8 | 4 | 1920 | 1080 | 0 | 0 |
Resource
3D Drawing
2D Drawing
Method
Software
FAQ
disable_splash=1
{{{5}}}
{{{5}}}
Test environment: 2022-04-04-raspios-bullseye-armhf 32-bit system
Supported models: Support Waveshare DSI LCD, DPI LCD, and HDMI LCD capacitive touch screen series.64bit system does not support 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'
Input the commands:
sudo evdev-rce
After running, you can touch and long press to achieve 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
In the 99-uinput.rules file, add:
KERNEL=="uinput", MODE="0660", GROUP="input"
Save it, and then run it in the terminal.
sudo udevadm control --reload-rules sudo udevadm trigger
Then restart:
sudo reboot
Reboot and run (no need for sudo at this point).
evdev-rce
After running, you can touch and long press to achieve the right-click function.
- Booting Setup
In the terminal, type:
sudo mkdir ~/.config/autostart sudo nano ~/.config/autostart/right_click.desktop
Add the following to 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 then you can modify LONG_CLICK_INTERVAL=1000 and LONG_CLICK_FUZZ=200
{{{5}}}
{{{5}}}
{{{5}}}
- Make sure that the HDMI interface of the PC can output normally.
- The PC only connects to this LCD as a monitor without others.
- You should connect the touch cable first and then the HDMI cable.
- Some PC needs to be restarted to make the 5.5-inch HDMI AMOLED display normally.
Note: You should use the Windows system.
{{{5}}}
Take Windows 10 as an example:
- 1. Enter the Windows setting of the system, type in the search bar, and click "Calibrate the screen for pen or touch input" (as shown in the picture below):
- 2. Click "Setup" in the pop-up "Tablet PC Settings" interface:
- 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.
【Note】If the touch screen is blank, press the "Enter" key, and the text prompt will switch to the touch screen. (The screen which displays the text prompt will be used as a touch screen!)
{{{5}}}
PS: The old version only adjusts the backlight button (no touch rotation button).
{{{5}}}
Press and hold the "Touch Rotate" button on the back of the display. (Each long press will rotate 90°)
PS: The old version only adjusts the backlight button (no touch rotation button).
{{{5}}}
{{{5}}}
{{{5}}}
{{{5}}}
{{{5}}}
As shown in the figure below, the four holes in the middle of the screen are fixed with M2.5*4mm screws
Note: It is recommended to use the screws provided by us or use the screws with the total thread length not longer than 4mm, otherwise there is a risk of damage to the screen.
{{{5}}}
As shown in the picture below, the four corners of the screen are fixed with M2.5*6mm screws, and the top bracket part is installed with KA2.3*8 self-tapping screws.
Note: If the black case is not installed, the screws cannot be tightened to the fullest extent, or use screws with a total thread length of no longer than 5mm, otherwise there is a risk of damage to the screen.
{{{5}}}
Rotating 90 or 270 degrees under the VOLUMIO system requires additional GPU memory, so you must first set the GPU memory and then rotate the direction.
{{{5}}}
- Hardware: RK3288
- OS: Android 6.0
- Protocol: Adjust output from 1920 1080 to 1080 1920
- Require: It requires that users are able to compile the kernel and have knowledge of Android.
- Step 1: Open the files below (source codes of the kernel).
- Step 2: find the codes below, and modify them to 1080 1920.
- Step 3: Re-compile kernel and replace.
Because Android OS is different in different platforms, you need to port yourself for a certain platform, guides above are just provided for reference.
{{{5}}}
{{{5}}}
Anti-Piracy
Since the first-generation Raspberry Pi released, Waveshare has been working on designing, developing, and producing various fantastic touch LCDs for the Pi. Unfortunately, there are quite a few pirated/knock-off products in the market. They're usually some poor copies of our early hardware revisions, and comes with none support service.
To avoid becoming a victim of pirated products, please pay attention to the following features when purchasing:
Beware of knock-offs
Please note that we've found some poor copies of this item in the market. They are usually made of inferior materials and shipped without any testing.
You might be wondering if the one you're watching or you've purchased in other non-official stores is original, feel free to contact us.
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)