Trimble Inc. 10950 Manual De Usuario
110
Alloy GNSS reference receiver User Guide
Responses to Commands
Programmatic Interface requests will trigger a response from the GNSS Receiver. The response is
usually a plain-text ASCII document which is returned using the HTTP or HTTPS protocol. The
response can take one of several forms:
usually a plain-text ASCII document which is returned using the HTTP or HTTPS protocol. The
response can take one of several forms:
•
A single line data response.
•
A multi-line data response.
•
A single line action response.
•
A single line error message.
•
A binary file.
Single Line Data Response
These are usually the result of "Show" commands, where the data returned is simple enough to fit
on a single text line. For example, the response to command Show SerialNumber will be:
on a single text line. For example, the response to command Show SerialNumber will be:
SerialNumber sn=1234A56789
Single-line responses can be arbitrary text, but most often they are similar to a Set command
format, showing an object name with parameters. For example, Show GpsSatControls returns:
format, showing an object name with parameters. For example, Show GpsSatControls returns:
GpsSatControls enable=all disable=5,6 ignoreHealth=7
This string is exactly what must be appended to the Set verb, in order to restore the controls to the
current state.
current state.
Multi-Line Data Response
Some responses are too lengthy to be returned in a single line of text. In this case, the response will
be spread over multiple lines, with leading and trailing lines that frame the data. Both framing lines
will start with '<' and end with '>'. Between the two characters will be some text that shows which
command was used to trigger the response. For example, the Show Sessions command produces a
response like this:
<Show Sessions>
Session name=CORSA enable=yes schedule=Continuous ....
Session name=CORSB enable=no schedule=Continuous....
Session name=CORSC enable=no schedule=Continuous ....
<end of Show Sessions>
Session name=CORSA enable=yes schedule=Continuous ....
Session name=CORSB enable=no schedule=Continuous....
Session name=CORSC enable=no schedule=Continuous ....
<end of Show Sessions>
Schematically, the multi-line format takes the form:
<Verb Object Parameters>
....
Zero or more lines of ASCII data.
....
<end of Verb Object Parameters>
....
Zero or more lines of ASCII data.
....
<end of Verb Object Parameters>