beautypg.com

Output #count buffer (controller mode) – Measurement Computing Personal488 rev.3.0 For DOS & Windows 3.Xi User Manual

Page 315

background image

15A. Driver488/DRV Commands

III. COMMAND REFERENCES - 15. Command References

III-300

Personal488 User’s Manual, Rev. 3.0

OUTPUT #count BUFFER (Controller Mode)

SYNTAX

OUTPUT [addr]#count BUFFER buf-addr [CONTINUE] [term] [term]

[EOI]

addr

is a device address (primary with optional secondary) or an external device

name.

count

is the number of bytes to

OUTPUT

.

buf-addr

is the memory buffer address.

CONTINUE

specifies asynchronous transmission.

term

and

EOI

override the normal IEEE 488 bus output terminator

RESPONSE

None

MODE

CA

BUS STATES

REN (if SC), *ATN, data (without addr)

REN (if SC), ATN

MTA, UNL, LAG, *ATN, data (with addr)

SEE ALSO

ENTER, TERM, TIME OUT, EOL, BUFFERED

EXAMPLES

PRINT#1,"OUTPUT16#100 BUFFER

&H2000:0”

Send 100 characters from memory at &H20000.

PRINT#1,"OUTPUT16#100 BUFFER

&H20100 EOI”

Send 100 characters from memory at &H20100

asserting EOI with the last character.

PRINT#1,"OUTPUT0701 #100

BUFFER &H1000:0 EOI”

Send 100 characters to bus device 07.

PRINT#1,"OUTPUT16#100 BUFFER

&H2000:0 CONTINUE EOI”

Send 100 characters and allow the program to

continue while the transfer is taking place.

PRINT#1,"WAIT"

Wait for the transfer to complete.

PRINT#1,"OUTPUT16#100 BUFFER

&H2000:100”

And send the next 100 bytes.

The

OUTPUT #count BUFFER

command sends data to I/O adapter devices from a user- supplied

memory region. The Remote Enable (

REN

) line is first asserted if Driver488 is the System Controller.

Then, if a device address (with optional secondary address) is specified, Driver488 is addressed to Talk
and that device is addressed to Listen. If no address is specified, Driver488 must already be configured
to send data, either as a result of an immediately preceding

OUTPUT

command, or as the result of a

SEND

command.

The character count

count

must be specified and is the number of characters that is transferred.

OUTPUT #count BUFFER

does not send any bus output terminators unless they are specified. The

number of characters actually sent can be checked with the

BUFFERED

command.

If

CONTINUE

is specified, then Driver488 returns control to the user’s program as soon as possible

without waiting for the transfer to be completed. It does, however, wait for the first byte to check for
time-out unless a time-out value of

0

had been specified by a

TIME OUT

command. Because of

hardware limitations, the

CONTINUE

may not return until a substantial portion of the transfer is

complete.

CONTINUE

transfers are not finished until Driver488 has had an opportunity to “clean up” and complete

the transfer. This “clean up” is usually automatic: Driver488 implicitly performs a

WAIT

command

before performing any bus command. The program can itself use the

WAIT

command to guarantee that

the transfer is complete.

All characters in the memory buffer are sent exactly as stored. No detection of the

EOL

output

terminator is performed, and no terminator translation takes place.