4fb06be9e0d2610f6a65b37999e620787064c2bd
[people/lynusvaz/gpxe.git] / src / drivers / bus / isa.c
1 #include "string.h"
2 #include "isa.h"
3
4 /*
5  * isa.c implements a "classical" port-scanning method of ISA device
6  * detection.  The driver must provide a list of probe addresses
7  * (probe_addrs), together with a function (probe_addr) that can be
8  * used to test for the physical presence of a device at any given
9  * address.
10  *
11  * Note that this should probably be considered the "last resort" for
12  * device probing.  If the card supports ISAPnP or EISA, use that
13  * instead.  Some cards (e.g. the 3c509) implement a proprietary
14  * ISAPnP-like mechanism.
15  *
16  * The ISA probe address list can be overridden by config.c; if the
17  * user specifies ISA_PROBE_ADDRS then that list will be used first.
18  * (If ISA_PROBE_ADDRS ends with a zero, the driver's own list will
19  * never be used).
20  */
21
22 /*
23  * Ensure that there is sufficient space in the shared dev_bus
24  * structure for a struct isa_device.
25  *
26  */
27 DEV_BUS( struct isa_device, isa_dev );
28 static char isa_magic[0]; /* guaranteed unique symbol */
29
30 /*
31  * Find an ISA device matching the specified driver
32  *
33  */
34 int find_isa_device ( struct isa_device *isa, struct isa_driver *driver ) {
35         unsigned int i;
36         uint16_t ioaddr;
37
38         /* Initialise struct isa if it's the first time it's been used. */
39         if ( isa->magic != isa_magic ) {
40                 memset ( isa, 0, sizeof ( *isa ) );
41                 isa->magic = isa_magic;
42         }
43
44         /* Iterate through any ISA probe addresses specified by
45          * config.c, starting where we left off.
46          */
47         DBG ( "ISA searching for device matching driver %s\n", driver->name );
48         for ( i = isa->probe_idx ; i < isa_extra_probe_addr_count ; i++ ) {
49                 /* If we've already used this device, skip it */
50                 if ( isa->already_tried ) {
51                         isa->already_tried = 0;
52                         continue;
53                 }
54
55                 /* Set I/O address */
56                 ioaddr = isa_extra_probe_addrs[i];
57
58                 /* An I/O address of 0 in extra_probe_addrs list means
59                  * stop probing (i.e. don't continue to the
60                  * driver-provided list)
61                  */
62                 if ( ! ioaddr )
63                         goto notfound;
64
65                 /* Use probe_addr method to see if there's a device
66                  * present at this address.
67                  */
68                 if ( driver->probe_addr ( ioaddr ) ) {
69                         isa->probe_idx = i;
70                         goto found;
71                 }
72         }
73
74         /* Iterate through all ISA probe addresses provided by the
75          * driver, starting where we left off.
76          */
77         for ( i = isa->probe_idx - isa_extra_probe_addr_count ;
78               i < driver->addr_count ; i++ ) {
79
80                 /* If we've already used this device, skip it */
81                 if ( isa->already_tried ) {
82                         isa->already_tried = 0;
83                         continue;
84                 }
85
86                 /* Set I/O address */
87                 ioaddr = driver->probe_addrs[i];
88
89                 /* Use probe_addr method to see if there's a device
90                  * present at this address.
91                  */
92                 if ( driver->probe_addr ( ioaddr ) ) {
93                         isa->probe_idx = i + isa_extra_probe_addr_count;
94                         goto found;
95                 }
96         }
97
98  notfound:
99         /* No device found */
100         DBG ( "ISA found no device matching driver %s\n", driver->name );
101         isa->probe_idx = 0;
102         return 0;
103
104  found:
105         DBG ( "ISA found %s device at address %hx\n", driver->name, ioaddr );
106         isa->ioaddr = ioaddr;
107         isa->already_tried = 1;
108         return 1;
109 }
110
111 /*
112  * Find the next ISA device that can be used to boot using the
113  * specified driver.
114  *
115  */
116 int find_isa_boot_device ( struct dev *dev, struct isa_driver *driver ) {
117         struct isa_device *isa = ( struct isa_device * )dev->bus;
118
119         if ( ! find_isa_device ( isa, driver ) )
120                 return 0;
121
122         dev->name = driver->name;
123         dev->devid.bus_type = ISA_BUS_TYPE;
124         dev->devid.vendor_id = driver->mfg_id;
125         dev->devid.device_id = driver->prod_id;
126
127         return 1;
128 }