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(으)로 마이그레이션하는 것이 좋습니다.

Serial Stream 커넥터

Serial Stream 커넥터는 AWS IoT Greengrass 코어 장치의 직렬 포트에서 읽고 씁니다.

이 커넥터는 다음 두 가지 작업 모드를 지원합니다.

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

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

요구 사항

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

Version 3

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

• 코어 장치에 설치되고 PATH 환경 변수에 추가된 Python 버전 3.7 또는 3.8입니다.

  참고

  Python 3.8을 사용하려면 다음 명령을 실행하여 기본 Python 3.7 설치 폴더에서 설치된 Python 3.8 바이너리로 연결되는 심볼릭 링크를 만드십시오.

  sudo ln -s path-to-python-3.8/python3.8 /usr/bin/python3.7

  이렇게 하면 AWS IoT Greengrass에 대한 Python 요구 사항을 충족하도록 장치가 구성됩니다.

• 대상 직렬 포트를 가리키는 Greengrass 그룹의 로컬 장치 리소스입니다.

  참고

  이 커넥터를 배포하기 전에 직렬 포트를 설정하고 해당 포트에서 읽고 쓸 수 있는지 확인하는 것이 좋습니다.

Versions 1 - 2

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

• 코어 장치에 설치되고 PATH 환경 변수에 추가된 Python 버전 3.7입니다.

• 대상 직렬 포트를 가리키는 Greengrass 그룹의 로컬 장치 리소스입니다.

  참고

  이 커넥터를 배포하기 전에 직렬 포트를 설정하고 해당 포트에서 읽고 쓸 수 있는지 확인하는 것이 좋습니다.

커넥터 파라미터

이 커넥터는 다음 파라미터를 제공합니다.

커넥터 만들기 예(AWS CLI)

다음 CLI 명령은 Serial Stream 커넥터가 포함된 초기 버전을 사용하여 ConnectorDefinition을 생성합니다. 폴링 읽기 모드에 대해 커넥터를 구성합니다.

aws greengrass create-connector-definition --name MyGreengrassConnectors --initial-version '{
    "Connectors": [
        {
            "Id": "MySerialStreamConnector",
            "ConnectorArn": "arn:aws:greengrass:region::/connectors/SerialStream/versions/3",
            "Parameters": {
                "BaudRate" : "9600",
                "Timeout" : "25",
                "SerialPort" : "/dev/serial1",
                "SerialPort-ResourceId" : "my-serial-port-resource",
                "PollingRead" : "true",
                "PollingReadLength" : "30",
                "PollingReadInterval" : "30",
                "PollingReadType" : "hex"
            }
        }
    ]
}'

AWS IoT Greengrass 콘솔에서는 그룹의 커넥터 페이지에서 커넥터를 추가할 수 있습니다. 자세한 내용은 Greengrass 커넥터 시작하기(콘솔) 단원을 참조하십시오.

입력 데이터

이 커넥터는 두 개의 MQTT 주제에서 직렬 포트에 대한 읽기 또는 쓰기 요청을 수락합니다. 입력 메시지는 JSON 형식이어야 합니다.

이러한 주제에 게시하려면 + 와일드카드를 코어 사물 이름으로 바꾸고 # 와일드카드를 직렬 포트의 경로로 바꿉니다. 예:

serial/core-thing-name/read/dev/serial-port

출력 데이터

이 커넥터는 다음 두 가지 주제에 대한 출력 데이터를 게시합니다.

이 주제에 게시하는 경우 커넥터는 + 와일드 카드를 코어 사물 이름으로 바꾸고 # 와일드카드를 직렬 포트 경로로 바꿉니다. 예:

serial/core-thing-name/status/dev/serial-port

사용 예

다음 상위 수준 단계를 사용하여 커넥터를 사용해 보는 데 이용할 수 있는 예제 Python 3.7 Lambda 함수를 설정합니다.

예

다음 예제 Lambda 함수는 커넥터에 입력 메시지를 보냅니다.

import greengrasssdk
import json

TOPIC_REQUEST = 'serial/CORE_THING_NAME/write/dev/serial1'

# Creating a greengrass core sdk client
iot_client = greengrasssdk.client('iot-data')

def create_serial_stream_request():
	request = {
		"data": "TEST",
		"type": "ascii",
		"id": "abc123"
	}
	return request

def publish_basic_request():
	iot_client.publish(payload=json.dumps(create_serial_stream_request()), topic=TOPIC_REQUEST)

publish_basic_request()

def lambda_handler(event, context):
	return

라이선스

Serial Stream 커넥터에는 다음 타사 소프트웨어/라이선스가 포함되어 있습니다.

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

Changelog

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

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

다음 사항도 참조하세요.