GPIB Error Codes

The GPIB functions can return the following error codes.

Code Name Description
0 EDVR Error connecting to driver or device. This error might be caused by a failure to find or properly open the GPIB device driver.
1 ECIC Command requires GPIB Controller to be Controller-In-Charge. This error occurs when the board is not the Controller-In-Charge and any board-level function requiring controller capability is called or when any device-level function that affects the GPIB is called and the driver cannot make the board the Controller-In-Charge.
2 ENOL No Listeners on the GPIB. This error occurs when a data-byte write operation, such as ibwrt, is attempted with no addressed listeners on the bus or if a command-byte operation, such as ibcmd or SendCmds, is attempted and no devices are present.
3 EADR GPIB Controller not addressed correctly. This error occurs when the board is the Controller-In-Charge and is not properly addressed before starting a transfer. For example, ibrd returns EADR if the interface is not addressed as a listener. ibgts also can return this error if the board is not properly addressed for shadow handshaking.
4 EARG Invalid argument or arguments to function call. This error occurs when a driver function is called with an invalid parameter.
5 ESAC Command requires GPIB Controller to be System Controller. This error occurs when the board is not the System Controller but needs to be to perform the requested operation.
6 EABO I/O operation aborted. This error occurs when the I/O operation is aborted due to timeout, ibstop, or Device Clear.
7 ENEB Nonexistent GPIB interface. Board-level functions return ENEB when the specified interface is configured in ibconf but cannot be found in the system. Device-level functions return ENEB when the specified access board of a device cannot be found in the system, even if the access board is configured in ibconf.
8 EDMA DMA hardware error detected. This error occurs when the driver has DMA enabled but cannot use DMA to transfer a buffer. The error can be due to an operating system error, such as when the operating system is unable to provide a physical address to the driver. The error also can be due to a hardware limitation, such as when the DMA controller cannot address your buffer and the driver cannot remap the buffer.
9 EBTO DMA hardware uP bus timeout.
10 EOIP Asynchronous I/O operation in progress. This error occurs when a thread starts asynchronous I/O and then attempts to access the interface while the interface is still in an unsynchronized state.
11 ECAP No capability for operation. This error occurs when you try to take advantage of a driver feature that is either not implemented in the driver or is not currently usable. For example, if you disabled hardware DMA by removing the DRQ/DACK jumpers on her legacy AT-GPIB/TNT, a call to ibconfigIbcDMA with a value of 1 to enable DMA would return this error.
12 EFSO File system operation error. This error occurs when an ibrdf or ibwrtf call encounters a problem accessing the specified file.
13 EOWN Shareable board exclusively owned.
14 EBUS GPIB bus error. This error occurs while sending out GPIB command bytes. This error is only returned by functions that indirectly send out command bytes. For example, a device-level ibwrt returns EBUS if it is unable to send the addressing command bytes.
15 ESTB Serial poll byte queue overflow.
16 ESRQ SRQ stuck in ON position. This error occurs when the driver is unable to wait for the RQS bit to set during a device-level ibwait.
17 ECMD Unrecognized command.
19 EBNP Board not present.
20 ETAB Table error. This error occurs when there is a problem with a table used by a driver function. FindLstn returns ETAB when it finds more listeners on the bus than will fit in the table you provided. FindRQS and AllSpoll return ETAB if the list of addresses to serial poll is empty or none of the devices in the list are asserting SRQ.
21 ELCK GPIB interface is locked and cannot be accessed. This error occurs when the requested operation cannot be performed because of an existing lock by another process accessing the same interface.
22 EARM The ibnotifyCallback failed to rearm. This error occurs when the asynchronous event notification mechanism of ibnotify fails to rearm itself.
23 EHDL The input handle is invalid or out of range. This error occurs in the following situations: when a valid board handle is passed in as a handle parameter to a device-level NI-488 function or a valid device handle is passed in as a handle parameter to a board-level NI-488 function; when an invalid board or device unit descriptor is passed as input to any NI-488 function; when a boardID outside the defined range is passed in to a traditional NI-488 board-level function or to an IEEE 488.2 style routine; when ibconfig or ibask is called with a device unit descriptor and a board-only configuration option or with a board unit descriptor and a device-only configuration option.
26 EWIP Wait in progress on specified input handle. EWIP indicates that an ibwait call is already in progress on the specified unit descriptor. This error occurs when one thread within a process calls ibwait on a given descriptor when another thread within the same process is already performing an ibwait using that same descriptor.
30 NADDR No GPIB address input.
31 NSTRG No string input (write).
32 NCNT No count input (read).
40 EMOM Out of memory (MacBus read or write).
41 EMIM Insufficient memory (MacBus read or write).