IBLN
From NI-488.2
IBLN
Board-Level
Purpose
Check for the presence of a device on the bus.
Format
C
| unsigned long ibln (int ud, int pad, int sad, short *listen) |
Visual Basic
| CALL ibln (ud%, pad%, sad%, listen%) |
or
| status% = illn (ud%, pad%, sad%, listen%) |
Interactive Control (Usage Notes)
ibln pad sad
Input
| ud | Board descriptor |
| pad | The primary GPIB address of the device |
| sad | The secondary GPIB address of the device |
Output
| listen | Indicates if a device is present or not |
| Function Return | The value of Ibsta |
Description
ibln determines whether there is a listening device at the GPIB address designated by the pad and sad parameters. The bus associated with the board is tested for Listeners. If a Listener is detected, a non-zero value is returned in listen. If no Listener is found, zero is returned.
The pad parameter can be any valid primary address (a value between 0 and 30). The sad parameter can be any valid secondary address (a value between 96 to 126), or one of the constants NO_SAD or ALL_SAD. The constant NO_SAD designates that no secondary address is to be tested (only a primary address is tested). The constant ALL_SAD designates that all secondary addresses are to be tested.
Possible Errors
| EARG | Either the pad or sad argument is invalid. |
| ECIC | The access board is not CIC. |
| EDVR | The NI-488.2 driver is either configured incorrectly or is not properly installed. |
| EHDL | ud is invalid or out of range. |
| ELCK | The requested operation could not be performed because of an existing lock by another process. |
| ENEB | The interface is not installed or is not properly configured. |
| EOIP | Asynchronous I/O is in progress. |