Scanlab RTC6 PCIe Board - Eth_Remove_Card

RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
374
innovators for industry
Ctrl Command eth_remove_card
Function Deletes the RTC6 Ethernet Board entry from the RTC6 board management at the specified
index.
Call Result = eth_remove_card( CardNo )
Parameters CardNo Index of the RTC6 Ethernet Board in the RTC6 board management.
As an unsigned 32-bit value.
Result Error code.
As a signed 32-bit value.
–2 Error: the entry cannot be deleted.
At this index an RTC6 Ethernet Board is entered which is still acquired yet.
–1 Error: the entry cannot be deleted.
At this index an RTC6 PCIe Board is entered.
0 Error: the entry cannot be deleted.
At this index “No card“ is entered or CardNo is invalid (> 255).
n (= CardNo ) Success: the entry has been deleted.
Comments • eth_remove_card is not available as a multi-board command.
• With all errors, the get_last_error return code RTC6_PARAM_ERROR is generated.
• Entries for “No card“s and RTC6 PCIe Boards cannot be deleted.
• Before deleting an RTC6 Ethernet Board entry, an acquired board must be explicitly
released by release_rtc.
• With CardNo = 0, the RTC6 Ethernet Board entry at index (rtc6_count_cards +
eth_count_cards) is deleted (see also continuous card numbering without gaps using
eth_assign_card or eth_assign_card_ip and CardNo = 0). CardNo = 0 and freely
chosen assignment of RTC6 Ethernet Boards to indexes should not be concurrently
used.
• All RTC6 Ethernet Board entries can be deleted from the RTC6 board management by
a simple loop (provided that all RTC6 Ethernet Boards are not acquired):
while ( eth_remove_card(0)> 0 );
• 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_assign_card_ip, eth_count_cards, release_rtc, rtc6_count_cards