显示器
树莓派触摸显示器
树莓派触摸显示器 是一个液晶显示屏，使用 DSI 连接器与 Raspberry Pi 相连。您可以同时使用触摸显示器和 HDMI 显示输出。
树莓派7英寸触摸显示屏
触摸显示器兼容所有型号的 Raspberry Pi，但 Raspberry Pi Zero 和 Zero 2 W 除外，因为它们没有 DSI 连接器。最早的 Raspberry Pi 型号缺少适当的安装孔，需要额外的安装硬件来安装显示器 PCB 上的支座。
显示屏具有以下主要功能：
- 800×480 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 及更高版本中，可以使用 wvkbd 屏幕键盘作为输入设备。要安装 wvkbd，请运行以下命令：
sudo apt install wvkbd
提示：在书虫之前的树莓派操作系统版本中，可以使用 matchbox-keyboard 代替。
更改屏幕方向
如果您想实际旋转显示屏或将其安装在特定位置，可以使用软件调整屏幕方向，以便更好地匹配您的设置。
从桌面旋转屏幕
要从桌面环境设置屏幕方向，请从首选项菜单中选择屏幕配置。右键单击布局编辑器中的 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
在 Raspberry Pi OS Bookworm 中，Wayfire 中的一个 Bug 目前会在使用 WayVNC 时阻止光标移动旋转。Wayfire 中没有解决这一错误的方法。您可以使用 labwc（目前处于测试阶段）。
首先安装 labwc：
sudo apt install labwc
然后，使用 Raspberry Pi 配置 CLI 切换到 labwc 窗口合成器。运行以下命令打开 raspi-config：
sudo raspi-config
进入高级选项。选择 Wayland，然后选择 labwc。退出 raspi-config 并使用 sudo reboot 重新启动。切换到 labwc 可能会重置某些配置，包括键盘布局和旋转设置。
触摸显示设备树选项参考
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
传统支持
这些说明仅适用于原版树莓派、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