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

您正在查看Amazon IoT Greengrass Version 1.Amazon IoT Greengrass Version 2是最新的主要版本Amazon IoT Greengrass. 有关使用Amazon IoT Greengrass V2,请参阅Amazon IoT Greengrass Version 2开发人员指南.

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

混合总线-TCP 协议适配器连接器

混合总线-TCP 协议适配器连接器通过 ModBustCP 协议从本地设备收集数据,并将其发布到选定的StreamManager流。

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

注意

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

此连接器具有以下版本。

Version

ARN

1

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

2

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

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

Requirements

此连接器具有以下要求:

Version 1 - 2
  • Amazon IoT GreengrassCore 软件 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

Connector of

此连接器支持以下参数:

LocalStoragePath

上的目录Amazon IoT GreengrassIoT SiteWise 连接器可以向其写入持久性数据的主机。默认目录为 /var/sitewise

在Amazon IoT控制台:本地存储路径

:必需false

类型:string

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

MaximumBufferSize

IoT 站点磁盘使用的最大大小(以 GB 为单位)。默认大小为 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/2", "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" } ] }

Licenses

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

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

Changelog

下表介绍每一版的连接器中的更改。

Version

更改

日期

2

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

2021 年 5 月 24 日

1

首次发布。

2020 年 12 月 15 日

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

另请参阅