《GeoCOM Reference Manual（Ver. 1.01）》Gc1100

Geo COM Reference manual Ver.1.01 1999, Leica Geosystems AG, Heerbrugg Switzerland

GeoCOM Reference Manual Ver. 1.01 © 1999, Leica Geosystems AG, Heerbrugg, Switzerland

GeoCOM Reference Manual GEOCOM 1.1 ODUCTION TPS I 100 SYSTEM SOFTWARE 1.2.1 Organisation of Subsystems I-I 1 3 PRINCIPLES OF GEOCOM OPERATION 1-3 GENERAL CONCEPTS OF USING GEOCOM 2.1 GENERAL CONCEPT OF OPERATION 2-1 2.2 ASCII PROTOCOL 2. 2. 1 ASCII Protocol Syntax 2.3 FUNCTION CALL PROTOCOL -C/C++ 2-4 2.4 FUNCTION CALL PROTOCOL- VBA 3 FUNDAMENTALS OF PROGRAMMING GEOCOM 3-1 ASCII PROTOCOL PROGRAMMING 3.1.1 Data Types in ASCII Protocol. 3.1.2 ASCII Protocol Program Example. 3.1.3 Modes ofoperani 3-5 C/C++- PROGRAMMING 3.2.1 Data Types in C/C++ 6 3.2.2 Basic GeoCOM Application Frame for C/C++ 3.2.3 C/C++ Development System Support 3.2.4P BA- PROGRAMMING 3.3. 1 Data Types in V'BA-General rules for derivation 3-8 3.3.2 Basic GeoCOM Application Frame for vBA 3-10 3.3.3 VBA Development System Support 3-11 3.4 UNITS OFⅤ ALUES 3-12 3.5 TPSI 100 INSTRUMENT MODES OF OPERATION 3-12 3.5.1 Getting Mode of Operation Concerning Commumication 3.6 COMMON COMMUNICATION ERRORS 3-15 4 REMARKS ON THE DESCRIPTION 4.1 STRUCTURE OF DESCRIPTIONS 4-1 4.1.1 Structure of a Subsystem... 4-1 4.1.2 Structure of a RPC Description Sample of a RPC Description 4-3 TPSI100-Version lo1

GeoCOM Reference Manual Contents TPS1100-Version 1.01 I 1 GEOCOM...................................................................................................1-1 1.1 INTRODUCTION .............................................................................................1-1 1.2 TPS1100 SYSTEM SOFTWARE .....................................................................1-1 1.2.1 Organisation of Subsystems........................................................................1-1 1.3 PRINCIPLES OF GEOCOM OPERATION ........................................................1-3 2 GENERAL CONCEPTS OF USING GEOCOM ................................2-1 2.1 GENERAL CONCEPT OF OPERATION ............................................................2-1 2.2 ASCII PROTOCOL.........................................................................................2-2 2.2.1 ASCII Protocol Syntax ................................................................................2-2 2.3 FUNCTION CALL PROTOCOL – C/C++.........................................................2-4 2.4 FUNCTION CALL PROTOCOL – VBA............................................................2-5 3 FUNDAMENTALS OF PROGRAMMING GEOCOM.....................3-1 3.1 ASCII PROTOCOL PROGRAMMING ..............................................................3-1 3.1.1 Data Types in ASCII Protocol....................................................................3-1 3.1.2 ASCII Protocol Program Example.............................................................3-4 3.1.3 Modes of Operation Concerning Communication....................................3-5 3.2 C/C++ - PROGRAMMING ..............................................................................3-5 3.2.1 Data Types in C/C++..................................................................................3-6 3.2.2 Basic GeoCOM Application Frame for C/C++........................................3-6 3.2.3 C/C++ Development System Support........................................................3-7 3.2.4 Programming Hints.....................................................................................3-8 3.3 VBA – PROGRAMMING................................................................................3-8 3.3.1 Data Types in VBA - General rules for derivation....................................3-8 3.3.2 Basic GeoCOM Application Frame for VBA.......................................... 3-10 3.3.3 VBA Development System Support.......................................................... 3-11 3.3.4 Programming Hints.................................................................................. 3-11 3.4 UNITS OF VALUES...................................................................................... 3-12 3.5 TPS1100 INSTRUMENT MODES OF OPERATION....................................... 3-12 3.5.1 Getting Mode of Operation Concerning Communication ..................... 3-13 3.6 COMMON COMMUNICATION ERRORS....................................................... 3-15 4 REMARKS ON THE DESCRIPTION..................................................4-1 4.1 STRUCTURE OF DESCRIPTIONS.....................................................................4-1 4.1.1 Structure of a Subsystem.............................................................................4-1 4.1.2 Structure of a RPC Description..................................................................4-1 Sample of a RPC Description....................................................................................4-3

GeoCOM Reference Manual COMMUNICATION SETTINGS 5.1 CONSTANTS AND TYPES 5-1 5.2 GENERAL GEOCOM FUNCTIONS 5.2.1 COM Get Double Precision-Get Double Precision Setting.. 5.2. 2 COM SetDoublePrecision-Set Double Precision Setting 5.3 CLIENT SPECIFIC GEOCOM FUNCTIONS 5.3.1 COM Init-Initialize GeoCOM 5.3.2 COM End -Quit GeoCOM. .5-5 5.3.3 COM Open Connection-Open a Port for Commumication 5.3.4 COM Close Connection -Close the Open Port 5.3.5 COM Get BaudRate-Get Current Baud rate .5-9 5.3.6 COM SetBaudRate-Set baud rate 5-10 5.3.7 COM GetTime Out-Get Current Timeout Value 5-11 53.8 COM SetTimeOut- Set Current Timeout value 5.3.9 COM GetComFormat-Get Transmission Data Format 5-13 5.3.10 COM SetComFormat-Set Transmission Data Format 5-14 5.3.11 COM Use Window- Declare Parent Windo Handle 5-15 5.3.12 COM SetConnDIg Flag-Set Connection Dialog Flag 5-16 5.3.13 COM View Error-Pop Up Error Message Box 5-17 53.14 COM GetErrorText- Get Error Text 5.3.15 COM GetWinSWVersion-Retrieve Client Version Information.5-19 5.3. 16 COM GetTPSState-Get Current TPS Operation Mode 5-20 AUTOMATION·AUT USAGE 6.2 CONSTANTS AND TYPE 6-3 6.3.1 AUT GetATRStatus-Get the status of the ATR mode 6.3.2 AUT SetATRStatus-Set the status of the ATR mode 6.3.3 AUT GetLockStatus-Get the status of the lock switch 6-5 6.3.4 AUT SetLockStatus-Set of the ATR lock switch 6.3.5 AUT ReadTol-Read current setting for the positioning tolerances.6-7 6.3.6 AUT SetTol-Set the positioning tolerances 6.3.7 AUT ReadTimeout- Read current timeout setting for positioning.6-10 6.3.8 AUT SetTimeout-Set timeout for positioning 6.3.9 AUT MakePositioning- Turns telescope to specified position.6-12 6.3.10 AUT Change Face-Turns telescope to other face 6-16 6.3.11 AUT Fine Adjust- Automatic tar 6-19 6.3.12 AUT Search- Performs an automatically target search....6-22 6.3.13 AUT Get FineAdjustMode-Get fine adjust positioning mode 6-25 TPSI100-Version lo1

GeoCOM Reference Manual Contents TPS1100-Version 1.01 II 5 COMMUNICATION SETTINGS..........................................................5-1 5.1 CONSTANTS AND TYPES...............................................................................5-1 5.2 GENERAL GEOCOM FUNCTIONS.................................................................5-2 5.2.1 COM_GetDoublePrecision - Get Double Precision Setting....................5-2 5.2.2 COM_SetDoublePrecision - Set Double Precision Setting......................5-4 5.3 CLIENT SPECIFIC GEOCOM FUNCTIONS.....................................................5-5 5.3.1 COM_Init - Initialize GeoCOM .................................................................5-5 5.3.2 COM_End - Quit GeoCOM........................................................................5-5 5.3.3 COM_OpenConnection - Open a Port for Communication.....................5-6 5.3.4 COM_CloseConnection - Close the Open Port.........................................5-8 5.3.5 COM_GetBaudRate – Get Current Baud Rate .........................................5-9 5.3.6 COM_SetBaudRate - Set Baud Rate ....................................................... 5-10 5.3.7 COM_GetTimeOut - Get Current Timeout Value .................................. 5-11 5.3.8 COM_SetTimeOut - Set Current Timeout Value.................................... 5-12 5.3.9 COM_GetComFormat - Get Transmission Data Format...................... 5-13 5.3.10 COM_SetComFormat - Set Transmission Data Format ....................... 5-14 5.3.11 COM_UseWindow - Declare Parent Window Handle .......................... 5-15 5.3.12 COM_SetConnDlgFlag - Set Connection Dialog Flag ......................... 5-16 5.3.13 COM_ViewError - Pop Up Error Message Box.................................... 5-17 5.3.14 COM_GetErrorText - Get Error Text..................................................... 5-18 5.3.15 COM_GetWinSWVersion - Retrieve Client Version Information......... 5-19 5.3.16 COM_GetTPSState – Get Current TPS Operation Mode ..................... 5-20 6 AUTOMATION - AUT.............................................................................6-1 6.1 USAGE...........................................................................................................6-1 6.2 CONSTANTS AND TYPES...............................................................................6-1 6.3 FUNCTIONS ...................................................................................................6-3 6.3.1 AUT_GetATRStatus - Get the status of the ATR mode .............................6-3 6.3.2 AUT_SetATRStatus - Set the status of the ATR mode ...............................6-4 6.3.3 AUT_GetLockStatus - Get the status of the lock switch ...........................6-5 6.3.4 AUT_SetLockStatus - Set of the ATR lock switch......................................6-6 6.3.5 AUT_ReadTol - Read current setting for the positioning tolerances.....6-7 6.3.6 AUT_SetTol - Set the positioning tolerances.............................................6-9 6.3.7 AUT_ReadTimeout - Read current timeout setting for positioning ...... 6-10 6.3.8 AUT_SetTimeout - Set timeout for positioning....................................... 6-11 6.3.9 AUT_MakePositioning - Turns telescope to specified position ............ 6-12 6.3.10 AUT_ChangeFace - Turns telescope to other face ................................ 6-16 6.3.11 AUT_FineAdjust - Automatic target positioning.................................... 6-19 6.3.12 AUT_Search - Performs an automatically target search ...................... 6-22 6.3.13 AUT_GetFineAdjustMode - Get fine adjust positioning mode.............. 6-25

GeoCOM Reference Manual 6.3.14 6.3.15 扎ri SetFine Adjust Mode-Set the fine adjustment mode... LockIn- Starts the target tracking BASIC APPLICATIONS- BAP 7.1 CONSTANTS AND TYPES 7-1 7.2 FUNCTIONS 7-2 7.2.1 BAP GetLastDisplayedError-Get last TPS system error number.7-2 7. 2. 2 BAP Meas Distance Angle- Measure distance and angles 7.2.3 BAP GetMeasPrg-Get User Measurement Program 7-6 7.2.4 BAP SetMeasPrg-Set User Measurement Program BASIC MAN MACHINE INTERFACE-BMM CONSTANTS AND TYPES FUNCTIONS 8.2. 1 BM BeepAlarm-Output of an alarm-signal. 8-1 8.2.2 BM BeepNormal-A single beep-signal 8-2 8.2.3 1OS BeepOn-Start a beep-signal 8.2.4 1OS BeepOf-Stop active beep-signal COMMUNICATIONS- COM 9.1 CONSTANTS AND TYPES 9.2 FUNCTIONS 9-1 9.2.1 COM GetSWVersion-Retrieve Server Release information 9.2.2 COM SetSenddelay-Set Reply delay 9-2 9.2.3 COM Local- Switch TPS1100 into Local Mode 9. 2. 4 COM SwitchOnTPs-Switch on TPS instrument 9.2.5 COM SwitchofTPS-Switch off TPS1100 or Set Sleep Mode.9 9.2.6 COM NullProc-Check Communication 9.2.7 COM Enable SignOf- Enable Remote Mode logging 9.2.8 COM Get BinaryAvailable-Get Binary Attribute of Server 9.2.9 COM Set Binary Available- Set Binary Attribute of server 10 CENTRAL SERVICES-CSV 10.1 USAGE 10-1 10.2 CONSTANTS AND TYPES 10.3 FUNCTIONS 10-3 10.3.1 CSV GetInstrumentNo-Get factory defined instrument number 0-3 10.3.2 CSV GetInstrumentName-Get Leica specific instrument name..10-4 10.3.3 CSI GetDevice Config-Get instrument configuration 0-4 103.4 CSV Get Date Time- Get date and time l0-5 10.3.5 CSV SetDate Time- Set date and time TPSI100-Version lo1

GeoCOM Reference Manual Contents TPS1100-Version 1.01 III 6.3.14 AUT_SetFineAdjustMode - Set the fine adjustment mode..................... 6-26 6.3.15 AUT_LockIn - Starts the target tracking ................................................ 6-27 7 BASIC APPLICATIONS - BAP .............................................................7-1 7.1 CONSTANTS AND TYPES...............................................................................7-1 7.2 FUNCTIONS ...................................................................................................7-2 7.2.1 BAP_GetLastDisplayedError - Get last TPS system error number.........7-2 7.2.2 BAP_MeasDistanceAngle - Measure distance and angles.......................7-3 7.2.3 BAP_GetMeasPrg – Get User Measurement Program............................7-6 7.2.4 BAP_SetMeasPrg – Set User Measurement Program..............................7-7 8 BASIC MAN MACHINE INTERFACE - BMM.................................8-1 8.1 CONSTANTS AND TYPES...............................................................................8-1 8.2 FUNCTIONS ...................................................................................................8-1 8.2.1 BMM_BeepAlarm - Output of an alarm-signal.........................................8-1 8.2.2 BMM_BeepNormal - A single beep-signal................................................8-2 8.2.3 IOS_BeepOn - Start a beep-signal.............................................................8-2 8.2.4 IOS_BeepOff - Stop active beep-signal......................................................8-3 9 COMMUNICATIONS - COM................................................................9-1 9.1 CONSTANTS AND TYPES...............................................................................9-1 9.2 FUNCTIONS ...................................................................................................9-1 9.2.1 COM_GetSWVersion - Retrieve Server Release Information..................9-1 9.2.2 COM_SetSendDelay - Set Reply Delay......................................................9-2 9.2.3 COM_Local - Switch TPS1100 into Local Mode......................................9-3 9.2.4 COM_SwitchOnTPS - Switch on TPS instrument.....................................9-4 9.2.5 COM_SwitchOffTPS - Switch off TPS1100 or Set Sleep Mode................9-5 9.2.6 COM_NullProc – Check Communication .................................................9-5 9.2.7 COM_EnableSignOff – Enable Remote Mode Logging ...........................9-6 9.2.8 COM_GetBinaryAvailable – Get Binary Attribute of Server...................9-7 9.2.9 COM_SetBinaryAvailable – Set Binary Attribute of Server.....................9-8 10 CENTRAL SERVICES - CSV................................................................ 10-1 10.1 USAGE........................................................................................................ 10-1 10.2 CONSTANTS AND TYPES............................................................................ 10-1 10.3 FUNCTIONS ................................................................................................ 10-3 10.3.1 CSV_GetInstrumentNo - Get factory defined instrument number........ 10-3 10.3.2 CSV_GetInstrumentName - Get Leica specific instrument name ......... 10-4 10.3.3 CSV_GetDeviceConfig - Get instrument configuration......................... 10-4 10.3.4 CSV_GetDateTime- Get date and time................................................... 10-5 10.3.5 CSV_SetDateTime - Set date and time.................................................... 10-7

GeoCOM Reference Manual l0.3.6 GetSWVersion-Get Software version l0-7 10.3.7 CSI GetvBat-Get the value of the voltage supply 10.3.8 CSV GetVMem-Get value of the memory backup voltage supply.. 10-9 10.3.9 CSV GetInt Temp-Get the temperature l0-10 CONTROLLER TASK-CTL 11-1 11.1 FUNCtIONs 71.1.I CTL GetUpCounter-Get Up Counter. l-1 12 ELECTRONIC DISTANCE MEASUREMENT- EDM 121 USAGE 12-1 12.2 CONSTANTS AND TYPES 12-1 12.3 FUNCTIONS 12.3.3 EDM SetEglIntensity-Change intensity of guide ligt.12-2 12.3.1 EDM Laserpoinmter-Switch on/off laserpointer 12.3.2 EDM GetEglIntensity-Get value of intensity of guide lig 12-4 12. 13 MOTORISATION- MOT 13-1 13.1 13-1 13.2 CONSTANTS AND TYPES 13.3 FUNCTIONS 13-2 13.3.1 MOT ReadLockStatus-Return condition of LockIn control....13-2 13.3.2 MOT Start Controller- Start motor controller l3-3 13.3.3 MOT StopController-Stop motor controller. 13-4 13. 3.4 MOT Set velocity- Drive Instrument with visual control 14 SUPERVISOR-SUP 14.1 CONSTANTS AND TYPES 142 FuNCtIONS l4-1 14.2.1 SUP GetConfig-Get power management configuration status 14-1 14.2.2 SUP SetConfig-Set power management configuration 14.2.3 SUP SwitchLow Temp Control -Set low temperature control l4-4 15 THEODOLITE MEASUREMENT AND CALCULATION- TMC 15-1 15.1 15-2 15. .I Inclination measurement/correction l5-2 15.1.2 Sensor measurement programs l5-3 15.2 CONSTANTS AND TYPES 15.3 MEASUREMENT FUNCTIONS 15-7 15.3.1 TMC GetCoordinate-Gets the coordinates of a measured point..15-7 15.3.2 TMC GetSimpleMea- Returns angle and distance measurement.. 15-10 TPSI100-Version lo1

GeoCOM Reference Manual Contents TPS1100-Version 1.01 IV 10.3.6 CSV_GetSWVersion - Get Software Version.......................................... 10-7 10.3.7 CSV_GetVBat - Get the value of the voltage supply.............................. 10-8 10.3.8 CSV_GetVMem - Get value of the memory backup voltage supply ...... 10-9 10.3.9 CSV_GetIntTemp - Get the temperature............................................... 10-10 11 CONTROLLER TASK – CTL............................................................... 11-1 11.1 FUNCTIONS ................................................................................................ 11-1 11.1.1 CTL_GetUpCounter – Get Up Counter.................................................. 11-1 12 ELECTRONIC DISTANCE MEASUREMENT - EDM.................... 12-1 12.1 USAGE........................................................................................................ 12-1 12.2 CONSTANTS AND TYPES............................................................................ 12-1 12.3 FUNCTIONS ................................................................................................ 12-2 12.3.1 EDM_Laserpointer - Switch on/off laserpointer.................................... 12-2 12.3.2 EDM_GetEglIntensity - Get value of intensity of guide light................ 12-4 12.3.3 EDM_ SetEglIntensity - Change intensity of guide light....................... 12-5 13 MOTORISATION - MOT....................................................................... 13-1 13.1 USAGE........................................................................................................ 13-1 13.2 CONSTANTS AND TYPES............................................................................ 13-1 13.3 FUNCTIONS ................................................................................................ 13-2 13.3.1 MOT_ReadLockStatus - Return condition of LockIn control................ 13-2 13.3.2 MOT_StartController - Start motor controller...................................... 13-3 13.3.3 MOT_StopController - Stop motor controller........................................ 13-4 13.3.4 MOT_SetVelocity - Drive Instrument with visual control..................... 13-5 14 SUPERVISOR - SUP ............................................................................... 14-1 14.1 CONSTANTS AND TYPES............................................................................ 14-1 14.2 FUNCTIONS ................................................................................................ 14-1 14.2.1 SUP_GetConfig - Get power management configuration status.......... 14-1 14.2.2 SUP_SetConfig - Set power management configuration....................... 14-3 14.2.3 SUP_SwitchLowTempControl - Set low temperature control............... 14-4 15 THEODOLITE MEASUREMENT AND CALCULATION - TMC 15-1 15.1 USAGE........................................................................................................ 15-2 15.1.1 Inclination measurement/correction....................................................... 15-2 15.1.2 Sensor measurement programs............................................................... 15-3 15.2 CONSTANTS AND TYPES............................................................................ 15-3 15.3 MEASUREMENT FUNCTIONS...................................................................... 15-7 15.3.1 TMC_GetCoordinate – Gets the coordinates of a measured point....... 15-7 15.3.2 TMC_GetSimpleMea - Returns angle and distance measurement...... 15-10