Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

INST_EXTERN()

 

NAME

INST_EXTERN − Compiled SCPI Commands
 

SYNOPSIS

 
INST_EXTERN (id, driver, type);
 
 

DESCRIPTION

 
This is an HP Compiled SCPI macro command. Instrument external creates an external variable reference for an instrument data pointer.  This command also specifies the instrument driver name and configuration type  (message-based or register-based instrument).  This command is similar to instrument declare except that it  declares a reference to an external variable.
 

PARAMETERS

 

id

The user variable name for the instrument.   This is where you declare the variable name for the instrument.  The name specified by id  is used in all other C-SCPI commands for that instrument. 
 

driver

The parameter that defines the HP driver.  This parameter is a quoted string, for example, "E1411B" is the driver name for the HP E1411B Multimeter.  See the HP 75000 Family of VXI Products catalog for a list of available drivers (available from your nearest HP Sales and Service Office). 
 

type

The parameter that defines the configuration type.  The configuration type can be one of the following:
 
MESSAGE -  for HP-IB or VXI message-based cards
 
REGISTER  - for register-based cards
 

COMMENTS

 
INST_DECL, INST_EXTERN, or INST_PARAM is required to declare the id parameter.  This declaration must be done before any command that uses id.
 
See also INST_DECL and INST_PARAM.
 

EXAMPLE

 
This example defines an external variable for the HP E1411B Multimeter.
 

INST_DECL (vm, "E1411B", REGISTER);
extern void setup();
  .
 main()
{
 INST_STARTUP();
INST_OPEN(vm, "vxi,24");
  .
setup();
  .
}
   ANOTHER FILE:
  INST_EXTERN (vm, "E1411B", REGISTER);
void setup()
{
INST_SEND(vm, "*RST");
.
.
}

  —  December 04, 1992

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026