Amazon IoT Greengrass Version 12023 年 6 月 30 日进入延长寿命阶段。有关更多信息,请参阅Amazon IoT Greengrass V1维护政策。在此日期之后,Amazon IoT Greengrass V1不会发布提供功能、增强功能、错误修复或安全补丁的更新。在上运行的设备Amazon IoT Greengrass V1不会受到干扰,将继续运行并连接到云端。我们强烈建议你迁移到Amazon IoT Greengrass Version 2,它补充说重要的新功能和支持其他平台。
本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
IoT 以太网 IP 协议适配器连接器
IoT 以太网 IP 协议适配器连接器使用 EtherNet/IP 协议从本地设备收集数据。您可以使用此连接器从多个设备收集数据并将其发布到StreamManager
消息流。
您也可以将此连接器与 IoT 结合使用。 SiteWise 连接器和 IoT SiteWise 网关。您的网关必须提供连接器的配置。有关更多信息,请参阅 。配置以太网 /IP (EIP) 源在 IoT 中 SiteWise 用户指南。
注意
此连接器运行于无容器隔离模式,因此您可以将其部署到Amazon IoT Greengrass在 Docker 容器中运行的组。
此连接器具有以下版本。
版本 |
ARN |
---|---|
2 (建议) |
|
1 |
|
有关版本更改的信息,请参阅更改日志。
要求
此连接器具有以下要求:
连接器参数
此连接器支持以下参数:
LocalStoragePath
-
上的目录Amazon IoT Greengrass托管 IoT SiteWise 连接器可以将持久性数据写入。默认目录为
/var/sitewise
。在中显示名称Amazon IoT控制台:本地存储路径
必需:
false
类型:
string
有效模式:
^\s*$|\/.
ProtocolAdapterConfiguration
-
连接器从中收集或连接到的数据的 Ethernet/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/2", "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" } ] }
许可证
IoT 以太网 IP 协议适配器连接器包含以下第三方软件/许可:
此连接器在Greengrass 核心软件许可协议
更改日志
下表介绍了在连接器各个版本中进行的更改。
版本 |
更改 |
日期 |
---|---|---|
2 |
此版本包含错误修复。 |
2021 年 12 月 23 日 |
1 |
首次发布。 |
2020 年 12 月 15 日 |
Greengrass 组一次只能包含一个连接器版本。有关升级连接器版本的信息,请参阅升级连接器版本。