Instrument Control Toolbox    
PrimaryAddress

Specify the primary address of the GPIB instrument

Description

For GPIB and VISA-GPIB objects, you configure PrimaryAddress to be the GPIB primary address associated with your instrument. The primary address can range from 0 to 30, and you must specify it during object creation using the gpib or visa function. For VISA-GPIB-VXI objects, PrimaryAddress is read-only, and the value is returned automatically by the VISA interface after the object is connected to the instrument with the fopen function.

For GPIB and VISA-GPIB objects, the Name property is automatically updated to reflect the PrimaryAddress value. For VISA-GPIB objects, the RsrcName property is automatically updated to reflect the PrimaryAddress value.

You can configure PrimaryAddress only when the GPIB or VISA-GPIB object is disconnected from the instrument. You disconnect a connected object with the fclose function. A disconnected object has a Status property value of closed.

Characteristics

Usage
GPIB, VISA-GPIB, VISA-GPIB-VXI
Read only
While open (GPIB, VISA-GPIB), always (VISA-GPIB-VXI)
Data type
Double

Values

PrimaryAddress can range from 0 to 30. The value is determined when the instrument object is created.

Example

This example creates a VISA-GPIB object associated with board 0, primary address 1, and secondary address 8, and then returns the primary address.

See Also

Functions

fclose, gpib, visa

Properties

Name, RsrcName, Status


  Port ReadAsyncMode