(cardInit) (cardInit card_id) (cardInit [card_id [port [hardware_address [intr [module]]]])
Shared interrupts are not supported, so if the same interrupt is associated with more than one card, only the first will use interrupt mode, and the remainder will use polling mode.
OK if successful, otherwise one of the following:
(error "cardInit DR_ERR_CARD_INVALID (time) invalid card: card_id") (error "cardInit PFB_ERR_NO_CARD (time) No additional SST-PFB-PCI cards detected") (error "cardInit PFB_ERR_NO_CARD (time) No SST-PFB-PCI cards detected") (error "cardInit PFB_ERR_NO_CARD (time) Card not available") (error "cardInit PFB_ERR_BAD_PORT_PASSIVE (time) Card passive port signature invalid") (error "cardInit PFB_ERR_BAD_PORT_ACTIVE (time) Card active port signature invalid") (error "cardInit PFB_ERR_MEMMAP (time) Failed to map memory") (error "cardInit PFB_ERR_FIRMWARE_FILENAME (time) Specified Firmware file not found") (error "cardInit PFB_ERR_FIRMWARE_WRITE (time) Error writing firmware to card") (error "cardInit PFB_ERR_CARD_FAILURE (time) i960 FAIL state asserted") (error "cardInit PFB_ERR_FIRMWARE_NOT_RUNNING (time) Firmware failed to execute") (error "cardInit PFB_ERR_BUFFER_ALLOC (time) Failed to allocate buffer memory")
This command initializes one or more SST-PFB cards. A card must be initialized before it can be used. At least one card must be initialized from the configuration file to prevent the driver from terminating. The driver can interface with up to 4 cards. Each card is uniquely identified by its card ID, between 0 and 3.
ISA cards must be initilized one at a time, fully specifying the card_id, port and hardware_address parameters.
If either port or hardware_address parameters are 0 or not specified, then the command will scan the system for new SST-PFB PCI card(s) that have not yet been initialized by the driver. If card_id is also not specified, then sequential available IDs are assigned to the cards. If multiple PCI cards are detected and a card_id is specified that is not the first available ID, then the driver skips over those cards that would have corresponded to the intervening IDs.
In the following example, the system will initialize an ISA card as ID 1 at port 0x250 and address 0xD0000. The card will default to polled mode.
(cardInit 1 0x250 0xD000 )
In the following example, the driver will scan for SST-PFB PCI cards in the system, identifying up to 4 cards, and assigning consecutive device IDs. The card(s) will default to interrupt mode, and following on from the previous example, would be assigned IDs of 0, then 2, and then 3.
In the following example, the driver will scan for SST-PFB PCI cards. Assuming no other cards have been initialized, and 2 cards are detected, the first card is skipped, and the second is assigned an ID of 1 and forced to polling mode. The subsequent cardInit command again detects all the available cards, assigning the first an ID of 0 with interrupt mode, and skipping the second that has already been initialized.
(cardInit 1 0 0 -1) (cardInit)
Copyright © 1995-2006 by Cogent Real-Time Systems, Inc. All rights reserved.