Enter (peripheral mode), Enter #count buffer (controller mode) – Measurement Computing Personal488 rev.3.0 For DOS & Windows 3.Xi User Manual
Page 304

III. COMMAND REFERENCES - 15. Command References
15A. Driver488/DRV Commands
Personal488 User’s Manual, Rev. 3.0
III-289
The
ENTER
command reads data from the I/O adapter. If a device address (with optional secondary
address) or name is specified, then Driver488 is addressed to Listen, and that device is addressed to
Talk. If no address is specified, then Driver488 must already be configured to receive data, either as a
result of an immediately preceding
ENTER
command, or as a result of one of the
SEND
commands. If
the character count
count
is specified, then that exact number of characters is read from the device.
Otherwise,
ENTER
terminates reception on detection of the input terminator, that may be overridden by
specifying the terminator in the
ENTER
command. The received terminator is then replaced with the
EOL IN
terminator before being returned to the user’s program.
ENTER (Peripheral Mode)
SYNTAX
ENTER[;][#count][;][term][term][EOI]
count
is the number of characters to read.
Term
and
EOI
override the normal bus input terminator.
RESPONSE
Device-dependent data. If count is specified, then exactly
count characters are returned without EOL being appended.
Otherwise the response ends when the input terminator is
detected at which time EOL is appended to the returned
data.
MODE
*CA
BUS STATES
Determined by the Controller
SEE ALSO
OUTPUT, TERM, EOL, BUFFERED
EXAMPLES
PRINT#1,”ENTER”
INPUT#2,A$
Read data into A$ until the default bus input terminator is
detected
PRINT#1,”ENTER CR”
INPUT#2,A$
Read data until CR is detected
PRINT#1,”ENTER$00”
INPUT#2,A$
Read data until a NULL is detected
PRINT#1,”ENTER LFEOI”
INPUT#2,A$
Read data until LF or EOI is detected
PRINT#1,”ENTER#10”
A$=INPUT$(10,#2)
Read 10 bytes. INPUT$ returns 10 bytes from file #2
In Peripheral mode, the
ENTER
command receives data from the I/O adapter under control of the Active
Controller. The Active Controller must put Driver488 into the
Listen
state and configure some bus
device to provide Driver488 with data. The
Listen
state can be checked with the
STATUS
command,
or can cause an interrupt with the
ARM
command. A time-out error occurs (if enabled) if Driver488
does not receive a data byte within the time out period after issuing the
ENTER
command.
ENTER #count BUFFER (Controller Mode)
SYNTAX
ENTER[addr][;]#count[;]BUFFER buf-addr [CONTINUE] [term]
[term][EOI]
addr
is a device address (primary with optional secondary) or external device
name.
count
is the number of characters to read.
CONTINUE
specifies asynchronous transmission.
Buf-addr
is the memory buffer address.
Term
and
EOI
override the normal bus input terminators.
RESPONSE
None, returned data is placed directly into the specified
memory buffer.
MODE
CA
BUS STATES
ATN
•UNL, MLA, TAG, *ATN, data (With addr)
*ATN, data (Without addr)
SEE ALSO
OUTPUT, TERM, EOL, BUFFERED
EXAMPLES
See next page.