1 /* ubavar.h 4.25 82/04/11 */ 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 int 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 0x01 /* transfer needs a bdp */ 141 #define UBA_CANTWAIT 0x02 /* don't block me */ 142 #define UBA_NEED16 0x04 /* need 16 bit addresses only */ 143 #define UBA_HAVEBDP 0x08 /* use bdp specified in high bits */ 144 145 /* 146 * Macros to bust return word from map allocation routines. 147 */ 148 #define UBAI_BDP(i) ((int)(((unsigned)(i))>>28)) 149 #define UBAI_NMR(i) ((int)((i)>>18)&0x3ff) 150 #define UBAI_MR(i) ((int)((i)>>9)&0x1ff) 151 #define UBAI_BOFF(i) ((int)((i)&0x1ff)) 152 153 #ifndef LOCORE 154 #ifdef KERNEL 155 /* 156 * UBA related kernel variables 157 */ 158 int numuba; /* number of uba's */ 159 struct uba_hd uba_hd[]; 160 161 /* 162 * Ubminit and ubdinit initialize the mass storage controller and 163 * device tables specifying possible devices. 164 */ 165 extern struct uba_ctlr ubminit[]; 166 extern struct uba_device ubdinit[]; 167 168 /* 169 * UNIbus device address space is mapped by UMEMmap 170 * into virtual address umem[][]. 171 */ 172 extern struct pte UMEMmap[][512]; /* uba device addr pte's */ 173 extern char umem[][512*NBPG]; /* uba device addr space */ 174 175 /* 176 * Since some VAXen vector their first (and only) unibus interrupt 177 * vector just adjacent to the system control block, we must 178 * allocate space there when running on ``any'' cpu. This space is 179 * used for the vector for uba0 on all cpu's. 180 */ 181 extern int (*UNIvec[])(); /* unibus vec for uba0 */ 182 183 #if VAX780 184 /* 185 * On 780's, we must set the scb vectors for the nexus of the 186 * UNIbus adaptors to vector to locore unibus adaptor interrupt dispatchers 187 * which make 780's look like the other VAXen. 188 */ 189 extern Xua0int(), Xua1int(), Xua2int(), Xua3int(); 190 #endif VAX780 191 #endif KERNEL 192 #endif !LOCORE 193