GTT2.5協(xié)議開發(fā)者手冊解讀

一、GTT2.5協(xié)議簡介

GTT 2.5命令協(xié)議是面向?qū)ο筌浖O計的一次進化。它允許用戶通過在RAM中存儲值，動態(tài)修改各種對象屬性，如值、字符串和顏色設置等。與舊的GTT 2.0命令集相比，GTT 2.5協(xié)議為開發(fā)者在人機界面（HMI）設計中提供了更大的靈活性和控制力。不過，GTT 2.5協(xié)議并沒有完全取代GTT 2.0命令集，所有GTT 2.0命令仍可與GTT 2.5命令結(jié)合使用。在升級到包含2.5協(xié)議的較新固件時，GTT 2.0命令的功能依然保留，基于GTT 2.0命令開發(fā)的GTT Designer項目也保持兼容，且GTT 2.5命令在運行固件1.10及以上版本中可用。

文件下載：GTT29A-TPN-BLM-B0-H1-CS-VPT.pdf

二、GTT2.5協(xié)議元素

（一）對象（Objects）

對象類型：屏幕上顯示的每個元素都被表示為一個對象，每個對象都屬于特定類型，并被分配一個唯一的標識符。常見的對象類型包括GTT25Gauge（值為3）、Label（值為9）、Slider（值為10）、Button（值為21）等。
創(chuàng)建對象：創(chuàng)建對象的方法由一系列字節(jié)組成，在設置對象的相關(guān)屬性之前，必須先創(chuàng)建對象。對象創(chuàng)建后，其相關(guān)屬性會被賦予默認值，用戶可以使用相應的設置或獲取方法來設置或檢索這些屬性。

（二）屬性（Properties）

屬性類型：每個對象都可以有多個不同的屬性，不同對象有其獨特的屬性集。例如，Gauge對象的常見屬性類型包括MinValue、MaxValue、Value等；Label對象的常見屬性類型有BackgroundR、BackgroundG、ForegroundR等。
設置屬性值：設置對象字節(jié)長度屬性值的方法由一系列字節(jié)組成，某些屬性（如基于文本的屬性）可能需要不同的數(shù)據(jù)類型。GTT Designer生成的項目報告將包含更詳細的信息，說明設置特定屬性所需的數(shù)據(jù)類型以及屏幕上每個特定對象類型可用的屬性。
獲取屬性值：獲取對象字節(jié)長度屬性值的方法也由一系列字節(jié)組成，所有GTT 2.5屬性值都可以使用相應的獲取屬性命令進行讀取，包括文本字符串、按鈕狀態(tài)以及條形圖和儀表值等。
返回消息：執(zhí)行獲取對象字節(jié)長度屬性值的命令后，返回消息的字節(jié)組成會根據(jù)返回的屬性信息類型而有所不同。例如，文本屬性在讀取時可能返回一串字符。如果主機不讀取返回消息，可能會導致GTT的返回緩沖區(qū)填滿，從而使GTT重啟。可以通過將通信通道設置為None來關(guān)閉GTT的返回消息。
狀態(tài)代碼：在GTT 2.5命令協(xié)議中，每個命令都會生成一個狀態(tài)返回，常見的狀態(tài)代碼包括FileNotFound、InvalidBitmapFileFormat等。

（三）事件（Events）

事件類型：許多事件由字節(jié)組合表示，如按鈕點擊、屬性更改成功和屬性反饋等事件會報告給主機，并通過特定的事件字節(jié)組合進行區(qū)分。常見的事件類型有GTT25BaseObject_OnPropertyChange、GTT25VisualObject_OnKey、Button_Click等。
事件消息：事件反饋遵循類似的消息格式，但可能會根據(jù)返回的數(shù)據(jù)類型有所不同。事件發(fā)生后，GTT會立即生成事件消息并返回給主機，主機可以根據(jù)事件類型、對象ID和值來確定發(fā)生了什么，并采取相應的行動。

（四）方法（Methods）

除了用于屬性的基本獲取和設置方法外，一些對象還有獨特的方法，如動畫對象的Start方法。

三、資源

（一）GTT Designer報告

GTT Designer生成的Report.txt文件列出了所有對象以及獲取和設置相關(guān)屬性的方法。該文件位于項目生成完成后的Output目錄中，在開發(fā)過程中可直接參考，它會突出顯示哪些對象屬性可以更改，并提供修改對象屬性時要發(fā)送和期望接收的數(shù)據(jù)類型信息。

（二）GTT2.5代碼庫

GTT 2.5命令協(xié)議允許開發(fā)者使用一套生成的代碼庫將GTT項目輕松連接到主機設備。代碼庫包括特定于GTT項目的.c/.h文件、用于打包數(shù)據(jù)的工作函數(shù)以及特定于主機設備的接口庫。

Designer .c/.h項目文件：位于項目生成完成后的Output目錄中，提供了所有對象標識符的列表以及用于獲取和設置這些對象相關(guān)屬性的簡單函數(shù)。
GTT客戶端庫：GTT Designer創(chuàng)建的.c和.h項目文件需要一些支持代碼才能正確運行，這些支持代碼包含在GTT客戶端庫中，該庫可在GTT的固件下載文件夾中找到。
接口庫：在使用新的主機設備進行開發(fā)時，可能需要創(chuàng)建一個接口庫。該接口庫至少應包含一個從GTT模塊讀取字節(jié)到設備的函數(shù)和一個從設備向GTT寫入字節(jié)的函數(shù)。同時，還需要在接口庫中定義輸入和輸出緩沖區(qū)，并配置GTT設備結(jié)構(gòu)，使其包含指向讀寫函數(shù)以及輸入和輸出緩沖區(qū)的指針。

四、附錄

（一）數(shù)據(jù)類型

手冊中使用的數(shù)據(jù)類型可以用常見編程語言中的原生數(shù)據(jù)類型來表示，如U8對應ANSI C/C++中的unsigned char、C#中的byte、Visual Basic中的Byte；U16對應ANSI C/C++中的unsigned short等。需要注意的是，多字節(jié)值的傳輸采用大端（MSB優(yōu)先）順序。

五、聯(lián)系信息

如果在使用GTT2.5協(xié)議過程中遇到問題或有相關(guān)需求，可以通過以下方式聯(lián)系：

銷售：電話403.229.2737，郵箱sales@matrixorbital.ca
支持：電話403.229.2737，郵箱support@matrixorbital.ca
設計：電話403.229.2737，郵箱design@matrixorbital.ca
在線購買：www.matrixorbital.com
在線支持：www.matrixorbital.ca

大家在實際開發(fā)中是否遇到過GTT2.5協(xié)議相關(guān)的難題呢？不妨在評論區(qū)分享一下，我們一起探討解決方案。

聲明：本文內(nèi)容及配圖由入駐作者撰寫或者入駐合作網(wǎng)站授權(quán)轉(zhuǎn)載。文章觀點僅代表作者本人，不代表電子發(fā)燒友網(wǎng)立場。文章及其配圖僅供工程師學習之用，如有內(nèi)容侵權(quán)或者其他違規(guī)問題，請聯(lián)系本站處理。舉報投訴