Skip to main content

Automatic PCM Error Logging

The Popoto application includes a diagnostic feature called Automatic PCM Error Logging, designed to support offline analysis of signal quality during transmission failures.

Overview​

When this feature is enabled, the Popoto application continuously maintains a rolling buffer of the most recent 30 seconds of PCM passband data. If a transmission fails with either a CRC Error or a Ranging Error, the application automatically dumps this buffered audio into a timestamped .wav file.

These recordings are intended for developers and engineers to use in post-mission analysis, regression testing, or reproducing field issues under known acoustic conditions.

How to Enable​

This feature is controlled at runtime through the pshell interface.

To disable PCM error logging, run:

set LogPcmEnable 0

To enable automatic logging of recent PCM data when an error occurs, run:

set LogPcmEnable 1
Default setting

LogPcmEnable is disabled by default.

No additional configuration is required. When enabled, the Popoto application writes .wav files automatically when a relevant error is detected.

Logging Details​

  • Recorded files are mono standard WAV format at the application sample rate and are timestamped at the moment of error detection.
  • Only raw PCM passband audio is captured. Decoded messages and payload content are not included.
  • Logging is triggered specifically by CRC Errors and Ranging Errors.
  • The PCM buffer is always 30 seconds long.