模板: DSI-TOUCH系列通用教程

调节背光亮度

图形界面调光

以下步骤以Trixie系统为例:

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

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

在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 打开该程序，如下图：

使用终端调节背光亮度

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文件开头添加对应显示屏的分辨率和旋转角度指令，保存重启后生效
#例如DSI-1显示屏720x1280分辨率，显示旋转90度
video=DSI-1:720x1280e,rotate=90
#例如DSI-1显示屏720x1280分辨率，显示旋转180度
video=DSI-1:720x1280e,rotate=180
#例如DSI-1显示屏720x1280分辨率，显示旋转270度
video=DSI-1:720x1280e,rotate=270

注意：

1.以实际的显示屏分辨率为准。
2.如果是使用Pi5/CM5，以实际识别到的DSI显示器编号为准，例如"DSI-2"。
3.无法使用 cmdline.txt 将 DSI 显示器与 HDMI 显示器分开旋转。当您同时使用 DSI 和 HDMI 时，它们共享相同的旋转值。

触摸旋转

如果使用图形界面进行旋转，可以在屏幕布局编辑器窗口中勾选“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

触摸模式选择

Trixie和Bookworm系统支持两种触控模式，可在 Screen Configuration > Touchscreen 菜单中切换：

1.Mouse Emulation（默认）

单击 = 鼠标左键功能
长按 = 鼠标右键功能
支持双击
不支持滑动页面和多点触摸功能

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

2.Multitouch

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

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

使用触摸屏虚拟键盘

从 Raspberry Pi OS Bookworm 版本开始，系统默认集成了 Squeekboard 屏幕键盘。

系统会在可输入文字时自动弹出，在不可输入文字时自动隐藏。
也可以通过任务栏右上角的键盘图标手动显示或隐藏

你也可以通过左上角菜单「Preferences」→「Control Centre」→「Display」来永久设置屏幕键盘的显示或隐藏。

在 Bookworm 系统中，可通过 Raspberry Pi Configuration → Display 或 raspi-config → Display 设置键盘显示或隐藏。

提示：

在 Raspberry Pi OS 的 Bookworm 之前的旧版本，请使用 matchbox-keyboard。如果你使用的是 wayfire 桌面合成器，请使用 wvkbd。

导航菜单