Scanlab RTC6 PCIe Board - Read_Io_Port_Buffer

RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
583
innovators for industry
Ctrl Command read_io_port_buffer
Function Returns the data previously stored in the IOPort buffer by read_io_port_list (input value
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 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.
Returned
parameter
values
Value 16-bit value.
As a pointer to an unsigned 32-bit value.
XPos Set position of the galvanometer scanner (x value).
As a pointer to a signed 32-bit value.
YPos Set position of the galvanometer scanner (y value).
As a pointer to a signed 32-bit value.
Time Time. In seconds.
As a pointer to an unsigned 32-bit value.
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 read_io_port_list has been called before read_io_port_buffer, then the
initialization values (Default: 0) are returned.
Example
(C/C++)
Wait until the data under Index gets newly written:
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