树莓派2.8inch DSI LCD 教程
产品特性
- 2.8英寸DSI触控屏，电容式五点触摸控制
- IPS显示面板，硬件分辨率为480×640
- 采用全贴合工艺，画质更清晰
- 钢化玻璃触摸盖板，硬度可达6H
- 支持Pi5/4B/CM4/3B+/3A+/3B/CM3+/CM3
- 直接通过Raspberry Pi的DSI接口驱动LCD，刷新率可达60Hz
- 配合Raspberry Pi使用时，支持Bookworm/Bullseye/Buster使用
- 支持通过软件控制背光亮度
硬件连接
搭配Pi 4B/3B+/3B/3A+使用
使用15PIN的FPC排线，将显示屏DSI接口连接到树莓派主板的DSI接口。
安装效果如下：
搭配Pi5/CM4/CM3+/CM3使用
使用“DSI-Cable-12cm”排线，将显示屏DSI接口连接到树莓派主板的22PIN DSI1接口。
安装效果如下：
软件设置
用于Bookworm和Bullseye系统
- 1. 将TF卡连接到PC，下载并使用Raspberry Pi Imager进行烧录对应系统镜像。
- 2. 镜像烧写完成后，打开TF卡根目录的config.txt文件，在config.txt最后加入以下代码，保存并安全弹出TF卡。
注意：由于Pi5/CM4/CM3+/CM3具有两个mipi DSI接口，请注意使用正确的DSI接口和指令，默认推荐使用DSI1。
dtoverlay=vc4-kms-v3d
#DSI1 Use
dtoverlay=vc4-kms-dsi-waveshare-panel,2_8_inch
#DSI0 Use
#dtoverlay=vc4-kms-dsi-waveshare-panel,2_8_inch,dsi0- 3. 将TF卡插入树莓派，给树莓派上电，正常等待几秒后可以进入显示，系统启动后可以正常触摸。
用于Buster系统
方法一：手动安装驱动
1. 在树莓派官网下载最新版本的镜像，将压缩文件下载到PC上，并解压得到.img文件。
2. TF卡连接到PC，使用SDFormatter软件格式化TF卡。
3. 打开Win32DiskImager软件，选择第1步准备的系统镜像，点击write烧写系统镜像。
4. 烧写完成后，将TF卡接入到树莓派上，并启动树莓派，登录树莓派的终端（可以将树莓派接到HDMI显示器或用ssh远程登录）。
#第一步：下载并进入Waveshare-DSI-LCD驱动文件夹 git clone https://github.com/waveshare/Waveshare-DSI-LCD cd Waveshare-DSI-LCD
#第二步：终端输入uname -a查看内核版本，并cd到对应文件目录 #6.1.21则运行下面指令 cd 6.1.21
#第三步：请确定当前使用的系统是多少位的，32位系统进入32目录，64位系统进入64目录 cd 32 #cd 64
#第四步：输入您对应的型号指令进行安装驱动，注意I2C拨码开关的选择 #2.8inch DSI LCD 480×640驱动： sudo bash ./WS_xinchDSI_MAIN.sh 28 I2C0
#第五步：等待几秒，当驱动安装完成，没有提示任何报错时，进行重启加载DSI驱动即可正常使用 sudo reboot #注意：以上步骤需要确保树莓派可以正常连接到互联网。
5.等待系统重启，将可以正常显示和触摸。
方法二：烧写预安装镜像
1.选择您对应的树莓派版本镜像，下载并解压为.img文件
树莓派4B/CM4版本下载：Waveshare DSI LCD - Pi4预安装镜像
树莓派3B/3B+/CM3版本下载：Waveshare DSI LCD - Pi3预安装镜像
2.TF卡连接到PC，使用SDFormatter软件格式化TF卡。
3.打开Win32DiskImager软件，选择第1步准备的系统镜像，点击write烧写系统镜像。
4.烧写完成后，打开TF卡根目录的config.txt文件，在[all]下方加入以下代码，保存并安全弹出TF卡。
dtoverlay=WS_xinchDSI_Screen,SCREEN_type=0,I2C_bus=10
dtoverlay=WS_xinchDSI_Touch,invertedy,swappedxy,I2C_bus=105.将TF卡接入到树莓派上，并启动树莓派，等待30秒左右即可正常显示和触摸。
Buster系统注意事项
1. 更新系统，如执行以下命令
sudo apt-get update sudo apt-get full-upgrade
注意：在更新完系统后，原本安装的驱动有些文件可能会被覆盖掉，需要重新安装驱动才可以正常显示。
2. 更换主板
如果原来在Raspberry Pi 4 Model B上安装的驱动，用户更换主板，如修改成Raspberry Pi 3 Model B+，会导致显示屏无法正常显示。
因为Pi4和Pi3需要加载不同的驱动文件，需在新的主板上按照#用于Buster系统重新安装驱动才可以正常显示。
软件调光
微雪提供了对应的应用程序(该程序仅用于Bookworm和Bullseye系统)，用户可以通过以下方式下载安装使用：
wget https://www.waveshare.net/w/upload/f/f4/Brightness.zip unzip Brightness.zip cd Brightness sudo chmod +x install.sh ./install.sh
安装完成后，可以在开始菜单-》Accessories -》Brightness 打开该程序，如下图：
另外，也在终端输入以下命令可以控制背光亮度：
echo X | sudo tee /sys/class/backlight/*/brightness
其中X表示0~255中的任意数字。0表示背光最暗，255表示背光最亮。例如：
echo 100 | sudo tee /sys/class/backlight/*/brightness echo 0 | sudo tee /sys/class/backlight/*/brightness echo 255 | sudo tee /sys/class/backlight/*/brightness
Bookworm触摸屏旋转
- 1.打开"Screen Configuration"应用程序；
- 2.进入"Screen"->"DSI-1"->"Touchscreen"，勾选"10-0014 Goodix Capacitive TouchScreen"
- 3.点击"Apply"，然后关闭当前窗口，根据弹窗提示进行Reboot，即可完成指定触摸屏；
- 4.进入"Screen"->"DSI-1"->"Orientation" ，勾选您需要旋转的方向，最后点击"Apply"即可完成显示和触摸同步旋转。
注意：仅Bookworm系统支持以上同步旋转方法。对于Bullseye和Butser系统，显示旋转后，需手动单独设置触摸旋转。
Bullseye/Buster显示旋转
- 1.打开"Screen Configuration"应用程序；
- 2.进入"Screen"->"DS-1"->"Orientation" ，勾选您需要旋转的方向，最后点击"Apply"，即可完成显示旋转。
Bullseye/Buster触摸旋转
sudo nano /boot/config.txt #在config.txt文件末端修改触摸旋转角度的指令，重启后生效（默认存在0°触摸方向的指令） #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
lite版本显示旋转
sudo nano /boot/cmdline.txt #在cmdline.txt文件开头添加对应显示旋转角度的指令，保存重启后生效 #显示旋转90度 video=DSI-1:480x640e,rotate=90 #显示旋转180度 video=DSI-1:480x640e,rotate=180 #显示旋转270度 video=DSI-1:480x640e,rotate=270
屏幕休眠
在树莓派终端运行以下指令，屏幕即可进入休眠状态：
xset dpms force off
禁用触摸
在config.txt文件最后，加入以下对应禁用触摸的命令（config文件位于TF卡根目录，也可以通过命令访问：sudo nano /boot/config.txt）：
disable_touchscreen=1
注：添加指令后需重启生效。
