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.
- SENSOR
- Indicates whether the
primaryorbackupmicrophone 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.