2 * Copyright (c) 1999,2000 Michael Smith
3 * Copyright (c) 2000 BSDi
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions
9 * 1. Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer.
11 * 2. Redistributions in binary form must reproduce the above copyright
12 * notice, this list of conditions and the following disclaimer in the
13 * documentation and/or other materials provided with the distribution.
15 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
16 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
19 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
21 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27 * Copyright (c) 2002 Eric Moore
28 * Copyright (c) 2002 LSI Logic Corporation
29 * All rights reserved.
31 * Redistribution and use in source and binary forms, with or without
32 * modification, are permitted provided that the following conditions
34 * 1. Redistributions of source code must retain the above copyright
35 * notice, this list of conditions and the following disclaimer.
36 * 2. Redistributions in binary form must reproduce the above copyright
37 * notice, this list of conditions and the following disclaimer in the
38 * documentation and/or other materials provided with the distribution.
39 * 3. The party using or redistributing the source code and binary forms
40 * agrees to the disclaimer below and the terms and conditions set forth
43 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
44 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
45 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
46 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
47 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
48 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
49 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
50 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
51 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
52 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
55 * $FreeBSD: src/sys/dev/amr/amrvar.h,v 1.2.2.5 2002/12/20 15:12:04 emoore Exp $
56 * $DragonFly: src/sys/dev/raid/amr/amrvar.h,v 1.9 2006/12/22 23:26:23 swildner Exp $
59 #include <sys/thread2.h>
61 #if defined(__FreeBSD__) && __FreeBSD_version >= 500005
62 # include <sys/taskqueue.h>
66 # define debug(level, fmt, args...) do {if (level <= AMR_DEBUG) kprintf("%s: " fmt "\n", __func__ , ##args);} while(0)
67 # define debug_called(level) do {if (level <= AMR_DEBUG) kprintf("%s: called\n", __func__);} while(0)
69 # define debug(level, fmt, args...)
70 # define debug_called(level)
72 #define xdebug(fmt, args...) kprintf("%s: " fmt "\n", __func__ , ##args)
75 * Per-logical-drive datastructure
83 /* synthetic geometry */
93 * Due to the difficulty of using the zone allocator to create a new
94 * zone from within a module, we use our own clustering to reduce
95 * memory wastage due to allocating lots of these small structures.
97 * 16k gives us a little under 200 command structures, which should
98 * normally be plenty. We will grab more if we need them.
101 #define AMR_CMD_CLUSTERSIZE (16 * 1024)
104 * Per-command control structure.
108 TAILQ_ENTRY(amr_command) ac_link;
110 struct amr_softc *ac_sc;
112 int ac_status; /* command completion status */
113 struct amr_mailbox ac_mailbox;
115 #define AMR_CMD_DATAIN (1<<0)
116 #define AMR_CMD_DATAOUT (1<<1)
117 #define AMR_CMD_CCB_DATAIN (1<<2)
118 #define AMR_CMD_CCB_DATAOUT (1<<3)
119 #define AMR_CMD_PRIORITY (1<<4)
120 #define AMR_CMD_MAPPED (1<<5)
121 #define AMR_CMD_SLEEP (1<<6)
122 #define AMR_CMD_BUSY (1<<7)
128 bus_dmamap_t ac_dmamap;
129 u_int32_t ac_dataphys;
132 size_t ac_ccb_length;
133 bus_dmamap_t ac_ccb_dmamap;
134 u_int32_t ac_ccb_dataphys;
136 void (* ac_complete)(struct amr_command *ac);
140 struct amr_command_cluster
142 TAILQ_ENTRY(amr_command_cluster) acc_link;
143 struct amr_command acc_command[0];
146 #define AMR_CMD_CLUSTERCOUNT ((AMR_CMD_CLUSTERSIZE - sizeof(struct amr_command_cluster)) / \
147 sizeof(struct amr_command))
150 * Per-controller-instance data
154 /* bus attachments */
156 struct resource *amr_reg; /* control registers */
157 bus_space_handle_t amr_bhandle;
158 bus_space_tag_t amr_btag;
159 bus_dma_tag_t amr_parent_dmat; /* parent DMA tag */
160 bus_dma_tag_t amr_buffer_dmat; /* data buffer DMA tag */
161 struct resource *amr_irq; /* interrupt */
165 volatile struct amr_mailbox *amr_mailbox;
166 volatile struct amr_mailbox64 *amr_mailbox64;
167 u_int32_t amr_mailboxphys;
168 bus_dma_tag_t amr_mailbox_dmat;
169 bus_dmamap_t amr_mailbox_dmamap;
171 /* scatter/gather lists and their controller-visible mappings */
172 struct amr_sgentry *amr_sgtable; /* s/g lists */
173 u_int32_t amr_sgbusaddr; /* s/g table base address in bus space */
174 bus_dma_tag_t amr_sg_dmat; /* s/g buffer DMA tag */
175 bus_dmamap_t amr_sg_dmamap; /* map for s/g buffers */
177 /* controller limits and features */
178 int amr_maxio; /* maximum number of I/O transactions */
179 int amr_maxdrives; /* max number of logical drives */
180 int amr_maxchan; /* count of SCSI channels */
182 /* connected logical drives */
183 struct amr_logdrive amr_drive[AMR_MAXLD];
185 /* controller state */
187 #define AMR_STATE_OPEN (1<<0)
188 #define AMR_STATE_SUSPEND (1<<1)
189 #define AMR_STATE_INTEN (1<<2)
190 #define AMR_STATE_SHUTDOWN (1<<3)
192 /* per-controller queues */
193 struct bio_queue_head amr_bioq; /* pending I/O with no commands */
194 TAILQ_HEAD(,amr_command) amr_ready; /* commands ready to be submitted */
195 struct amr_command *amr_busycmd[AMR_MAXCMD];
197 TAILQ_HEAD(,amr_command) amr_completed;
198 TAILQ_HEAD(,amr_command) amr_freecmds;
199 TAILQ_HEAD(,amr_command_cluster) amr_cmd_clusters;
201 /* CAM attachments for passthrough */
202 struct cam_sim *amr_cam_sim[AMR_MAX_CHANNELS];
203 TAILQ_HEAD(, ccb_hdr) amr_cam_ccbq;
208 /* controller type-specific support */
210 #define AMR_TYPE_QUARTZ (1<<0)
211 #define AMR_IS_QUARTZ(sc) ((sc)->amr_type & AMR_TYPE_QUARTZ)
212 #define AMR_TYPE_40LD (1<<1)
213 #define AMR_IS_40LD(sc) ((sc)->amr_type & AMR_TYPE_40LD)
214 int (* amr_submit_command)(struct amr_softc *sc);
215 int (* amr_get_work)(struct amr_softc *sc, struct amr_mailbox *mbsave);
216 int (*amr_poll_command)(struct amr_command *ac);
217 int support_ext_cdb; /* greater than 10 byte cdb support */
220 struct intr_config_hook amr_ich; /* wait-for-interrupts probe hook */
221 struct callout amr_timeout; /* periodic status check */
222 #if defined(__FreeBSD__) && __FreeBSD_version >= 500005
223 struct task amr_task_complete; /* deferred-completion task */
228 * Interface between bus connections and driver core.
230 extern int amr_attach(struct amr_softc *sc);
231 extern void amr_free(struct amr_softc *sc);
232 extern int amr_flush(struct amr_softc *sc);
233 extern int amr_done(struct amr_softc *sc);
234 extern void amr_startio(struct amr_softc *sc);
237 * Command buffer allocation.
239 extern struct amr_command *amr_alloccmd(struct amr_softc *sc);
240 extern void amr_releasecmd(struct amr_command *ac);
245 extern int amr_cam_attach(struct amr_softc *sc);
246 extern void amr_cam_detach(struct amr_softc *sc);
247 extern int amr_cam_command(struct amr_softc *sc, struct amr_command **acp);
250 * MegaRAID logical disk driver
256 struct amr_softc *amrd_controller;
257 struct amr_logdrive *amrd_drive;
258 struct disk amrd_disk;
259 struct devstat amrd_stats;
262 #define AMRD_OPEN (1<<0) /* drive is open (can't detach) */
266 * Interface between driver core and disk driver (should be using a bus?)
268 extern int amr_submit_bio(struct amr_softc *sc, struct bio *bio);
269 extern void amrd_intr(struct bio *bio);
270 extern int amr_dump_blocks(struct amr_softc *sc, int unit, u_int32_t lba, void *data, int blks);
272 /********************************************************************************
273 * Enqueue/dequeue functions
276 amr_enqueue_bio(struct amr_softc *sc, struct bio *bio)
279 bioq_insert_tail(&sc->amr_bioq, bio);
283 static __inline struct bio *
284 amr_dequeue_bio(struct amr_softc *sc)
289 if ((bio = bioq_first(&sc->amr_bioq)) != NULL)
290 bioq_remove(&sc->amr_bioq, bio);
296 amr_enqueue_ready(struct amr_command *ac)
299 TAILQ_INSERT_TAIL(&ac->ac_sc->amr_ready, ac, ac_link);
304 amr_requeue_ready(struct amr_command *ac)
307 TAILQ_INSERT_HEAD(&ac->ac_sc->amr_ready, ac, ac_link);
311 static __inline struct amr_command *
312 amr_dequeue_ready(struct amr_softc *sc)
314 struct amr_command *ac;
317 if ((ac = TAILQ_FIRST(&sc->amr_ready)) != NULL)
318 TAILQ_REMOVE(&sc->amr_ready, ac, ac_link);
324 amr_enqueue_completed(struct amr_command *ac)
327 TAILQ_INSERT_TAIL(&ac->ac_sc->amr_completed, ac, ac_link);
331 static __inline struct amr_command *
332 amr_dequeue_completed(struct amr_softc *sc)
334 struct amr_command *ac;
337 if ((ac = TAILQ_FIRST(&sc->amr_completed)) != NULL)
338 TAILQ_REMOVE(&sc->amr_completed, ac, ac_link);
344 amr_enqueue_free(struct amr_command *ac)
347 TAILQ_INSERT_TAIL(&ac->ac_sc->amr_freecmds, ac, ac_link);
351 static __inline struct amr_command *
352 amr_dequeue_free(struct amr_softc *sc)
354 struct amr_command *ac;
357 if ((ac = TAILQ_FIRST(&sc->amr_freecmds)) != NULL)
358 TAILQ_REMOVE(&sc->amr_freecmds, ac, ac_link);