9c5b4efdfb0bc4acdd71a301db3f721355f022a7
[people/lynusvaz/gpxe.git] / src / drivers / bus / isa.c
1 #include "string.h"
2 #include "console.h"
3 #include "config/isa.h"
4 #include "isa.h"
5
6 /*
7  * isa.c implements a "classical" port-scanning method of ISA device
8  * detection.  The driver must provide a list of probe addresses
9  * (probe_addrs), together with a function (probe_addr) that can be
10  * used to test for the physical presence of a device at any given
11  * address.
12  *
13  * Note that this should probably be considered the "last resort" for
14  * device probing.  If the card supports ISAPnP or EISA, use that
15  * instead.  Some cards (e.g. the 3c509) implement a proprietary
16  * ISAPnP-like mechanism.
17  *
18  * The ISA probe address list can be overridden by config.h; if the
19  * user specifies ISA_PROBE_ADDRS then that list will be used first.
20  * (If ISA_PROBE_ADDRS ends with a zero, the driver's own list will
21  * never be used).
22  */
23
24 /*
25  * User-supplied probe address list
26  *
27  */
28 static isa_probe_addr_t isa_extra_probe_addrs[] = {
29 #ifdef ISA_PROBE_ADDRS
30         ISA_PROBE_ADDRS
31 #endif
32 };
33 #define isa_extra_probe_addr_count \
34      ( sizeof ( isa_extra_probe_addrs ) / sizeof ( isa_extra_probe_addrs[0] ) )
35
36 #ifdef ISA_PROBE_ONLY
37 #  define               ISA_PROBE_IDX_LIMIT     isa_extra_probe_addr_count
38 #else
39 #  define               ISA_PROBE_IDX_LIMIT     ( ISA_MAX_PROBE_IDX + 1 )
40 #endif
41
42 /*
43  * Increment a bus_loc structure to the next possible ISA location.
44  * Leave the structure zeroed and return 0 if there are no more valid
45  * locations.
46  *
47  */
48 static int isa_next_location ( struct bus_loc *bus_loc ) {
49         struct isa_loc *isa_loc = ( struct isa_loc * ) bus_loc;
50         
51         /*
52          * Ensure that there is sufficient space in the shared bus
53          * structures for a struct isa_loc and a struct
54          * isa_dev, as mandated by bus.h.
55          *
56          */
57         BUS_LOC_CHECK ( struct isa_loc );
58         BUS_DEV_CHECK ( struct isa_device );
59
60         return ( ( ++isa_loc->probe_idx < ISA_PROBE_IDX_LIMIT ) ?
61                  1 : ( isa_loc->probe_idx = 0 ) );
62 }
63
64 /*
65  * Fill in parameters (vendor & device ids, class, membase etc.) for
66  * an ISA device based on bus_loc.
67  *
68  * Returns 1 if a device was found, 0 for no device present.
69  *
70  */
71 static int isa_fill_device ( struct bus_dev *bus_dev,
72                              struct bus_loc *bus_loc ) {
73         struct isa_loc *isa_loc = ( struct isa_loc * ) bus_loc;
74         struct isa_device *isa = ( struct isa_device * ) bus_dev;
75         signed int driver_probe_idx;
76
77         driver_probe_idx = isa_loc->probe_idx - isa_extra_probe_addr_count;
78         if ( driver_probe_idx < 0 ) {
79                 isa->ioaddr = isa_extra_probe_addrs[isa_loc->probe_idx];
80         } else {
81                 isa->ioaddr = 0;
82                 isa->driver_probe_idx = driver_probe_idx;
83         }
84         isa->mfg_id = isa->prod_id = 0;
85         isa->name = "?";
86         return 1;
87 }
88
89 /*
90  * Test whether or not a driver is capable of driving the specified
91  * device.
92  *
93  */
94 int isa_check_driver ( struct bus_dev *bus_dev,
95                        struct device_driver *device_driver ) {
96         struct isa_device *isa = ( struct isa_device * ) bus_dev;
97         struct isa_driver *driver
98                 = ( struct isa_driver * ) device_driver->bus_driver_info;
99
100         /* If ioaddr is zero, it means we're using a driver-specified
101          * ioaddr
102          */
103         if ( ! isa->ioaddr )
104                 isa->ioaddr = driver->probe_addrs[isa->driver_probe_idx];
105
106         /* Use probe_addr method to see if there's a device
107          * present at this address.
108          */
109         if ( driver->probe_addr ( isa->ioaddr ) ) {
110                 DBG ( "ISA found %s device at address %hx\n",
111                       driver->name, isa->ioaddr );
112                 isa->name = driver->name;
113                 isa->mfg_id = driver->mfg_id;
114                 isa->prod_id = driver->prod_id;
115                 return 1;
116         }
117
118         /* No device found */
119         return 0;
120 }
121
122 /*
123  * Describe a ISA device
124  *
125  */
126 static char * isa_describe ( struct bus_dev *bus_dev ) {
127         struct isa_device *isa = ( struct isa_device * ) bus_dev;
128         static char isa_description[] = "ISA 0000";
129
130         sprintf ( isa_description + 4, "%hx", isa->ioaddr );
131         return isa_description;
132 }
133
134 /*
135  * Name a ISA device
136  *
137  */
138 static const char * isa_name ( struct bus_dev *bus_dev ) {
139         struct isa_device *isa = ( struct isa_device * ) bus_dev;
140         
141         return isa->name;
142 }
143
144 /*
145  * ISA bus operations table
146  *
147  */
148 struct bus_driver isa_driver __bus_driver = {
149         .next_location  = isa_next_location,
150         .fill_device    = isa_fill_device,
151         .check_driver   = isa_check_driver,
152         .describe       = isa_describe,
153         .name           = isa_name,
154 };
155
156 /*
157  * Fill in a nic structure
158  *
159  */
160 void isa_fill_nic ( struct nic *nic, struct isa_device *isa ) {
161
162         /* Fill in ioaddr and irqno */
163         nic->ioaddr = isa->ioaddr;
164         nic->irqno = 0;
165
166         /* Fill in DHCP device ID structure */
167         nic->dhcp_dev_id.bus_type = ISA_BUS_TYPE;
168         nic->dhcp_dev_id.vendor_id = htons ( isa->mfg_id );
169         nic->dhcp_dev_id.device_id = htons ( isa->prod_id );
170 }