2023工业控制系统人机接口组态文件交互第3部分：扩展交互描述

3目  次目  次 I前  言 II引  言 III范围 1规范性引用文件 1术语和定义 1缩略语 1扩展交互文件描述 1扩展组态信息 1扩展交互描述文件说明 1IO设备可扩展配置 1IO设备配置可扩展配置信息 1IO设备配置可扩展通用描述方法 2变量IO链接可扩展配置 2变量IO链接可扩展配置信息 2变量IO链接配置可扩展通用描述方法 2函数集FUNCTIONS 2函数描述方式 2数学函数 3字符串函数 3时间函数 3系统函数 3图元模版集3图元模版集元素 4图元模版复杂类型 4附录A（规范性）扩展交互组态XML文件架构 6附录B（资料性）常用IO设备扩展配置定义 8MODBUS协议IO设备扩展配置定义 8OPCUA协议IO设备扩展配置定义 8附录C（资料性）常用变量IO链接配置定义 9MODBUS协议变量IO链接配置定义 9OPCUA协议变量IO链接配置定义 9附录D（资料性）常用变量IO链接配置定义 10附录E（资料性）常用函数声明 12数学函数 12字符串函数 12时间函数 13工业系统人机接口组态文件交互系列标准由四部分构成。12XML的基础可交互组态文件结构与文件3XML的扩展可交互组态文件结构与文件4IIIPAGEPAGE11PAGEPAGE10工业控制系统人机接口组态文件交互第3部分：扩展交互描述范围IO设备可扩展配置、变量IO链接可扩展配置、函数等元素的描述方式。规范性引用文件（包括所有的修改单适用于本文件。GB/TXXXXX.1 工业控制系统人机接口组态文件交互第1部分：通用信息GB/TXXXXX.2 工业控制系统人机接口组态文件交互第2部分：基础交互描述术语和定义GB/TXXXXX.1—XXXX、GB/TXXXXX.2-XXXX界定的术语和定义适用于本文件。缩略语下列缩略语适用于本文件。OID：对象识别符（ObjectIdentifier）IO：输入输出（Input/Output）扩展交互文件描述扩展组态信息工业控制系统人机接口扩展交互信息为协议（protocol）或者厂商（vender）特有元素，或其属性特定于协议（protocol）或者厂商（vender）的元素，由IO设备可扩展配置集、IO链接可扩展配置集、函数集与图元模版四个部分组成。扩展交互描述文件说明础交互文件基础上，扩展了IO设备配置、设备驱动相关的变量链接扩展定义和函数定义，文件结构与基础交互节点保持一致。详见GB/TXXXXX.2的第6章节。IO设备可扩展配置IO设备配置可扩展配置信息自定义配置集“IODeviceExtension”作为IO设备的扩展节点名称，是元素“IODevice”元素的子节点，用于描述IO设备的拓展配置信息，其属性特定于协议（protocol）或者厂商（vender）。IO设备配置可扩展通用描述方法“IODeviceExtension”应符合如下规则描述：拓展信息由一组或多组键值对（属性名与属性值）构成；属性值可以为整型量或枚举量。如果整型值表示的是顺序号，则整型量从0开始。枚举量为字符串形式表示的准确枚举值名称；若有层级划分。分类的原则是：先大类、后小类。每个分类对应XML的一个节点，下级分类节点为其上级分类节点的子节点。IO链接可扩展配置IO链接可扩展配置信息自定义配置集“IOLinkExtension”作为IO“IOLink”IO链接配置可扩展通用描述方法“IOLinkExtension”应符合如下规则描述：拓展信息由一组或多组键值对（属性名与属性值）构成；属性值可以为整型量或枚举量。如果整型值表示的是顺序号，则整型量从0开始。枚举量为字符串形式表示的准确枚举值名称；若有层级划分。分类的原则是：先大类、后小类。每个分类对应XML的一个节点，下级分类Functions函数描述方式“Functions”元素描述组态工程中用户自定义的“Function”声明和实现的集合，用户可以把一些公共的、通用的运算或操作定义成自定义函数，然后在脚本中引用。“Function”元素的属性包含函数名称“name”、函数说明“desc”、函数返回数据类型“returnType”和函数实现代码“body”，“Function”元素的子元素为函数形参集“Parameters”。“Parameters”元素包含函数形参名称“name”、形参描述“desc”、形参数据类型“type”、传参方式“byRef”和默认值“initValue”属性。其内容如图1所示。图1函数集“Functions”元素结构数学函数工业控制系统人机接口组态软件规范的公共数学函数，可在脚本中直接使用。数学函数包括次幂、取整最小值最大值绝对值正弦值余弦值正切值反正弦值反余弦值反正切值自然常数e的若干次幂自然常数e的对数指定数字的平方根取一个数字的整数部分取模生成随机数等。具体的函数声明详见附录E.1 。字符串函数。时间函数。系统函数（级别Templates图元模版集“Templates”元素图元模版集描述了人机接口组态工程中的画面图元模版（即图库）的定义集合，“Templates”元素包含一个或多个图元模板“Template”的定义，其类型为“Template”复杂类型。在人机接口组态软图2图元模版集“Templates”元素结构图元模版“Template”复杂类型图元模版“template”复杂类型的属性包含图元模版名“name”、缩放时是否保持比例“isScale”、宽度“width、高度“height“template”的子元素包含脚本集“Scripts、事件集“Event、局部变量集“LocalVariables”、模版变量集“TmplVariables”、图元集“Shapes”。“Template”结构详见图3说明。图3图元模版“Templates”复杂类型结构“Script”、“Event”、“ViewVariable”与“Shape”复杂类型分别详见GB/TXXXX.2—XXXX6.8、6.9、8.1、7.3小节说明。模板变量“TmplVariable”复杂类型包含变量名“name”、说明“description”、变量数据类型“dataType”附录A（规范性）扩展交互组态XML文件架构工业控制系统人机接口组态扩展交互XML文件结构如下：Function<xsd:complexTypename="Function"><xsd:annotation><xsd:documentation>Functiondeclarationandimplementation</xsd:documentation></xsd:annotation><xsd:sequence><xsd:elementname="Parameters"minOccurs="0"maxOccurs="unbounded"><xsd:complexType><xsd:attributename="name"use="required"/><xsd:attributename="desc"use="required"/><xsd:attributename="type"use="required"/><xsd:attributename="initValue"/><xsd:attributename="byRef"/></xsd:complexType></xsd:element></xsd:sequence><xsd:attributename="name"use="required"/><xsd:attributename="desc"use="required"/><xsd:attributename="returnType"use="required"/><xsd:attributename="body"use="required"/></xsd:complexType>Template图元模版复杂类型<xsd:complexTypename="Template"><xsd:annotation><xsd:documentation>Definesthewindows/flowchartshapetemplate</xsd:documentation></xsd:annotation><xsd:all><xsd:elementname="Scripts"minOccurs="0"><xsd:complexType><xsd:sequence><xsd:elementname="Script"type="Script"maxOccurs="unbounded"/></xsd:sequence></xsd:complexType></xsd:element><xsd:elementname="Events"minOccurs="0"><xsd:complexType><xsd:sequence><xsd:elementname="Event"type="Event"maxOccurs="unbounded"/></xsd:sequence></xsd:complexType></</xsd:element><xsd:elementname="LocalVariables"minOccurs="0"><xsd:complexType><xsd:sequence><xsd:elementname="ViewVariable"type="ViewVariable"maxOccurs="unbounded"/></xsd:sequence></xsd:complexType></xsd:element><xsd:elementname="TmplVariables"minOccurs="0"><xsd:complexType><xsd:sequence><xsd:elementname="TmplVariable"type="TmplVariable"maxOccurs="unbounded"/></xsd:sequence></xsd:complexType></xsd:element><xsd:elementname="Shapes"><xsd:complexType><xsd:sequence><xsd:elementname="Shape"type="Shape"maxOccurs="unbounded"/></xsd:sequence></xsd:complexType></xsd:element></xsd:all><xsd:attributename="name"use="required"/><xsd:attributename="isScale"/><xsd:attributename="width"/><xsd:attributename="height"/></xsd:complexType>附录B（资料性）常用IO设备扩展配置定义ModbusIO设备扩展配置定义图B.1为Modbus协议设备的自定义配置集“IODeviceExtension”。该元素属性包括系统位数“systemBits”，字节顺序“byteOrder”。B.1ModbusIOIODeviceExtension”元素OPCUAIO设备扩展配置定义图B.2为OPCUA协议设备的自定义配置集“IODeviceExtension”。该元素属性包括接入点地址“endpointURI”，使用加密连接“enableEncryption”，加密证书（公钥）文件“certificateFile”，私钥文件“keyFile”，加密方式“securityMode”，加密等级（加密策略）“securityPolicy”，使用用户身份认证“enableUserAuth”，用户名“userName”，密码“passWord”，最大操作数“maxOperationLimit”。B.2OPCUAIOIODeviceExtension”元素附录C（资料性）常用变量IO链接配置定义ModbusIO链接配置定义C.1ModbusIO链接自定义配置集“IOLinkExtension”。该元素属性包括寄存器类型“memoryType”、寄存器地址“memoryAddress”、读写属性“readWriteAttributes”、数据位“dataBit”。其中寄存器类型“memoryType”（DI）“memoryAddress”065536C.1ModbusIOIOLinkExtension”元素OPCUAIO链接配置定义C.2OPCUAIO链接自定义配置集“IOLinkExtension”。该元素属性包括节点编号“nodeID”。C.2OPCUAIOIOLinkExtension”元素附录D（资料性）常用变量IO链接配置定义IO设备可扩展配置信息XML文件结构（XSD）如下：<<xsd:elementname="IODeviceExtension"minOccurs="0"><xsd:complexType><xsd:choice><xsd:elementname="Modbus"><xsd:complexType><xsd:attributename="systemBits"use="required"/><xsd:attributename="byteOrder"use="required"/></xsd:complexType></xsd:element><xsd:elementname="OPCUA"><xsd:complexType><xsd:attributename="endpointURI"use="required"/><xsd:attributename="enableEncryption"use="required"/><xsd:attributename="certificateFile"use="required"/><xsd:attributename="keyFile"use="required"/><xsd:attributename="securityMode"use="required"/><xsd:attributename="securityPolicy"use="required"/><xsd:attributename="enableUserAuth"use="required"/><xsd:attributename="userName"use="required"/><xsd:attributename="passWord"use="required"/><xsd:attributename="maxOperationLimit"use="required"/></xsd:complexType></xsd:element></xsd:choice></xsd:complexType></xsd:element>变量IO链接可扩展配置信息XML文件结构（XSD）如下：<<xsd:elementname="IOLinkExtension"minOccurs="0"><xsd:complexType><xsd:choice><xsd:elementname="Modbus"><xsd:complexType><xsd:attributename="memoryType"use="required"/><xsd:attributename="memoryAddress"use="required"/><xsd:attributename="readWriteAttributes"use="required"/><xsd:attributename="dataBit"use="required"/></</xsd:complexType></xsd:element><xsd:elementname="OPCUA"><xsd:complexType><xsd:attributename="nodeID"/></xsd:complexType></xsd:element></xsd:choice></xsd:complexType></xsd:element>附录E（资料性）数学函数常用数学函数如表E.1所示。表E.1常用数学函数函数名称C/C++VBScriptJavaScript次幂doublepow(doublex,doubley)需要自定义Numberpow(x,y)向下取整doublefloor(doublex)Int(number)Numberfloor(x)最小值intmin(doublex,doubley)需要自定义Numbermin(x,y,z...n)最大值intmax(doublex,doubley)需要自定义Numbermax(x,y,z...n)绝对值doubleabs(doublex)Abs(number)Numberabs(x)正弦值doublesin(doublex)Sin(number)Numbersin(x)余弦值doublecos(doublex)Cos(number)Numbercos(x)正切值doubletan(doublex)Tan(number)Numbertan(x)反正弦值doubleasin(doublex)需要自定义Numberasin(x)反余弦值doubleacos(doublex)需要自定义Numberacos(x)反正切值doubleatan(doublex)Atn(number)Numberatan(x)e的若干次幂doubleexp(doublex)Exp(number)Numberexp(x)平方根doublesqrt(doublex)Sqr(number)Numbersqrt(x)对数(底数为e)doublelog(doublex)Log(number)Numberlog(x)取整数部分doublemodf(doublex,double*integer)Fix(number)Numbertrunc(x)生成随机数intrand(void)Rnd()Numberrandom()字符串函数常用字符串处理函数如表E.2所示。表E.2常用字符串处理函数函数名称C/C++VBScriptJavaScript字符串和数值转换intatoi(constchar*str)char*itoa(intnum,char*str,intradix)需要自定义StringtoString(radix)NumberNumber(string)字符串截取char*substr(constchar*source,intm,intn)Mid(string,start[,length])Stringsubstr(start,length)字符串长size_tstrlen(constcharLen(string|varname)length属性度*str)字符串查找char*strpbrk(constchar*str1,constchar*str2)InStr([start,]string1,string2[,compare])Numbersearch(searchvalue)字符与ASCII值转换intsprintf(char*str,constchar*format,...)Asc(string)chr(charcode)NumbercharCodeAt(index)StringfromCharCode(n1,n2,...)空格过滤需要自定义Trim(string)Stringtrim()字符串复制char*strcpy(char*d