Compaq AA-RNG2A-TE manual Setting Up the elprobe Routine

•For subsequent probe operations, reads the EEPROM to determine if the hardware address (and thus the adapter) has changed (Section 5.1.10)

•Registers the interrupt handler (Section 5.1.11)

•Saves the controller and softc data structure pointers (Section 5.1.12)

•Tries to allocate another controller data structure (Section 5.1.13)

•Registers the shutdown routine (Section 5.1.14)

5.1.1 Setting Up the el_probe Routine

The following code shows how to set up the el_probe( ) routine:

static int el_probe (io_handle_t io_handle, 1 struct controller *ctlr) 2

{

struct el_softc *sc; 3

int unit = ctlr->ctlr_num, i, j, isatag=0, status, multi_func_flag=0; 4 struct handler_intr_info el_intr_info; 5

ihandler_t el_ihandle; 6

struct card_info *card_infop = (struct card_info *)(ctlr->card_info_ptr); io_handle_t reg; 8

struct e_port port_sel; 9 struct irq irq_sel; 10 unsigned short *ed; unsigned char *ee;

struct tuple_info *tuple_infop; 11 struct tuple_data_info tuple_data; struct tuple_data_info *tuple_data_infop;

7

1

2

3

4

Declares an argument that specifies an I/O handle that you can use to reference a device register or memory that is located in bus address space (either I/O space or memory space). This I/O handle references the device’s I/O address space for the bus where the read operation originates (in calls to the read_io_port( ) routine) and where the write operation occurs (in calls to the write_io_port( ) routine). The bus configuration code passes this I/O handle to the driver’s probe interface during device autoconfiguration.

Declares a pointer to a controller data structure for this controller. This data structure contains such information as the controller type, the controller name, and the current status of the controller. The bus configuration code passes this initialized controller data structure to the driver’s probe and attach interfaces. A device driver typically uses the ctlr_num member of the controller data structure as an index to identify the instance of the controller a request is for.

Declares a pointer to the el_softc data structure and calls it sc.

Declares a unit variable and initializes it to the controller number for this controller. This controller number identifies the specific 3Com 3C5x9 controller that is being probed. The controller number is

5–2Implementing the Autoconfiguration Support Section (probe)