Difference between revisions of "Template:5.5inch HDMI AMOLED user manual"

From Waveshare Wiki
Jump to: navigation, search
m (Text replacement - "https://www.waveshare.com/w/upload/" to "https://files.waveshare.com/upload/")
 
(25 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
===Features===
 
===Features===
*5.5inch AMOLED, 1080x1920 resolution
+
*5.5inch AMOLED, 1080 x 1920 resolution.
*Toughened glass capacitive touch panel, 6H hardness
+
*5-point capacitive touch control with tempered glass panel, hardware up to 6H.
*Supports popular mini PCs such as Raspberry Pi, as well as general desktop computers
+
*When works with Raspberry Pi, supports Raspberry Pi OS/Ubuntu/Kali/Retropie.
*When works with Raspberry Pi, supports Raspbian/Ubuntu/Kali/Retropie, driver free
+
*When works as a computer monitor, supports Windows 11/10/8.1/8/7.
*When works as a computer monitor, supports Windows 10/8.1/8/7, five-points touch, and driver free
+
*3.5mm audio jack, supports HDMI audio output.
*3.5mm audio jack, supports HDMI audio output
 
*M2.5 screw holes for easy mounting
 
  
==How to use==
+
=='''Video'''==
===Working with Windows PC===
+
<youtube>https://youtu.be/eyk1T8s5oIY</youtube>
When working with PC, 5.5inch HDMI AMOLED can supports Windows 7/ 8/ 8.1 /10 OS
 
  
1. Connect Touch interface of LCD to one USB port of PC
 
  
2. Connect HDMI Interface of LCD to HDMI port of PC
+
==''' Working with Windows PC'''==
 +
When working with PC, 5.5-inch HDMI AMOLED can support Windows 7/ 8/ 8.1 /10 /11.
  
- You can connect 3.5mm earphone to LCD for audio output
+
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.
  
【Note】
+
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.
  
-The touch screen controls the main display by default, therefore, we recommend you to set the 5.5inch HDMI AMOLED as main displays.
+
'''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]].<br />
 +
 
 +
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 DC interface 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).
 +
 
 +
[[File:win10_touch011.png|700px]]
 +
 
 +
*2. Click "Setup" in the pop-up "Tablet PC Settings" interface:
 +
 
 +
[[File:win10_touch02.png|400px]]
 +
 
 +
 
 +
*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.
  
-Sometimes, USB ports of PC has not enough power to power 5.5inch HDMI AMOLED, in this case, you can connect external 5V/2A power adapter to DC interface of LCD
+
<font color=red>【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!) </font>
  
-If the LCD cannot display normally after connecting, please restart your PC and check again.
+
[[File:win10_touch03.png|800px]]
===Working with Raspberry Pi===
 
When working with Raspberry Pi, 5.5inch HDMI AMOLED can support various systems like Raspbian, Ubuntu Mate and so on. Herein we take Raspbain as example.
 
  
Raspberry Pi cannot recognized and adapted to resolution of LCD plugged, therefore, we need to set the resolution of Raspbian manually
+
==''' 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.
  
1. Download Raspbian image from Raspberry Pi website
+
When AMOLED works on systems such as Raspberry Pi OS, the resolution must be manually set. Otherwise, it will cause abnormal display.
  
2. Write the image to your TF card. (TF card need to be formatted)
+
Please download the latest version of the image on the [https://www.raspberrypi.com/software/operating-systems/ Raspberry Pi official website.]
  
3. Open config.txt file which located in root directory of SD card and add the statements below to end of the file
+
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 [https://files.waveshare.com/upload/d/d7/Panasonic_SDFormatter.zip SDFormatter] software to format the TF card.
 +
 
 +
3) Open the [https://files.waveshare.com/upload/7/76/Win32DiskImager.zip 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.
  
 
<source lang="c">
 
<source lang="c">
 
max_framebuffer_height=1920
 
max_framebuffer_height=1920
max_usb_current=1
 
 
config_hdmi_boost=10
 
config_hdmi_boost=10
 
hdmi_group=2
 
hdmi_group=2
Line 44: Line 64:
 
hdmi_mode=87
 
hdmi_mode=87
 
hdmi_timings=1080 1 26 4 50 1920 1 8 2 6 0 0 0 60 0 135580000 3
 
hdmi_timings=1080 1 26 4 50 1920 1 8 2 6 0 0 0 60 0 135580000 3
dtoverlay=vc4-fkms-v3d
 
 
</source>
 
</source>
  
<font color=red>If you use the LCD with Raspberry Pi 4B,you need to remove line dtoverlay=vc4-fkms-V3D from config.txt file.</font>
 
  
4. Save and eject the SD card. Plug the card to your Raspberry Pi
+
5) Save and eject the SD card. Plug the card into your Raspberry Pi.
  
5. Connect Touch interface of LCD to one USB port of Raspberry Pi
+
6) Connect the Touch interface of the LCD to one USB port of the Raspberry Pi.
  
6. Connect HDMI interface of LCD to HDMI interface of Raspberry Pi
+
7) Connect the HDMI interface of the LCD to the HDMI interface of the Raspberry Pi.
  
7. Power on Raspberry Pi
+
8) Power on Raspberry Pi, and wait for a few seconds until the LCD displays normally.
  
【Note】The LCD is vertically display by default. You can refer to [[#Orientation Setting]] to change the orientation.
+
【Note】The LCD is vertically displayed by default. You can refer to [[#Orientation Setting]] to change the orientation.
  
===Screen Saver===
+
===Display Rotation===
AMOLED screen has advantages of high contrast, wide color range, wide view angle
+
'''Update the system'''<br/>
and so on. However, it is easy to face burn-in problem if displaying same content for long time. '''As we test, the AMOLED cannot be restored if it display same static image for 168 hours because of burn-in problem'''. In this case, we recommend you to set screen saver and do not let the AMOLED display same static image for long time (cannot longer than 1h).
+
Raspberry Pi OS Bullseye branch needs to update the software version, other systems can omit this step.
 +
sudo apt-get update
 +
sudo apt-get full-upgrade
 +
'''Raspberry Pi OS and Kali display rotation'''<br/>
 +
First, check whether the KMS or FKMS driver is loaded on the system you are using.
  
You can install screen saver with command below:
+
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:
 +
<source lang="c">
 +
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
 +
</source>
 +
* If KMS or FKMS driver is not turned on:
 +
Use the following command for display rotation:
 +
<source lang="c">
 +
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
 +
</source>
  
sudo apt-get install xscreensaver
+
===Touch Rotation===
  
===Orientation Setting===
+
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:
1. To rotating the display, you can append this statement to the config file
+
*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.
 +
:[[File:800px-5.5-new5.png|600px]]
 +
*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
  
  display_rotate=1 #1: 90; 2: 180; 3: 270
+
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
  
2. Reboot the Raspberry Pi
+
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
  
  sudo reboot
+
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"
;Touch Rotating
 
  
With the operation above. The screen could rotate in display. However, the touch works improperly. To rotate the touch as display, you could do as below:
+
Similar to the picture below:
  
1. install libinput
 
sudo apt-get install xserver-xorg-input-libinput
 
:For Ubuntu-Mate OS, you need to install '''xserver-xorg-input-libinput-hwe-16.04''' instead.
 
2. create an xorg.conf.d folder
 
sudo mkdir /etc/X11/xorg.conf.d
 
3. copy file 40-libinput-conf to the folder which we created
 
sudo cp /usr/share/X11/xorg.conf.d/40-libinput.conf /etc/X11/xorg.conf.d/
 
4. Append a statement to touchscreen part of the file as below:
 
sudo nano /etc/X11/xorg.conf.d/40-libinput.conf
 
 
[[File:touch roate.jpg]]<br />
 
[[File:touch roate.jpg]]<br />
5. save and reboot your Pi
+
5. Save and reboot your Pi:
 
  sudo reboot
 
  sudo reboot
  
After completing these steps. The LCD could rotate 90 degree both display and touch.
+
After completing these steps. The LCD could rotate 90 degrees both display and touch.
  
 
'''Note:'''
 
'''Note:'''
Line 102: Line 140:
  
 
270 degree: Option "CalibrationMatrix" "0 -1 1 1 0 0 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.<br/>
 +
 +
Otherwise, you can refer to the following EDID settings:<br/>
 +
{| class="wikitable"
 +
! 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
 +
|}

Latest revision as of 06:19, 2 September 2023

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 DC interface 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).

Win10 touch011.png

  • 2. Click "Setup" in the pop-up "Tablet PC Settings" interface:

Win10 touch02.png


  • 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!)

Win10 touch03.png

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) Save and eject the SD card. Plug the 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, other systems can omit this step.

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.
800px-5.5-new5.png
  • 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:

Touch roate.jpg
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