Header

OpenFormat Zero supports different Header information to setup the data handling in LogView Studio. As a minimum you must send the $N$ and $C$ header because LogView Studio uses it for a dataset change detection and Database enhancement. All other header are optional. As mentioned in last chapter all header lines have to end with CR LF (\r\n).

You can use all command with an additional channel setting (<CHN>) to use the OpenFormat Zero in a multi Channel scenario.

Please take a look at the chapter Multi Channel Usage to get a better understanding how this works.

If you don't send a channel information LogView Studio will always use Channel 1 as a default.

General Information for the Header Settings

Header Settings are valid as long as you don't change them. You can set the Columns once and send multiple datasets. All datasets will use the same Columns. Same for Factor, Offsets and Timesettings.

$N<CHN>$;DatasetName

Set the Dataset Name in LogView Studio and indicates the start of a new dataset.

If you only send $N$; LogView Studio will use a Default dataset name.

Note: This header is mandatory for a new dataset!

$C<CHN>$;Temp 1 [°C,T];Voltage[V];Current

Set the columns which will be received in the data part. Each column is separated by a ; (semicolon).

As you can see the Column name can be supplemented by one or two values in [].

The first value is the Unit and the second value is the Symbol. You can also use only one additional value. In that case you have to transmit the Unit.

It's also possible to send only the Column name.

Note: The Column count must match the data item count !

$V<CHN>$;VALUE

You can set the value format for the data lines. Valid Values are HEX and DOUBLE.

If you don't set this value the Default is DOUBLE.

$L<CHN>$;Level;LogText

You can send Log Messages to LogView Studio. They appear in the LogView Logging system. You can use this feature to send some Debug information.

Level can be set to the following values:
E = Error

W = Warning

V = Verbose

If you only set the LogText the Default Level is Verbose.

$F<CHN>$;Factor1;Factor2;....

$O<CHN>$;Offset1;Offset2;....

$S<CHN>$;SumOffset1;SumOffset2;.....

LogView can calculate the value based on three values : Factor, Offset, Sum Offset.

The formula for this is : y = (x + t1) * m + t2

y is the resulting value which will be stored in LogView Studio.

x is the value from your Device.

m is the Factor

t1 is the Offset

t2 is the Sum Offset

Note : Factor, Offset and SumOffset must have the same count as the data items count!

$R<CHN>$

Reset the Time Settings to Time Mode Receivedate.

$T<CHN>$;1;yyMMdd

Set the Time Settings to Time Mode TimeGiven.

The first parameter (1) indicates the Time position in the data line (value starts with Index 0 !)

The second parameter sets the given DateTime Format.

$I<CHN>$;1000;28042013_120005123

Set the Time Setting to Time Mode Increment.

The first parameter is the increment in Milliseconds.

The second parameter is optional and indicates the Start Date Time. The Format is : DDMMYYYY_HHMMSSFFF (FFF = Milliseconds).

Note : See Time Formats for more details.