ModbusMaster规格说明书

修改版本：V1.9北京亚控版权所有第1页共13页2020-1-111:29ModbusMaster产品规格说明书[修订记录]日期版本号创建人说明2008-6-131.0王东海创建2008-6-201.1徐珺修改，去掉8寄存器等2008-6-241.2徐珺修改，去掉7，8，9寄存器等2008-7-181.3王东海修改串口设备地址格式,增加延时2008-8-61.4王东海修改TCP的通讯方式，改成串口2008-12-301.5李霞3寄存器和4寄存器增加String数据类型尝试连接改为尝试最后一次成功的读包2009-03-271.6李霞增加去除噪音功能，过滤掉帧前帧后多余的干扰字节2009-12-031.7索春明增加CRC校验SwapC寄存器，调整校验字节次序2010-01-201.8索春明增加对于FMC寄存器使用的说明2010-04-091.9单维旺修改配置文件格式以及打包规则说明2010-11-302.0杨晨在TCP设备地址加上延时2011-03-0860,4,16,30曹萌萌添加对当第一帧写命令失败是，从配置文件读取指定的尝试连接帧的处理2011-04-1360,4,18,30董秀芹使用域名定义设备时，定义不下去，提示设备地址格式错误。2011-6-1560.5.18.30肖自辉4号寄存器String类型变量读写以斜杠0结束设备地址格式定义补充说明2012-9-1760.5.19.30赵迪修改设备地址的通讯范围，并对设备地址的范围进行限制2012-12-1760.6.19.30温志杰修改设备地址的通讯范围，并对设备地址的范围进行限制，修改校验错误2013-3-2160.7.20.30邢志远添加4寄存器位类型读写功能，在添加功能时发现TCP连接存在严重故障，已经修正。2013-5-2160.7.23.30邢志远修正TCP故障，合并代码增加域名解析功能，实现248到255正常通信。2013-6-2060.6.24.30邢志远修正TCP在组态王下尝试连接成功后初始化失败的故障.2013-11-1460.11.25.30赵迪增加一个寄存器，使得这个驱动支持10和06功能码，同时能够实现4aa.bbbit寄存器可读写。2014-06-2460.12.29.30邢志远彻底修改驱动代码结构，修改打包模式，增加全链路的配置文件作用，合并以前代码的所有功能。2014-12-460.13.29.30赫思奇增加地址页中关于Swap字节序的设置。增加对DTU的支持。修改版本：V1.9北京亚控版权所有第2页共13页2020-1-111:292015-01-460.14.29.30邢志远为每个float类型变量加上swap配置（2级通道）2015-2-460.14.30.30邢志远增加发帧次数（对于正常设备没有影响）增加通信稳定性，修改句柄和线程泄露。2015-3-3060.14.31.30邢志远修改尝试连接时的尝试包，将尝试重连包按站号区分。[项目经理填写]一、产品功能简介a)支持协议说明通用协议：ModbusRtu，ModbusASCII，ModbusTCPb)支持的硬件型号说明：所有支持上述协议的设备。c)支持的连接说明及发送方式支持串口连接和TCP连接。如果是串口连接，支持按Rtu和ASCII发送；如果是TCP连接，支持以socket发送。二、驱动接口：3.0开发包三、设备添加方式a)在组态王中定义设备时请选择：通用版下：[PLC][莫迪康][ModbusRTU][COM][PLC][莫迪康][ModbusRTU(unpack)][COM][PLC][莫迪康][ModbusASCII][COM][PLC][莫迪康][ModbusTCP][TCP]其他的设备，设备名中必须包含有ModbusRTU，或ModbusASCII，或ModbusTCP字样。区分大小写。否则无法使用该驱动。由于驱动是通过des文件里面的这些关键字进行匹配的。英文版下：[PLC][Modicon][ModbusRTU][COM][PLC][Modicon][ModbusRTU(unpack)][COM]修改版本：V1.9北京亚控版权所有第3页共13页2020-1-111:29[PLC][Modicon][ModbusASCII][COM][PLC][Modicon][ModbusTCP][TCP]注：串口统一为“COM”，以太网统一为“TCP”b)设备向导页选项的特殊说明：如果是串口设备：是否选串口是是否有地址选择页是通讯方式RS232/RS485/RS422/描述COM如果是以太网设备：是否选串口是是否有地址选择页是通讯方式串口描述TCP网络设备需要选择串口的原因是：一个设备接口(如Com1、网卡)开启一个线程。c)对于串口设备通讯参数的推荐设置如下无，视具体设备而定四、本设备的地址格式及地址范围串口连接方式（Rtu）：Address[:Delay:BeforeDelay][|SwapF|SwapL|SwapC]Address0-255设备地址Delay0-60000发送每条命令帧后的延迟时间（毫秒）BeforeDelay0-60000发送每条命令帧前的延迟时间（毫秒）SwapF0-3浮点数的字节顺序，默认为配置文件中所写SwapL0-3长征性的字节顺序，默认为配置文件中所写SwapC0-1CRC校验的字节顺序，默认为配置文件中所写如：1:500:500|1|0|0注：如果在设备定义中对Swap系列功能设定，需要同时设定3个Swap顺序，且SwapF、SwapL、SwapC次序不得有误。修改版本：V1.9北京亚控版权所有第4页共13页2020-1-111:29串口连接方式（ASCII）：同RTUTCP连接方式：IP[:Port]Address[/TimeOut][|SwapF|SwapL|SwapC]IP0-255设备IP地址或域名Port0-65535设备IP地址端口，(不写时默认为502)Address0-255设备地址TimeOut0-65535网络超时(不写时默认3秒)SwapF0-3浮点数的字节顺序，默认为配置文件中所写SwapL0-3长征性的字节顺序，默认为配置文件中所写SwapC0-1CRC校验的字节顺序，默认为配置文件中所写[][]内不写则采用驱动默认值，写则采用用户自定义值。【说明】1.采用TCP连接方式，TCP常用设备格式有三种：1172.16.7.107:5021/50含义如下：172.16.7.107为IP地址。：为端口分隔符502为端口号1为设备地址/为网络超时分隔符50为延时时间(单位秒)2172.16.7.1071含义：IP地址和设备地址，这时端口和网络超时默认值分别为502和503172.16.7.1071/30含义：IP地址、设备地址和网络延时2.使用域名定义设备时，只需要把上面的ip地址改成域名即可，后面端口号、设备号、超时和上面的一样。如：最后的关于Swap字节序的添加，与RTU中相同如：192.168.21.20:5021/50|1|0|0注：如果在设备定义中对Swap系列功能设定，需要同时设定3个Swap顺序，且SwapF、SwapL、SwapC次序不得有误。设备格式2为常用格式，如果出现设备通信不正常的情况3格式为最佳选择。设备地址格式定义补充说明：修改版本：V1.9北京亚控版权所有第5页共13页2020-1-111:29在定义设备地址时没有按照地址格式定义时，虽然能够通过，但是在实际运行中会出现错误，可以在信息窗口中看到设备初始化失败信息。五、寄存器列说明寄存器范围数据类型读写说明01~65535Bit读写逻辑线圈，I/O离散（0XXXX）11~65535Bit读输入位寄存器（1XXXX）3dd.xx3nn.mm3dd3dd3m.n3aa.bbdd:1~65535xx:0-1nn:1~65535mm:0-3dd:1~65535dd:1~65534m:1~65535n:0~127并且m+(n+1)/2-1=65535aa:1~655365bb:0~15BytefloatUshort/short/BCDfloat/Long/LongBCDStringBit读输入寄存器（3XXXX）4dd.xx4nn.mm4dd4dd4m.ndd:1~65535xx:0-1nn:1~65535mm:0-3dd:1~65535dd:1~65534m:1~65535n:0~127并且BytefloatUshort/short/BCDfloat/Long/LongBCDString读读写保持寄存器（4XXXX）写操作时Bit/Byte/Ushort/short/BCD类型用06功能码float/Long/LongBCD/String类型用10功能码修改版本：V1.9北京亚控版权所有第6页共13页2020-1-111:294aa.bbm+(n+1)/2-1=65535aa:1~655365bb:0~15Bit6dd.xx6nn.mm6dd6dd6m.n6aa.bbdd:1~65535xx:0-1nn:1~65535mm:0-3dd:1~65535dd:1~65534m:1~65535n:0~127并且m+(n+1)/2-1=65535aa:1~655365bb:0~15BytefloatUshort/short/BCDfloat/Long/LongBCDStringBit读写同4寄存器的所有功能，但是写操作所有类型只下发0x10功能码SwapF0Byte写浮点型字节顺序SwapS0Byte写字符串型字节顺序SwapL0Byte写长整型字节顺序SwapC0Byte写CRC校验字节次序SwapBCD0Byte写长BCD型字节顺序Ja0Bit读位类型写操作成功标志Sa0String读字符串类型写操作成功标志FMC1~65535String写强制多线圈状态说明：1.该寄存器最多强制16个连续的线圈状态；修改版本：V1.9北京亚控版权所有第7页共13页2020-1-111:292.通道号为线圈的起始地址；3.只能写入’0’或’1’组合的字符串如：FMC1写入111表示线圈1-3置位00000表示线圈1-5复位111111111表示线圈1-9置位下表2是Modbus功能码与本驱动支持的寄存器间的关系：功能码（16进制）名称作用相关寄存器01读取线圈状态取得一组逻辑线圈的当前状态（ON/OFF)002读取输入状态取得一组开关输入的当前状态（ON/OFF)103读取保持寄存器在一个或多个保持寄存器中取得当前的二进制值404读取输入寄存器在一个或多个输入寄存器中取得当前的二进制值305强置单线圈强置一个逻辑线圈的通断状态006预置单寄存器把具体二进值装入一个保持寄存器40F强置多线圈强置一串连续逻辑线圈的通断FMC10预置多寄存器把连续的二进制值装入对应的连续的保持寄存器4/6说明：1)SWAPF寄存器用于改变浮点数的字节顺序，SWAPL寄存器用语改变long型数据的字节顺序，只有0，1，2，3四种取值。例如在通讯时从0001地址读取的四个十六进制值为HV1,HV2,HV3,HV4则：当SWAP=0时，转换后浮点数对应的内存值为：HV4HV3HV2HV1。当SWAP=1时，转换后浮点数对应的内存值为：HV3HV4HV1HV2。当SWAP=2时，转换后浮点数对应的内存值为：HV1HV2HV3HV4。当SWAP=3时，转换后浮点数对应的内存值为：HV2HV1HV4HV3。2)对于只写寄存器，请将采集频率设置为0。3)3，4寄存器，如果客户需要读取Byte数据类型，需要定义二级通道。分别表示修改版本：V1.9北京亚控版权所有第8页共13页2020-1-111:29字的高字节和低字节。例：31.0表示地址为0的数据的低字节，31.1表示地址为0的数据的高字节。Byte数据类型只可以读，不可以写。如果需要写，请定义Short或Usho