= SPEC_CRE_setup =

{{{
// IMPORTANT NOTE: functionally similar to SPEC_cre_setup; see history
//                 to see new features
// Missionphase  : FM ILT
//
// Purpose       : Set CRE bias, ramps' length and capacitor values;
//                 Switch on blue heater
//
// Author        : Helmut Feuchtgruber
// CUS script    : Diego A. Cesarsky
//
//
// CRE setup according to the DEC/MEC User's Manual
//
// 1. DMC_SWON_B_DEC to switch on the DEC
// 2. Wait 5 seconds to get the 1355 connection between DEC and CPU board
// 3. Send the complete set of default parameters.
//    First send a DMC_WRT_B_SPEC_PAR command with these values
//    (in hex: 20-8-18C-0-0-EA60-0-0).
// 3a. Then, send a DMC_SET_PAR_B_SPEC to really send the parameters to the DEC.
// 4. DMC_SWON_B_SPEC to switch on the detector array
// 5. Wait 15 seconds to let the switch on procedure run and all voltages
//    become stables
// 6. Then, to activate the CREs (signal SELECT on the CREs), send the first
//    3 parameters, i.e. DMC_WRT_B_SPEC_PAR command with these
//    values (length: 3, values in hex : 20- 8-18E).
// 6a. Then, send a DMC_SET_PAR_B_SPEC to really send the parameters to the DEC.
//    Note: with this command, we set bit1 to 1 (activate CRE). Bit0
//    has been set to 1 by the DMC_SWON_B_SPEC command but,
//    bit0 is not commandable through the DMC_WRT_B_SPEC_PAR.
//    The only way to switch on/off the detector array is to use the
//    trigger commands.
// 7. Then, you should set the bias voltages by writing the first 4 or 5
//    parameters of the block. Make sure to copy the latest values you use
//    for the first 3 parameters.
//
// Description   : Sets CRE parameters (see list of arguments).
//                 User specifies cre_ctrl_xx as:
//                 cre_ctrl: 256 to set "sync width=2"
//                           128 to set "T sensor on"
//                             2 to set "select"
//                             1 power on (not relevant here)
//                 Script adds capa_xx to cre_ctrl_xx
//                     xx_cre_ctrl = capa_xx + cre_ctrl_xx
//                 xx_cre_ctrl gets written to the CRE register
//                 Switch on blue detector heater
//                 Must be called on a stopped SPU. This procedure will
//                 neither stop nor start SPU (call SPEC_spu_reset and
//                 SPEC_spu_setup respectively for that)
//
//
// Dependencies  :
//
// Comments      : Based on V1.3 of FGB's fgb_spec_cre_setup.tcl. Major
//                 change is getting ENG values for the bias voltages
//
// Version       : 0.1  7-Oct-2004 Creation by DAC
// History       : 0.2 12-Oct-2004 Removed "delay" statements
//                 0.3 18-Oct-2004 Normalized variable names
//                 0.4 21-Oct-2004 Added cre_ctrl_xx and heater_on
//                                 arguments to allow calling by
//                                 SPEC_orbit_prologue.
//                                 Removed heater commands
//                 0.5 27-Oct-2004 Put bck delay statement
//                 1.0 10-Apr-2006 HF, modified for FM
//                 1.1 16-nov-2006 Reviewed for use in OpDataBase
//                                 - removed "duree" computations
//                                 - moved "fix" arguments to body
//                                 - added heater, write receiver, and synch
//                                   commands
//
}}}
Input variables:
{{{
procedure SPEC_CRE_setup {
    int ramp_len_red = 64; // Red  ramp length
    int ramp_len_blu = 64; // Blue ramp length
    double bias_d_red = 0.07 in [0.0,1.0]; // BIAS_D for red spectro  (0-1V)
    double bias_r_red = 0.01 in [0.0,1.0]; // BIAS_R for red spectro  (0-1V)
    double bias_d_blu = 0.21 in [0.0,1.0]; // BIAS_D for blue spectro (0-1V)
    double bias_r_blu = 0.01 in [0.0,1.0]; // BIAS_R for blue spectro (0-1V)
    int capa_red = 12; // Capacitor red  (0=100fF,4=400fF,8=0.2pf,12=1pF)
    int capa_blu = 12; // Capacitor blue (0=100fF,4=400fF,8=0.2pf,12=1pF)
    double blue_heat_current = 1.5 in [0.0,10.01]; // Current [mAmp]
}{
}}}