Device File Preamble

Device files must contain a preamble. This has a number of sections, each one optional, which must be specified in the order shown:

Syntax

DEVICE NAME := name
    { COMPAT_VERSION := version ; }
    { AUTHOR := author } ;
    { DESCRIPTION := description } ;
    { MAJOR_VERSION := version ; }
    { PCOLA := value } ;

    PINS
        busName := [ pinNum | deviceReference.pinNum ] { , ... } ;
        ...
    END;

    DISABLE DEVICE
        busName := [ 1 | 0 | Z ] ;
        ...
    END;

    TEST COVERAGE
        busName := { SHORTS } { OPEN } { HI } { LO } { FUNCTIONAL } ;
        ...
    END;
    
    FILES
        filename;
        ...
    END;

    FILE_CONFIG
        VALUES
            ...
        END;
    END;
END;

Fields

The optional fields at the top of the preamble allow metadata to be specified for the device file.

COMPAT_VERSION

This integer value specifies the file format version of the file and is automatically written by XJTAG when a device file is saved. It is used when loading a device file to detect if the file is from a later version and is incompatible with the current version.

AUTHOR

The author is a quoted string that specifies the author of the file.

DESCRIPTION

The description is a quoted string that describes the device file.

MAJOR_VERSION

The major version of the file in the XJEase Library.

PCOLA

The PCOLA value specifies the testing levels the device test should report for PCOLA/SOQ analysis purposes. The value is a string comprising 5 characters representing coverage for Presence, Correctness, Orientation, Live and Alignment in that order. The value for each character can be: '?' = Unset, 'x'=Ignored, 'N'=None, 'P'=Partial, or 'F'=Full.

Example preamble

DEVICE NAME := "FLASH"
    COMPAT_VERSION := 6;
    AUTHOR := "XJTAG";
    DESCRIPTION := "Example flash device";
    PCOLA := "FFFPN";

    PINS
        Address := 1, 2, 3, 5, 4, 6, 12, 212, 23, 12;
        Data := 8, 10, 11, 13, 14;
        nCS := 49;
        nWE := 48;
        nOE := 47;

        EXTRA := IC17.4;
    END;

    DISABLE DEVICE
        nCS := 1;
        nWE := 1;
        nOE := 1;
    END;

    TEST COVERAGE
        Address := SHORTS OPEN HI LO;
        Data := SHORTS OPEN HI LO;
        nCS := OPEN HI;
        nWE := OPEN HI LO;
        nOE := OPEN HI LO;
    END;
END;