Leica TPS1200全站仪GeoCOM接口编程指南

需积分: 49 20 浏览量更新于2024-07-18 1 收藏 343KB DOCX 举报

"莱卡全站仪接口文档是关于如何与莱卡的TPS1200系列全站仪进行通信和编程的详细指南。该文档涵盖了从基础概念到高级功能的各种主题，包括ASCII协议、C/C++和VBA的函数调用协议，以及全站仪的操作模式和通用通信错误。此外，它还提供了特定于应用程序的功能，如自动化（AUT）、基本应用（BAP）和电子距离测量（EDM）。文档中还包括了关于如何将TPS1100应用程序移植到新版本的信息，并列出了远程过程调用（RPC）的完整列表。" 这篇文档主要介绍了莱卡全站仪的GEOCOM操作原理和使用方法，适用于开发基于MS-Windows或其他支持ASCII通信的平台的客户端应用程序。文档首先介绍了GEOCOM的背景和TPS1200系统软件的功能，系统软件协调多个传感器元件的工作并提供执行应用程序的框架。接下来，文档详细阐述了使用GEOCOM的一般概念，如ASCII协议，这是一种用于设备间通信的标准文本格式。对于程序员来说，文档提供了C/C++和VBA两种编程语言的函数调用协议，使得开发者可以编写控制全站仪的程序。此外，文档还讨论了编程的基础知识，包括单位值、仪器操作模式和常见的通信错误。文档的后续部分按模块详细介绍了各项功能，如ALT USER（AUS）、Automation（AUT）、基本应用（BAP）、基本人机界面（BMM）、通讯（COM）、中央服务（CSV）、电子距离测量（EDM）、文件传输（FTR）、图像处理（IMG）、电机化（MOT）、监督者（SUP）、经纬仪测量和计算（TMC），以及将TPS1100应用程序移植到新版本的指南。每个模块都包含了使用方法、常量和类型、以及相关的函数。最后，文档列举了GEOCOM的不同版本发布的历史记录，以及一个包含远程过程调用名称和返回码的附录，这对于调试和优化与全站仪的通信至关重要。此外，还提供了示例程序，帮助开发者更好地理解和实现与莱卡全站仪的交互。这份接口文档是开发人员和专业人士与莱卡全站仪进行高级集成和自定义操作的宝贵资源，涵盖了从基础通信到复杂应用程序开发的全面指导。

GeoCOM Reference

Fundamentals of Programming

Leica TPS1200 / TS30 / TM30 – Version

The following rules are for generating/interpreting values with a type different from the base types and aggregated data

types:

Numerical and string data type

The numerical data types correspond to the C-parameters in value, range and precision as close as possible. If no

identical data type is available then the next best one will be taken. Character and string will be replaced by the

string data type.

Enumerations

If the corresponding C-parameter is an enumeration data type, then the enumeration value of the ASCII

parameter is equal to the implicit value of the declaration of the C-data type. For clarification, we will give

always the name and the associated value in the description of an enumeration data type.

Structures

Structure data types will be converted into a comma-separated list of elements. One element’s representation

conforms to the data type representation of its base type. If an element itself is a structure then depth first

conversion will take place. If this rule does not apply then the types and their ASCII parameters are described

explicitly.

Arrays

An array will be converted into a comma-separated list of elements. One element’s representation conforms to

the data type representation of its base type.

Example for Enumeration Data Types and Structures

The following example gives a typical data type declaration and the corresponding procedure declaration used in

this manual for TMC_GetSimpleMea from the subsystem Theodolite Measurement and Calculation:

Constants and Types

typedef long SYSTIME;

struct TMC_HZ_V_ANG

{

double dHz;

double dV;

}

enum TMC_INCLINE_PRG

{

TMC_MEA_INC, // encoded as 0

TMC_AUTO_INC, // 1

TMC_PLANE_INC // 2

}

C-Declaration

TMC_GetSimpleMea(SYSTIME WaitTime,

TMC_HZ_V_ANG &OnlyAngle,

double &dSlopeDistance,

TMC_INCLINE_PRG Mode)

ASCII-Request

%R1Q,2108:WaitTime[long],Mode[long]

ASCII-Response

%R1P,0,0:RC,Hz[double],V[double],dSlopeDistance[double]

Please, notice that the RPC has two input and two output parameters. Anytime a request must encode and send

input and in/out parameters only and a reply must encode and send in/out and output parameters only!

Note: Bytes are always represented in two-character hexadecimal notation. Hexadecimal notation can use upper-

or lower-case representation: 0.9 + [a .. f | A .. F].

Characters sent within a string which do not fall within the ASCII character range 0x20 to 0x7E (32 to 126

decimal) are sent using an adapted byte notation - e.g. ”\x9A”, where \x (or \X) introduces a byte value in

hexadecimal notation. To include the back slash, double quote, per cent or tilde character (\ “ % ~) as part of

the string, it must be preceded by a backslash character, e.g. “This is a \”quote\””.

Types of integer (short, unsigned short, long, unsigned long) can also be represented in hexadecimal

notation, introduced by 0x or 0X.

GeoCOM Reference

Fundamentals of Programming

Leica TPS1200 / TS30 / TM30 – Version

The ASCII Request to call this RPC with the value for WaitTime = 1000 and the inclination measure

mode TMC_AUTO_INC has the following form (note that the value 1 is used for the Mode parameter

because the counting of enumeration data types start at 0):

%R1Q,2108:1000,1^m

A possible reply can be as follows:

%R1P,0,0:0,0.9973260431694,1.613443448007,1.3581^m

Where the second and third value after the colon corresponds to the dHz and dV parts of the structure

TMC_HZ_V_ANG and the fourth value corresponds to the variable dSlopeDistance. (Note that the first value

after the ‘:’ is not a parameter but the return code value of the RPC).

3.2.2 ASCII Protocol Program Example

For getting a feeling of how requests and replies are build up and work see also the provided geocom.trm file in

the samples directory. Please refer to Appendix C-1 Settings for Terminal Emulator for further information.

3.2.3 Modes of Operation Concerning Communication

Section 3.6 - TPS1200 Instrument Modes of Operation - explains the different modes of operation of GeoCOM

concerning communication. Similar to that the following is valid for the ASCII protocol.

Since the client has to remind which mode is active, no support can be given from the TPS1200 instrument. The only

way to distinguish between modes is to remind the actions an application has initiated and their resulting replies. So far

no other possibility exists to determine the current mode.

To switch on the instrument a single character is sufficient. It is recommended to ignore the subsequent reply (one or

two lines).

3.3 C/C++ - PROGRAMMING

Programming in C/C++ is based on the well-known DLL concept, defined by Microsoft Corp. To compile a project

successfully first you have to include the file com_pub.hpp, which defines all necessary constants, data types and

function prototypes. Second geocoms2k.lib has to be included in the project, which enables the linker to resolve the

DLL exported functions. To operate successfully the geocoms2k.dll file must be accessible for the operating

system, hence it must be located in a directory, which the operating system looks up for the requested DLL file.

Project Options GEOCOMS2K.lib

Structure byte-alignment 4 bytes

Memory model N/A

Special #defines (if not using MFC) STRICT

3.3.1 Data Types in C/C++

Since the main programming language of implementation of TPS1200 instruments Firmware is C/C++ all data types are

initially defined in C/C++. Therefore, no conversion of values or data types is necessary.

3.3.2 Basic GeoCOM Application Frame for C/C++

A C/C++ GeoCOM application consists at least of the following parts:

- Initialise GeoCOM

- Open a connection to the server

- One or more GeoCOM RPC’s

- Close the active connection to the server

- Finalise GeoCOM

A sample implementation of above points could be:

// include standard system headers

#include "com_pub.hpp"

// include application headers

Note: Unnecessary parameters must not be sent.

Although the enclosed header file com_pub.hpp

denotes default values for certain function parameters

they will not be supported. Hence, they have to be sent.

剩余63页未读，继续阅读

zihan159

粉丝: 0
资源: 3

Leica TPS1200全站仪GeoCOM接口编程指南

徕卡Geocom使用手册

徕卡TCA2003全站仪使用说明书

GEOCOM32-VB徕卡全站仪开发包

全站仪说明书

Leica TPS1200全站仪GeoCOM接口操作手册：实现精准测量与控制

徕卡TC905全站仪技术规格与性能解析

莱卡水准仪测量API

仪器软件驱动

莱卡数据处理VBA(203KB)

TPS1200_TS30_TM30_GEOCOM_MANUAL_GeoCom_莱卡通讯协议_

最新资源