Trimble Inc. 10950 Manual De Usuario

Descargar
Página de 124
 
 
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:  
• 
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:  
    
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:  
    
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.  
 
 
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> 
Schematically, the multi-line format takes the form:  
    <Verb Object Parameters> 
    .... 
    Zero or more lines of ASCII data. 
    .... 
    <end of Verb Object Parameters>