RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
375
Ctrl Command eth_search_cards
Function Executes a board search in form of a broadcast and returns the number of RTC6 Ethernet
Boards which have answered in the specified address range.
Call
Result = eth_search_cards( Ip, Netmask )
Parameters
Ip
IP address in Big Endian byte order.
As an unsigned 32-bit value.
Netmask
Subnet mask in Big Endian byte order.
As an unsigned 32-bit value.
Result Number of RTC6 Ethernet Boards in the specified address range which have answered
(within TimeOut).
As an unsigned 32-bit value.
Comments • eth_search_cards is not available as a multi-board command.
• To convert from the usual dotted decimal notation to Big Endian byte order,
eth_convert_string_to_ip can be used. See also Chapter 16.5.1 ”Notes on Working
with IP Addresses”, page 904.
• The timeout value can be set with eth_set_search_cards_timeout.
• A broadcast only reaches reliably addresses within the specified network segment. For
other use cases a board search by IP scan (eth_search_cards_range) can be carried
out.
• The number of found RTC6 Ethernet Boards can also be queried by eth_found_cards
at a later time.
RTC4RTC6 New command.
RTC5RTC6 New command.
Version info Available as of DLL 606, OUT 606, RBF 611.
References eth_convert_string_to_ip, eth_found_cards, eth_search_cards_range,
eth_set_search_cards_timeout