跳到主要内容

使用说明

硬件连接​

搭配 Pi 4B/3B+/3A+/3B/2B/B+/A+使用​

  1. 使用 15PIN 的 FPC 排线，将显示屏接口连接到 Raspberry Pi 的 DSI 接口。
  2. 使用 15PIN 的 FFC 排线，将摄像头接口连接到 Raspberry Pi 的 CSI 接口。
  3. 为了方便使用，可以把 Raspberry Pi 通过螺丝固定到显示屏的背面。

安装效果如下图所示：（树莓派将通过顶针给 LCD 供电）

DSC 0297

搭配 Pi 5/CM4/CM3+/CM3 使用使用​

  1. 使用 DSI-Cable-12cm 线材，将显示屏接口连接到 Raspberry Pi 主板的 22PIN DSI1 接口。
  2. 使用 Pi5-Camera-Cable 线材，将摄像头接口连接到 Raspberry Pi 主板的 22PIN CSI0 接口。
  3. 使用 2PIN 电源连接线将 LCD 的电源接口连接到树莓派的 40PIN GPIO 接口。
  4. 为了方便使用，可以把 Raspberry Pi 5 通过螺丝固定的 8inch DSI LCD 的背面，并组装上铜柱。如下图所示：

8inch DSI LCD (with cam)Pi-5

软件设置​

Raspberry Pi OS 镜像烧录​

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

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

    800x480-DSI-LCD-0

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

    提示

    注意：由于 Pi5/CM4/CM3+/CM3 具有两个 mipi DSI 接口，请注意使用正确的 DSI 接口和指令，默认推荐使用 DSI1。

    dtoverlay=vc4-kms-v3d
    dtoverlay=ov5647
    #DSI1 Use
    dtoverlay=vc4-kms-dsi-7inch
    #DSI0 Use
    #dtoverlay=vc4-kms-dsi-7inch,dsi0

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

调节背光亮度​

图形界面调光​

以下步骤以 Trixie 系统为例：

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

    8inch dsi lcd -1

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

    8inch dsi lcd -2

    信息

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

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

使用终端调节背光亮度​

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

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

    8inch dsi lcd -6

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

    8inch dsi lcd -7

  • 在 Bookworm 系统中，该设置入口位于 Screen Configuration → Screen。
信息

注意：仅 Trixie/Bookworm 系统支持以上同步旋转方法。对于 Bullseye/Buster 系统，显示旋转后，需手动单独设置触摸旋转。

lite 版本显示旋转

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

    sudo nano /boot/cmdline.txt

  2. 在 cmdline.txt 文件开头，添加对应显示旋转角度的指令：（请注意，该命令需要放在同一行上，每个命令用空格分隔。）

    video=DSI-1:800x480M@60,rotate=90

通过将 rotate 值更改为 90、180 或 270 来更改显示旋转的角度。

  1. 保存并重新启动

    sudo reboot

Bullseye/Buster 显示旋转​

GUI 界面旋转

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

    DSI-LCD-Bullseye-Rotate-02

  2. 进入"Screen"->"DSI-1"->"Orientation" ，勾选您需要旋转的方向，最后点击"Apply"，即可完成显示旋转。

    DSI-LCD-Bullseye-Rotate-03

    DSI-LCD-Bullseye-Rotate-04

lite 版本显示旋转

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

    sudo nano /boot/cmdline.txt

  2. 在 cmdline.txt 文件开头，添加对应显示旋转角度的指令：（请注意，该命令需要放在同一行上，每个命令用空格分隔。）

    video=DSI-1:800x480M@60,rotate=90

通过将 rotate 值更改为 90、180 或 270 来更改显示旋转的角度。

  1. 保存并重新启动

    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

  1. 在/etc/X11/下创建 xorg.conf.d 目录 （如果该目录已存在，这直接进行第 3 步）

    sudo mkdir /etc/X11/xorg.conf.d

  2. 复制 40-libinput-conf 文件到刚刚创建的目录下

    sudo cp /usr/share/X11/xorg.conf.d/40-libinput.conf /etc/X11/xorg.conf.d/

  3. 编辑该文件

    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

  1. 重启树莓派

    sudo reboot

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

屏幕休眠​

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

xset dpms force off

禁用触摸​

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

disable_touchscreen=1

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