RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
396
innovators for industry
Variable
List Command
rs232_write_text_list
Function
sends a text string (character-by-character) to the RS232 interface.
Call
rs232_write_text_list( pData )
Parameter
pData
PC memory address of the first character (byte) of the to-be-sent text string as
a pointer to a null-terminated ANSI string.
Comments
• When a
rs232_write_text_list
command 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
command in the list memory (keep this
in mind to prevent unintended overflow of the corresponding buffer area). Processing
of the individual
rs232_write_text_list
commands is similar to that of the
command (the 12-character block is split into individual characters
and sent sequentially to the RS232 interface).
• The command takes some time for execution, depending on the baud rate and text
length.
• Also see
chapter 9.1.6 "RS232 Interface", page 207
RTC
®
4
RTC
®
5 new command
Version info
Last change with version DLL 516, OUT 515
References
Ctrl Command rtc5_count_cards
Function
returns the number of RTC
®
5 boards detected during initialization
Call
NoOfCards = rtc5_count_cards()
Result
number of RTC
®
5 boards as an unsigned 32-bit value
Comments
• Initialization of the installed RTC
®
5 boards is to be made separately for each application
(user program) by calling
• The command
rtc5_count_cards
is also available without explicit access rights to a
specific RTC
®
5 board.
•
rtc5_count_cards
is not availabe as a multi-board command.
• The board-specific error variables
LastError
and
AccError
(see
) are neither generated nor altered by
rtc5_count_cards
.
RTC
®
4
RTC
®
5 new command, similar in functionality to its predecessor version (
rtc4_count_cards
)