• svn co http://edf.bu.edu/svn/edf/semiray/AMCT_Python_Tool/dev_tools (Note: codes are located inside the dev_tools)

AMCT Purpose

Installation

Python 2.7.12 Installation

• pip install ipython

• svn co (code_link) (Note: AMCT tool is inside the dev_tool package)

Python 2.7.12 Installation to Virtualenv

• export PATH=~/bin:~/python2.7/bin:~/vim/bin:$PATH

> dev_tools]$ amct --help
Usage: amct [OPTIONS] COMMAND [ARGS]...

Options:
  -v, --verbose
  -d, --debug
  -l, --log-level [INFO|DEBUG|WARNING|ERROR|CRITICAL]
  -c, --config PATH               Global configuration
  --version                       Show the version and exit.
  -h, --help                      Show this message and exit.

Commands:
  amctool    Utilities for testing AMC13 interactively.
  firmware   Operations for testing AMC13 firmware.
  testsuite  Run predefined test-suites against AMC13...

• amc.run('any AMC13Tool2_command') # run=do (select your favorite one.)

Testing AMC13 Cards Using Scripted Mode

• cd dev_tools (note: dont forget to activate virtualenv)

amct --verbose testsuite run --name c01 -i 161/c

(SN =161 and c01: a folder that contain the test1.pyamc script)

INFO	13772 [08/17/2016 14:02:51]:	Testsuite c01 finished OK

STATUS.SFP.SFP0.EVENTS_BUILT error, expected: 6, observed: 5

• cd ~/amc13
• wget http://www.python.org/ftp/python/2.7.12/Python-2.7.12.tgz
• tar -zxvf Python-2.7.12.tgz

Virtualenv Installation

Python 2.7 Installation to Virtualenv

• cd Python-2.7.12
• make clean
• ./configure --prefix=/home/${USER}/.localpython
• make
• make install
• pip install ipython

Now you have python 2.7.12 and ipython in virtualenv.

• svn co (code_link) (Note: AMCT tool is inside the dev_tool package)

• cd ~/amc13

• svn co http://edf.bu.edu/svn/edf/semiray/AMCT_Python_Tool/dev_tools/ (Note: AMCT tool is inside the dev_tool package)
• cd dev_tools

Testing AMC13 Cards Using Interactive Mode

>amc.do('en 1-12 f t')
>amc.do('localL1A o 1') 
>amc.do('lt 5') 
>amc.do('rv STATUS*')
>amc.do('re') #etc...

>amc.do('en 1-12 f t')
>amc.do('localL1A o 1') 
>amc.do('lt 5') 
>amc.do('rv STATUS*')
>amc.do('re') #etc...

> print amc.do('nodes t1 *ttc*error*')
9 nodes matched
0: STATUS.TTC.BCNT_ERROR                                        (addr=00000000 mask=00000040)  r
1: STATUS.TTC.BCNT_ERRORS_HI                                    (addr=00000045 mask=0000ffff)  r
2: STATUS.TTC.BCNT_ERRORS_LO                                    (addr=00000044 mask=ffffffff)  r
3: STATUS.TTC.MULT_BIT_ERROR                                    (addr=00000000 mask=00000100)  r
4: STATUS.TTC.MULT_BIT_ERRORS_HI                                (addr=00000043 mask=0000ffff)  r
5: STATUS.TTC.MULT_BIT_ERRORS_LO                                (addr=00000042 mask=ffffffff)  r
6: STATUS.TTC.SGL_BIT_ERROR                                     (addr=00000000 mask=00000080)  r
7: STATUS.TTC.SGL_BIT_ERRORS_HI                                 (addr=00000041 mask=0000ffff)  r
8: STATUS.TTC.SGL_BIT_ERRORS_LO                                 (addr=00000040 mask=ffffffff)  r

>amct amctool ipython -i 322  ## SerialNumber=322

>amct amctool python -i 322

>r1 = amc.get_registers()    : get  registers
>r1['STATUS.AMC01.COUNTERS.AMC13_AMC_EVENTS_LO']check specific register
>amc.do('en 1-12 f t')    : create fake events
>amc.do('localL1A o 1 1')    : configure localL1A)
>amc.do('lt 5')    : send 5 triggers
>r2 = amc.get_registers()    : get  registers
>r2['STATUS.AMC01.COUNTERS.AMC13_AMC_EVENTS_LO']    : check specific register after send 5 trig.
>rdiff = amc.diff_registers(r1, r2)    : define diff function to check the differences with/without trig.
>rdiff['STATUS.AMC01.COUNTERS.AMC13_AMC_EVENTS_LO']    : check diff of registers with/without trig.

AMCT Python Software

General Explanations

The goal is to develop a set of routines to automatically (i.e. without human intervention) test AMC13 hardware using python language. Tests will exercise the functionality of the AMC13 card(s) and report errors/failures. The tool allows for a detailed testing of the AMC hardware in both supervised and non-supervised fashion and it is meant to be used as a part of the production and quality testing of the AMC13 hardware.

For python tool, typically you need to use `virtualenv` to create a separate python environment and install all dependencies. It creates a folder which contains all the necessary executables to use the packages that a Python project would need. Before starting, make sure you have `pip` and `virtualenv`. Use your favorite package manager to install them.

Installation

• cd amc13
• make
• source env.sh
• cd ~/amc13/dev_tools
• svn co (code link)
• wget https://bitbucket.org/techtonik/locally/raw/tip/06.get-virtualenv.py
• python 06.get-virtualenv.py
• python .locally/virtualenv.py virtualenv

amc.do('en 1-12 f t ')

amc.do('localL1A o 1 ') 

amc.do('lt 5') 

amc.do('rv STATUS*')

amc.do('re') #etc...

amc.run('en 1-12 f t ')

amc.run('localL1A o 1 ') 

amc.run('lt 5') 

amc.run('rv STATUS*')

amc.run('re') #etc...

print amc.do('any AMC13Tool2_command') 

amctool ipython -i 322  ## SerialNumber=322

amctool python -i 322 

r1 = amc.get_registers() # get  registers

r1['STATUS.AMC01.COUNTERS.AMC13_AMC_EVENTS_LO'] #check specific register

amc.do('en 1-12 f t') # create fake events

amc.do('localL1A o 1 1') #localL1A

amc.do('lt 5') #send 5 triggers

r2 = amc.get_registers() # get  registers

r2['STATUS.AMC01.COUNTERS.AMC13_AMC_EVENTS_LO'] #check specific register after send 5 trig.

rdiff = amc.diff_registers(r1, r2) # define diff function to check the differences with/without trig.

rdiff['STATUS.AMC01.COUNTERS.AMC13_AMC_EVENTS_LO'] #check diff of registers with/without trig.

AMCT

-- SemirayGirgisChyla - 08 Aug 2016