========================
data_format.txt
$Id$
========================

This file describes format of data files.

-----------
.dat Format
-----------

This is a standard format of tcc output. It has been used for long time.
It contains lines like

       10 2003 3333 127 1

here 10 is SCSN command (in this case 10 is write command),
2003 is address in TRAP chip,
and 3333 is data. 127 is slave ID, and 1 is additional line number
which you can ignore. Command can also be SCSN pseudo command.
Command set is described in TRAP user's manual.

-----------
.tdt Format
-----------

This is "Extended text based data format".
Addition to SCSN commands and SCSN pseudo commands, it can contains
special commands to be understood by Control Engine itself (CE commands).

-----------
.bdt Format
-----------

This is extended binary data format. This is binary version of .tdt file.

-----------
CE Commands
-----------

Here is the proposed set of Control Engine special Commands (CE Commands).
Please be careful that command 0 to 15 was reserved for SCSN and SCSN pseudo
commands. See TRAP manual for precise definitions. Therefore, it is
proposed to assign numbers from 16 to 126 for the CE Commands.


* 32 SCSN-command

 Set the default SCSN command. It should take one argument.
 Example:

   32 10

 changes default SCSN or SCSN pseudo command to be write (=10).

* 42 linkpair0 linkpair1 linkpair2 linkpair3

 Link setup. This is used to setup the default link or enable and
 disable for all linkpairs. It requires four arguments.
 Example:

   42 0 1 1 -1

 changes so that commands are sent to link0 or linkpair0,
 link1 of linkpair 1 and 2, and nothing is sent to linkpair 3.

* 50

 Chip selection in SCSN Slave ID.
 Following operations should be done for only
 specified chips. This command can take maximum 3 arguments.
 Example:

   50 127
   50 1 15

 first line specify broadcast. second line specify only chip
 from 1 to 15.

* 51

 Chip selection in ALICE ID. To be defined.

------------------------
 example:

   42   0 0 0 0    ... all linkpair use link 0, following commands are
                       sent to all linkpairs.
   32   10         ... default command is 'write'
   50   127        ... broadcast to all chip in linkpair is selected.
   2000 500        ... write 500 to address 2000 for all chips in all linkpairs.
   42   0 -1 -1 -1 ... now only linkpair0 is active.
   50   1 16       ... following commands should be sent only to chip 1 to 16.
   2001 501        ... this command is sent only to chip 1 to 16 in linkpair 0 using link 0
   2002 502 20     ... In this case it is sent only to chip 20 (old format) in linkpair 0 using link 0
                       setup by 50 1 16 is simply ignored.

** .tdt can have any number of blank line, and any line contains non digit is ignored.


EOF