MCGS脚本驱动开发工具使用指导手册

北京昆仑通态自动化软件科技有限公司北京昆仑通态自动化软件科技有限公司北京昆仑通态自动化软件科技有限公司北京昆仑通态自动化软件科技有限公司昆巳通态kunluntongtai脚本驱动V2.0使用指导手册版本号:0.1® 北京昆仑通态自动化软件科技有限公司® 北京昆仑通态自动化软件科技有限公司北京昆仑通态自动化软件科技有限公司北京昆仑通态自动化软件科技有限公司©昆已囲态kunluntongtai目录TOC\o"1-5"\h\z®—章 新脚本驱动说明 1脚本驱动适用范围 1脚本驱动适用的版本 1脚本驱动适川的设备 1脚本驱动适川的t办议 1脚本驱动兼容性 1脚本驭动新增内容 1脚本驱动新®功能 1脚本驱动新增函数 1祐二章 祯础概念讲解 3通讯t办议 3ACSII码通讯协议(字符揪协议) 3HEX通W协议(字节数组协议) 3ASCII码通讯与HEX通讯的区别 3\o"CurrentDocument"策三章 向导使用说明 4完全适用向导的协议 4ASCII码协议，多条命令通讯示例 4HEX码协议，中条命令通讯示例 19\o"CurrentDocument"不完全适用向导 31®叫章新增函数使用说明 36数据解析函数 36ISvrGetByteFromByteArr(ByRefByteArr,start,ByRefn,Flag) 36ISvrGetShortFromByteArr(ByRefByteArr7start'ByRefn,Flag) 36!SvrGetlntFromByteArr(ByRefByteArr, start, ByRefn,Flag) 37ISvrGetSingleFromByteArr《ByRefByteArr,start,ByRefx,Flag) 37ISvrGetByteFromHexStr(str,ByRefnzFlag) 37iSvrGetShortFormHexStrfstr,ByRefn,Flag) 38ISvrGetlntFromHexStr(str,ByRefn,Flag) 38!SvrGetSingleFromHexStr(str,ByRefx,Flag) 39数W校验函数 39!SvrByteArraySum(ByRefByteArr,start,length) 39!SvrStrSum(str,Flag) 40!SvrByteArrayXOR(ByRefByteArr,start,length) 40!SvrStrXOR(str,Flag) .40!SvrStrModbusCRC(ByRefByteArr,start,length) 41!SvrStrModbusLRC(str,start,length) 41!OpenLog() 41!CloseLog() 41\o"CurrentDocument"字节数组操作函数 42!HStr2HByre(str,arByte) 42!HByte2HStr(arByte,str) 42\o"CurrentDocument"®五章 故障分析 43\o"CurrentDocument"无法通讯 43通W行跳变 43\o"CurrentDocument"通讯正常.数裾不正确 43\o"CurrentDocument"检测驱动 43©昆巳圃态kunluntongtai第一章新脚本驱动说明•1.2.3.脚本驱动适用范围脚本驱动适用的版本AMCGS嵌入人组态软件：版本号：65(010010)注：此版本以上为新版本，以下为旧版本BMCGS通用版的定制版组态软件CMCGSM络版的定制版绀态软件脚本驱动适用的设备a独没&B卬口通信设缶脚本驱动适用的协议二.脚本驱动兼容性1.旧版本脚本驱动妝容新版本组态软件2.新版本脚本骓动不兼界旧版本的组态软件，旧版本组态软件无法Ui别新版本脚本咻动••1.2.脚本驱动新増内容脚本驱动新増功能新增加生成向导功能.具体参照第三章内容。脚本驱动新増函数<1)数据解析函数rByteFiomByte.AnXByRefByteAn，start,ByRrfn.Flag)S\-iGetShortFiomBneAn\B\RefBytcArustart，ByRefn,FhgjS\-iGet[ntFiomByteAn\ByRefByteArr、start、ByRefn.Flag;fSxiCietSingleFiomByte.AinByRefByteAn，start，ByRefx,Flag)S\-iGetB\ieFroinHexS,tr(sti\ByRefn.Fhgj6.rSXTGetShortFormHexStrtstr、ByRefa,FlagjJJSx^iGetlnlFioinHexShtstr,ByRefn，Flog)8.’S\-iGetSingleFromHexStr(str*ByRefx，Fhgj(2) 数据校验函数1.fS\*iByteArrayS^nnByRefByUAir,start,length;2JS\-rStrSunnstr.Flag?S\-rByteArrayXORjBvRefByteArr、start,length)4JSvrShXOR^str,Flag)!S\-rStrModbusCRCtByRefBy«Arr.start,length}fS\TStiModbusLRC^str,san,length)北京昆仑通态自动化软件科技有限公司北京昆仑通态自动化软件科技有限公司北京昆仑通态自动化软件科技有限公司北京昆仑通态自动化软件科技有限公司7JOpenLog(>S/CloseLog^(3)字节数组操作函数lJHSlrlHByretstr,arByie)2.,HByte2HSti(aiByte,str)北京昆仑通态自动化软件科技有限公司北京昆仑通态自动化软件科技有限公司北京昆仑通态自动化软件科技有限公司北京昆仑通态自动化软件科技有限公司©昆已圃态kunluntongtai第二章基础概念讲解一.通讯协议ACSII码通讯协议（字符型协议〉通讯信息按照ascii码方A解析得到的参数位息称为asch码通讯。比如：主站接收到从站发送的4个宁符：0x310x340x2E0x36,川ASCII码表示为14<5。HEX通讯协议（字节数组协议）通讯信息按照十六进制方忒解析得到的参数倍以称为十六逊制通讯。比如：主站接收到从站发送的4个卞符：0x310x340x2E0x36，川HEX表示为0x31342E36ASCII码通讯与HEX通讯的区别1） ASCHfil通讯传送的7符能淸楚的了解发送命令和接收信息，fH足传送的倌息速度策少：十六进制通讯发送的‘?•符倍总速度里人，但是发送命令和接收信乜小明了。2） ASCII码的通讯帧1个卞占4个卞符，而HEX的通讯帕1个卞占2个卞符。如：发送0x1427HASCII发送4个7符：0x310x34奴320x37.而HEX!i志要发送2个7打:0x140x27.©昆已囲态kunluntongtai第三章向导使用说明一.完全适用向导的协议ASCII码协议，多条命令通讯示例1.1步骤1:协议分析通讯命令1:模仿ADAM4018协议，协议格式如下：发送俞令：#xx\r帧失：长L个字符.IAI定为#地址：闻定长2个字符帧尾：长I个字符.为冋车接收命令：#-*XXXXX-*XXXXX-*XXXXX-»XXXXX-tXXXxx-txxx.xx-txxx.xx-txxx.xxr帧头：长L个字符.阑定为#数裾体：井8个数裾休.每个数裾休7个宁符，按ASCIIS方式解析帧屺：个字符，为回车模拟数锯：发送命令h#01\[接收命令L：#+11.111+22.222+31333+44444+55555-»-66.€6^77.777-hSS.888'x通讯命令2:自己定义，解析数据非等长通讯协议，分两种愔况：数据长度己知；数据长度未知•下面以数据长度未知，数据之间用分隔符分离的协议.协议格式如下：发送命令：#xxxxxxx帧头：长L个宁符.|A1定为#.参与校验地址：固定长2个字符，参与校验校验：K2个7符，尜加和校验铀朿符号:长1个字符，W定为回车技收命令：#xxAA，BBB,CCCC«DDDDD£EEE^FF.GGJIHHHxxr帧失:KL个7符.IAI定为#数据体：8个数裾体.以分隔校验:长2个字符，累加和校验结束符号：氏1个7符，w定为iuPT模拟数掂：发送命令：#0134\r接收俞令：»1U223333,44444.5555.6«56,77,8S88E3'I-4-©昆巳囲态kunlunlongtai1.2步骤2:新建工程进入向导新后进入新辻1:稈模式，如阁34-1-1所示。M3-1-1-1M3-1-1-1选择“使用向导新建工程歸,则进入向导界面.關34小2所示。选择“使用向导新建工程歸,则进入向导界面.關34小2所示。选择“不使川甸导新建工W”，流W和原來-样，^接土成示例脚本。销个脚木配貫分为4个步骤.前一个步骤不执行，不允执行卜个步骤ra3-1-1-2i殳苒脚木驱动的名称和注释内容北京昆仑通态自动化软件科技有限公司北京昆仑通态自动化软件科技有限公司北京昆仑通态自动化软件科技有限公司北京昆仑通态自动化软件科技有限公司1.3步骤3:配置驱动属性m3-1-1-3添加W性.添加除“没格地址”和“通iH延时”以外的W性.，所添加W性的数据类兜选择枚举5?时，嵐性范围处填写枚举5,并用隔开.taffl3-1-1-4所示。删除妞性，对多余的质性迸行删除，芄屮“没格地址"和“通讯延IH”为畎认诚性，不允许删除.3设咒w性*修改设加的w性。RI3-1-1-4kunluntongtai 北京昆仑通态自动化软件科技有限公司kunluntongtai 北京昆仑通态自动化软件科技有限公司---返1"1值：幵关型，0：成功-1失败数：无实三.实三.例：^loseLogu字节数组操作函数!HStr2HByre(str,arByte)函数怠义：将字符中转为7符数组返1"1值：>-o：转换字节个数小于0:错误，具体意义如下:-1：没订定义数组arByte-2：arByte不足数组类中-3：str必须为偶数个-4：转换错误参数：str,7符V，蒞要校验数裾arByte.经过H换后的7•节数组实例：！HStr2Hbyte(strarByte)，str-”123456”则铃换后aiByte值分别为0x310x320x330x340x350x36!HByte2HStr(arByte,str)函数意义：将卞符屮转为卞符数组返Wffi：7符彻，返liiliE确的校验供/判断圮输出足否IE常：止确：返M校验值错误，返|||丨空卞符屮参数：ST.7•符型.滞迎校验数帐arByte.经过H换后的卞b数纽实 m:!Hb\-te2HS,tr(arByte^tr).arByneffi分別为0x350x360x370x380x39,则特换Sstr-”567沾”©昆巳画态kunluntongtai第五章故障分析无法通讯检杏串丨|父没备参数足内正确检卉串II足否被m:他程序占m检S通讯电缆足否正确迕接检査设答，使用厂家测试程序确保通讯正常检卉没备厲性SS是否与实际设腿性一致适当延长“通讯等待时间”读収地址是内超出范ra通讯有跳变检S父没备串II校验位是否正确适当延长“通讯等待时问"没备断电，琅新上电，使初始化没备通讯电缆人长，做短距离测试现场干扰人人，避免周M坏境干扰通itUS号变弱，使用介源RS232/485块该取数据超出范闹（添加采通道后.导致通M状态变为非0）通讯正常，数据不正确新i£T.