GeoCOM Reference Manual
Automation - AUT
Leica TPS1200 / TS30 / TM30 – Version 1.50
52
7.4.6
AUT_ChangeFace – turning the telescope to the other face
AUT_ChangeFace ..............................................................................................................................................................................................................................................................................
ce
................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................ 9028
9028 ................................................................................................................................................................................................................................................................AUT_ChangeFa
C-Declaration
AUT_ChangeFace(AUT_POSMODE PosMode,
AUT_ATRMODE ATRMode,
BOOLE bDummy)
VB-Declaration
VB_AUT_ChangeFace4(PosMode As Long,
ATRMode As Long,
bDummy As Boolean)
ASCII-Request
%R1Q,9028:
PosMode,ATRMode,0
ASCII-Response
%R1P,0,0:
RC
Remarks
This procedure turns the telescope to the other face. If another function is active, for example locking onto a
target, then this function is terminated and the procedure is executed.
If the position mode is set to normal (
PosMode = AUT_NORMAL
) it is allowed that the current value of the
compensator measurement is inexact. Positioning precise (
PosMode = AUT_PRECISE
) forces a new
compensator measurement. If this measurement is not possible, the position does not take place.
If ATR mode is activated and the ATR mode is set to
AUT_TARGET,
the instrument tries to position onto a target
in the destination area.
If LOCK mode is activated and the ATR mode is set to
AUT_TARGET,
the instrument tries to lock onto a target
in the destination area.
Parameters
POSMode In
Position mode:
AUT_NORMAL
: uses the current value of the compensator. For
positioning distances >25GON
AUT_NORMAL
might tend to
inaccuracy.
AUT_PRECISE
: tries to measure exact inclination of target.
Tends to long position time (check
AUT_TIMEOUT
and/or
COM-time out if necessary).
ATRMode In
Mode of ATR:
AUT_POSITION
: conventional position to other face.
AUT_TARGET:
tries to position onto a target in the destination
area. This set is only possible if ATR exists and is activated.
bDummy In
It’s reserved for future use, set
bDummy
always to
FALSE
Return-Code Names and Return-Code Values
GRC_OK
0 Execution
successful.
GRC_NA
27
GeoCOM Robotic license key not available
GRC_IVPARAM
2 Invalid
parameter.
GRC_AUT_TIMEOUT
8704
Timeout while positioning of one or both axes. (perhaps
increase AUT timeout, see
AUT_SetTimeout
)
GRC_AUT_MOTOR_ERROR
8707
Instrument has no ‘motorization’.
TMC_NO_FULL_CORRECTION
1283
Error with angle measurement occurs if the instrument is not
levelled properly during positioning.
GRC_FATAL
4 Fatal
error.
GRC_ABORT
8 Function
aborted.
GRC_COM_TIMEDOUT
3077
Communication timeout. (perhaps increase COM timeout,
see
COM_SetTimeout
)
Additionally with position mode
AUT_TARGET
.
GRC_AUT_NO_TARGET
8710
No target found
GRC_AUT_MULTIPLE_TARGETS
8711
Multiple targets found.
