使用说明
搭配Raspberry Pi 5使用
1.使用22PIN FFC排线，将显示屏的DSI接口连接到树莓派主板的22PIN DSI1接口。
2.使用3PIN杜邦线，将显示屏的POWER接口连接到树莓派主板的5V 5V GND引脚。（红色代表5V，黑色代表GND）
3.使用M2.5螺丝将树莓派固定到显示屏背板上的螺母。
安装效果如下：
注意：请确保 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螺丝将树莓派固定到显示屏背板上的螺母。
安装效果如下：
-f0dbf22dcf0944935bd6e2592208fe83.webp)
注意：请确保 FPC 线方向连接无误，并通过杜邦线提供 5V 电源。
搭配CM5/CM4/CM3使用
1.使用22PIN FFC排线，将显示屏的DSI接口连接到树莓派主板的22PIN DSI1接口。
2.使用3PIN杜邦线，将显示屏的POWER接口连接到树莓派主板的5V 5V GND引脚。（红色代表5V，黑色代表GND）
安装效果如下：
注意：请确保 FFC 线方向连接无误，并通过杜邦线提供 5V 电源。
软件设置
用于Trixie和Bookworm系统
方法一： 手动安装驱动（推荐）
- 1. 将TF卡连接到PC，下载并使用Raspberry Pi Imager进行烧录对应系统镜像。
- 2. 镜像烧写完成后，打开TF卡根目录的config.txt文件，在config.txt最后加入以下代码，保存并安全弹出TF卡。
根据不同的 Raspberry Pi 型号，推荐的 DSI lane 设置如下：
Raspberry Pi 3 / 4
dtoverlay=vc4-kms-v3d
dtoverlay=vc4-kms-dsi-waveshare-panel,13_3_inch_2lane
Raspberry Pi 5 / CM3/3+/4/5
dtoverlay=vc4-kms-v3d
#DSI1 Use
dtoverlay=vc4-kms-dsi-waveshare-panel,13_3_inch_4lane
#DSI0 Use
#dtoverlay=vc4-kms-dsi-waveshare-panel,13_3_inch_4lane,dsi0
注意：由于Pi5/CM4/CM3+/CM3具有两个mipi DSI接口，请注意使用正确的DSI接口和指令，默认推荐使用DSI1。
- 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；
- 2.进入"Screen"->"DSI-2"->"Brightness" ，勾选并调整所需的背光亮度，最后点击 Apply 保存设置。。
在Bookworm系统中，该设置入口位于 Screen Configuration → Screen。
使用微雪背光调节应用程序
您也可以使用微雪提供的图形化背光调节工具：
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
Trixie/Bookworm显示旋转
GUI 界面旋转
以下步骤以Trixie系统为例：
- 1.点击左上角菜单，依次进入 Preferences → Control Center，选择 Screens
- 2.进入"Screen"->"DSI-1"->"Touchscreen" ，勾选"10-0014 Goodix Capacitive TouchScreen"
- 3：进入"Screen"->"DSI-2"->"Orientation" ，勾选您需要旋转的方向，最后点击"Apply"即可完成显示和触摸同步旋转。
- 在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 菜单中切换：
-
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
注：添加指令后需重启生效。