Leica TPS1200+ & TM30全站仪GeoCOM英文版1.5：功能与编程详解

5星 · 超过95%的资源需积分: 46 31 浏览量更新于2024-07-28 2 收藏 1.42MB PDF 举报

本资源是Leica TPS1200全站仪与TM30系列的GeoCOM说明书英文版v1.5，主要针对TPS1200系统的软件操作和GeoCOM（Geodetic Control）功能进行详细解释。GeoCOM是一种用于精确测量和定位的技术，它允许用户通过计算机程序与全站仪进行通信，执行各种测量任务。 1. **介绍**：章节1.1简要介绍了GeoCOM的概念，包括其在TPS1200系统中的应用，强调了其在地理空间数据采集和控制中的作用。章节1.2重点讲解了TPS1200系统的软件，可能涉及安装、配置和基本操作。 2. **通用概念与操作**：章节2详细阐述了GeoCOM的通用操作原理和协议。2.1介绍了使用GeoCOM的基本理念，2.2讲解了ASCII和函数调用（C/C++和VBA）这两种常见的通信协议，使得开发者能够理解如何编写与全站仪交互的代码。 3. **编程基础**：章节3深入到编程层面，包括对ASCII协议、C/C++和VBA编程方法的指导，以及值的单位和全站仪工作模式的介绍。这部分内容对于开发基于GeoCOM的应用程序至关重要，帮助用户确保程序的兼容性和效率。 4. **描述结构与注意事项**：在4.1中，给出了描述文档的结构和组织方式，有助于用户快速找到所需的信息。4.1还可能提到了一些在编写文档时需要注意的细节和规范。 5. **通信设置**：章节5详细说明了如何设置和管理与全站仪的通信，包括通用的GeoCOM功能和特定于客户端的功能，以及如何处理可能出现的通信错误。 6. **两个具体应用示例**：章节6和7分别关注AltUser-AUS38和Automation-AUT43，提供具体的使用指南、常量类型和功能列表，可能是为了演示如何在自动化场景下更高效地利用GeoCOM功能。 7. **基本应用程序示例**：章节8则展示了BASICAPPLICATIONS-BAP，这可能是集成GeoCOM技术的一些实用案例或模板，以供用户参考和学习。这份说明书为开发者提供了全面的GeoCOM操作指南，涵盖了从理论概念到实际编程的方方面面，有助于用户充分利用Leica TPS1200全站仪的GeoCOM功能来提升测量工作的精确度和效率。无论是初学者还是经验丰富的开发者，都能从中找到所需的信息。

GeoCOM Reference Manual Fundamentals of Programming GeoCOM

Leica TPS1200 / TS30 / TM30 – Version 1.50 16

Dim s As String

' initialise string

s = Space(255)

Call VB_COM_GetErrorText(GRC_IVPARAM, s)

' trim string, justify string length

s = Trim$(s)

Note: Incorrectly handled string output parameters may lead to severe runtime problems.

3.5 UNITS OF VALUES

All parameters are based on the SI unit definition, if not explicitly indicated differently. The SI units, and their

derivatives, used are:

Abbreviation

Unit Description

M ( Meters ) for lengths, co-ordinates, ...

Rad ( Radians ) for angles

Sec ( Seconds ) for time

Hpa ( Hekto Pascal ) for pressure

C (Celsius ) for temperature

Table 3-2: SI Units

3.6 TPS1200 INSTRUMENT MODES OF OPERATION

In respect to communication, the TPS1200 instrument knows several states in which it reacts differently. The main state

for GeoCOM is online state or mode. There it is possible to use all RPC’s, which are described in this manual.

Especially we will describe the possibilities of changing the state by the built-in RPC’s. For the ASCII protocol refer to

section 3.2.3 - Modes of Operation Concerning Communication.

The possible states can be described as follows:

Off The instrument is switched off and can be switched on using

COM_OpenConnection. To switch on the

instrument a single character is sufficient.

GeoCOM The instrument accepts RPC’s. To switch into GeoCOM mode start the “Configuration” menu on the

instrument, open the submenu “Interfaces” and enable interface “GeoCOM Mode”.

RCS The instrument accepts Remote Control sequences.

3.7 COMMON COMMUNICATION ERRORS

GeoCOM is based on calling functions remotely. Because of the additional communication layer the set of return codes

increases with return codes based on communication errors. Since all of these codes may be returned by any RPC we

will explain them here and omit them in the descriptions of the RPC’s.

Return-Code Value Description

GRC_OK

0 Successful termination, implies also no communication error.

GRC_COM_CANT_ENCODE

3073 Can't encode arguments in client. Returned by the client to the

calling application directly, i.e. without anything being sent to

the transport layer and beyond.

GRC_COM_CANT_DECODE

3074 Can't decode results in client. Once an RPC has been sent to

the server and a reply has been sent back, this return code

states that the encoded reply could not be decoded in the

client. This is usually the result of using different versions of

GeoCOM on client and server.

GRC_COM_CANT_SEND

3075 Failure in sending calls. If the resources at the transmitting

port have been allocated previously, i.e. GeoCOM does not

have exclusive rights to the port, or if the exception or similar

routine has experienced a failure, this error code is returned.

GeoCOM Reference Manual Fundamentals of Programming GeoCOM

Leica TPS1200 / TS30 / TM30 – Version 1.50 17

Return-Code Value Description

GRC_COM_CANT_RECV

3076 Failure in receiving result. A failure has occurred during

reception of a packet at the data link layer. This could be due

to incorrect parameter settings or noise on the line, etc..

GRC_COM_TIMEDOUT

3077 Call timed out. The client has sent an RPC to the server but it

has not replied within the current time-out period as set for the

current transaction. This could be because: the server has not

received the request; the server has taken too long to execute

the request; the client has not received the reply; the

communication line (physical layer is no longer there; or, the

time-out is too short (especially true when communicating

over noisy or radio links at low baud rates).

GRC_COM_WRONG_FORMAT

3078 The request and receive formats are different. Something got

mixed up along the way or the application tried to send using a

format, which has not been implemented on both client and

server.

GRC_COM_VER_MISMATCH

3079 RPC protocol mismatch error. An RPC protocol has been

requested which does not exist. This error will indicate

incompatible client and server protocols.

GRC_COM_CANT_DECODE_REQ

3080 Can't decode request in server. If the client sends the server an

RPC but one, which cannot be decoded in the server, the

server replies with this error. It could be that the GeoCOM

versions running on the client and server are different or the

packet was not correctly sent over a noisy or unreliable line.

GRC_COM_PROC_UNAVAIL

3081 The requested procedure is unavailable in the server. An

attempt has been made to call an RPC, which does not exist.

This is usually caused when calling RPC’s, which have been

inserted, appended, deleted, or altered between the differing

versions of GeoCOM on client and server. To be on the safe

side, always use the same GeoCOM version whenever

possible on both sides.

GRC_COM_CANT_ENCODE_REP

3082 Can't encode reply in server. The server has attempted to

encode the reply but has failed. This can be caused by the

calling procedure trying to pass too much data back to the

client and in so doing has exceeded the maximum packet

length.

GRC_COM_SYSTEM_ERR

3083 Communication hardware error

GRC_COM_FAILED

3085 Mess into communication itself. Should be OK once the node

has been recycled, i.e. powered-down and -up again.

GRC_COM_NO_BINARY

3086 Unknown protocol. An unknown (or not yet supported)

Transport or Network protocol has been used. Could appear

when using differing GeoCOM versions on client and server.

GRC_COM_INTR

3087 Call interrupted. Something has happened outside of the scope

of GeoCOM, which has forced the current RPC to abort itself.

GRC_COM_REQUIRES_8DBITS

3090 This error indicates desired protocol requires 8 data bits

GRC_COM_TR_ID_MISMATCH

3093 Request and reply transaction ids do not match. Somewhere

along the line a packet (usually a reply) has been lost or

delayed. GeoCOM tries to bring everything back to order but

if this error continues during the session it may be wise to

inspect the line and, at least, to restart the session. The

immediately following RPC may be lost.

GRC_COM_NOT_GEOCOM

3094 Parse failed; data package not recognised as GeoCOM

communication package

GRC_COM_UNKNOWN_PORT

3095 Tried to access an unknown hardware port. The application

has not taken the physical resources of the machine on which

it is running into account.

GeoCOM Reference Manual Remarks on the Description

Leica TPS1200 / TS30 / TM30 – Version 1.50 19

4 REMARKS ON THE DESCRIPTION

This chapter contains some remarks on the description of RPC’s and on the structure of the descriptions.

4.1 STRUCTURE OF DESCRIPTIONS

The whole reference part is subdivided into sections. Each section contains descriptions of a set of functions, which

build up a subsystem. A subsystem gathers all functions, which are related to a specific functionality of a TPS1200

instrument, e.g. MOT describes all functions, which relate to motorization. Each subsystem is subdivided into the

descriptions of RPC’s.

4.1.1 Structure of a Subsystem

A subsystem consists of the following parts:

1. Usage

This part gives some hints about the usage of the subsystem and general information of its functionality.

2. Constants and Types

All subsystem specific constants and data types are listed here. Also their meanings are described if they are not

obvious.

3. Functions

All RPC’s of these subsystems are listed here and described in detail.

Note: To reduce redundancy the VB declarations of data types and constants have been omitted. Please refer to chapter

3.3 to get more information about this subject.

4.1.2 Structure of a RPC Description

One RPC description contains the following parts:

Title

Contains the name of the RPC and a short description of the function.

C-Declaration

Contains the C declaration of the function (excluding the return type).

VB-Declaration

Declares the function in VB (excluding the return type).

ASCII-Request

Describes the request including the input parameters and their data types listed in [ ].

ASCII-Reply

Describes the reply including the output parameters and their data types listed in [ ].

Remarks

Gives additional information on the usage and possible side effects of the function.

Parameters In/Out

Explains the parameters, their data types and their meaning. Parameters and their ASCII equivalent are explained

at the beginning of each chapter.

Return-Codes

Lists the most common RC to this request, in RC name and RC value.

Leica TPS1200+ & TM30全站仪GeoCOM英文版1.5：功能与编程详解

Leica TPS1200+全站仪GeoCOM参考手册：功能与编程详解

徕卡GeoCom1000开发手册V2.20版概述

莱卡全站仪TS30 / TM30 二次开发手册及软件详解

TPS1200_TS30_TM30_GeoCOM_Manual.rar_TM30通讯_TPS1200_TS30_TM30__ge

TPS1200_TS30_TM30_GEOCOM_MANUAL_GeoCom_莱卡通讯协议_

TS30测量机器人Geocom中文说明书.docx

徕卡全站仪GeoCOM_Manual 中文版

TPS1200_GeoCOM_Manual.rar_GeoCOM_Manual_GeoCom_徕卡_徕卡geocom

geocom for C++

vb GEOCOM 开发

最新资源