저울용 MT-SICS 드라이버

MT-SICS Scale Driver 사용법

Tulip용 MT-SICS 저울 드라이버 가이드:::(Info) (Player Information)
This driver will only be available for Player 2.8.0 and above. Please reach out to developer@tulip.co to put this on your instance.
:::

이 문서에서는 Tulip의 MT-SICS(예: Sartorius) 저울 드라이버와 관련된 기능 및 구성에 대해 설명합니다.

개요

이 문서에서는 Tulip과 Sartorius 저울과 같은 MT-SICS 호환 저울 간의 연결에 대해 중점적으로 다룹니다. 연결을 구성하는 방법을 다룬 다음, 무게 측정, 타링, 저울 제로 설정과 같은 드라이버의 기능을 살펴보겠습니다. 저울을 Windows PC에 연결하고 Tulip 인스턴스에서 적절한 기능 플래그(Feature Flag)를 활성화해야 합니다.

구성

Tulip에서 MT-SICS 저울을 사용하도록 구성하려면 다음 단계를 따르십시오.

필수 조건

1. 저울 연결: Sartorius(또는 기타 MT-SICS 호환) 저울을 Windows PC에 연결합니다(일반적으로 USB 또는 직렬 연결을 통해).
2. Windows 구성: Windows PC가 연결된 저울을 인식할 수 있는지 확인하십시오. 시리얼 연결인 경우, Windows에서 할당된 COM 포트를 확인하십시오(드라이버를 통해 해당 포트 목록을 확인할 수도 있습니다).

Tulip Player 설정

저울과의 연결은 Tulip Player를 통해 관리됩니다. 다음 단계는 일반적으로 관련 Tulip 애플리케이션(예: Driver Unit Tests 앱) 내의 Player Driver 페이지 에서 수행됩니다:

1. MT-SICS 드라이버로 이동:
   • Tulip Player를 엽니다.
   • 장치 드라이버 전용 페이지로 이동합니다(테스트/유틸리티 앱 내에서 대개 “Player Driver Page” 또는 이와 유사한 이름으로 표시됨).
   • "MT-SICS" 버튼 또는 섹션을 찾아 선택합니다.

{height="" width=""}2. COM 포트 확인: * ‘직렬 장치 목록’ 버튼을 클릭합니다. 그러면 시스템 조회를 통해 사용 가능한 COM 포트가 표시됩니다. * 연결된 저울에 해당하는 COM 포트를 확인합니다.

1. 연결 설정:
   • 확인한 COM 포트를 해당 입력란에 입력하십시오.
   • 전송 속도를 입력합니다. MT-SICS를 사용하는 대부분의 Sartorius 저울의 경우, 이 값은 일반적으로 115200입니다.
   • '연결' 버튼을 클릭하십시오. 연결이 성공하면 성공 메시지나 상태 표시기가 나타납니다.

문제 해결

• COM 포트 목록에 표시되지 않는 경우:
  • 저울이 PC에 올바르게 연결되어 있고 전원이 켜져 있는지 확인하십시오.
  • Windows 장치 관리자를 확인하여 저울(또는 USB-시리얼 어댑터)이 인식되었는지, COM 포트가 할당되었는지 확인하십시오.
  • 저울을 다시 연결하거나 Tulip Player를 다시 시작해 보십시오.
• 연결 실패:
  • 올바른 COM 포트와 전송 속도가 입력되었는지 확인하십시오.
  • 현재 다른 응용 프로그램이 동일한 COM 포트를 사용하고 있지 않은지 확인하십시오.
  • CUSTOM_EDGE_DRIVER_MT_SICS_SCALE 기능 플래그가 활성화되어 있는지 확인하십시오.

기능

MT-SICS 저울 드라이버를 사용하면 네트워크로 연결되거나 직접 연결된(예: USB/직렬) 저울을 Windows Tulip Player를 통해 Tulip Apps에 통합할 수 있습니다.

이 드라이버는 저울에 연결, 무게 가져오기, 저울 영점 조정, 저울 타링 및 작업 취소를 지원합니다.

함수

Tulip Triggers에서 다음 함수를 사용하여 연결된 저울과 상호 작용할 수 있습니다:

• 직렬 장치 목록 표시:
  • 설명: Windows Player 컴퓨터를 조회하여 사용 가능한 직렬(COM) 포트를 나열합니다. 저울에 적합한 포트를 식별하는 데 유용합니다.
  • 입력: 없음.
  • 출력: 사용 가능한 COM 포트 목록.
• 연결:
  • 설명: MT-SICS 저울과 연결을 설정합니다.
  • 입력:
    • COM 포트: 저울이 연결된 시리얼 포트(예: "COM3").
    • 전송 속도: 직렬 연결의 통신 속도(예: 115200).
  • 출력: 연결 시도 상태(성공/실패).
• 무게 가져오기:
  • 설명: 저울에 현재 중량을 요청합니다. 일반적으로 드라이버는 측정값이 포함된 WeightData 이벤트를 발생시킵니다.
  • 입력: 없음(연결이 활성화된 것으로 가정).
  • 출력: WeightData 이벤트를 트리거합니다. 앱이 이 이벤트를 수신하고 표시할 수 있도록 설정되어 있는지 확인하십시오(예: “현재 중량” 변수).
• 초기화:
  • 설명: 체중계의 수치를 0으로 초기화하는 명령을 전송합니다. 체중계 디스플레이에도 이 변경 사항이 반영되어야 합니다.
  • 입력: 없음.
  • 출력: OperationStatus 이벤트를 트리거합니다(성공/실패).
• 즉시 영점 설정:
  • 설명: 저울을 0으로 초기화하라는 명령을 즉시 전송합니다.
  • 입력: 없음.
  • 출력: OperationStatus 이벤트(성공/실패)를 트리거합니다.
• 타레:
  • 설명: 저울에 실린 현재 무게를 기준으로 타레를 설정합니다. 저울 디스플레이에는 0이 표시되어야 합니다. 무게가 너무 크거나 타레 허용 범위를 벗어날 경우 이 명령이 실패할 수 있습니다.
  • 입력: 없음(저울에 현재 올려진 무게를 사용).
  • 출력: OperationStatus 이벤트 발생 (성공/실패).
• 즉시 용기 중량 설정:
  • 설명: 저울에 실린 현재 무게를 기준으로 즉시 용기 중량 제로 설정을 수행하도록 명령을 보냅니다.
  • 입력: 없음.
  • 출력: OperationStatus 이벤트 발생 (성공/실패).
• 취소:
  • 설명: 저울과의 진행 중인 통신이나 명령을 취소하려고 시도합니다. 드라이버가 무게 데이터를 스트리밍 중이었다면, 이로 인해 지속적인 무게 업데이트가 중지될 수도 있습니다.
  • 입력: 없음.
  • 출력: OperationStatus 이벤트(성공)를 트리거합니다. “현재 중량” 업데이트가 중단될 수 있습니다.
• 연결 끊기:
  • 설명: MT-SICS 저울과의 연결을 종료합니다.
  • 입력: 없음.
  • 출력: 연결 해제 시도 상태.

이벤트

다음 이벤트는 Tulip 트리거에서 저울 드라이버의 정보 또는 상태 변경에 반응하는 데 사용할 수 있습니다:

• 오류:
  • 설명: 드라이버 또는 저울과의 통신에 문제가 있음을 나타냅니다.
  • 페이로드: 오류에 대한 상세 내용이 담긴 메시지를 포함합니다.
• WeightData:
  • 설명: 저울로부터 새로운 중량 정보를 수신했을 때 발생하며, 일반적으로 'Get weight' 명령을 실행한 후 또는 드라이버가 중량 스트리밍 모드로 설정된 경우에 발생합니다.
  • 페이로드: 중량 (숫자 값)과 단위 (예: "g", "kg")가 포함됩니다. 이 값은 "현재 중량"을 표시하기 위해 Tulip 변수에 저장되어야 합니다.
• OperationStatus:
  • 설명: 실행된 명령(예: 제로, 타레, 취소)의 결과를 나타냅니다.
  • 페이로드:
    • status: "success" 또는 "failure".
    • message: 작업 결과에 대한 추가 정보(예: "타레 성공", "타레 실패: 과부하").