ALTUS Nexto NX3004 User Manual

4. Configuration
203
Figure 4-99. Block Used for Reception Buffer Reading
Input parameters
Type
Description
REQUEST
BOOL
This variable, when true, enables the function
block use.
PORT
SERIAL_PORT
Select the serial port, as described in the
SERIAL_PORT data type.
RX_BUFFER_POINTER
POINTER TO
SERIAL_RX_CHAR_E
XTENDED
Pointer of a SERIAL_RX_CHAR_EXTENDED
array to receive the buffer values.
RX_BUFFER_LENGTH
UINT
Specify the expected character number in the
SERIAL_RX_CHAR_EXTENDED array. In
case more than the expected bytes are
available, only the expected quantity will be
read from the byte array, the rest will be leaved
in the RX queue (maximum size equal to 1024
characters).
RX_TIME-OUT
UINT
Specify the time-out to receive the expected
character quantity. In case it is smaller than the
necessary to receive the characters, the
RX_TIME-OUT_ERROR output from the
STATUS parameter will be indicated. When the
specified value, in ms, is equal to zero, the
function will return the data within the buffer.
Table 4-141. SERIAL_RX_EXTENDED Input Parameters
Output parameters
Type
Description
DONE
BOOL
This variable is true when the block is completely
executed. It is false otherwise.
EXEC
BOOL
This variable is true while the block is being
executed. It is false otherwise.
ERROR
BOOL
This variable is true when the block concludes the
execution with an error. It is false otherwise. It is
connected to the variable DONE, as its status is
showed after the block conclusion.
STATUS
SERIAL_STATUS
In case the ERROR variable is true, the STATUS
structure will show the error found during the
block execution. The possible states, already
described in the SERIAL_STATUS data type, are:
- NO_ERROR
- ILLEGAL_SERIAL_PORT
- PORT_BUSY
- HW_ERROR_UART
- HW_ERROR_REMOTE
- ILLEGAL_RX_BUFF_LENGTH
- RX_TIME-OUT_ERROR
- FB_SERIAL_RX_EXTENDED_NOT_ALLOWED
- NOT_CONFIGURED
RX_RECEIVED
UINT
Returns the received characters number. This
number can be within zero and the configured
value in RX_BUFFER_LENGTH. In case it is
smaller, an error will be indicated by the function
block
RX_REMAINING
UINT
Returns the number of characters which are still
in the RX queue after the function block
execution.
RX_SILENCE
UINT
Returns the silence time in the RX queue,
measured since the last received character is

ALTUS Nexto NX3004 Specifications

General

Brand	ALTUS
Model	Nexto NX3004
Category	Processor
Language	English