Google Chat: zj734465502@gmail.com
+86-0755-88291180
sales01@spotpear.com
dragon_manager@163.com
services01@spotpear.com
manager01@spotpear.com
WhatsApp:13246739196
Use a 15PIN FPC cable to connect the 2.8inch DSI LCD to the DSI interface of the Raspberry Pi.
#Step 1: Download and enter the Waveshare-DSI-LCD driver folder
git clone https://github.com/waveshare/Waveshare-DSI-LCD
cd Waveshare-DSI-LCD
#Step 2: Enter uname -a in the terminal to view the kernel version and cd to the corresponding file directory
#6.1.21 then run the following command
cd 6.1.21
#Step 3: Please check the bits of your system, enter the 32 directory for 32-bit systems, and enter the 64 directory for 64-bit systems
cd 32
#cd 64
#Step 4: Enter your corresponding model command to install the driver, pay attention to the selection of the I2C DIP switch
#2.8inch DSI LCD 480×640 Driver:
sudo bash ./WS_xinchDSI_MAIN.sh 28 I2C0
#Step 5: Wait for a few seconds, when the driver installation is complete and no error is prompted, restart and load the DSI driver and it can be used normally
sudo reboot
Note: The above steps need to ensure that the Raspberry Pi can be connected to the Internet normally.
5. Wait for the system to restart, it will be able to display and touch normally.
1. Select your corresponding Raspberry Pi version image, download and decompress it as a ".img" file.
Raspberry Pi 4B/CM4 version download: Waveshare DSI LCD - Pi4 pre-install image
Raspberry Pi 3B/3B+/CM3 version download: Waveshare DSI LCD - Pi3 pre-install image
2. Connect the TF card to the PC and use SDFormatter to format the TF card.
3. Open Win32DiskImager software, choose the system image prepared in the first step, and then click "write" to write the system image.
4. After the programming is finished, open the config.txt file in the root directory of the TF card, add the following code under [all], save, and eject the TF card safely.
dtoverlay=WS_xinchDSI_Screen,SCREEN_type=0,I2C_bus=10
dtoverlay=WS_xinchDSI_Touch,invertedy,swappedxy,I2C_bus=10
5. Connect the TF card to the Raspberry Pi, and start the Raspberry Pi, wait for about 30 seconds to display and touch normally.
In the start menu, select: Preferences -> Screen Configuration -> Configure -> Screens -> DSI-1 -> Orientation, select the corresponding angle in it, click "√", select Yes, and restart.
sudo nano /boot/cmdline.txt #Add a command to display the rotation angle at the beginning of the cmdline.txt file, save and reboot to take effect #Display rotates 90 degrees video=DSI-1:480x640e,rotate=90 #Display rotates 180 degrees video=DSI-1:480x640e,rotate=180 #Display rotates 270 degrees video=DSI-1:480x640e,rotate=270
sudo nano /boot/config.txt #Modify the instruction of the touch rotation angle at the end of the config.txt file, and it will take effect after restarting (there is a 0° touch direction instruction by default) #90°: dtoverlay=WS_xinchDSI_Touch #180°: dtoverlay=WS_xinchDSI_Touch,swappedxy,invertedx #270°: dtoverlay=WS_xinchDSI_Touch,invertedx,invertedy #0°: dtoverlay=WS_xinchDSI_Touch,invertedy,swappedxy
Using the application provided by Waveshare:
cd Waveshare-DSI-LCD # Determine the currently used kernel version, such as the 5.15.61 kernel, and run the following command cd 5.15.61 #Check the bits of the system, the 32-bit system enters 32 directory, and the 64-bit system enters 64 directory cd 32 #cd 64 cd Backlight sudo ./install.sh
After the installation is complete, you can open the program in the Start menu - > Accessories - > Brightness, as shown below:
To adjust the system command of the lite version, after entering the root privilege, execute the following command on the Raspberry Pi terminal:
echo X > /sys/waveshare/rpi_backlight/brightness
(X value in the range of 0~255.)
For example:
sudo su root echo 100 > /sys/waveshare/rpi_backlight/brightness
1. Update the system, such as executing the following command:
sudo apt-get update sudo apt-get full-upgrade
After updating the system, some files of the originally installed driver may be overwritten, and the driver needs to be reinstalled to display normally.
2. Replace the motherboard:
If the driver is originally installed on the Raspberry Pi 4 Model B, the user replaces the motherboard, such as modifying it to a Raspberry Pi 3 Model B+, and the display will not display properly.
Because Pi4 and Pi3 need to load different driver files, you need to reinstall the driver on the new motherboard to display properly.