Codecore Logo
Quick Search
»
Advanced Search »

Log File Driver

RSS
Allows logging device property values at timed intervals to a comma separated value (csv) file (or tab separated value file).

For example you could save your thermostat temperature(s) to a csv file every 15 minutes.

The 1st logged field will always be the date and time. Do not include it in the FieldNames or FieldValueScripts parameters.

Unexpected property values may be logged when the system starts up since some of the device property may not yet be known. For example the ElkM1 driver's heat set point temperature (which is initialized as -999) may not have been read yet at the time this driver logs it's value, so -999 would be written as it's value until the actual value was read from the ElkM1 panel.

This driver allows multiple instances.


Driver Parameters

  • FirstLogEntryDelay: (optional) The time duration to wait after the driver starts to log the first entry. This gives other drivers time to start up and initialize their property values. The default in 60 seconds. Format: [days.]hours:minutes[:seconds] Days and seconds are optional, denoted by the square brackets. Example: 00:01:30 represents 1 minute and 30 seconds.

  • LoggingInterval: The time duration between logging entries. Format: [days.]hours:minutes[:seconds] Days and seconds are optional, denoted by the square brackets. Example: 00:01:30 represents 1 minute and 30 seconds.

  • FilePath: The file path of the log file.

  • FieldNames: Comma separated list of field names.

  • FieldValueScripts: The field value scripts.
    Example: elkm1.Outputs[1], elkm1.Outputs[2]


  • Delimiter: (optional) The field value delimiter when saving to the log file. Defaults to a comma ','. Use '\t' for tab.

Events

none

Instance Methods

LogNow

Forces the driver to log now.

Syntax:

void LogNow( )

Parameters:

none

Example:

temperaturelog.LogNow( );
Privacy Policy | Conditions Of Use

Copyright ©2014 Codecore Technologies, All rights reserved.