Tulip을 ParticleIO 기기와 손쉽게 연결하세요
Particle 커뮤니티 통합 가이드(동일한 가이드)를 여기에서 확인하세요:Particle <> Tulip 커뮤니티 통합
설정
Tulip 머신 엔드포인트 설정
튤립에서 머신을 생성하려면 다음이 필요합니다: * API 자격 증명 * 머신 유형 * 머신
API 자격 증명:::(Info) (Feature rename)
Prior to r383, Service Accounts were called "API Tokens".
:::
설정 --> Tulip API로 이동하여 머신 및 속성에 대한 읽기/쓰기 권한이 있는 서비스 계정을 생성하세요.
머신 유형작업현장(Shop Floor) → 머신(Machines) → 머신 유형(Machine Types)으로 이동하여 새로운 머신 유형을 생성합니다. ParticleIO에서 게시된 이벤트를 반영하도록 머신 속성을 생성합니다. 참고: 데이터 유형은 반드시 문자열(string)이어야 합니다. 
기계: 새로 생성한 기계 유형 아래에 새 기계를생성합니다. 구성(Configuration)에서 기계 속성을 Tulip Machine API에 매핑하고, MachineId 및 AttributeId를 기록해 둡니다.
통합 활성화
Particle 콘솔: 필요한 모든 사전 구성을 완료했으므로, 이제 Particle 콘솔에서 Tulip 통합을 활성화할 준비가 되었습니다.
먼저 사이드바의 통합 아이콘()을 클릭하거나 이 링크를 따라 통합 허브로 이동하세요. 특정 제품에 대해 통합을 활성화하려면 해당 제품의 통합 허브로 이동해야 합니다. 사이드바의 제품 아이콘()을 클릭하고, 해당 제품을 찾은 다음, 제품 정보 화면에서 통합 아이콘()을 클릭하여 이동할 수 있습니다.
통합 허브에 접속하면 “새 통합” 버튼을 클릭하세요. 사용 가능한 통합 목록에서 “웹훅”을 클릭하세요.
다음 단계는 웹훅을 구성하는 것입니다. 다음 필드를 입력하세요:
- 이벤트 이름: Tulip Machine으로 이벤트 게시를 트리거할 이벤트의 이름입니다. 이는 펌웨어에서 Particle.publish()를 호출할 때 사용하는 이벤트 이름입니다.
- URL: Tulip Machine API의 전체 URL입니다. 예: https://[instance].tulip.co/api/v3/attributes/report
- 요청 유형: Tulip 서버는 POST 요청을 기대하므로, 해당 항목이 선택되어 있는지 확인하십시오.
- 요청 형식: 기본값은 웹 양식(Web Form)이지만, JSON을 전송할 예정이므로 이 항목을 JSON으로 변경해야 합니다.
사용자 정의 JSON 형식을 입력하려면 ‘고급 설정’ 영역을 클릭해야 합니다. 다음과 같이 입력할 수 있습니다:
{ "attributes": [ { "machineId": "machineID", "attributeId": "attributeID", "value": "{{{PARTICLE_EVENT_VALUE}}}" } ]}
인증 마지막으로, API 키와 시크릿을 사용하여 Tulip에 인증해야 합니다. 아래 스크린샷을 참고하세요.
이 경우 Basic Auth가 사용됩니다.
"Create Webhook"을 클릭하세요. 이제 Particle 클라우드가 MachineAPI를 통해 Tulip으로 데이터를 스트리밍하도록 성공적으로 설정했습니다!
이제 펌웨어 설정으로 넘어갈 차례입니다!
펌웨어
Particle 클라우드에서 통합이 활성화되었으므로, Tulip으로 데이터를 스트리밍하기 위해 필요한 마지막 단계는 대상 이벤트를 게시하는 펌웨어를 기기에 플래시하는 것입니다. Particle Web IDE, Local IDE 또는 펌웨어 개발에 사용 중인 IDE로 이동하세요.
이미 펌웨어 애플리케이션을 개발 중이라면, 위에서 Google Cloud Platform 연동을 활성화할 때 사용한 이벤트 이름과 일치하는 Particle.publish()를 포함하도록 하세요. 그렇지 않은 경우, 샘플 펌웨어가 필요하다면 아래 코드를 펌웨어 애플리케이션에 붙여넣으세요:
void loop() {
// 임의의 데이터 String data = String((rand()%100)+1); // 통합 트리거 Particle.publish("temperature", data, PRIVATE); // 6초 대기 delay(6000);}```위의 코드는 6초마다 이벤트를 게시하며, 이때 난수를 생성한 후 webook 이벤트로 게시합니다.
이제 Particle.publish()가 포함된 펌웨어를 플래시하여 Particle 장치와의 연동을 트리거해 보세요.
축하합니다! 통합 기능을 처음부터 끝까지 작동시키는 데 필요한 작업은 이것뿐입니다. 이제 기기가 대상 이벤트를 게시하기 시작하며, 이는 Particle 클라우드에 신호를 보내 이벤트 내용을 Tulip 인스턴스로 스트리밍하도록 합니다.
### 데이터가 Tulip에 도달하는지 확인하기
데이터가 Tulip에 성공적으로 게시되고 있는지 확인하려면, Shop Floor --> Machines 영역에서 기계 업데이트를 확인하세요.
{height="" width=""}
참고: 해당 속성은 문자열 형식으로 지정된 후 나중에 변환해야 할 수도 있습니다.
### 사용 사례 예시
Boron404x와 같은 ParticleIO 보드는 Wi-Fi 신호가 약하고, 기기 연결을 위해 셀룰러 통신이 더 빠른 대안일 때 매우 유용합니다. 사용 사례로는 다음이 포함될 수 있습니다:\* 자재 추적\* 기계 모니터링\* 실시간 품질 업데이트