파티클IO 통합
  • 21 Oct 2024
  • 2 읽을 분
  • 기여자

파티클IO 통합


기사 요약

Tulip과 ParticleIO 기기를 쉽게 연결하기

파티클의 커뮤니티 통합(동일한 가이드)을 따라하기: 파티클 <> 튤립 커뮤니티 통합

설정

Tulip 머신 엔드포인트 설정하기

Tulip에서 머신을 생성하려면 다음이 필요합니다.* API 자격증명* 머신 유형* 머신

API 자격증명설정 --> API 토큰으로 이동하여 머신 및 속성에 대한 읽기/쓰기 기능이 있는 API 토큰을 생성합니다image.png

머신 유형작업현장 --> 머신 --> 머신 유형으로 이동하여 새 머신 유형을 생성합니다. ParticleIO에서 게시된 이벤트를 반영하는 머신 속성을 생성합니다. 참고: 데이터 유형은 문자열이어야 합니다. image.png

새로 생성된 머신 유형 아래에 새 머신을생성하고, 구성에서 머신 속성을 Tulip 머신 API에 매핑하고 MachineId 및 AttributeIdimage.png{height="" width=""}에 유의합니다.

통합 활성화

파티클 콘솔필요한모든 사전 구성을 완료했으므로 이제 파티클 콘솔에서 Tulip 통합을 활성화할 준비가 되었습니다.

먼저 사이드바()의 통합 아이콘을 클릭하거나 이 링크를 따라 통합 허브로 이동하세요. 제품에 대한 연동을 활성화하려면 원하는 제품의 통합 허브를 방문해야 합니다. 사이드바에서 제품 아이콘()을 클릭하고 제품을 찾은 다음 제품 컨텍스트에서 연동 아이콘()을 클릭하면 됩니다.

연동 허브에서 '새 연동' 버튼을 클릭합니다. 사용 가능한 연동 목록에서 "웹훅"을 클릭합니다.

다음 단계는 웹훅을 구성하는 것입니다. 다음 필드를 입력합니다:

  • 이벤트 이름: 이벤트 이름: Tulip Machine에 이벤트 게시를 트리거할 이벤트의 이름입니다. 펌웨어에서 Particle.publish()를 호출할 때 이벤트의 이름이 됩니다.
  • URL: Tulip Machine API의 전체 URL 예시: https://[instance].tulip.co/api/v3/attributes/report
  • 요청 유형: Tulip 서버가 POST를 기대하므로 이를 선택했는지 확인하세요.
  • 요청 형식: 기본값은 웹 양식이지만 JSON을 전송할 예정이므로 이를 JSON으로 변경해야 합니다.

고급 설정 영역을 클릭하여 사용자 지정 JSON 형식을 입력해야 합니다. 다음과 같이 입력할 수 있습니다:

{ "attributes": [ { "machineId": "machineID", "attributeId": "attributeID", "value": "{{{PARTICLE_EVENT_VALUE}}}" } ]}

인증 마지막으로 API 키와 비밀번호로 Tulip에 인증해야 합니다. 아래 스크린샷을 예로 들어보세요.tulip_api_auth.jpg

이 경우 기본 인증이 사용됩니다.

"웹훅 생성"을 클릭합니다. 이제 파티클 클라우드가 MachineAPI를 통해 데이터를 Tulip으로 스트리밍하도록 성공적으로 지시했습니다!

이제 펌웨어로 넘어갈 차례입니다!

펌웨어

이제 파티클 클라우드에서 통합이 활성화되었으므로 데이터를 Tulip으로 스트리밍하는 데 필요한 마지막 단계는 대상 이벤트를 게시하는 펌웨어를 디바이스에 플래시하는 것입니다. 파티클 웹 IDE, 로컬 IDE 또는 펌웨어 개발에 사용 중인 IDE로 이동합니다.

이미 펌웨어 애플리케이션을 개발 중인 경우, 위에서 Google Cloud Platform 연동을 활성화하는 데 사용한 이벤트와 일치하는 이벤트 이름으로 Particle.publish()를 포함해야 합니다. 그렇지 않은 경우 샘플 펌웨어가 필요한 경우 아래 코드를 펌웨어 앱에 붙여넣으세요:

void setup() {}

void loop() {}

// 랜덤 데이터 String data = String((rand()%100)+1); // 통합 트리거 Particle.publish("temperature", data, PRIVATE); // 6초 동안 대기 delay(6000);}``` 위 코드는 6초마다 이벤트를 게시하여 난수를 생성한 다음 위북 이벤트에 게시합니다.

이제 파티클 디바이스와의 통합을 트리거할 파티클.publish() 함수를 사용하여 펌웨어를 플래시하세요.

축하합니다! 이제 통합을 엔드 투 엔드 방식으로 작동시키는 데 필요한 모든 작업이 완료되었습니다. 이제 디바이스가 대상 이벤트를 게시하기 시작하고, 파티클 클라우드에 신호를 보내 이벤트의 콘텐츠를 Tulip 인스턴스로 스트리밍합니다.

데이터가 Tulip에 도달하는지 확인

데이터가 Tulip에 성공적으로 게시되었는지 확인하려면 작업 현장 --> 머신 영역에서 머신 업데이트를 확인할 수 있습니다.

image.png

참고: 속성은 문자열 형식이어야 하며 나중에 변환해야 할 수도 있습니다.

사용 사례 예시

Wi-Fi 상태가 좋지 않고 셀룰러가 장치 연결을 위한 더 빠른 해결 방법일 때 Boron404x와 같은 ParticleIO 보드를 사용하는 것이 좋습니다. 사용 사례에는 다음이 포함될 수 있습니다. * 재료 추적 * 기계 모니터링 * 실시간 품질 업데이트


이 문서가 도움이 되었습니까?