TSD V1.13
=========

The general syntax of TSD.EXE is "TSD cmd USB-drive-letter [switch|file]" where 
cmd is a letter which represents the command. Note, that the '*' letter symbol 
can be used as a placeholder for the first found SICOLOG USB stick.

Following commands are available: copy from/to, (un)erase, mark as (un)saved, 
copy CAN messages, repair header/measurement, update measurement's time zone, 
eject USB stick.


Unerase a SICOLOG measurement
-----------------------------

Example: TSD u f:

This command unerases a SICOLOG measurement on the USB stick if the stick is 
mounted as drive with the letter "F:".


Copy a SICOLOG raw measurement from a USB stick into a file
-----------------------------------------------------------

Example: TSD c f: data.bin

This command copies the raw measurement from the USB stick which is mounted as 
drive with the letter "F:" into the file "data.bin".


Copy a SICOLOG raw measurement from a file into a USB stick
-----------------------------------------------------------

Example: TSD D f: data.bin

This command copies the raw measurement from the file "data.bin" into the USB 
stick which is mounted as drive with the letter "F:". Note, that the USB stick 
must not already contain a valid measurement, but it must be already formatted 
as a SICOLOG USB stick (e.g. the structure "\TELLERT\SICOLOG" must already 
exist).


Invalidate a measurement header
-------------------------------

Example: TSD i f:

This command invalidates a SICOLOG measurement header. This command can be used 
prior a repair operation, and to enforce a repair. This command can be used on 
any SICOLOG measurement without negative impacts.


Repair header
-------------

Example 1: TSD h f:
Example 2: TSD h f: -f
Example 3: TSD h f: 500000
Example 4: TSD h f: -f 500000 1000000

This command just rewrites the header signature and can be used on any SICOLOG 
measurement without negative impacts (as long as the correct CAN-bitrates in bps
for CAN#1/CAN#2 are specified in case of a scanned CAN measurement. Note, that 
the CAN-bitrates for CAN#3 and CAN#4 are unimportant.
The timestamps of the CAN-messages for CAN#1 and/or CAN#2 will be output as 
64-bit-hex-counters instead of a real time values in case of a zero/unspecified
value for the CAN bitrate.)


Repair measurement
------------------

Example 1: TSD r f:
Example 2: TSD r f: -f

CAUTION: Please make a backup of the files before using the command "r" because 
it is very intrusive. 

With this command every signature and item of the header is rewritten. And also 
the sample's end position is searched until an invalid token is found in the 
stream.


Repair measurement with total measurement stream
------------------------------------------------

Example 1: TSD R f:
Example 2: TSD R f: -f

CAUTION: Please make a backup of the files before using the command "R" because 
it is very intrusive. 

With this command every signature and item of the header is rewritten. And also 
the sample's end position is reset to the entire measurement stream.


Repair measurement without timestamp check of the measurement stream
--------------------------------------------------------------------

Example 1: TSD t f:
Example 2: TSD t f: -f

CAUTION: Please make a backup of the files before using the command "t" because 
it is very intrusive. 

With this command every signature and item of the header is rewritten. And also 
the sample's end position is searched until an invalid token is found in the 
stream. Note that an invalid timestamp does not cause an invalid token, and that
the first fast or slow sample defines the corresponding sample size.


Extracing CAN samples
---------------------

Example 1: TSD s f:
Example 2: TSD s f: data.log

This command copies the raw CAN samples of a scanned CAN from the USB stick 
which is mounted as drive with the letter "F:", and stores it, for example 2,
into the file "data.log".
