QuickStart Guide
...
Industrial Systems Connection ...
Generic

CSV Stream

8min

Review the following information for setting up and configuring the CSV Stream driver.

Litmus Edge Compatible Series

Compatibility parameter

Compatible items

Driver type

A TCP client used to connect to generic or protocol-less TCP servers, which send unsolicited data as a CSV Stream.

Configure CSV Stream Driver

Configure the following parameters. Update the default values to your specific setup.

Parameter

Value

Type

Generic

Driver

CSV Stream

Delimiter

,

Terminator

\n

Transport

TCP

Role

Client

Address

192.168.0.1

Port

1234

Configure the remaining settings as needed if they are enabled.

TLS Settings

Parameter

Value

Client Auth

Disable or Enable

CA Chain

Upload the file

Min TLS

Select one of:

  • TLS 1.0
  • TLS 1.1
  • TLS 1.2
  • TLS 1.3

Client Auth Settings

Parameter

Value

Certificate

Upload or copy the file.

Private Key

Upload or copy the file.

TCP Parsing

Select one of:

  • Non-Transparent Framing (RFC6587)
  • Octet Counting (RFC5425)
  • Single Message (RFC5426)

Advanced Settings

Parameter

Value

Timeout

1000

Max PDU

65536

Configure the List of Registers

When you Add Tags to the driver, a list of register names is not available. You must enter the case-sensitive register name in Field.

Note: Currently, Field is non-functional but required. You can enter any value to create a tag. All received rows from the device will be published to all tags.

The only value type available is string.

Tag Parameters

  • Field: Enter the case-sensitive register name.
  • Value Type: Select a data type from the drop-down list.
  • Tag Name: Enter a name for the tag.
  • Description (Optional): Enter a description for the tag.
  • Tag Formula: Enter a formula for the tag to process the generated data. Two variables are permitted: value (current tag value) and timestamp (current tag UNIX time in milliseconds). The following math functions are available:
    • sin
    • cos
    • sqrt
    • tan
    • power: power(x) performs the operation 10^x.
    • log: log(x) is the natural logarithm (the logarithm is in base e).
    • exp: exp(x) performs the operation e^x.
  • Only Publish on Change of Value: Select the checkbox to customize NATS messages to be published only when the value parameter changes from a previous value to a new one. Change of Value only applies to boolean, numeric (such as int or float), and simple string data types. It does not apply to complex types, such as JSON or array. Poll-once topics will not be affected by Change of Value settings. These topics will still only see a single message.
  • Meta Data: Metadata summarizes basic information about data. This feature allows you to define key-value pair data for the device output payload later on. It can then be used to find, use, and reuse particular instances of data.

Note: If you use special characters in meta data key names, the special characters are replaced with underscore characters in the payload. This can cause two key names to be combined into one. For example, configuring the key names a**b and a&&b will cause only one key name to be created (a__b).