用户指南
pixxiLCD系列
pixxiLCD-13P2/CTP-CLB
pixxiLCD-20P2/CTP-CLB
pixxiLCD-25P4/CTP
pixxiLCD-39P4/CTP

pixxiLCD系列

* 也可提供覆盖镜头挡板 (CLB) 版本。

变体：
PIXXI 处理器 (P2)
PIXXI 处理器 (P4)
非接触式 (NT)
电容式触控 (CTP)
带盖板挡板的电容式触控 (CTP-CLB)
本用户指南将帮助您开始使用 pixxiLCD-XXP2/P4-CTP/CTP-CLB 模块以及 WorkShop4 IDE。 它还包括一份重要项目清单amp文件和应用说明。

包装内容

支持文档、数据表、CAD 步骤模型和应用说明可在 www.4dsystems.com.au

介绍

本用户指南介绍了如何熟悉 pixxiLCDXXP2/P4-CT/CT-CLB 和与之相关的软件 IDE。 本手册应
仅作为有用的起点，而不是全面的参考文件。 有关所有详细参考文档的列表，请参阅应用说明。

在本用户指南中，我们将简要关注以下主题：

• 硬件和软件要求
• 将显示模块连接到您的 PC
• 简单项目入门
• 使用 pixxiLCD-XXP2/P4-CT/CT-CLB 的项目
• 应用说明
• 参考文档

pixxiLCD-XXP2/P4-CT/CT-CLB 是由 4D Systems 设计和制造的 Pixxi 系列显示模块的一部分。 该模块具有 1.3 英寸圆形、2.0 英寸、2.5 英寸或 3.9 色 TFT LCD 显示屏，可选电容式触控。 它由功能丰富的 4D Systems Pixxi22/Pixxi44 图形处理器提供支持，为设计师/集成商/用户提供一系列功能和选项。
智能显示模块是低成本的嵌入式解决方案，用于医疗、制造、军事、汽车、家庭自动化、消费电子等行业的各种应用。 事实上，当今市场上很少有没有显示器的嵌入式设计。 甚至许多消费类白色家电和厨房电器都包含某种形式的展示。 在工业机器、恒温器、饮料分配器、3D 打印机、商业应用——几乎任何电子应用中，按钮、旋转选择器、开关和其他输入设备正在被色彩更丰富、更易于使用的触摸屏显示器所取代。
为了让设计人员/用户能够为其应用程序创建和设计将在 4D 智能显示模块上运行的用户界面，4D Systems 提供了一个免费且用户友好的软件 IDE（集成开发环境），称为“Workshop4”或“WS4” . 此软件 IDE 在“系统要求”一节中进行了更详细的讨论。

系统要求

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

硬件

一、智能显示模组及配件
包装盒中包含 pixxiLCD-xxP2/P4-CT/CT-CLB 智能显示模块及其配件（转接板和扁平排线），在您从我们的购买后交付给您 web网站或通过我们的经销商之一。 有关显示模块及其附件的图片，请参阅“包装盒中的物品”部分。
2. 编程模块
编程模块是将显示模块连接到 Windows PC 所需的单独设备。 4D Systems 提供以下编程模块：

• 4D编程电缆
• uUSB-PA5-II 编程适配器
• 4D-UPA

要使用编程模块，必须先在 PC 中安装相应的驱动程序。
您可以参考给定模块的产品页面以获取更多信息和详细说明。
笔记： 该设备与 4D Systems 分开提供。 请参阅产品页面了解更多信息。

3.媒体存储
Workshop4 具有可用于设计显示 UI 的内置小部件。 这些小部件中的大多数都需要与其他图形一起存储在存储设备中，例如 microSD 卡或外部闪存 files 在编译步骤中。
注意：microSD 卡和外部闪存是可选的，只有使用图形的项目才需要 files.
另请注意，并非市场上的所有 microSD 卡都兼容 SPI，因此并非所有卡都可用于 4D Systems 产品。 放心购买，选择 4D Systems 推荐的显卡。

4. 视窗电脑
Workshop4 只能在 Windows 操作系统上运行。 建议在 Windows 7 到 Windows 10 上使用，但仍应与 Windows XP 一起使用。 一些较旧的操作系统，例如 ME 和 Vista，已经有一段时间没有经过测试，但是，该软件应该仍然可以工作。
如果您想在 Mac 或 Linux 等其他操作系统上运行 Workshop4，建议您在 PC 上设置虚拟机 (VM)。

软件

1. Workshop4 集成开发环境
Workshop4 是适用于 Microsoft Windows 的综合软件 IDE，它为所有 4D 系列处理器和模块提供集成软件开发平台。 IDE 结合了编辑器、编译器、链接器和下载器来开发完整的 4DGL 应用程序代码。 所有用户应用程序代码都是在 Workshop4 IDE 中开发的。
Workshop4 包含三种开发环境，供用户根据应用需求甚至用户技能水平进行选择——Designer、ViSi-Genie 和 ViSi。

Workshop4 环境
设计师
该环境使用户能够以自然形式编写 4DGL 代码来对显示模块进行编程。

ViSi – 精灵
完全不需要任何 4DGL 编码的高级环境，所有这些都是自动为您完成的。 只需使用您想要的对象（类似于 ViSi）布置显示器，设置事件以驱动它们，然后自动为您编写代码。 ViSi-Genie 提供来自 4D Systems 的最新快速开发体验。

硅
一种可视化编程体验，支持拖放式放置对象以协助 4DGL 代码生成，并允许用户可视化如何
显示器将在开发时看起来。

2. 安装 Workshop4
可以在 Workshop4 产品页面上找到 WS4 安装程序和安装指南的下载链接。

将显示模块连接到电脑
本节显示了将显示器连接到 PC 的完整说明。 此部分下有三 (3) 个说明选项，如下图所示。 每个选项都特定于一个编程模块。 仅遵循适用于您正在使用的编程模块的说明。

连接选项

选项 A – 使用 4D-UPA

1. 将 FFC 的一端连接到 pixxiLCD 的 15 路 ZIF 插座，使 FFC 上的金属触点面向闩锁。
2. 将 FFC 的另一端连接到 30D-UPA 上的 4 路 ZIF 插座，使 FFC 上的金属触点朝向闩锁
3. 将 USB-Micro-B 电缆连接到 4D-UPA。
4. 最后，将 USB-Micro-B 电缆的另一端连接到计算机。

选项 B – 使用 4D 编程电缆

1. 将 FFC 的一端连接到 pixxiLCD 的 15 路 ZIF 插座，使 FFC 上的金属触点面向闩锁。
2. 将 FFC 的另一端连接到 gen30-IB 上的 4 路 ZIF 插座，FFC 上的金属触点面向闩锁。
3. 按照电缆和模块标签上的方向将 5D 编程电缆的 4 针母头连接到 gen4-IB。 您也可以在提供的带状电缆的帮助下做到这一点。
4. 将 4D 编程电缆的另一端连接到计算机。

选项 C – 使用 uUSB-PA5-II

1. 将 FFC 的一端连接到 pixxiLCD 的 15 路 ZIF 插座，使 FFC 上的金属触点面向闩锁。
2. 将 FFC 的另一端连接到 gen30-IB 上的 4 路 ZIF 插座，FFC 上的金属触点面向闩锁。
3. 按照电缆和模块标签上的方向将 uUSB-PA5-II 的 5 针母头连接到 gen4-IB。 您也可以在提供的带状电缆的帮助下做到这一点。
4. 将 USB-Mini-B 电缆连接到 uUSB-PA5-II。
5. 最后，将 uUSB-Mini-B 的另一端连接到计算机。

让 WS4 识别显示模块

按照上一节中的相应说明进行操作后，您现在需要配置和设置 Workshop4 以确保它识别并连接到正确的显示模块。

1. 打开 Workshop4 IDE 并创建一个新项目。
2. 从列表中选择您正在使用的显示模块。
3. 为您的项目选择所需的方向。
4. 单击“下一步”。
5. 选择一个 WS4 编程环境。 只会启用显示模块的兼容编程环境。
   
6. 单击 COMMS 选项卡，从下拉列表中选择显示模块连接到的 COM 端口。
7. 点击红点开始扫描显示模块。 扫描时会显示一个黄点。 确保您的模块连接正确。
8. 最后，成功检测将为您提供一个蓝点，旁边显示显示模块的名称。
9. 单击主页选项卡开始创建您的项目。

开始一个简单的项目

使用编程模块将显示模块成功连接到 PC 后，您现在可以开始创建基本应用程序。 本节介绍如何使用 ViSi-Genie 环境并利用滑块和仪表小部件设计简单的用户界面。
生成的项目包含一个滑块（一个输入小部件），它控制一个仪表（一个输出小部件）。 小部件还可以配置为通过串行端口将事件消息发送到外部主机设备。

创建一个新的 ViSi-Genie 项目
您可以通过打开 Workshop 并选择要使用的显示类型和环境来创建 ViSi-Genie 项目。 该项目将使用 ViSi-Genie 环境。

1. 双击图标打开 Workshop4。
2. 使用新选项卡创建新项目。
3. 选择您的显示类型。
4. 单击“下一步”。
5. 选择 ViSi-Genie 环境。

添加滑块小部件
要添加滑块小部件，只需单击主页选项卡并选择输入小部件。 从列表中，您可以选择要使用的小部件类型。 在这种情况下，选择了滑块小部件。

只需将小部件拖放到所见即所得 (WYSIWYG) 部分即可。

添加仪表小部件
要添加仪表小部件，请转到仪表部分并选择您要使用的仪表类型。 在这种情况下，Coolgauge 小部件被选中。

将其拖放到 WYSIWYG 部分以继续。

链接小部件
输入小部件可以配置为控制输出小部件。 为此，只需单击输入（在此示例中ample，滑块小部件）并转到其对象检查器部分并单击事件选项卡。
输入小部件的事件选项卡下有两个可用事件 - OnChanged 和 OnChanging。 这些事件由在输入小部件上执行的触摸操作触发。
每次释放输入小部件时都会触发 OnChanged 事件。 另一方面，在触摸输入小部件时会连续触发 OnChanging 事件。 在这个前amp即，使用 OnChanging 事件。 通过单击 OnChanging 事件处理程序的省略号来设置事件处理程序。

出现事件选择窗口。 选择coolgauge0Set，然后点击OK。

配置输入小部件以向主机发送消息
通过串口连接到显示模块的外部主机可以知道小部件的状态。 这可以通过将小部件配置为将事件消息发送到串行端口来实现。 为此，请将滑块小部件的 OnChanged 事件处理程序设置为 Report Message。

microSD 卡/板载串行闪存
在 Pixxi 显示模块上，小部件的图形数据可以存储到 microSD 卡/板载串行闪存中，显示模块的图形处理器将在运行时访问这些数据。 然后，图形处理器将在显示器上呈现小部件。

相应的 PmmC 还必须上传到 Pixxi 模块才能使用相应的存储设备。 支持 microSD 卡的 PmmC 带有后缀“-u”，而支持板载串行闪存的 PmmC 带有后缀“-f”。
要手动上传 PmmC，请单击工具选项卡，然后选择 PmmC 加载器。

构建和编译项目
要构建/上传项目，请单击 (Build) Copy/Load 图标。

复制所需 File到
microSD 卡/板载串行闪存

microSD 卡
WS4 生成所需的图形 files 并会提示您选择安装 microSD 卡的驱动器。 确保 microSD 卡正确安装到 PC，然后在复制确认窗口中选择正确的驱动器，如下图所示。

完成后点击确定 files 被传输到 microSD 卡。 从 PC 上卸下 microSD 卡并将其插入显示模块的 microSD 卡插槽。

板载串行闪存
选择闪存作为图形目标时 file, 确保模块中没有连接 microSD 卡
将弹出一个复制确认窗口，如下面的消息所示。

单击确定，然后 File 将弹出传输窗口。 等待过程结束，图形现在将显示在显示模块上。

测试应用程序
应用程序现在应该在显示模块上运行。 现在应该显示滑块和仪表小部件。 开始触摸和移动滑块小部件的拇指。 其值的变化也应该导致仪表小部件值的变化，因为这两个小部件是链接的。

使用 GTX 工具检查消息
WS4 中有一个工具，用于检查显示模块发送到串口的事件消息。 这个工具叫做“GTX”，代表“Genie Test eXecutor”。 这个工具也可以被认为是外部主机设备的模拟器。 GTX 工具可以在工具部分下找到。 单击图标以运行该工具。

移动和释放滑块的拇指将导致应用程序向串行端口发送事件消息。 这些消息将被 GTX 工具接收并打印出来。 有关 ViSiGenie 应用程序通信协议的详细信息，请参阅 ViSi-Genie 参考手册。 本文档在“参考文档”部分中进行了描述。

应用说明

应用说明	标题	描述	支持的环境
4D-AN-00117	设计师入门 - 第一个项目	本应用笔记展示了如何使用 Designer 环境创建新项目。 它还介绍了 4DGL（4D 图形语言）的基础知识。	设计师
4D-AN-00204	ViSi 入门 - Pixxi 的第一个项目	本应用笔记展示了如何使用 ViSi 环境创建新项目。 它还介绍了 4DGL（4D 图形语言）的基础知识和 WYSIWYG（所见即所得）屏幕的基本使用。	硅
4D-AN-00203	维西精灵 入门——Pixxi 显示器的第一个项目	本应用笔记中开发的简单项目演示了使用 ViSi-Genie 的基本触摸功能和对象交互 环境。 该项目说明了如何配置输入对象以将消息发送到外部主机控制器以及如何解释这些消息。	ViSi-精灵

参考文档

ViSi-Genie 是推荐给初学者的环境。 该环境不一定涉及编码，这使其成为四种环境中对用户最友好的平台。
然而，ViSi-Genie 有其局限性。 对于希望在应用程序设计和开发过程中获得更多控制和灵活性的用户，建议使用 Designer 或 ViSi 环境。 ViSi 和 Designer 允许用户为其应用程序编写代码。
4D Systems 图形处理器使用的编程语言称为“4DGL”。 下面列出了可用于进一步研究不同环境的基本参考文件。

ViSi-Genie 参考手册
ViSi-Genie 完成所有背景编码，无需学习 4DGL，它为您完成所有工作。 本文档涵盖了可用于 PIXXI、PICASO 和 DIABLO16 处理器的 ViSi-Genie 功能以及被称为 Genie 标准协议的通信协议。

4DGL 程序员参考手册
4DGL 是一种面向图形的语言，允许快速应用程序开发。 丰富的图形、文本库和 file 系统功能和语言的易用性，它结合了 C、Basic、Pascal 等语言的最佳元素和语法结构。本文档涵盖了语言风格、语法和流程控制。

内部功能手册
4DGL 有许多内部函数，可用于更轻松的编程。 本文档涵盖了可用于 pixxi 处理器的内部（芯片驻留）功能。

pixxiLCD-13P2/P2CT-CLB 数据表
本文档包含有关 pixxiLCD-13P2/P2CT-CLB 集成显示模块的详细信息。

pixxiLCD-20P2/P2CT-CLB 数据表
本文档包含有关 pixxiLCD-20P2/P2CT-CLB 集成显示模块的详细信息。

pixxiLCD-25P4/P4CT 数据表
本文档包含有关 pixxiLCD-25P4/P4CT 集成显示模块的详细信息。

pixxiLCD-39P4/P4CT 数据表
本文档包含有关 pixxiLCD-39P4/P4CT 集成显示模块的详细信息。

Workshop4 IDE 用户指南
本文档介绍了 4D Systems 的集成开发环境 Workshop4。

笔记： 有关 Workshop4 的更多信息，请参阅 Workshop4 IDE 用户指南，网址为 www.4dsystems.com.au

词汇表

硬件

1. 4D 编程电缆 – 4D 编程电缆是 USB 到串行 TTL UART 转换器电缆。 该电缆提供了一种快速简单的方法，可以将所有需要 TTL 电平串行接口的 4D 设备连接到 USB。
2. 嵌入式系统——在较大的机械或电气系统中具有专用功能的编程控制和操作系统，通常具有
   实时计算约束。 它作为完整设备的一部分嵌入，通常包括硬件和机械部件。
3. 母头 - 一种连接到电线、电缆或硬件的连接器，具有一个或多个带有内部电气端子的凹孔。
4. FFC – 柔性扁平电缆，或 FFC，是指任何种类的扁平和柔性电缆。 它用于将显示器连接到编程适配器。
5. gen4 – IB – 一个简单的接口，可将来自您的 gen30 显示模块的 4 路 FFC 电缆转换为用于编程的常用 5 信号
   并连接到 4D Systems 产品。
6. gen4-UPA – 一种通用编程器，设计用于多个 4D Systems 显示模块。
7. Micro USB 电缆 – 一种用于将显示器连接到计算机的电缆。
8. 处理器——处理器是一种集成电子电路，它执行运行计算设备的计算。 它的基本工作是接收输入和
   提供适当的输出。
9. 编程适配器——用于对第 4 代显示模块进行编程，连接到用于原型设计的面包板，连接到 Arduino 和 Raspberry Pi 接口。
10. 电阻式触控面板 – 一种触控式电脑显示器，由两片涂有电阻材料并由气隙或微点隔开的柔性片组成。
11. microSD 卡 – 一种用于存储信息的可移动闪存卡。
12. uUSB-PA5-II – USB 到串行 TTL UART 桥接转换器。 它为用户提供高达 3M 波特率的多波特率串行数据，并在方便的 10 针 2.54 毫米（0.1 英寸）间距双列直插式封装中访问附加信号，例如流量控制。
13. 零插入力——柔性扁平电缆插入的部分。

软件

1. 通信端口——用于连接显示器等设备的串行通信端口或通道。
2. 设备驱动程序——一种特殊形式的软件应用程序，旨在实现与硬件设备的交互。 如果没有所需的设备驱动程序，相应的硬件设备将无法工作。
3. 固件 – 为设备的特定硬件提供低级控制的特定计算机软件类别。
4. GTX 工具 – Genie 测试执行器调试器。 用于检查显示器发送和接收的数据的工具。
5. GUI – 一种用户界面形式，允许用户通过图形图标和视觉指示器（例如二级符号）与电子设备进行交互，
   而不是基于文本的用户界面，键入命令标签或文本导航。
6. 图像 Files - 是图形 files 在程序编译时生成，应保存到 microSD 卡中。
7. Object Inspector – Workshop4 中的一个部分，用户可以在其中更改某个小部件的属性。 这是小部件定制和事件配置发生的地方。
8. 小部件 - Workshop4 中的图形对象。
9. 所见即所得——所见即所得。 Workshop4 中的图形编辑器部分，用户可以在其中拖放小部件。

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

版权所有 © 4D Systems，2022，保留所有权利。
所有商标均属于其各自所有者并得到认可和承认。

文件/资源

4D SYSTEMS pixxiLCD-13P2-CTP-CLB 显示Arduino平台评估扩展板 [pdf] 用户指南 pixxiLCD-13P2-CTP-CLB,Display Arduino平台评估扩展板,平台评估扩展板,评估扩展板,pixxiLCD-13P2-CTP-CLB,扩展板

参考

• 用户手册