1 /*- 2 * Copyright (c) 1999 Michael Smith 3 * All rights reserved. 4 * 5 * Redistribution and use in source and binary forms, with or without 6 * modification, are permitted provided that the following conditions 7 * are met: 8 * 1. Redistributions of source code must retain the above copyright 9 * notice, this list of conditions and the following disclaimer. 10 * 2. Redistributions in binary form must reproduce the above copyright 11 * notice, this list of conditions and the following disclaimer in the 12 * documentation and/or other materials provided with the distribution. 13 * 14 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 15 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 17 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 18 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 20 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 21 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 22 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 23 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 24 * SUCH DAMAGE. 25 * 26 * $FreeBSD: src/sys/dev/mlx/mlxvar.h,v 1.5.2.3 2001/06/25 04:37:51 msmith Exp $ 27 * $DragonFly: src/sys/dev/raid/mlx/mlxvar.h,v 1.11 2007/05/15 00:01:04 dillon Exp $ 28 */ 29 30 /* 31 * Debugging levels: 32 * 0 - quiet, only emit warnings 33 * 1 - noisy, emit major function points and things done 34 * 2 - extremely noisy, emit trace items in loops, etc. 35 */ 36 #ifdef MLX_DEBUG 37 #define debug(level, fmt, args...) do { if (level <= MLX_DEBUG) kprintf("%s: " fmt "\n", __func__ , ##args); } while(0) 38 #define debug_called(level) do { if (level <= MLX_DEBUG) kprintf(__func__ ": called\n"); } while(0) 39 #else 40 #define debug(level, fmt, args...) 41 #define debug_called(level) 42 #endif 43 44 /* 45 * Regardless of the actual capacity of the controller, we will allocate space 46 * for 64 s/g entries. Typically controllers support 17 or 33 entries (64k or 47 * 128k maximum transfer assuming 4k page size and non-optimal alignment), but 48 * making that fit cleanly without crossing page boundaries requires rounding up 49 * to the next power of two. 50 */ 51 #define MLX_NSEG 64 52 53 #define MLX_NSLOTS 256 /* max number of command slots */ 54 55 #define MLX_MAXDRIVES 32 /* max number of system drives */ 56 57 /* 58 * Structure describing a System Drive as attached to the controller. 59 */ 60 struct mlx_sysdrive 61 { 62 /* from MLX_CMD_ENQSYSDRIVE */ 63 u_int32_t ms_size; 64 int ms_state; 65 int ms_raidlevel; 66 67 /* synthetic geometry */ 68 int ms_cylinders; 69 int ms_heads; 70 int ms_sectors; 71 72 /* handle for attached driver */ 73 device_t ms_disk; 74 }; 75 76 /* 77 * Per-command control structure. 78 */ 79 struct mlx_command 80 { 81 TAILQ_ENTRY(mlx_command) mc_link; /* list linkage */ 82 83 struct mlx_softc *mc_sc; /* controller that owns us */ 84 u_int8_t mc_slot; /* command slot we occupy */ 85 u_int16_t mc_status; /* command completion status */ 86 time_t mc_timeout; /* when this command expires */ 87 u_int8_t mc_mailbox[16]; /* command mailbox */ 88 u_int32_t mc_sgphys; /* physical address of s/g array in controller space */ 89 int mc_nsgent; /* number of entries in s/g map */ 90 int mc_flags; 91 #define MLX_CMD_DATAIN (1<<0) 92 #define MLX_CMD_DATAOUT (1<<1) 93 #define MLX_CMD_PRIORITY (1<<2) /* high-priority command */ 94 95 void *mc_data; /* data buffer */ 96 size_t mc_length; 97 bus_dmamap_t mc_dmamap; /* DMA map for data */ 98 u_int32_t mc_dataphys; /* data buffer base address controller space */ 99 100 void (* mc_complete)(struct mlx_command *mc); /* completion handler */ 101 void *mc_private; /* submitter-private data or wait channel */ 102 }; 103 104 /* 105 * Per-controller structure. 106 */ 107 struct mlx_softc 108 { 109 /* bus connections */ 110 device_t mlx_dev; 111 struct resource *mlx_mem; /* mailbox interface window */ 112 int mlx_mem_rid; 113 int mlx_mem_type; 114 bus_space_handle_t mlx_bhandle; /* bus space handle */ 115 bus_space_tag_t mlx_btag; /* bus space tag */ 116 bus_dma_tag_t mlx_parent_dmat;/* parent DMA tag */ 117 bus_dma_tag_t mlx_buffer_dmat;/* data buffer DMA tag */ 118 struct resource *mlx_irq; /* interrupt */ 119 void *mlx_intr; /* interrupt handle */ 120 121 /* scatter/gather lists and their controller-visible mappings */ 122 struct mlx_sgentry *mlx_sgtable; /* s/g lists */ 123 u_int32_t mlx_sgbusaddr; /* s/g table base address in bus space */ 124 bus_dma_tag_t mlx_sg_dmat; /* s/g buffer DMA tag */ 125 bus_dmamap_t mlx_sg_dmamap; /* map for s/g buffers */ 126 127 /* controller limits and features */ 128 struct mlx_enquiry2 *mlx_enq2; 129 int mlx_feature; /* controller features/quirks */ 130 #define MLX_FEAT_PAUSEWORKS (1<<0) /* channel pause works as expected */ 131 132 /* controller queues and arrays */ 133 TAILQ_HEAD(, mlx_command) mlx_freecmds; /* command structures available for reuse */ 134 TAILQ_HEAD(, mlx_command) mlx_work; /* active commands */ 135 struct mlx_command *mlx_busycmd[MLX_NSLOTS]; /* busy commands */ 136 int mlx_busycmds; /* count of busy commands */ 137 struct mlx_sysdrive mlx_sysdrive[MLX_MAXDRIVES]; /* system drives */ 138 mlx_bioq mlx_bioq; /* outstanding I/O operations */ 139 int mlx_waitbufs; /* number of bufs awaiting commands */ 140 141 /* controller status */ 142 int mlx_geom; 143 #define MLX_GEOM_128_32 0 /* geoemetry translation modes */ 144 #define MLX_GEOM_256_63 1 145 int mlx_state; 146 #define MLX_STATE_INTEN (1<<0) /* interrupts have been enabled */ 147 #define MLX_STATE_SHUTDOWN (1<<1) /* controller is shut down */ 148 #define MLX_STATE_OPEN (1<<2) /* control device is open */ 149 #define MLX_STATE_SUSPEND (1<<3) /* controller is suspended */ 150 struct callout mlx_timeout; /* periodic status monitor */ 151 time_t mlx_lastpoll; /* last time_second we polled for status */ 152 u_int16_t mlx_lastevent; /* sequence number of the last event we recorded */ 153 int mlx_currevent; /* sequence number last time we looked */ 154 int mlx_background; /* if != 0 rebuild or check is in progress */ 155 #define MLX_BACKGROUND_CHECK 1 /* we started a check */ 156 #define MLX_BACKGROUND_REBUILD 2 /* we started a rebuild */ 157 #define MLX_BACKGROUND_SPONTANEOUS 3 /* it just happened somehow */ 158 struct mlx_rebuild_status mlx_rebuildstat; /* last rebuild status */ 159 struct mlx_pause mlx_pause; /* pending pause operation details */ 160 161 int mlx_locks; /* reentrancy avoidance */ 162 int mlx_flags; 163 #define MLX_SPINUP_REPORTED (1<<0) /* "spinning up drives" message displayed */ 164 #define MLX_EVENTLOG_BUSY (1<<1) /* currently reading event log */ 165 166 /* interface-specific accessor functions */ 167 int mlx_iftype; /* interface protocol */ 168 #define MLX_IFTYPE_2 2 169 #define MLX_IFTYPE_3 3 170 #define MLX_IFTYPE_4 4 171 #define MLX_IFTYPE_5 5 172 int (* mlx_tryqueue)(struct mlx_softc *sc, struct mlx_command *mc); 173 int (* mlx_findcomplete)(struct mlx_softc *sc, u_int8_t *slot, u_int16_t *status); 174 void (* mlx_intaction)(struct mlx_softc *sc, int action); 175 int (* mlx_fw_handshake)(struct mlx_softc *sc, int *error, int *param1, int *param2); 176 #define MLX_INTACTION_DISABLE 0 177 #define MLX_INTACTION_ENABLE 1 178 }; 179 180 /* 181 * Simple (stupid) locks. 182 * 183 * Note that these are designed to avoid reentrancy, not concurrency, and will 184 * need to be replaced with something better. 185 */ 186 #define MLX_LOCK_COMPLETING (1<<0) 187 #define MLX_LOCK_STARTING (1<<1) 188 189 static __inline int 190 mlx_lock_tas(struct mlx_softc *sc, int lock) 191 { 192 if ((sc)->mlx_locks & (lock)) 193 return(1); 194 atomic_set_int(&sc->mlx_locks, lock); 195 return(0); 196 } 197 198 static __inline void 199 mlx_lock_clr(struct mlx_softc *sc, int lock) 200 { 201 atomic_clear_int(&sc->mlx_locks, lock); 202 } 203 204 /* 205 * Interface between bus connections and driver core. 206 */ 207 extern void mlx_free(struct mlx_softc *sc); 208 extern int mlx_attach(struct mlx_softc *sc); 209 extern void mlx_startup(struct mlx_softc *sc); 210 extern void mlx_intr(void *data); 211 extern int mlx_detach(device_t dev); 212 extern int mlx_shutdown(device_t dev); 213 extern int mlx_suspend(device_t dev); 214 extern int mlx_resume(device_t dev); 215 extern d_open_t mlx_open; 216 extern d_close_t mlx_close; 217 extern d_ioctl_t mlx_ioctl; 218 219 extern devclass_t mlx_devclass; 220 extern devclass_t mlxd_devclass; 221 222 /* 223 * Mylex System Disk driver 224 */ 225 struct mlxd_softc 226 { 227 device_t mlxd_dev; 228 cdev_t mlxd_dev_t; 229 struct mlx_softc *mlxd_controller; 230 struct mlx_sysdrive *mlxd_drive; 231 struct disk mlxd_disk; 232 struct devstat mlxd_stats; 233 int mlxd_unit; 234 int mlxd_flags; 235 #define MLXD_OPEN (1<<0) /* drive is open (can't shut down) */ 236 }; 237 238 /* 239 * Interface between driver core and disk driver (should be using a bus?) 240 */ 241 extern int mlx_submit_bio(struct mlx_softc *sc, struct bio *bio); 242 extern int mlx_submit_ioctl(struct mlx_softc *sc, 243 struct mlx_sysdrive *drive, u_long cmd, 244 caddr_t addr, int32_t flag); 245 extern void mlxd_intr(struct bio *bio); 246 247 248