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般若波罗蜜多心经
观自在菩萨，行深般若波罗蜜多时，照见五蕴皆空，度一切苦厄。
舍利子，色不异空，空不异色，色即是空，空即是色，受想行识，亦复如是。
舍利子，是诸法空相，不生不灭，不垢不净，不增不减。
是故空中无色，无受想行识，无眼耳鼻舌身意
，无色声香味触法，无眼界，乃至无意识界。
无无明，亦无无明尽，乃至无老死，亦无老死尽。
无苦集灭道，无智亦无得。
以无所得故，菩提萨埵，依般若波罗蜜多故，心无挂碍，无挂碍故，无有恐怖，远离颠倒梦想，究竟涅槃。
三世诸佛，依般若波罗蜜多故，得阿耨多罗三藐三菩提。
故知般若波罗蜜多，是大神咒，是大明咒，是无上咒，是无等等咒，能除一切苦，真实不虚。
故说般若波罗蜜多咒，即说咒曰：
揭谛揭谛，波罗揭谛，波罗僧揭谛，菩提萨婆诃。
升级会员 