IoT 이더넷 IP 프로토콜 어댑터 커넥터 - AWS IoT Greengrass
요구 사항파라미터입력 데이터출력 데이터라이선스Changelog다음 사항도 참조하세요.

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하는 것이 좋습니다. 이 마이그레이션하면 추가 플랫폼 에 대한 중요한 새 기능과 지원이 추가됩니다. https://docs.aws.amazon.com/greengrass/v2/developerguide/operating-system-feature-support-matrix.html

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

IoT 이더넷 IP 프로토콜 어댑터 커넥터

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

또한 이 커넥터를 IoT SiteWise 커넥터 및 IoT SiteWise 게이트웨이와 함께 사용할 수 있습니다. 게이트웨이는 커넥터에 대한 구성을 제공해야 합니다. 자세한 내용은 IoT SiteWise 사용 설명서의 이더넷/IP(EIP) 소스 구성을 참조하십시오.

참고

이 커넥터는 컨테이너 없음 격리 모드에서 실행되므로, Docker 컨테이너에서 실행되는 AWS IoT Greengrass 그룹에 이 커넥터를 배포할 수 있습니다.

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

버전

ARN

2(권장)

arn:aws:greengrass:region::/connectors/IoTEIPProtocolAdaptor/versions/2

1

arn:aws:greengrass:region::/connectors/IoTEIPProtocolAdaptor/versions/1

버전 변경 사항에 대한 자세한 내용은 Changelog를 참조하십시오.

요구 사항

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

Version 1 and 2

  • AWS IoT Greengrass 코어 소프트웨어 v1.9.3 이상.

  • 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

커넥터 파라미터

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

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)

다음 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 함수에는 수명이 긴 수명 주기가 있습니다.

입력 데이터

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

출력 데이터

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

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

라이선스

IoT Ethernet IP Protocol Adapter 커넥터에는 다음 타사 소프트웨어/라이선스가 포함되어 있습니다.

이 커넥터는 Greengrass 코어 소프트웨어 라이선스 계약에 따라 릴리스됩니다.

Changelog

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

버전

변경

날짜

2

이 버전에는 버그 수정이 포함되어 있습니다.

2021년 12월 23일

1

최초 릴리스.

2020년 12월 15일

Greengrass 그룹은 한 번에 하나의 커넥터 버전만 포함할 수 있습니다. 커넥터 버전 업그레이드에 대한 자세한 내용은 커넥터 버전 업그레이드 단원을 참조하십시오.

다음 사항도 참조하세요.