GeoCOM Reference Manual 15.3.3 TMC GetAnglel-Returns complete angle measurement 15-13 15.3. TMC GetAngle5-Retuurns simple angle measurement 15-15 15.3.5 TMC Quick- Returns slope-distance and hz- v-angle l5-17 15.4 MEASUREMENT CONTROL FUNCTIONS 15-22 15.4.1 TMC DoMeasure-Carries out a distance measurement 15-22 15.4.2 TMC SetHandDist-Input slope distance and height offset 15-24 15.5 DATA SETUP FUNCTIONS 15.5.1 TMC GetHeight-Returns the current reflector height 15-26 15.5.2 TMC SetHeight-Sets new reflector height .15-27 15.5.3 TMC GetAtmCorr-Get atmospheric correction parameters 15.5.4 TMC SetAtmCorr -Set atmospheric correction parameters l5-28 15.5.6 TMC GetPrismCorr-Get the prism const H: direction 15.5.5 TMC SetOrientation-Orients the theodolite 15-29 l5-31 15.5.7 TMC SetPrism Corr-Set the prism constant l5-32 15.5.8 TMC GetRefractive Corr- Get the refraction factor l5-33 15.5.9 TMC SetRefractive Corr-Set the refraction factor l5-34 15.5.10 TMC GetRefractiveMethod-Ger the refraction model l5-35 15.5.11 TMC SetRefractive Method -Set the refraction model 15-36 15.5. 12 TMC GetStation-Get the coordinates of the instrument station...15-37 15.5.13 TMC SetStation-Set the coordinates of the instrument station... 15-38 15.6 INFORMATION FUNCTIONS xx15-39 15.6.1 TMC GetFace-Get face information of current telescope position. 15-39 15.6.2 TMC GetSignal-Get information about EDM's signal amplitude.15-40 15.7 CONFIGURATION FUNCTIONS 15.7.1 TMC GetAng Switch- Get angular corrections states 15-4l 15.7.2 TMC GetIncline Switch-Get the dual axis compensator's state..15-42 15.7.3 TMC SetIncline Switch-Switch dual axis compensator -…15-43 TMC GetEdmMode-Get the Edm measurement mode 15.7.5 TMC SetEdmMode- Set EDm measurement modes 15-45 15.7.6 TMC GetSimple coord- Get cartesian coordinates .l5-46 15.7.7 TMC IDataAze Error-IATR error occu l5-50 15.7.8 TMC IDataIncError-I incline erroroccur l5-51 15.7.9 TMC SetAng Switch- Enable/disable angle corrections 15.7. 10 TMC GetSlope DistCorr-Get slope distance correction factors..15-53 16 WI- REGISTRATION- WIR 16.1 CONSTANTS FUNCTIONS 6.2. WIR 16.2.2 WIR Serech format-Get record format ormat- Set record format 16-2 TPS I100-Version 1.01
GeoCOM Reference Manual Contents TPS1100-Version 1.01 V 15.3.3 TMC_GetAngle1 - Returns complete angle measurement................... 15-13 15.3.4 TMC_GetAngle5 - Returns simple angle measurement....................... 15-15 15.3.5 TMC_QuickDist – Returns slope-distance and hz-,v-angle ................ 15-17 15.4 MEASUREMENT CONTROL FUNCTIONS .................................................. 15-22 15.4.1 TMC_DoMeasure - Carries out a distance measurement................... 15-22 15.4.2 TMC_SetHandDist - Input slope distance and height offset ............... 15-24 15.5 DATA SETUP FUNCTIONS ........................................................................ 15-26 15.5.1 TMC_GetHeight - Returns the current reflector height ..................... 15-26 15.5.2 TMC_SetHeight - Sets new reflector height........................................ 15-27 15.5.3 TMC_GetAtmCorr - Get atmospheric correction parameters............ 15-28 15.5.4 TMC_SetAtmCorr - Set atmospheric correction parameters.............. 15-28 15.5.5 TMC_SetOrientation - Orients the theodolite in Hz direction............ 15-29 15.5.6 TMC_GetPrismCorr - Get the prism constant..................................... 15-31 15.5.7 TMC_SetPrismCorr - Set the prism constant....................................... 15-32 15.5.8 TMC_GetRefractiveCorr - Get the refraction factor........................... 15-33 15.5.9 TMC_SetRefractiveCorr - Set the refraction factor............................. 15-34 15.5.10 TMC_GetRefractiveMethod - Get the refraction model...................... 15-35 15.5.11 TMC_SetRefractiveMethod - Set the refraction model........................ 15-36 15.5.12 TMC_GetStation - Get the coordinates of the instrument station....... 15-37 15.5.13 TMC_SetStation - Set the coordinates of the instrument station......... 15-38 15.6 INFORMATION FUNCTIONS ...................................................................... 15-39 15.6.1 TMC_GetFace - Get face information of current telescope position . 15-39 15.6.2 TMC_GetSignal - Get information about EDM’s signal amplitude ... 15-40 15.7 CONFIGURATION FUNCTIONS.................................................................. 15-41 15.7.1 TMC_GetAngSwitch - Get angular correction's states........................ 15-41 15.7.2 TMC_GetInclineSwitch - Get the dual axis compensator's state ........ 15-42 15.7.3 TMC_SetInclineSwitch - Switch dual axis compensator on or off...... 15-43 15.7.4 TMC_GetEdmMode - Get the EDM measurement mode .................... 15-44 15.7.5 TMC_SetEdmMode - Set EDM measurement modes........................... 15-45 15.7.6 TMC_GetSimpleCoord – Get cartesian coordinates........................... 15-46 15.7.7 TMC_IfDataAzeError – If ATR error occur......................................... 15-50 15.7.8 TMC_IfDataIncError – If incline error occur..................................... 15-51 15.7.9 TMC_SetAngSwitch – Enable/disable angle corrections.................... 15-52 15.7.10 TMC_GetSlopeDistCorr – Get slope distance correction factors...... 15-53 16 WI - REGISTRATION – WIR.............................................................. 16-1 16.1 CONSTANTS ............................................................................................... 16-1 16.2 FUNCTIONS ................................................................................................ 16-1 16.2.1 WIR_GetRecFormat – Get Record Format............................................ 16-1 16.2.2 WIR_SetRecFormat – Set Record Format.............................................. 16-2
GeoCOM Reference Manual 17 PORTING A TPS1000 APPLICATION 17.1 RPC CHANGES 17.1.1 Beep On/of. 17-3 17.1.2 Central Services-CST 17.1.3 Electronic Distance Measurement-EDM 17-3 17.1.4 Theodolite Measurement and Calculation -TMC 17.2 DATA TYPES AND CONSTANTS CHANGES 173 NEW RETURNCODES 17-5 A Return Codes A-1 General Return Codes A-2 ANG Subsyste .3 ATA Subsystem -5 TMC Subsyste MOT Subsystem A-7 A-8 WIR Subsystem A-9 AUT Subsystem A-10 BAP Subsystem Hardware interface Serial Interface B-1 Debugging Utility B-2 C-1 Settings for Terminal Emulator Program frames DDD 115 Notice: Microsoft, MS, MS-DOS, Windows, Windows NT, win32, Visual C++ and Visual Basic are either registered trademarks or trademarks of Microsoft Corporation in the USA and other countries TPS I100-Version 1.01
GeoCOM Reference Manual Contents TPS1100-Version 1.01 VI 17 PORTING A TPS1000 APPLICATION............................................... 17-3 17.1 RPC CHANGES .......................................................................................... 17-3 17.1.1 Beep On/Off.............................................................................................. 17-3 17.1.2 Central Services – CSV............................................................................ 17-3 17.1.3 Electronic Distance Measurement – EDM............................................. 17-3 17.1.4 Theodolite Measurement and Calculation – TMC................................. 17-4 17.2 DATA TYPES AND CONSTANTS CHANGES ................................................ 17-4 17.3 NEW RETURNCODES.................................................................................. 17-5 A Return Codes A-1 A-1 General Return Codes A-1 A-2 ANG Subsystem A-2 A-3 ATA Subsystem A-3 A-4 EDM Subsystem A-4 A-5 TMC Subsystem A-6 A-6 MOT Subsystem A-7 A-7 COM Subsystem A-7 A-8 WIR Subsystem A-8 A-9 AUT Subsystem A-9 A-10 BAP Subsystem A-10 B Hardware interface B-1 B-1 Serial Interface B-1 B-2 Debugging Utility B-2 C Provided Samples C-1 C-1 Settings for Terminal Emulator C-1 C-2 Program Frames C-2 D List of RPC’s D-1 D-1 Alpha order D-1 D-2 Numeric Order D-5 . Notice: Notice: Microsoft, MS, MS-DOS, Windows, Windows NT, Win32, Visual C++ and Visual Basic are either registered trademarks or trademarks of Microsoft Corporation in the USA and other countries
GeoCOM Reference Manual 1. GeoCOM 1 GEOCOM 1.1 INTRODUCTION TPS 1 100 series Theodolites are modern geodetic measurement instruments. Most of the main tasks can be fulfilled with these instruments implicitly by their integrated applications. Now, to fulfil a broader spectrum of tasks and applicatio an interface to the tps 1 100 series sensor functions has been defined and will be published with this document With this interface it will be possible to write client applications based on MS Windows and/or for any other platform which supports ASCll based communications 1.2 TPS1100 SYSTEM SOFTWARE The TPS1100 system software organises and controls the interplay sensor elements. Furthermore, it builds up a frame for applications, which can be executed on the tPs 1 100 Theodolite This document concentrates on the main interface to the sensor elements of the TPS1100 Theodolite. This main interface can be used to implement solutions for special customer problems if the already existing solution does not provide the needed functionality or just to enhance it. 1. 2. 1 Organisation of Subsystems The TPS1 100 system software is built around the sensor elements, which are parts and/or optional add-ons of the TPS1 100 Theodolite instrument. It provides a set of functions to access sensors and calculated values. These functions are organised subsystems. We will keep this segmentation in this document These functions can be grouped in the following sections AUT Automatisation; a module which provides functions like the control of the Automatic Target Recognition, Change Face function or Positioning BAP Basic Applications, some functions which can easily be used to ge measuring data BMM Basic Man Machine; functions which controls some basic input/output functionality, e. g set beep alarm,etc TPS1100-Version l01
GeoCOM Reference Manual 1 . GeoCOM TPS1100-Version 1.01 1-1 1 GEOCOM 1.1 INTRODUCTION TPS1100 series Theodolites are modern geodetic measurement instruments. Most of the main tasks can be fulfilled with these instruments implicitly by their integrated applications. Now, to fulfil a broader spectrum of tasks and applications an interface to the TPS1100 series sensor functions has been defined and will be published with this document. With this interface it will be possible to write client applications based on MSWindows and/or for any other platform which supports ASCII based communications. 1.2 TPS1100 SYSTEM SOFTWARE The TPS1100 system software organises and controls the interplay of several sensor elements. Furthermore, it builds up a frame for applications, which can be executed on the TPS1100 Theodolite. This document concentrates on the main interface to the sensor elements of the TPS1100 Theodolite. This main interface can be used to implement solutions for special customer problems if the already existing solution does not provide the needed functionality or just to enhance it. 1.2.1 Organisation of Subsystems The TPS1100 system software is built around the sensor elements, which are parts and/or optional add-ons of the TPS1100 Theodolite instrument. It provides a set of functions to access sensors and calculated values. These functions are organised as subsystems. We will keep this segmentation in this document. These functions can be grouped in the following sections: AUT Automatisation; a module which provides functions like the control of the Automatic Target Recognition, Change Face function or Positioning functions. BAP Basic Applications; some functions which can easily be used to get measuring data. BMM Basic Man Machine; functions which controls some basic input/output functionality, e.g. set beep alarm, etc
GeoCOM Reference m 1. GeoCOM COMF Communication a module which handles the basic communication parameters. Most of these functions relate to both client and server side COM Communication; functions to access some aspects of TPS1 100 control which are close to communication These functions relate either to the client side or to the server side CSv Central Services; this module provides functions to get or set central/basic information about the tps 1 100 instrument CTL Control task; this module contains functions of the system control task edM Electronic distance meter the module which measures distances MOT Motorization; the part which can be used to control the movement and the speed of movements of the instrument SUP Supervisor; functions to control some of the general values of the TPS1100 instrument, e.g. set the lower limit temperature TMC Theodolite Measurement and Calculation; the core module for getting measurement data. WIR WI Registration; this module contains function for GSi recording See Picture(1)for an architectural overview of these subsystems TPS1100-Version 1.01
GeoCOM Reference Manual 1 . GeoCOM TPS1100-Version 1.01 1-2 COMF Communication; a module which handles the basic communication parameters. Most of these functions relate to both client and server side. COM Communication; functions to access some aspects of TPS1100 control which are close to communication. These functions relate either to the client side or to the server side. CSV Central Services; this module provides functions to get or set central/basic information about the TPS1100 instrument. CTL Control task; this module contains functions of the system control task. EDM Electronic Distance Meter; the module which measures distances. MOT Motorization; the part which can be used to control the movement and the speed of movements of the instrument. SUP Supervisor; functions to control some of the general values of the TPS1100 instrument, e.g. set the lower limit temperature. TMC Theodolite Measurement and Calculation; the core module for getting measurement data. WIR WI Registration; this module contains function for GSI recording. See Picture (1) for an architectural overview of these subsystems
GeoCOM Reference Manual 1. GeoCOM PC application GeoCOM client Serial Line COMF TPS GeoCoM BAP CTL EDM COM system software motorization inclination) angle distancebasic sensor sensor senso in/out Picture(1)-Overview Client/Server Application 1.3 PRINCIPLES OF GEOCOM OPERATION Communication takes place between two participants-a client and a server. The medium of communication is a serial communication line. Refer to Appendix B for further information about settings and needed hardware The idea of GeoCOM is based on SUN Microsystems Remote Procedure Call On the low level of implementation, each procedure, which is executable on th remote instrument, is assigned a remote procedure call identification number. Thi number is used internally to associate a specific request, including the implici parameters, to a procedure on the remote device. On this level, GeoCOM provides TPS1100-Version l01
GeoCOM Reference Manual 1 . GeoCOM TPS1100-Version 1.01 1-3 Picture (1) - Overview Client/Server Application 1.3 PRINCIPLES OF GEOCOM OPERATION Communication takes place between two participants – a client and a server. The medium of communication is a serial communication line. Refer to Appendix B for further information about settings and needed hardware. The idea of GeoCOM is based on SUN Microsystems’ Remote Procedure Call (RPC) protocol. On the low level of implementation, each procedure, which is executable on the remote instrument, is assigned a remote procedure call identification number. This number is used internally to associate a specific request, including the implicit parameters, to a procedure on the remote device. On this level, GeoCOM provides system software BMM SUP MOT TMC CSV AUT BAP EDM PC application GeoCOM server inclination sensor angle sensor distance sensor motorization basic in/out COM GeoCOM client COMF Serial Line TPS PC WIR CTL