pulsetest.py
============

This script runs the pulse test, by writing to the pulsetest FPGA gateware
the frequency of pulse generation to the channels the user wants to generate
pulses on.

To run, you first need a CONV-TTL-BLO with a pulsetest gateware. Then:

%> ./pulsetest.py
Slot no.: <give the slot number of the pulsetest CONV-TTL-BLO>

CH1 freq (Hz): <pulse frequency, number >0; 0 disables the channel >
CH2 freq (Hz): <pulse frequency, number >0; 0 disables the channel >
CH3 freq (Hz): <pulse frequency, number >0; 0 disables the channel >
CH4 freq (Hz): <pulse frequency, number >0; 0 disables the channel >
CH5 freq (Hz): <pulse frequency, number >0; 0 disables the channel >
CH6 freq (Hz): <pulse frequency, number >0; 0 disables the channel >

How long would you like to run the test?
  hrs: <give the number of hours>
  mins: <give the number of minutes>
  secs: <give the number of seconds>

For each channel you set a frequency value greater than 0, the script writes the
frequency value to the appropriate register in the pulsetest gateware, then sets
the appropriate bits to the control register to enable pulse generation. For
more information on the pulsetest gateware and the registers the script is
writing, see:
http://www.ohwr.org/projects/conv-ttl-blo-gw/wiki/pulsetest

Note that the output pulse frequency is limited to the MAXFREQ value in the script
_in software_, to avoid damage to the output stage MOSFET. The gateware employs
no limitation on this value.

When the script finishes execution, the script stores the output to a file it
specifies at the end. The name of this file is based on the date and time
the script started execution.

