cpat - compile pattern.

SYNOPSIS

    cpat [OPTION] filename ...

DESCRIPTION

This cpat is a pattern table generator which takes as input a command orientated discription of a waveform pattern and output the ASCII patterns table used in the spex software.

The input command files are given the .p extension (.p files).
The output pattern table are given the .pat extensions(.pat files)

Summary of commands:

BCLEAR name - Turn off the named bits in the mask.

BCLEARALL - Turn off all bits in the mask.

BDEF name value - Defines Bits Name.

BSET name - Turn on the named bits in the mask.

DESC text - Description text for pattern.

OUTFILE filename - Sets filename for output.

PMask { off | on } - Turns off/on the preserve mask.

PMaskClear - Clears a bit in the preserve Mask

PMaskClearAll - Clears the current mask.

PMaskSetBits hex - Sets preserve mask using the hex value.

PROCESS filename - Execute commands in file.

RESET - Resets all internal variables to startup condition.

REWIND - Sets the tminx to 0. timinx is the current tick pointer.

SETENV - Set up an environment variable. For example, this
    setenv ReadDataTicks=12
allows you to put this in you .p files:
     tick $SettleTicks

SHOW - Show all internal variables.

TICK n - OR current Mask to n intervals & incrementing tminx.

TICKALL - OR Mask to from tminx to END of period.  tminx is set to last period (tminx = end).

WRITE - generates a .pat file.

OPTIONS

   -v    verbose - Produces very verbose output. Default=off

   -h    help    - Displays summary of usage, options, and command.

EXAMPLE

For the following input file test.p file:

reset
pmask on
pmasksetbits 0xa1234567
outfile test.pat
desc   Description of Pattern 75
bdef  frame       0x00000001
bdef  convert     0x00000002
bset   frame
tick 2
bset   convert
tick 1
bclear convert
tick 2
write
 
 

test.pat - Description of Pattern 75
a1234567   ; Preserve mask (hex)
5         ; Number of patterns (dec).
00000001
00000001
00000003
00000001
00000001

dpat