Trimble Inc. 10950 Benutzerhandbuch

Seite von 124
 
Alloy GNSS reference receiver User Guide 
 109
 
The general command format is:  
    http://SystemName/prog/Verb?Object&param=value&param=value... 
In most of this document, parts of that format will be left out for clarity. So commands will be 
shown as  
   Verb  Object  param=value  param=value ... 
As far as is possible, Verbs, Objects, parameter names, and parameter values are Case Insensitive. 
That is, you can use any combination of upper and lower case characters, anywhere in the 
commands. The exceptions are items like SystemName, file names, session names, account names, 
passwords, etc. These exceptions are called out in the parameter descriptions for each command.  
Command parameters are of the form paramname=value. The value is a string of characters, 
usually a number or a single word. A few parameter values can contain multiple items 
concatenated into a single string, often with punctuation. For example, some parameters allow a 
comma-separated list like this:  
    Set GpsSatControls disable=5,8,23 
In such cases, the parameter listing in the command description will show the acceptable formats.  
Some parameters define an arbitrary string of characters which can include spaces, ampersands or 
other punctuation characters. These characters may cause problems when encoded in URLs. It is 
best to express them as "%xx" values, where 'xx' is the hexadecimal equivalent of the ASCII 
character. Common values that need encoding are:  
Hex  
 
ASCII  
%20 
 
Space 
%25 
 
Percent, % 
%26 
 
Ampersand, & 
%3F 
 
QuestionMark, ? 
 
Most other characters will not require encoding, but it cannot hurt to encode them if there is any 
doubt.  
 
 
Uploading Files 
 
A small number of commands are used to transfer a file from an external computer into the GNSS 
receiver. These commands all use the verb Upload.   The process for uploading a file is more 
complex than a simple URL/CGI submission. Instead of an http GET request, a "POST" request is 
used. Programming with Upload commands requires using special techniques. See the upload 
examples below in the Curl and Perl sections. Also see the documentation for the Upload 
FirmwareFile command.