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，這會增加重要的新功能，並支援其他平台。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

模塊-TCP 協議適配器連接器

模擬總線-TCP 協議適配器連接器從本地設備中收集數據，並將其發佈到選定StreamManager串流。

您還可以將此連接器與 IoT 結合使用 SiteWise 連接器和 IoT SiteWise 網關。您的網關必須提供連接器的配置。如需詳細資訊，請參閱「」配置模態總線 TCP 源在 IoT 中 SiteWise 使用者指南。

此連接器具有下列版本。

如需版本變更的詳細資訊，請參閱 Changelog。

要求

此連接器有下列要求：

Version 1 - 3

• AWS IoT Greengrass核心軟體 v1.10.2 或更新版本。

• 串流管理員已在AWS 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
                    }
                }
            ]
        }
    ]
}
            

建立範例連接器 (AWS CLI)

以下 CLI 命令會建立ConnectorDefinition包含 MODBU-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 Core 軟體授權合約。

Changelog

下表描述連接器每個版本的變更。

Greengrass 組一次只能包含連接器的一個版本。若要取得有關升級連接器版本的資訊，請參閱升級連接器版本。

另請參閱