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

莱卡测量机器人TM30/TS30/TPS1200中文版说明书GeoCom使用说明2019-5-52019-5-5

目录1地理数据通讯接口 61.1课程介绍 61.2TPS1200系统软件 71.2.1.子系统的组织 71.3公关地球通讯运作的初步情况 82.使用GEOCOM的一般概念 82.1课程介绍 82.2.操作的一般概念 92.3ASCII协议 92.3.1ASCII协议语法 92.4函数调用协议-C/c++ 102.5FuNCTION调用协议-VBA 113GEOCOM编程基础 113.1介绍 113.2ASCII协议编程 113.2.1ASCII协议中的数据类型 123.2.2ASCII协议程序示例 133.2.3与通信有关的操作方式 143.3.1.C/c++中的数据类型 143.3.2基本的GeoCOM应用框架为C/c++ 143.3.3C/c++开发系统支持 153.3.4编程提示 153.4VB编程 163.4.1.VBA中的数据类型——派生的一般规则 163.4.2VBA的基本GeoCOM应用框架 173.4.3VBA开发系统支持 183.4.4编程提示 183.5联合它的值 183.6TPS1200仪器操作方式 183.7常见的通信错误 194.说明 214.1结构描述 214.1.1以下子系统的结构 214.1.2RPC描述的结构 225通讯设置 235.1内存使用 235.2常数和类型 235.3一般GEOCOM功能 245.3.1获取双精度设置 245.3.2COM_SetDoublePrecision-设置双精度设置 255.4客户特定的GEOCOM功能 265.4.1正在初始化GeoCOM 265.4.2退出GeoCOM 265.4.3打开通信端口 265.4.4关闭打开的端口 275.4.5获取当前波特率 285.4.6获取当前超时值 295.4.7设置当前超时值 305.4.8获取传输数据格式 315.4.9获取传输数据格式 315.4.10COM_UseWindow——声明父窗口句柄 325.4.11设置一个弹出错误消息框 335.4.12获取错误文本 345.4.13检索客户端版本信息 346ALT用户-AUS 356.1USAGE 356.2常数和类型 356.3FNCTIONS 356.3.1获取ATR模式的状态 356.3.2设置ATR模式的状态 366.3.3获取锁定模式的状态 376.3.4AUS_SetUserLockState-设置锁定模式的状态 387自动化-AUT 397.1USAGE 397.2取消/终止当前函数 397.3常数和类型 397.4FNCTIONS 417.4.1AUT_ReadTol-读取定位公差的当前设置 417.4.2自动设置定位公差 427.4.3AUT_ReadTimeout—读取当前定位超时设置 437.4.4自动设置定位超时 447.4.5自动定位-将望远镜转到指定位置 447.4.6自动转换面-将望远镜转向另一个面 477.4.7自动微调-自动目标定位 507.4.8AUT_Search—执行自动目标搜索 527.4.9Aut_getfineadjust模式-获得微调定位模式 547.4.10自动设置微调模式-设置微调定位模式 557.4.11启动目标跟踪 567.4.12获取PowerSearch窗口的维度 567.4.13设置PowerSearch窗口 577.4.14获取ATR搜索窗口 587.4.15设置ATR搜索窗口 597.4.16AUT_PS_EnableRange-启用PowerSearch窗口和PowerSearch范围 597.4.17AUT_PS_SetRange—设置PowerSearch范围 607.4.18启动PowerSearch 617.4.19AUT_PS_SearchNext—搜索下一个目标 628.基本应用-BAP 638.1USAGE 638.2常数和类型 638.3函数 648.3.1BAP_GetTargetType—获取EDM类型 648.3.2设置EDM类型 658.3.3获取默认的prism类型 668.3.4设置默认prism类型 668.3.5BAP_GetPrismType2—获取默认或用户prism类型 678.3.6设置默认或用户prism类型 688.3.7获取默认棱镜定义 688.3.8获取用户棱镜定义 698.3.9设置用户棱镜定义 708.3.11设置距离测量程序 718.3.12BAP_MeasDistanceAngle—测量Hz、V角和单个距离 718.3.13BAP_SearchTarget—搜索目标 748.3.14获取当前ATR低可视模式 758.3.15设置当前ATR低可视模式 758.3.16获取缩小的ATR视图字段 768.3.17BAP_SetRedATRFov-设置缩小的ATR视图字段 779基本人机界面-BMM 779.1USAGE 779.2常数和类型 779.3函数 789.3.1BMM_BeepAlarm—输出一个警报信号(三次哔哔声) 789.3.2BMM_BeepNormal-输出报警信号(单个beep) 789.3.3IOS_BeepOn-启动连续的beep信号 799.3.4停止一个活跃的哔哔信号 8010通讯卫星 8010.1说明 8010.2 常数和类型 8010.3函数 8110.3.1获取服务器仪器版本 8110.3.2COM_SwitchOnTPS-打开仪器 8210.3.3COM_SwitchOffTPS-关闭仪器 8310.3.4COM_NullProc-检查通信 8310.3.5获取服务器的二进制属性 8410.3.6COM_SetBinaryAvailable-设置服务器的二进制属性 8511 中央服务-CSV 8511.1INTRODUCTION 8511.2 USAGE 8511.3常数和类型 8511.4函数 8811.4.1获取工厂定义的仪表号 8811.4.2CSV_GetInstrumentName——获取徕卡特定的仪器名称 8811.4.3CSV_GetDeviceConfig-获取仪器配置 8911.4.4获取RL类型 9011.4.5CSV_GetDateTime—获取日期和时间 9111.4.6CSV_SetDateTime—设置日期和时间 9211.4.7CSV_GetSWVersion–获取软件版本 9211.4.8CSV_CheckPower-检查可用的电源 9311.4.9CSV_GetIntTemp–gettingthetemperature 9411.4.10CSV_GetDateTimeCentiSec—获取日期和时间 9512 电子测距-EDM 9612.1介绍 9612.2使用 9612.3常数和类型 9612.4.1EDM_Laserpointer-打开/关闭激光指针 9612.4.3edm_setelintensity-改变电子导光的强度 9813 文件传输-FTR 9913.1USAGE 9913.2 常数和类型 10013.3 函数 10113.3.1 FTR_SetupList-设置列表 10113.3.2列表文件 10213.3.3FTR_AbortList中止列表 10413.3.4FTR_SetupDownload-安装下载 10413.3.5FTR_Download-下载文件 10513.3.6FTR_AbortDownload-中止下载 10713.3.7FTR_Delete-删除文件 10814图像处理-IMG 10914.1INTRODUCTION 10914.2USAGE 10914.3常数和类型 10914.4函数 11014.4.1IMG_GetTccConfig-读取实际的映像配置 11014.4.2IMG_SetTccConfig-设置实际的映像配置 11114.4.3IMG_TakeTccImage捕捉望远镜图像EDM_Laserpointer 11115机械化年检 11315.1介绍 11315.2使用 11315.3常数和类型 11315.4函数 11415.4.1返回锁定控件的状态 11415.4.2启动电机控制器 11515.4.3MOT_StopController—停止电机控制器 11615.4.4.MOT_SetVelocity—以恒定的速度驱动仪器 11616管理-SUP 11816.1使用 11816.2常数和类型 11816.3函数 11816.3.1获取电源管理配置状态 11816.3.2SUP_SetConfig-设置电源管理配置 11917经纬仪测量与计算-TMC 12017.1介绍 12017.2使用 12117.2.1倾角测量/校正 12117.2.2传感器测量程序 12117.3常数和类型 12217.4功能函数 12517.4.1TMC_GetCoordinate—获取测量点的坐标 12517.4.2返回一个角度和距离测量 12717.4.3返回一个完整的角度测量值 12817.4.4返回一个简单的角度测量 13017.4.5返回一个斜坡距离和z角，v角 13217.4.6返回角度、倾角和距离测量值 13517.5MASUREMENT控制功能 13817.5.1进行距离测量 13817.5.2TMC_SetHandDist-输入坡度距离和高度偏移量 13917.6数据设置功能 14117.6.1返回当前反射器高度 14117.6.2设置一个新的反射镜高度 14217.6.3获取大气校正参数 14317.6.4设置大气校正参数 14317.6.5TMC_SetOrientation—使仪器在hz方向上定向 14417.6.6获取棱镜常数 14617.6.7TMC_GetRefractiveCorr-得到折射系数 14717.6.8设置折射系数 14817.6.9TMC_GetRefractiveMethod-获取折射模型 14817.6.10设置折射模型 14917.6.11获取仪器的站坐标 15017.6.12TMC_SetStation—设置仪器的站坐标 15117.6.13TMC_GetAtmPpm—获取大气ppm校正因子 15217.6.14TMC_SetAtmPpm-设置大气ppm校正 15317.6.15得到几何ppm校正因子 15317.6.16tmc_setgeo-设置几何ppm校正因子 15417.7形成功能 15517.7.1获取当前望远镜位置的面信息 15517.7.2获取EDM信号强度的信息 15617.8组织功能 15817.8.1获取角度校正状态 15817.8.2获取双轴补偿器状态 15917.8.3TMC_SetInclineSwitch-打开/关闭双轴补偿器 16017.8.4获取EDM测量模式 16017.8.5设置EDM测量模式 16117.8.6获取笛卡尔坐标 16217.8.7如果发生ATR错误，返回状态 16517.8.8TMC_IfDataIncCorrError—如果发生倾斜错误，返回状态 16617.8.9TMC_SetAngSwitch-启用/禁用角度校正 16717.8.10TMC_GetSlopeDistCorr-获取总ppm和棱镜校正因子 16718移植TPS1100应用程序 16818.1介绍 16818.2卢比C的变化 16818.2.1沟通——COM 16818.2.2中央服务-CSV 16918.2.3Alt用户-AUS 16918.2.4自动化——AUT 16918.2.5控制器任务-CTL 16918.2.6WI注册-WIR 16918.2.7基本应用-BAP 16918.2.8经纬仪测量与计算-TMC 17018.3数据类型和常量发生变化 17018.4RETURN-CODES 17019GEOCOMRELEASES 17119.1.00版本1 17119.2版本1.10 17119.3版本1.20 17119.4版本1.50 17120附录 171B硬件接口 176B-2调试工具 177C提供样品 177C-1程序框架 177C-1.1VBA示例程序 177C-1.2C/c++示例程序 178C-1.3TCC图像采集采样程序 1781地理数据通讯接口1.1课程介绍TPS1200系列经纬仪是现代大地测量仪器。大多数主要任务都可以通过这些工具的集成应用程序隐式地完成。现在，为了完成更广泛的任务和应用，已经定义了TPS1200系列传感器功能的接口，并将随本文档一起发布。有了这个接口，就可以编写基于MS-Windows和/或任何其他支持ASCII的基于通信的平台的客户机应用程序。注意:TS30/TM30和TPS1200共享相同的GeoCOM接口。如果没有另外说明，TM30和TS30仪器的实现与tps1200仪器相同。1.2TPS1200系统软件TPS1200系统软件组织和控制多个传感器元件的相互作用。此外，它还建立了一个应用框架，可以在TPS1200经纬仪上执行。本文主要研究TPS1200经纬仪传感器元件的主接口。如果现有的解决方案没有提供所需的功能，或者只是为了增强功能，则可以使用此主接口实现针对特殊客户问题的解决方案。1.2.1.子系统的组织TPS1200系统软件围绕传感器元件构建，传感器元件是TPS1200经纬仪的部件和/或可选附件。它提供了一组函数来访问传感器和计算值。这些功能被组织成子系统。我们将在这个文档中保留这个分段。这些功能可分为以下几部分:AUS:由于子系统“Alt用户”主要包含“SHIFT”+“User”按钮后面的功能。AUTAutomatisation:一种模块，它提供控制目标自动识别、改变人脸功能或定位功能等功能。BAP:BAP基本应用程序;一些功能，可以很容易地用来获取测量数据。BMM:基础人机;功能，控制一些基本的输入/输出功能，例如设置哔哔声报警等。COMF:处理基本通信参数的模块。这些函数中的大多数都与客户机和服务器端相关。COM:功能访问一些方面的TPS1200控制，这是接近通信。这些函数要么与客户端相关，要么与服务器端相关。CSV:中央服务;该模块提供了获取或设置TPS1200仪器中心/基本信息的功能。CTL:控制任务;该模块包含了系统控制任务的功能。EDM:电子测距仪;测量距离的模块.FTR:文件传输，功能列表，从仪器下载图像文件IMG:图像处理;配置和捕获望远镜相机图像MOT:机动化;部件，它可以用来控制仪器的运动和运动速度。SUP:主管;功能控制一些一般数值的TPS1200仪器。TMC:经纬仪测量与计算;测量数据获取的核心模块。图1-1:客户端/服务器应用概述1.3公关地球通讯运作的初步情况通信发生在两个参与者之间——客户机和服务器。通信介质是串行通信线路。有关设置和所需硬件的详细信息，请参阅附录B。GeoCOM的思想基于SUNMicrosystems的远程过程调用(RPC)协议。在较低的实现级别上，每个在远程设备上可执行的过程都被分配一个远程过程调用标识号。这个数字在内部用于将特定的请求(包括隐式参数)与远程设备上的过程关联起来。在这个级别上，GeoCOM提供了一个ASCII接口，可用于在不支持MS-Windows的平台上实现应用程序。在高层，GeoCOM为C/c++和MS-VBA提供了对这些远程函数的正常函数调用接口。这些接口使程序员能够实现应用程序，就像它将直接在TPS1200仪器上执行一样。注意:进一步，我们将把远程可执行系统函数称为RPC。TPS1200仪器系统软件采用多任务操作系统。然而，一次只能执行一个请求。这意味着调用RPC的GeoCOM只能同步工作。在低层接口上，如果当前请求尚未完成，服务器将缓冲后续请求。如果队列已满，则后续请求将丢失。相反，在高级接口上，函数调用在完全完成之前不会返回。2.使用GEOCOM的一般概念2.1课程介绍在这里，我们将描述使用GeoCOM的几个方面。其中之一是如何在TPS1200仪器上执行功能。GeoCOM的当前实现支持两种(三种)使用。我们可以区分相当基本的ASCII协议和高级函数调用接口。前一种ASCII协议由请求和响应组成。以这种方式使用GeoCOM意味着应用程序组装一个请求，通过串行线将其发送到正在监听的TPS1200仪器，等待回答并解码接收到的回答。后者使用C/c++或VBA中的普通函数调用。为了便于解释，我们将其分为两类，因为受支持的两种编程环境的类型系统各不相同。以这种方式使用GeoCOM意味着调用一个函数。GeoCOM将隐式处理任何必要的通信。2.2.操作的一般概念GeoCOM基本上是作为点对点通信系统实现的。这两个通信参与者称为客户机(外部设备)和服务器(TPS1200仪器)。一个通信单元由请求和相应的应答组成。因此，当客户机向服务器发送一个请求，服务器向客户机发送一个回复时，就会发生一次通信。图2-1:基本沟通GeoCOM实现为同步通信。请求/应答对不能被另一个请求/应答中断。相反，在启动新的通信单元之前，必须成功地完成通信单元。完成的指示器是接收返回代码。虽然ASCII协议允许在接收到相应的应答之前发送下一个请求，但不建议这样做。当然，当前一个请求到目前为止还没有完成时，后续请求将被缓冲。但是，如果缓冲区内容达到其大小限制，则数据可能会丢失。2.3ASCII协议接下来，我们将首先定义语法，然后给出一些关于如何使用ASCII协议在TPS1200仪器上调用函数的信息。ASCII协议是行协议;因此，它使用行结束符来区分不同的请求(应答)。一个请求必须由一个终止符终止。2.3.1ASCII协议语法ASCII请求的语法:[<LF>]%R1Q,<RPC>[,<TrId>]:[<P0>][,<P1>,...]<Term>可选项在括号[]中。圆括号<>包围名称或描述。这些名称根据其类型和含义具有变量值。尖括号本身不属于传输文本的一部分。没有方括号包围的字符是文本，是GeoCOM协议的一部分。<LF>初始换行清除接收器缓冲区。%R1QGeoCOM请求类型1。<RPC>远程过程调用标识号在0到65535之间。<TrId>可选事务ID:通常从1增加到7。相同的值。:协议头和以下参数之间的分隔符。<P0>,<P1>…参数0，参数1，…<TERM>终止符字符串(默认为CR/LF，使用COM_SetTerminator更改《终结者》)。作为一种常见的快捷方式，“^m”将在示例中使用。举例:下面的示例使用RPCCSVGetDateTime查询工具的当前日期和时间:%R1R,5008:1^m(1^m表示终结者)注意:不允许在请求的开头、参数之间或结尾添加字符。它们在解释过程中可能会导致错误。ASCII回复的语法:%R1P,<RC_COM>[,<TrId>]:<RC>[,<P0>,<P1>,...]<Term>可选项在括号[]中。圆括号<>包围名称或描述。这些名称具有在其类型中描述的变量值。尖括号本身不是通信文本的一部分。没有尖括号包围的字符是文本，是GeoCOM协议的一部分。%R1pGeoCOM回复类型1。<RC_COM>GeoCOM返回代码。此值表示通信成功。GRC_OK=0表示通信成功。有关更多信息，请参考“3.7常见通信错误”。<TrId>事务ID—与请求的ID相同。如果请求没有事务ID，那么它将是0。：协议头和以下参数之间的分隔符。<RC>从调用的RPC返回代码，并表示如果将其设置为0，则成功完成(有关进一步信息，请参见附录中的表“RPC返回代码”)。<P0>,<P1>…参数0，参数1，…这些参数只有在<GRC>=0(GRC_OK)时才有效。<TERM>终止符字符串(默认的CR/LF，使用COM_SetTerminator来更改终止符)。下面的示例显示了对RPC5008-CSV_GetDateTime的响应。%R1P,0,0:0,1996,'07','19','10','13','2f'^m月、日、小时、+分、秒的值以字节-格式返回(有关详细信息，请参阅表通信参数...)从RPC返回代码:0意味着没有错误(更多信息请参见RPC返回代码)请求的事务ID。如果没有ID，则返回值为0。GeoCOM返回码:0表示没有错误(详细信息请参阅GeoCOM返回码)2.4函数调用协议-C/c++GeoCOMforC/c++的实现符合正常的函数调用。GeoCOM本身处理所有必要的通信。除了一个例外，程序员不需要对通信进行任何干预。如果GeoCOM报告了一个通信错误，程序员必须确保要么通过调用GeoCOM支持函数来解决问题，要么通过终止正在运行的任务来不再调用RPC。然而，程序员必须初始化GeoCOM并设置端口的设置，以确保通信能够进行。此外，用户必须确保TPS1200仪器连接良好。举例：下面是一个使用TMC_GetSimpleMea的示例代码片段。我们并没有在这里进行必要的初始化和建立GeoCOM。有关C/c++的基本GeoCOM应用框架，请参阅第3.2.3章。GRC_TYPERetCode;TMC_HZ_V_ANGAngles;doubledSlopeDist;RetCode=TMC_GetSimpleMea(1000,Angles,dSlopeDist,TMC_AUTO_INC);if(RetCode==GRC_OK){//dosomething-usevalues}else{//handleerror}2.5函数调用协议-VBA这里对于VBA和C/c++几乎都是有效的。请参阅第2.4章。VBA和C/c++唯一的区别是VBA有一个不同的类型系统。因此，定义的数据类型在定义上略有不同。此外，由于实现的原因，RPC名称必须有一个额外的前缀，即“VB_”，用于GeoCOM的当前实现。例子:我们使用与第2.4章相同的例子。DimRetCodeAsIntegerDimAnglesAsTMC_HZ_V_ANGDimdSlopeDistAsDoubleRetCode=VB_TMC_GetSimpleMea(1000,Angles,dSlopeDist,TMC_AUTO_INC)IfRetCode=GRC_OKThen'dosomething-usevaluesElse'handleerrorEndIf3GEOCOM编程基础3.1介绍我们将描述如何使用不同的协议来编写程序。当然，类型系统(协议之间的主要区别)将被更详细地描述。3.2ASCII协议编程实现一个使用ASCII协议的应用程序是基于使用串行线的简单数据传输。程序员负责设置客户端的串行线参数，使其与TPS1200仪器的设置相对应。然后，远程调用只需发送有效的编码请求并接收和解码它们的响应即可。出于调试目的，使用所谓的Y-cable可能会有所帮助，它使您能够使用终端或终端模拟器观察串行线上的通信。有关详细信息，请参见附录B-2调试实用程序。注意:如果活动COM端口的设置是由任何软件部分设置的，如果服务器是在线的，那么强烈建议使用前导<LF>清除服务器端的接收缓冲区。这将减少下一个RPC的不必要错误消息。3.2.1ASCII协议中的数据类型RPC的每个参数都有自己的关联数据类型。有各种不同的数据类型，它们是为已发布的函数集定义的。ASCII协议只支持简单的数据类型。所有与基类型不同的数据类型、名称中的类型和聚合的数据类型都被转换为它们的基类型。转换意味着将聚合的数据序列化为以逗号分隔的元素列表。因此，程序员有责任根据相关的数据类型解释这些值。所支持的基类型及其值范围定义如下:格式类型取值范围低条件进入联网有效输入表示典型的输出表示boolean0=false1=true10,10,1byte0...2552（4）‘00’,’FF’,’ff’,’7a’,’A7’‘00’,’FF’,’ff’,’7a’,’A7’string-<512”abc\x0d\x0a””abc\x0d\x0a”double±2.225E-308...±1.797E+30817+31,1.0,1.0e4,-0.1e-07,-2-0.1234567+e67long(231)...(231-1)110x7FFFFFFF,-5432115,-154836,900000short32768...3276760,-1,-32700,45,56,0x45e,0X3AA0,-1,-32700,45,56unsignedlong0...(232-1)100xFFFFFFFF0,1,3400065,9573unsignedshort0...6553550,1,34000,65,65535,0x3a,0x00,0xFFFF0,1,34000,65,65535表3-1:通信参数类型注意:字节总是用双字符十六进制表示法表示。十六进制表示法可以使用大小写表示法:0.9+[a..]f|A..F]。在不属于ASCII字符范围0x20到0x7E(32到126小数)的字符串中发送的字符使用自适应的字节表示法发送——例如“\x9A”，其中\x(或\x)引入十六进制表示法中的字节值。要包含反斜杠、双引号、百分号或波浪号(\"%~)作为字符串的一部分，必须在它前面加上反斜杠字符，例如"Thisisa\"quote\""。整数的类型(短、无符号短、长、无符号长)也可以用十六进制表示法表示，由0x或0x引入。以下规则用于生成/解释不同于基本类型和聚合数据类型的值:数值和字符串数据类型数值数据类型与c参数在数值、范围和精度上尽可能接近。如果没有相同的数据类型可用，那么将采用下一个最佳数据类型。字符和字符串将被字符串数据类型替换。枚举类型如果对应的c参数是枚举数据类型，则ASCII参数的枚举值等于c数据类型声明的隐式值。为了说明这一点，我们将始终在枚举数据类型的描述中给出名称和关联值。建成结构结构数据类型将转换为以逗号分隔的元素列表。一个元素的表示符合其基类型的数据类型表示。如果一个元素本身是一个结构，那么深度优先转换将会发生。如果不应用此规则，则显式地描述类型及其ASCII参数。数组数组将转换为以逗号分隔的元素列表。一个元素的表示符合其基类型的数据类型表示。枚举数据类型和结构的示例下面的例子给出了一个典型的数据类型声明，以及本手册中用于分系统经纬仪测量与计算的TMC_GetSimpleMea的相应的过程声明:常数和类型typedeflongSYSTIME;structTMC_HZ_V_ANG{doubledHz;doubledV;}enumTMC_INCLINE_PRG{TMC_MEA_INC,//encodedas0TMC_AUTO_INC,//1TMC_PLANE_INC//2}C-定义TMC_GetSimpleMea(SYSTIMEWaitTime,TMC_HZ_V_ANG&OnlyAngle,double&dSlopeDistance,TMC_INCLINE_PRGMode)ASCII-请求%R1Q,2108:WaitTime[long],Mode[long]ASCII-回应%R1P,0,0:RC,Hz[double],V[double],dSlopeDistance[double]请注意RPC有两个输入和两个输出参数。任何时候，一个请求必须只编码和发送输入/输出参数，而一个响应必须只编码和发送输入/输出参数!注意:不可以发送不必要的参数。尽管包含了头文件com_pub。hpp表示不支持某些函数参数的默认值。因此，它们必须被发送。使用值forWaitTime=1000和倾角测量模式TMC_AUTO_INC调用此RPC的ASCII请求具有以下形式(注意，值1用于模式参数，因为枚举数据类型的计数从0开始):%R1Q,2108:1000,1^m可能的答复如下:%R1P,0,0:0,0.9973260431694,1.613443448007,1.3581^m其中冒号后面的第二个和第三个值对应结构TMC_HZ_V_ANG的dHz和dV部分，第四个值对应变量dSlopeDistance。(注意:':'后面的第一个值不是参数，而是RPC的返回代码值)。3.2.2ASCII协议程序示例要了解请求和响应是如何构建和工作的，请参阅提供的geocom。示例目录中的trm文件。有关详细信息，请参阅终端模拟器的附录C-1设置。3.2.3与通信有关的操作方式第3.6节-TPS1200仪器的运作模式-解释地球通讯的不同运作模式。与此类似，以下内容对ASCII协议也是有效的。由于客户必须提醒哪种模式是活动的，所以TPS1200仪器不能提供支持。区分模式的唯一方法是提醒应用程序启动的操作及其结果响应。到目前为止，还不存在确定当前模式的其他可能性。要打开仪器，一个字符就足够了。建议忽略后续的回复(一两行)。3.3C/c++编程用C/c++编程是基于众所周知的DLL概念，由MicrosoftCorp.定义，要成功地编译一个项目，首先必须包含文件com_pub。hpp，它定义了所有必要的常量、数据类型和函数原型。第二个geocoms2k。库必须包含在项目中，这使得链接器能够解析导出的DLL函数。为了成功地操作geocoms2k.dll文件，操作系统必须能够访问它，因此它必须位于操作系统查找所请求的DLL文件的目录中。项目的选择GEOCOMS2K.lib结构字节对齐4个字节内存模型N/一个特殊#定义(如果不使用MFC)严格的3.3.1.C/c++中的数据类型由于TPS1200仪器固件实现的主要编程语言是C/c++，所以所有的数据类型最初都是用C/c++定义的。因此，不需要转换值或数据类型。3.3.2基本的GeoCOM应用框架为C/c++C/c++GeoCOM应用程序至少包括以下部分:——初始化GeoCOM-打开到服务器的连接-一个或多个GeoCOMRPC-关闭到服务器的活动连接——敲定GeoCOM上述各点的示例实现可以是://includestandardsystemheaders#include"com_pub.hpp"//includeapplicationheaders#defineNUM_OF_RETRIES1GRC_TYPERetCode;BOOLEbOpenAndRunning=FALSE;//initializeGeoCOMRetCode=COM_Init();if(RetCode==GRC_OK){//openaconnectiontotheTPS1200instrumentRetCode=COM_OpenConnection(COM_1,COM_BAUD_19200,NUM_OF_RETRIES);if(RetCode==GRC_OK){bOpenAndRunning=TRUE;}}//optionallysetupothercomm.parametershereif(RetCode==GRC_OK){//--functionalityoftheapplication--//herewejusttestifcommunicationisupRetCode=COM_NullProc();if(RetCode!=GRC_OK){//handleerror}}//closechannelif(bOpenAndRunning){RetCode=COM_CloseConnection();if(RetCode!=GRC_OK){//handleerror}}//anytimefinalizeandresetGeoCOMRetCode=COM_End();if(RetCode!=GRC_OK){//handleerror}3.3.3C/c++开发系统支持利用MicrosoftVisualC/c++6.0开发了GeoCOM系统文件。虽然这个开发环境是当前GeoCOM实现的基础，但是强调它是独立于GeoCOM的，因此也可以使用其他开发环境。但请注意，到目前为止还没有进行彻底的测试。3.3.4编程提示由于GeoCOM重新