지원 종료 공지: 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 코어 소프트웨어 v1.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
------
## 커넥터 파라미터
이 커넥터는 다음 파라미터를 지원합니다.
`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)
다음 CLI 명령은 Modbus-TCP Protocol Adapter 커넥터가 포함된 초기 버전을 사용하여 `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 Protocol Adapter 커넥터에는 다음 타사 소프트웨어/라이선스가 포함되어 있습니다.
+ [Digital Petri](https://github.com/digitalpetri/modbus) Modbus
이 커넥터는 [Greengrass 코어 소프트웨어 라이선스 계약](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf)에 따라 릴리스됩니다.
## Changelog
다음 표에서는 의 각 릴리스에서 변경된 중요 사항에 대해 설명합니다.
| 버전 | 변경 | 날짜 |
| --- | --- | --- |
| 3(권장) | 이 버전에는 버그 수정이 포함되어 있습니다. | 2022년 12월 22일 |
| 2 | ASCII, UTF8 및 ISO8859 인코딩 소스 문자열에 대한 지원이 추가되었습니다. | 2021년 5월 24일 |
| 1 | 최초 릴리스. | 2020년 12월 15일 |
Greengrass 그룹은 한 번에 하나의 커넥터 버전만 포함할 수 있습니다. 커넥터 버전 업그레이드에 대한 자세한 내용은 [커넥터 버전 업그레이드](connectors.md#upgrade-connector-versions)을 참조하십시오.
## 다음 사항도 참조하세요.
+ [Greengrass 커넥터를 사용하여 서비스 및 프로토콜과 통합](connectors.md)
+ [Greengrass 커넥터 시작하기(콘솔)](connectors-console.md)
+ [Greengrass 커넥터 시작하기(CLI)](connectors-cli.md)