使用说明
搭配Pi 5/CM5/CM4/CM3+/CM3使用使用
- 使用DSI-Cable-12cm线材，将4.3inch DSI LCD连接到Raspberry Pi主板的22PIN DSI1接口。
- 为了方便安装，可将 Raspberry Pi 5 固定在 4.3inch DSI LCD 背面。
在组装时，请在屏幕与主板之间垫上配件包内的短铜柱，再用螺丝固定，如下图所示：
搭配Pi 4B/3B+/3A+/3B/2B/B+/A+使用
- 使用FFC线，将4.3inch DSI LCD连接到Raspberry Pi主板的15PIN DSI接口。
- 为了方便使用，可以把Raspberry Pi主板通过螺丝固定的4.3inch DSI LCD的背面，并组装上铜柱。
在组装时，请在屏幕与主板之间垫上配件包内的短铜柱，再用螺丝固定，如下图所示：
软件设置
用于Trixie和Bookworm系统
用于树莓派的Raspberry Pi OS / Ubuntu / Kali / Volumio 和 Retropie系统。
- 1. 将TF卡连接到PC，下载并使用Raspberry Pi Imager进行烧录对应系统镜像。
-
2. 镜像烧写完成后，打开TF卡根目录的config.txt文件，在config.txt最后加入以下代码，保存并安全弹出TF卡。
dtoverlay=vc4-kms-v3d#DSI1 Usedtoverlay=vc4-kms-dsi-7inch#DSI0 Use#dtoverlay=vc4-kms-dsi-7inch,dsi0 -
3. 将TF卡插入树莓派，给树莓派上电，正常等待几秒后可以进入显示，系统启动后可以正常触摸。
#更新系统sudo apt-get updatesudo apt-get full-upgrade -y#重启系统sudo reboot
调节背光亮度
图形界面调光
以下步骤以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版本显示旋转
-
1.需要修改/boot/cmdline.txt文件：
sudo nano /boot/cmdline.txt -
2.在cmdline.txt文件开头，添加对应显示旋转角度的指令：（请注意，该命令需要放在同一行上，每个命令用空格分隔。）
video=DSI-1:800x480M@60,rotate=90
通过将rotate值更改为 90、180 或 270 来更改显示旋转的角度。
-
3.保存并重新启动
sudo reboot
Bullseye/Buster显示旋转
GUI 界面旋转
- 1.打开"Screen Configuration"应用程序；
- 2.进入"Screen"->"DSI-1"->"Orientation" ，勾选您需要旋转的方向，最后点击"Apply"，即可完成显示旋转。
lite版本显示旋转
-
1.需要修改/boot/cmdline.txt文件：
sudo nano /boot/cmdline.txt -
2.在cmdline.txt文件开头，添加对应显示旋转角度的指令：（请注意，该命令需要放在同一行上，每个命令用空格分隔。）
video=DSI-1:800x480M@60,rotate=90
通过将rotate值更改为 90、180 或 270 来更改显示旋转的角度。
-
3.保存并重新启动
sudo reboot
Stretch/Jessie显示旋转
对于一些比较古老的系统，它们不使用vc4-kms-v3d 或 vc4-fkms-v3d 驱动模式，显示旋转方法如下
-
1. 在config.txt文件中加入语句（config文件位于TF卡根目录，即/boot中）：
display_rotate=1 #1：90；2: 180； 3: 270 -
2. 保存后重启树莓派即可
sudo reboot
触摸旋转
Bookworm 触摸
如果使用图形界面进行旋转，可以在屏幕布局编辑器窗口中勾选“Touchscreen”来同步触摸旋转。屏幕旋转方法请参考前面的介绍。命令行旋转方法请参考以下文字：
1. 创建一个名为的新文件99-waveshare-touch.rules
sudo nano /etc/udev/rules.d/99-waveshare-touch.rules
2. 根据需要添加以下行：
#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"
3. 保存并重启
sudo reboot
Bullseye/Buster 触摸
部分系统显示旋转后，触摸方向不一致，需要按下文操作进行触摸旋转：
1. 安装libinput
sudo apt-get install xserver-xorg-input-libinput
-
如果你安装的是Ubuntu系统，或者是Jetson Nano。安装指令为
sudo apt install xserver-xorg-input-synaptics
2. 在/etc/X11/下创建xorg.conf.d目录 (如果该目录已存在，这直接进行第3步)
sudo mkdir /etc/X11/xorg.conf.d
3. 复制40-libinput-conf 文件到刚刚创建的目录下
sudo cp /usr/share/X11/xorg.conf.d/40-libinput.conf /etc/X11/xorg.conf.d/
4. 编辑该文件
sudo nano /etc/X11/xorg.conf.d/40-libinput.conf
#找到 touchscreen的部分，在里面添加对应的旋转角度指令，然后保存即可
#90°Right触摸旋转：
Option "CalibrationMatrix" "0 1 0 -1 0 1 0 0 1"
#180° Inverted触摸旋转：
#Option "CalibrationMatrix" "-1 0 1 0 -1 1 0 0 1"
#270° Left旋转：
#Option "CalibrationMatrix" "0 -1 1 1 0 0 0 0 1"
类似下图位置：
5. 重启树莓派
sudo reboot
完成以上步骤后触摸将会进行旋转。