NAME

 cscpipp − Compiled SCPI Preprocessor Command
 

SYNOPSIS

 
cscpipp [-f block_file] [-i driver] file.cs
 

DESCRIPTION

 
The C-SCPI preprocessor command is executed at the command prompt.  This command runs the C-SCPI preprocessor and generates C source code for you to run through your C compiler.  The preprocessor traps C-SCPI commands and replaces them with driver and/or SICL calls.
 

OPTIONS

 
There are two options available on the command line: -f to store block data in a file outside the C program and -i to use a file with only SCPI commands.
 

-f

 
-f is used when you have SCPI commands that require block data to be sent to an instrument.  This option stores block data in a file outside the C program.  This helps keep the size of the C program down, the speed of compilation up, and allows for a smaller executable file.  This option is usually only needed if you have a lot of block data.
 
[block_file] used with this option specifies the file to store the block data in when the preprocessor runs.  In your C program you must use a pointer called cscpi_datafile to point to a data file for the block data.  You must open the file to read the block data back into your program.
 

-i

 
-i takes a file that contains only SCPI commands and converts it into a C function.  The C-SCPI preprocessor treats each SCPI command like an INST_SEND.  This can be very useful with products like the HP 75000 Model D20 Digital Functional Test System.  The D20 can require a large number of commands to set up a measurement or test.  To help with programming all these commands, the D20 provides programming aids to generate the software that contains strictly SCPI commands.
 
The following restrictions apply:
 
All SCPI commands must be for the same instrument.
 
SCPI query commands are NOT allowed.
 
Any text that is not a SCPI command is NOT allowed.
 
[driver] used with this option defines the driver name of the instrument.  In most cases you’ll have two files. One file with the SCPI commands, and the other file  is the main program.  The main program might call the function generated by the C-SCPI preprocessor that contains only SCPI commands.  Each file must be run through the C-SCPI preprocessor, compiled, and then linked.
 
 

  —  December 04, 1992