支援終止通知：2026 年 10 月 7 日 AWS 將停止 的支援 AWS IoT Greengrass Version 1。2026 年 10 月 7 日之後，您將無法再存取 AWS IoT Greengrass V1 資源。如需詳細資訊，請造訪[從 遷移 AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html)。

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

# Modbus-TCP 通訊協定轉接器連接器
<a name="modbus-tcp-connector"></a>

Modbus-TCP 通訊協定轉接器[連接器](connectors.md)會透過 ModbusTCP 通訊協定從本機裝置收集資料，並將其發佈至選取的`StreamManager`串流。

您也可以將此連接器與 IoT SiteWise 連接器和 IoT SiteWise 閘道搭配使用。您的閘道必須提供連接器的組態。如需詳細資訊，請參閱 IoT SiteWise 使用者指南中的[設定 Modbus TCP 來源](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-modbus-source.html)。

**注意**  
 此連接器以[無容器](lambda-group-config.md#no-container-mode)隔離模式執行，因此您可以將其部署到在 Docker 容器中執行的 AWS IoT Greengrass 群組。

此連接器具有下列版本。


| 版本 | ARN | 
| --- | --- | 
| 3 | `arn:aws:greengrass:region::/connectors/ModbusTCPConnector/versions/3` | 
| 2 | `arn:aws:greengrass:region::/connectors/ModbusTCPConnector/versions/2` | 
| 1 | `arn:aws:greengrass:region::/connectors/ModbusTCPConnector/versions/1` | 

如需版本變更的詳細資訊，請參閱 [Changelog](#modbus-tcp-connector-changelog)。

## 要求
<a name="modbus-tcp-connector-req"></a>

此連接器有下列要求：

------
#### [ Version 1 - 3 ]
+ AWS IoT Greengrass 核心軟體 1.10.2 版或更新版本。
+  AWS IoT Greengrass 群組上已啟用串流管理員。
+ 安裝在核心裝置上並新增至`PATH`環境變數的 Java 8。

**注意**  
 此連接器僅適用於下列區域：  
ap-southeast-1
ap-southeast-2
eu-central-1
eu-west-1
us-east-1
us-west-2
cn-north-1

------

## 連接器參數
<a name="modbus-tcp-connector-param"></a>

此連接器支援下列參數：

`LocalStoragePath`  
IoT SiteWise 連接器可寫入持久性資料的 AWS IoT Greengrass 主機目錄。預設目錄為 `/var/sitewise`。  
 AWS IoT 主控台中的顯示名稱：**本機儲存路徑**  
必要： `false`  
類型：`string`  
有效模式： `^\s*$|\/.`

`MaximumBufferSize`  
IoT SiteWise 磁碟用量的大小上限，以 GB 為單位。預設大小為 10GB。  
 AWS IoT 主控台中的顯示名稱：**磁碟緩衝區大小上限**  
必要： `false`  
類型：`string`  
有效模式： `^\s*$|[0-9]+`

`CapabilityConfiguration`  
連接器從 收集資料並連線的一組 Modbus TCP 收集器組態。  
 AWS IoT 主控台中的顯示名稱：**CapabilityConfiguration**  
必要： `false`  
類型：格式正確的 JSON 字串，定義一組支援的意見回饋組態。

以下是 的範例`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)
<a name="modbus-connector-create"></a>

下列 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}]}\"}"
            }
        }
    ]
}'
```

**注意**  
此連接器中的 Lambda 函數具有[長期生命週期](lambda-functions.md#lambda-lifecycle)。

## 輸入資料
<a name="modbus-tcp-connector-data-input"></a>

此連接器不接受 MQTT 訊息做為輸入資料。

## 輸出資料
<a name="modbus-tcp-connector-data-output"></a>

此連接器會將資料發佈至 `StreamManager`。您必須設定目的地訊息串流。輸出訊息的結構如下：

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

## 授權
<a name="modbus-tcp-connector-license"></a>

Modbus-TCP 通訊協定轉接器連接器包含下列第三方軟體/授權：
+ [數位 Petri](https://github.com/digitalpetri/modbus) Modbus

此連接器根據 [Greengrass 核心軟體授權合約](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf)發行。

## 變更記錄
<a name="modbus-tcp-connector-changelog"></a>

下表說明連接器每個版本中的變更。


| 版本 | 改變 | 日期 | 
| --- | --- | --- | 
| 3 （建議） | 此版本包含錯誤修正。 | 2021 年 12 月 22 日 | 
| 2 | 新增對 ASCII、UTF8 和 ISO8859 編碼來源字串的支援。 | 2021 年 5 月 24 日 | 
| 1 | 初始版本。 | 2020 年 12 月 15 日 | 

<a name="one-conn-version"></a>Greengrass 群組一次只能包含一個版本的連接器。若要取得有關升級連接器版本的資訊，請參閱[升級連接器版本](connectors.md#upgrade-connector-versions)。

## 另請參閱
<a name="modbus-tcp-connector-see-also"></a>
+ [使用 Greengrass 連接器來整合服務和通訊協定](connectors.md)
+ [Greengrass 連接器入門 (主控台)](connectors-console.md)
+ [Greengrass 連接器入門 (CLI)](connectors-cli.md)