5.3.11. cemHomeSuccess_Set


SYNOPSIS

VT_I4 cemHomeSuccess_Set(
  [in] VT_I4 Axis, [in] VT_I4 IsSuccess
  )

DESCRIPTION

  • cemHomeSuccess_Set 함수는 원점 복귀의 성공 여부에 대한 상태를 강제로 설정하는 함수입니다. 일반적으로는 원점 복귀 완료 상태는 원점 복귀의 실제 수행에 의해서 설정됩니다. 그러나 필요한 경우에 강제로 설정할 수 있습니다.

PARAMETER

  • Axis : 축 번호. 통합 축으로 관리되는 축 번호를 의미하며, 상수 값으로 0 (Zero Based) 이상, (최대 통합 축 개수 - 1) 이하의 값을 축 번호로 설정할 수 있습니다.

  • IsSuccess : cemHomeSuccess_Set 함수의 인자이며, 원점 복귀의 성공 여부에 대한 상태를 강제로 설정합니다.

Value

Meaning

0(cmFALSE)

지정한 축을 원점 복귀 이송이 진행 중인 상태 혹은 비정상적으로 완료된 상태로 설정합니다.

1(cmTRUE)

지정한 축을 원점 복귀 이송이 정상적으로 완료된 상태로 설정합니다.

RETURN VALUE

  • 함수 수행 여부를 반환합니다.

Value

Meaning

음수

수행 실패

0 (ceERR_NONE)

수행 성공

REFERENCE

  • 원점복귀의 성공 여부에 대한 상태는 응용 프로그램이 종료되어도 그대로 유지됩니다. 따라서 다시 응용 프로그램이 시작되면 이전에 원점복귀를 정상적으로 수행했었는지를 알 수가 있습니다. 단, 제어 시스템의 하드웨어적인 전원이 차단되거나 재 시작(Rebooting) 되면 원점 복귀가 완료되지 않은 상태로 설정됩니다. 따라서 cemHomeSuccess_Get 함수의 이러한 특성을 활용하면 프로그램이 종료되었다가 다시 실행될 때 이전의 원점복귀 수행 여부를 확인할 수가 없어서 매번 원점복귀를 수행해야 했던 불편을 보완할 수 있습니다.

  • IsSuccess 매개변수가 FALSE 인 경우는 원점복귀가 진행 중인 경우를 의미할 수도 있고 비정상적으로 종료되었음을 의미할 수도 있습니다. 따라서 cemHomeMoveStart 함수를 사용한 경우에는 먼저 cemHomeIsBusy 함수나 cemSxWaitDone 함수를 선행하여 완료를 확인한 후에 cemHomeSuccess_Get 를 사용하여 성공 여부를 확인하는 것이 정석입니다.

  • 이전에 원점복귀가 성공적으로 수행되었더라도 해당 축의 원점복귀를 다시 시작하면 원점복귀가 완료되지 않은 상태로 설정됩니다

EXAMPLE

  • //* cemHomeMove / cemHomeMoveStart 예제를 참고하여 주시기 바랍니다.