Popoto Log
Introduction
The popoto.log file is a diagnostic log file that is updated while the popoto_app runs. It tracks message flow and logic flow within the system.
The log file has these properties:
- Leveled: Each log entry is assigned a severity level in the code. By changing the output filter, only logs greater than a configured severity level are displayed.
- Timestamped: Each log message is tagged with a millisecond-accurate real-time clock stamp and a PCM count timestamp. The real-time clock is useful for comparing transmit and receive times between units. The PCM clock indicates when a message is displayed with respect to reception or transmission of acoustic messages.
- Rolling: Each time the Popoto application starts, the previous log file is moved into a list of the 10 preceding log files. In the Popoto_app directory, popoto.log is the current log file, popoto.log.1 is the most recent previous log file, and popoto.log.2 through popoto.log.10 are older logs.
Location
On the target hardware, popoto.log is found in: /var/popotoLogs/popoto.log
To allow more than one Popoto image to run on a PC, the base port number is appended to the log file name.
| Log File | Corresponding Simulation |
|---|---|
/tmp/popoto.log.17000 | Popoto image running at base port 17000 |
/tmp/popoto.log.18000 | Popoto image running at base port 18000 |
Logging Levels
Each log message is assigned a logging level from 0 to 7, with 0 being the most severe and 7 being the least.
| Level | Name |
|---|---|
0 | logERROR |
1 | logWARNING |
2 | logINFO |
3 | logDEBUG |
4 | logDEBUG1 |
5 | logDEBUG2 |
6 | logDEBUG3 |
7 | logDEBUG4 |
By default, all log messages with a logging level of logINFO or lower are written to the log.
Changing the Log Level
To change the log level, issue:
SetValue LoggingLevel int <Level> 0
Or from pshell:
setvaluei LoggingLevel <level>
Getting the Current Log Level
To get the current logging level, issue:
GetValue LoggingLevel int 0
Or from pshell:
getvaluei LoggingLevel
Modem State Machine (MSM) Logs
The Modem State Machine includes a logging mechanism that can be connected to popoto.log. This allows you to see events and state transitions as the modem state machine operates.
To enable MSM logs, send the EnableMSMLogs command. Or, from pshell:
enablemsmlogs
To disable MSM logs, send the DisableMSMLogs command. Or, from pshell:
disablemsmlogs