[开发测试]KEPServerEX6 MTConnect-Driver 中文说明书（完整版）

MTConnect? Driver Help

? 2015 Kepware Technologies

雲飛兄
群：905485143

2022．02 . 22

目录

2.MTConnect?驱动程序帮助4

3.概述4

4.频道设置6

5.设备设置7

6.设置7

7.自动标签数据库生成9

8.数据类型描述9

9.地址描述11

10.错误描述12

11.地址验证12

12.数据类型<type>对设备地址<address>无效。 12

13.设备地址<address>包含语法错误。 13

14.设备地址<地址>是只读的。 13

15.设备状态消息13

16.设备<设备名称>没有响应。 13

17.读取设备<device>上的数据项<address>失败。原因：代理报告的数据是不可用。 14

19.读取设备<device>上的数据项<address>失败。原因：代理的响应失败

20.模式验证。 14

21.读取设备<device>上的数据项<address>失败。原因：创建MTConnect时出错

22.分组。 14

23.读取设备<device>上的数据项<address>失败。原因：内部错误。 15

24.读取设备<device>上的数据项<address>失败。原因：数据项ID无效。 15

25.读取设备<device>上的数据项<address>失败。原因：代理的响应无效。 15

26.读取设备<device>上的数据项<address>失败。原因：收到HTTP错误<errorcode> .15

27.读取设备<device>上的数据项<address>失败。原因：收到MTConnect错误

28. <错误字符串>。 15

29.读取设备<device>上的数据项<address>失败。原因：无法连接到代理。 16

30.读取设备<device>上的数据项<address>失败。原因：无法将请求传输到

31.代理人。 16

32.读取设备<device>上的数据项<address>失败。原因：XML验证错误：节点

由于没有找到DTD /模式声明，因此既无效也无效。 16

34. <schema file>无法加载;可能会导致验证错误。 17

35.无法绑定到适配器：<网络适配器名称>。连接失败。 17

36.自动标签数据库生成消息17

37.无法为设备<device>生成标记数据库。原因：代理人没有回应。 18

38.无法为设备<device>生成标记数据库。原因：代理返回MTConnect错误：

39. <错误字符串>。 18

40.无法为设备<device>生成标记数据库。原因：创建MTConnect数据包时出错。 18

41.无法为设备<device>生成标记数据库。原因：HTTP错误：<错误代码>。 18

42.无法为设备<device>生成标记数据库。原因：内部错误。 18

43.无法为设备<device>生成标记数据库。原因：代理的响应无效。 19

44.无法为设备<device>生成标记数据库。原因：代理程序失败的架构响应验证。 19

46.无法为设备<device>生成标记数据库。原因：无法连接到代理。 19

47.无法为设备<device>生成标记数据库。原因：无法将请求传送给剂。 19

49.错误代码20

50. MTConnect错误代码20

51. HTTP响应代码20

52.指数21

------------

MTConnect? Driver Help

Help version 1.019

CONTENTS

Overview? 概观

What is the MTConnect Driver?? 什么是MTConnect驱动程序？

Channel Setup? 频道设置

How do I configure the driver to search for devices on the network? 如何配置驱动程序以搜索网络上的设备？

Device Setup? 设备设置

How do I configure a device for use with this driver??? 如何配置设备以使用此驱动程序？

Automatic Tag Database Generation? 自动标签数据库生成

How can I automatically generate tags from an MTConnect agent? 如何从MTConnect代理自动生成标签

Data Types Description? 数据类型描述

What data types does this driver support? 该驱动程序支持哪些数据类型？

Address Descriptions? 地址描述

How do I reference a data location in an MTConnect device?? 如何在MTConnect设备中引用数据位置？

Error Descriptions? 错误描述

What error messages does the MTConnect Driver produce?? MTConnect驱动程序产生哪些错误消息？

-----------------------------------------------------------------------------------------------------

Overview ??概观

What is the MTConnect Driver?? 什么是MTConnect驱动程序？

MTConnect?客户端驱动程序提供了一种将MTConnect代理连接到OPC客户端的简便方法

应用程序，包括HMI，SCADA，Historian，MES，ERP和许多自定义应用程序。

MTConnect是一种轻量级，开放且可扩展的协议，旨在在车间之间交换数据用于监测和数据分析的设备和软件应用程序。 该标准是拥有和由MTConnect Institute维护。 MTConnect系统的基本架构是：

?

?

?

?

代理(agent)，适配器(adapter)和设备(device)可以组合或分离，并在设备，PC或设备中实现组合。

MTConnect客户端驱动程序在应用程序级别运行。 TCP / IP用于通过寻址其IP和端口号与适配器和代理进行通信。 适配器的默认端口号是7878，代理的默认端口是5000，但是80，经常使用默认HTTP端口。 代理程序响应具有格式良好的XML的应用程序请求，其中适配器将管道分离的数据发送到代理程序。

MTConnect?客户端驱动程序适用于所有符合V1.1和V1.2标准的MTConnect代理，并提供部分功能

支持V1.3。驱动程序当前支持以下MTConnect命令：

PROBE：此命令读取设备的地址空间（由代理表示并用于自动生成标记）。

CURRENT：此命令读取数据项的快照值。

最佳实践

MTConnect?客户端驱动程序始终连接到代理程序; 必须将指定给目标代理程序的任何端口号指定为“设备属性”中的“端口号”设置。 可以将MTConnect?客户端驱动程序连接到适配器端口，该端口失败，因为驱动程序需要XML格式并且无法解释管道分离的数据。 最好通过浏览器连接端口来验证端口，以确认有效的数据结果。

例：

如果代理和适配器都在IP地址为10.20.21.73的PC上运行，请使用以下地址进行连接：

http://10.20.21.73:5000

http://10.20.21.73:7878

端口5000返回格式良好的XML。

端口7878返回管道分离的数据;例如2015-01-15T16：40：58.616Z | Xloadc |师范大学||||

事件日志中的XML验证错误意味着从代理发送的XML失败了文件夹driver / MTConnectClient中的模式文件中的某些方面或限制，或者来自代理的XML流中指定的模式文件的版本不在 driver / MTConnectClient文件夹。 要临时绕过代理流的所有架构验证，请从driver / MTConnectClient文件夹中删除所有架构。 用于在代理和驱动程序之间传输数据的MTConnect版本由代理确定，可以在代理配置文件中设置。

笔记：

1.重新启动或重新初始化服务器运行时以加载架构更改。

2. 2014年11月发布的MTConnect 1.3版增加了对XML模式1.1的支持。这个MTConnect

客户端驱动程序不支持依赖XSD 1.1的增强功能。

也可以看看：

错误描述

-----------------------------------------------------------------------------------------

Channel Setup? 频道设置

Device Discovery?? 设备发现

MTConnect驱动程序可以在网络上定位代理。 找到代理后，可以将它们添加到代理中

通道作为服务器设备。 一次可以发现的代理程序的最大数量是65535.有关更多信息

有关设备发现的信息，请参阅服务器帮助文件。

?

参数说明如下：

起始IP地址(Starting IP Address)：该参数指定起始IP地址。 默认设置为0.0.0.0。

结束IP地址(Ending IP Address)：该参数指定结束IP地址。 默认设置为0.0.0.0。

端口(Port)：该参数指定端口号。 有效范围是1到65535.默认设置为80。

Timeout超时（msec） (Number of Retries)：此参数指定驱动程序等待与代理建立连接的时间，以及驱动程序在放弃之前等待代理响应的时间并继续下一个请求。 默认设置为500毫秒。

重试次数：此参数指定驱动程序在放弃和继续下一条消息之前重试消息的次数。 默认设置为1。

--------------------------------------------------------------------------------------------------

设备设置 ?Device Setup

支持的设备 ?(Supported Devices)

任何符合V1.1的MTConnect代理。

注意：用户可以将其他模式导入服务器的root \ Drivers \ MTConnectClient文件夹。

最大通道数和设备数 ?(Maximum Number of Channels and Devices)

支持的最大通道数为100.每个通道支持的最大设备数为256。

设备编号 ?(Device ID)

除了代理中引用的设备的名称之外，设备ID还指定代理的IP地址/主机名。

格式为<IPAddress \ HostName> / <Device-ID>。 设备名称必须是NMTOKEN XML类型。

例（Example）

173.45.237.40/VMC-3Axis

注意：有关更多信息，请参阅可扩展标记语言（XML）1.0（第五版）。

自动降级 ?(Auto-Demotion)

具有许多标签的非响应代理可能阻碍与同一信道上的其他代理的通信，这是由于对非响应代理的每个连续查询所使用的超时时段。 因此，建议在通信不可靠时为每个代理使用自动降级。 有关autodemotion的更多信息，请参阅服务器帮助文件。

------------------------------------------------------------------------------------------------------------------

设置 (Settings)

与代理通信时使用这些参数。

?

参数说明如下：

端口号（Port numbe）：该参数指定端口号。 有效范围是1到65535.默认值设置是80。

每个请求的项目数（Items per request）：此参数指定每次读取时将多少数据项捆绑在一起

请求。 有效范围是1到100.默认设置为25。

每次请求后关闭与代理的连接(Close connection with the agent after each request)：选中此选项后，此选项将在每次读取请求后关闭与代理的套接字连接。 将打开一个新连接以供后续读取。 选中默认设置

-----------------------------------------------------------------------------------------------------------------

自动标签数据库生成 ?--? Automatic Tag Database Generation

MTConnect驱动程序能够从MTConnect代理程序为设备自动生成标签。 执行此操作时，驱动程序将使用PROBE命令接收设备的所有现有数据项。 然后将创建与每个接收的数据项对应的标签。

MTConnect设备由可能具有其他子组件的组件组成。 数据项在组件内组织。 自动生成的标签将组织在同一层次结构中; 也就是说，在与每个组件或子组件对应的标签组中

注意：有关自动标记数据库生成的更多信息，请参阅服务器帮助文件。

数据类型描述 ?-- Data Types Description

? ? ? ? ? ? ? ? ? ? ? ? ? ? ??

?

分配数据类型 ?--? Assigning Data Types

手动创建的标记还必须手动分配数据类型。 用户必须分配正确的数据类型，因为MTConnect驱动程序没有基于标记地址（或数据项ID）的任何信息。 手动创建的标签的默认数据类型是String。

自动生成的标签将根据MTConnect标准自动分配数据类型。 有关更多信息，请参阅MTConnect?标准第2部分 - 组件和数据项1.1.0版和MTConnect?标准第3部分 - 流，事件，样本和条件版本1.1.0。

以下数据类型映射表用于自动生成的标记。

SAMPLE Data Items?? --示例数据项

? ? ? ? ? ? ? ? ? ? ?

? ? ? ? ? ? ? ? ? ? ?

?

?

EVENT Data Items?? (事件数据项)

? ? ? ? ? ? ? ? ? ? ? ??

Note: All CONDITION type data items are assigned the String data type.

注意：所有CONDITION类型数据项都分配了String数据类型。

地址描述 ??（Address Descriptions）

MTConnect驱动程序使用数据项ID指定地址。 此ID区分大小写，并且必须符合W3C标准ID类型。 因此，ID必须以冒号，逗号，下划线或字母（A-Z或a-z）开头。 然后可以跟随数字，字母，连字符或句点。 有关更多信息，请参阅可扩展标记语言（XML）1.0（第五版）。

注意：所有地址都是只读的。

========================================

Error Descriptions? (错误描述)

The following error/warning messages may be generated. Click on the link for a description of the message. 可能会生成以下错误/警告消息。 单击链接以获取消息描述。

Address Validation? (地址验证)

Data Type <type> is not valid for device address <address>.?? --? 数据类型<type>对设备地址<address>无效。

Device address <address> contains a syntax error. ??--? 设备地址<address>包含语法错误。

Device address <address> is read only. ?--? 设备地址<地址>是只读的。

Device Status Messages? (设备状态消息)

-Device <device name> is not responding.?? --? 设备<设备名称>没有响应。

-Read for the data item <address> on device <device> failed. Reason: Agent unable to collect data

from the device. Agent reported data is UNAVAILABLE.?? --? 读取设备<device>上的数据项<address>失败。 原因：代理无法从设备收集数据。 代理报告的数据是无法使用的。

-Read for the data item <address> on device <device> failed. Reason: Response from agent failed

schema validation.?? --?? 读取设备<device>上的数据项<address>失败。 原因：代理响应模式验证失败。

-Read for the data items <address> on device <device> failed. Reason: Error in creating MTConnect packet.? --? 读取设备<device>上的数据项<address>失败。 原因：创建MTConnect数据包时出错。

-Read for the data items <address> on device <device> failed. Reason: Internal error.? --? 读取设备<device>上的数据项<address>失败。 原因：内部错误。

-Read for the data items <address> on device <device> failed. Reason: Invalid data item ID.? --? 读取设备<device>上的数据项<address>失败。 原因：数据项ID无效。

-Read for the data items <address> on device <device> failed. Reason: Invalid response from agent.?? --? 读取设备<device>上的数据项<address>失败。 原因：代理的响应无效。

-Read for the data items <address> on device <device> failed. Reason: Received HTTP error <errorcode>.? --? 读取设备<device>上的数据项<address>失败。 原因：收到HTTP错误<errorcode>。

-Read for the data items <address> on device <device> failed. Reason: Received MTConnect error?? --?? 读取设备<device>上的数据项<address>失败。 原因：收到MTConnect错误

<error-string>.?? -- <错误字符串>

-Read for the data items <address> on device <device> failed. Reason: Unable to connect to the

agent.??? --? 读取设备<device>上的数据项<address>失败。 原因：无法连接到代理。

-Read for the data items <address> on device <device> failed. Reason: Unable to transmit request

to the agent.? -- 读取设备<device>上的数据项<address>失败。 原因：无法向代理发送请求。

-Read for the data items <address> on device <device> failed. Reason: XML Validation Error: The

node is neither valid nor invalid because no DTD/Schema declaration was found.?? --? 读取设备<device>上的数据项<address>失败。 原因：XML验证错误：节点既无效也无效，因为未找到DTD / Schema声明。

-Schema file failed to load; may cause validation errors.?? --? 架构文件无法加载; 可能会导致验证错误。

-Unable to bind to adapter: <network adapter name>. Connect failed.?? --? 无法绑定到适配器：<网络适配器名称>。 连接失败。

Automatic Tag Database Generation Messages? (自动标记数据库生成消息)

-Unable to generate a tag database for device <device>. Reason: Agent did not respond.?? --无法为设备<device>生成标记数据库。 原因：代理人没有回应。

-Unable to generate a tag database for device <device>. Reason: Agent returned MTConnect error:? --无法为设备<device>生成标记数据库。 原因：代理返回MTConnect错误：

<error-string>.? <错误字符串>

-Unable to generate a tag database for device <device>. Reason: Error in creating MTConnect packet.? --无法为设备<device>生成标记数据库。 原因：创建MTConnect数据包时出错。

-Unable to generate a tag database for device <device>. Reason: HTTP error: <error-code>.? --无法为设备<device>生成标记数据库。 原因：HTTP错误：<错误代码>。

-Unable to generate a tag database for device <device>. Reason: Internal error.? --? 无法为设备<device>生成标记数据库。 原因：内部错误。

-Unable to generate a tag database for device <device>. Reason: Invalid response from agent.? --无法为设备<device>生成标记数据库。 原因：代理的响应无效。

-Unable to generate a tag database for device <device>. Reason: Response from agent failed schema validation.? --无法为设备<device>生成标记数据库。 原因：代理响应模式验证失败。

-Unable to generate a tag database for device <device>. Reason: Unable to connect to the agent.? --无法为设备<device>生成标记数据库。 原因：无法连接到代理

-Unable to generate a tag database for device <device>. Reason: Unable to transmit request to the agent.?? --? 无法为设备<device>生成标记数据库。 原因：无法向代理发送请求。