Difference between revisions of "MCE Test Scripts"

From MCEWiki
Line 1: Line 1:
−
The following test scripts are found in SVN in the /mce_script/test_suite directory. The scripts are as follows:
+
Here are few scripts to help troubleshoot MCE hardware failures. They can be found under mce_script/test_suite.
 +
; mce_check
 +
: checks the health of the MCE by reporting the hardware status: Silicon ID, FPGA temperature, card temperature, firmware revision, hardware revision for each card in MCE crate. The output looks like [[mce_check_output]]
  
−
= Card-level Functional Test =
 
 
; card_all_test
 
; card_all_test
−
:this script is used to test the features common to all MCE cards on a particular unit-under-test.  
+
:this script is used to test the features common to all MCE cards on a particular card (unit-under-test). It queries the MCE for temperatures, silicon ID, firmware revision, hardware revision, toggles LEDs, etc.
 +
****** Check to make sure the LEDs on the target card switched status! ****
 +
Unit Under Test  :  rc1
 +
Serial Number    :  SRC-216
 +
Firmware Revision:  0x05010003
 +
card_id          :  0x20be502
 +
slot_id          :  [4]
 +
card_type        :  [2]
 +
card_rev        :  0
 +
fpga_temp        :  34 C pass
 +
card_temp        :  28 C pass
 +
results are in  :  /data/cryo/current_data/SRC-216_1285959943_all_test
 
; bc_test
 
; bc_test
−
:this script is used to test the DACs on Bias Cards. It does a fix-value test, ramp test, and a cross-talk test.
+
:this script is used to load test patterns into the DACs of a Bias Card and user can verify those patterns using a scope probe. It loads a fix-value, then ramp, and finally a cross-talk test between even and odd channels.
 +
 
 
; rc_test
 
; rc_test
−
: this script is used to test the DACs and etc... (under development)
+
: this script is used to test the serial and parallel DACs in a Readout Card. It loads certain patterns and user has to use a probe to verify the DAC output.
 +
 
 
; rc_noise_test_histogram  
 
; rc_noise_test_histogram  
 
: This script is used to test the integrity of the pre-amp chain and ADCs. This script collects 10 sets of 65k 50MHz samples of all channels and creates a histogram of all the data  and also a bit-ratio distribution to assess the ADC noise. The histograms are saved in postscript.  
 
: This script is used to test the integrity of the pre-amp chain and ADCs. This script collects 10 sets of 65k 50MHz samples of all channels and creates a histogram of all the data  and also a bit-ratio distribution to assess the ADC noise. The histograms are saved in postscript.  
 +
 
; hw_auto_cc  
 
; hw_auto_cc  
−
: This script tests the Clock Card FPGA's hardware interfaces.  Newer than hw_man_cc_2slotbp, uses some nifty code
+
: This script tests the Clock Card FPGA's hardware interfaces.
−
 
 
−
= System-level Functional Test =
 
−
; hw_man_mce
 
−
: Uses the SQUID Emulator Board (built by Bryce) that plugs into the MDM connectors in the back of the MCE, to test all the DACs and ADCs of the cards in the subrack, except for the Address Card's DACs.
 
−
; sys_auto_mce
 
−
: Reads MCE information like temperatures, slot-id's, etc, and reports the health of the MCE.
 
−
; mce_check
 
−
: Replaced by sys_auto_mce.
 
−
 
 
−
= Auxiliary scripts =
 
−
== Python Scripts ==
 
−
Here are Python scripts that are available for testing firmware, hardware and software.  Python scripts are eventually going to supersede Bash scripts, because of the ease of parsing data frames in Python, etc.  The following Pyton scripts currently exist, and are used for the following:
 
−
* fw_auto_cc_stop -- '''Incomplete'''.  Eventually this script will test all the different STOP command scenarios in the MCE.
 
−
 
 
−
== Bash Scripts ==
 
−
There are Bash scripts for testing firmware, hardware and software.  They are stored in SVN, in the following directory path: /home/mce/mce_script/test_suite.  The following Bash scripts currently exist, and are used for the following:
 
−
* addressing.scr -- Turns on Address Card normal multiplexing.  Not currently in SVN, but is stored on mce-ubc-2.
 
−
* biasing.scr -- Turns on Address Card fast feedback.  Not currently in SVN, but is stored on mce-ubc-2.
 
−
for determining the filename of the script, etc.
 
−
* hw_auto_cc_sram -- This script tests the SRAM interfaces on the Clock Card
 
−
* test_suite -- An agglomeration of all the other suites.  This will eventually be able to run everything.
 
−
* test_suite_library.bash -- A library of subroutine calls used to test the MCE
 
−
* sram_test -- '''Obsolete'''.  Replaced by hw_auto_cc_sram.
 
−
* hw_man_cc_2slotbp -- '''Obsolete'''.  This script tests the Clock Card FPGA's hardware interfaces.  It is very similar to hw_auto_cc.
 
  
−
= Helpful Links =
+
== Useful Links ==
−
* [[ MAS Cheat Sheet ]]
+
:[[Testing MCE Readout Cards]]
−
* [[ Using Python to Automate MAS ]]
+
:[[Testing MCE Bias Cards]]
−
* [[ MCE: Helper programs ]]
+
:[[Test Plans]]

Revision as of 11:15, 24 April 2012

Here are few scripts to help troubleshoot MCE hardware failures. They can be found under mce_script/test_suite.

mce_check
checks the health of the MCE by reporting the hardware status: Silicon ID, FPGA temperature, card temperature, firmware revision, hardware revision for each card in MCE crate. The output looks like mce_check_output
card_all_test
this script is used to test the features common to all MCE cards on a particular card (unit-under-test). It queries the MCE for temperatures, silicon ID, firmware revision, hardware revision, toggles LEDs, etc.
****** Check to make sure the LEDs on the target card switched status! ****
Unit Under Test  :  rc1
Serial Number    :  SRC-216
Firmware Revision:  0x05010003
card_id          :  0x20be502
slot_id          :  [4]
card_type        :  [2]
card_rev         :  0
fpga_temp        :  34 C pass
card_temp        :  28 C pass
results are in   :  /data/cryo/current_data/SRC-216_1285959943_all_test
bc_test
this script is used to load test patterns into the DACs of a Bias Card and user can verify those patterns using a scope probe. It loads a fix-value, then ramp, and finally a cross-talk test between even and odd channels.
rc_test
this script is used to test the serial and parallel DACs in a Readout Card. It loads certain patterns and user has to use a probe to verify the DAC output.
rc_noise_test_histogram
This script is used to test the integrity of the pre-amp chain and ADCs. This script collects 10 sets of 65k 50MHz samples of all channels and creates a histogram of all the data and also a bit-ratio distribution to assess the ADC noise. The histograms are saved in postscript.
hw_auto_cc
This script tests the Clock Card FPGA's hardware interfaces.

Useful Links

Testing MCE Readout Cards
Testing MCE Bias Cards
Test Plans
Retrieved from "https://e-mode.phas.ubc.ca/mcewiki/index.php?title=MCE_Test_Scripts&oldid=4963"