Commands
Commands are used to control and configure OEM7 receivers.
As of firmware 7.08 and later, Agriculture firmware versions support the same commands as OEM7 firmware streams.
Command Formats
The receiver accepts commands in 3 formats as described in Messages:
-
Abbreviated ASCII
-
ASCII
-
Binary
Abbreviated ASCII is the easiest to use for your input. The other two formats include a CRC for error checking and are intended for use when interfacing with other electronic equipment.
The following are examples of the same command in each format:
Abbreviated ASCII Example:
LOG COM1 BESTPOSB ONTIME 1[CR]
ASCII Example:
#LOGA,THISPORT,0,0,UNKNOWN,0,0.0,0,0,0;COM1,BESTPOSB,ONTIME,1.000000,0.000000,NOHOLD*ec9ce601[CR]
Binary Example:
AA44121C 010000C0 20000000 00FF0000 00000000 00000000 00000000 20000000 2A000000 02000000 00000000 0000F03F 00000000 00000000 00000000 34D32DC1
Optional Parameters
Many commands have nested optional parameters where an optional parameter requires the optional parameter before it to be present. This is noted in the Abbreviated ASCII Syntax as:
Command [OPT_1 [OPT_2 [OPT_3]]]
In this syntax example, OPT_1 and OPT_2 must be provided if you want to provide a value for OPT_3. These leading two options are required even if you want to use the defaults for OPT_1 and OPT_2.
Command Settings
There are several ways to determine the current command settings of the receiver:
-
Request an RXCONFIG log. This log provides a listing of all commands issued to the receiver and their parameter settings. It also provides the most complete information.
-
For some specific commands, logs are available to indicate all their parameter settings. The LOGLIST log shows all active logs in the receiver beginning with the LOG command.
-
Request a log of the specific command of interest to show the parameters last entered for that command. The format of the log produced is exactly the same as the format of the specific command with updated header information.
Requesting a log for specific command is useful for most commands. For commands repeated with different parameters (for example, SERIALCONFIG and LOG), only the most recent set of parameters used is shown. To view all sets of parameters, try method 1 or 2 above.
Abbreviated ASCII Example:
log fix
<FIX COM1 0 49.5 FINESTEERING 2072 405099.446 02000008 37d7 15761
< NONE -10000.00000000000 -10000.00000000000 -10000.0000
Command Defaults
When the receiver is first powered up or after a FRESET command, all commands revert to their factory default settings. When you use a command without specifying its optional parameters, it may have a different command default than the factory default. The SAVECONFIG command can be used to save these defaults. Use the RXCONFIG log to reference any default command and log settings.
Factory default settings for individual commands are stated in the following commands, organized alphabetically by command name.
FRESET STANDARD causes all previously stored user configurations saved to non-volatile memory to be erased (including Saved Config, Saved Almanac, Saved Ephemeris and L-Band-related data, excluding subscription information).
Ensure that all windows, other than the Console window, are closed in NovAtel’s Connect user interface application before you issue the SAVECONFIG command.