Connections for the CSVDataLog ActiveX control

The following table shows the connections to control the operation of the CSVDataLog ActiveX control at runtime.
Connections
Descriptions
FileLocation
Required
This is the complete path and filename of the CSV file the control will use, for example, "C:\DataStorePlus\File.csv".
This connection can be an explicit string or a string tag.
  • If set
    Start New Files
    with
    Never
    , the control will create a new file named as your configuration. The control will use the file for all logging.
  • If set
    Start New Files
    with
    Periodic
    or
    At specified Times
    , the control will create new file using the naming convention YYYY_MM_DD_HH_MM_NNNN_<filename>.csv.
    For example, if FileLocation is set to "c:\DataStorePlus\File.csv", the control will create a file named as "c:\DataStorePlus\2015_12_15_02_02_0001_File.csv".
Trigger
Required
The control uses an event to enable record writing.
When the assigned tag or expression transitions from a zero to a non-zero value, the control will append data to a CSV file until the tag value changes to zero.
When Handshake is configured, Trigger must be a tag.
A new CSV file will be created if:
  • A CSV file does not exist.
  • The control configured for
    Periodic
    or
    At Specified Times
    data collection.
Float01 - Float100
Optional
These connections are the analog tags that make up the data in each row of the CSV file. Assign analog tags to these connections.
It is recommended that the connections are specified as a contiguous list, for example, use connections 1-25 as opposed to connections 10-25 & 40-50.
When using the control to read data from a CSV file, these connections should be configured to use memory tags. The application should use a macro to copy the memory tags to controller tags.
String01 - String50
Optional
These connections are the string tags that make up the data in each row of the CSV file. Each string can be up to 82 characters long. Assign string tags to these connections
It is recommended that the connections are specified as a contiguous list, for example, use connections 1-25 as opposed to connections 10-25 & 40-50.
When using the control to read data from a CSV file, these connections should be configured to use memory tags. The application should use a macro to copy the memory tags to controller tags.
Handshake
Optional
This connection is used for coordinating the control's operations with the automation control system (PLC). Assign a Boolean controller tag to the connection.
If this connection is set, when the Trigger value is set from a zero to a non-zero value, the control object logs one line data for all associated tags. During this writing time, the Handshake connection is set to 1. It informs the PLC that the control is currently writing data to the CSV file. After the single line of data has been written, the Trigger and Handshake values are set to False (0) by the control, waiting for the next Trigger value transition from a zero to a non-zero value.
Provide Feedback
Have questions or feedback about this documentation? Please submit your feedback here.
Normal