ModbusMaster规格说明书

1、修改版本：V1.9ModbusMaster产品规格说明书一、 产品功能简介a) 支持协议说明通用协议：ModbusRtu，ModbusASCII，ModbusTCPb) 支持的硬件型号说明：所有支持上述协议的设备。c) 支持的连接说明及发送方式支持串口连接和TCP连接。如果是串口连接，支持按Rtu和ASCII发送；如果是TCP连接，支持以socket发送。二、 驱动接口：3.0开发包三、 设备添加方式a) 在组态王中定义设备时请选择：通用版下：PLC > 莫迪康 > ModbusRTU > COMPLC > 莫迪康 > ModbusRTU(unpack) >

2、 COMPLC > 莫迪康 > ModbusASCII > COMPLC > 莫迪康 > ModbusTCP > TCP其他的设备，设备名中必须包含有ModbusRTU，或ModbusASCII，或ModbusTCP字样。区分大小写。否则无法使用该驱动。由于驱动是通过des文件里面的这些关键字进行匹配的。英文版下：PLC > Modicon > ModbusRTU > COMPLC > Modicon > ModbusRTU(unpack) > COMPLC > Modicon > ModbusASCII &g

3、t; COMPLC > Modicon > ModbusTCP > TCP注：串口统一为“COM”，以太网统一为“TCP”b) 设备向导页选项的特殊说明：如果是串口设备：是否选串口是是否有地址选择页是 通讯方式RS232/RS485/RS422/描述COM如果是以太网设备：是否选串口是是否有地址选择页是 通讯方式串口描述TCP网络设备需要选择串口的原因是：一个设备接口(如Com1、网卡)开启一个线程。c) 对于串口设备通讯参数的推荐设置如下无，视具体设备而定四、 本设备的地址格式及地址X围串口连接方式（Rtu）：Address:Delay:BeforeDelay |SwapF

4、|SwapL|SwapCAddress 1-255设备地址Delay 0-60000 发送每条命令帧后的延迟时间（毫秒）BeforeDelay 0-60000 发送每条命令帧前的延迟时间（毫秒）SwapF 0-3 浮点数的字节顺序，默认为0SwapL 0-3 长征性的字节顺序，默认为0SwapC 0-1 CRC校验的字节顺序，默认为0如：1:50:50|0|0|0串口连接方式（ASCII）：同RTUTCP连接方式：IP:Port Address|SwapF|SwapL|SwapCIP设备IP地址或域名Port设备IP地址端口，默认为502Address1-255设备地址 SwapF 0-3 浮

5、点数的字节顺序，默认为0(厂家沟通) SwapL 0-3 长征性的字节顺序，默认为0SwapC 0-1 CRC校验的字节顺序，默认为0如：192.168.0.100 1|0|0|0注：如果在设备定义中对Swap系列功能设定，需要同时设定3个Swap顺序，且SwapF、SwapL、SwapC次序不得有误。五、 寄存器列说明寄存器X围数据类型读写说明01 65535Bit读写逻辑线圈，I/O离散 （0XXXX）11 65535Bit读输入位寄存器（1XXXX）3dd3dd.xx3m.ndd: 1 65535xx: 0-1m:165535n:0127并且m+n<=65535Byte/Ushor

6、t/short/BCD/float/Long/LongBCD/String读输入寄存器（3XXXX）4dd4dd.xx4m.ndd: 1 65535xx: 0-1m:165535n:0127并且m+n<=65535ByteUshort/short/BCD/float/Long/LongBCD/String读读写保持寄存器（4XXXX）SwapF0Byte写浮点型字节顺序SwapL0Byte写长整型字节顺序SwapC0Byte写CRC校验字节次序FMC165535String写强制多线圈状态说明：1. 该寄存器最多强制16个连续的线圈状态；2. 通道号为线圈的起始地址；3. 只能写入0或1

7、组合的字符串如：FMC1写入111表示线圈1-3置位00000表示线圈1-5复位111111111表示线圈1-9置位下表2是Modbus功能码与本驱动支持的寄存器间的关系：功能码 名称 作用 相关寄存器01 读取线圈状态 取得一组逻辑线圈的当前状态（ON/OFF)002 读取输入状态 取得一组开关输入的当前状态（ON/OFF) 103 读取保持寄存器 在一个或多个保持寄存器中取得当前的二进制值404 读取输入寄存器 在一个或多个输入寄存器中取得当前的二进制值305 强置单线圈 强置一个逻辑线圈的通断状态 006 预置单寄存器 把具体二进值装入一个保持寄存器 415 强置多线圈 强置一串连续逻辑

8、线圈的通断 FMC说明： 1) SWAPF寄存器用于改变浮点数的字节顺序，SWAPL寄存器用语改变long型数据的字节顺序，只有0， 1， 2， 3四种取值。例如在通讯时从0001地址读取的四个十六进制值为 HV1,HV2, HV3, HV4则：当SWAP = 0时，转换后浮点数对应的内存值为： HV4 HV3 HV2 HV1。当SWAP = 1时，转换后浮点数对应的内存值为： HV3 HV4 HV1 HV2。当SWAP = 2时，转换后浮点数对应的内存值为： HV1 HV2 HV3 HV4。当SWAP = 3时，转换后浮点数对应的内存值为： HV2 HV1 HV4 HV3。2) 对于只写寄存

9、器，请将采集频率设置为0。3) 3，4寄存器，如果客户需要读取Byte数据类型，需要定义二级通道。分别表示字的高字节和低字节。例：31.0表示地址为0的数据的低字节，31.1表示地址为0的数据的高字节。Byte数据类型只可以读，不可以写。如果需要写，请定义Short或Ushort数据类型。4) 寄存器4读功能码为03，写单字(Short，Ushort，BCD)的功能码为06，写双字(Long，Float，LongBCD)的功能码为0x10。5) 驱动的变量后的寄存器通道号(寄存器X围)，是按照以1为起始地址的。对于以0为起始地址的设备，定义变量应该加1。例如，如果某设备的一个变量在数据4区，为

10、40100，如果地址是从1开始，对应变量定义为40100；如果地址是从0开始，定义为40101。6) 3,4寄存器的String类型说明：a) 二级通道表示 x.y X表示读/写字符串的起始地址；y表示字符串的长度。长度说明：字符串长度为N，但在内存中还有一位结束符，由于Modbus Holding Register只能以双字节为单位写，所以实际发帧的时候共发N+1个字节或N+2个字节。即若写入N长度的字符串，实际在PLC中写入N+1或N+2个字节。Y = 0 时：驱动代码中赋一个空串给组态王，但组态王显示为“0”。Y=1 时： 读取的字符串为地址X的当前ASCII字符。Y=N（N>1）

11、时：读取长度为N的字符串，从地址X开始。b) 组态王支持可输入的ASCII码。c) #号只能读不能写入。d) 长度问题：字符串长度为N，但在内存中还有一位结束符，实际共占N+1位。即若写入N长度的字符串，实际在内存中写入N+1位e）当写入字符串的长度小于y时，其他内存全部填充'0'。y为奇数时,实际在内存中写入y+1位。7) SWAPC寄存器用于调整CRC校验字节次序.例如在通讯时从1#Modbus 从设备40001地址读取的数据为 01 03 02 00 06 3846当SWAPC = 0时，将按 LOBYTE = 38，HIBYTE = 46 正常方式进行CRC校验当SWA

12、PC = 1时，将按 LOBYTE = 46，HIBYTE = 38 反向方式进行CRC校验六、 打包规格描述：1) 相同的寄存器，数据长度相同，不超过最大打包长度时，可以打一个包。2) Byte，Ushort，short，bcd长度相同；long，float，longbcd长度相同。3) 配置文件中能够配置打包长度和打包段。七、 接收缓冲区的大小：（程序员需要提供此参数，此说明只用于测试工程师测试，用户文档中不列此项。）1024个字节八、 配置文件格式以及打包规则说明(1) 配置文件格式配置文件名称为ModbusMaster，是一个文本格式文件，文件后缀名为.ini，其格式以及相关说明如下：

13、设备名称1 /设备名称，与Devlst中的设备名称一致PackLen =125 / 最大打包长度，0为不打包SupReg = 0,1,3,4 / 支持的寄存器，如果支持就添加到括号中Timeout = 15000 / 使用GPRS或者Modem时的通讯超时，默认15000毫秒Num = 4 / 后续的打包规则个数1 = 01，010，Fixed / 打包规则1，0寄存器的180点数据可以打/在一个包里（协议层），Fixed为可选项，当协议里规/定，该数据段的数据必须在一个数据帧里请求，则定义该标记；/驱动在请求该数据段中的任何数据时，都会组帧请求1到10的/固定帧。2 = 1200，1250

14、/1寄存器的15932000点数据可以打在一个包里3 = 31，310 ，320，330 /3寄存器的110点数据可以打在一个包里（协议层），20 30/点数据可以打在一个包里（协议层）。4 = 41，410，420，430，Fixed /4寄存器的110点数据可以打在一个包里（协议层），/由于定义了Fixed标记，驱动在请求该数据段中的任何/数据时，都会组帧请求1到10的固定帧；同样，对于 /20 30点数据可以打在一个包里，由于Fixed标记的存/在，请求20 30数据段之间的任何数据时，都会组帧请/求20 到30的固定帧。设备名称2添加对当第一帧写命令失败是，从配置文件读取指定的尝试连接

15、帧的处理TryConnectnTryStartAddress = 1 /注意起始地址是1nTryEndAddress = 1 /结束地址应该大于等于起始地址nTryRegType = 3 /寄存器的类型（寄存器的顺序取值0,1,2,3分别对应寄存器0,1,3,4）nTryDataType = 2 /数据类型，可以按默认处理/ 解释nTryDataType可以选取如下值，数字代表所对应的数据类型BIT_DATATYPE1BYTE_DATATYPE2INT_DATATYPE4UINT_DATATYPE8BCD_DATATYPE16LONG_DATATYPE32LONGBCD_DATATYPE64F

16、LOAT_DATATYPE128STRING_DATATYPE256(2) 打包规则说明配置文件是一个信息文件格式，其中定义了设备名称以及打包规则。需要说明的是，这里定义的打包规则是基于协议的。比如协议里规定，4寄存器的110是一个数据段，可以在一个包里请求，那么就在配置文件里定义41，410如果客户在组态王中定义了变量的情况如下：42，45，46，47，48，49则会依据下面的步骤进行判断，1) 从配置文件里，载入配置信息，获得协议层的打包规则；2) 42，45，46，47，48，49这些变量在一个包里可以读出。3) 如果相应的规则后没有fixed，那么组包为42-49。4) 如果相应的规则

17、后有fixed，那么组包为41-410。5) 如果变量不在规则指定的X围内，则每个变量单独一个包。 (3) 配置文件使用说明目前配置文件ModbusRTU段后的信息为标准的modbus协议的打包规则。ModbusRTU(unpack)段后的信息为不打包的打包规则。如果需要修改相应的规则，则按照文件的格式要求进行修改。(4) 其他说明1) ModbusMaster.ini文件保存在组态王驱动安装文件夹下，默认安装在: C:Program FilesKingviewdriver。2) PackLen单位为字(WORD)。由于ModbusRTU应答的数据最多255字节(127个WORD)，PackL

18、en最大设置为127。3) 每个寄存器需单独列出打包规则。若有多个打包段，按顺序写。最多支持32个打包段。4) 0和1寄存器是以字节(BYTE)为单位，其他寄存器是以字(WORD)为单位。例如：1 = 10003,10004 表示寄存器变量10017-10032可以打一个包2 = 40008,40012 表示寄存器变量40008-40012可以打在一个包5) 如果用户没有使用配置文件，则默认打包规则见“六 打包规则描述”；如果用户定义了配置文件，则默认打包规则无效，用户定义的打包段外的寄存器不打包。例：用户定义配置文件：3 = 310，320，最大打包长度127定义寄存器35，310，320，

19、321，322，则35一个包，310-320一个包，321一个包，322一个包。6) Modbus TCP/IP 的一帧比通用的Modbus的一帧在帧前多加了6个字节，而且在帧尾除去了CRC或LRC校验。九、 重点测试部分说明（需要测试工程师重点测试部分的说明）十、 程序员测试特殊说明（程序员在调试程序中发现的一些特殊需要说明的问题，例如某个寄存器写X围超过多大的数据就有问题了）十一、 是否需要双机热备测试？十二、 驱动运行需要涉及的其他软件的支持（备注：驱动运行需要安装的软件或需要调用的库文件或数据库文件的说明）十三、 其他软硬件环境支持的简要操作说明和注意事项（备注：1,和通讯相关的硬件参数的设置，例如