Sidewalk_Arbitrary_Switchboard.cmd ---------------------------------- L1Cal IIb GUI command file 23-Feb-2006 O. General ---------- The goal for this command file is to present the full granularity of all actions used in the standard tests currently used at the sidewalk test of the L1Cal IIb System. This is an alternative to using one of the other Sidewalk*.cmd which provide a one-click full cold start setup of part of or the whole system. This command file does not use or invoke any of the other Sidewalk*.cmd files (except for Sidewalk_Arbitrary_DefineAdfSlots.def). This command file displays the following menu of choices and then waits for the operator to request an option by entering its number at the prompt. 0) Quit 1) Set Scope: Single Card 2) Set Scope: Full System 3) Set Scope: Arbitrary (Re-Read Def) 4) Configure FPGAs (T7) 5) Standard Initialization of ADF 6) Run Find_DAC on all Channels 7) Load Pseudo-Random Seeds 8) Load Fixed Values Constant 9) Load Fixed Values Pallet 10) Send to TAB: BLS Signal on LiveX 11) Send to TAB: Pseudo-Random on LiveX 12) Send to TAB: Pseudo-Random Always 13) Send to TAB: Fixed Value Always 14) De-Skew (Original) Perform Action: After a specified option has been executed by the command file, the menu is displayed again and the command file waits for the the next request. I. Returning to normal GUI control ---------------------------------- 0) Quit Select Option #0 "Quit" to return to normal L1Cal IIb GUI operation. II. Controlling the Scope ------------------------- The word Scope is used to represent the Set of ADF cards controlled via this command file 1) Set Scope: Single Card 2) Set Scope: Full System 3) Set Scope: Arbitrary (Re-Read Def) The Sidewalk_Arbitrary_Switchboard L1Cal GUI command file starts by reading the file Sidewalk_Arbitrary_DefineAdfSlots.def to learn which arbitrary set of ADF cards are being targeted. The operator specifies in Sidewalk_Arbitrary_DefineAdfSlots.def which or the 20 ADF card slots from each of the 4 ADF crates is currently included. Option #1 "Set Scope: Single Card" overrides the current ADF Card set to include only one ADF Card that the operator interactively identifies by its Crate Number (0..3) and Slot Number (2..21). Option #2 "Set Scope: Full System" overrides the current ADF Card Set to include all ADF Cards from all 4 ADF Crates. Option #3 "Set Scope: Arbitrary (Re-Read Def)" overrides the current ADF Card set by re-reading Sidewalk_Arbitrary_DefineAdfSlots.def III. Configuring ADF FPGAs -------------------------- 4) Configure FPGAs (T7) Option #4 "Configure FPGAs (T7)" will ask L1Cal TCC to configure (i.e. load Firmware into) all FPGAs from all ADF Cards in the current Scope using the "T7" ADF Test Firmware. This step is always required after power up. IV. Initializing ADF Cards -------------------------- 5) Standard Initialization of ADF Option #5 "Standard Initialization of ADF" will ask L1Cal TCC to perform the standard initialization of all the ADF Cards in the current Scope. cf. http://www.pa.msu.edu/hep/d0/ftp/run2b/l1cal/tcc/ l1cal_iib_tcs/adf_initialization.txt This step is always required after FPGA Configuration. The Et Lookup programmed into the ADF Cards via this initialization method is a one-to-one mapping, meaning that the Raw E Filtered data is sent as Output Et when the "BLS Signal" source is selected (cf. VIII). V. Adjusting ADF Analog Input Pedestals --------------------------------------- 6) Run Find_DAC on all Channels Option #6 "Run Find_DAC on all Channels" will ask L1Cal TCC to run the Find_DAC algorithm on all Analog Input Channels of all the ADF Cards in the current Scope. The targeted Zero Energy Response for the analog Front-End is set at 50 counts of digitized Raw E energy. The Et Lookup programmed during the default initialization (cf. IV) being a one-to-one mapping, 50 counts will also be the Zero Energy Response of the data sent to the TAB Cards when sending "BLS Signals" (cf. VIII). This step is not required after initialization (cf. IV) unless the operator plans on sending the "BLS signals" to the TAB Cards (cf. VIII). VI. Loading Seeds for Pseudo Random generator --------------------------------------------- 7) Load Pseudo-Random Seeds Option #7 "Load Pseudo-Random Seeds" will program the pre-defined set of Pseudo-Random Seeds in all 32 Channels of all the ADF Cards in the current Scope and synchronously start all 32 Channels of each ADF Cards in a manner compatible with proper operation of the Saclay Channel Link Tester (aka. BigBrother) Loading the Pseudo-Random Seeds does not change the programming of the Fixed Output Et values (cf. VII), nor does it affect what data type is being sent to the TABs via the Channel Links (cf. VIII). This step is not required after initialization (cf. IV) unless the operator plans on sending pseudo-random data to the TAB Cards (cf. VIII). VII. Loading Fixed Output Et values ----------------------------------- 8) Load Fixed Values Constant 9) Load Fixed Values Pallet After Initialization (Option #5), the ADF Cards have already been initialized for normal operation, which includes programming the value of 8 counts as the Fixed output Et value. This value is used in normal operation as the value sent to the TABs on non-live Beam Crossings. Option #8 "Load Fixed Values Constant" will interactively request a new fixed value to load in all EM Channels and another value to load in all HD Channels of all the ADF Cards in the current Scope. Option #9 "Load Fixed Values Pallet" will load a pre-defined set of values into each channel of all the ADF Cards in the current Scope. This set of values is meant to help verify the proper cabling of the ADF-to-TAB : The EM value will encode the Trigger Tower Eta index, with the most significant bit encoding the eta polarity (0=positive, 1=negative) and the lower 7 bits encoding the eta magnitude (1:20). i.e. positive eta= +E encoded with EM data value = E and negative eta= -E encoded with EM data value = 128 + E The HD value will encode the Phi index (1:32). i.e. phi= P is encoded with the HD data value = P Changing the Fixed Output Et values does not affect the operation and synchronization of the pseudo-random generators (cf. VI), nor does it affect what data type is being sent to the TABs via the Channel Links (cf. VIII). This step is not required after initialization (cf. IV), if the operator is planning on sending Pseudo-Random Data on all Crossings. This step is not required after initialization (cf. IV), unless a value different than the default Fixed Output Et is desired. The default Fixed Output Et after initialization corresponds to Option #8 "Load Fixed Values Constant" while selecting 8 counts for both EM and HD Channels. VIII. Selecting which data is being sent to the TABs ---------------------------------------------------- 10) Send to TAB: BLS Signal on LiveX 11) Send to TAB: Pseudo-Random on LiveX 12) Send to TAB: Pseudo-Random Always 13) Send to TAB: Fixed Value Always These options control which data is being sent as Output Et by the ADF Cards to the TAB Cards. Option #10 "Send to TAB: BLS Signal on LiveX" will program all Channels of all the ADF Cards in the current Scope to send the BLS Signal (more precisely the result of the digitization and filtering of that signal) to the TABs for all 36 Live Beam Crossings of each Accelerator Turn. The Fixed Output Et value (cf. VII) will be substituted for all non-Live Beam Crossings. Option #11 "Send to TAB: Pseudo-Random on LiveX" will program all Channels of all the ADF Cards in the current Scope to send the Pseudo-Random Data Pattern (cf. VI) to the TABs for all 36 Live Beam Crossings of each Accelerator Turn. The Fixed Output Et value (cf. VII) will be substituted for all non-Live Beam Crossings. Option #12 "Send to TAB: Pseudo-Random Always" will program all Channels of all the ADF Cards in the current Scope to send the Pseudo-Random Data Pattern (cf. VI) to the TABs for all Beam Crossings of each Accelerator Turn. Option #13 "Send to TAB: Fixed Value Always" will program all Channels of all the ADF Cards in the current Scope to send the Fixed Output Et value (cf. VII) to the TABs for all Beam Crossings of each Accelerator Turn. Changing the type of data being sent to the TABs does not change the programming of the Fixed Output Et values (cf. VII), nor does it affect the operation and synchronization of the pseudo-random generators (cf VI). It only changes which data is being sent to the TABs via the Channel Links. The default after initialization (cf. IV) corresponds to Option #10 "Send to TAB: BLS Signal on LiveX" IX. Channel Link De-Skew ------------------------ 14) De-Skew (Original) Option #14 "De-Skew (Original)" will initiate a Channel Link De-Skew operation on all HD Channels of all the ADF Cards in the current Scope. De-Skewing the Adf-to-TAB Serial Communication Channel Links does not change the programming of the Fixed Output Et values (cf. VII), nor does it affect the operation and synchronization of the pseudo-random generators (cf VI), nor does it affect what data type is being sent to the TABs via the Channel Links (cf. VIII). This step is not required after initialization (cf. IV) as de-skewing is part of the normal initialization of the ADF Card. This step is not required after changing the type of data being sent to the TABs (cf. VIII), nor after changing the Fixed Output Et values (cf. VII), nor after loading pseudo-random generators seeds (cf VI). This step is however always required any time an ADF-to-TAB cable has been unplugged, or any time a TAB Card has been powered up. ----------------------------------------------------------------------- Appendix -------- Example #1: ----------- In order to set up the full system to send Pseudo-Random data on all Crossings: Select this sequence of steps: 2, 4, 5, 7, 12 This achieves the same result as Sidewalk_Full_PseudoRandom.cmd Example #2: ----------- In order to set up the full system to send Fixed Data on all Crossings: Select this sequence of steps: 2, 4, 5, 8, 13 This achieves the same result as Sidewalk_Full_Fixed_Em55HdAA.cmd while the operator here gets to pick the fixed values. Example #3: ----------- In order to set up the full system to send BLS Data (with a Zero Energy Response of 50 counts) on Live Crossings (and the fixed value of 8 counts on all non-Live Crossings): Select this sequence of steps: 2, 4, 5, 6 This achieves the same result as Sidewalk_Full_Setup_for_BLS_Signals.cmd