Scanlab RTC6 PCIe Board - Eth_Assign_Card

RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
353
innovators for industry
Ctrl Command eth_assign_card
Function Enters the RTC6 Ethernet Board with index SearchNo from the search result list at the
RTC6 board management index CardNo .
Call Result = eth_assign_card( SearchNo, CardNo )
Parameters SearchNo Index of the search result list. As an unsigned 32-bit value.
Allowed value range: [1…(Result value > 0 of eth_found_cards].
CardNo Index of the RTC6 board management, at which the RTC6 Ethernet Board
is to be entered. As an unsigned 32-bit value.
Allowed value range: [(rtc6_count_cards + 1)…255] or 0.
Result Error code.
As a signed 32-bit value.
–2 Error: the entry cannot be made.
At this index, already an RTC6 Ethernet Board is entered.
–1 Error: the entry cannot be made.
At this index, already an RTC6 PCIe Board is entered.
0 Error: the entry cannot be made.
SearchNo is invalid (0, > eth_found_cards).
Or: CardNo is invalid (1  CardNo  rtc6_count_cards, > 255).
n (= CardNo ) Success: the card number entry has been made.
Comments • eth_assign_card is not available as a multi-board command.
• To create a search result list, eth_search_cards and eth_search_cards_range are
used. See also Chapter 16.5.2 ”About Searching RTC6 Ethernet Boards”, page 904.
• No RTC6 Ethernet Board or RTC6 PCIe Board must already be entered at the specified
index CardNo . An RTC6 Ethernet Board must be explicitly removed by
eth_remove_card in advance. RTC6 PCIe Boards cannot be removed.
• When successful, eth_count_cards is automatically increased by 1.
• With CardNo = 0 the RTC6 Ethernet Board is entered at rtc6_count_cards +
eth_count_cards + 1. Thus, a continuous card numbering without gaps can
automatically be created (see also eth_remove_card). CardNo = 0 and freely chosen
assignment of RTC6 Ethernet Boards to indexes should not be concurrently used.
• With all errors, the get_last_error return code RTC6_PARAM_ERROR is generated.
• See also Chapter 16.5.3 ”About the RTC6 Board Management”, page 905.
R
TC4RTC6 New command.
RTC5RTC6 New command.
Version info Available as of DLL 606, OUT 606, RBF 611.
References eth_assign_card_ip, eth_count_cards, eth_found_cards, eth_max_card,
eth_search_cards, eth_search_cards_range, eth_remove_card, rtc6_count_cards,
eth_set_com_timeouts_auto