产品特性​

• 6.25 英寸 DSI 触控屏，支持五点电容式触摸。
• IPS 显示面板，硬件分辨率为 720 × 1560。
• 默认竖屏显示，可通过系统显示设置切换显示方向。
• 采用全贴合工艺，配备钢化玻璃触摸面板，硬度为 6H。
• DSI 显示接口，I2C 触摸接口。
• 适配 Raspberry Pi，支持 Raspberry Pi OS 新系统免驱使用。
• 背光亮度支持软件调节，也可通过板载按键调节。

电气规格​

• Note 1：输入电压超过最大值或操作不当可能会对设备造成永久性损坏。
• Note 2：输入电流需≥400mA，否则将导致启动失败或者显示异常，长时间处于异常状态可能会对设备造成永久性损坏。
• Note 3：请不要将显示屏长期置于高温高湿的存储环境，显示屏需在极限值范围内工作，否则将可能损坏显示屏。

接口介绍​

外观尺寸​

硬件连接​

Raspberry Pi 5​

1. 使用"DSI-Cable-12cm"排线，将显示屏的 DSI 接口连接到 Raspberry Pi 的 22PIN DSI 接口。
2. 将 Raspberry Pi 固定到显示屏背部的螺母柱上。
3. 确认弹簧顶针与 Raspberry Pi 接触正常，显示屏通过弹簧顶针获取 5 V 电源。

Raspberry Pi 4B / 3B+ / 3B / 3A+​

1. 使用双头 15PIN 的 FPC 排线，将显示屏的 DSI 接口连接到 Raspberry Pi 的 15PIN DSI 接口。
2. 将 Raspberry Pi 固定到显示屏背部的螺母柱上。
3. 确认弹簧顶针与 Raspberry Pi 接触正常，显示屏通过弹簧顶针获取 5 V 电源。

Compute Module IO Board​

1. 使用 “DSI-Cable-12cm” 排线，将显示屏的 DSI 接口连接到 Compute Module IO Board 的 DSI 接口。
2. 使用 4PIN PH2.0 杜邦线，将显示屏的 5V 和 GND 分别连接到树莓派的 5V 和 GND 引脚。（默认使用 DSI 接口的内置 I2C0，故 SDA1 和 SCL1 可不接。）

软件设置​

烧录系统​

1. 将 TF 卡连接到电脑，下载并使用 Raspberry Pi Imager 烧录最新 Raspberry Pi OS。

   
   

2. 烧录完成后，打开 TF 卡根目录中的 config.txt 文件，在文件末尾添加以下配置，保存后安全弹出 TF 卡。

   DSI 接口选择

   Raspberry Pi 5 / CM5 / CM4 / CM3+ / CM3 具有两个 MIPI DSI 接口。默认推荐使用 DSI1；如果屏幕连接到 DSI0，请启用 DSI0 对应配置。

   dtoverlay=vc4-kms-v3d
   #DSI1 Use
   dtoverlay=vc4-kms-dsi-waveshare-panel,6_25_inchB
   #DSI0 Use
   #dtoverlay=vc4-kms-dsi-waveshare-panel,6_25_inchB,dsi0
   

3. 将 TF 卡插入 Raspberry Pi 并上电。系统启动后，显示与触摸功能可正常使用。

背光亮度调节​

图形界面调光​

以下步骤以 Raspberry Pi OS Trixie 为例：

1. 点击左上角菜单，进入 "Preferences" > "Control Center"，选择 "Screens"。

   
   

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

   
   

使用背光调节应用程序​

也可使用 Waveshare 提供的图形化背光调节工具：

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 界面旋转​

以下步骤以 Raspberry Pi OS Trixie 为例：

1. 点击左上角菜单，进入 "Preferences" > "Control Center"，选择 "Screens"。

   
   

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

   
   

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

   
   

Lite 版本显示旋转​

编辑 cmdline.txt：

sudo nano /boot/firmware/cmdline.txt

在文件开头添加对应旋转角度的参数，保存并重启后生效。

# 显示旋转 90 度
video=DSI-1:720x1560M@60,rotate=90

# 显示旋转 180 度
video=DSI-1:720x1560M@60,rotate=180

# 显示旋转 270 度
video=DSI-1:720x1560M@60,rotate=270

触摸旋转​

如果使用图形界面进行旋转，可在屏幕布局编辑器中勾选 "Touchscreen" 同步触摸旋转。命令行触摸旋转可通过 udev 规则配置。

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. 重启 Raspberry Pi。

   sudo reboot
   

触摸模式选择​

Raspberry Pi OS Trixie 和 Bookworm 支持两种触控模式，可在 "Screen Configuration" > "Touchscreen" 中切换。

Mouse Emulation​

• 单击对应鼠标左键。
• 长按对应鼠标右键。
• 支持双击。
• 不支持滑动页面和多点触摸。

Multitouch​

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

屏幕键盘​

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

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

在 Trixie 系统中，可通过 "Preferences" > "Control Center" > "Display" 设置屏幕键盘显示或隐藏。

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

技术支持

周一-周五（9:30-6:30）周六（9:30-5:30）

手机：13434470212

邮箱：services04@spotpear.cn

QQ：202004841