NEO-M9N - Integration manual
Message
Description
UBX-LOG-STRING
Enables a host process to write a string of bytes to the log file
Table 8: Logging control and configuration messages
Message
Description
UBX-LOG-RETRIEVE
Starts the log retrieval process
UBX-LOG-RETRIEVEPOS
A position log entry returned by the receiver
UBX-LOG-RETRIEVEPOSEXTRA
Odometer position data
UBX-LOG-RETRIEVESTRING
A byte string log entry returned by the receiver
UBX-LOG-FINDTIME
Finds the index of the first entry (given time)
Table 9: Logging retrieval messages
3.4.2 Setting the logging system up
An empty log can be created using the UBX-LOG-CREATE message and a log can be deleted with the
UBX-LOG-ERASE message. The logging system will only run if a log is in existence, so most logging
messages will be rejected with a UBX-ACK-NAK message if there is no log present. Only one log
can be created at any one time so a UBX-ACK-NAK message will be returned if a log already exists.
The message specifies the maximum size of the log in bytes (with some pre-set values provided).
Both the logging subsystem and the receiver file-store have implementation overheads, so the total
space available for log entries will be somewhat smaller than the size specified.
UBX-LOG-CREATE also allows the log to be specified as a circular log. If the log is circular, a set of
older log entries will be deleted when it fills up, and the space freed up is used for new log entries.
By contrast, if a non-circular log becomes full then new entries which do not fit will be rejected. UBX-
LOG-CREATE also causes the logging system to start up so that further logging messages can be
processed. The logging system will start up automatically on power-up if there is a log in existence.
The log will remain in the receiver until specifically erased using the UBX-LOG-ERASE message.
The CFG-LOGFILTER-* configuration group controls whether logging of entries is currently enabled
and selects position fix messages for logging.
Figure 7: The top level active/inactive states of the logging subsystem
3.4.3 Information about the log
The receiver can be polled for a UBX-LOG-INFO message which will give information about the log.
This will include the maximum size that the log can grow to (which, due to overheads, will be smaller
than that requested in UBX-LOG-CREATE) and the amount of log space currently occupied. It will
also report the number of entries currently in the log together with the time and date of the newest
and oldest messages that have a valid time stamp.
Log entries are compressed and have housekeeping information associated with them, so the actual
space occupied by log messages may be difficult to predict. The minimum size for a position fix entry
UBX-19014286 - R07
3 Receiver functionality
Page 19 of 95
C1-Public