使用教程

硬件连接

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

1. 使用 15PIN 的 FPC 排线，将显示屏接口连接到 Raspberry Pi 的 DSI 接口。

2. 使用 15PIN 的 FFC 排线，将摄像头接口连接到 Raspberry Pi 的 CSI 接口。

3. 使用 2PIN 电源连接线将 LCD 的电源接口连接到树莓派的 40PIN GPIO 接口。

   

4. 为方便使用，可以把 Raspberry Pi 通过螺丝固定到显示屏的背面。

   最终安装效果如下图所示：

   

搭配 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 通过螺丝固定的 7inch DSI LCD (with cam) 的背面，并组装上铜柱。

   如下图所示：

   

软件设置

Raspberry Pi OS 镜像烧录

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

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

   

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；

   

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/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 来更改显示旋转的角度。

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

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

屏幕休眠

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

xset dpms force off

禁用触摸

在 config.txt 文件末尾加入以下命令以禁用触摸。config.txt 位于 TF 卡根目录，也可以通过 sudo nano /boot/config.txt 命令访问：

disable_touchscreen=1

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

Raspberry Pi OS 分支介绍

Raspberry Pi OS Bookworm 和 Bullseye 分支

在该分支中，默认使用 libcamera 相机子系统接口。并且摄像头接口默认是打开的。

可以使用以下命令控制摄像头：

#libcamera-hello 是一个简单的"hello world" 程序，主要是启动摄像头预览功能，并显示到屏幕上。
libcamera-hello #大约显示 5 秒左右的预览窗口
libcamera-hello -t 0 #可以长时间显示预览窗口，使用 ctrl+c 结束

#libcamera-jpeg 是一个简单的应用程序，运行预览窗口，然后获取高分辨率静止图像。
libcamera-jpeg -o test.jpg #大约显示 5 秒左右的预览窗口，然后将完整分辨率的 JPEG 图像保存到 test.jpg

#libcamera-still 是一个更复杂的静态图像捕捉应用程序，主要为了模拟 raspistill
libcamera-still -o test.jpg #约显示 5 秒左右的预览窗口，然后图像保存到 test.jpg

#libcamera-vid 是一个视频拍摄应用程序。默认使用 Raspberry Pi 的硬件 H.264 编码器。
libcamera-vid -t 10000 -o test.h264 #将 10 秒的视频保存到 test.h264
vlc test.h264 #可以使用 vlc 播放生成的文件

#libcamera-raw 直接从传感器捕获原始帧的基本应用程序，不显示预览窗口。
libcamera-raw -t 2000 -o test.raw #将 2 秒的视频保存到 test.raw

更详细信息可查看：Raspberry Pi Camera software 文档

注：在有些主板上，使用 libcamera 报错，可以尝试执行以下命令

sudo raspi-config -> Advanced Options -> Glamor -> Yes(Enabled) -> Ok -> Finish -> Yes (Reboot)

Raspberry Pi OS buster 分支与 Ubuntu

在这些系统中默认使用 raspicam 相机子系统接口。在 Ubuntu 中摄像头接口默认是打开的。在 Raspberry Pi OS buster 分支中，需要执行以下命令打开摄像头接口

sudo raspi-config -> Interface Options -> Camera -> Yes -> OK -> Finish -> Yes (Reboot)

可以使用以下命令控制摄像头：

#raspistill 是一个运行预览窗口，然后获取高分辨率静止图像的应用程序。
raspistill -o cam.jpg #大约显示 5 秒左右的预览窗口，然后图像保存到 cam.jpg
raspistill -vf -hf -o cam2.jpg #垂直翻转和水平翻转

#raspivid 是一个视频拍摄应用程序。
raspivid -o vid.h264 #将 5 秒的视频保存到 test.h264
raspivid -o video.h264 -t 10000 #录制 10 秒视频
raspivid -vf -hf -o video.h264 -t 10000 #垂直翻转和水平翻转

更详细信息可查看：Raspicam 命令