beautypg.com

Ibeos, Table 3-4. selecting eos, E 3-4 – Measurement Computing GPIB-488 User Manual

Page 31: Selecting eos

background image

Chapter 3

GPIB 488.1 Library Reference

Programming Reference Manual

3-18

GPIB-488

IBEOS

Changes or disables End-Of-String termination mode.

Syntax

C

ibeos (int boarddev, int eos)

Parameters

boarddev

is an integer containing the board/device handle.

eos

is an integer that defines which termination mode and what EOS character are to be used,

as shown in Table 3-4, Selecting EOS.

Returns

ibsta

will contain a 16-bit status word as described in Appendix B,

IBSTA

.

iberr

will contain an error code, if an error occurred. If an error does not occur the previous

value of

eos

is stored in

iberr

.

Usage Notes

This call only defines an EOS byte for a board or device. It does not cause the handler to
automatically send that byte when performing writes. Your application must include the EOS
byte in the data string it defines.

If this call defines an EOS for a device, then the defined EOS is used for all reads and writes
involving that device. Likewise, if the call defines an EOS for a board, then all reads and
writes involving that board will use that EOS.

Table 3-4. Selecting EOS

Method

Description

eos

High Byte

Low Byte

A

Terminate read when EOS is detected. Can be used
alone or in combination with Method C. (Constant =
REOS)

00000100

EOS
character

B

Set EOI with EOS on write function. Can be used alone
or in combination with Method C. (Constant = XEOS)

00001000

EOS
character

C

Compare all 8 bits of EOS byte rather than low 7 bits for
all read and write functions. (Constant = BIN)

00010000

EOS
character