set_on_tp_progress (수동 모드)

이 절에서는 수동(교시) 작업에서 set_on_tp_progress를 사용하는 방법을 설명합니다. 이 함수는 티치펜던트(TP)에서 진행 상황 업데이트를 받는 콜백 함수를 등록합니다. 주로 실행 중인 프로그램의 진행률 같은 실행 진행 상황을 모니터링하거나, 수동 교시 시퀀스 중에 진행 상황을 시각적으로 표시할 때 사용합니다.

일반적인 사용법

  • 교시 작업 중 실시간 진행 상황이나 완료율을 표시합니다.

  • 수동 모드에서 실행하는 여러 단계의 DRL 절차를 모니터링합니다.

  • 호스트 PC나 교시 UI에서 진행 데이터를 기록하고 시각화합니다.

  • TP 진행 상황 업데이트를 호스트 측 피드백(예: 진행 표시줄)과 동기화해 사용자가 상황을 쉽게 파악하도록 합니다.

참고

  • TP가 진행 상황 업데이트 데이터를 보낼 때마다 콜백이 호출됩니다.

  • 콜백 함수 규칙을 참고하세요.

  • 받은 구조체에는 _iCurrentCount와 _iTotalCount 필드가 있습니다.

예제: 수동 교시 중 진행 상황 피드백 모니터링하기

// TP 진행 메시지용 콜백 함수
void OnTpProgress(LPMESSAGE_PROGRESS tProgress)
{
    printf("-------------------------------------------\n");
    printf("[TP PROGRESS UPDATE]\n");
    printf("Step : %d / %d\n", tProgress->_iCurrentCount, tProgress->_iTotalCount);
    printf("-------------------------------------------\n");

    // 예: 모든 단계가 완료되면 메시지 기록
    if (tProgress->_iCurrentCount >= tProgress->_iTotalCount)
        printf("All steps completed.\n");
}

drfl.open_connection("192.168.137.100");
drfl.set_on_tp_progress(OnTpProgress);

printf("[Teach] Waiting for progress updates from TP...\n");
while (true)
    this_thread::sleep_for(chrono::seconds(1));

이 콜백을 등록하면 티치펜던트(TP)가 진행 상황 메시지를 보고할 때 자동으로 실행됩니다. 콜백은 현재 단계와 전체 단계에 대한 실시간 정보를 제공하므로, 수동 교시 상황을 더 잘 파악하고 호스트 측 피드백 시스템과 동기화할 수 있습니다.

팁

  • 길거나 여러 단계로 이루어진 교시 절차를 실시간으로 모니터링할 때 사용하세요.

  • 나중에 분석할 수 있도록 호스트 PC에 진행 값을 기록하세요.