树莓派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=10

5.将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

注:添加指令后需重启生效。

资料

3D图纸