Scanlab RTC6 PCIe Board - Rs232_Write_Text_List

RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
597
innovators for industry
Variable
List Command
rs232_write_text_list
Function Sends a text string (character-by-character) to the RS-232 interface.
Call rs232_write_text_list( pData )
Parameters pData PC memory address of the first character (byte) of the to-be-sent text string.
As a pointer to a \0-terminated string.
Comments • When an rs232_write_text_list is loaded, the to-be-sent text (if more than 12
characters in length, \0 not included) is split into blocks of 12 characters, with each
block receiving its own rs232_write_text_list in the RTC6 List Memory (keep this in
mind to prevent unintended overflow of the corresponding RTC6 List Memory area).
Processing of the individual rs232_write_text_list is similar to that of
rs232_write_text (the 12-character block is split into individual characters and sent
sequentially to the RS-232 interface).
• rs232_write_text_list takes some time for execution, depending on the baud rate and
text length.
• See also Chapter 9.1.6 ”RS-232 Interface”, page 287.
RTC4RTC6 New command.
RTC5RTC6 Unchanged functionality.
Version info Available as of DLL 600, OUT 600, RBF 600.
References rs232_write_text, rs232_read_data, uart_config