FreeBSD/Linux Kernel Cross Reference
sys/chips/busses.c

     /* 
      * Mach Operating System
      * Copyright (c) 1993-1989 Carnegie Mellon University
      * All Rights Reserved.
      * 
      * Permission to use, copy, modify and distribute this software and its
      * documentation is hereby granted, provided that both the copyright
      * notice and this permission notice appear in all copies of the
      * software, derivative works or modified versions, and any portions
     * thereof, and that both notices appear in supporting documentation.
     * 
     * CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"
     * CONDITION.  CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND FOR
     * ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
     * 
     * Carnegie Mellon requests users of this software to return to
     * 
     *  Software Distribution Coordinator  or  Software.Distribution@CS.CMU.EDU
     *  School of Computer Science
     *  Carnegie Mellon University
     *  Pittsburgh PA 15213-3890
     * 
     * any improvements or extensions that they make and grant Carnegie Mellon
     * the rights to redistribute these changes.
     */
    /*
     * HISTORY
     * $Log:        busses.c,v $
     * Revision 2.15  93/05/17  10:26:48  rvb
     *      Type casts, etc to quiet gcc 2.3.3 warnings
     * 
     * Revision 2.14  93/05/10  22:25:04  rvb
     *      No more caddr_t.
     *      [93/04/09            af]
     * 
     * Revision 2.13  93/01/14  17:15:09  danner
     *      Converted to boolean return values, prototyped.
     *      [93/01/14            danner]
     * 
     * Revision 2.12  92/08/03  17:21:10  jfriedl
     *      removed silly prototypes
     *      [92/08/02            jfriedl]
     * 
     * Revision 2.11  92/05/21  17:05:33  jfriedl
     *      Cleanup to quiet gcc warnings.
     *      [92/05/16            jfriedl]
     * 
     * Revision 2.10  91/11/12  11:09:14  rvb
     *      Upgrade phys_address and address check
     *      [91/10/30  15:36:00  rvb]
     * 
     * Revision 2.9  91/10/09  15:55:08  af
     *      Changed to never overwrite the *->address and *->phys_address
     *      fields in either master or device descriptors.  This lets the
     *      probe routine use them as it pleases, and modify them if
     *      necessary.
     *      Also, if the device does have a phys address insist that we match.
     *      [91/09/03            af]
     * 
     * Revision 2.8  91/08/24  11:51:24  af
     *      Wildcarding on adaptor no. works now.
     * 
     * Revision 2.7  91/06/19  11:46:21  rvb
     *      File moved here from mips/PMAX since it tries to be generic;
     *      it is used on the PMAX and the Vax3100.
     *      [91/06/04            rvb]
     * 
     *      Added check in configure_bus_master for device's controller# to match
     *      the controller's unit#, if not wildcarded.
     *      Also, made device->ctlr correct *before* calling the slave function.
     *      [91/06/02            af]
     * 
     * Revision 2.6  91/05/14  17:32:20  mrt
     *      Correcting copyright
     * 
     * Revision 2.5  91/02/05  17:47:04  mrt
     *      Added author notices
     *      [91/02/04  11:21:01  mrt]
     * 
     *      Changed to use new Mach copyright
     *      [91/02/02  12:24:34  mrt]
     * 
     * Revision 2.4  90/12/05  23:36:34  af
     *       
     * 
     * Revision 2.3  90/12/05  20:49:29  af
     *      Fixed wrong wildcarding on controller rather than adaptor.
     *      Removed unused "metering" disk ID.  Now the flag field is used for
     *      more meaningful purposes.
     *      [90/12/03  23:00:38  af]
     * 
     * Revision 2.2  90/08/07  22:29:04  rpd
     *      Let the bus name be a parameter to the config functions.
     *      [90/08/07  15:26:10  af]
     * 
     * Revision 2.1.1.1  90/05/20  14:10:14  af
     *      Created, putting in just the minimum functionality
     *      needed for the 3max TURBOchannel.  Should extend to
     *      cope with VME properly.
    *      [90/04/18            af]
    * 
    */
   
   /*
    *      File: busses.c
    *      Author: Alessandro Forin, Carnegie Mellon University
    *      Date:   4/90
    *
    *      Generic autoconfiguration functions,
    *      usable to probe and attach devices
    *      on any bus that suits the generic bus
    *      structure, such as VME, TURBOChannel,
    *      and all the VAX busses.
    *
    */
   
   #include <mach/boolean.h>
   #include <mach/std_types.h>
   #include <chips/busses.h>
   
   
   
   
   /*
    * configure_bus_master
    *
    *      Given the name of a bus_ctlr, look it up in the
    *      init table.  If found, probe it.  If there can be
    *      slaves attached, walk the device's init table
    *      for those that might be attached to this controller.
    *      Call the 'slave' function on each one to see if
    *      ok, then the 'attach' one.
    *
    * Returns 0 if the controller is not there.
    *
    */
   boolean_t configure_bus_master(
           char            *name,
           vm_offset_t      virt,
           vm_offset_t      phys,
           int              adpt_no,
           char            *bus_name)
   {
           register struct bus_device *device;
           register struct bus_ctlr *master;
           register struct bus_driver *driver;
   
           int             found = 0;
   
           /*
            * Match the name in the table, then pick the entry that has the
            * right adaptor number, or one that has it wildcarded.  Entries
            * already allocated are marked alive, skip them. 
            */
           for (master = bus_master_init; master->driver; master++) {
                   if (master->alive)
                           continue;
                   if (((master->adaptor == adpt_no) || (master->adaptor == '?')) &&
                       (strcmp(master->name, name) == 0)) {
                           found = 1;
                           break;
                   }
           }
   
           if (!found)
                   return FALSE;
   
           /*
            * Found a match, probe it 
            */
           driver = master->driver;
           if ((*driver->probe) (virt, master) == 0)
                   return FALSE;
   
           master->alive = 1;
           master->adaptor = adpt_no;
   
           /*
            * Remember which controller this device is attached to 
            */
           driver->minfo[master->unit] = master;
   
           printf("%s%d: at %s%d\n", master->name, master->unit, bus_name, adpt_no);
   
           /*
            * Now walk all devices to check those that might be attached to this
            * controller.  We match the unallocated ones that have the right
            * controller number, or that have a widcarded controller number. 
            */
           for (device = bus_device_init; device->driver; device++) {
                   int     ctlr;
                   if (device->alive || device->driver != driver ||
                       (device->adaptor != '?' && device->adaptor != adpt_no))
                           continue;
                   ctlr = device->ctlr;
                   if (ctlr == '?') device->ctlr = master->unit;
                   /*
                    * A matching entry. See if the slave-probing routine is
                    * happy. 
                    */
                   if ((device->ctlr != master->unit) ||
                       ((*driver->slave) (device, virt) == 0)) {
                           device->ctlr = ctlr;
                           continue;
                   }
   
                   device->alive = 1;
                   device->adaptor = adpt_no;
                   device->ctlr = master->unit;
   
                   /*
                    * Save a backpointer to the controller 
                    */
                   device->mi = master;
   
                   /*
                    * ..and to the device 
                    */
                   driver->dinfo[device->unit] = device;
   
                   if (device->slave >= 0)
                           printf(" %s%d: at %s%d slave %d",
                                  device->name, device->unit,
                                  driver->mname, master->unit, device->slave);
                   else
                           printf(" %s%d: at %s%d",
                                  device->name, device->unit,
                                  driver->mname, master->unit);
   
                   /*
                    * Now attach this slave 
                    */
                   (*driver->attach) (device);
                   printf("\n");
           }
           return TRUE;
   }
   
   /*
    * configure_bus_device
    *
    *      Given the name of a bus_device, look it up in the
    *      init table.  If found, probe it.  If it is present,
    *      call the driver's 'attach' function.
    *
    * Returns 0 if the device is not there.
    *
    */
   boolean_t configure_bus_device( 
           char            *name,
           vm_offset_t      virt,
           vm_offset_t      phys,
           int              adpt_no,
           char            *bus_name)
   {
           register struct bus_device *device;
           register struct bus_driver *driver;
   
           int             found = 0;
   
           /*
            * Walk all devices to find one with the right name
            * and adaptor number (or wildcard).  The entry should
            * be unallocated, and also the slave number should
            * be wildcarded.
            */
           for (device = bus_device_init; device->driver; device++) {
                   if (device->alive)
                           continue;
                   if (((device->adaptor == adpt_no) || (device->adaptor == '?')) &&
                       (device->slave == -1) &&
                       ((!device->phys_address) ||
                        ((device->phys_address == phys) && (device->address == virt))) &&
                       (strcmp(device->name, name) == 0)) {
                           found = 1;
                           break;
                   }
           }
   
           if (!found)
                   return FALSE;
   
           /*
            * Found an entry, probe the device
            */
           driver = device->driver;
           if ((*driver->probe) (virt, (struct bus_ctlr *)device) == 0)
                   return FALSE;
   
           device->alive = 1;
           device->adaptor = adpt_no;
   
           printf("%s%d: at %s%d", device->name, device->unit, bus_name, adpt_no);
   
           /*
            * Remember which driver this device is attached to 
            */
           driver->dinfo[device->unit] = device;
   
           /*
            * Attach the device
            */
           (*driver->attach) (device);
           printf("\n");
   
           return TRUE;
   }
   

Cache object: 81fa5df6b059f978c54d14ffb52cf64f