Scanlab RTC6 PCIe Board - Eth_Assign_Card_Ip

RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
354
innovators for industry
Ctrl Command eth_assign_card_ip
Function Enters an RTC6 Ethernet Board with the IP address Ip at the index CardNo in the
RTC6 board management.
Call Result = eth_assign_card_ip( Ip, CardNo )
Parameters Ip IP address for the RTC6 Ethernet Board. As an unsigned 32-bit value.
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.
CardNo is invalid (1  CardNo  rtc6_count_cards, > 255).
n (= CardNo ) Success: the entry has been made.
Comments • eth_assign_card_ip is not available as a multi-board command.
• 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.
• The RTC6 Ethernet Board is entered in the RTC6 board management, even if there is an
Ethernet error during its initialization. Before trying to initialize once again, this
RTC6 Ethernet Board must be removed explicitly from the RTC6 board management.
• See also Chapter 16.5.3 ”About the RTC6 Board Management”, page 905.
RTC4RTC6 New command.
RTC5RTC6 New command.
Version info Available as of DLL 606, OUT 606, RBF 611.
References eth_assign_card, eth_count_cards, eth_re
move_card, et
h_set_com_timeouts_auto