README for TRAPconfig
=====================

The TRAPconfig package contains code and configuration data for the
TRAP chips in the ALICE TRD. 

The code is provided as .tcs files containing configuration commands
for the TRAP chips, .asm files with assembler code and .DAT files
containing extended SCSN commands. These files are translated to .dat
files that contain low-level commands to be sent to the SCSN bus. The
files (also called scripts) can be grouped into configurations that
define a list of actions to be performed to configure the detector for
a specific purpose. Files ending in .DAT are copied verbatim to create
the corresponding .dat file.

The .tcs and .asm files are stored in the src/ directory tree. The
common/ subdirectory is for code used by many configurations, params/
are FEE configurations.

Configurations are stored in the configurations/ directory. Each .cfg
file in this directory contains a list of .dat files - without the
leading src/ and the trailing .dat - in the source tree, that will be
concatenated to produce the final configuration file. 

The code can be compiled into a sqlldr file suitable for upload to a
wingDB by `make upload/FILENAME.sqlldr`. `make compat` produces a .dat
file for each configuration containing all commands to be sent for
this configuration, mainly for sanity checks.