320 脳 240, 2.8inch Resistive Touch Screen TFT LCD, designed for Raspberry Pi.
MoreAbout RevisionThe 2.8inch RPi LCD (A) was updated to Rev2.1 because of the shortages of controllers. In terms of appearance, LCD size is no different, but the software needs to be updated, Rev2.1 version to add a backlight PWM control function (the latest driver is required).Users can judge the old and new versions by the silkscreen on the back of the module. If the back side of the screen print has Rev2.1, then it is the new version.Features320 脳 240 hardware resolution, support touch function.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.As big as your Raspberry Pi.Immersion gold with detailed design.Getting StartedHardware ConnectionThere 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 driverThe RPi LCD can be driven in two ways: Method 1. Install a 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.gitcd LCD-show/Note: The Raspberry Pi must be connected to the network, or else the touch driver won't be successfully installed.
chmod +x LCD28-showIf it is an old version, execute the following code:sudo ./LCD28-showIf it is a new version, execute the following code:sudo ./LCD28-show-V2The 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: ./LCD28-show liteMethod 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 settingsAfter 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 XThe 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 XTouch screen calibrationThis 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.confSave the touch parameters (may differ depending on LCD) to 99-calibration.conf, as shown in the picture:2.8inch RPi LCD (A) - Rev2.1 PWM backlight adjustment functionFor Pi4, you need to update the wiringPi version first. The operation method is as follows (for 3B+ and earlier versions, there is no need to update):
wget https://project-downloads.drogon.net/wiringpi-latest.debsudo dpkg -i wiringpi-latest.debgpio -v# Run gpio -v and version 2.52 will appear. If it does not appear, the installation is wrongAfter the wiringPi is updated successfully, the backlight brightness can be controlled by the following commands.
gpio -g mode 18 pwm #Occupied pins are PWM pinsgpio pwmc 100gpio -g pwm 18 0 #the darkestgpio -g pwm 18 1023 #brightestgpio -g mode 18 out #Release as outputInstall Virtual Keyboard1. Install matchbox-keyboard:
sudo apt-get install updatesudo apt-get install matchbox-keyboardsudo nano /usr/bin/toggle-matchbox-keyboard.sh2. Copy the statements below to toggle-matchbox-keyboard.sh and save.
#!/bin/bash#This script toggle the virtual keyboardPID=`pidof matchbox-keyboard`if [ ! -e $PID ]; thenkillall matchbox-keyboardelsematchbox-keyboard -s 50 extended&fi3. Execute the commands:
sudo chmod +x /usr/bin/toggle-matchbox-keyboard.shsudo mkdir /usr/local/share/applicationssudo nano /usr/local/share/applications/toggle-matchbox-keyboard.desktop4. Copy the statements to toggle-matchbox-keyboard. desktop and save:
[Desktop Entry]Name=Toggle Matchbox KeyboardComment=Toggle Matchbox Keyboard`Exec=toggle-matchbox-keyboard.shType=ApplicationIcon=matchbox-keyboard.pngCategories=Panel;Utility;MBX-MB-INPUT-MECHANSIM=True5. 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/panel6. Find the statement which is similar to the one below: (It may be different in different versions.)
Plugin {type = launchbarConfig {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 rebootInterfacePIN NO.SYMBOLDESCRIPTION1, 173.3VPower positive (3.3V power input)2, 45VPower positive (5V power input)3, 5, 8, 10NCNC6, 9, 14, 20, 25GNDGround7KEY1Button (Rev2.1)NCNC (old version)11TP_IRQTouch Panel interrupt, low level while the Touch Panel detects touching12PWMBrightness control pin (Rev2.1)KEY1Button (Old version)13RSTReset15LCD_RSLCD command control, Command/data register selection16KEY2button18KEY3button19LCD_SI / TP_SILCD display/SPI data input of Touch Panel21TP_SOSPI data output of Touch Panel22KEY4button23LCD_SCK / TP_SCKLCD display/SPI clock of Touch Panel24LCD_CSLCD chip selection, low active26TP_CSTouch Panel chip selection, low active