| Instrument Control Toolbox | ![]() |
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.
Functions
Properties
| Port | ReadAsyncMode | ![]() |