IoT 以太网 IP 协议适配器连接器 - AWS IoT Greengrass
要求参数输入数据输出数据许可证更改日志另请参阅

AWS IoT Greengrass Version 1 2023 年 6 月 30 日进入延长寿命阶段。有关更多信息，请参阅 AWS IoT Greengrass V1 维护策略。在此日期之后，将 AWS IoT Greengrass V1 不会发布提供功能、增强功能、错误修复或安全补丁的更新。在上面运行的设备 AWS IoT Greengrass V1 不会中断，将继续运行并连接到云端。我们强烈建议您迁移到 AWS IoT Greengrass Version 2，这样可以添加重要的新功能并支持其他平台。

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

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

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

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

注意

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

此连接器具有以下版本。

版本

ARN

2（推荐）

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

1

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

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

要求

此连接器具有以下要求：

Version 1 and 2

  • AWS IoT Greengrass Core 软件 v1.10.2 版或更高版本。

  • AWS IoT Greengrass 组上启用的流管理器 。

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

  • 至少 256 MB 的额外内存。这项要求是对 AWS IoT Greengrass Core 内存要求的补充。

注意

该连接器仅在以下区域推出：

  • cn-north-1

  • ap-southeast-1

  • ap-southeast-2

  • eu-central-1

  • eu-west-1

  • us-east-1

  • us-west-2

连接器参数

此连接器支持以下参数：

LocalStoragePath

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

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

必需：false

类型：string

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

ProtocolAdapterConfiguration

一组 EtherNet/IP 收集器的配置，连接器从这些收集器中收集数据或连接到这些收集器。这可以是空列表。

AWS 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"
                        }
                    ]
                }
            ]
        }
    ]
}

创建连接器示例 (AWS CLI)

以下 CLI 命令创建一个 ConnectorDefinition，其初始版本包含 IoT Ethernet 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 Ethernet IP 协议适配器连接器包含以下第三方软件/许可：

该连接器在 Greengrass Core 软件许可协议下发布。

更改日志

下表介绍每个版本连接器的更改。

版本

更改

日期

2

此版本包含错误修复。

2021 年 12 月 23 日

1

首次发布。

2020 年 12 月 15 日

Greengrass 组在一个时间上只能包含一个版本的连接器。有关升级连接器版本的信息，请参阅升级连接器版本。

另请参阅