SEPTENTRIO PolaRx5TR, Reference Manual

Page: 75 / 512

3 Command Line Reference
The maximum length of any ASCII command line is 2000 characters.
For commands requiring arguments, the comma "," must be used to separate the arguments
from each other and from the command’s name. Any number of spaces can be inserted
before and after the comma.
Each argument of a
set
-command corresponds to a single configuration parameter in the
receiver. Usually, each of these configuration parameters can be set independently of the
others, so most of the
set
-command’s arguments are optional. Optional arguments can
be omitted but if omitted arguments are followed by non-omitted ones, a corresponding
number of commas must be entered. Omitted arguments always keep their current value.
3.1.3 Command Replies
The reply to ASCII commands always starts with "$R" and ends with <CR><LF> followed by
the prompt corresponding to the connection descriptor you are connected to.
The following types of replies are defined for ASCII commands:
• For comment lines (user input beginning with "#") or empty commands (just pressing
"Enter"), the receiver replies with the prompt.
COM1> # This is a comment! <CR>
COM1>
• For invalid commands, the reply is an error message, always beginning with the key-
word "$R?" followed by an error message.
• For all valid
set
-,
get
- and
exe
-commands, the first line of the reply is an exact copy
of the command as entered by the user, preceded with "$R:". One or more additional
lines are printed depending on the command. These lines report the configuration of
the receiver after execution of the command.
COM1> setNMEAOutput, stream1, com1, GGA, sec1 <CR>
$R: setNMEAOutput, stream1, com1, GGA, sec1
NMEAOutput, stream1, com1, GGA, sec1
COM1>
For commands which reset or halt the receiver (e.g.
exeResetReceiver
), the reply
is terminated by "
STOP>
" instead of the standard prompt, to indicate that no further
command can be entered.
• For all valid
lst
-commands, the first line of the reply is an exact copy of the com-
mand as entered by the user, preceded with "$R;". The second line is a pseudo-prompt
"
−−−−
>" and the remaining of the reply is a succession of formatted blocks, each of
them starting with "$
−−
BLOCK".
75