触摸显示屏
Raspberry Pi 触摸屏
在 GitHub 上修改
Raspberry Pi Touch Display 是一款LCD显示器，使用DSI连接器和GPIO连接器连接到Raspberry Pi。
触控显示器兼容所有型号的树莓派，除了树莓派zero系列和键盘系列，它们缺少DSI连接器。最早的树莓派型号缺乏适当的安装位置，需要额外的安装硬件来安装显示器印刷电路板上的支架。
该显示器具有以下主要特点：
-
800×480px RGB 液晶显示屏
-
24 位色彩
-
工业品质：水平视角 140 度，垂直视角 120 度
-
10 点多点触摸屏
-
通过 I2C 接口实现 PWM 背光控制和电源控制
-
金属框架背面，带有 Raspberry Pi 显示器转换板和 Raspberry Pi 的安装点
-
背光寿命：20000 小时
-
工作温度：-20 至 +70 摄氏度
-
存储温度：-30 至 +80 摄氏度
-
对比度：500
-
平均亮度：250 cd/m2
-
视角（度）：
-
顶部 - 50
-
底部 - 70
-
左 - 70
-
右 - 70
-
-
电源要求： 最大亮度时，典型值为 5V 200mA。
-
外部尺寸：192.96 × 110.76 毫米 192.96 × 110.76 毫米
-
可视区域 154.08 × 85.92 毫米
安装触摸屏
您可以使用Raspberry Pi的支架将其安装到触控显示器的背面，然后连接适当的电缆。如果有可用的机箱，您也可以将触控显示器安装在单独的机箱中。连接保持不变，但因为机箱的不同，您可能需要更长的电缆。
将扁平柔性电缆（FFC）的一端连接到触控显示器PCB上的 RPI-DISPLAY 端口。银色或金色触点应远离显示器。然后将FFC的另一端连接到Raspberry Pi上的 DISPLAY 端口。这一端的触点应面向内部，朝向Raspberry Pi。
如果FFC没有完全插入或正确定位，您将遇到显示器问题。故障排除时，您应该始终仔细检查此连接，尤其是如果您在显示器上没有看到任何内容，或者显示器只显示一种颜色。
|
Note
|
触摸显示器的 机械图 可以下载。 |
启动触摸屏
我们建议使用Raspberry Pi的GPIO为触控显示器供电。或者，您可以使用单独的微型USB电源直接为显示器供电。
使用树莓派供电
要使用Raspberry Pi为Touch Display供电，您需要在 Raspberry Pi GPIO 上的5V和 GND 引脚以及显示器上的5V和 GND 引脚之间连接两根跳线，如下图所示。
GND 引脚的位置在开始之前，请确保Raspberry Pi已断电且未连接到任何电源。将黑色跳线的一端连接到Raspberry Pi上的引脚6（GND），将红色跳线的一端连接到引脚4（5V）。如果引脚6不可用，您可以使用任何其他开放的 GND 引脚连接黑线。如果引脚4不可用，您可以使用任何其他5V引脚连接红线，例如引脚2。
接下来，将黑线的另一端连接到显示屏上的 GND 引脚，将红线的另一端连接到显示屏上的5V引脚。完成所有连接后，您应该会在下次打开Raspberry Pi时看到Touch Display打开。
使用触控显示屏上的其他三个引脚将显示屏连接到原始Raspberry Pi 1 Model A或B。有关详细信息，请参阅我们在 旧版支持 上的留档。
|
Note
|
要识别原始Raspberry Pi，请检查GPIO排针。只有原始型号有26针GPIO排针；后续型号有40针。 |
使用micro USB电源供电
如果您不想使用Raspberry Pi为触控显示器供电，可以改用微型USB电源。我们建议使用 Raspberry Pi 12.5W 电源 以确保显示器按预期运行。
如果您选择使用micro USB供电，请不要将Raspberry Pi上的GPIO引脚连接到显示器。两块板之间的唯一连接应该是扁平柔性电缆。
|
Warning
|
使用微型USB电缆为显示器供电时，请将其安装在机箱内，以在使用过程中阻止访问显示器的PCB。 |
使用虚拟键盘
树莓派操作系统_Bookworm_和更高版本默认包括Squeekboard屏幕键盘。当连接触摸显示器时，屏幕键盘应该在可以输入文本时自动显示，在不可能输入文本时自动隐藏。
对于不支持文本输入检测的应用程序，请使用任务栏右端的键盘图标手动显示和隐藏键盘。
您还可以在Raspberry Pi Configuration的Display选项卡或 raspi-config 的 Display 部分永久显示或隐藏屏幕键盘。
在_Bookworm_之前的Raspberry Pi OS版本中，请改用 matchbox-keyboard。如果您使用wayfire桌面合成器，请改用 wvkbd。
旋转屏幕
如果您想物理旋转显示器，或将其安装在特定位置，请从 首选项 菜单中选择 屏幕配置。右键单击布局编辑器中的触摸显示矩形（可能是DSI-1），选择 方向，然后选择适合您需求的最佳选项。
无图像桌面旋转屏幕
要在缺少桌面环境的设备上设置屏幕方向，请编辑 /boot/firmware/cmdline.txt 配置文件以将方向传递给系统。将以下行添加到 cmdline.txt：
video=DSI-1:800x480@60,rotate=<rotation-value>将 <rotation-value> 占位符替换为以下值之一，这些值对应于相对于显示器上默认值的旋转程度：
-
0 -
90 -
180 -
270
例如，90 的旋转值将显示器向右旋转90度。180 将显示器旋转180度，或上下颠倒。
|
Note
|
使用 cmdline.txt 无法将DSI显示器与HDMI显示器分开旋转。当您同时使用DSI和HDMI时，它们共享相同的旋转值。
|
旋转触摸
|
Warning
|
通过设备树旋转触摸输入可能会导致与您的输入库发生冲突。只要有可能，请在输入库或桌面中配置触摸事件旋转。 |
触摸输入的旋转与显示器本身的方向无关。要更改此设置，您需要在 /boot/firmware/config.txt 中手动添加 dtoverlay 指令。在 config.txt 末尾添加以下行：
dtoverlay=vc4-kms-dsi-7inch,invx,invy然后，通过从 config.txt 中删除以下行（如果存在）来禁用自动显示检测：
display_auto_detect=1触摸显示设备树选项参考
vc4-kms-dsi-7inch overlay支持以下选项：
| DT parameter | Action |
|---|---|
|
Sets X resolution (default 800) |
|
Sets Y resolution (default 480) |
|
Invert X coordinates |
|
Invert Y coordinates |
|
Swap X and Y coordinates |
|
Disables the touch overlay totally |
要指定这些选项，请将它们（以逗号分隔）添加到 /boot/firmware/config.txt 中的 dtoverlay 行。存在布尔值时默认为true，但您可以使用后缀“=0”将它们设置为false。整数值需要一个值，例如 sizey=240。例如，要将X分辨率设置为400像素并反转X和Y坐标，请使用以下行：
dtoverlay=vc4-kms-dsi-7inch,sizex=400,invx,invy早期支持
在 GitHub 上修改
|
Warning
|
这些说明仅适用于原始Raspberry Pi、型号A和B板。要识别原始Raspberry Pi，请检查GPIO接头连接器。只有原始型号有26针GPIO接头；后续型号有40针。 |
Raspberry Pi 1 Model A和B板上的DSI连接器没有与触摸屏控制器和DSI控制器通信所需的I2C连接。要解决这个问题，请使用显示套件随附的附加跳线电缆。将GPIO接头上的SCL/SDA连接到显示板上标记为SCL/SDA的水平引脚。使用跳线电缆通过GPIO引脚为Model A/B供电。
在这些板上默认禁用DSI显示自动检测。要启用检测，请将以下行添加到 /boot/firmware/config.txt 文件中：
ignore_lcd=0通过显示板上的 PWR IN micro-USB连接器为设置供电。不要通过Raspberry Pi的micro-USB端口为设置供电。这将超过输入聚熔断器的最大额定电流，因为显示器消耗大约400mA。