ModbusMaster规格说明书.doc

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

2、COMPLC 莫迪康 ModbusTCP TCP其他的设备，设备名中必须包含有ModbusRTU，或 ModbusASCII ，或 ModbusTCP字样。区分大小写。否则无法使用该驱动。由于驱动是通过des 文件里面的这些关键字进行匹配的。英文版下：PLC Modicon ModbusRTU COMPLC Modicon ModbusRTU(unpack) COMPLC Modicon ModbusASCII COMPLC Modicon ModbusTCP TCP错误 ! 未找到引用源。北京亚控版权所有第 1页共10页2020-4-1821:41修改版本： V1.9注：串口统一为“ COM

3、 ”，以太网统一为“ TCP”b)设备向导页选项的特殊说明：如果是串口设备：是否选串口是是否有地址选择页是通讯方式RS232/RS485/RS422/描述COM如果是以太网设备：是否选串口是是否有地址选择页是通讯方式串口描述TCP网络设备需要选择串口的原因是：一个设备接口 (如 Com1、网卡 )开启一个线程。c) 对于串口设备通讯参数的推荐设置如下无，视具体设备而定四、本设备的地址格式及地址范围串口连接方式（ Rtu ）：Address :Delay: BeforeDelay|SwapF|SwapL|SwapCAddress1-255设备地址Delay0-60000发送每条命令帧后的延迟时间

4、（毫秒）BeforeDelay0-60000发送每条命令帧前的延迟时间（毫秒）SwapF 0-3浮点数的字节顺序，默认为0SwapL 0-3长征性的字节顺序，默认为0SwapC 0-1CRC 校验的字节顺序，默认为 0如： 1:50:50|0|0|0串口连接方式（ ASCII ）：同 RTUTCP 连接方式：IP:Port Address |SwapF|SwapL|SwapCIP设备 IP 地址或域名错误 ! 未找到引用源。北京亚控版权所有第 2页共10页2020-4-1821:41修改版本： V1.9Port设备 IP 地址端口，默认为 502Address 1-255设备地址SwapF 0

5、-3浮点数的字节顺序，默认为0(厂家沟通 )SwapL 0-3长征性的字节顺序，默认为0SwapC 0-1CRC 校验的字节顺序，默认为 0如： 192.168.0.100 1|0|0|0注：如果在设备定义中对Swap 系列功能设定，需要同时设定3 个 Swap 顺序，且 SwapF、SwapL、SwapC 次序不得有误。五、寄存器列说明寄存器范围数据类型01 65535Bit11 65535Bit3dddd:1Byte/Ushort/sho3dd.xx65535rt/BCD/float/Loxx: 0-1ng/LongBCD/St3m.nm:16553ring5n:0 127并且m+n=65

6、5354dddd:1Byte4dd.xx65535Ushort/short/Bxx: 0-1CD/float/Long/4m.nm:16553LongBCD/Strin5gn:0 127并且m+n1）时：读取长度为 N 的字符串，从地址X 开始。b) 组态王支持可输入的 ASCII 码。c) #号只能读不能写入。d) 长度问题：字符串长度为N，但在内存中还有一位结束符，实际共占N+1 位。即若写入 N 长度的字符串，实际在内存中写入N+1 位e）当写入字符串的长度小于y 时，其他内存全部填充0。y 为奇数时 ,实际在内存中写入 y+1 位。7) SWAPC 寄存器用于调整 CRC 校验字节次序

7、 .例如在通讯时从 1#Modbus 从设备 40001地址读取的数据为 01 03 02 00 06 38 46 当 SWAPC = 0时，将按 LOBYTE = 38 ，HIBYTE = 46 正常方式进行 CRC 校验错误 ! 未找到引用源。北京亚控版权所有第 5页共10页2020-4-1821:41修改版本： V1.9当 SWAPC = 1时，将按 LOBYTE = 46 ，HIBYTE = 38 反向方式进行 CRC 校验六、打包规格描述：1) 相同的寄存器，数据长度相同，不超过最大打包长度时，可以打一个包。2) Byte，Ushort，short，bcd 长度相同； long， f

8、loat，longbcd 长度相同。3) 配置文件中能够配置打包长度和打包段。七、接收缓冲区的大小：（程序员需要提供此参数，此说明只用于测试工程师测试，用户文档中不列此项。）1024 个字节八、配置文件格式以及打包规则说明(1) 配置文件格式配置文件名称为 ModbusMaster，是一个文本格式文件，文件后缀名为.ini ，其格式以及相关说明如下： 设备名称 1/设备名称，与 Devlst 中的设备名称一致PackLen =125/ 最大打包长度， 0 为不打包SupReg = 0,1,3,4/ 支持的寄存器，如果支持就添加到括号中Timeout = 15000/ 使用 GPRS 或者 Mo

9、dem 时的通讯超时，默认15000 毫秒Num = 4/ 后续的打包规则个数1 = 01，010，Fixed/ 打包规则 1，0 寄存器的 180 点数据可以打/在一个包里（协议层）， Fixed 为可选项，当协议里规/定，该数据段的数据必须在一个数据帧里请求，则定义该标记；/驱动在请求该数据段中的任何数据时，都会组帧请求 1 到 10 的/固定帧。2 = 1200，1250/1 寄存器的 15932000 点数据可以打在一个包里3 = 31，310 ，320，330/3 寄存器的 110 点数据可以打在一个包里 （协议层），20 30/点数据可以打在一个包里（协议层） 。4 = 41，41

10、0，420，430，Fixed/4 寄存器的 110 点数据可以打在一个包里 （协议层），/由于定义了 Fixed 标记，驱动在请求该数据段中的任何/数据时，都会组帧请求1 到 10 的固定帧；同样，对于错误 ! 未找到引用源。北京亚控版权所有第 6页共10页2020-4-1821:41修改版本： V1.9/20 30 点数据可以打在一个包里，由于Fixed 标记的存/在，请求 20 30 数据段之间的任何数据时，都会组帧请/求 20 到 30 的固定帧。 设备名称 2添加对当第一帧写命令失败是，从配置文件读取指定的尝试连接帧的处理TryConnectnTryStartAddress = 1

11、/注意起始地址是 1 nTryEndAddress = 1 /结束地址应该大于等于起始地址nTryRegType = 3/寄存器的类型（寄存器的顺序取值0,1,2,3 分别对应寄存器0,1,3,4）nTryDataType = 2/数据类型，可以按默认处理/解释 nTryDataType 可以选取如下值，数字代表所对应的数据类型BIT_DATATYPE1BYTE_DATATYPE2INT_DATATYPE4错误 ! 未找到引用源。北京亚控版权所有第 7页共10页2020-4-1821:41修改版本： V1.9UINT_DATATYPE8BCD_DATATYPE16LONG_DATATYPE32

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

13、后没有 fixed ，那么组包为 42-49。4) 如果相应的规则后有 fixed，那么组包为 41-410。5) 如果变量不在规则指定的范围内，则每个变量单独一个包。(3) 配置文件使用说明目前 配置 文件 ModbusRTU 段后 的信 息为 标准的modbus 协议 的打 包规 则 。ModbusRTU (unpack) 段后的信息为不打包的打包规则。如果需要修改相应的规则，则按照文件的格式要求进行修改。(4) 其他说明1) ModbusMaster.ini 文件保存在组态王驱动安装文件夹下，默认安装在: C:ProgramFilesKingviewdriver 。2) PackLen

14、单位为字 (WORD) 。由于 ModbusRTU 应答的数据最多255 字节 (127 个WORD) ，PackLen 最大设置为 127。3) 每个寄存器需单独列出打包规则。若有多个打包段，按顺序写。最多支持32 个打包段。4) 0 和 1 寄存器是以字节 (BYTE) 为单位，其他寄存器是以字(WORD) 为单位。错误 ! 未找到引用源。北京亚控版权所有第 8页共10页2020-4-1821:41修改版本： V1.9例如：1 = 10003,10004 表示寄存器变量10017-10032 可以打一个包2 = 40008,40012 表示寄存器变量40008-40012 可以打在一个包5

15、) 如果用户没有使用配置文件， 则默认打包规则见 “六 打包规则描述”；如果用户定义了配置文件，则默认打包规则无效，用户定义的打包段外的寄存器不打包。例：用户定义配置文件： 3 = 310，320，最大打包长度 127定义寄存器 35，310，320，321，322，则 35 一个包， 310-320 一个包， 321 一个包， 322 一个包。6) Modbus TCP/IP 的一帧比通用的 Modbus 的一帧在帧前多加了 6 个字节，而且在帧尾除去了 CRC 或 LRC 校验。九、重点测试部分说明（需要测试工程师重点测试部分的说明）十、程序员测试特殊说明（程序员在调试程序中发现的一些特殊

16、需要说明的问题， 例如某个寄存器写范围超过多大的数据就有问题了）十一、是否需要双机热备测试？十二、驱动运行需要涉及的其他软件的支持（备注：驱动运行需要安装的软件或需要调用的库文件或数据库文件的说明）十三、其他软硬件环境支持的简要操作说明和注意事项（备注： 1,和通讯相关的硬件参数的设置，例如仪表需要设备某个参数才能和组态王通讯2,设备软件上影响通讯的参数的设置方法， 例如对于 plc 设备，需要用软件对设备进行特殊的参数设置后，设备才能和组态王通讯，结合图片说明）十四、具体接线图的说明（有特殊连线要求的填写）十五、对于性能事项的特别说明十六、参考资料的说明附录： 3.0 接口程序编程规范关于程

17、序的规范，会影响到测试环节的部分a) 寄存器和通道号之间的 0 不做限制， 0 通道的 0 可输入可不输入。寄存器加通道号的总长度不能超过 32。错误 ! 未找到引用源。北京亚控版权所有第 9页共10页2020-4-1821:41修改版本： V1.9b)寄存器通道的多级通道之间使用英文输入下的英文点号 （” .）”，例如 A 寄存器有三级通Ax.y.zc)设备地址有多层含义时用 英文输入下的冒号 （” :）”分开 .比如 Modbus tcp 地址格式为IP地址:端口号 :单元号 ，地址举例应为为：127.0.0.1:502:12 （ IP 地址按照国际标准之间用英文”.）”各个分隔符中间只能是数字。数字可以是十进制的或者十六进制的。十六进制A F 字符大小写不敏感。如