触摸显示屏2
树莓派触摸屏2是一款竖屏式触摸液晶显示屏（支持旋转功能），专为平板电脑、娱乐系统及信息仪表盘等交互项目设计。
树莓派触摸显示屏 2
规格
本节描述触摸 Touch Display 2 的物理特性和功能，包括尺寸、特性和硬件。
尺寸规格
触控 Touch Display 2 提供两种尺寸：5英寸和7英寸（对角线测量）。除物理尺寸外，这两款显示屏具备完全相同的特性和功能。下表汇总了这两款显示屏的尺寸规格：
| 厚度 | 外形尺寸 | 显示区域 | 有效区域 | |
|---|---|---|---|---|
| 5英寸显示屏 | 16毫米 | 143.5 x 91.5 毫米 | 111.5 x 63 毫米 | 110.5 x 62 毫米 |
| 7英寸显示屏 | 15 毫米 | 189.5 x 120 毫米 | 155.5 x 88 毫米 | 154.5 x 87 毫米 |
功能特性
触控显示屏 2（5 英寸与 7 英寸型号）具备以下特性：
- 720 x 1280 像素分辨率。 高清输出效果。
- 24 位 RGB 显示。 可呈现超过 1600 万种色彩。
- 多点触控。 支持同时响应五个触控点。
- 鼠标等效功能。 无需实体鼠标即可实现完整桌面控制，例如选择、拖拽、滚动及长按调出菜单。
- 屏幕键盘。 支持以虚拟键盘替代实体键盘。
- 集成供电。 直接由主机树莓派供电，无需独立电源适配器。
硬件
触摸显示屏 2 包装盒内含以下部件：
- 一块Touch Display 2
- 八颗M2.5螺丝
- 一条15针转15针柔性排线
- 一条适用于树莓派5的22针转15针柔性排线
- 一条GPIO电源线
下图从上至下、左至右展示了这些部件。
触摸显示屏 2 包装盒包含以下部件（如下图从左到右、从上到下的顺序）：
触摸显示屏 2 包装盒中包含的部件
连接器
触摸显示屏 2 通过以下方式连接至树莓派：
- DSI 连接器 用于传输视频和触摸数据。
- GPIO 接口 用于供电。
建立 DSI 连接时，请 使用显示屏随附的 扁平柔性电缆 (FFC)。所需的 FFC 类型取决于您的树莓派型号：
- 树莓派5需使用22针转15针FFC线
- 其他型号树莓派均需使用15针转15针FFC线
触控显示屏2兼容树莓派1B+及后续所有型号，但不支持未配备DSI接口的Zero系列和键盘系列。
连接树莓派
确定适用于您树莓派型号的正确FFC线缆后，即可将触摸屏2连接至树莓派。完成以下步骤后，可重新连接树莓派电源。树莓派操作系统可能需要最多一分钟时间才能开始向触摸屏2显示输出内容。
连接并安装到触摸显示屏 2 的 Raspberry Pi 5
执行以下步骤前，请先断开树莓派电源。
步骤1. 将柔性扁平电缆连接至触摸屏2
- 向外滑动触摸屏2上柔性扁平电缆连接器两侧的固定卡扣。.
- 将柔性扁平电缆的15针端口插入触摸屏2的柔性扁平电缆连接器，金属触点朝上，远离触摸屏2。
- 若连接树莓派5（需使用22针转15针FFC线），请注意22针端为线缆较小端。将较大端插入触摸屏2的FFC接口。
- 若使用15针转15针FFC线，可将线缆任一端插入触摸屏2的FFC接口。
- 牢固按压FFC线缆后，同时从两侧将固定卡扣推回触摸屏2的FFC接口。
步骤2. 将柔性扁平电缆连接至树莓派
- 从树莓派 DSI 连接器两侧向上滑动固定卡扣。
- 此接口应标有 DISPLAY、CAM/DISP 或 DISP 等字样。
- 若树莓派存在多个DSI接口，建议选用标注为1的端口。
- 将柔性扁平电缆另一端插入树莓派DSI接口，金属触点需朝向以太网口和USB-A接口方向。
- 牢固按压柔性扁平电缆的同时，将树莓派接口处的卡扣向下推回，确保线缆固定到位。
步骤3. 连接GPIO电源线
- 将GPIO电源线较细端插入触摸屏2的J1接口。.
- 将GPIO 电源线的三针端连接至树莓派GPIO接口。
红色线缆（5V电源）连接至第2脚，黑色线缆（接地）连接至第6脚。从顶部观察（以网口和USB-A接口朝下为基准），这些引脚位于电路板右上角，其中第2脚处于最右上端位置。
与触摸显示屏 2 的 GPIO 连接
错误连接电源线可能导致显示器损坏。
第4步：将树莓派安装至触摸屏2（可选）
可选操作：使用随附的M2.5螺丝将树莓派固定在触摸屏2背面。
- 将树莓派四角的支架孔与触摸显示屏2背面FFC连接器及J1接口周围的四个安装点对齐。.
- 将M2.5螺丝（随附）旋入四角支架孔，拧紧直至树莓派固定牢固。
操作时请注意避免夹住FFC线缆。
使用屏幕键盘
树莓派操作系统Bookworm及更高版本已内置Squeekboard屏幕键盘。连接触摸显示屏2后，该键盘会在可输入文本时自动显示，不可输入时自动隐藏。
对于不支持文本输入检测的应用程序，可通过任务栏右侧的键盘图标手动显示或隐藏键盘。您还可通过树莓派图形界面或命令行永久启用/禁用屏幕键盘：
- 树莓派桌面界面：从树莓派菜单进入首选项 > 树莓派配置 > 显示，选择屏幕键盘设置。
- 命令行操作： 打开终端输入
sudo raspi-config。在raspi-config菜单导航至 显示 选项卡，选择键盘设置。
调整屏幕方向
无论是否连接桌面系统，您均可更改触摸屏 2 的方向行为。此功能适用于物理旋转屏幕或横向安装设备的情况。
您有四种旋转选项：
- 0 保持默认显示位置，即纵向模式。
- 90 将显示屏向右旋转 90 度（顺时针方向），切换为横向模式。
- 180 将显示屏顺时针旋转180度，导致画面上下颠倒。
- 270 将显示屏顺时针旋转270度，效果等同于逆时针旋转90度，最终呈现横向显示。
桌面环境操作
若运行树莓派操作系统桌面环境，可通过屏幕配置工具旋转显示屏：.
- 进入首选项 > 屏幕配置。此操作将打开布局编辑器，其中显示已连接的显示设备。
- 右键点击布局编辑器中代表触摸屏2的矩形区域（通常标记为
DSI-1）。. - 选择方向。
- 选择旋转角度：0°、90°、180° 或 270°。该操作将显示屏向右旋转指定角度。
无桌面环境操作
要在不使用桌面的情况下旋转显示屏，请编辑/boot/firmware/cmdline.txt文件。该文件包含树莓派操作系统启动时读取的参数。在cmdline.txt末尾添加以下内容，并将<rotation-value>替换为所需旋转角度（0、90、180或270）：
video=DSI-1:720x1280@60,rotate=<rotation-value>
此 rotate= 设置仅旋转文本模式控制台；任何直接写入 DRM 的应用程序（如 cvlc 或 libcamera 应 用）不会被旋转，需要使用自身的旋转选项（如有可用）。
无法通过 cmdline.txt 独立旋转 DSI 显示屏与 HDMI 显示屏。当同时使用DSI和HDMI时，两者共享相同的旋转值。
自定义触摸屏设置
可通过设备树覆盖层告知树莓派操作系统如何在启动时配置触摸屏2：
- 5英寸显示屏对应覆盖层名为
vc4-kms-dsi-ili9881-5inch。 - 7英寸显示屏对应的覆盖层名为
vc4-kms-dsi-ili9881-7inch。
可在启动配置文件（/boot/firmware/config.txt）中修改设备树覆盖层。
打开/boot/firmware/config.txt，在dtoverlay行添加所需设备树参数，用逗号分隔。
- 布尔值（
invx、invy、swapxy和disable_touch）若存在则默认为 true，但可通过添加后缀=0设置为 false。 - 整数值（
sizex和sizey）需填写具体数值，例如sizey=240。
具体设置详见下表。
设备树选项
| 参数 | 功能 |
|---|---|
sizex | 设置触摸水平分辨率（默认值为720） |
sizey | 设置触摸垂直分辨率（默认值为720） |
invx | 反转触摸X轴（左右方向） |
invy | 反转触摸Y轴（上下方向） |
swapxy | 交换触摸X轴和Y轴（逻辑上旋转90°） |
disable_touch | 禁用触摸屏功能 |
示例
在下例中，invx 翻转 X 轴，invy 翻转 Y 轴，适用于 7 英寸触摸显示屏 2：
dtoverlay=vc4-kms-dsi-ili9881-7inch,invx,invy
连接计算模块
与树莓派单板计算机（SBC）自动检测官方树莓派触摸屏不同，树莓派计算模块不会自动检测连接的设备；您必须手动告知其连接了何种显示器。
这是因为树莓派系统芯片（SoC）与显示器接口（DSI）的连接是固定的，系统能识别连接的硬件；自动检测确保正确的设备树配置传递给Linux内核，使显示器无需额外配置即可工作。
计算模块面向工业及定制化应用，其所有通用输入输出接口（GPIO）和外设接口均对外开放。这虽提供了更强的硬件连接灵活性，但也意味着计算模块无法自动检测触摸屏2等设备。因此对于计算模块，必须手动指定告知内核如何与显示屏交互的设备树片段。可通过以下三种方式实现：
- 在
config.txt中添加覆盖条目。此为最简易方案。配置指南详见计算模块硬件文档。 - 使用自定义基础设备树文件。此为高级方法，未在本在线文档中涵盖。
- 使用HAT EEPROM（若存在）。
中文翻译版以英文版相同知识授权方式共享：CC-BY-SA 4.0。交流 Q群：498908352