Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

Amazon IoT Greengrass Version 12023 年 6 月 30 日进入延长寿命阶段。有关更多信息，请参阅Amazon IoT Greengrass V1维护政策。在此日期之后，Amazon IoT Greengrass V1不会发布提供功能、增强功能、错误修复或安全补丁的更新。在上运行的设备Amazon IoT Greengrass V1不会受到干扰，将继续运行并连接到云端。我们强烈建议你迁移到Amazon IoT Greengrass Version 2，它补充说重要的新功能和支持其他平台。

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

Modbus-TCP 协议适配器连接器

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

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

此连接器具有以下版本。

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

要求

此连接器具有以下要求：

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

连接器参数

此连接器支持以下参数：

以下是一个示例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}]}\"}"
            }
        }
    ]
}'

输入数据

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

输出数据

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

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

许可证

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

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

更改日志

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

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

另请参阅