IoT 以太网 IP 协议适配器接口 - 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开发人员指南.

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

IoT 以太网 IP 协议适配器接口

IoT 以太网 IP 协议适配器连接器使用以太网 /IP 协议从本地设备收集数据。您可以使用此连接器从多个设备收集数据并将其发布到StreamManager消息流。

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

注意

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

此连接器具有以下版本。

Version

ARN

1

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

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

Requirements

此连接器具有以下要求:

Version 1
  • Amazon IoT GreengrassCore 软件 v1.10.2 或更高版本。

  • 启用的流管理器Amazon IoT Greengrass组中)。

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

  • 至少有 256 MB 的额外内存。这一要求是除Amazon IoT Greengrass核心内存要求。

注意

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

  • ap-southeast-1

  • ap-southeast-2

  • eu-central-1

  • eu-west-1

  • us-east-1

  • us-west-2

Connector of

此连接器支持以下参数:

LocalStoragePath

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

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

:必需false

类型:string

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

ProtocolAdapterConfiguration

连接器从中收集数据或连接到的以太网 /IP 收集器配置集。这可以是空列表。

显示名称Amazon IoT控制台:协议适配器配置

:必需true

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

以下是一个ProtocolAdapterConfiguration

{ "sources": [ { "type": "EIPSource", "name": "TestSource", "endpoint": { "ipAddress": "52.89.2.42", "port": 44818 }, "destination": { "type": "StreamManager", "streamName": "MyOutput_Stream", "streamBufferSize": 10 }, "destinationPathPrefix": "EIPSource_Prefix", "propertyGroups": [ { "name": "DriveTemperatures", "scanMode": { "type": "POLL", "rate": 10000 }, "tagPathDefinitions": [ { "type": "EIPTagPath", "path": "arrayREAL[0]", "dstDataType": "double" } ] } ] } ] }

创建连接器示例 (Amazon CLI)

以下 CLI 命令将创建的ConnectorDefinition初始版本包含 IoT 以太网 IP 协议适配器连接器。

aws greengrass create-connector-definition --name MyGreengrassConnectors --initial-version '{ "Connectors": [ { "Id": "MyIoTEIPProtocolConnector", "ConnectorArn": "arn:aws:greengrass:region::/connectors/IoTEIPProtocolAdaptor/versions/1", "Parameters": { "ProtocolAdaptorConfiguration": "{ \"sources\": [{ \"type\": \"EIPSource\", \"name\": \"Source1\", \"endpoint\": { \"ipAddress\": \"54.245.77.218\", \"port\": 44818 }, \"destinationPathPrefix\": \"EIPConnector_Prefix\", \"propertyGroups\": [{ \"name\": \"Values\", \"scanMode\": { \"type\": \"POLL\", \"rate\": 2000 }, \"tagPathDefinitions\": [{ \"type\": \"EIPTagPath\", \"path\": \"arrayREAL[0]\", \"dstDataType\": \"double\" }]}]}]}", "LocalStoragePath": "/var/MyIoTEIPProtocolConnectorState" } } ] }'
注意

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

输入数据

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

输出数据

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

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

Licenses

IoT 以太网 IP 协议适配器连接器包含以下第三方软件/许可:

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

Changelog

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

Version

更改

1

首次发布。

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

另请参阅