组态王和永宏PLC驱动
组态王和永宏PLC驱动
产品规格说明书
（本说明书说明驱动产品的功能，性能指标，是测试工程师、文档工程师和开发人员交流的重要依据，是编写测试用例和帮助文档的重要依据。下边几项是必须填写的，如果还有需要说明的部分，需要编写更多的内容）
[修订记录]
| 日期 |
版本号 |
创建人 |
说明 |
| 07-2-12 |
1.0 |
欧阳丹娜 |
|
| 07-3-20 |
|
李鹏 |
添加了寄存器说明和打包规则 |
| 07-3-22 |
|
李鹏 |
根据厂家资料修改FBS-10MAT寄存器通道范围 |
| 07-4-4 |
|
李鹏 |
更改寄存器名称，补充寄存器说明和打包说明 |
| 07-5-22 |
|
李鹏 |
增加英文设备路径 |
| 07-9-3 |
|
李鹏 |
DR寄存器增加STRING类型，使用二级通道
STATUS寄存器Bit类型时使用二级通道 |
| 07-10-19 |
1.1 |
皮敏捷 |
通用版转嵌入版 |
[项目经理填写]
一、
产品功能简介
本次是在以前的代码上添加数据类型SHORT。以前这个驱动没有帮助文档，这次补全。
a) 硬件功能概述
（简要说明硬件设备功能）：
永宏PLC；
b) 支持协议说明（说明支持的协议，特别是针对多协议的设备一定要说明该驱动支持哪种协议，对协议支持到什么程度）
厂家自定义协议
c) 支持的硬件型号说明：
永宏PLC
二、
驱动接口：（老开发包，在以前的代码上添加数据类型）
（程序员必须填写，对于3.0开发包的编程规范参加附录，测试工程师按下面的规范要求执行测试）
3.0以前的开发包
三、
设备添加方式
a) 在组态王中定义设备时请选择：
通用版：[PLC]〉[永宏电机有限公司]〉[FATEK]〉[COM]
英文版：[PLC]〉[FATEK]〉[FATEK]〉[COM]
嵌入版设备列表路径：[PLC] > [永宏电机] > [FATEK] > [COM]
b) 设备向导页选项的特殊说明：
| 是否选串口 |
是 |
| 是否有地址选择页 |
是 |
| 通讯方式 |
RS232 或RS485 |
| 描述 |
COM |
| 通讯卡名 |
（没有的不需要填写） |
c) 对于串口设备通讯参数的推荐设置如下
| 设置项 |
波特率 |
数据位长度 |
停止位长度 |
奇偶校验位 |
| 推荐值 |
9600 |
7 |
1 |
E |
四、
本设备的地址格式及地址范围
0-254
五、
寄存器列说明 （参见 代码库中的永宏PLC驱动使用说明.doc）
| 寄存器名称 |
通道范围 |
数据类型 |
变量类型 |
读写属性 |
寄存器说明 |
| STATUS |
1-3
BIT: xx.yy
xx: 1-3
yy: 0-7
|
BIT,
BYTE |
I/O整数 |
只读 |
PLC概略系统状态 |
| CONTRL |
0-0 |
BIT |
I/O离散 |
只写 |
PLC RUN/STOP控制 |
| REGX |
0-9999 |
BIT, BYTE， SHORT, USHORT, LONG |
I/O整数 |
读写 |
输入接点
|
| REGY |
0-9999
|
BIT, BYTE， SHORT, USHORT, LONG |
I/O整数 |
读写 |
输出继电器
|
| REGM |
0-9999
|
BIT, BYTE， SHORT, USHORT, LONG |
I/O整数 |
读写 |
内部继电器
|
| REGS |
0-9999
|
BIT, BYTE， SHORT, USHORT, LONG |
I/O整数 |
读写 |
步进继电器
|
| REGT |
0-9999
|
BIT, BYTE， SHORT, USHORT, LONG |
I/O整数 |
读写 |
定时器接点
|
| REGC |
0-9999 |
BIT, BYTE， SHORT, USHORT, LONG |
I/O整数 |
读写 |
计数器接点
|
| TMR |
0-9999
|
SHORT, USHORT, LONG |
I/O整数 |
读写 |
定时器缓存器
|
| CTR |
0-9999 |
SHORT, USHORT, LONG |
I/O整数 |
读写 |
计数器缓存器
|
| HR |
0-65535
|
SHORT, USHORT, LONG |
I/O整数 |
读写 |
资料缓存器
|
| DR |
0-65535
STRING: xx.yy
xx: 0-65535
yy: 1-16
|
SHORT, USHORT, LONG
STRING |
I/O整数
I/O字符串 |
读写 |
资料缓存器
Yy:字符串长度 |
说明： 1, 对于只写寄存器，请将采集频率设置为0
2．对于寄存器REGX、REGY、REGM、REGS、REGT、REGC的通道范围0-9999，类型为SHORT,USHORT,LONG时，通道号必须为8的倍数。 由于X、Y、M、S、T、C为单点寄存器，所以在使用SHORT和USHORT访问寄存器时：每一个SHORT和USHORT数据都对应16个BIT；每一个LONG数据都对应32个BIT。例如：
1）SHORT型的X0寄存器的数据为REGX寄存器0通道开始的16个BIT所组成的10进制数。
SHORT型的X8寄存器的数据为REGX寄存器8通道开始的16个BIT所组成的10进制数。
因此作为SHORT型使用时，REGX0和REGX8的SHORT型数据是相互影响的。
2）LONG型的REGX0寄存器的数据为REGX寄存器0通道开始的32个BIT所组成的10进制数。
LONG型的REGX8寄存器的数据为REGX寄存器8通道开始的32个BIT所组成的10进制数。
因此作为LONG型使用时，REGX0、REGX8、REGX16、REGX24的LONG型数据都是相互影响的。
3. TMR、CTR、HR、DR寄存器按照LONG型访问时，每一个LONG对应两个SHORT。例如
LONG型的HR0寄存器的数据为HR寄存器0通道开始的2个SHORT组成的10进制数。
因此作为LONG型使用时，HR0和HR1的LONG型数据是相互影响的。
4． REGX、REGY、REGM、REGS、REGT、REGC作为BYTE时，功能为读写抑/致能状态：
写：4个状态
1 ：表示抑能
2 ：表示致能
3 ：表示设定
4 ：表示清除
读： 2个状态
0 ：表示致能
1 ：表示抑能
5．FBS-10MAT PLC的部分寄存器通道范围与facon-protocol-chs.pdf说明不符，详细请见程序员测试特殊说明
六、
特殊寄存器详细说明
（对于有特殊使用说明和含义的在寄存器列表中描述不方便的在此进行详细描述，例如某个寄存器的含义解释比较多，在上面的表上不能详细说明。或者对于一个通用驱动，针对不同型号设备寄存器支持的范围不同等）
七、
打包规格描述：
（程序员需要提供此参数，此说明只用于测试工程师测试，用户文档中不列此项。）
写寄存器不打包
（参见facon-protocol-chs.pdf第6页及依据旧代码进行填写）
| 寄存器名称 |
打包范围（对于不能实现打包的请说明原因，范围填写0～0） |
打包规则（备注：说明每个寄存器的打包规则以及包的最大通道个数；）
|
| STATUS |
1-3 |
读取打包，最大通道个数256 |
| CONTRL |
0-0 |
只写 |
| REGX |
0-9999 |
读取打包
BIT,BYTE: 最大通道个数256
USHORT,SHORT: 最大通道个数64
LONG: 最大通道个数32 |
| REGY |
0-9999 |
读取打包
BIT,BYTE: 最大通道个数256
USHORT,SHORT: 最大通道个数64
LONG: 最大通道个数32 |
| REGM |
0-9999 |
读取打包
BIT,BYTE: 最大通道个数256
USHORT,SHORT: 最大通道个数64
LONG: 最大通道个数32 |
| REGS |
0-9999 |
读取打包
BIT,BYTE: 最大通道个数256
USHORT,SHORT: 最大通道个数64
LONG: 最大通道个数32 |
| REGT |
0-9999 |
读取打包
BIT,BYTE: 最大通道个数256
USHORT,SHORT: 最大通道个数64
LONG: 最大通道个数32 |
| REGC |
0-9999 |
读取打包
BIT,BYTE: 最大通道个数256
USHORT,SHORT: 最大通道个数64
LONG: 最大通道个数32 |
| TMR |
0-9999 |
读取打包
USHORT,SHORT: 最大通道个数64
LONG: 最大通道个数32 |
| CTR |
0-9999 |
读取打包
USHORT,SHORT: 最大通道个数64
LONG: 最大通道个数32 |
| HR |
0-65535 |
读取打包
USHORT,SHORT: 最大通道个数64
LONG: 最大通道个数32 |
| DR |
0-65535 |
读取打包
USHORT,SHORT: 最大通道个数64
LONG: 最大通道个数32 |
说明：
REGX, REGY, REGM, REGS, REGT, REGC寄存器的16位（SHORT,USHORT）读取时，只有通道号相差16的倍数才可以打包
REGX, REGY, REGM, REGS, REGT, REGC寄存器的32位(LONG)读取时，只有通道号相差32的倍数才可以打包
TMR,CTR,HR,DR寄存器的32位(LONG)读取时，只有通道号相差2的倍数才可以打包
八、
接收缓冲区的大小：
（程序员需要提供此参数，此说明只用于测试工程师测试，用户文档中不列此项。）
1K
九、
重点测试部分说明
（需要测试工程师重点测试部分的说明）
十、
程序员测试特殊说明
（程序员在调试程序中发现的一些特殊需要说明的问题，例如某个寄存器写范围超过多大的数据就有问题了）
1．
单点状态（REGX、REGY、REGM、REGS、REGT、REGC）可以将连续16个或32个状态组成16位或32位缓存器来用，但通道号必须为8的倍数。
2．
FBS-10MAT的部分寄存器通道与facon-protocol-chs.pdf内的说明不符。经测试和厂家的数据，实际通道范围如下
| 寄存器 |
数据类型 |
通道范围 |
| REGX |
BIT, BYTE |
0-255 |
| |
SHORT, USHORT,LONG |
0-9999 |
| REGY |
BIT, BYTE |
0-255 |
| |
SHORT, USHORT,LONG |
0-9999 |
| REGM |
BIT, BYTE |
0-2001 |
| |
SHORT, USHORT,LONG |
0-9999 |
| REGS |
BIT, BYTE, |
0-999 |
| |
SHORT, USHORT,LONG |
0-9999 |
| REGT |
BIT, BYTE |
0-255 |
| |
SHORT, USHORT,LONG |
0-9999 |
| REGC |
BIT, BYTE |
0-255 |
| |
SHORT, USHORT,LONG |
0-9999 |
| TMR |
SHORT, USHOR，LONG |
0-255 |
| CTR |
SHORT, USHORT |
0-199 |
| |
LONG |
0-255 |
| HR |
LONG ,SHORT, USHORT |
0-8071 |
| DR |
LONG |
0-4094 |
| SHORT, USHORT |
0-4095 |
十一、
是否需要双机热备测试？
十二、
驱动运行需要涉及的其他软件的支持
（备注：驱动运行需要安装的软件或需要调用的库文件或数据库文件的说明）
十三、
其他软硬件环境支持的简要操作说明和注意事项
（备注：1,和通讯相关的硬件参数的设置，例如仪表需要设备某个参数才能和组态王通讯
2,设备软件上影响通讯的参数的设置方法，例如对于plc设备，需要用软件对设备进行特殊的参数设置后，设备才能和组态王通讯，结合图片说明）
十四、
具体接线图的说明（有特殊连线要求的填写）
十五、
对于性能事项的特别说明
十六、
参考资料的说明
《皮带秤说明书》
附录：3.0接口程序编程规范
关于程序的规范，会影响到测试环节的部分
a) 寄存器和通道号之间的0不做限制，0通道的0可输入可不输入。寄存器加通道号的总长度不能超过32。
b) 寄存器通道的多级通道之间使用英文点号（”.”），中文也可以，例如A寄存器有三级通Ax.y.z
c) 设备地址有多层含义时用英文冒号（”:”）分开(中文键盘下的也可以).比如Modbus tcp地址格式为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 |
对于不选择串口的板卡，通信卡名应写成卡的型号。如图中的红圈所示。
