Tulip에서 메시지를 전송하려면(예: 앱 내 트리거 또는 자동화 기능에서), 커넥터를 사용할 수 있습니다. 이는 모든 Tulip 엣지 디바이스에 커넥터 호스트를 설치하는 것이 가장 간편한 방법입니다.
튤립 엣지 디바이스를 사용하여
다음 흐름은 튤립 트리거에서 튤립 엣지 디바이스에서 실행 중인 Node-RED로 메시지를 전송하는 데 사용됩니다:
설정이 완료되면, 새로 생성된 커넥터를 Tulip 앱이나 자동화에서 사용하여 장치 명령어나 플로우 입력과 같은 메시지를 Node-RED로 전송할 수 있습니다.
Tulip에서: 커넥터 및 커넥터 호스트 구성
참고: Tulip의 커넥터 호스트 및 커넥터 기능에 익숙하지 않다면 이 문서를 확인해 주세요.
- Tulip 인스턴스의 ‘커넥터( Connectors )’ 페이지에서 새 커넥터를 생성합니다.
- 표시되는 모달에서 아래와 같이 정보를 입력하세요:
이름:커넥터 이름을 지정하세요.설명: 커넥터호스트에 대한 설명을 입력하세요.커넥터 유형: HTTP를 선택하세요.
- "저장"을 클릭합니다.
- 커넥터 호스트의 세부 정보를 지정하려면 왼쪽에 있는 '프로덕션, 테스트 및 개발' 버튼을 클릭하세요. 나타나는 모달에서 다음 정보를 입력하세요:
실행 위치: 대상 엣지 디바이스의 커넥터 호스트를 선택합니다. *참고: 엣지 디바이스의 커넥터 호스트를 찾을 수 없는 경우, 엣지 디바이스 포털로 이동하여 "커넥터 호스트"가 활성화되어 있는지 확인하십시오.*호스트: localhost를 입력합니다.포트: 1880을 입력합니다(이 포트는 Node-RED가 실행되는 포트입니다).TLS: '아니요'를 선택합니다.헤더나 인증서를 추가할 필요는 없습니다.
- '테스트'를 클릭하여 연결이 정상적으로 이루어지는지 확인합니다. 마지막으로 '저장'을 클릭합니다.
이제 이 커넥터는 대상 에지 디바이스의 Node-RED와 통신할 수 있습니다.
Node-RED에서: HTTP IN 노드 구성
This section assumes familiarity with Node-RED. Learn more here.
장치 내 커넥터 호스트로부터 메시지를 수신하기 위해 HTTP IN 노드가 사용됩니다.
- Node-RED 편집기 왼쪽의 팔레트에서 HTTP IN 노드를 클릭하여 드래그한 후 플로우에 추가합니다:
다음 정보를 입력합니다: 메서드: POST URL: /nodeRED 또는 /myMachine/0013과 같이 사용자가 정의한 경로라면 무엇이든 가능합니다. 이 URL은 Node-RED에서 재사용되므로, 쉽게 알아볼 수 있고 기억하기 쉬운 것이 좋습니다.아래 예시에서는 URL을 /test로 구성한 경우를 보여줍니다: 
- "완료"를 클릭하여 변경 사항을 저장합니다.
서버(이 경우 Tulip)로 응답이 반환되지 않으면 HTTP 요청이 실패합니다. 1. HTTP 응답 노드를 드래그하여 추가합니다. 2. HTTP 요청 노드를 HTTP 응답 노드에 연결합니다. 3. HTTP 응답 노드를 두 번 클릭하고 상태 코드에 200을 입력합니다. 완료를 클릭합니다.
Modify the Status Code and/or use the +add button in the HTTP Response node to modify or add to the Connector's response. These data (most often, system or device outputs generated by the Flow) will appear in the Connector's Response. Configure Connector Outputs with the guide here.
- 마지막으로 팔레트에서 디버그 노드를 끌어옵니다. 이 노드를 구성하여 " msg. " 드롭다운을 사용하여 "Complete Message Object "를 출력하도록 설정합니다:
이제 이 Node-RED 플로우는 Tulip에서 메시지를 수신하여 Node-RED 디버그 로그에 표시합니다.
완성된 플로우는 아래와 같이 표시될 수 있습니다:
오른쪽 상단의 ‘배포 ( Deploy )’를 클릭하여 모든 변경 사항을 적용합니다.
Tulip에서: 커넥터 기능 구성 및 테스트
Node-RED 플로우 구성이 완료되면 Tulip의 커넥터로 돌아갑니다. 1. 새 커넥터 함수를 생성합니다. 2. 커넥터 함수의 요청 방식을 GET에서 POST로 변경합니다. 3. URL에 Node-RED에서 구성한 경로(이 예시에서는 /test)를 입력합니다. 4. (선택 사항) 커넥터에 콘텐츠(예: 메시지 또는 명령)를 추가하려면 커넥터에 입력(Input)을 추가합니다. 5. (선택 사항) 먼저 콘텐츠 유형 (Content Type)을 JSON으로 변경한 다음, 루트(root)에 항목을 추가하여 해당 입력을 요청 본문(Request Body)에 포함시킵니다.
아래 스크린샷은 위에서 지정한 /test 엔드포인트로 구성된 커넥터를 보여주며, testValue라는 입력을 포함하고 있습니다:
"실행(Run)"을 클릭하여 커넥터 함수를 테스트합니다. 성공 시 다음 두 가지 징후가 나타납니다: 1. 커넥터 함수는 200 OK 응답을 수신하며, 이 응답에는 (해당되는 경우) 다음이 포함됩니다: 1. 커넥터에 구성된 모든 입력 2. Node-RED의 HTTP 응답 노드에서 구성된 추가 출력값2. Node-RED의 디버그 로그에 커넥터 메시지가 표시됩니다. 참고: Node-RED의 현재 버전에 따라 커넥터 요청 본문은 다음 중 한 곳에서 확인할 수 있습니다: a. msg.payload, 또는 b. msg.req.body
두 가지 성공 상태는 다음과 같습니다:
커넥터 성공:
Node-RED 성공: