4D SYSTEMS gen4-4DPI-43T/CT-CLB 树莓派智能显示模块用户指南

gen4-4DPi-XXT 和 gen4-4DPi-XXCT-CLB 是 4D Systems 为 Raspberry Pi 板设计和制造的 gen4 系列显示模块的一部分。这些模块具有通过 Raspberry Pi 板供电的 4.3”、5.0” 和 7.0” 彩色 LCD 显示屏，并提供电阻式和电容式触摸变体 - 分别为 gen4-4DPi-XXT 和 gen4-4DPi XXCT-CLB。

系统要求

以下小节讨论了本手册的硬件和软件要求。

硬件

Raspberry Pi 开发板
最重要的要求之一是将用作 4DPi 显示器的 CPU 的 Raspberry Pi。

gen4-4DPi-XXT/CT-CLB
gen4-4DPi-XXT/CT-CLB 及其配件包含在包装盒中，在您从我们的购买后交付给您 web网站或通过我们的经销商之一。有关显示模块及其附件的图片，请参阅“包装盒中的物品”部分。
gen4-4DPi 适配器
适配器放置在 Raspberry Pi 的顶部。您可以参考描述上的图像以查看正确的方向。

30 路扁平柔性电缆 (FFC)
Flat Flex 电缆连接到适配器以将其连接到 gen4-4DPi-XXT/CT-CLB。
5V 直流电源
要了解电源所需的规格，请参阅 gen4-4DPi 数据表。

要求

gen4-4DPi 旨在与在 Raspberry Pi 上运行的 Raspbian 操作系统配合使用，因为这是官方的 Raspberry Pi 操作系统。

笔记
Raspbian OS 映像可在官方 Raspberry Pi 获得 web地点。

如何使用 GEN4-4DPI-XXT/CT-CLB

下载和安装

下载最新的树莓派
https://www.raspberrypi.com/software/
将树莓派镜像加载到 SD 卡中
加载图像后 file，将 SD 卡插入树莓派并通电。
笔记： 暂时不要连接 gen4-4DPI-XXT/CT-CLB！
要么使用标准的“pi”和“raspberry”凭据从键盘/显示器登录到 Raspberry Pi，否则 SSH 到您的 Raspberry PI 并通过 SSH 会话登录。

更新和升级您的 Raspberry Pi，以确保您运行的是最新版本的内核和固件。
sudo apt-get 更新
sudo apt-get 升级
笔记： 只有在确保 4D 的最新内核包支持最新内核后才能进行升级。否则，安装 4D 内核包会降级内核。
重启树莓派
sudo 重启
重启后，再次登录您的树莓派，您需要下载并安装支持 gen4-4DPi 显示器的内核。

要从 4D Systems 服务器下载并安装内核映像，请参阅 gen4-4DPi 数据表
成功安装镜像后 file，关闭树莓派安全
笔记： 并在完成关机后拔掉电源。
关机
or
sudo 立即关机

如下图所示将 gen4-4DPi 显示器连接到 Raspberry Pi 并重新接通电源

校准电阻式触控

从 4D Systems 工厂发货的每个 gen4-4DPi 都略有不同，因为每个触摸屏的校准都略有不同。为了从您的 gen4-4DPi 中获得最佳效果，您需要校准显示器，使其尽可能准确。

要校准触摸屏，需要 xinput_calibrator 并应执行以下步骤。在开始之前确保桌面没有运行，如果是则退出桌面并返回终端提示符。请注意，只能校准电阻式触摸显示模块。

通过从终端运行它来安装 xinput_calibrator（如果默认情况下未安装）：
sudo apt-get 安装 xinput-校准器

安装事件设备输入驱动：
sudo apt-get 安装 xserver-xorg-input-evdev
重命名 10-evdev.conf file 到 45-evdev.conf
sudo mv /usr/share/X11/xorg.conf.d/10-evdev.conf /usr/share /X11/xorg.conf.d/45-evdev.conf

检查 evdev.conf 的数字是否高于 libinput.conf ls /usr/share/X11/xorg.conf.d/
用户应该得到这样的东西
10-quirks.conf 40-libinput.conf 45-evdev.conf 99 fbturbo.conf
执行重启
sudo 立即重启
重新连接到 SSH 并运行 xinput 校准器。
显示=：0.0 xinput_calibrator
执行校准并复制结果。
结果应该与此类似
“输入类”部分
标识符“校准”
匹配产品“AR1020触摸屏”
选项“校准”“98 4001 175 3840”
选项“交换轴”“0”
结束部分

您可以在 xinput 校准器结束后测试更改。要使更改永久生效，请将结果粘贴到calibration.conf file.
须藤纳米/etc/X11/xorg.conf.d/99-calibration.conf
保存 file 并执行重启
sudo 立即重启

更改显示方向

可以更改显示器的屏幕方向。为了实现这一点，有两件事需要改变：

要更改显示方向，只需编辑 cmdline.txt file
sudo nano /boot/cmdline.txt
在参数列表的第二个位置添加下面的参数：4dpi.rotate = 90
并将其更改为具有 0、90、180 或 170 的值。它应该类似于：
dwc_otg.lpm_enable=0 4dpi.rotate=90 控制台=serial0,115200
保存 file 并重新启动您的树莓派。由于自定义内核，触摸屏将自动重新映射对齐。

背光控制
背光亮度可以从终端或 bash 脚本控制。以下命令可用于设置背光从 0 到 100%

sudo sh -c 'echo 31 > /sys/class/backlight/4dhats/brightness'

以上将背光设置为 100%。只需将“echo 31”更改为 0 到 31 之间的任何值。

开始一个简单的项目

连接显示器并闪烁图像后，您现在可以开始做项目了。这个项目只是在 gen4-4DPi 上显示一个消息框，上面写着“HELLO WORLD”。

第 1 部分：脚本

第 1 步：更新 Python 版本
本项目使用 Python 3.5.3。要知道你的 python3 的版本，你可以使用

$ python3 ––版本

您可以使用以下命令更新您的 python3 版本

$ sudo apt-get 更新
$ sudo apt-get 安装 python3

第 2 步：安装 PyQt
PyQt 是最流行的 Python 绑定之一。该项目使用 PyQt 绑定来显示输出。

要安装 PyQt，请运行以下命令：

$ sudo apt-get 安装 python3-pyqt4

第 3 步：连接到 SSH
您可以通过多种方式从远程终端操作您的 BeagleBone 设备。这个前任ample 展示了如何使用 SSH 进行操作。

使用您的 SSH 登录。本应用笔记使用 MobaXterm 工具通过 SSH 进行连接。
转到桌面并创建一个新的 file “HelloWorld.py”。
使用 Sublime Text 或您计算机中安装的任何其他编辑器打开。
粘贴下面的脚本并保存：
导入系统
从 PyQt4 导入 QtGui
定义窗口（）：
应用程序 = QtGui.QApplication(sys.argv)
小部件 = QtGui.QWidget()
标签 = QtGui.QLabel（小部件）
label.setText(“你好世界！”)
小部件.setWindowTitle（“PyQt”）
小部件.show()
系统退出（app.exec_（））
如果名称 == '主要'：
窗户（）

第 2 部分：运行项目

选项 1：使用 Raspberry Pi 终端运行 Python 脚本
要使用 gen4-4DPi 显示器运行 python 脚本，请导航到保存 python 脚本的位置，然后运行命令：

$ python3 HelloWorld.py

选项 2：使用 SSH 运行 Python 脚本
导航到脚本的目录（在本例中为桌面）。

这是可选的，但您可以通过运行在远程终端中测试您的脚本，

$ python3 HelloWorld.py

要从远程终端运行脚本并将其显示在 gen4-4DPi 上，
$ DISPLAY=:0.0 python3 HelloWorld.py

gen4-4DPi 现在应该如下所示：

参考文档

“HelloWorld”项目是几乎所有语言（包括 Python）中最常见和最基础的项目之一。以下是可以帮助用户进一步增强 GUI 编程并了解更多有关 gen4-4DPi 的站点和文档的列表：

gen4-4DPi 数据表
本文档包含与 gen4 4DPi 相关的基本信息。

树莓派 Web地点
获取有关 Raspberry Pi 和各种可用发行版的信息和支持的好地方。

树莓派最新图片
这 web站点详细介绍了 Raspberry Pi 的最新固件映像。

笔记： 有关 gen4-4DPi 硬件的支持，请访问 www.4dsystems.com.au 并通过工单直接联系支持人员，或使用 4D Systems 论坛。

词汇表

背光 – LCD 显示模块中使用的一种照明形式。
校准触摸 - 为提高触摸屏控制器提供的转换触摸位置的准确性而执行的过程。
固件 – 编程到只读存储器中的永久软件。

图像 File – 以某种非易失性形式存储的计算机系统整个状态的序列化副本。
内核——管理计算机和硬件的操作。
PyQt – PyQt 是 Qt 跨平台 C++ 框架最流行的 Python 绑定之一。

Python – 一种高级编程语言，旨在易于阅读和实现。
Raspbian – Raspberry Pi 使用的官方操作系统。
重启——关闭和重启设备的实例。

电阻式触控显示器 – 一种触控式显示器，由两片涂有电阻材料并由气隙或微点隔开的柔性片组成。
SSH – Secure Shell 或 Secure Socket Shell，是一种网络协议，它为用户（尤其是系统管理员）提供了一种通过不安全网络访问计算机的安全方式。

访问我们的 web网站位于： www.4dsystems.com.au
技术支援： www.4dsystems.com.au/support
销售支持： sales@4dsystems.com.au

文件/资源

适用于树莓派的 4D SYSTEMS gen4-4DPI-43T/CT-CLB 智能显示模块 [pdf] 用户指南
gen4-4DPI-43T CT-CLB, gen4-4DPI-50T CT-CLB, gen4-4DPI-70T CT-CLB, gen4-4DPI系列, 树莓派智能显示模组, gen4-4DPI-43T CT-CLB智能显示模组树莓派

参考

用户手册

包装内容

介绍