Read_Io_Port_Buffer - Scanlab RTC6 PCIe Board Installation And Operation Manual

Ctrl Command read_io_port_buffer
Function Returns the data previously stored in the IOPort buffer by
read at the EXTENSION 1 socket connector's 16-bit digital input port; the
galvanometer scanner set position and time value that has been current at the time of
reading).
Call CurrentIndex = read_io_port_buffer( Index, &Value, &XPos, &YPos, &Time )
Parameters Index
Value
Returned
parameter
values
XPos
YPos
Time
Result The index to which data is written upon the next read_io_port_list.
As an unsigned 32-bit value.
Comments • See also comments for read_io_port_list.
• If no
initialization values (Default: 0) are returned.
Wait until the data under Index gets newly written:
Example
(C/C++)
while (Index == read_io_port_buffer( Index, &Value, &XPos, &YPos, &Time ));
Read all data from Index to the current (not yet newly written) read position:
while (Index != read_io_port_buffer( Index, &Value, &XPos, &YPos, &Time ))
{ Index = (Index+1) & 0xf; ...}
RTC4RTC6 New command.
RTC5RTC6 Unchanged functionality. Larger IOPort buffer.
Version info Available as of DLL 600, OUT 600, RBF 600.
References read_io_port_list
RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
Number of the to-be-returned entry in the IOPort buffer.
As an unsigned 32-bit value.
Only the 12 least significant bits are evaluated (the IOPort buffer only has
4,096 entries). Therefore, the user program can use a continuous counter for
the index.
16-bit value.
As a pointer to an unsigned 32-bit value.
Set position of the galvanometer scanner (x value).
As a pointer to a signed 32-bit value.
Set position of the galvanometer scanner (y value).
As a pointer to a signed 32-bit value.
Time. In seconds.
As a pointer to an unsigned 32-bit value.
read_io_port_list has been called before read_io_port_buffer, then the
read_io_port_list (input value
583