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 }