Modbus-TCP 协议适配器连接器 - Amazon IoT Greengrass
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

Amazon IoT Greengrass Version 1在 2023 年 6 月 30 日之前,不再接收功能更新,只会收到安全补丁和错误修复。有关更多信息,请参阅 。Amazon IoT Greengrass V1维护政策. 强烈建议您迁移到Amazon IoT Greengrass Version 2,它补充说重要新功能对其他平台的支持.

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

Modbus-TCP 协议适配器连接器

Modbus-TCP 协议适配器连接器通过 modBustCP 协议从本地设备收集数据并将其发布到选定的StreamManager流式传输。

您也可以将此连接器与 IoT 结合使用 SiteWise 连接器和你的 IoT SiteWise 网关。您的网关必须提供连接器的配置。有关更多信息,请参阅 。配置 Modbus TCP 源在 IoT 中 SiteWise 用户指南。

注意

此连接器运行于无容器隔离模式,因此您可以将其部署到Amazon IoT Greengrass在 Docker 容器中运行的组。

此连接器具有以下版本。

版本

ARN

3

arn:aws:greengrass:region::/connectors/ModbusTCPConnector/versions/3

2

arn:aws:greengrass:region::/connectors/ModbusTCPConnector/versions/2

1

arn:aws:greengrass:region::/connectors/ModbusTCPConnector/versions/1

有关版本更改的信息,请参阅更改日志

要求

此连接器具有以下要求:

Version 1 - 3
  • Amazon IoT Greengrass核心软件 v1.10.2 或更高版本。

  • 在Amazon IoT Greengrass组中)。

  • 核心设备上安装的 Java 8 并添加到PATH环境变量。

注意

此连接器仅在以下区域可用:

  • ap-southeast-1

  • ap-southeast-2

  • eu-central-1

  • eu-west-1

  • us-east-1

  • us-west-2

  • cn-north-1

连接器参数

此连接器支持以下参数:

LocalStoragePath

上的目录Amazon IoT Greengrass托管 IoT SiteWise 连接器可以向写入持久性数据。默认目录为 /var/sitewise

中的显示名称Amazon IoT控制台:本地存储路径

必需false

类型:string

有效模式:^\s*$|\/.

MaximumBufferSize

IoT 的最大大小(以 GB 为单位) SiteWise 磁盘使用量。默认大小为 10 GB。

中的显示名称Amazon IoT控制台:最大磁盘缓冲区大小

必需false

类型:string

有效模式:^\s*$|[0-9]+

CapabilityConfiguration

连接器从中收集数据并连接到的 Modbus TCP 收集器配置集。

中的显示名称Amazon IoT控制台:CapabilityConfiguration

必需false

类型: 一个格式正确的 JSON 字符串,用于定义支持的反馈配置集。

以下是一个示例CapabilityConfiguration

{ "sources": [ { "type": "ModBusTCPSource", "name": "SourceName1", "measurementDataStreamPrefix": "SourceName1_Prefix", "destination": { "type": "StreamManager", "streamName": "SiteWise_Stream_1", "streamBufferSize": 8 }, "endpoint": { "ipAddress": "127.0.0.1", "port": 8081, "unitId": 1 }, "propertyGroups": [ { "name": "GroupName", "tagPathDefinitions": [ { "type": "ModBusTCPAddress", "tag": "TT-001", "address": "30001", "size": 2, "srcDataType": "float", "transformation": "byteWordSwap", "dstDataType": "double" } ], "scanMode": { "type": "POLL", "rate": 100 } } ] } ] }

创建连接器示例 (Amazon CLI)

以下 CLI 命令将创建ConnectorDefinition初始版本包含 Modbus-TCP 协议适配器连接器。

aws greengrass create-connector-definition --name MyGreengrassConnectors --initial-version ' { "Connectors": [ { "Id": "MyModbusTCPConnector", "ConnectorArn": "arn:aws:greengrass:region::/connectors/ModbusTCP/versions/3", "Parameters": { "capability_configuration": "{\"version\":1,\"namespace\":\"iotsitewise:modbuscollector:1\",\"configuration\":\"{\"sources\":[{\"type\":\"ModBusTCPSource\",\"name\":\"SourceName1\",\"measurementDataStreamPrefix\":\"\",\"endpoint\":{\"ipAddress\":\"127.0.0.1\",\"port\":8081,\"unitId\":1},\"propertyGroups\":[{\"name\":\"PropertyGroupName\",\"tagPathDefinitions\":[{\"type\":\"ModBusTCPAddress\",\"tag\":\"TT-001\",\"address\":\"30001\",\"size\":2,\"srcDataType\":\"hexdump\",\"transformation\":\"noSwap\",\"dstDataType\":\"string\"}],\"scanMode\":{\"rate\":200,\"type\":\"POLL\"}}],\"destination\":{\"type\":\"StreamManager\",\"streamName\":\"SiteWise_Stream\",\"streamBufferSize\":10},\"minimumInterRequestDuration\":200}]}\"}" } } ] }'
注意

此连接器中的 Lambda 函数有长时间生存生命周期。

输入数据

此连接器不接受 MQTT 消息作为输入数据。

输出数据

此连接器将数据发布到StreamManager. 您必须配置目标消息流。输出消息具有以下结构:

{ "alias": "string", "messages": [ { "name": "string", "value": boolean|double|integer|string, "timestamp": number, "quality": "string" } ] }

许可证

Modbus-TCP 协议适配器连接器包含以下第三方软件/许可:

此连接器在Greengrass 核心软件许可协议.

更改日志

下表介绍了连接器各个版本中的更改。

版本

更改

日期

3(推荐)

此版本包含错误修复。

2021 年 12 月 22 日

2

添加了对 ASCII、UTF8 和 ISO8859 编码源字符串的支持。

2021 年 5 月 24 日

1

首次发布。

2020 年 12 月 15 日

Greengrass 组一次只能包含一个连接器版本。有关升级连接器版本的信息,请参阅升级连接器版本

另请参阅