FindLstn Function

Finds all Listeners on the GPIB.

FindLstn detects the presence of devices at particular addresses because most GPIB devices have the ability to listen. When you detect the devices, you can usually interrogate them to determine their identity.

Refer to GPIB Function Defaults for more information about the timeout and address defaults.


icon

Inputs/Outputs

  • ci32.png bus

    bus refers to the GPIB bus number. If you have only one GPIB interface in your computer, the default bus number is 0.

    Refer to the software installation instructions included with the GPIB controller for additional GPIB interfaces.
  • c1di16.png address list

    address list tests for the presence of a Listener for all devices listed in address list.

    If the function does not detect a listening device at the particular primary address, it tests all the secondary addresses associated with that primary address.
  • ci16.png limit

    limit If more Listeners are present on the bus than limit specifies, the function truncates listener address list after limit entries.

  • cerrcodeclst.png error in

    error in describes error conditions that occur before this node runs. This input provides standard error in functionality.

  • i1di16.png listener address list

    listener address list contains the addresses of all the Listeners the function finds.

  • i1dbool.png status

    status is a Boolean array in which each bit describes a state of the GPIB Controller.

    If an error occurs, the function sets bit 15. GPIB error is valid only if bit 15 of status is set.

    The following table shows the numeric value and symbolic status of each bit in status. This table also includes a description of each bit.

    Status BitNumeric ValueSymbolic StatusDescription
    01DCASDevice Clear state
    12DTASDevice Trigger State
    24LACSListener Active
    38TACSTalker Active
    416ATNAttention Asserted
    532CICController-In-Charge
    664REMRemote State
    7128LOKLockout State
    8256CMPLOperation Completed
    124096SRQISRQ Detected while CIC
    138192ENDEOI or EOS Detected
    1416384TIMOTimeout
    15-32768ERRError Detected
  • ii32.png number of listeners

    number of listeners contains the number of addresses placed in listener address list.

  • ierrcodeclst.png error out

    error out contains error information. This output provides standard error out functionality.