TP触摸屏自定义协议说明

Twin自定义协议编写说明
作为专业的触摸屏人界面，TP系列人机界面除了支持与各种主流PLC、变频器等控制
器的直接连接之外，又增加一种用户自定义的通讯协议。用户只需根据自己所使用控制器的
通讯协议编写相应的驱动程序，即可实现TP系列人机界面与任何控制器的通讯。
下面就以编写一个简单modbus协议通讯为例介绍一下自定义协议的编写规则：
一、在安装程序TouchWin文件夹下需要增加或修改的项。
1、在目录TouchWin\Device下新建一个驱动文件夹modbus_UD（文件名称用户自定义），
文件夹中需要增加2个文件： preview.bmp、modbus_UD.ini。
这 2 个文件可以从其他驱动文件夹里面拷贝过来，把.ini 文件的文件名称改成新建文件夹
modbus_UD的名称，并将其中的内容删除。
2、打开目录 TouchWin\Device下的Device.ini文件，该文件有两部分要修改。
a)把[option]一项中的number后面的数字n改成n+1。（比如原来number = 22，改成number =
1
PDF 文件使用 "pdfFactory" 试用版本创建 昳wwÿw 昳.fineprint.cn23。
b)然后在文件的最后仿照原有的部分增加一段新建驱动文件的信息。
2
PDF 文件使用 "pdfFactory" 试用版本创建 昳wwÿw 昳.fineprint.cn3、打开目录 TouchWin\Chinese 或者 TouchWin\English 下的 Note.ini 文件，在
[Device_Name]一项的最后增加新建驱动文件的一行信息。
3
PDF 文件使用 "pdfFactory" 试用版本创建 昳wwÿw 昳.fineprint.cn注：增加的这行信息的“=”右边的名称是任意的，这只是一个显示的作用。
作完上面这些工作之后，在编程软件里面已经有了您自定义的通讯协议选项。如下图
二、配置文件的编写规则。
第一步中创建的驱动文件夹中的 2 个文件，其中 preview.bmp文件是不需要编辑的，
4
PDF 文件使用 "pdfFactory" 试用版本创建 www.fineprint.cnmodbus_UD.ini就是用户所要编写的自定义协议配置文件。
自定义协议配置文件主要由以下几部分组成：
1、描述部分[descript]
自定义协议的描述部分都是一样的，无需改动。如下所示：
[descript]
DeviceModelCode=22
FirmwareName=UserDefine
2、通讯格式定义[Communication]
主要定义有：BaudRate—波特率
DataBits —数据位
Parity—校验方式
StopBits—停止位
例如，波特率9600bps，8位数据位，偶校验，1个停止位定义如下：
5
PDF 文件使用 "pdfFactory" 试用版本创建 ÿw ÿw w.fineprint.cn上述设置在编程软件中显示：
[Communication]
BaudRate=9600 波特率
DataBits=8 数据位
Parity=2 ; 0-None, 1-Odd, 2-Even 校验形式
StopBits=0 ; 0-1 bit, 1-1.5 bits, 2-2 bits 停止位
6
PDF 文件使用 "pdfFactory" 试用版本创建 ÿw ww.fineprint.cn3、站号的定义[StationNo]
前缀Panel表示TP屏本身的站号，前缀Device表示客户选用的设备的站号。
上述设置在编程软件中显示：
7
PDF 文件使用 "pdfFactory" 试用版本创建 www.fineprint.cn[StationNo]
; 0-NO, 1-YES
PanelWithStationNo=0 0：不使用站号，1：使用站号。（为 0：以下 3 项设
PanelDefaultStationNo= 置无效）
PanelMinStationNo=
PanelMaxStationNo=
DeviceWithStationNo=1 0：用户没有站号设置，1：用户有站号设置
DeviceDefaultStationNo=1 默认站号1
DeviceMinStationNo=0
表示站号的设定范围是从0~255
DeviceMaxStationNo=255
4、定义对象及定义对象描述值
1）定义对象个数[Object]
例如：如果定义2个对象，如下所示
[Object]
ObjectNum=2
2） 定义对象属性
8
PDF 文件使用 "pdfFactory" 试用版本创建 ÿw ÿw w.fineprint.cn上述设置在编程软件中显示：
[Object1]
; 0-Bit, 1-Reg, 2-Regs
CanAct=1 ; Reg 定义类型：0—表示位；1—表示寄存器；
2—表示寄存器组
IDSymbol=4x 定义的表现形式
TypeNo=0 设置对象类型码
bitlength = 16; 设置对象长度
DescripNum=1 设置对象有几段描述值
CanSelectType=12; (0000'1100) 设置对象可选的类型
4-n Regs, 3-dword, 2-word, 1-byte, 0-bit
ReadWord = 1
ReadDWord = 1 设置寄存器对象读写数据时所选用的通讯
WriteWord = 3 规则
WriteDWord = 3
9
PDF 文件使用 "pdfFactory" 试用版本创建 www.fineprint.cn3）定义对象第一段描述值
上述设置在编程软件中显示：
10
PDF 文件使用 "pdfFactory" 试用版本创建 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 设置第一段描述值的表示形式：范围 0~7，表
示上面列出的8种形式。
DefaultNumber=0 设置第一段描述只的默认数值。
MinNumber=0
设置描述值的范围
MaxNumber=65535
format=10 ; 十进制 设置描述值的进制形式

TP（Touche Panel）触摸屏自定义协议通常是指在触摸屏与控制器或其他设备之间设计的一种非标准或私有通信方式。它允许开发者根据特定应用的需求，创建一套独有的数据交换规则，以实现更加灵活和个性化的功能交互。 具体来说，自定义协议包括以下几个方面： 1. 协议类型：可以是基于UART、SPI、I2C、CAN、Ethernet等通用接口协议的变种，或者使用更为高级的专有总线协议如MIPI-DSI、USB Type-C DP++等。 2. 数据格式：定义了触摸信息（如坐标、压力、多点触控等）以及可能的附加控制命令的数据结构，如字节序列、消息包结构等。 3. 传输流程：包含了握手信号、命令帧、数据帧、校验码、应答机制等内容，确保数据准确无误地发送和接收。 4. 控制逻辑：自定义协议还可能包含一些特殊的功能控制逻辑，如防抖处理、错误检测与恢复机制、唤醒/睡眠模式切换等。 5. 配置文件或驱动支持：为了能在不同硬件平台上实施该协议，通常会提供相关的配置文件模板和驱动程序接口供开发人员调用和集成。 总之，TP触摸屏自定义协议是为了满足特定应用场景中对人机交互性能、实时性、能耗等方面的高度定制化需求，通过制定一套专属的通信规则，提升整个系统的灵活性和互操作性。