GSI ONLINE for Leica TPS

Transcription

1 GSI LINE for Leica TPS M. Mueller Advanced User Guide Geosystems

2 Introduction Controlling electronic Total Stations with remote interface devices opens a big, new section in the world of surveying applications. Exchanging data and configurations between instruments and computers or transferring data directly to a data logger highly enhances the flexibility and functionality of Leica s sensors. The latest TPS Total Stations, as well as previous series support a large set of interfacing commands, to allow direct user access via RS serial interface. The Leica Geo Serial Interface (GSI) is a general purpose, serial data interface for bi-directional communication between TPS Total Stations and computers. GSI uses a simple command structure to read/write values from/to the sensor. Global and instrument specific word indexes (WI) are used to specify various data types. Depending on the type of Total Station used, GSI provides a specific set of commands considering the instrument series functionality. In addition to the former online reference guide WILD INSTRUMENTS LINE, this User Guide focuses the latest Leica Series of Total Stations - TPS//7//. We have designed this guide as a simple command listing and therefore basic aspects of serial data communications will not be covered. For detailed information and advice on GSI communication, we strongly recommend to consult the WILD INSTRUMENTS LINE. Marco Mueller Business Area TPS

3 Table of contents GSI Data Format... 4 GSI Block Information... 5 Online Command Structure... 6 TPS Commands... 7 SET... 8 CF... PUT... GET... Remote Stake out... 4 Warning and Errors... 5 TPS/7 Commands... 6 SET... 7 CF... PUT... GET... 5 Warning and Errors... 7 TPS/ Commands... 8 SET... 9 CF... PUT... GET... 4 Telescope positioning... 6 Warning and Errors... 7

4 GSI Data Format GSI Data Format Data transmitted trough GSI interface is composed in a sequence of blocks, ending with a terminator (CR or CR/LF). Every block (see the GSI8 example below) starts with a two character WI code, specifying the data type within this block. So far, a GSI8 block consists of totally 5 characters, including 7 information characters (e.g. WI, sign) and 8 (GSI8) data characters. Since data had become larger than 8 characters, we have introduced an enhanced 6 character data format, called GSI6. This new format size considers large scaled values, such as UTM coordinates, large alphanumeric codes, attributes or pointnumbers. Following, a GSI8 example showing a sequence of three blocks, containing pointnumber (), easting coordinate (8) and northing coordinate (8). Example, shows a GSI6 block sequence with pointnumber (), horizontal () and vertical () angle. Example GSI8: +A A A A A ch. GSI8 Datablock Structure: Pos.-: Word Index (WI) e.g. ; WI code Pos.-6: Information related to data e.g. ; number of lines Pos.4: Sign e.g. + or - Pos.8-5: GSI8 data (8 digits) e.g. A ; Pointnumber Pos.6: Blank (=separating character) Example GSI6: +PNC PNC PNC PNC PNC char. GSI6 Datablock Structure: Pos.-: Word Index (WI) e.g. ; WI code Pos.-6: Information related to data e.g. ; number of lines Pos.4: Sign e.g. + or - Pos.8-: GSI6 data (6 digits) e.g. PNC58 ; Pointnumber Pos.6/4: Blank (=separating character) 4

5 GSI Bock Information GSI Block Information Position Explanation Applicable for No significance All words 4 AUTOMATIC INDEX INFORMATI : Automatic index : Automatic index OPERATING : Automatic index OPERATING 5 INPUT MODE 6 UNITS 7 SIGN 8-5 (8-) : Original measured values transferred from the instrument : Manual input from keyboard : Measured value, Hz-Correction : Measured value, Hz-Correction 4: Result of special function : Meter (last digit: mm) : Feet (last digit: /ft) : 4 gon : 6 decimal 4: 6 sexagesimal 5: 64 mil 6: Meter (last digit: /mm) 7: Feet (last digit: / ft) 8: Meter (last digit: /mm) +: Positive value -: Negative value DATA Data includes a sequence of 8(6) numerical or alphanumerical characters. All words containing angle information Measured data Measured data Measured data Measured data Note that certain data blocks are allowed to carry more than value (e.g. PPM/MM). Those data are automatically transferred with a sign before each single value. 6 (4) SEPARATING CHARACTER _: Blank All words [Tab.]; [Source: WILD INSTRUMENTS LINE; 988] 5

6 Online Command Structure Online Command Structure GSI online commands represent a simple syntax structure consisting of four basic commands. To access a wide range of settings or values, commands can be enhanced with a limited sequence of word indexes (WI) and parameters. Following, a short summary explaining the meaning of the basic commands continued with some examples. SET Set instrument parameters CF Read internal parameter settings PUT Write/change values within the Total station GET/I/ Get instant values from the Total Station (last valid value) GET/M/ Release measurement and get measured values from the Total Station Examples: SET commands SYNTAX: SET/<set spec>/<parameter><cr/lf> EXAMPLE: SET// RESPSE:? Instrument BEEP: SET// (disable) SET// (enable) CF commands SYNTAX: CF/<conf spec><cr/lf> EXAMPLE: CF/ RESPSE: / Above CF/ reads the BEEP setting / Beep disabled / Beep enabled PUT commands SYNTAX: PUT/<put spec> <Value>_<CR/LF> EXAMPLE: PUT/.+ RESPSE:? CFIRMATI: <CR/LF> Writes Pointnumber PUT/.+ PtNo 4 Make sure you put a space (_), behind <Value>! GET commands SYNTAX: GET/n/WI<get spec><cr/lf> EXAMPLE: GET/M/WI RESPSE:.+494 Read Hz-Angle value GET/I/WI Read Hz-,and V-Angles GET/I/WI/WI;

7 TPS TPS Series The TPS Series were introduced in 996/97. These Total Stations were the first series supporting an enhanced set of GSI interfacing commands. The additional functionality conducted to increasing operational benefit, compared to its predecessor TC5 which is described in the WILD INSTRUMENTS LINE, Appendix E. Supported Instruments: TC4L, TC6, TC8 (Firmware Version. and higher) TC65/L, TC85/L TC95/L (collectively the TCx5 series) The following command listing is split into separate sections for each basic command (SET, CF, PUT, GET). Some of the listed features may require specially equipped instruments (e.g. instruments with Laser Plummet or EGL). For detailed description of single functions, we recommend to consult the corresponding User Manual. Low Level commands SYNTAX: <command>cr/lf RESPSE:? <Command>: a b c Powers on the instrument Powers off the instrument Clears a distance measurement Restrictions: ) Applies to TCx5 instruments only ) Applies to TCx/4 instruments only ) Applies to instruments equipped with EGL (Electronic Guide Light) only 4) Applies to instruments equipped with Laser Plummet only 7

8 TPS SET Syntax: SET/<SET SPEC>/<Parameter><CR/LF> <SET SPEC> FUNCTI <PARAMETER> SETTING BEEP Display contrast Angle UNIT 4 Distance UNIT 44 V angle READING 49 ) Time/Date format 5 Angle rounding 7 Baudrate Parity 7 Terminator 76 Data recording device 8 ) EGL activity 8 ) EGL intensity 95 Auto 4) Laser plummet Low contrast Medium contrast Medium to high contrast High contrast G Degree decimal Degree sexagesimal Meter Feet Zenith Horizontal Slope in percent Form (am/pm) Form (4 hours) Low Medium High ( refer to manual) Baud 6 Baud Baud 4 Baud 48 Baud 96 Baud None Odd Even CR CR/LF Internal Memory RS Poor Medium Strong [ cont.] 8

9 TPS <SET SPEC> FUNCTI <PARAMETER> SETTING 4) Laser plummet availibility 5 RS recording mask 6 Data transfer output format 7 RS format length 8 ) Quick code recording 49 Display MASK 6 Setting measured distance to invalid 7 Direction of horizontal circle reading (Hz-Angle) 77 Compensator 78 ) Hz compensator 79 ) Hz collimation [Tab.] No Yes Mask (,,,.) Mask (,., 8, 8, 8) Mask Mask Activates user format # Activates user format # ( refer to manual) GSI8 GSI6 Before measurement After measurement WI,,, WI,,, WI, 8, 8, 8 WI, 4,, 87 Set distance (WI,,) and coordinates (WI8,8,8) to invalid ) Clockwise Counterclockwise ( refer to manual) ( refer to manual) Example: Intended action: Change Display contrast to HIGH contrast Command: SET//<CR/LF> Response:? 9

10 TPS CF Syntax: CF/<CF SPEC><CR/LF> <CF SPEC> FUNCTI RESPSE CFIGURATI BEEP / / Display contrast / / / / Low contrast Medium contrast Medium to high contrast High contrast 4 9 4/ 4/ 4 Angle UNIT 4/ 4/ 4/ G Degree decimal Degree sexagesimal 4 Distance UNIT 4/ 4/ Meter Feet 44 V angle READING 44/ 44/ 44/ Zenith Horizontal Slope in percent 49 ) Time/Date format 49/ 49/ Form Form ( refer to manual) 5 Angle rounding 5/ 5/ 5/ low medium high 7 Baudrate 7/ 7/ 7/ 7/ 7/4 7/5 Baud 6 Baud Baud 4 Baud 48 Baud 96 Baud 7 Parity 7/ 7/ 7/ NE ODD EVEN 7 Terminator 7/ 7/ CR CR/LF 76 Data recording device 76/ 76/ Internal Memory RS 8 ) EGL activity 8/ 8/ 8 ) EGL intensity 8/ 8/ 8/ poor medium strong 9 Battery level 9/n N[=empty..9=full] 9 Instr. Temperature 9/nn nn<: Temp in C nn>: nn-55= temperature in - C [ cont.]

11 TPS <CF SPEC> FUNCTI RESPSE CFIGURATI 95 Auto 95/ 95/ 4) Laser plummet / / 4) Laser plummet / availability / 5 RS recording 5/ mask 5/ 6 Data transfer output 6/ format 6/ 6/ 6/ FORM/n Check format name; n:[..4] Format_ Format_n 7 RS format 7/ length 7/ 8 ) Quick code 8/ recording 8/ 49 Display MASK 49/ 49/ 49/ 49/ ) 6 Validity of measured 6/ distance 6/ 6 EDM measuring 6/ mode 6/ 7 Direction of horizontal 7/ circle reading 7/ (Hz-Angle) 77 Compensator 77/ 77/ 78 Hz compensator 78/ 78/ 79 Hz collimation 79/ 79/ 8 Instrument Series 8/4 8/6 8/8 8/9 8 Instrument Type 8/ 8/ Not available Available Mask (,,,.) Mask (,., 8, 8, 8) Mask Mask Activates user format # Activates user format # ( refer to manual) e.g. CF/FORM/ -> GSI GSI8 GSI6 Before measurement After measurement WI,,, WI,,, WI, 8, 8, 8 WI, 4,, 87 Invalid DIST Valid DIST IR Fine mode IR Rapid mode Clockwise Counterclockwise ) TC4 TC6/65 TC8/85 TC95 T (Theodolite) TC (Total Station) 8 Firmware version 8/7 e.g. Version.7 [Tab.]

12 TPS PUT Syntax: SET/<PUT SPEC>/<Parameter>_<CR/LF> <PUT SPEC> FUNCTI Access/Example Set Pointnumber PUT/.+4_<CR/LF> puts PtID 4 Hz Angle PUT/ n+_<cr/lf> n[..4]; angle units must be specified for n=; puts Hz=. gon 58 Prism const PUT/58.+_<CR/LF> puts reflector constant to mm 59 PPM PUT/59. +_<CR/LF> puts PPM correction to 84 Station Easting PUT/84 n+_<crlf> n[..]; distance unit must be specified for n=; puts Easting=. m 85 Station Northing PUT/85 n+_<crlf> n[..]; distance unit must be specified for n=; puts Northing=. m 86 Station Elevation PUT/86 n+45_<crlf> n[..]; distance unit must be specified for n=; puts Elevation= 45. m 87 Reflector height PUT/87 n+7_<crlf> n[..]; distance unit must be specified for n=; puts hr=.7 m 88 Instrument height PUT/88 n+5_<crlf> n[..]; distance unit must be specified for n=; puts hi=.5 m [Tab.4]

13 TPS GET Syntax: GET/n/WI<GET SPEC>/<Parameter><CR/LF> <GET SPEC> FUNCTI Access/Example Pointnumber GET/M/WI<CR/LF>; e.g..+h66 PtNo= H66 Hz Angle GET/M/WI<CR/LF>; e.g Hz gon Vertical Angle GET/M/WI<CR/LF>; e.g V: gon Slope distance GET/M/WI<CR/LF>; e.g Sdist:.87 m Horizontal distance GET/M/WI<CR/LF>; e.g Hdist:.98 m Height difference GET/M/WI<CR/LF>; e.g PPM and Prism constant Hdiff:.9 m GET/I/WI5; e.g PPM and Prism const mm 58 Prism constant GET/I/WI58; e.g Prism mm 59 PPM GET/I/WI59; e.g Target Easting (E) PPM GET/M/WI8; e.g E: m 8 Target Northing (N) GET/M/WI8; e.g Target Elevation (H) 84 Station Easting (E) 85 Station Northing (N) 86 Station Height (H) 87 Reflector height (hr) 88 Instrument height (hi) N: m GET/M/WI8; e.g H:.88 m GET/I/WI84; e.g E: 9.7 m GET/I/WI85; e.g N: 656. m GET/I/WI86; e.g H: m GET/I/WI87; e.g hr:.7 m GET/I/WI88; e.g hi:.55 m GETDATE ) read date GETDATE; (dd:mm:yy) 7// GETTIME ) read time GETTIME; (hh:mm:ss) [Tab.5] 4:6:58p

14 TPS Remote Stake Out The TCx5 series support a remote set-out method for surveyors using handheld or external recording devices. Stake out data can be transferred from via RS interface to the instrument s onboard Remote Stake Out application. The following procedure describes a possible way for successful field stake out. [Note: _ represents a space character] Remote Set Station Start Remote S/O SETOUT<CR/LF> Calls onbard S/O Set Station Pointnumber PUT/6.+S7_<CRLF> e.g. S7 Set Station Easting PUT/84 +_<CRLF> e.g.. [m] Set Station Northing PUT/85 +_<CRLF> e.g.. [m] SetStation Height PUT/86 +5_<CRLF> e.g. 5. [m] Set Instrument Height PUT/88 +5_<CRLF> e.g..5 [m] Remote Set Orientation Set Hz-Orientation PUT/ +_<CRLF> e.g.. gon (respectively Hz=) Remote Target Point setting out Set Target Pointnumber PUT/.+S7_<CRLF> e.g. S7 Set stakeout bearing PUT/4 +_<CRLF> e.g.. [m] Set stakeout distance PUT/4 +_<CRLF> e.g.. [m] Set stakeout height PUT/8 +5_<CRLF> e.g. 5. [m] Set Reflector height PUT/87.+5_<CRLF> e.g..5 [m] Release DIST or ALL key to measure a distance Terminating remote S/O X<CR/LF> Quits remote S/O For further information, please refer to the corresponding instrument manual. Refer also to Basic Knowledge BK99/44. 4

15 TPS Warnings/Errors Message ID Meaning Possible Instrument busy Any other device is still interfacing the instrument; check interfacing Invalid command The string sent to the TC could not be decoded properly or does not exist; check the syntax, or Input buffer overflow (max. EDM error The EDM could not proceed the requested measurement; no or weak signal; Check EDM mode and One of the instruments sensor corrections could not be assigned. Instrument is not stable or levelled; Tilt is out of range (e.g. when tilt sensor is out of Value out of range Check parameter Invalid Value No valid value; Check parameter Battery low Low Battery; check Invalid command No valid command; check the Initialisation error Contact Temperature out of range Refer to manual for temperature Parity error Wrong parity set; check Com-Port RS time-out The instrument was waiting for a response for the last RS overflow RS overflow; check Com-Port Compensator error Inclination Error; check instrument setup or switch of the EDM intensity Weak signal; target is most likely outside the field of EDM system error One of the instruments sensor corrections could not be assigned. General hardware error Instrument is not stable, not levelled or suffering of vibration; Tilt is out of range (e.g. when tilt sensor is out of range); Level instrument or switch off compensator Contact Initialization error Contact service [Tab.6] 5

16 TPS/7 TPS/7 Series The TPS and TPS7 series were introduced in 998/99. Featuring the latest generation technology, these instruments have further increased their interfacing capabilities. Considering the new firmware and application platform, lots of new commands have been added or existing commands being changed compared to its predecessors, the TPS Total Stations. However, basic functions use the same commands and therefore most of the existing TPS interfacing applications will still support the new TPS/7 series. Supported Instruments: TC, TC, TC5, TC7 TCR, TCR, TCR5, TCR7 TC7, TC7, TC75 TCR7, TCR7, TCR75 The following command listing is split into separate sections for each basic command (SET, CF, PUT, GET). Some of the listed features may require specially equipped instruments (e.g. Reflectorless EDM RL). For detailed description of single functions, we recommend to consult the corresponding User Manual. Low Level commands SYNTAX: <command>cr/lf SYNTAX: BEEP/<value> <Command>: <Value>: a b c BEEP/ BEEP/ BEEP/ Powers on the instrument Powers off the instrument Clears a distance measurement Short beep Long beep Alarm beep (short beep, times) Restrictions: ) TCR models LY ) Instruments equipped with EGL only 6

17 TPS/7 SET Syntax: SET/<SET SPEC>/<Parameter><CR/LF> <SET SPEC> FUNCTI <PARAMETER> SETTING BEEP Display illumination Display contrast [..] ) EGL activity 6 ) Laser Pointer 4 Angle UNIT 4 4 Distance UNIT 4 4 Temperature UNIT 4 Pressure UNIT Angle; displayed decimals 4 Medium Loud Low Medium High [range] Low contrast Medium contrast High contrast Low Medium High G Degree decimal Degree sexagesimal Mils radiant Meter US Feet, decimal Intl. Feet, decimal US Feet/Inch Intl. Feet/Inch Degree Celcius Degree Fahrenheit hpa MmHg Mbar PSI InchHg Atm Torr,,n,nn,nnn,nnnn [ cont.] 7

18 TPS/7 <SET SPEC> FUNCTI <PARAMETER> SETTING 5 Distance; displayed decimals 4,,n,nn,nnn,nnn(n) 55 Angle rounding [..] e.g. n=:.,.6,.9, 55 Distance rounding [..] e.g. n=:.,.6,.9, 7 Baudrate Parity 7 Terminator 75 Protocol 76 Data recording device Baud 6 Baud Baud 4 Baud 48 Baud 96 Baud 9 Baud None Odd Even CR CR/LF On Internal Memory RS 78 Timeout delay [..5] Increase of ms/unit 95 Auto On Sleep mode Laser plummet On 4 Laser plummet pulse rate 5 Laser plummet intensity [..] [..] [range] permanent High pulse rate [range] Low bright On Face I Face II 6 Display heat Orientation face definition 5 Recording mask [..8] [range] ( refer to manual) 6 Output format [..7] [range] number ( refer to manual) 7 RS format GSI8 length GSI6 [ cont.] 8

19 TPS/7 <SET SPEC> FUNCTI <PARAMETER> SETTING 8 Quick code recording 6 Setting measured distance to invalid 6 EDM modes (SET/6/n) 7 Direction of horizontal circle reading (Hz-Angle) 7 Compensator 78 Standing axis correction 79 Hz collimation [Tab.7] Before measurement After measurement Setting WI,, and coordinates WI8,8,8 to invalid; (CT variables only; contact a TPS product manager) IR Standard IR Fast n.a. n.a. 4 n.a. 5 IR Tracking 6 ) RL Long (with prisms) 7 ) RL Short 8 n.a. 9 ) RL Tracking IR Tape Clockwise Counterclockwise (-Axis) (-Axis) ( refer to manual) ( refer to manual) 9

20 TPS/7 CF Syntax: CF/<CF SPEC><CR/LF> <CF SPEC> FUNCTI RESPSE CFIGURATI BEEP / / / Display illumination / / / / Normal Loud Low Medium High Display contrast /nnn n:[..] : lowest contrast 5: Medium contrast : Highest contrast 4 9 4/ 4/ On 5 ) EGL activity 5/ 5/ 5/ 5/ 6 ) Laser Pointer 6/ 6/ 4 Angle UNIT 4/ 4/ 4/ 4/ 4/4 4 Distance UNIT 4/ 4/ 4/ 4/ 4/4 4 Temperature UNIT 4/ 4/ 4 Pressure UNIT 4/ 4/ 4/ 4/ 4/4 4/5 4/6 5 Angle; displayed decimals [ cont.] 5/ 5/ 5/ 5/ 5/4 Low Medium High On Gon Degree decimal Degree sexagesimal Mil Radiant Meter US Feet, decimal Intl. Feet, decimal US Feet/Inch Intl. Feet/Inch Degree Celcius Degree Fahrenheit hpa mmhg mbar PSI InchHg Atm Torr,,n,nn,nnn,nnnn

21 TPS/7 <CF SPEC> FUNCTI RESPSE CFIGURATI 5 Distance; displayed decimals 5/ 5/ 5/ 5/ 5/4,,n,nn,nnn,nnn(n) 55 Angle rounding 55/nn N:[..] 56 Distance rounding 56/nn N:[..] 7 Baudrate 7/ 7/ 7/ 7/ 7/4 7/5 7/6 7 Parity 7/ 7/ 7/ 7 Terminator 7/ 7/ 75 Protocol 75/ 75/ 76 Data recording 76/ device 76/ Baud 6 Baud Baud 4 Baud 48 Baud 96 Baud 9 Baud NE ODD EVEN CR CR/LF On Internal Memory RS 78 Timeout delay [..5] Increase of ms/unit 9 Battery level 9/nn n:[..] : Empty : Full 9 Temperature 9/nnn [..±] C 95 Auto- 95/ 95/ On Laser plummet / / On Laser plummet availability / / Not available Available 4 Laser plummet pulse rate 5 Laser plummet intensity 6 Display heat 6/ Orientation face definition [ cont.] 4/nnn N: [..] : Permanent : High pulse rate 5/nnn N: [..] : Low : bright 6/ On / / Face I Face II

22 TPS/7 <CF SPEC> FUNCTI RESPSE CFIGURATI Orientation face status (face of last measurement) 5 RS recording mask 6 Output format number 7 RS recording length 8 Quick code recording / / 5/n N: [..8] Face I Face II ( refer to manual) 6/nnn n: [..7] 7/ 7/ GSI8 GSI6 8/ 8/ 8 Display MASK 8/n N: [..8] 6 Validity of measured 6/ Distance invalid distance 6/ Distance valid 6 EDM modes (SET/6/n) 6/ 6/ 6/5 6/6 ) 6/7 ) 6/9 ) 6/ 7 Detect current face 7/ 7/ 7 Direction of horizontal circle reading (Hz-Angle) 7/ 7/ 7 Compensator 7/ 7/ 78 Standing axis correction 78/ 78/ 79 Hz collimation 79/ 79/ [Tab.8] Before measurement After measurement IR Standard IR Fast IR Tracking RL Long (with prisms) RL Short RL Tracking IR Tape Face I Face II ( refer to manual) Clockwise Counterclockwise (-Axis) (-Axis) ( refer to manual) ( refer to manual)

23 TPS/7 PUT Syntax: SET/<PUT SPEC>/<Parameter>_<CR/LF> <PUT SPEC> FUNCTI Access/Example Set Pointnumber PUT/.+4_<CR/LF> puts PtID 4 6 Station Pointnumber PUT/6...+A_<CR/LF> puts StNr A Hz Angle PUT/ n+_<cr/lf> n[..4]; angle units must be specified for n=; puts Hz=. gon 4 Code-Block ID PUT/4...+TREE_<CR/LF> puts code value TREE 4 Information PUT/ _<CR/LF> puts info value.4 4 Information PUT/4...+CAT_<CR/LF> puts info value CAT 44 Information PUT/44...+NN_<CR/LF> puts info value NN 45 Information 4 PUT/45...+NN_<CR/LF> puts info value NN 46 Information 5 PUT/46...+NN_<CR/LF> puts info value NN 47 Information 6 PUT/47...+NN_<CR/LF> puts info value NN 48 Information 7 PUT/48...+NN_<CR/LF> puts info value NN 49 Information 8 PUT/49...+NN_<CR/LF> puts info value NN 58 Prism const PUT/58.+_<CR/LF> puts reflector constant to mm 59 PPM PUT/59. +_<CR/LF> puts PPM correction to 84 Station Easting PUT/84 n+_<crlf> n[..]; distance unit must be specified for n=; puts Easting=. m 85 Station Northing PUT/85 n+_<crlf> n[..]; distance unit must be specified for n=; puts Northing=. m 86 Station Elevation PUT/86 n+45_<crlf> n[..]; distance unit must be specified for n=; puts Elevation= 45. m 87 Reflector height PUT/87 n+7_<crlf> [ cont.] n[..]; distance unit must be specified for n=; puts hr=.7 m

24 TPS/7 <PUT SPEC> FUNCTI Access/Example 88 Instrument height PUT/88 n+5_<crlf> n[..]; distance unit must be specified for n=; puts hi=.5 m 56 Time: [hh.mm.ss] PUT/ _<CRLF> ::59 56 Date: [mm.dd] PUT / _<CRLF> February 8 th 56 Year: [yyyy] PUT/56...+_<CRLF> year 9 Station Pointnumber [Tab.9] PUT/9...+ST5_<CRLF> puts Station PtID ST5 4

25 TPS/7 GET Syntax: GET/n/WI<GET SPEC>/<Parameter><CR/LF> <GET SPEC> FUNCTI Access/Example Pointnumber GET/M/WI<CR/LF>; e.g..+h66 PtNo= H66 Serial number GET/I/WI<CR/LF>; e.g S.No Instrument type GET/I/WI<CR/LF>;...+TCR5 Instr. TCR5 6 Station Pointnumber GET/I/WI6; e.g St.No. 7 Date [DD.MM.YYYY] GET/I/WI7; e.g Feb. 8 th 9 Time [MM.DD.hh.mm] GET/I/WI9; e.g Feb. 8 th ; :9 Horizontal Angle GET/M/WI<CR/LF>; e.g Hz gon Vertical Angle GET/M/WI<CR/LF>; e.g V: gon Slope distance GET/M/WI<CR/LF>; e-g Sdist:.87 m Horizontal distance GET/M/WI<CR/LF>; e.g Hdist:.98 m Height difference GET/M/WI<CR/LF>; e.g...+9 Hdiff:.9 m 4 Code-Block ID GET/I/WI4<CR/LF>; e.g Code: m 4 Information GET/I/WI4<CR/LF>; e.g TREES Info: TREES 4 Information GET/I/WI4<CR/LF>; e.g Info: Information GET/I/WI44<CR/LF>; e.g CAT. Info: CAT. 45 Information 4 GET/I/WI45<CR/LF>; e.g NN Info4: NN 46 Information 5 GET/I/WI46<CR/LF>; e.g NN Info5: NN 47 Information 6 GET/I/WI47<CR/LF>; e.g NN Info6: NN 48 Information 7 GET/I/WI48<CR/LF>; e.g NN Info7: NN 49 Information 8 GET/I/WI49<CR/LF>; e.g NN Info8: NN 58 Prism constant GET/I/WI58; e.g Prism mm 59 PPM GET/I/WI59; e.g PPM [ cont.] 5

26 TPS/7 <GET SPEC> FUNCTI Access/Example 8 Target Easting (E) GET/M/WI8; e.g E: m 8 Target Northing (N) GET/M/WI8; e.g Target Elevation (H) N: 9.59 m GET/M/WI8; e.g H:.88 m 84 Station Easting (E) GET/I/WI84; e.g Station Northing (N) E: 9.7 m GET/I/WI85; e.g N: 656. m 86 Station Height (H) GET/I/WI86; e.g H: m 87 Reflector height (hr) GET/I/WI87; e.g Instrument height (hi) hr:.7 m GET/I/WI88; e.g hi:.55 m 5 Atmos. correction: pressure GET/I/WI5; e.g Coefficient of refraction GET/I/WI58; e.g Time: [hh.mm.ss] GET/I/WI56; e.g :5:8 56 Date: [mm.dd] GET/I/WI56; e.g Year: [yyyy] GET/I/WI56; e.g year 59 SW-Version: Application GET/I/WI59; e.g V. 59 SW-Version: Operating system GET/I/WI59; e.g V. 59 SW-Version: OS interface GET/I/WI59; e.g V. 59 SW-Version: GEOCOM GET/I/WI59; e.g V. 594 SW-Version: Gsi communication GET/I/WI594; e.g V. 595 SW-Version: Edm Device GET/I/WI595; e.g V. 9 Job GET/I/WI9; e.g BLDG.A BLDG.A 94 Operator GET/I/WI94; e.g MM-59 MM-59 [Tab.] 6

27 TPS/7 Warnings/Errors Message ID Meaning Possible Instrument busy Any other device is still interfacing the instrument; check interfacing Invalid command The string sent to the TC could not be decoded properly or does not exist; check the syntax, or Input buffer overflow (max. EDM error The EDM could not proceed the requested measurement; no or weak signal; Check EDM mode and [Tab.] One of the instruments sensor corrections could not be assigned. Instrument is not stable, not levelled or suffering of vibration; Tilt is out of range (e.g. when tilt sensor is out of range); Level instrument or switch off compensator 7

28 TPS/ TPS/ Series The TPS and its successor TPS series represent the very high end level of Leica s Total Station products. Functionality has increased and instruments do more and more support customized remote control options. Thus controlling instruments with GSI commands has come to a technical limit. However, to provide access to all implemented functions, a new interfacing tool has been developed, called GEOBASIC. As GEOBASIC will not be covered within this reference guide, we kindly ask you to consult the corresponding GEOBASIC USER MANUAL, for further information on GEOBASIC. You will find the manual on every CD-ROM s delivered with TPS Total Stations. Following, the complete set of GSI LINE commands providing access to TPS/ GSI functions. Supported Instruments (TPS Series) TC/L, TC5/L, TC7/L, TC8/L TCM/L, TCM8/L TCA/L, TCA8/L Supported Instruments (TPS Series) TC, TC, TC, TC5 TCR, TCR, TCR, TCR5 TCM, TCM, TCM, TCM5 TCRM, TCRM, TCRM, TCRM5 TCA, TCA, TCA, TCA5 TCRA, TCRA, TCRA, TCRA5 For standard recording, the instrument needs to be activated in any Measure&Record mode. To avoid unnecessary miscommunication, we therefore recommend to enable the autostart function for remote control applications. Low Level commands SYNTAX: <command>cr/lf SYNTAX: BEEP/<value> <Commands>: Example: a b c BEEP/ BEEP/ BEEP/ Powers on the instrument Powers off the instrument Clears a distance measurement Short beep Long beep Alarm beep (TPS series only!) 8

29 TPS/ SET Syntax: SET/<SET SPEC>/<Parameter><CR/LF> <SET SPEC> FUNCTI <PARAMETER> SETTING BEEP Display (DSP) and Crosshairs (X-hairs)- illumination Display contrast 5 EGL 4 Angle UNIT 4 Distance UNIT 4 4 Temperature UNIT 4 Pressure UNIT 4 5 Angle; displayed decimals 5 Distance; displayed decimals Parity 7 Terminator Medium Loud DSP on, X-hairs low DSP on, X-hairs medium DSP on, X-hairs bright Low Low-Medium Medium-High High On Gon Degree decimal Degree, sexagesimal Mils Meter US Feet, decimal Intl. Feet, decimal US Feet/Inch Intl. Feet/Inch C F hpa mmhg mbar PSI inchhg...4 or max. accuracy None Odd Even CR CR/LF [ cont.] 9

30 TPS/ <SET SPEC> FUNCTI <PARAMETER> SETTING 75 Protocol Without GSI 76 Data recording device Memory card RS interface 95 Auto On 7 RS format length GSI8 GSI6 6 Setting measured distance to invalid Setting WI,, and coordinates WI8,8,8 to invalid 6 EDM modes (SET/6/n) Compensator [Tab.] IR Standard IR Fast IR Average IR Precise ) /Standard ) IR Tracking IR Rapid tracking RL Stand. long range ) RL Standard ) RL Tracking ) IR Tape ) RL Average long range ) RL Average ) On ) TPS only ) TPS only

31 TPS/ CF Syntax: CF/<CF SPEC><CR/LF> <CF SPEC> FUNCTI RESPSE CFIGURATI BEEP / / / Display (DSP) and Crosshairs (X-hairs)- illumination / / / / Display contrast / / / / 5 EGL 5/ 5/ 4 Angle UNIT 4/ 4/ 4/ 4/ 4 Distance UNIT 4/ 4/ 4/ 4/ 4/4 4 Temperature UNIT 4/ 4/ 4 Pressure UNIT 4/ 4/ 4/ 4/ 4/4 5 Angle; displayed decimals 5 Distance; displayed decimals 5/ 5/ 5/4 5/ 5/ 5/ 5/ 5/4 7 Baudrate 7/ 7/4 7/5 7/6 Medium Loud DSP on, X-hairs low DSP on, X-hairs medium DSP on, X-hairs bright Low Low-Medium Medium-High High On Gon Degree decimal Degree, minute, second Mil Meter US Feet, decimal Intl. Feet, decimal US Feet/Inch Intl. Feet/Inch C F hpa mmhg mbar PSI InchHg...4 or max. accuracy or max. accuracy 4 Baud 48 Baud 96 Baud 9 Baud [ cont.]

32 TPS/ <CF SPEC> FUNCTI RESPSE CFIGURATI 7 Parity 7/ 7/ 7/ 7 Terminator 7/ 7/ 75 Protocol 75/ 75/ 76 Data recording 76/ device 76/ None Odd Even CR CR/LF Without GSI Memory card Serial interface 9 Battery level 9/n N:[..9]; n=: low 95 Auto 95/ 95/ 95/ On Sleep 5 Recording mask 5/ Mask 7 RS format length 7/ 7/ GSI8 GSI6 49 Display MASK 49/ Mask 6 Validity of measured distance 6/ 6/ Distance/Coords invalid Distance/Coords valid 6 EDM modes (SET/6/n) 6/ 6/ 6/ 6/ 6/4 6/5 6/6 6/7 6/9 6/ 6/ 6/ 7 Detect current face 7/ 7/ 7 Direction of horizontal circle reading (Hz-Angle) 7/ 7/ IR Standard IR Fast IR Average IR Precise ) /Standard ) IR Tracking IR Rapid tracking RL Stand. long range ) RL Standard ) RL Tracking ) IR Tape ) RL Average long range ) RL Average ) Face I Face II ( refer to manual) Clockwise Counterclockwise 7 Compensator 7/ 7/ 8 Software version 8/nn Version n.n 84 Active application running 84/ 84/ No Yes [Tab.]

33 TPS/ PUT Syntax: SET/<PUT SPEC>/<Parameter>_<CR/LF> <PUT SPEC> FUNCTI Access/Example Set Pointnumber PUT/.+4_<CR/LF> puts PtID 4 Hz Angle PUT/ n+_<cr/lf> n[..4]; angle units must be specified for n=; puts Hz=. gon 58 Prism const PUT/58.+_<CR/LF> puts reflector constant to mm 59 PPM PUT/59. +_<CR/LF> puts PPM correction to 7 Remark (or Attribute ) PUT/ _<CR/LF> puts info value.4 7 Remark (or Attribute ) PUT/7...+CAT_<CR/LF> puts info value CAT 7 Remark (or Attribute ) PUT/7...+NN_<CR/LF> puts info value NN 74 Remark 4 (or Attribute 4) PUT/74...+NN_<CR/LF> puts info value NN 75 Remark 5 (or Attribute 5) PUT/78...+NN_<CR/LF> puts info value NN 76 Remark 6 (or Attribute 6) PUT/76...+NN_<CR/LF> puts info value NN 77 Remark 7 (or Attribute 7) PUT/77...+NN_<CR/LF> puts info value NN 78 Remark 8 (or Attribute 8) PUT/78...+NN_<CR/LF> puts info value NN 79 Remark 9 (or Attribute 9) PUT/79...+NN_<CR/LF> puts info value NN 84 a) Station Easting PUT/84 n+_<crlf> for n=; puts Easting=. m 85 a) Station Northing PUT/85 n+_<crlf> for n=; puts Northing=. m 86 a) Station Elevation PUT/86 n+45_<crlf> for n=; puts Elevation= 45. m 87 a) Reflector height PUT/87 n+7_<crlf> for n=; puts hr=.7 m 88 a) Instrument height PUT/88 n+5_<crlf> [Tab.4] for n=; puts hi=.5 m a) For WI84-88; distance unit must be specified with n[..]; please refer to page 5.

34 TPS/ GET Syntax: GET/n/WI<GET SPEC>/<Parameter><CR/LF> <GET SPEC> FUNCTI Access/Example Pointnumber GET/M/WI<CR/LF>; e.g..+h66 PtNo= H66 Serial number GET/I/WI<CR/LF>; e.g S.No Instrument type GET/I/WI<CR/LF>;...+TCR5 Instr. TCR5 9 Time [MM.DD.hh.mm] GET/I/WI9; e.g Feb. 8 th ; :9 Horizontal Angle GET/M/WI<CR/LF>; e.g Hz gon Vertical Angle GET/M/WI<CR/LF>; e.g V: gon Slope distance GET/M/WI<CR/LF>; e-g Sdist:.87 m Horizontal distance GET/M/WI<CR/LF>; e.g Hdist:.98 m Height difference GET/M/WI<CR/LF>; e.g...+9 Hdiff:.9 m 4 Code-Block ID GET/I/WI4<CR/LF>; e.g Code: m 4 Information GET/I/WI4<CR/LF>; e.g TREES Info: TREES 4 Information GET/I/WI4<CR/LF>; e.g Info: Information GET/I/WI44<CR/LF>; e.g CAT. Info: CAT. 45 Information 4 GET/I/WI45<CR/LF>; e.g NN Info4: NN 46 Information 5 GET/I/WI46<CR/LF>; e.g NN Info5: NN 47 Information 6 GET/I/WI47<CR/LF>; e.g NN Info6: NN 48 Information 7 GET/I/WI48<CR/LF>; e.g NN Info7: NN 49 Information 8 GET/I/WI49<CR/LF>; e.g NN Info8: NN 5 PPM/mm GET/I/WI5<CR/LF>; e.g ppm; 4 mm 58 Prism constant GET/I/WI58; e.g Prism mm 59 PPM GET/I/WI59; e.g [ cont.] PPM 4

35 TPS/ <GET SPEC> FUNCTI Access/Example 7 Remark (or Attribute ) 7 Remark (or Attribute ) 7 Remark (or Attribute ) 74 Remark4 (or Attribute 4) 75 Remark5 (or Attribute 5) 76 Remark6 (or Attribute 6) 77 Remark7 (or Attribute 7) 78 Remark8 (or Attribute 8) 79 Remark9 (or Attribute 9) 8 Target Easting (E) 8 Target Northing (N) 8 Target Elevation (H) 84 Station Easting (E) 85 Station Northing (N) 86 Station Height (H) 87 Reflector height (hr) 88 Instrument height (hi) GET/I/WI7<CR/LF>; e.g REM REM GET/I/WI7<CR/LF>; e.g REM REM GET/I/WI7<CR/LF>; e.g REM REM GET/I/WI74<CR/LF>; e.g REM4 REM4 GET/I/WI75<CR/LF>; e.g REM5 REM5 GET/I/WI76<CR/LF>; e.g REM6 REM6 GET/I/WI77<CR/LF>; e.g REM7 REM7 GET/I/WI78<CR/LF>; e.g REM8 REM8 GET/I/WI79<CR/LF>; e.g REM9 REM9 GET/M/WI8; e.g E: m GET/M/WI8; e.g N: 9.59 m GET/M/WI8; e.g H:.88 m GET/I/WI84; e.g E: 9.7 m GET/I/WI85; e.g N: 656. m GET/I/WI86; e.g H: m GET/I/WI87; e.g hr:.7 m GET/I/WI88; e.g hi:.55 m [Tab.5] 5

36 TPS/ Telescope positioning (TM, TCM and TCA models only) Command PASSWORD CFACE POSIT/<spec>Hz/V List of <spec> A R P S Function Allows the use of the following commands. It must be sent at least once after the instrument is switched on Turns the telescope to the opposite face Turns the telescope to the given direction horizontally and vertically. Hz and V are given in the unit set in the instruments Absout positioning to the giben values Relative positioning from the current position Turn the telescope to the direction of the last distance measurement Search for a reflector in the giben range from the Current positon (only valid for TCA) Example: POSIT/A/.4567/ Turns the telescope to the circle reading.4567 gon Hz and gon Vertical. POSIT/R// POSIT/P//- POSIT/S// Turns the telescope units clockwise. Tuns to the last position where a distance has been measured with gon offset horizontal and vertical. Searches for a reflector in the range of gons Horizontal and vertical. 6

37 TPS/ Warnings/Errors Errors, initiated by an interface command are not always transferred to the interface. Instead of the error message the will be sent and the TPS will be ready to receive the next command. Message ID Meaning Possible Instrument busy Any other device is still interfacing the instrument; check interfacing Invalid command The string sent to the TC could not be decoded properly or does not exist; check the syntax, or Input buffer overflow (max. Battery low Low Battery; check Initialization error Contact Temperature out of range Refer to manual for temperature EDM error The EDM could not proceed the requested measurement; no or weak signal; Check EDM mode and V or Hz collimation Check calibration data Angle error Call One of the instruments sensor corrections could not be assigned. Instrument is not stable, not levelled or suffering of vibration; Tilt is out of range (e.g. when tilt sensor is out of range); Level instrument or switch off Telescope position out of range Positioning timeout; Instrument could not position; Try General motorisation If frequently occurs call service Data error Check record General error If frequently occurs call ATR error ATR not enabled; check ATR function [Tab.6] 7

38 Illustrations, descriptions and technical data are not binding and may be changed. Printed in Switzerland. Copyright Leica Geosystems AG, Heerbrugg, Switzerland, en VI. INT Geosystems