beautypg.com

Setrwls, Setrwls -25 – Measurement Computing GPIB-488 User Manual

Page 93

background image

Chapter 4

GPIB 488.2 Library Reference

GPIB-488

4-25

Programming Reference Manual

SetRWLS

Puts all devices in Remote state with Local Lockout and addresses specified devices as
Listeners.

Syntax

C

SetRWLS(int board, short addresslist [])

Parameters

board

is an integer which identifies the GPIB board to be used for this operation. In most

applications, this value is 0.

addresslist

is an array of GPIB addresses, terminated by the value

NOADDR

. These

addresses identify the devices to be put in remote mode.

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.

Usage Notes

This routine puts the specified devices in remote mode with local lockout. The system
controller asserts the REN (Remote Enable) line and addresses the specified devices as
listeners. These devices can then be programmed by messages sent over the GPIB bus. (In
other words, they can not be locally programmed from front panel controls.)

Example

This example puts all devices controlled by GPIB board 0 into Remote mode. Devices 6 and
7 are then addressed as Listeners by the Controller.

C

short addresslist[3] = {6, 7, NOADDR};

SetRWLS(0, addresslist);