Keithley KPCI-488 LPA, User Manual

Page: 44 / 82

2-18 Return to Section Topics KPCI-488LPA-900-01 Rev. A / December 2008
Section 2: NI Command Compatible Functions Model KPCI-488LPA GPIB Controller Interface Card User’s Manual
ibeos
Description This command configures the EOS termination mode or character.
NOTE
Defining an EOS byte does not automatically send it when I/O writing is terminated; the user
must set the EOS byte after the data strings have been defined by the application.
Support Level Board / device level
Syntax Microsoft C/C++ and Borland C++
int ibeot (int ud, int v)
Visual Basic
ibeos (ByVal ud As Integer, ByVal v As Integer)
As Integer
- or -
call ibeos (ByVal ud As Integer, ByVal v As Integer)
Parameters ud : board or device descriptor
v : The information of the EOS mode and character. If v is zero, the EOS configuration
is disabled. Otherwise, the low byte is the EOS character and the upper byte contains
the flags that define the EOS mode. Table 2-9 shows the different EOS configurations
and the corresponding values of v .
Configure bit A and bit C to determine how to terminate the I/O reading. If bit A is set
and bit C is clear, the I/O reading is terminated when a byte that matches the low
seven bits of the EOS character is received. If both bit A and bit C are set, the I/O
reading is terminated when a byte matching the entire eight bits of the EOS character
is received.
Configure bit B and bit C to determine how to control the GPIB EOI line during
I/O writing. If bit B is set and bit C is clear, the EOI line is set to enable when a byte
that matches the low seven bits of the EOS character is written. If both bit B and bit C
are set, the EOI line is set to enable when a byte matching the entire eight bits of the
EOS character is written.
Table 2-9
EOS mode V value
EOS mode
V Value
Bit Upper Byte Low Byte
Terminate reading when the
EOS is detected. A 00000100 EOS character
Through the write function,
set EOI with EOS. B 00001000 EOS character
Compare the entire eight bits
of the EOS byte rather than
the low 7 bits. C 00010000 EOS character
Return Value The value of the ibsta
Error Codes EARG, EDVR, ENEB, EOIP