cmmHomeGetSuccess¶
SYNOPSIS¶
VT_I4 cmmHomeGetSuccess(
[in] VT_I4 Channel, [out] VT_PI4 IsSuccess
)
DESCRIPTION¶
cmmHomeGetSuccess() 함수는 이 함수가 호출되기 이전에 원점복귀가 성공적으로 완료되었는지를 알려주는 함수입니다.
PARAMETER¶
Channel : 축(채널) 번호. 축번호는 상수값으로 [cmX1] 부터 0 번째 채널을 기준 채널로 임의의 채널을 설정할 수 있습니다.
IsSuccess : cmmHomeGetSuccess 함수의 인자이며, 이 함수가 호출된 시점을 기준으로 이전에 원점복귀가 성공적으로 완료된 상태인지를 알려주는 매개 변수입니다.
Value
Meaning
0(FALSE)
지정한 축은 현재 원점복귀가 진행 중이거나 또는 비정상적으로 완료되었습니다.
1(TRUE)
지정한 축은 현재 원점복귀가 정상적으로 수행된 상태입니다.
RETURN Value¶
Value |
Meaning |
|---|---|
음수 |
수행 실패 |
cmERR_NONE |
수행 성공 |
REFERENCE¶
원점복귀의 성공 여부에 대한 플래그 값은 응용프로그램이 종료되어도 그대로 유지됩니다. 따라서 다시 응용프로그램이 시작되면 이전에 원점복귀를 정상적으로 수행했었는지를 알 수가 있습니다. 단, PC 의 하드웨어적인 전원이 차단되거나 재 시작(Rebooting) 되면 그 값은 FALSE 로 리셋됩니다. 따라서 cmmHomeGetSuccess() 함수의 이러한 특성을 활용하면 프로그램이 종료되었다가 다시 실행될 때 이전의 원점복귀 수행여부를 확인할 수가 없어서 매번 원점복귀를 수행해야 했던 불편을 보완할 수 있습니다.
IsSuccess 매개 변수가 FALSE 인 경우는 원점복귀가 진행중인 경우를 의미할 수도 있고 비정상적으로 종료되었음을 의미할 수도 있습니다. 따라서 cmmHomeMoveStart() 함수를 사용한 경우에는 먼저 cmmHomeIsBusy() 함수나 cmmHomeWaitDone() 함수를 선행하여 완료를 확인한 후에 cmmHomeGetSuccess()를 사용하여 성공여부를 확인하는 것이 정석입니다.
이전에 원점복귀가 성공적으로 수행되었더라도 해당 축의 원점복귀를 다시 시작하면 원점복귀의 성공 여부에 대한 플래그는 FALSE 로 리셋(Reset)됩니다.