모드버스-TCP 프로토콜 어댑터 커넥터 - AWS IoT Greengrass

다음에 대한 설명서를 보고 있습니다.AWS IoT Greengrass Version 1.AWS IoT Greengrass Version 2의 최신 주요 버전입니다AWS IoT Greengrass. 사용에 관한 자세한 내용은 단원을 참조하십시오.AWS IoT Greengrass V2에 대한 자세한 내용은AWS IoT Greengrass Version 2개발자 안내서.

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

모드버스-TCP 프로토콜 어댑터 커넥터

모드버스-TCP 프로토콜 어댑터커넥터는 ModBustCP 프로토콜을 통해 로컬 디바이스에서 데이터를 수집하여 선택한StreamManager스트림을 사용합니다.

또한 IoT SiteWise 커넥터와 IoT SiteWise 게이트웨이와 함께이 커넥터를 사용할 수 있습니다. 게이트웨이는 커넥터에 대한 구성을 제공해야 합니다. 자세한 내용은 단원을 참조하십시오.모드버스 TCP 소스 구성의 IoT SiteWise 사용자 가이드에 나와 있습니다.

참고

이 커넥터는컨테이너 없음격리 모드에 배포 할 수 있으므로AWS IoT GreengrassDocker 컨테이너에서 실행

이 커넥터에는 다음과 같은 버전이 있습니다.

버전

ARN

1

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

2

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

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

Requirements

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

Version 1 - 2
  • AWS IoT Greengrass코어 소프트웨어 v1.10.2 이상입니다.

  • 에서 스트림 관리자가 활성화되어 있습니다.AWS IoT Greengrass그룹

  • 코어 디바이스에 설치되고PATH환경 변수.

참고

이 커넥터는 다음 리전에서만 사용할 수 있습니다.

  • ap-southeast-1

  • ap-southeast-2

  • eu-central-1

  • eu-west-1

  • us-east-1

  • us-west-2

  • cn-north-1

커넥터 매개변수

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

LocalStoragePath

에 있는 디렉터리AWS IoT GreengrassIoT SiteWise 커넥터가 영구 데이터를 기록할 수 있는 호스트입니다. 기본 디렉터리는/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

Type: 지원되는 피드백 구성 세트를 정의하는 올바른 형식의 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 명령은ConnectorDefinitionModbus-TCP 프로토콜 어댑터 커넥터가 포함된 초기 버전을 사용합니다.

aws greengrass create-connector-definition --name MyGreengrassConnectors --initial-version ' { "Connectors": [ { "Id": "MyModbusTCPConnector", "ConnectorArn": "arn:aws:greengrass:region::/connectors/ModbusTCP/versions/2", "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 함수에는수명이 긴 함수수명 주기

입력 데이터

이 커넥터는 MQTT 메시지를 입력 데이터로 허용하지 않습니다.

출력 데이터

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

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

Licenses

MDBUS-TCP 프로토콜 어댑터 커넥터에는 다음 타사 소프트웨어/라이선스가 포함되어 있습니다.

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

Changelog

다음 표에서는 커넥터의 각 커넥터의 버전 변경사항에 대해 설명합니다.

버전

변경

날짜

2

ASCII, UTF8 및 ISO8859 인코딩된 소스 문자열에 대한 지원이 추가되었습니다.

2021년 5월 24일

1

최초 릴리스.

2020년 12월 15일

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

다음 사항도 참조하세요.