Files and Folders - LIFsCode/ELOC-3.0 GitHub Wiki

File Names and Folders

Initial Setup

  • ELOC Boot-Up: Upon booting the ELOC with an SD card inserted, a folder named eloc is automatically created in the root of the SD card.

SD_root

SessionID - Session Folder

  • Initiation: Press the Recording/Detecting button to start a session. This action:
    • Generates a unique SessionID.
    • Creates a new folder on the SD card in the eloc folder, named after the SessionID.
  • New Sessions: Each new session gets a different SessionID and a corresponding new folder.
  • Composition: The SessionID consists of the Timestamp (in Unix format) when the recording session starts.
    • Example: 1702641306844
    • Structure: Timestamp (1702641306844) in epoch format, indicating the start time of the recording session.

Add picture of folder here

File Names

Files from each session are stored in the folder corresponding to the SessionID.

Sound Recordings

  • Example: Grid28_1702641306844_2022-07-17_08-41-52.wav
  • Structure: FileHeader_SessionID_TimeStamp
    • FileHeader: Settable in Settings -> File Header.
    • SessionID: See above.
    • TimeStamp: Represents the time the file was created on the SD card.
    • Special Case: If the FileHeader is "not_set," the filename becomes SessionID_Timestamp.wav.

List of Detected Events

If detecting is enabled, a list of all detected events with timestamps is stored in a CSV file.

  • Example: Grid28_1702641306844_2022-07-17_08-41-52.csv
  • Structure: Same as Sound Recordings.

Meta Data

Two files are automatically generated with each SessionID in the same folder. These contain settings and status information like Sample Rate, Battery State, Location, etc.

  • elocStatus: [Link to elocStatus example]
  • elocConfig: [Link to elocConfig example]

Add picture of files here

Log Files

  • Enable Logs: In Settings -> Advanced Settings -> [Option].
  • Storage: A folder named log is created at the root of the SD card.
  • Structure: Log files are stored in this folder, split into multiple files.

Screenshot 2023-12-19 114446

Load Configs from SD card

The ELOC will check at boot for the file eloctest.txt and will boot with the settings found in eloctest.txt. You can use the content from elocConfig.json and copy it into the eloctest.txt