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 and .asm files with assembler code. 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,
generally in the common/ subdirectory if the code is used by many
configurations, or in a subdirectory named as the configuration for
configuration specific code. The code is translated to a .dat file by
the same name in the same directory, where a number of intermediate
files is generated for assembler code.

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. 

Currently, the dafault target of the Makefile produces the .dat files
in the src/ tree. `make compat` produces a .dat file for each
configuration containing all commands to be sent for this
configuration. A future target will provide a file suitable for upload
to the wingDB and usage for PVSS/ICL/FeeServer based configuration.