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. 

==== comment ====

* With upload/XXX.sqlldr, you generate a _version_ "XXX",
  with all configurations (p, pgt, p_autotrg, p_zs_autotrg...). Usually
  the version should be 2007.X if it is intended as a production version
  (and also tagged in SVN, for documentation), or r1234, where 1234 is
  the subversion release. If I do not want to commit, I sometimes used
  r1234.01 or something like this. The r1234 releases rarely leave
  Muenster, and the r1234.42 should never.

* In some system, you will have tcc (TRAP cmmand converter) but not for
  TRAP chip but the "tiny C compiler". This is different stuff at all.
  Please uninstall it and install tcc package from TRD repository.


==== how to upload *.sqlldr into database ====

1. first login as oracle (login as root, and then login)
2. and set required environment variables 

  export ORAENV_ASK=NO
  export ORACLE_SID=wing
  . /usr/local/bin/oraenv

3. then upload

  sqlldr 'userid=trdfero/secret@trdro2:1521/wing.trd.net control=*.sqlldr log=import.log'

4. if you have a problem, then check username and passwd in /home/trd/.wingdb and make sure these are correct

EOF