Difference between revisions of "MCE Test Scripts"

From MCEWiki
(→‎Bash Scripts)
 
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
The following test scripts are found in SVN in the /mce_script/test_suite directory. The scripts are as follows:
+
{{Related|Testing}}
 +
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]]
  
−
= Python Scripts =
+
; card_all_test
−
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:
+
: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.
−
* fw_auto_cc_stop -- '''Incomplete'''.  Eventually this script will test all the different STOP command scenarios in the MCE.
+
  ****** 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.
  
−
= Bash Scripts =
+
; rc_test
−
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:
+
: 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.
−
* 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.
 
−
* hw_auto_cc -- This script tests the Clock Card FPGA's hardware interfaces.  Newer than hw_man_cc_2slotbp, uses some nifty code for determining the filename of the script, etc.
 
−
* hw_auto_cc_sram -- This script tests the SRAM interfaces on the Clock Card
 
−
* hw_man_mce -- Uses the SQUID Emulator Board (built by Bryce) 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.
 
−
* 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
 
−
* mce_check -- '''Obsolete'''.  Replaced by sys_auto_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.
 
−
* rc_noise_test_histogram -- 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.
 
−
* card_all_test -- this script is used to test the features common to all MCE cards on a unit-under-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.
 
  
−
= Helpful Links =
+
; rc_noise_test_histogram
−
* [[ MAS Cheat Sheet ]]
+
: 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.
−
* [[ Using Python to Automate MAS ]]
+
 
−
* [[ MCE: Helper programs ]]
+
; hw_auto_cc
 +
: This script tests the Clock Card FPGA's hardware interfaces.
 +
 
 +
== Useful Links ==
 +
*[[Testing MCE Readout Cards]]
 +
*[[Testing MCE Bias Cards]]
 +
 
 +
[[Category:MCE Script]]
 +
[[Category:Testing]]

Latest revision as of 18:05, 31 August 2016

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

Retrieved from "https://e-mode.phas.ubc.ca/mcewiki/index.php?title=MCE_Test_Scripts&oldid=6588"