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