CRaTER -- lf_mask

NAME

lf_mask -- Verify operation of the CRaTER coincidence mask

USAGE

     lf_mask

FLAGS

     none

DESCRIPTION

This program connects to the CRaTER GSE with bcmd and CData 121 and, for all combinations of the detector processing enables (2**6), checks each bit of the coincidence mask individually (64 bits). The test is not done for every combination of coincidence mask bits (2**64 combinations), since that would involve a prohibitive amount of test time.

With the internal cal circuit generating 8 events per second -- plus a few natural background events occuring spontaneously -- the ``Good Event'' counter in the Secondary Science packet is monitored. For any given combination of detector processing enables, one and only one coincidence mask bit should result in a Good Event count. If that is the case, success for that processing combination is reported.

This script is part of the Long Form Functional Test. It assumes no particular instrument state and leaves the instrument in RESET.

DATA MARKERS -- embedded via ``echo''

    0x0100 -- start of data run
    0x00nn -- start of nth mask combination
    0xFFFF -- end of data run

ENVIRONMENT

    perl5.002     Minimum version of Perl interpreter required
    CRATERTOOLS   Environment variable containing path to CRaTER utilities
    CRATER_GSE    Environment variable containing EGSE machine name

BUGS

No multi-bit mask combinations are tested.

SEE ALSO

CData, bcmd

AUTHOR

Bob Goeke

RCS Information

$Id: lf_mask,v 1.8 2007/11/15 18:49:02 goeke Exp goeke $