触摸显示屏
树莓派触摸显示屏
树莓派触摸显示屏 是一个液晶显示屏，通过 DSI 连接器和 GPIO 连接器与 Raspberry Pi 相连。
树莓派7英寸触摸显示屏
触摸显示屏兼容所有型号的 Raspberry Pi，但缺少 DSI 连接器的 Zero 系列和键盘系列除外。最早的 Raspberry Pi 型号缺少适当的安装孔，需要额外的安装硬件来安装显示屏 PCB 上的支座。
显示屏具有以下主要功能：
- 800×480px RGB 液晶显示屏
- 24位色彩
- 工业品质：水平视角 140 度，垂直视角 120 度
- 10点多点触摸屏
- 通过 I2C 接口实现 PWM 背光控制和电源控制
- 金属框架背面，带有树莓派显示屏转换板和树莓派的安装点
- 背光寿命：20000 小时
- 工作温度：-20 至 +70 摄氏度
- 存储温度：-30 至 +80 摄氏度
- 对比度：500
- 平均亮度：250 cd/m2
- 视角（度）
- 顶部 - 50
- 底部 - 70
- 左 - 70
- 右 - 70
- 电源要求： 最大亮度时，典型值为 5V 200mA。
- 外部尺寸 192.96 × 110.76 毫米
- 可视区域 154.08 × 85.92 毫米
安装触摸显示屏
您可以使用触控显示屏的支座将 Raspberry Pi 安装到触控显示屏的背面，然后连接相应的电缆。如果你有单独的机箱，也可以将触摸显示屏安装到机箱中。连接方式保持不变，但根据机箱的不同，您可能需要更长的电缆。
连接到触摸显示屏的树莓派
将扁平柔性电缆 (FFC) 的一端连接到触摸显示电路板上的 RPI-DISPLAY 端口。银色或金色触点应远离显示屏。然后将 FFC 的另一端连接到树莓派上的 DISPLAY 端口。这一端的触点应朝内，朝向树莓派。
如果 FFC 没有完全插入或位置不正确，显示屏就会出现问题。在排除故障时，尤其是在显示屏上看不到任何东西或显示屏只显示一种颜色时，应仔细检查此连接。
您可以下载触摸显示屏的机械图纸。
为触摸显示屏供电
我们建议使用 Raspberry Pi 的 GPIO 为触摸显示屏供电。或者，您也可以使用单独的微型 USB 电源直接为显示屏供电。
从树莓派供电
要使用树莓派为触摸显示屏供电，您需要在树莓派GPIO 的 5V 和 GND 引脚与显示屏的 5V 和 GND 引脚之间连接两条跳线，如下图所示。
显示屏 5V 和 GND 引脚的位置
开始之前，请确保 Raspberry Pi 已关闭电源，并且未连接任何电源。将黑色跳线的一端连接到 Raspberry Pi 的第六针（GND），红色跳 线的一端连接到第四针（5V）。如果没有第六针，您可以使用任何其他开放的 GND 针来连接黑线。如果没有四号针脚，可以使用任何其他 5V 针脚连接红线，例如二号针脚。
树莓派针座的位置
接下来，将黑线的另一端连接到显示屏上的 GND 引脚，红线的另一端连接到显示屏上的 5V 引脚。完成所有连接后，下次打开 Raspberry Pi 时就能看到触摸显示屏打开了。
使用触摸显示屏上的其他三个引脚将显示屏连接到原始 Raspberry Pi 1 Model A 或 B。更多信息，请参阅我们的传统支持文档。
要识别原装 Raspberry Pi，请检查 GPIO 接头。只有原装型号有一个 26 针 GPIO 接头；后续型号有 40 针。
从微型USB供电
如果不想使用树莓派为触摸显示屏供电，可以使用微型 USB 电源。我们建议使用树莓派12.5W 电源，以确保显示屏按预期运行。
如果您选择使用微型 USB 供电，请不要将树莓派上的 GPIO 引脚连接到显示屏。两块板之间的唯一连接应该是扁平柔性线缆。
使用微型 USB 电缆为显示屏供电时，请将其安装在机箱内，以防止在使用过程中接触到显示屏的印刷电路板。
使用屏幕键盘
Raspberry Pi OS Bookworm 及更高版本默认包含 Squeekboard 屏幕键盘。当连接触摸显示屏时，屏幕键盘会在可以输入文字时自动显示，在无法输入文字时自动隐藏。
对于不支持文字输入检测的应用程序，可使用任务栏右端的键盘图标手动显示和隐藏键盘。
您也可以在 Raspberry Pi 配置的 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 度，即上下颠倒。
使用 cmdline.txt 无法将 DSI 显示屏与 HDMI 显示屏分开旋转。同时使用 DSI 和 HDMI 时，它们共享相同的旋转值。
旋转触摸输入
通过设备树旋转触摸输入可能会与输入库发生冲突。请尽可能在输入库或桌面中配置触摸事件旋转。
触摸输入的旋转与显示屏本身的方向无关。要更改这一点，需要在 /boot/firmware/config.txt 中手动添加 dtoverlay 指令。在 config.txt 最后添加以下一行：
dtoverlay=vc4-kms-dsi-7inch,invx,invy
然后，从 config.txt 中删除以下行（如果存在），禁用自动显示检测功能：
display_auto_detect=1
触摸显示设备树选项参考
vc4-kms-dsi-7inch 叠加支持以下选项：
| DT参数 | 操作 |
|---|---|
sizex | 设置 X 分辨率（默认为 800） |
sizey | 设置 Y 分辨率（默认为 480） |
invx | 反转 X 坐标 |
invy | 反转 Y 坐标 |
swapxy | 交换 X 和 Y 坐标 |
disable_touch | 完全禁用触摸覆盖 |
要指定这些选项，请将它们添加到 /boot/firmware/config.txt 中的 dtoverlay 行，中间用逗号隔开。布尔值出现时默认为 "true"，但可以使用后缀 "=0" 将其设置为 "false"。整数值需要一个值，例如 sizey=240。例如，要将 X 分辨率设置为 400 像素并反转 X 和 Y 坐标，请使用下面一行：
dtoverlay=vc4-kms-dsi-7inch,sizex=400,invx,invy
在计算模块设备上的安装。
所有树莓派单板计算机（SBC）均可自动检测官方触摸屏，因为连接到树莓派主板DSI接口的电路是固定的；此自动检测功能确保正确的设备树条目被传递给内核。然而，计算模块旨在用于工业应用，其中集成商可以根据需要使用任何和所有GPIO和接口。因此，自动检测在计算模块设备上不可行，且已被禁用。这意味着设置显示屏所需的设备树片段必须通过其他机制加载，具体方式可以是如上所述在 config.txt 中添加 dtoverlay 条目、使用自定义基础设备树文件，或若存在 HAT EEPROM 则通过该 EEPROM 进行加载。
传统支持
这些说明仅适用于原版树莓派、A和B板。要识别原版树莓派，请检查 GPIO 接头。只有原版型号有一个 26 针 GPIO 接头；后续型号有 40 针。
树莓派1A和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 接口为设置供电。请勿通过树莓派的微型 USB 端口为设置供电。这将超过输入多芯保险丝的最大额定电流，因为显示屏的功耗约为 400mA。
中文翻译版以英文版相同知识授权方式共享：CC-BY-SA 4.0。交流 Q群：498908352