Annotation of 41BSD/4.0.upgrade/sys/h/ubavar.h, revision 1.1

1.1     ! root        1: /*     ubavar.h        4.21    81/10/27        */
        !             2: 
        !             3: /*
        !             4:  * This file contains definitions related to the kernel structures
        !             5:  * for dealing with the unibus adapters.
        !             6:  *
        !             7:  * Each uba has a uba_hd structure.
        !             8:  * Each unibus controller which is not a device has a uba_ctlr structure.
        !             9:  * Each unibus device has a uba_device structure.
        !            10:  */
        !            11: 
        !            12: #ifndef LOCORE
        !            13: /*
        !            14:  * Per-uba structure.
        !            15:  *
        !            16:  * This structure holds the interrupt vector for the uba,
        !            17:  * and its address in physical and virtual space.  At boot time
        !            18:  * we determine the devices attached to the uba's and their
        !            19:  * interrupt vectors, filling in uh_vec.  We free the map
        !            20:  * register and bdp resources of the uba into the structures
        !            21:  * defined here.
        !            22:  *
        !            23:  * During normal operation, resources are allocated and returned
        !            24:  * to the structures here.  We watch the number of passive releases
        !            25:  * on each uba, and if the number is excessive may reset the uba.
        !            26:  * 
        !            27:  * When uba resources are needed and not available, or if a device
        !            28:  * which can tolerate no other uba activity (rk07) gets on the bus,
        !            29:  * then device drivers may have to wait to get to the bus and are
        !            30:  * queued here.  It is also possible for processes to block in
        !            31:  * the unibus driver in resource wait (mrwant, bdpwant); these
        !            32:  * wait states are also recorded here.
        !            33:  */
        !            34: struct uba_hd {
        !            35:        struct  uba_regs *uh_uba;       /* virt addr of uba */
        !            36:        struct  uba_regs *uh_physuba;   /* phys addr of uba */
        !            37:        int     (**uh_vec)();           /* interrupt vector */
        !            38:        struct  uba_device *uh_actf;    /* head of queue to transfer */
        !            39:        struct  uba_device *uh_actl;    /* tail of queue to transfer */
        !            40:        short   uh_mrwant;              /* someone is waiting for map reg */
        !            41:        short   uh_bdpwant;             /* someone awaits bdp's */
        !            42:        int     uh_bdpfree;             /* free bdp's */
        !            43:        int     uh_hangcnt;             /* number of ticks hung */
        !            44:        int     uh_zvcnt;               /* number of 0 vectors */
        !            45:        int     uh_errcnt;              /* number of errors */
        !            46:        int     uh_lastiv;              /* last free interrupt vector */
        !            47:        short   uh_users;               /* transient bdp use count */
        !            48:        short   uh_xclu;                /* an rk07 is using this uba! */
        !            49: #define        UAMSIZ  25
        !            50:        struct  map *uh_map;            /* buffered data path regs free */
        !            51: };
        !            52: 
        !            53: #ifndef LOCORE
        !            54: /*
        !            55:  * Per-controller structure.
        !            56:  * (E.g. one for each disk and tape controller, and other things
        !            57:  * which use and release buffered data paths.)
        !            58:  *
        !            59:  * If a controller has devices attached, then there are
        !            60:  * cross-referenced uba_drive structures.
        !            61:  * This structure is the one which is queued in unibus resource wait,
        !            62:  * and saves the information about unibus resources which are used.
        !            63:  * The queue of devices waiting to transfer is also attached here.
        !            64:  */
        !            65: struct uba_ctlr {
        !            66:        struct  uba_driver *um_driver;
        !            67:        short   um_ctlr;        /* controller index in driver */
        !            68:        short   um_ubanum;      /* the uba it is on */
        !            69:        short   um_alive;       /* controller exists */
        !            70:        int     (**um_intr)();  /* interrupt handler(s) */
        !            71:        caddr_t um_addr;        /* address of device in i/o space */
        !            72:        struct  uba_hd *um_hd;
        !            73: /* the driver saves the prototype command here for use in its go routine */
        !            74:        int     um_cmd;         /* communication to dgo() */
        !            75:        int     um_ubinfo;      /* save unibus registers, etc */
        !            76:        struct  buf um_tab;     /* queue of devices for this controller */
        !            77: };
        !            78: 
        !            79: /*
        !            80:  * Per ``device'' structure.
        !            81:  * (A controller has devices or uses and releases buffered data paths).
        !            82:  * (Everything else is a ``device''.)
        !            83:  *
        !            84:  * If a controller has many drives attached, then there will
        !            85:  * be several uba_device structures associated with a single uba_ctlr
        !            86:  * structure.
        !            87:  *
        !            88:  * This structure contains all the information necessary to run
        !            89:  * a unibus device such as a dz or a dh.  It also contains information
        !            90:  * for slaves of unibus controllers as to which device on the slave
        !            91:  * this is.  A flags field here can also be given in the system specification
        !            92:  * and is used to tell which dz lines are hard wired or other device
        !            93:  * specific parameters.
        !            94:  */
        !            95: struct uba_device {
        !            96:        struct  uba_driver *ui_driver;
        !            97:        short   ui_unit;        /* unit number on the system */
        !            98:        short   ui_ctlr;        /* mass ctlr number; -1 if none */
        !            99:        short   ui_ubanum;      /* the uba it is on */
        !           100:        short   ui_slave;       /* slave on controller */
        !           101:        int     (**ui_intr)();  /* interrupt handler(s) */
        !           102:        caddr_t ui_addr;        /* address of device in i/o space */
        !           103:        short   ui_dk;          /* if init 1 set to number for iostat */
        !           104:        short   ui_flags;       /* parameter from system specification */
        !           105:        short   ui_alive;       /* device exists */
        !           106:        short   ui_type;        /* driver specific type information */
        !           107:        caddr_t ui_physaddr;    /* phys addr, for standalone (dump) code */
        !           108: /* this is the forward link in a list of devices on a controller */
        !           109:        struct  uba_device *ui_forw;
        !           110: /* if the device is connected to a controller, this is the controller */
        !           111:        struct  uba_ctlr *ui_mi;
        !           112:        struct  uba_hd *ui_hd;
        !           113: };
        !           114: #endif
        !           115: 
        !           116: /*
        !           117:  * Per-driver structure.
        !           118:  *
        !           119:  * Each unibus driver defines entries for a set of routines
        !           120:  * as well as an array of types which are acceptable to it.
        !           121:  * These are used at boot time by the configuration program.
        !           122:  */
        !           123: struct uba_driver {
        !           124:        int     (*ud_probe)();          /* see if a driver is really there */
        !           125:        int     (*ud_slave)();          /* see if a slave is there */
        !           126:        int     (*ud_attach)();         /* setup driver for a slave */
        !           127:        int     (*ud_dgo)();            /* fill csr/ba to start transfer */
        !           128:        u_short *ud_addr;               /* device csr addresses */
        !           129:        char    *ud_dname;              /* name of a device */
        !           130:        struct  uba_device **ud_dinfo;  /* backpointers to ubdinit structs */
        !           131:        char    *ud_mname;              /* name of a controller */
        !           132:        struct  uba_ctlr **ud_minfo;    /* backpointers to ubminit structs */
        !           133:        short   ud_xclu;                /* want exclusive use of bdp's */
        !           134: };
        !           135: #endif
        !           136: 
        !           137: /*
        !           138:  * Flags to UBA map/bdp allocation routines
        !           139:  */
        !           140: #define        UBA_NEEDBDP     1               /* transfer needs a bdp */
        !           141: #define        UBA_CANTWAIT    2               /* don't block me */
        !           142: #define        UBA_NEED16      4               /* need 16 bit addresses only */
        !           143: #define        UBA_HAVEBDP     8               /* use bdp specified in high bits */
        !           144: 
        !           145: #ifndef LOCORE
        !           146: #ifdef KERNEL
        !           147: /*
        !           148:  * UBA related kernel variables
        !           149:  */
        !           150: int    numuba;                                 /* number of uba's */
        !           151: extern struct  uba_hd uba_hd[];
        !           152: 
        !           153: /*
        !           154:  * Ubminit and ubdinit initialize the mass storage controller and
        !           155:  * device tables specifying possible devices.
        !           156:  */
        !           157: extern struct  uba_ctlr ubminit[];
        !           158: extern struct  uba_device ubdinit[];
        !           159: 
        !           160: /*
        !           161:  * UNIbus device address space is mapped by UMEMmap
        !           162:  * into virtual address umem[][].
        !           163:  */
        !           164: extern struct pte UMEMmap[][16];       /* uba device addr pte's */
        !           165: extern char umem[][16*NBPG];           /* uba device addr space */
        !           166: 
        !           167: /*
        !           168:  * Since some VAXen vector their first (and only) unibus interrupt
        !           169:  * vector just adjacent to the system control block, we must
        !           170:  * allocate space there when running on ``any'' cpu.  This space is
        !           171:  * used for the vector for uba0 on all cpu's.
        !           172:  */
        !           173: extern int (*UNIvec[])();                      /* unibus vec for uba0 */
        !           174: 
        !           175: #if VAX780
        !           176: /*
        !           177:  * On 780's, we must set the scb vectors for the nexus of the
        !           178:  * UNIbus adaptors to vector to locore unibus adaptor interrupt dispatchers
        !           179:  * which make 780's look like the other VAXen.
        !           180:  */
        !           181: extern Xua0int(), Xua1int(), Xua2int(), Xua3int();
        !           182: #endif VAX780
        !           183: #endif KERNEL
        !           184: #endif !LOCORE

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.