サポート終了通知: 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 プロトコルアダプターコネクタ
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)」を参照してください。
## 要件
このコネクタには以下の要件があります。
------
#### [ Version 1 - 3 ]
+ AWS IoT Greengrass Core ソフトウェア v1.10.2 以降。
+ AWS IoT Greengrass グループで有効になっているストリームマネージャー。
+ Java 8 が Core デバイスにインストールされ、`PATH` 環境変数に追加されている。
**注記**
このコネクタは、次のリージョンでのみ利用できます。
ap-southeast-1
ap-southeast-2
eu-central-1
eu-west-1
us-east-1
us-west-2
cn-north-1
------
## コネクタパラメータ
このコネクタでは、以下のパラメータがサポートされています。
`LocalStoragePath`
IoT SiteWise コネクタが永続データを書き込むことができる AWS IoT Greengrass ホスト上のディレクトリ。デフォルトのディレクトリは `/var/sitewise` です。
AWS IoT コンソールでの名前の表示: **ローカルストレージパス**
必須: `false`
型: `string`
有効なパターン: `^\s*$|\/.`
`MaximumBufferSize`
IoT SiteWise ディスク使用量の最大サイズ (GB)。デフォルトサイズは 10 GB です。
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)
以下の CLI コマンドは、Modbus-TCP プロトコルアダプタコネクタを含む初期バージョンで `ConnectorDefinition` を作成します。
```
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)ライフサイクルがあります。
## 入力データ
このコネクタは MQTT メッセージを入力データとして受け入れません。
## 出力データ
このコネクタは、`StreamManager` にデータを発行します。宛先メッセージストリームを設定する必要があります。出力メッセージは以下の構造になります。
```
{
"alias": "string",
"messages": [
{
"name": "string",
"value": boolean|double|integer|string,
"timestamp": number,
"quality": "string"
}
]
}
```
## ライセンス
Modbus-TCP プロトコルアダプタコネクタには、以下のサードパーティーのソフトウェアおよびライセンスが含まれています。
+ [デジタルペトリ](https://github.com/digitalpetri/modbus) Modbus
このコネクタは、[Greengrass Core ソフトウェアライセンス契約](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf)に従ってリリースされます。
## 変更ログ
次の表に、コネクタの各バージョンにおける変更点を示します。
| バージョン | 変更 | 日付 |
| --- | --- | --- |
| 3 (推奨) | このバージョンには、バグ修正が含まれています。 | 2021 年 12 月 22 日 |
| 2 | ASCII、UTF8、および ISO8859 エンコードされたソース文字列のサポートが追加されました。 | 2021 年 5 月 24 日 |
| 1 | 初回リリース。 | 2020 年 12 月 15 日 |
Greengrass グループには、一度に 1 つのバージョンのコネクタしか含めることができません。コネクタのバージョンのアップグレードについては、「[コネクタのバージョンのアップグレード](connectors.md#upgrade-connector-versions)」を参照してください。
## 関連情報
+ [Greengrass コネクタを使用したサービスおよびプロトコルとの統合](connectors.md)
+ [Greengrass コネクタの開始方法 (コンソール)](connectors-console.md)
+ [Greengrass コネクタの開始方法 (CLI)](connectors-cli.md)