Overview

<aside> ⚠️ This guide is for Bristlemouth-enabled Spotter 3 systems, and only covers SD card data related to the Bristlemouth control system and connected modules. • For a complete description of Spotter 3 system logging please refer to this guide. • For Legacy Spotters please refer to this guide.

</aside>

Files are split into numbered "log sessions" to limit the maximum size of individual files and minimize the damage of any file corruption.

• All files with the same Log Session ID are concurrent.
• Log Session ID will increment on every system boot, as well as when any individual file in the session exceeds 1GB.

Bristlemouth-enabled Spotter systems contain additional log files with content depending on the connected Bristlemouth modules. Files in the bm/ directory contain data useful for Sofar Support to track system health and diagnose issues, as well as any data from custom Bristlemouth applications. Data in the bm/ directory is organized into sub-directories by Bristlemouth Node ID. The files within each subdirectory are fully managed by the corresponding Bristlemouth Module.

Additionally, Bristlemouth-enabled systems will log to the log/ directory. The Bristlemouth-related files in the log/ directory use the same file rotation management and indexing pattern for other Spotter SD card files, as described in Overview.

The additional Bristlemouth-related files in the log/ directory are:

SENS_IND.csv - individual sensor readings from Bristlemouth sensors.

SENS_AGG.csv - aggregated samples from Bristlemouth sensors.

BRIDGE_CFG.log - a record of the Bristlemouth system physical configuration and settings.

BRIDGE_SYS.log - Debug system output from the Bristlemouth controller.

BRIDGE.log - Debug system output from the main Spotter controller related to Bristlemouth tasks.

BM_DFU.csv - A record of Bristlemouth firmware updates.

Bristlemouth File Type Details

SENS_IND.csv

This file contains individual sensor readings from supported Bristlemouth module types: Single Point Current Meter, RBR Coda3 Adapter, Sofar Temperature Sensor. The first 6 columns are common among all module types. Subsequent columns depend on the specific type, and are not labeled in the common CSV file header. In the table views below, these flexible columns are labeled as “Data Column 1”, “Data Column 2”, etc., but these column names will not appear in the csv header.

Untitled

Example file from a system with a single Sofar Temperature sensor:

0000_SENS_IND.csv

Example file from a system with a single Current Meter sensor:

0000_SENS_IND.csv

Example file from a system with a single RBR Coda3 sensor:

0002_SENS_IND.csv