Twin自定義協(xié)議編寫說明
作為專業(yè)的觸摸屏人界面，TP系列人機界面除了支持與各種主流PLC、變頻器等控制
器的直接連接之外，又增加一種用戶自定義的通訊協(xié)議。用戶只需根據(jù)自己所使用控制器的
通訊協(xié)議編寫相應(yīng)的驅(qū)動程序，即可實現(xiàn)TP系列人機界面與任何控制器的通訊。
下面就以編寫一個簡單modbus協(xié)議通訊為例介紹一下自定義協(xié)議的編寫規(guī)則：
一、在安裝程序TouchWin文件夾下需要增加或修改的項。
1、在目錄TouchWin\Device下新建一個驅(qū)動文件夾modbus_UD（文件名稱用戶自定義），
文件夾中需要增加2個文件： preview.bmp、modbus_UD.ini。
這 2 個文件可以從其他驅(qū)動文件夾里面拷貝過來，把.ini 文件的文件名稱改成新建文件夾
modbus_UD的名稱，并將其中的內(nèi)容刪除。
2、打開目錄 TouchWin\Device下的Device.ini文件，該文件有兩部分要修改。
a)把[option]一項中的number后面的數(shù)字n改成n+1。（比如原來number = 22，改成number =
1
PDF 文件使用 "pdfFactory" 試用版本創(chuàng)建 昳ww?w 昳.fineprint.cn23。
b)然后在文件的最后仿照原有的部分增加一段新建驅(qū)動文件的信息。
2
PDF 文件使用 "pdfFactory" 試用版本創(chuàng)建 昳ww?w 昳.fineprint.cn3、打開目錄 TouchWin\Chinese 或者 TouchWin\English 下的 Note.ini 文件，在
[Device_Name]一項的最后增加新建驅(qū)動文件的一行信息。
3
PDF 文件使用 "pdfFactory" 試用版本創(chuàng)建 昳ww?w 昳.fineprint.cn注：增加的這行信息的“=”右邊的名稱是任意的，這只是一個顯示的作用。
作完上面這些工作之后，在編程軟件里面已經(jīng)有了您自定義的通訊協(xié)議選項。如下圖
二、配置文件的編寫規(guī)則。
第一步中創(chuàng)建的驅(qū)動文件夾中的 2 個文件，其中 preview.bmp文件是不需要編輯的，
4
PDF 文件使用 "pdfFactory" 試用版本創(chuàng)建 www.fineprint.cnmodbus_UD.ini就是用戶所要編寫的自定義協(xié)議配置文件。
自定義協(xié)議配置文件主要由以下幾部分組成：
1、描述部分[descript]
自定義協(xié)議的描述部分都是一樣的，無需改動。如下所示：
[descript]
DeviceModelCode=22
FirmwareName=UserDefine
2、通訊格式定義[Communication]
主要定義有：BaudRate—波特率
DataBits —數(shù)據(jù)位
Parity—校驗方式
StopBits—停止位
例如，波特率9600bps，8位數(shù)據(jù)位，偶校驗，1個停止位定義如下：
5
PDF 文件使用 "pdfFactory" 試用版本創(chuàng)建 ?w ?w w.fineprint.cn上述設(shè)置在編程軟件中顯示：
[Communication]
BaudRate=9600 波特率
DataBits=8 數(shù)據(jù)位
Parity=2 ; 0-None, 1-Odd, 2-Even 校驗形式
StopBits=0 ; 0-1 bit, 1-1.5 bits, 2-2 bits 停止位
6
PDF 文件使用 "pdfFactory" 試用版本創(chuàng)建 ?w ww.fineprint.cn3、站號的定義[StationNo]
前綴Panel表示TP屏本身的站號，前綴Device表示客戶選用的設(shè)備的站號。
上述設(shè)置在編程軟件中顯示：
7
PDF 文件使用 "pdfFactory" 試用版本創(chuàng)建 www.fineprint.cn[StationNo]
; 0-NO, 1-YES
PanelWithStationNo=0 0：不使用站號，1：使用站號。（為 0：以下 3 項設(shè)
PanelDefaultStationNo= 置無效）
PanelMinStationNo=
PanelMaxStationNo=
DeviceWithStationNo=1 0：用戶沒有站號設(shè)置，1：用戶有站號設(shè)置
DeviceDefaultStationNo=1 默認站號1
DeviceMinStationNo=0
表示站號的設(shè)定范圍是從0~255
DeviceMaxStationNo=255
4、定義對象及定義對象描述值
1）定義對象個數(shù)[Object]
例如：如果定義2個對象，如下所示
[Object]
ObjectNum=2
2） 定義對象屬性
8
PDF 文件使用 "pdfFactory" 試用版本創(chuàng)建 ?w ?w w.fineprint.cn上述設(shè)置在編程軟件中顯示：
[Object1]
; 0-Bit, 1-Reg, 2-Regs
CanAct=1 ; Reg 定義類型：0—表示位；1—表示寄存器；
2—表示寄存器組
IDSymbol=4x 定義的表現(xiàn)形式
TypeNo=0 設(shè)置對象類型碼
bitlength = 16; 設(shè)置對象長度
DescripNum=1 設(shè)置對象有幾段描述值
CanSelectType=12; (0000'1100) 設(shè)置對象可選的類型
4-n Regs, 3-dword, 2-word, 1-byte, 0-bit
ReadWord = 1
ReadDWord = 1 設(shè)置寄存器對象讀寫數(shù)據(jù)時所選用的通訊
WriteWord = 3 規(guī)則
WriteDWord = 3
9
PDF 文件使用 "pdfFactory" 試用版本創(chuàng)建 www.fineprint.cn3）定義對象第一段描述值
上述設(shè)置在編程軟件中顯示：
10
PDF 文件使用 "pdfFactory" 試用版本創(chuàng)建 www.fineprint.cn有的元件有2段描述值，定義時和定義第一段描述值類似。如下所示：
[Object1Descrip1]
Caption=
;0-Number, 1-Postfix1(0-7),
2-Postfix2(00-07), 3-Postfix3(0-15),
4-Postfix4(00-15), 5-Postfix5(0-F),
6-Postfix6(00-0F), 7-Postfix7(0-31)
Type=0 ; Number 設(shè)置第一段描述值的表示形式：范圍 0~7，表
示上面列出的8種形式。
DefaultNumber=0 設(shè)置第一段描述只的默認數(shù)值。
MinNumber=0
設(shè)置描述值的范圍
MaxNumber=65535
format=10 ; 十進制 設(shè)置描述值的進制形式

TP（Touche Panel）觸摸屏自定義協(xié)議通常是指在觸摸屏與控制器或其他設(shè)備之間設(shè)計的一種非標(biāo)準(zhǔn)或私有通信方式。它允許開發(fā)者根據(jù)特定應(yīng)用的需求，創(chuàng)建一套獨有的數(shù)據(jù)交換規(guī)則，以實現(xiàn)更加靈活和個性化的功能交互。 具體來說，自定義協(xié)議包括以下幾個方面： 1. 協(xié)議類型：可以是基于UART、SPI、I2C、CAN、Ethernet等通用接口協(xié)議的變種，或者使用更為高級的專有總線協(xié)議如MIPI-DSI、USB Type-C DP++等。 2. 數(shù)據(jù)格式：定義了觸摸信息（如坐標(biāo)、壓力、多點觸控等）以及可能的附加控制命令的數(shù)據(jù)結(jié)構(gòu)，如字節(jié)序列、消息包結(jié)構(gòu)等。 3. 傳輸流程：包含了握手信號、命令幀、數(shù)據(jù)幀、校驗碼、應(yīng)答機制等內(nèi)容，確保數(shù)據(jù)準(zhǔn)確無誤地發(fā)送和接收。 4. 控制邏輯：自定義協(xié)議還可能包含一些特殊的功能控制邏輯，如防抖處理、錯誤檢測與恢復(fù)機制、喚醒/睡眠模式切換等。 5. 配置文件或驅(qū)動支持：為了能在不同硬件平臺上實施該協(xié)議，通常會提供相關(guān)的配置文件模板和驅(qū)動程序接口供開發(fā)人員調(diào)用和集成。 總之，TP觸摸屏自定義協(xié)議是為了滿足特定應(yīng)用場景中對人機交互性能、實時性、能耗等方面的高度定制化需求，通過制定一套專屬的通信規(guī)則，提升整個系統(tǒng)的靈活性和互操作性。