Read String Function (4403) - GE PACSystems RX7i Reference Manual

Cpu
Hide thumbs Also See for PACSystems RX7i:
Table of Contents

Advertisement

Chapter 6. Serial I/O, SNP & RTU Protocols

6.2.15 Read String Function (4403)

This function causes characters to be read from the specified port until a specified terminating character
is received. The characters are read from the internal input buffer and placed in the specified input data
area.
The function returns both the number of characters retrieved and the number of unprocessed characters
still in the input buffer. If zero characters of input are requested, only the number of unprocessed
characters in the input buffer is returned.
If the terminating character is not in the input buffer, the status of the operation is not complete until
either the terminating character has been received or the time-out interval expires. In either of those
conditions, the port status indicates the reason for completion of the read operation.
If the time-out interval is set to zero, the COMMREQ remains pending until it has received the requested
string, terminated by the specified end character.
If this COMMREQ fails for any reason, no data is returned to the input data area. Any data that has not
been read from the internal input buffer remains, and it can be retrieved with a subsequent read request.
Example Command Block for the Read String Function
Value
(decimal)
Address
0005
Address +1
0000
Address +2
0008
Address +3
0000
Address +4
0000
Address +5
0000
Address +6
4403
Address +7
0030
Address +8
0013
Address +9
0008
Address +10
0100
224
Value
(hexadecimal)
0005
0000
0008
0000
0000
0000
1133
001E
000D
0008
0064
PACSystems* RX7i, RX3i and RSTi-EP CPU Reference Manual
Meaning
Data block length
NOWAIT mode
Status word memory type (%R)
Status word address minus 1 (%R0001)
Not used
Not used
Read string command
Read time-out (30 seconds)
Terminating character (carriage return): must be
between 0 and 255 (0xFF), inclusive
Input data memory type (%R)
Input data memory address (%R0100)
GFK-2222AD

Hide quick links:

Advertisement

Table of Contents
loading

This manual is also suitable for:

Pacsystems rsti-epPacsystems rx3i

Table of Contents