Raspberry Pi Touch Display 2
产品特性
- 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螺丝将树莓派固定到显示屏上。
安装效果如下：
注意：请确保 DSI 排线方向连接无误，并通过 GPIO 引脚提供 5V 电源。
搭配Raspberry Pi4B/3B+/3B/3A+使用
1.使用"Pi4 DSI 排线"，将显示屏的DSI接口连接到树莓派主板的DSI接口。 2.使用"GPIO 连接线"，将显示屏的电源接口连接到树莓派主板的排针。 3.用M2.5螺丝将树莓派固定到显示屏上。
安装效果如下：
注意：请确保 DSI 排线方向连接无误，并通过 GPIO 引脚提供 5V 电源。
软件设置
用于Bookworm/Bullseye/Buster系统
- 1. 将TF卡连接到PC，下载并使用Raspberry Pi Imager进行烧录对应系统镜像。
- 2. 镜像烧写完成后，将TF卡插入树莓派，给树莓派上电，正常等待几秒后可以进入显示，系统启动后可以正常触摸。
触摸屏虚拟键盘
Raspberry Pi OS Bookworm 及更高版本默认包括 Squeekboard 屏幕键盘。连接触摸显示器后，屏幕键盘应在可以输入文本时自动显示，在无法输入文本时自动隐藏。
对于不支持文本输入检测的应用程序，请使用任务栏右端的键盘图标手动显示和隐藏键盘。
您还可以在 Raspberry Pi Configuration 的 Display 选项卡或 raspi-config 的 Display 部分中永久显示或隐藏屏幕键盘。
注意：在 Bookworm 之前的 Raspberry Pi OS 版本中，请改用 matchbox-keyboard。如果您使用 wayfire 桌面合成器，请改用 wvkbd。
软件调光
微雪提供了对应的应用程序(该程序仅用于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 打开该程序，如下图：
另外，也在终端输入以下命令可以控制背光亮度：
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
Bookworm触摸屏旋转
- 1.打开"Screen Configuration"应用程序；
- 2.进入"Screen"->"DSI-1"->"Touchscreen"，勾选"10-0014 Goodix Capacitive TouchScreen"
- 3.点击"Apply"，然后关闭当前窗口，根据弹窗提示进行Reboot，即可完成指定触摸屏；
- 4.进入"Screen"->"DSI-1"->"Orientation" ，勾选您需要旋转的方向，最后点击"Apply"即可完成显示和触摸同步旋转。
注意：仅Bookworm系统支持以上同步旋转方法。对于Bullseye和Butser系统，显示旋转后，需手动单独设置触摸旋转。
Bullseye/Buster显示旋转
- 1.打开"Screen Configuration"应用程序；
- 2.进入"Screen"->"DS-1"->"Orientation" ，勾选您需要旋转的方向，最后点击"Apply"，即可完成显示旋转。
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
完成以上步骤后触摸将会进行旋转。
lite版本显示旋转
sudo nano /boot/firmware/cmdline.txt #在cmdline.txt文件开头添加对应显示旋转角度的指令，保存重启后生效 #显示旋转90度 video=DSI-1:1280x720@60,rotate=90 #显示旋转180度 video=DSI-1:1280x720@60,rotate=180 #显示旋转270度 video=DSI-1:1280x720@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
注：添加指令后需重启生效。
资料
FAQ
将自定义图片替换此目录的图片即可 /usr/share/plymouth/themes/pix/splash.png
售后
联系人：吴工
EMAIL：3005496359@qq.com
电话：0755-83043099
QQ：3005496359
微信：扫下方二维码添加
