4D SYSTEMS pixxiLCD-13P2-CTP-CLB 顯示Arduino平台評估擴展板用戶指南

使用者指南
像素液晶螢幕系列
pixxiLCD-13P2/CTP-CLB
pixxiLCD-20P2/CTP-CLB
pixxiLCD-25P4/CTP
pixxiLCD-39P4/CTP

像素液晶螢幕系列

*另提供蓋板鏡片邊框 (CLB) 版本。

變體：
PIXXI 處理器 (P2)
PIXXI 處理器 (P4)
非接觸式 (NT)
電容式觸控（CTP）
帶蓋板邊框的電容式觸控螢幕 (CTP-CLB)
本使用者指南將協助您開始使用 pixxiLCD-XXP2/P4-CTP/CTP-CLB 模組以及 WorkShop4 IDE。它還包括重要項目的列表amp文件和應用說明。

內容隱藏

4.2 選項 B – 使用 4D 編程電纜

4.3 選項 C – 使用 uUSB-PA5-II

盒子裡有什麼

支持文檔、數據表、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 在「系統需求」部分有更詳細的討論。

系統需求

以下小節討論了本手冊的硬件和軟件要求。

硬體

1. 智慧顯示模組及配件
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.Windows電腦
Workshop4 只能在 Windows 操作系統上運行。建議在 Windows 7 到 Windows 10 上使用，但仍應與 Windows XP 一起使用。一些較舊的操作系統，例如 ME 和 Vista，已經有一段時間沒有經過測試，但是，該軟件應該仍然可以工作。
如果您想在 Mac 或 Linux 等其他操作系統上運行 Workshop4，建議在您的 PC 上設置虛擬機 (VM)。

軟體

1.Workshop4 IDE
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

將 FFC 的一端連接到 pixxiLCD 的 15 路 ZIF 插座，並使 FFC 上的金屬接點面向閂鎖。

將 FFC 的另一端連接到 30D-UPA 上的 4 路 ZIF 插座，並使 FFC 上的金屬接點面向閂鎖
將 USB-Micro-B 電纜連接到 4D-UPA。
最後，將 USB-Micro-B 電纜的另一端連接到計算機。

選項 B – 使用 4D 編程電纜

將 FFC 的一端連接到 pixxiLCD 的 15 路 ZIF 插座，並使 FFC 上的金屬接點面向閂鎖。
將 FFC 的另一端連接到 gen30-IB 上的 4 路 ZIF 插座，並使 FFC 上的金屬接點面向閂鎖。

按照電纜和模組標籤上的方向將 5D 編程電纜的 4 針母接頭連接到 gen4-IB。您也可以藉助隨附的帶狀電纜來完成此操作。
將 4D 程式線的另一端連接至電腦。

選項 C – 使用 uUSB-PA5-II

將 FFC 的一端連接到 pixxiLCD 的 15 路 ZIF 插座，並使 FFC 上的金屬接點面向閂鎖。
將 FFC 的另一端連接到 gen30-IB 上的 4 路 ZIF 插座，並使 FFC 上的金屬接點面向閂鎖。

依照電纜和模組標籤上的方向將 uUSB-PA5-II 的 5 針母接頭連接到 gen4-IB。您也可以藉助隨附的帶狀電纜來完成此操作。
將 USB-Mini-B 連接線連接到 uUSB-PA5-II。
最後，將uUSB-Mini-B的另一端連接到電腦。

讓 WS4 識別顯示模塊

按照上一節中的相應說明進行操作後，您現在需要配置和設置 Workshop4 以確保它識別並連接到正確的顯示模塊。

打開 Workshop4 IDE 並創建一個新項目。
從列表中選擇您正在使用的顯示模塊。
為您的項目選擇所需的方向。
按一下下一步。
選擇一個 WS4 編程環境。只會啟用顯示模塊的兼容編程環境。

單擊 COMMS 選項卡，從下拉列表中選擇顯示模塊連接到的 COM 端口。
點擊紅點開始掃描顯示模塊。掃描時會顯示一個黃點。確保您的模塊連接正確。

最後，成功檢測會給您一個藍點，旁邊顯示顯示模塊的名稱。
單擊主頁選項卡開始創建您的項目。

開始一個簡單的項目

使用程式設計模組成功將顯示模組連接到 PC 後，您現在可以開始建立基本應用程式。本節介紹如何使用 ViSi-Genie 環境並利用滑桿和儀表小工具來設計簡單的使用者介面。
產生的項目由控制儀表（輸出小工具）的滑桿（輸入小工具）組成。這些小部件還可以配置為透過序列埠將事件訊息傳送到外部主機設備。

創建一個新的 ViSi-Genie 項目
您可以透過開啟 Workshop 並選擇要使用的顯示類型和環境來建立 ViSi-Genie 專案。該項目將使用 ViSi-Genie 環境。

雙擊圖標打開 Workshop4。
使用新選項卡創建新項目。
選擇您的顯示類型。
按一下“下一步”。
選擇 ViSi-Genie 環境。

添加滑塊小部件
若要新增滑桿小工具，只需按一下「首頁」標籤並選擇「輸入小工具」即可。從清單中，您可以選擇要使用的小工具類型。在本例中，選擇了滑桿小工具。

只需將小部件拖放到所見即所得 (WYSIWYG) 部分。

添加儀表小部件
要添加儀表小部件，請轉到儀表部分並選擇您要使用的儀表類型。在這種情況下，Coolgauge 小部件被選中。

將其拖放到 WYSIWYG 部分以繼續。

鏈接小部件
輸入小部件可以配置為控制輸出小部件。為此，只需單擊輸入（在此示例中amp文件，滑塊小部件）並轉到其對象檢查器部分並單擊事件選項卡。
輸入小工具的事件標籤下有兩個可用事件 - OnChanged 和 OnChanging。這些事件由在輸入小工具上執行的觸控操作觸發。
每次釋放輸入小工具時都會觸發 OnChanged 事件。另一方面，當觸摸輸入小工具時，OnChanging 事件會持續觸發。在這個前amp文件中，使用了OnChanging事件。透過點選 OnChanging 事件處理程序的省略號來設定事件處理程序。

出現事件選擇窗口。選擇coolgauge0Set，然後點擊OK。

配置輸入小部件以向主機發送消息
透過序列埠連接到顯示模組的外部主機可以了解小部件的狀態。這可以透過配置小部件將事件訊息傳送到序列埠來實現。為此，請將滑桿小工具的 OnChanged 事件處理程序設定為報告訊息。

microSD 卡/板載串行閃存
在 Pixxi 顯示模組上，小部件的圖形資料可以儲存到 microSD 卡/板載串列快閃記憶體中，顯示模組的圖形處理器將在運行時存取這些資料。然後圖形處理器將在顯示器上渲染小部件。

也必須將適當的 PmmC 上傳到 Pixxi 模組才能使用對應的儲存裝置。用於 microSD 卡支援的 PmmC 具有後綴“-u”，而用於板載串列快閃記憶體支援的 PmmC 具有後綴“-f”。
若要手動上傳 PmmC，請按一下「工具」選項卡，然後選擇 PmmC 載入程式。

構建和編譯項目
要構建/上傳項目，請單擊 (Build) Copy/Load 圖標。

複製所需 File到
microSD 卡/板載串行閃存

微型SD卡
WS4產生所需的圖形 files 並會提示您選擇安裝 microSD 卡的驅動器。確保 microSD 卡正確安裝到 PC，然後在復制確認窗口中選擇正確的驅動器，如下圖所示。

完成後點擊確定 files 被傳輸到 microSD 卡。從 PC 上卸下 microSD 卡並將其插入顯示模塊的 microSD 卡插槽。

板載串行快閃記憶體
選擇快閃記憶體作為圖形目標時 file，請確保模組中沒有連接microSD卡
將彈出複製確認窗口，如下訊息所示。

按一下“確定”，然後出現一個 File 將彈出傳輸視窗。等待過程結束，圖形現在將顯示在顯示模組上。

測試應用程序
應用程式現在應該在顯示模組上運行。現在應該顯示滑桿和儀表小工具。開始觸摸並移動滑桿小工具的拇指。其值的變化也會導致儀表小部件的值發生變化，因為這兩個小部件是連結的。

使用 GTX 工具檢查消息
WS4 中有一個工具，用於檢查顯示模塊發送到串口的事件消息。這個工具叫做“GTX”，代表“Genie Test eXecutor”。這個工具也可以被認為是外部主機設備的模擬器。 GTX 工具可以在工具部分下找到。單擊圖標以運行該工具。

移動並釋放滑桿將導致應用程式將事件訊息傳送到序列埠。然後，GTX Tool 將接收並列印這些訊息。有關 ViSiGenie 應用程式通訊協定的詳細信息，請參閱 ViSi-Genie 參考手冊。本文檔在「參考文檔」部分中進行了描述。

應用筆記

應用筆記	標題	描述	支持的環境
4D-AN-00117	設計師入門 - 第一個項目	本應用程式筆記展示如何使用設計器環境建立新專案。它也介紹了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

詞彙表

硬體

4D 編程電纜 – 4D 編程電纜是 USB 到串行 TTL UART 轉換器電纜。該電纜提供了一種快速簡單的方法，可以將所有需要 TTL 電平串行接口的 4D 設備連接到 USB。
嵌入式系統－在較大的機械或電氣系統中具有專用功能的程式控制和操作系統，通常具有
即時計算的限制。它作為完整設備的一部分嵌入，通常包括硬體和機械部件。
母頭 - 連接到電線、電纜或硬件的連接器，具有一個或多個凹孔，內部帶有電氣端子。

FFC – 柔性扁平電纜或FFC，指任何既扁平又柔韌的電纜。它用於將顯示器連接到編程適配器。
gen4 – IB – 一個簡單的接口，可將來自 gen30 顯示模組的 4 路 FFC 電纜轉換為用於編程的常見 5 種信號
以及與 4D Systems 產品的介面。
gen4-UPA – 通用程式設計器，設計用於與多個 4D Systems 顯示模組搭配使用。

Micro USB 電纜 – 一種用於將顯示器連接到計算機的電纜。
處理器 – 處理器是一種積體電子電路，用於執行運行計算設備的計算。它的基本工作是接收輸入並
提供適當的輸出。
編程適配器——用於對第 4 代顯示模塊進行編程，連接到用於原型設計的麵包板，連接到 Arduino 和 Raspberry Pi 接口。

電阻式觸控面板 – 一種觸控式電腦顯示器，由兩片塗有電阻材料並由氣隙或微點隔開的柔性片組成。
microSD 卡 – 一種用於存儲信息的可移動閃存卡。
uUSB-PA5-II – USB 至串列 TTL UART 橋接器轉換器。它為用戶提供高達 3M 波特率的多波特率串行數據，並可存取附加訊號，例如採用方便的 10 引腳 2.54 毫米（0.1 英寸）間距雙列直插式封裝中的流量控制。

零插入力 – 柔性扁平電纜插入的部分。

軟體

通信端口——用於連接顯示器等設備的串行通信端口或通道。
設備驅動程序——一種特殊形式的軟件應用程序，旨在實現與硬件設備的交互。如果沒有所需的設備驅動程序，相應的硬件設備將無法工作。

固件 – 為設備的特定硬件提供低級控制的特定類別的計算機軟件。
GTX Tool – Genie Test Executor 偵錯器。用於檢查顯示器發送和接收的資料的工具。
GUI – 一種使用者介面形式，允許使用者透過圖形圖示和視覺指示器（例如輔助符號、
鍵入命令標籤或文字導航而不是基於文字的使用者介面。

影像 Files - 是圖形 files 在程序編譯時生成，應保存到 microSD 卡中。
Object Inspector – Workshop4 中的一個部分，用戶可以在其中更改某個小部件的屬性。這是小部件定制和事件配置發生的地方。
小部件 - Workshop4 中的圖形對象。
所見即所得——所見即所得。 Workshop4 中的圖形編輯器部分，用戶可以在其中拖放小部件。

訪問我們的 web網站位於： www.4dsystems.com.au
技術支援： www.4dsystems.com.au/support
銷售支持： sales@4dsystems.com.au

文件/資源

4D SYSTEMS pixxiLCD-13P2-CTP-CLB 顯示 Arduino 平台評估擴充板 [pdf] 使用者指南
pixxiLCD-13P2-CTP-CLB，顯示Arduino平台評估擴充板，平台評估擴充板，評估擴充板，pixxiLCD-13P2-CTP-CLB，擴充板

參考

使用者手冊