7inch Raspberry Pi Touch Display 2

来自Waveshare Wiki
跳转至： 导航、 搜索

产品特性

  • 7英寸DSI触控屏，支持五点电容触摸控制
  • IPS显示面板，硬件分辨率为720×1280
  • 兼容Raspberry Pi 5/4B/CM4/3B+/3A+/3B/CM3+/CM3
  • 通过Raspberry Pi的DSI接口直接驱动LCD，刷新率高达60Hz
  • 配合Raspberry Pi使用时，兼容Bookworm/Bullseye/Buster系统
  • 支持软件调节背光亮度

硬件连接

搭配Raspberry Pi 5使用

1.使用"Pi5 DSI 排线"，将显示屏的DSI接口连接到树莓派主板的22PIN DSI1接口。
2.使用"GPIO 连接线"，将显示屏的电源接口连接到树莓派主板的排针。
3.用M2.5螺丝将树莓派固定到显示屏上。

安装效果如下：
DSC 0208.jpg

注意：请确保 DSI 排线方向连接无误，并通过 GPIO 引脚提供 5V 电源。

搭配Raspberry Pi4B/3B+/3B/3A+使用

1.使用"Pi4 DSI 排线"，将显示屏的DSI接口连接到树莓派主板的DSI接口。
2.使用"GPIO 连接线"，将显示屏的电源接口连接到树莓派主板的排针。
3.用M2.5螺丝将树莓派固定到显示屏上。

安装效果如下：
DSC 0209.jpg

注意：请确保 DSI 排线方向连接无误，并通过 GPIO 引脚提供 5V 电源。

软件设置

用于Bookworm/Bullseye/Buster系统

800x480-DSI-LCD-0.png

  • 2. 镜像烧写完成后，将TF卡插入树莓派，给树莓派上电，正常等待几秒后可以进入显示，系统启动后可以正常触摸。

触摸屏虚拟键盘

Raspberry Pi OS Bookworm 及更高版本默认包括 Squeekboard 屏幕键盘。连接触摸显示器后，屏幕键盘应在可以输入文本时自动显示，在无法输入文本时自动隐藏。
Image-3.png
对于不支持文本输入检测的应用程序，请使用任务栏右端的键盘图标手动显示和隐藏键盘。
Image-4.png
您还可以在 Raspberry Pi Configuration 的 Display 选项卡或 raspi-config 的 Display 部分中永久显示或隐藏屏幕键盘。
注意：在 Bookworm 之前的 Raspberry Pi OS 版本中，请改用 matchbox-keyboard。如果您使用 wayfire 桌面合成器，请改用 wvkbd。

调节背光亮度

图形界面调光

以下步骤以Trixie系统为例:

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

8inch dsi lcd -1.png

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

8inch dsi lcd -2.png

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

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

使用终端调节背光亮度

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.png

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

8inch dsi lcd -6.png

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

8inch dsi lcd -7.png

  • 在Bookworm系统中，该设置入口位于 Screen Configuration → Screen。
注意：仅在Trixie/Bookworm系统系统支持以上同步旋转方法。对于Bullseye/Butser系统，显示旋转后，需手动单独设置触摸旋转。

Bullseye/Buster显示旋转

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

DSI-LCD-Bullseye-Rotate-02.png

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

DSI-LCD-Bullseye-Rotate-03.pngDSI-LCD-Bullseye-Rotate-04.png

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.jpg
5. 重启树莓派 

sudo reboot

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

lite版本显示旋转

sudo nano /boot/firmware/cmdline.txt
#在cmdline.txt文件开头添加对应显示旋转角度的指令，保存重启后生效
#显示旋转90度
video=DSI-1:720x1280@60,rotate=90
#显示旋转180度
video=DSI-1:720x1280@60,rotate=180
#显示旋转270度
video=DSI-1:720x1280@60,rotate=270

屏幕休眠

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

xset dpms force off

注：该指令仅适用于Bullseye和Buster系统。

Touch Display 2 设备树选项参考

vc4-kms-dsi-ili9881-7inch 覆盖层支持以下选项：

DT 参数 操作
sizex Sets X resolution (default 1280)
sizey Sets Y resolution (default 720)
invx Invert X coordinates
invy Invert Y coordinates
swapxy Swap X and Y coordinates
disable_touch Disables the touch overlay totally

要指定这些选项，请将它们添加到 /boot/firmware/config.txt 中的 dtoverlay 行中，以逗号分隔。
例如，要反转 X 和 Y 的触摸坐标，请使用以下行：

dtoverlay=vc4-kms-dsi-ili9881-7inch,invx,invy

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

安全说明

为避免本产品发生故障或损坏，请遵守以下事项：

  • 连接设备前，请关闭您的 Raspberry Pi 计算机并断开外部电源。
  • 如果线缆脱落，请将连接器上的锁定装置向前拉，将带状线缆插入，金属触点朝向您，然后将锁定装置推回原位。
  • 本设备应在 0–50°C 的干燥环境中操作。
  • 操作时，请勿将设备暴露在水中或潮湿环境中，也不要将其放置在导电表面上。
  • 请勿将其暴露在任何过热源的环境中。
  • 应注意不要折叠或拉紧带状线缆。
  • 拧入零件时应小心。螺纹错位可能会造成无法修复的损坏，并使保修失效。
  • 搬运时请小心，避免对印刷电路板和连接器造成机械或电气损坏。
  • 存放在阴凉干燥处。
  • 避免温度急剧变化，否则会导致设备内积聚湿气。
  • 显示屏表面易碎，有可能破碎。

资料

FAQ

问题：如何替换树莓派开机logo图片？

将自定义图片替换此目录的图片即可 /usr/share/plymouth/themes/pix/splash.png


售后

联系人：梁工
电话：0755-83043099
微信：扫下方二维码添加
Ljh.png

说明：进行售后服务前，请准备好客户信息（定货单位、定货人等），以供验证

取自“https://www.waveshare.net/w/index.php?title=7inch_Raspberry_Pi_Touch_Display_2&oldid=134101”