The xGIR register class is used for loading program files into the DSP on the GIR in a VXI module. Since normally all DSPs on any given model of VXI card will be running the same program the xGIR class caches program files internally and performs the actual program load from this cached copy.

Attributes :-

-s    VXI slot number

specifies the slot number (1-12) within the VXI crate. Manditory - no default value.

-a    address

specifies the address offset relative to the base of the VXI module which is the HOST interface address for the DSP.

-l    file length

specifies the maximum length (in 16 bit words) of program files to be loaded. This is used for space allocation in the program cache. The default is 8192 words.

-v    GIR version

specifies the version number of the GIR. This determines how the program data is written to the DSP.

-l    mode flag

determines the behaviour of the register WRITE operation.
mode = 0 ; the file specified by a WRITE operation is downloaded into the internal file cache only if the file is not already in the cache, otherwise the WRITE operation returns OK but performs no further actions.
mode = 1 ; the file specified by a WRITE operation will first be deleted from the internal file cache if it already exists. The file is then downloaded into the cache. This permits program files in the cache to be updated.
mode = 2 ; the file specified by a WRITE operation ,which must already exist in the program cache, is used to program the DSP.

-i    initial value

specifies the file name of a firmware file to be loaded by the INITIALISE operation into the program cache.

The WRITE operation supplies the path name of a file containing a DSP program to be either downloaded into the internal program cache or to be loaded into the DSP. The action performed is determined by the current value of the mode attribute. In the case of a WRITE operation with mode=2 ,programming the DSP, then a null string can be supplied as a path name in which case the last file downloaded by a mode=0 or mode=1 operation will be used.

The READ operation returns the path name of the file last specified in a WRITE operation.

The INITIALISE operation is equivalent to a WRITE operation with mode=0.

The program files can be supplied as either Windows or Unix text files with one (16 bit) data word per record.