지원 종료 공지: 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)을 참조하세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# IoT 이더넷 IP 프로토콜 어댑터 커넥터
<a name="ethernet-ip-connector"></a>

IoT 이더넷 IP 프로토콜 어댑터 [커넥터](connectors.md)는 EtherNet/IP 프로토콜을 사용하여 로컬 장치에서 데이터를 수집합니다. 이 커넥터를 사용하여 여러 장치에서 데이터를 수집하여 `StreamManager` 메시지 스트림에 게시할 수 있습니다.

또한 이 커넥터를 IoT SiteWise 커넥터 및 IoT SiteWise 게이트웨이와 함께 사용할 수 있습니다. 게이트웨이는 커넥터에 대한 구성을 제공해야 합니다. 자세한 내용은 IoT SiteWise 사용 설명서의 [이더넷/IP(EIP) 소스 구성](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-eip-source.html)을 참조하십시오.

**참고**  
이 커넥터는 [컨테이너 없음](lambda-group-config.md#no-container-mode) 격리 모드에서 실행되므로 Docker 컨테이너에서 실행되는 AWS IoT Greengrass 그룹에 배포할 수 있습니다.

이 커넥터의 버전은 다음과 같습니다.


| 버전 | ARN | 
| --- | --- | 
| 2(권장) | `arn:aws:greengrass:region::/connectors/IoTEIPProtocolAdaptor/versions/2` | 
| 1 | `arn:aws:greengrass:region::/connectors/IoTEIPProtocolAdaptor/versions/1` | 

버전 변경 사항에 대한 자세한 내용은 [Changelog](#ethernet-ip-connector-changelog)를 참조하십시오.

## 요구 사항
<a name="ethernet-ip-connector-req"></a>

이 커넥터에는 다음과 같은 요구 사항이 있습니다.

------
#### [ Version 1 and 2 ]
+ AWS IoT Greengrass 코어 소프트웨어 v1.10.2 이상.
+  AWS IoT Greengrass 그룹에서 스트림 관리자가 활성화되었습니다.
+ 코어 장치에 설치되고 `PATH` 환경 변수에 추가된 Java 8입니다.
+ 최소 256MB의 추가 램이 필요합니다. 이 요구 사항은 AWS IoT Greengrass 코어 메모리 요구 사항에 추가됩니다.

**참고**  
 이 커넥터는 다음 AWS 리전에서만 사용할 수 있습니다.  
cn-north-1
ap-southeast-1
ap-southeast-2
eu-central-1
eu-west-1
us-east-1
us-west-2

------

## 커넥터 파라미터
<a name="ethernet-ip-connector-param"></a>

이 커넥터는 다음 파라미터를 지원합니다.

`LocalStoragePath`  
IoT SiteWise 커넥터가 영구 데이터를 쓸 수 있는 AWS IoT Greengrass 호스트의 디렉터리입니다. 기본 디렉터리는 `/var/sitewise`입니다.  
 AWS IoT 콘솔의 표시 이름: **로컬 스토리지 경로**  
필수: `false`  
유형: `string`  
유효한 패턴: `^\s*$|\/.`

`ProtocolAdapterConfiguration`  
커넥터가 데이터를 수집하거나 연결하는 EtherNet/IP 컬렉터 구성 세트. 빈 목록일 수 있습니다.  
 AWS IoT 콘솔의 표시 이름: **프로토콜 어댑터 구성**  
필수: `true`  
유형: 지원되는 피드백 구성 세트를 정의하는 올바른 형식의 JSON 문자열입니다.

 다음은 `ProtocolAdapterConfiguration`의 예제입니다.

```
{
    "sources": [
        {
            "type": "EIPSource",
            "name": "TestSource",
            "endpoint": {
                "ipAddress": "52.89.2.42",
                "port": 44818
            },
            "destination": {
                "type": "StreamManager",
                "streamName": "MyOutput_Stream",
                "streamBufferSize": 10
            },
            "destinationPathPrefix": "EIPSource_Prefix",
            "propertyGroups": [
                {
                    "name": "DriveTemperatures",
                    "scanMode": {
                        "type": "POLL",
                        "rate": 10000
                    },
                    "tagPathDefinitions": [
                        {
                            "type": "EIPTagPath",
                            "path": "arrayREAL[0]",
                            "dstDataType": "double"
                        }
                    ]
                }
            ]
        }
    ]
}
```

### 커넥터 만들기 예(AWS CLI)
<a name="eip-connector-create"></a>

다음 CLI 명령은 IoT Ethernet IP Protocol Adapter 커넥터가 포함된 초기 버전을 사용하여 `ConnectorDefinition`을 생성합니다.

```
aws greengrass create-connector-definition --name MyGreengrassConnectors --initial-version 
'{
    "Connectors": [
        {
            "Id": "MyIoTEIPProtocolConnector",
            "ConnectorArn": "arn:aws:greengrass:region::/connectors/IoTEIPProtocolAdaptor/versions/2",
            "Parameters": {
                "ProtocolAdaptorConfiguration": "{ \"sources\": [{ \"type\": \"EIPSource\", \"name\": \"Source1\", \"endpoint\": { \"ipAddress\": \"54.245.77.218\", \"port\": 44818 }, \"destinationPathPrefix\": \"EIPConnector_Prefix\", \"propertyGroups\": [{ \"name\": \"Values\", \"scanMode\": { \"type\": \"POLL\", \"rate\": 2000 }, \"tagPathDefinitions\": [{ \"type\": \"EIPTagPath\", \"path\": \"arrayREAL[0]\", \"dstDataType\": \"double\" }]}]}]}",
                "LocalStoragePath": "/var/MyIoTEIPProtocolConnectorState"
            }
        }
    ]
}'
```

**참고**  
이 커넥터의 Lambda 함수에는 [수명이 긴](lambda-functions.md#lambda-lifecycle) 수명 주기가 있습니다.

## 입력 데이터
<a name="ethernet-ip-connector-data-input"></a>

이 커넥터는 MQTT 메시지를 출력 데이터로 게시하지 않습니다.

## 출력 데이터
<a name="ethernet-ip-connector-data-output"></a>

이 커넥터는 `StreamManager`에 데이터를 게시합니다. 대상 메시지 스트림을 구성해야 합니다. 출력 메시지는 다음 구조를 취합니다.

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

## 라이선스
<a name="ethernet-ip-connector-license"></a>

IoT Ethernet IP Protocol Adapter 커넥터에는 다음 타사 소프트웨어/라이선스가 포함되어 있습니다.
+ [이더넷/IP 클라이언트](https://github.com/digitalpetri/ethernet-ip/blob/master/LICENSE)
+ [MapDB](https://github.com/jankotek/mapdb/blob/master/LICENSE.txt)
+ [Elsa](https://github.com/jankotek/elsa/blob/master/LICENSE.txt)

이 커넥터는 [Greengrass 코어 소프트웨어 라이선스 계약](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf)에 따라 릴리스됩니다.

## Changelog
<a name="ethernet-ip-connector-changelog"></a>

다음 표에서는 의 각 릴리스에서 변경된 중요 사항에 대해 설명합니다.


| 버전 | 변경 | 날짜 | 
| --- | --- | --- | 
| 2 | 이 버전에는 버그 수정이 포함되어 있습니다. | 2021년 12월 23일 | 
| 1 | 최초 릴리스. | 2020년 12월 15일 | 

<a name="one-conn-version"></a>Greengrass 그룹은 한 번에 하나의 커넥터 버전만 포함할 수 있습니다. 커넥터 버전 업그레이드에 대한 자세한 내용은 [커넥터 버전 업그레이드](connectors.md#upgrade-connector-versions)을 참조하십시오.

## 다음 사항도 참조하세요.
<a name="ethernet-ip-connector-see-also"></a>
+ [Greengrass 커넥터를 사용하여 서비스 및 프로토콜과 통합](connectors.md)
+ [Greengrass 커넥터 시작하기(콘솔)](connectors-console.md)
+ [Greengrass 커넥터 시작하기(CLI)](connectors-cli.md)