ModbusMaster规格说明书.docx
《ModbusMaster规格说明书.docx》由会员分享,可在线阅读,更多相关《ModbusMaster规格说明书.docx(14页珍藏版)》请在冰豆网上搜索。
ModbusMaster规格说明书
ModbusMaster
产品规格说明书
一、产品功能简介
a)支持协议说明
通用协议:
ModbusRtu,ModbusASCII,ModbusTCP
b)支持的硬件型号说明:
所有支持上述协议的设备。
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]
[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]
Address1-255设备地址
Delay0-60000发送每条命令帧后的延迟时间(毫秒)
BeforeDelay0-60000发送每条命令帧前的延迟时间(毫秒)
SwapF0-3浮点数的字节顺序,默认为0
SwapL0-3长征性的字节顺序,默认为0
SwapC0-1CRC校验的字节顺序,默认为0
如:
1:
50:
50|0|0|0
串口连接方式(ASCII):
同RTU
TCP连接方式:
IP[:
Port]Address[|SwapF|SwapL|SwapC]
IP设备IP地址或域名
Port设备IP地址端口,默认为502
Address1-255设备地址
SwapF0-3浮点数的字节顺序,默认为0(厂家沟通)
SwapL0-3长征性的字节顺序,默认为0
SwapC0-1CRC校验的字节顺序,默认为0
如:
192.168.0.1001|0|0|0
注:
如果在设备定义中对Swap系列功能设定,需要同时设定3个Swap顺序,且SwapF、SwapL、SwapC次序不得有误。
五、寄存器列说明
寄存器
范围
数据类型
读写
说明
0
1~65535
Bit
读写
逻辑线圈,I/O离散(0XXXX)
1
1~65535
Bit
读
输入位寄存器(1XXXX)
3dd
3dd.xx
3m.n
dd:
1~65535
xx:
0-1
m:
1~65535
n:
0~127
并且
m+n<=65535
Byte/Ushort/short/BCD/float/Long/LongBCD/String
读
输入寄存器(3XXXX)
4dd
4dd.xx
4m.n
dd:
1~65535
xx:
0-1
m:
1~65535
n:
0~127
并且
m+n<=65535
Byte
Ushort//short/BCD/float/Long/LongBCD/String
读
读写
保持寄存器(4XXXX)
SwapF
0
Byte
写
浮点型字节顺序
SwapL
0
Byte
写
长整型字节顺序
SwapC
0
Byte
写
CRC校验字节次序
FMC
1~65535
String
写
强制多线圈状态
说明:
1.该寄存器最多强制16个连续的线圈状态;
2.通道号为线圈的起始地址;
3.只能写入’0’或’1’组合的字符串
如:
FMC1写入
111表示线圈1-3置位
00000表示线圈1-5复位
111111111表示线圈1-9置位
下表2是Modbus功能码与本驱动支持的寄存器间的关系:
功能码
名称
作用
相关寄存器
01
读取线圈状态
取得一组逻辑线圈的当前状态(ON/OFF)
0
02
读取输入状态
取得一组开关输入的当前状态(ON/OFF)
1
03
读取保持寄存器
在一个或多个保持寄存器中取得当前的二进制值
4
04
读取输入寄存器
在一个或多个输入寄存器中取得当前的二进制值
3
05
强置单线圈
强置一个逻辑线圈的通断状态
0
06
预置单寄存器
把具体二进值装入一个保持寄存器
4
15
强置多线圈
强置一串连续逻辑线圈的通断
FMC
说明:
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数据类型,需要定义二级通道。
分别表示字的高字节和低字节。
例:
31.0表示地址为0的数据的低字节,31.1表示地址为0的数据的高字节。
Byte数据类型只可以读,不可以写。
如果需要写,请定义Short或Ushort数据类型。
4)寄存器4读功能码为03,写单字(Short,Ushort,BCD)的功能码为06,写双字(Long,Float,LongBCD)的功能码为0x10。
5)驱动的变量后的寄存器通道号(寄存器范围),是按照以1为起始地址的。
对于以0为起始地址的设备,定义变量应该加1。
例如,如果某设备的一个变量在数据4区,为40100,如果地址是从1开始,对应变量定义为40100;如果地址是从0开始,定义为40101。
6)3,4寄存器的String类型说明:
a)二级通道表示x.y
X表示读/写字符串的起始地址;y表示字符串的长度。
长度说明:
字符串长度为N,但在内存中还有一位结束符,由于ModbusHoldingRegister只能以双字节为单位写,所以实际发帧的时候共发N+1个字节或N+2个字节。
即若写入N长度的字符串,实际在PLC中写入N+1或N+2个字节。
Y=0时:
驱动代码中赋一个空串给组态王,但组态王显示为“0”。
Y=1时:
读取的字符串为地址X的当前ASCII字符。
Y=N(N>1)时:
读取长度为N的字符串,从地址X开始。
b)组态王支持可输入的ASCII码。
c)#号只能读不能写入。
d)长度问题:
字符串长度为N,但在内存中还有一位结束符,实际共占N+1位。
即若写入N长度的字符串,实际在内存中写入N+1位
e)当写入字符串的长度小于y时,其他内存全部填充'\0'。
y为奇数时,实际在内存中写入y+1位。
7)SWAPC寄存器用于调整CRC校验字节次序.
例如在通讯时从1#Modbus从设备40001地址读取的数据为01030200063846
当SWAPC=0时,将按LOBYTE=38,HIBYTE=46正常方式进行CRC校验
当SWAPC=1时,将按LOBYTE=46,HIBYTE=38反向方式进行CRC校验
六、打包规格描述:
1)相同的寄存器,数据长度相同,不超过最大打包长度时,可以打一个包。
2)Byte,Ushort,short,bcd长度相同;long,float,longbcd长度相同。
3)配置文件中能够配置打包长度和打包段。
七、接收缓冲区的大小:
(程序员需要提供此参数,此说明只用于测试工程师测试,用户文档中不列此项。
)
1024个字节
八、配置文件格式以及打包规则说明
(1)配置文件格式
配置文件名称为ModbusMaster,是一个文本格式文件,文件后缀名为.ini,其格式以及相关说明如下:
[设备名称1]//设备名称,与Devlst中的设备名称一致
PackLen=125//最大打包长度,0为不打包
SupReg=[0,1,3,4]//支持的寄存器,如果支持就添加到括号中
Timeout=15000//使用GPRS或者Modem时的通讯超时,默认15000毫秒
Num=4//后续的打包规则个数
1=01,010,Fixed//打包规则1,0寄存器的1~80点数据可以打
//在一个包里(协议层),Fixed为可选项,当协议里规
//定,该数据段的数据必须在一个数据帧里请求,则定义该标记;//驱动在请求该数据段中的任何数据时,都会组帧请求1到10的//固定帧。
2=1200,1250//1寄存器的1593~2000点数据可以打在一个包里
3=31,310,320,330//3寄存器的1~10点数据可以打在一个包里(协议层),20~30
//点数据可以打在一个包里(协议层)。
4=41,410,420,430,Fixed//4寄存器的1~10点数据可以打在一个包里(协议层),//由于定义了Fixed标记,驱动在请求该数据段中的任何
//数据时,都会组帧请求1到10的固定帧;同样,对于//20~30点数据可以打在一个包里,由于Fixed标记的存
//在,请求20~30数据段之间的任何数据时,都会组帧请//求20到30的固定帧。
[设备名称2]
…
添加对当第一帧写命令失败是,从配置文件读取指定的尝试连接帧的处理
[TryConnect]
nTryStartAddress=1//注意起始地址是1
nTryEndAddress=1//结束地址应该大于等于起始地址
nTryRegType=3//寄存器的类型(寄存器的顺序取值0,1,2,3分别对应寄存器0,1,3,4)
nTryDataType=2//数据类型,可以按默认处理
//
解释nTryDataType可以选取如下值,数字代表所对应的数据类型
BIT_DATATYPE1
BYTE_DATATYPE2
INT_DATATYPE4
UINT_DATATYPE8
BCD_DATATYPE16
LONG_DATATYPE32
LONGBCD_DATATYPE64
FLOAT_DATATYPE128
STRING_DATATYPE256
(2)打包规则说明
配置文件是一个信息文件格式,其中定义了设备名称以及打包规则。
需要说明的是,这里定义的打包规则是基于协议的。
比如协议里规定,4寄存器的1~10是一个数据段,可以在一个包里请求,那么就在配置文件里定义41,410
如果客户在组态王中定义了变量的情况如下:
42,45,46,47,48,49
则会依据下面的步骤进行判断,
1)从配置文件里,载入配置信息,获得协议层的打包规则;
2)42,45,46,47,48,49这些变量在一个包里可以读出。
3)如果相应的规则后没有fixed,那么组包为42-49。
4)如果相应的规则后有fixed,那么组包为41-410。
5)如果变量不在规则指定的范围内,则每个变量单独一个包。
(3)配置文件使用说明
目前配置文件[ModbusRTU]段后的信息为标准的modbus协议的打包规则。
[ModbusRTU(unpack)]段后的信息为不打包的打包规则。
如果需要修改相应的规则,则按照文件的格式要求进行修改。
(4)其他说明
1)ModbusMaster.ini文件保存在组态王驱动安装文件夹下,默认安装在:
C:
\ProgramFiles\Kingview\driver。
2)PackLen单位为字(WORD)。
由于ModbusRTU应答的数据最多255字节(127个WORD),PackLen最大设置为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,321,322,则35一个包,310-320一个包,321一个包,322一个包。
6)ModbusTCP/IP的一帧比通用的Modbus的一帧在帧前多加了6个字节,而且在帧尾除去了CRC或LRC校验。
九、重点测试部分说明
(需要测试工程师重点测试部分的说明)
一十、程序员测试特殊说明
(程序员在调试程序中发现的一些特殊需要说明的问题,例如某个寄存器写范围超过多大的数据就有问题了)
一十一、是否需要双机热备测试?
一十二、驱动运行需要涉及的其他软件的支持
(备注:
驱动运行需要安装的软件或需要调用的库文件或数据库文件的说明)
一十三、其他软硬件环境支持的简要操作说明和注意事项
(备注:
1,和通讯相关的硬件参数的设置,例如仪表需要设备某个参数才能和组态王通讯
2,设备软件上影响通讯的参数的设置方法,例如对于plc设备,需要用软件对设备进行特殊的参数设置后,设备才能和组态王通讯,结合图片说明)
一十四、具体接线图的说明(有特殊连线要求的填写)
一十五、对于性能事项的特别说明
一十六、参考资料的说明
附录:
3.0接口程序编程规范
关于程序的规范,会影响到测试环节的部分
a)寄存器和通道号之间的0不做限制,0通道的0可输入可不输入。
寄存器加通道号的总长度不能超过32。
b)寄存器通道的多级通道之间使用英文输入下的英文点号(”.”),例如A寄存器有三级通Ax.y.z
c)设备地址有多层含义时用英文输入下的冒号(”:
”)分开.比如Modbustcp地址格式为IP地址:
端口号:
单元号,地址举例应为为:
127.0.0.1:
502:
12(IP地址按照国际标准之间用英文”.”)
各个分隔符中间只能是数字。
数字可以是十进制的或者十六进制的。
十六进制A~F字符大小写不敏感。
如果需要表示字符信息,用数字代表,并且在规格说明书中注明,例如:
某电力仪表的驱动需要在地址栏中注明选用的电压测量范围,0~5v或者0~220v,那么可以规定数字0代表0~5v,数字1代表0~220v,其他输入非法。
d)设备列表编写规范
通信方式
描述方法
串口
COM
TCP
TCP
UDP
UDP
PCI
PCI
ISA
ISA
USB
USB
对于不选择串口的板卡,通信卡名应写成卡的型号。
如图中的红圈所示
1般若波罗蜜多心经
观自在菩萨,行深般若波罗蜜多时,照见五蕴皆空,度一切苦厄。
舍利子,色不异空,空不异色,色即是空,空即是色,受想行识,亦复如是。
舍利子,是诸法空相,不生不灭,不垢不净,不增不减。
是故空中无色,无受想行识,无眼耳鼻舌身意
,无色声香味触法,无眼界,乃至无意识界。
无无明,亦无无明尽,乃至无老死,亦无老死尽。
无苦集灭道,无智亦无得。
以无所得故,菩提萨埵,依般若波罗蜜多故,心无挂碍,无挂碍故,无有恐怖,远离颠倒梦想,究竟涅槃。
三世诸佛,依般若波罗蜜多故,得阿耨多罗三藐三菩提。
故知般若波罗蜜多,是大神咒,是大明咒,是无上咒,是无等等咒,能除一切苦,真实不虚。
故说般若波罗蜜多咒,即说咒曰:
揭谛揭谛,波罗揭谛,波罗僧揭谛,菩提萨婆诃。