13.3inch DSI LCD

来自Waveshare Wiki
跳转至: 导航搜索

产品特性

  • 13.3英寸DSI触控屏,支持十点电容触摸控制
  • IPS显示面板,硬件分辨率为1920×1080
  • 配备6H硬度的钢化玻璃触控盖板
  • 兼容Raspberry Pi 5/4B/CM4/3B+/3A+/3B/CM3+/CM3
  • 通过Raspberry Pi的DSI接口直接驱动LCD
  • 配合Raspberry Pi使用时,兼容Bookworm系统
  • 支持软件调节背光亮度

视频教程

硬件连接

搭配Raspberry Pi 5使用

1.使用22PIN FFC排线,将显示屏的DSI接口连接到树莓派主板的22PIN DSI1接口。
2.使用3PIN杜邦线,将显示屏的POWER接口连接到树莓派主板的5V 5V GND引脚。(红色代表5V,黑色代表GND)
3.使用M2.5螺丝将树莓派固定到显示屏背板上的螺母。

安装效果如下:
13.3inch-DSI-LCD-details-3.jpg

注意:请确保 FFC 线方向连接无误,并通过杜邦线提供 5V 电源。

搭配Raspberry Pi4B/3B+/3B/3A+使用

1.使用"MIPI-DSI-Cable-12cm",将显示屏的DSI接口连接到树莓派主板的DSI接口。
2.使用3PIN杜邦线,将显示屏的POWER接口连接到树莓派主板的5V 5V GND引脚。(红色代表5V,黑色代表GND)
3.使用M2.5螺丝将树莓派固定到显示屏背板上的螺母。

安装效果如下:
13.3inch-DSI-LCD-details-4 (1).jpg

注意:请确保 FPC 线方向连接无误,并通过杜邦线提供 5V 电源。

搭配CM5/CM4/CM3使用

1.使用22PIN FFC排线,将显示屏的DSI接口连接到树莓派主板的22PIN DSI1接口。
2.使用3PIN杜邦线,将显示屏的POWER接口连接到树莓派主板的5V 5V GND引脚。(红色代表5V,黑色代表GND)

安装效果如下:
13.3inch-DSI-LCD-details-5.jpg

注意:请确保 FFC 线方向连接无误,并通过杜邦线提供 5V 电源。

软件设置

用于Trixie和Bookworm系统

方法一: 手动安装驱动(推荐)

Raspberry Pi Imager burning.gif

  • 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,13_3_inch_2lane
#DSI0 Use
#dtoverlay=vc4-kms-dsi-waveshare-panel,13_3_inch_2lane,dsi0
  • 3. 将TF卡插入树莓派,给树莓派上电,正常等待几秒后可以进入显示,系统启动后可以正常触摸。

方法二:烧写预安装镜像

1.选择您对应的树莓派版本镜像,下载并解压为.img文件
树莓派5版本下载:13.3inch DSI LCD - Pi5预安装镜像
树莓派4B/CM4/3B+/CM3版本下载:13.3inch DSI LCD - Pi4预安装镜像
2.烧写完成后,将TF卡接入到树莓派上,并启动树莓派,等待30秒左右即可正常显示和触摸。

调节背光亮度

图形界面调光

以下步骤以Trixie系统为例:

  • 1.点击左上角菜单,依次进入 Preferences → Control Center,选择 Screens;

8inch dsi lcd -1.png

  • 2.进入"Screen"->"DSI-2"->"Brightness" ,勾选并调整所需的背光亮度,最后点击 Apply 保存设置。。

8inch dsi lcd -2.png

在Bookworm系统中,该设置入口位于 Screen Configuration → Screen。

使用微雪背光调节应用程序

您也可以使用微雪提供的图形化背光调节工具(该程序仅用于Trixie,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 打开该程序,如下图:

43H-800480-IPS-CT-details-13.gif

使用终端调节背光亮度

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

Trixie/Bookworm显示旋转

GUI 界面旋转
以下步骤以Trixie系统为例:

  • 1.点击左上角菜单,依次进入 Preferences → Control Center,选择 Screens

8inch dsi lcd -5.png

  • 2.进入"Screen"->"DSI-1"->"Touchscreen" ,勾选"10-0014 Goodix Capacitive TouchScreen"

8inch dsi lcd -6.png

  • 3:进入"Screen"->"DSI-2"->"Orientation" ,勾选您需要旋转的方向,最后点击"Apply"即可完成显示和触摸同步旋转。

8inch dsi lcd -7.png

  • 在Bookworm系统中,该设置入口位于 Screen Configuration → Screen。
注意:仅在Trixie/Bookworm系统系统支持以上同步旋转方法。对于Bullseye/Butser系统,显示旋转后,需手动单独设置触摸旋转。

lite版本显示旋转

sudo nano /boot/firmware/cmdline.txt
#在cmdline.txt文件开头添加对应显示旋转角度的指令,保存重启后生效
#显示旋转90度
video=DSI-1:1920x1080e,rotate=90
#显示旋转180度
video=DSI-1:1920x1080e,rotate=180
#显示旋转270度
video=DSI-1:1920x1080e,rotate=270

注意:如果是使用Pi5/CM5/CM4,以实际识别到的DSI显示器编号为准,例如DSI-2。

触摸旋转

sudo nano /etc/udev/rules.d/99-waveshare-touch.rules

#在文件内设定触摸旋转角度的指令,重启后生效
#90°:
ENV{ID_INPUT_TOUCHSCREEN}=="1", ENV{LIBINPUT_CALIBRATION_MATRIX}="0 -1 1 1 0 0"

#180°:
#ENV{ID_INPUT_TOUCHSCREEN}=="1", ENV{LIBINPUT_CALIBRATION_MATRIX}="-1 0 1 0 -1 1"

#270°:
#ENV{ID_INPUT_TOUCHSCREEN}=="1", ENV{LIBINPUT_CALIBRATION_MATRIX}="0 1 0 -1 0 1"

#保存退出并重启
sudo reboot

触摸模式选择

Bookworm系统支持两种触控模式,可在 Screen Configuration > Touchscreen 菜单中切换:
DSI-Touch-Bookworm-Keyboard-03.png

  • 1.Mouse Emulation(默认)
单击 = 鼠标左键功能
长按 = 鼠标右键功能
支持双击
不支持滑动页面和多点触摸功能

注:此模式适合需要鼠标操作的场景,如双击打开文件管理器,长按实现右键功能。

  • 2.Multitouch
支持多点触摸功能
支持滑动页面
不支持双击和长按右键功能

注:此模式适合触控优化场景,如网页浏览、滚动列表。

关闭/开启屏幕

在树莓派终端运行以下指令,屏幕即可进入关闭状态:

wlr-randr --output DSI-2 --off
# DSI-2需修改为实际使用的显示器,例如"DSI-1"或"HDMI-A-1"

在树莓派终端运行以下指令,屏幕即可进入开启状态:

wlr-randr --output DSI-2 --on
# DSI-2需修改为实际使用的显示器,例如"DSI-1"或"HDMI-A-1"

注:该指令仅适用于 Labwc 和 Wayfire 图形界面,不适用于 X11 图形界面。

屏幕休眠

在树莓派终端运行以下指令,屏幕即可进入休眠状态:

xset dpms force off

注:该指令仅适用于 X11 图形界面,不适用于 Labwc 和 Wayfire 图形界面。

禁用触摸

在config.txt文件最后,加入以下对应禁用触摸的命令(config文件位于TF卡根目录,也可以通过命令访问:sudo nano /boot/config.txt):

disable_touchscreen=1

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

资料

FAQ

将自定义图片替换此目录的图片即可 /usr/share/plymouth/themes/pix/splash.png


售后

联系人:梁工
电话:0755-83043099
微信:扫下方二维码添加
Ljh.png

说明:进行售后服务前,请准备好客户信息(定货单位、定货人等),以供验证