跳到主要内容

搭配树莓派使用

硬件连接​

  1. 连接 12V 2A 电源适配器到屏幕的 DC 电源接口

  2. 将 Touch 接口连接到树莓派的 USB 接口

  3. 将 HDMI 接口连接到树莓派 HDMI 接口

    21

软件设置​

用于树莓派的 Raspberry Pi OS / Ubuntu / Kali 和 Retropie 系统。

  1. 将 TF 卡连接到 PC，下载并使用 Raspberry Pi Imager 进行烧录对应系统镜像。

    800x480-DSI-LCD-0

  2. 镜像烧写完成后，打开 TF 卡根目录的 config.txt 文件，在 config.txt 最后加入以下代码，保存并安全弹出 TF 卡。

    hdmi_force_hotplug=1
    max_framebuffer_height=1080
    hdmi_group=2
    hdmi_mode=87
    hdmi_timings=1920 0 88 44 148 1080 0 4 5 36 0 0 0 60 0 148500000 0
    config_hdmi_boost=10

  3. 将 TF 卡插入树莓派，给树莓派上电，正常等待几秒后可以进入显示，系统启动后可以正常触摸。

显示旋转​

Bookworm 系统​

GUI 界面旋转​

  1. 打开"Screen Configuration"应用程序；

    DSI-LCD-Bookworm-Rotate-01

  2. 依次点击菜单"Screen"->"HDMI-A-1"->"Touchscreen" ，勾选"Waveshare Waveshare"

    7

  3. 依次进入"Screen"->"HDMI-A-1"->"Orientation"，选择所需的旋转方向，并点击 Apply 应用设置，即可完成显示与触摸方向的同步旋转。

    7

备注

仅 Bookworm 系统支持此方法实现“显示+触摸”同步旋转。Bullseye 及更早版本需分别设置显示与触摸旋转。

lite 版本显示旋转（无桌面环境）​

编辑启动命令行文件：

sudo nano /boot/firmware/cmdline.txt

在 cmdline.txt 文件开头添加以下参数（需修改为屏幕实际分辨率） ：

video=HDMI-A-1:400x1280M@60,rotate=90

可替换为：

  • rotate=90：顺时针旋转 90°
  • rotate=180：旋转 180°
  • rotate=270：逆时针旋转 90°
备注

HDMI 与其他接口（如 DPI、DSI）共享旋转设置，无法分别单独设置。

Bullseye/Buster 系统​

GUI 界面旋转​

  1. 打开"Screen Configuration"应用程序；

    DSI-LCD-Bullseye-Rotate-02

  2. 依次点击菜单"Screen"->"HDMI-A-1"->"Orientation"，选择所需的旋转角度，并点击 Apply 应用设置。

    DSI-LCD-Bullseye-Rotate-03

lite 版本显示旋转​

  1. 需要修改/boot/cmdline.txt 文件：

    sudo nano /boot/cmdline.txt

  2. 在 cmdline.txt 文件开头添加以下参数（需修改为屏幕实际分辨率） ：

    video=HDMI-A-1:400x1280M@60,rotate=90

    可替换为：

    • rotate=90：顺时针旋转 90°
    • rotate=180：旋转 180°
    • rotate=270：逆时针旋转 90°
    注意

    HDMI 与其他接口（如 DPI、DSI）共享旋转设置，无法分别单独设置。

  3. 保存并重新启动

    sudo reboot

Stretch/Jessie 系统​

对于较旧系统（不使用 vc4-kms-v3d 或 vc4-fkms-v3d 驱动），请按以下方式设置：

  1. 编辑 config.txt 文件：

    sudo nano /boot/config.txt

  2. 在文件末尾加入语句：

    display_rotate=1 #1：90；2: 180； 3: 270

  3. 保存后重启树莓派即可

    sudo reboot

触摸屏旋转设置​

部分屏幕可通过长按背面的 Rotate Touch 按键来旋转触摸方向，每次长按可切换一次方向。

7

Bookworm 系统（命令行方式）​

如果使用图形界面进行旋转，可以在屏幕布局编辑器窗口中勾选“Touchscreen”来同步触摸旋转。屏幕旋转方法请参考前面的介绍。命令行旋转方法请参考以下文字：

  1. 创建 udev 规则文件：

    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"

    类似下图位置：

    Touch roate

  5. 重启树莓派

    sudo reboot

完成以上步骤后触摸将会进行旋转。

使用触摸屏虚拟键盘​

从 Raspberry Pi OS Bookworm 版本开始，系统默认集成了 Squeekboard 屏幕键盘。 当连接触摸显示屏时，在可以输入文字的情况下，屏幕键盘会自动显示；而在无法输入文字的情况下，它会自动隐藏。 对于不支持自动检测文字输入的应用程序，可以使用任务栏最右侧的键盘图标手动显示或隐藏屏幕键盘。

DSI-Touch-Bookworm-Keyboard-01

你也可以通过“Raspberry Pi Configuration”中的“Display”选项栏目，或通过 raspi-config 中的“Display”部分，来设置屏幕键盘的显示或隐藏。

DSI-Touch-Bookworm-Keyboard-02

提示

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

触摸模式选择​

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

DSI-Touch-Bookworm-Keyboard-03

  1. Mouse Emulation（默认）

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

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

  2. Multitouch

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

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