RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
396
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
rs232_write_text 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
®
5new command
Version info Last change with version DLL 516, OUT 515
References rs232_write_text
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 init_rtc5_dll (page 306).
• 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 "Error Handling", page
87) 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)
To Next Page
Loading...
