beautypg.com

Clear, Clearlist, Clockfrequency – Measurement Computing Personal488 rev.3.0 For DOS & Windows 3.Xi User Manual

Page 332

background image

III. COMMAND REFERENCES - 15. Command References

15B. Driver488/SUB, W31, W95, & WNT

Personal488 User’s Manual, Rev. 3.0

III-317

Clear

SYNTAX

int pascal Clear(DevHandleT devHandle);

devHandle

refers to either an IEEE 488 hardware interface or an external device.

If

devHandle

refers to a hardware interface, then a Device Clear (

DCL

) is

sent. If

devHandle

refers to an external device, a Selected Device Clear

(

SDC

) is sent.

RETURNS

-1 if error

MODE

CA

BUS STATES

ATN

DCL (all devices)

ATN

UNL, MTA, LAG, SDC (selected device)

SEE ALSO

Reset, ClearList

EXAMPLES

errorcode = Clear(ieee);

Sends the Device Clear (DCL) command to the

interface board

errorcode = Clear(wave)

Sends the Selected Device Clear (SDC) command to

the WAVE

errorcode = Clear(dmm)

Sends the Selected Device Clear (SDC) command to

the DMM

The

Clear

command causes the Device Clear (

DCL

) bus command to be issued to an interface or a

Selected Device Clear (

SDC

) command to be issued to an external device. IEEE 488 bus devices that

receive a Device Clear or Selected Device Clear command normally reset to their power-on state.

ClearList

SYNTAX

int pascal ClearList(DevHandlePT devHandles);

devHandles

is a pointer to a list of device handles that refer to external devices.

If a hardware interface is in the list,

DCL

is sent instead of

SDC

.

RETURNS

-1 if error

MODE

CA

BUS STATES

ATN

DCL (all devices)

ATN

UNL, MTA, LAG, SDC (selected device)

SEE ALSO

Clear, Reset

EXAMPLES

deviceList[0] = wave;
deviceList[1] = scope;
deviceList[2] = dmm;
deviceList[3] = NODEVICE;
errorcode = ClearList(deviceList);

Sends the Selected Device Clear

(SDC) command to a list of
devices.

The

ClearList

command causes the Selected Device Clear (

SDC

) command to be issued to a list of

external devices. IEEE 488 bus devices that receive a Selected Device Clear command normally reset
to their power-on state.

ClockFrequency

Driver488/SUB and Driver488/W31 only

SYNTAX

int pascal ClockFrequency(DevHandleT devHandle,int freq);

devHandle

refers to either an IEEE 488 Interface or an external device. If

devHandle

refers to an external device, the

ClockFrequency

command acts

on the hardware interface to which the external device is attached.

freq

is the actual clock rate rounded up to the nearest whole number of MHz.

RETURNS

-1 if error

MODE

Any

BUS STATES

None

SEE ALSO

Reset