Instrument Control Toolbox

Adaptor Information

To display information about a specific installed adaptor, you must supply the interface name and the adaptor name as arguments to instrhwinfo. The supported interface and adaptor names are given below.

Interface Name	Adaptor Name
gpib	agilent, cbi, cec, iotech, keithley, ni
visa	agilent, ni

The returned information describes the adaptor, the vendor driver, and the object constructor(s). For example, to display information for the National Instruments GPIB adaptor

ghwinfo = instrhwinfo('gpib','ni')
ghwinfo =

             AdaptorDllName: [1x56 char]
          AdaptorDllVersion: 'Version 1.0 (R12)'
                AdaptorName: 'ni'
      ObjectConstructorName: 'gpib('ni', <BID>, <PR>)'
              VendorDllName: 'gpib-32.dll'
    VendorDriverDescription: 'NI-488'

The ObjectConstructorName field describes how you can create a GPIB object for the National Instruments adaptor. For example, to create the GPIB object g associated with a GPIB controller with board index 0 and an instrument with primary address 1

g = gpib('ni',0,1);

To display information for the Agilent Technologies VISA adaptor

vhwinfo = instrhwinfo('visa','agilent')
vhwinfo = 

             AdaptorDllName: [1x62 char]
          AdaptorDllVersion: 'Version 1.0 (R12)'
                AdaptorName: 'AGILENT'
           AvailableChassis: 0
       AvailableSerialPorts: ''
          InstalledBoardIds: 0
      ObjectConstructorName: {7x1 cell}
                SerialPorts: ''
              VendorDllName: 'hpvisa32.dll'
    VendorDriverDescription: 'Agilent Technologies VISA Driver'
        VendorDriverVersion: 1.1000

The available VISA object constructor names are shown below.

vhwinfo.ObjectConstructorName
ans = 
    'visa('agilent', 'GPIB0::9::0::INSTR');'
    'visa('agilent', 'GPIB0::9::10::INSTR');'
    'visa('agilent', 'VXI0::0::INSTR');'
    'visa('agilent', 'VXI0::130::INSTR');'
    'visa('agilent', 'VXI0::32::INSTR');'
    'visa('agilent', 'GPIB-VXI0::0::INSTR');'
    'visa('agilent', 'GPIB-VXI0::80::INSTR');

The ObjectConstructorName field describes how you can create a VISA instrument object for instruments associated with the GPIB, VXI, and GPIB-VXI interfaces. For example, to create the VISA-VXI object vv associated with a VXI chassis with index 0 and an instrument with logical address 130

vv = visa('agilent','VXI0::130::INSTR')

Interface Information

Instrument Object Information