Function Call Protocol - C/C - Leica tps1100 Reference Manual

GeoCOM Reference Manual
<RC>
<P0>,<P1>,...
<Term>
Example:
The following example shows the reply to the RPC 5008 -
CSV_GetDateTime.
%R1P,0,0:0,1996,'07','19','10','13','2f'^m
¦ ¦ ¦ ----------------------------
¦ ¦ ¦
¦ ¦ ¦
¦ ¦ ¦
¦ ¦ ¦
¦ ¦ +------
¦ ¦
¦ +-----
¦
+----
2.3

FUNCTION CALL PROTOCOL - C/C++

The implementation of GeoCOM for C/C++ conforms to normal function calls.
GeoCOM itself handles all necessary communication. No intervention of the
programmer in respect to the communication is necessary with one exception. If
the GeoCOM reports a communication error the programmer has to make sure that
either the problem will be solved - by calling GeoCOM support functions - or no
further RPC's will be called - by terminating the running task.
Nevertheless, the programmer has to initialise GeoCOM and set up the port's
settings to make sure that communication can take place. Moreover the user has to
make sure that the TPS1100 instrument is well connected.
Example:
An example code fragment for using
We do not take care of the necessary initialisation and set up of GeoCOM here.
TPS1100 - Version 1.05
Return code from the called RPC and denotes the
successful completion if it is set to 0 (see table 'RPC
return codes' in the appendix for further
information).
Parameter 0, Parameter 1, ... These parameters will
be valid only if
Terminator string (default CR/LF, use
COM_SetTerminator
The values for month, day, hour,
¦
minute and second are replied in the byte-
+---
format (see table communication parameter
for further information)
Return code from the RPC: 0 means no error
(see RPC return codes for further information)
The Transaction ID of the request. If there was no ID
the value returned is 0.
Return code from GeoCOM: 0 means no error (see
GeoCOM return codes for further information)
TMC_GetSimpleMea
General Concepts of Using GeoCOM
is equal to 0 (RC_OK).
<GRC>
to change the terminator).
could be the following.
2-4