This repository houses calibration and control scripts for the HMCAD1511 ADC chips on the CASPER SNAP board.
To install, download and run
sudo python setup.py install
You will need the numpy and katcp python packages.
To program a board and calibrate, from the command line, run:
snap_init snapname boffile [-d 1,2 or 4]
where snapname is the hostname / IP of SNAP board, boffile is the name of the bof to run, and -d selects the demux factor of
snap_init HOST BOF_FILE [OPTIONS]
positional arguments:
host specify the host name
bof specify the bof file to load unto FPGA
optional arguments:
-h, --help show this help message and exit
-d DEMUX_MODE, --demux DEMUX_MODE
Set demux mode 1/2/4
-g GAIN, --gain GAIN Possible gain values (choose one): { 1 1.25 2 2.5 4 5
8 10 12.5 16 20 25 32 50 }, default is 1
-k KATCP_PORT, --katcp_port KATCP_PORT
KATCP port to use (default 7147)
-c CHIPS [CHIPS ...], --chips CHIPS [CHIPS ...]
Input chips you wish to calibrate. Default all chips:
a b c.
-s, --silent Silence all logging info.
-v, --verbose Verbose mode, for debugging.
To plot data from the ADCs from the command line, run:
snap_plot snapname [options]
positional arguments:
host specify the host name
optional arguments:
-h, --help show this help message and exit
-p KATCP_PORT, --port KATCP_PORT
KATCP port to connect to (default 7147)
-d DEMUX_MODE, --demux DEMUX_MODE
ADC demux mode (1, 2 or 4)
-r, --remote Faster plotting for remote connection
-f, --fft Plot ADC channel bandpass (i.e. take FFT^2 of snapshot
data)
-T, --deskewpattern Plot test pattern (deskew). Value should be a constant
42.
-R, --ramppattern Plot test pattern (ramp)
To program the board from a script:
from snap_control import SnapBoard
s = snap.SnapBoard(host, katcp_port, timeout=10)
s.program(boffile=bof,
chips=chips,
demux_mode=demux_mode,
gain=gain)