Main Content

ividevlist

List physically connected IVI-C and VXIplug&play instruments

    Description

    example

    deviceList = ividevlist returns a table containing information about the physically connected IVI-C and VXIplug&play instruments detected on your computer, as well as their associated MATLAB® drivers. Connect to one of the drivers from MATLAB by using the MATLAB driver name and resource name with ividev.

    To use the ividev interface, you must have the Instrument Control Toolbox™ Support Package for IVI® and VXIplug&play Drivers. For more information, see Install Instrument Control Toolbox Support Package for IVI and VXIplug&play Drivers.

    Note

    Some resources connected over serial or TCP/IP might not be listed in the table, but you can still create an ividev object for those resources by specifying a valid resource name.

    deviceList = ividevlist(Timeout=time) returns all physically connected IVI-C and VXIplug&play instruments found within the specified period, time, in seconds. The default timeout period is 30 seconds.

    Examples

    collapse all

    Use ividevlist to list all available IVI-C and VXIplug&play instruments, along with their resource names, on your computer.

    deviceList = ividevlist
    deviceList =
    
      1×5 table
    
               MATLABDriver                     ResourceName                    VendorDriver          Model       SerialNumber
             _________________    ________________________________________    _________________    ___________    ____________
    
        1    "AgInfiniiVision"    "TCPIP0::152.90.186.165::hislip0::INSTR"    "AgInfiniiVision"    "DSOX1204A"    "CN59206154"

    MATLABDriver and ResourceName identify each resource. You must use both as inputs to create an ividev object. The VendorDriver, Model, and SerialNumber columns provide additional information about the instrument or device.

    In this example, a Keysight™ DSOX1204A oscilloscope that uses the AgInfiniiVision driver is connected to the computer. The resource name indicates that this instrument is connected over TCP/IP.

    Output Arguments

    collapse all

    List of IVI-C and VXIplug&play instruments, returned as a table. The table has the following columns.

    MATLAB driver name, returned as a string scalar. This is the MATLAB wrapper for the associated vendor driver. Use this name as an input for ividev to create a connection to your instrument.

    IVI-C or VXIplug&play instrument name, returned as a string scalar. Use this name as an input for ividev to create a connection to your instrument.

    Third-party vendor driver name, returned as a string scalar. This is the vendor driver DLL that you have installed on your computer.

    Instrument model, returned as a string scalar. This column has a value only if the instrument provides this information.

    Serial number associated with instrument, returned as a string scalar. If you have more than one of the same type of instrument, you can identify them using the value of this column.

    Version History

    Introduced in R2022a