Difference between revisions of "3.2inch RPi LCD (B)"
m (Text replacement - "http://www.waveshare.com/w/upload/" to "https://files.waveshare.com/upload/") |
|||
(12 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
<div class="wiki-pages jet-green-color"> | <div class="wiki-pages jet-green-color"> | ||
{{Infobox item | {{Infobox item | ||
− | |brief= | + | |brief=320 × 240 |
− | |img=[[File:3.2inch-RPi-LCD-B_l.jpg|300px|{{Amazon_nolink|default={{#urlget:amazon|0}}|{#urlget:Amazon|0}}|default|}}| | + | |img=[[File:3.2inch-RPi-LCD-B_l.jpg|300px|{{Amazon_nolink|default={{#ifeq: {{#urlget:amazon|0}}|{{#urlget:Amazon|0}}| default|}}|url=link=http://www.waveshare.com/product/3.2inch-RPi-LCD-B.htm}} | 3.2inch RPi LCD (B)]] |
|caption=3.2 inch Resistive Touch Screen TFT LCD Designed for Raspberry Pi, Raspbian IMG Provided | |caption=3.2 inch Resistive Touch Screen TFT LCD Designed for Raspberry Pi, Raspbian IMG Provided | ||
|platform=Raspberry Pi | |platform=Raspberry Pi | ||
Line 18: | Line 18: | ||
=Overview= | =Overview= | ||
== '''Introduction''' == | == '''Introduction''' == | ||
− | 3.2 inch Resistive Touch Screen TFT LCD is designed for Raspberry Pi | + | 3.2-inch Resistive Touch Screen TFT LCD is designed for Raspberry Pi and provides Raspbian IMG. |
{{Amazon|{{#ifeq: {{#urlget:amazon|0}}|{{#urlget:Amazon|0}}| default|}}=display | {{Amazon|{{#ifeq: {{#urlget:amazon|0}}|{{#urlget:Amazon|0}}| default|}}=display | ||
Line 24: | Line 24: | ||
== '''Features''' == | == '''Features''' == | ||
− | * The hardware resolution is | + | * The hardware resolution is 320 × 240. |
* Resistive touch control. | * Resistive touch control. | ||
− | * It is compatible and can be directly inserted | + | * It is compatible and can be directly inserted into any version of Raspberry Pi. |
* Drivers provided (works with your own Raspbian/Ubuntu/Kali and Retropie system directly). | * Drivers provided (works with your own Raspbian/Ubuntu/Kali and Retropie system directly). | ||
* Support FBCP software driver, can set the software resolution and dual-screen display. | * Support FBCP software driver, can set the software resolution and dual-screen display. | ||
Line 33: | Line 33: | ||
{{RPi LCD User Manual}} | {{RPi LCD User Manual}} | ||
--> | --> | ||
+ | |||
== '''Getting Started''' == | == '''Getting Started''' == | ||
=== Hardware Connection === | === Hardware Connection === | ||
Line 38: | Line 39: | ||
===Install the touch driver=== | ===Install the touch driver=== | ||
− | The RPi LCD can be driven in two ways: Method 1. | + | The RPi LCD can be driven in two ways: Method 1. Install the driver to your Raspbian OS. Method 2. Use the Ready-to-use image file of which the LCD driver was pre-installed. |
''' Method 1. Driver installation''' | ''' Method 1. Driver installation''' | ||
Line 46: | Line 47: | ||
1) Download the compressed image file to the PC, and unzip it to get the .img file. | 1) Download the compressed image file to the PC, and unzip it to get the .img file. | ||
− | 2) Connect the TF card to the PC, open the [ | + | 2) Connect the TF card to the PC, 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. (How to write an image to a micro SD card for your Pi? See [[RPi-Image-Installation-Guides|RPi Image Installation Guides]] for more details.) |
− | 3) Connect the TF card to the Raspberry Pi, start the Raspberry Pi. The LCD will display after booting up, and then log in to the Raspberry Pi terminal,(You may need to connect a keyboard and HDMI LCD to Pi for driver | + | 3) Connect the TF card to the Raspberry Pi, and start the Raspberry Pi. The LCD will display after booting up, and then log in to the Raspberry Pi terminal,(You may need to connect a keyboard and HDMI LCD to Pi for driver installation, or log in remotely with SSH). |
4) Then open the terminal of Raspberry Pi to install the touch driver. | 4) Then open the terminal of Raspberry Pi to install the touch driver. | ||
Line 131: | Line 132: | ||
'''Notes:''' | '''Notes:''' | ||
*1. Executing apt-get upgrade will cause the LCD to fail to work properly. In this case, you need to edit the config.txt file in the SD card and delete this sentence: dtoverlay=ads7846. | *1. Executing apt-get upgrade will cause the LCD to fail to work properly. In this case, you need to edit the config.txt file in the SD card and delete this sentence: dtoverlay=ads7846. | ||
− | *2. Using | + | *2. Using Raspbian-lite, the command of the touch driver installation should be: |
{{#switch: {{FULLPAGENAME}} | {{#switch: {{FULLPAGENAME}} | ||
| 2.8inch RPi LCD (A) = | | 2.8inch RPi LCD (A) = | ||
Line 191: | Line 192: | ||
'''Method 2. Using Ready-to-use image''' | '''Method 2. Using Ready-to-use image''' | ||
− | The image file with pre-installed driver is located in the IMAGE directory of the CD, or you can download it from [[#Image]]. Extract the .7z file and you will get an .img file. Write the image to your micro SD card (How to write an image to a micro SD card for your Pi? See [[RPi-Image-Installation-Guides|RPi Image Installation Guides]] for more details). Then insert the card | + | The image file with the pre-installed driver is located in the IMAGE directory of the CD, or you can download it from [[#Image]]. Extract the .7z file and you will get an .img file. Write the image to your micro SD card (How to write an image to a micro SD card for your Pi? See [[RPi-Image-Installation-Guides|RPi Image Installation Guides]] for more details). Then insert the card into your Pi, power up, and enjoy it. |
<!-- | <!-- | ||
Line 264: | Line 265: | ||
<syntaxhighlight lang="c"> | <syntaxhighlight lang="c"> | ||
cd LCD-show/ | cd LCD-show/ | ||
− | #X can be 0, 90, 180 and 270. Indicates that the LCD rotates 0 degrees, 90 degrees, 180 degrees and 270 degrees, respectively. | + | #X can be 0, 90, 180, and 270. Indicates that the LCD rotates 0 degrees, 90 degrees, 180 degrees, and 270 degrees, respectively. |
#If it is an old version, execute the following code: | #If it is an old version, execute the following code: | ||
sudo ./LCD28-show X | sudo ./LCD28-show X | ||
Line 274: | Line 275: | ||
<syntaxhighlight lang="c"> | <syntaxhighlight lang="c"> | ||
cd LCD-show/ | cd LCD-show/ | ||
− | #X can be 0, 90, 180 and 270. Indicates that the LCD rotates 0 degrees, 90 degrees, 180 degrees and 270 degrees, respectively. | + | #X can be 0, 90, 180, and 270. Indicates that the LCD rotates 0 degrees, 90 degrees, 180 degrees, and 270 degrees, respectively. |
#If it is an old version, execute the following code: | #If it is an old version, execute the following code: | ||
sudo ./LCD28-show lite X | sudo ./LCD28-show lite X | ||
Line 288: | Line 289: | ||
* Click the "Menu" button on the taskbar, choose "Preference" -> "Calibrate Touchscreen". | * Click the "Menu" button on the taskbar, choose "Preference" -> "Calibrate Touchscreen". | ||
* Finish the touch calibration following the prompts. Maybe rebooting is required to make calibration active. | * Finish the touch calibration following the prompts. Maybe rebooting is required to make calibration active. | ||
− | * You can create a 99-calibration.conf file to save the touch parameters (not necessary if file exists). | + | * You can create a 99-calibration.conf file to save the touch parameters (not necessary if the file exists). |
sudo nano /etc/X11/xorg.conf.d/99-calibration.conf | sudo nano /etc/X11/xorg.conf.d/99-calibration.conf | ||
* Save the touch parameters (may differ depending on LCD) to 99-calibration.conf, as shown in the picture: | * Save the touch parameters (may differ depending on LCD) to 99-calibration.conf, as shown in the picture: | ||
Line 325: | Line 326: | ||
== '''Install Virtual Keyboard''' == | == '''Install Virtual Keyboard''' == | ||
− | 1. Install matchbox-keyboard <br /> | + | 1. Install matchbox-keyboard. <br /> |
<pre> | <pre> | ||
sudo apt-get install update | sudo apt-get install update | ||
Line 360: | Line 361: | ||
X-MB-INPUT-MECHANSIM=True | X-MB-INPUT-MECHANSIM=True | ||
</pre> | </pre> | ||
− | 5. Execute commands as below. '''Note that you need to use "Pi " user permission instead of root to execute this command''' | + | 5. Execute commands as below. '''Note that you need to use "Pi " user permission instead of root to execute this command.''' |
<pre> | <pre> | ||
sudo nano /etc/xdg/lxpanel/LXDE-pi/panels/panel | sudo nano /etc/xdg/lxpanel/LXDE-pi/panels/panel | ||
</pre> | </pre> | ||
− | 6. Find the statement which is similar to below: (It | + | 6. Find the statement which is similar to below: (It may be different in different versions.) |
<pre> | <pre> | ||
Plugin { | Plugin { | ||
Line 377: | Line 378: | ||
} | } | ||
</pre> | </pre> | ||
− | 7. Append these statements to add | + | 7. Append these statements to add a button option: |
<pre> | <pre> | ||
Button { | Button { | ||
Line 385: | Line 386: | ||
[[File:RPILCD-INSTALL-KEYBOARD01.png|400px]] <br /> | [[File:RPILCD-INSTALL-KEYBOARD01.png|400px]] <br /> | ||
− | 8. Reboot your Raspberry Pi. If the virtual keyboard is installed correctly, you can find that there is a keyboard icon on the left of the bar | + | 8. Reboot your Raspberry Pi. If the virtual keyboard is installed correctly, you can find that there is a keyboard icon on the left of the bar. |
sudo reboot | sudo reboot | ||
<br /> | <br /> | ||
Line 395: | Line 396: | ||
RPi LCD can also work with an external camera to take photos. In this operation, a Raspberry Pi camera is required, which should be purchased separately. | RPi LCD can also work with an external camera to take photos. In this operation, a Raspberry Pi camera is required, which should be purchased separately. | ||
− | If you use the image provided | + | If you use the image provided by us, after the camera is attached, you can open the camera by command lines. |
cd /home/pi/camera/ | cd /home/pi/camera/ | ||
Camera | Camera | ||
− | Then, waiting several seconds, the camera application will be started automatically. Now, you can capture pictures by double clicking the screen. | + | Then, waiting several seconds, the camera application will be started automatically. Now, you can capture pictures by double-clicking the screen. |
− | If you use the image with clean installation, you can | + | If you use the image with a clean installation, you can set up the camera driver with: |
--> | --> | ||
<!-- | <!-- | ||
Line 447: | Line 448: | ||
Camera will be enabled by the steps above. | Camera will be enabled by the steps above. | ||
--> | --> | ||
− | |||
== '''Interface''' == | == '''Interface''' == | ||
Line 467: | Line 467: | ||
| 13 || RST || Reset | | 13 || RST || Reset | ||
|- | |- | ||
− | | 15 || LCD_RS || Command/data register selection,low level select command, high level select data. | + | | 15 || LCD_RS || Command/data register selection, low-level select command, high-level select data. |
|- | |- | ||
| 16 || KEY2 || button | | 16 || KEY2 || button | ||
Line 487: | Line 487: | ||
= '''Resource''' = | = '''Resource''' = | ||
===User Manual=== | ===User Manual=== | ||
− | *[https:// | + | *[https://files.waveshare.com/upload/1/1e/RPi_LCD_User_Manual_EN.pdf RPi LCD User Manual] |
=== Image === | === Image === | ||
− | Description: if you felt hard to install driver, try the image with driver pre-installed. | + | Description: if you felt hard to install the driver, try the image with the driver pre-installed. |
*[https://drive.google.com/open?id=1ivEM3ZQ3llaqS_P0zfDpHyhu58OTyDji RPi-2.8inch_32inch-LCD-Raspbian-180326.img.7z] | *[https://drive.google.com/open?id=1ivEM3ZQ3llaqS_P0zfDpHyhu58OTyDji RPi-2.8inch_32inch-LCD-Raspbian-180326.img.7z] | ||
<!-- | <!-- | ||
Line 498: | Line 498: | ||
{{RPI LCD DRIVER}} | {{RPI LCD DRIVER}} | ||
=== Software === | === Software === | ||
− | * [ | + | * [https://files.waveshare.com/upload/d/d7/Panasonic_SDFormatter.zip Panasonic SDFormatter] |
− | * [ | + | * [https://files.waveshare.com/upload/7/76/Win32DiskImager.zip Win32DiskImager] |
− | * [ | + | * [https://files.waveshare.com/upload/5/56/Putty.zip PuTTY] |
=== LCD Panel Dimension === | === LCD Panel Dimension === | ||
* [http://www.waveshare.com/wiki/File:3.2inch-rpi-lcd-b-panel-dimension.pdf 3.2inch RPi LCD (B) panel dimension] | * [http://www.waveshare.com/wiki/File:3.2inch-rpi-lcd-b-panel-dimension.pdf 3.2inch RPi LCD (B) panel dimension] | ||
Line 507: | Line 507: | ||
= '''FAQ''' = | = '''FAQ''' = | ||
{{RPI HDMI GPIO LCD FAQ}} | {{RPI HDMI GPIO LCD FAQ}} | ||
− | + | ='''Support'''= | |
− | {{ | + | {{Servicebox1}} |
[[Category:OLEDs / LCDs|OLEDs / LCDs]] [[Category:Raspberry Pi|Raspberry Pi]] [[Category:Raspberry Pi LCD|Raspberry Pi LCD]] | [[Category:OLEDs / LCDs|OLEDs / LCDs]] [[Category:Raspberry Pi|Raspberry Pi]] [[Category:Raspberry Pi LCD|Raspberry Pi LCD]] | ||
</div> | </div> |
Latest revision as of 06:49, 4 September 2023
| ||
Overview
Introduction
3.2-inch Resistive Touch Screen TFT LCD is designed for Raspberry Pi and provides Raspbian IMG.
More |
Features
- The hardware resolution is 320 × 240.
- Resistive touch control.
- It is compatible and can be directly inserted into any version of Raspberry Pi.
- Drivers provided (works with your own Raspbian/Ubuntu/Kali and Retropie system directly).
- Support FBCP software driver, can set the software resolution and dual-screen display.
- Gold sinking process, fine carving.
Getting Started
Hardware Connection
- There are 40 pins on Raspberry Pi, but there are 26 pins on the LCD, so you should pay attention to connecting the pins to your Pi accordingly.
Install the touch driver
The RPi LCD can be driven in two ways: Method 1. Install the driver to your Raspbian OS. Method 2. Use the Ready-to-use image file of which the LCD driver was pre-installed.
Method 1. Driver installation
Please download the latest version of the image on the Raspberry Pi official website. (Raspbian/Ubuntu Mate/Kali or Retropie)
1) Download the compressed image file to the PC, and unzip it to get the .img file.
2) Connect the TF card to the PC, open the Win32DiskImager software, select the system image downloaded in step 1, and click 'Write' to write the system image. (How to write an image to a micro SD card for your Pi? See RPi Image Installation Guides for more details.)
3) Connect the TF card to the Raspberry Pi, and start the Raspberry Pi. The LCD will display after booting up, and then log in to the Raspberry Pi terminal,(You may need to connect a keyboard and HDMI LCD to Pi for driver installation, or log in remotely with SSH).
4) Then open the terminal of Raspberry Pi to install the touch driver.
git clone https://github.com/waveshare/LCD-show.git cd LCD-show/
Note: The Raspberry Pi must be connected to the network, or else the touch driver won't be successfully installed.
chmod +x LCD32-show ./LCD32-show
The touch function will work after restart. For ease of use, you can set the screen orientation, see: #Screen orientation settings.
Notes:
- 1. Executing apt-get upgrade will cause the LCD to fail to work properly. In this case, you need to edit the config.txt file in the SD card and delete this sentence: dtoverlay=ads7846.
- 2. Using Raspbian-lite, the command of the touch driver installation should be:
./LCD32-show lite
Method 2. Using Ready-to-use image
The image file with the pre-installed driver is located in the IMAGE directory of the CD, or you can download it from #Image. Extract the .7z file and you will get an .img file. Write the image to your micro SD card (How to write an image to a micro SD card for your Pi? See RPi Image Installation Guides for more details). Then insert the card into your Pi, power up, and enjoy it.
Screen orientation settings
After installing the touch driver, you can modify the screen rotation direction by running the following commands.
cd LCD-show/ #X can be 0, 90, 180, and 270. Indicates that the LCD rotates 0 degrees, 90 degrees, 180 degrees, and 270 degrees, respectively. #If it is an old version, execute the following code: sudo ./LCD28-show X #If it is a new version, execute the following code: sudo ./LCD28-show-V2 X
The rotation command under Raspbian-lite is as follows:
cd LCD-show/ #X can be 0, 90, 180, and 270. Indicates that the LCD rotates 0 degrees, 90 degrees, 180 degrees, and 270 degrees, respectively. #If it is an old version, execute the following code: sudo ./LCD28-show lite X #If it is a new version, execute the following code: sudo ./LCD28-show-V2 lite X
Touch screen calibration
This LCD can be calibrated through the xinput-calibrator program. Note: The Raspberry Pi must be connected to the network, or else the program won't be successfully installed.
- Run the following command to install:
sudo apt-get install xinput-calibrator
- Click the "Menu" button on the taskbar, choose "Preference" -> "Calibrate Touchscreen".
- Finish the touch calibration following the prompts. Maybe rebooting is required to make calibration active.
- You can create a 99-calibration.conf file to save the touch parameters (not necessary if the file exists).
sudo nano /etc/X11/xorg.conf.d/99-calibration.conf
- Save the touch parameters (may differ depending on LCD) to 99-calibration.conf, as shown in the picture:
Install Virtual Keyboard
1. Install matchbox-keyboard.
sudo apt-get install update sudo apt-get install matchbox-keyboard sudo nano /usr/bin/toggle-matchbox-keyboard.sh
2. Copy the statements below to toggle-matchbox-keyboard.sh and save.
#!/bin/bash #This script toggle the virtual keyboard PID=`pidof matchbox-keyboard` if [ ! -e $PID ]; then killall matchbox-keyboard else matchbox-keyboard -s 50 extended& fi
3. Execute the commands:
sudo chmod +x /usr/bin/toggle-matchbox-keyboard.sh sudo mkdir /usr/local/share/applications sudo nano /usr/local/share/applications/toggle-matchbox-keyboard.desktop
4. Copy the statements to toggle-matchbox-keyboard.desktop and save.
[Desktop Entry] Name=Toggle Matchbox Keyboard Comment=Toggle Matchbox Keyboard` Exec=toggle-matchbox-keyboard.sh Type=Application Icon=matchbox-keyboard.png Categories=Panel;Utility;MB X-MB-INPUT-MECHANSIM=True
5. Execute commands as below. Note that you need to use "Pi " user permission instead of root to execute this command.
sudo nano /etc/xdg/lxpanel/LXDE-pi/panels/panel
6. Find the statement which is similar to below: (It may be different in different versions.)
Plugin { type = launchbar Config { Button { id=lxde-screenlock.desktop } Button { id=lxde-logout.desktop } }
7. Append these statements to add a button option:
Button { id=/usr/local/share/applications/toggle-matchbox-keyboard.desktop }
8. Reboot your Raspberry Pi. If the virtual keyboard is installed correctly, you can find that there is a keyboard icon on the left of the bar.
sudo reboot
Interface
PIN NO. | SYMBOL | DESCRIPTION |
---|---|---|
1, 17 | 3.3V | Power positive (3.3V power input) |
2, 4 | 5V | Power positive (5V power input) |
3, 5, 7, 8, 10, 22 | NC | NC |
6, 9, 14, 20, 25 | GND | Ground |
11 | TP_IRQ | Touch Panel interrupt, low level while the Touch Panel detects touching |
12 | KEY1 | button |
13 | RST | Reset |
15 | LCD_RS | Command/data register selection, low-level select command, high-level select data. |
16 | KEY2 | button |
18 | KEY3 | button |
19 | LCD_SI / TP_SI | LCD display/SPI data input of Touch Panel |
21 | TP_SO | SPI data output of Touch Panel |
23 | LCD_SCK / TP_SCK | LCD display/SPI clock of Touch Panel |
24 | LCD_CS | LCD chip selection, low active |
26 | TP_CS | Touch Panel chip selection, low active |
Resource
User Manual
Image
Description: if you felt hard to install the driver, try the image with the driver pre-installed.
Driver
The driver can be downloaded from github
git clone https://github.com/waveshare/LCD-show.git
Software
LCD Panel Dimension
FAQ
{{{5}}}
- Make sure the hardware connection is correct and the contact is good.
- Make sure that TF card programming is normal.
- When the Raspberry Pi starts normally, the PWR light is always on, and the ACT light is flashing. If it is found that both lights are always on, it may be that the TF card is not successfully programmed to the image or the TF card is in poor contact with the Raspberry Pi.
- It is recommended to use a 5V 2.5A power adapter for the Raspberry Pi. If the Raspberry Pi is powered by the USB port of the PC, the Raspberry Pi may not be able to start normally due to an insufficient power supply.
{{{5}}}
{{{5}}}
{{{5}}}
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 AM GMT+8 (Monday to Friday)