Microphone Log Files - SMART System

SMART System User Guide (Latest Software Version)

Core Product
SMART System
Accessory
SMART Software Version
1.3.9

Each microphone attached to a SMART System writes a line to a dedicated log file each time the microphone's active state changes.

State changes that prompt the microphone to write a new line to its log file include the following:

  • The microphone begins a schedule period.
  • The microphone's heater turns on or off.
  • The microphone performs a microphone sensitivity test.

The most recent log file is saved to the path /var/www/html/storage/devices/MACaddress/data/log/prefix_log.txt, where prefix is the custom name assigned to each microphone. If log file rotation is enabled, older log files are saved to the same directory with the name format date_time-prefix_log.txt, where date and time reflect the date and time of the first entry in each log file.

A microphone log file is presented as a comma-separated list of values, with column headers.

From left to right, the values in each row represent the following:

DATE TIME (YYYY-MM-DD hh:mm:ss.uuuuuu)
The date and time when each row was written to the log file, to microsecond precision.
SN
The 12-digit serial number or MAC address unique to the microphone.
DURATION (seconds)
The length of time before the next state change is scheduled to occur. This will approximately correspond to the length of time until the following log entry.
HEATER
Indicates whether the microphone's built-in heater was enabled during a given period.
heater means the heater was enabled at the listed time.
A blank entry means the heater was disabled at the listed time.
SENSOR
Indicates whether the primary or backup microphone sensor more closely matched the calibration target during the most recent sensitivity test. This is the microphone sensor the SMART MIC-1 will use for monitoring until the next sensitivity test.
PRIMARY_CAL (dBFS)
Records the measured amplitude of the test signal as recorded by the primary microphone element.
BACKUP_CAL (dBFS)
Records the measured amplitude of the test signal as recorded by the backup microphone element.
TARGET_CAL (dBFS)
Records the target amplitude for the sensitivity test. This value is user-defined for each Setting Profile.

Microphone Log File

Say a microphone log file includes the following lines:

DATE TIME,SN,DURATION,HEATER,SENSOR,PRIMARY_CAL,BACKUP_CAL,TARGET_CAL
2024-08-05 11:59:44.564490,9c.25.be.01.00.55,300.456991,,primary,,,
2024-08-05 12:04:47.248379,9c.25.be.01.00.55,597.186486,,backup,-30.34,-28.67,-25.00
2024-08-05 12:14:44.586711,9c.25.be.01.00.55,0.530147,heater,backup,,,

One way to read the contents more easily is to change the log file's extension from .txt to .csv and open it in a spreadsheet processor. When arranged in a table, the example file above might look like this:

DATE TIME SN DURATION HEATER SENSOR PRIMARY_CAL BACKUP_CAL TARGET_CAL
2024-08-05 11:59:44.564490 9c.25.be.01.00.55 300.456991   primary      
2024-08-05 12:04:47.248379 9c.25.be.01.00.55 597.186486   backup -30.34 -28.67 -25
2024-08-05 12:14:44.586711 9c.25.be.01.00.55 0.530147 heater backup      

Line 1 occurs at 11:59:45 AM, and the DURATION is 300 seconds, or 5 minutes. Line 2 occurs at 12:04:47 PM, or 5 minutes and 2 seconds after Line 1. Line 2 includes the results of a microphone sensitivity test, meaning this line corresponds to when that test occurred. The two-second discrepancy exists because a sensitivity test takes 2 seconds to complete, and the log file was updated after the test completed.

In Line 2, the backup microphone's sensitivity result was closer in value to the TARGET_CAL, or calibration target. Therefore, this microphone switched from its primary sensor to its backup sensor and continued using the backup sensor during the Line 3, when the heater turned on.