xref: /freebsd-13.1/sys/dev/amr/amrvar.h (revision 718cf2cc)
1 /*-
2  * SPDX-License-Identifier: BSD-2-Clause-FreeBSD AND BSD-3-Clause
3  *
4  * Copyright (c) 1999,2000 Michael Smith
5  * Copyright (c) 2000 BSDi
6  * All rights reserved.
7  *
8  * Redistribution and use in source and binary forms, with or without
9  * modification, are permitted provided that the following conditions
10  * are met:
11  * 1. Redistributions of source code must retain the above copyright
12  *    notice, this list of conditions and the following disclaimer.
13  * 2. Redistributions in binary form must reproduce the above copyright
14  *    notice, this list of conditions and the following disclaimer in the
15  *    documentation and/or other materials provided with the distribution.
16  *
17  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
18  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
21  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27  * SUCH DAMAGE.
28  *
29  * Copyright (c) 2002 Eric Moore
30  * Copyright (c) 2002 LSI Logic Corporation
31  * All rights reserved.
32  *
33  * Redistribution and use in source and binary forms, with or without
34  * modification, are permitted provided that the following conditions
35  * are met:
36  * 1. Redistributions of source code must retain the above copyright
37  *    notice, this list of conditions and the following disclaimer.
38  * 2. Redistributions in binary form must reproduce the above copyright
39  *    notice, this list of conditions and the following disclaimer in the
40  *    documentation and/or other materials provided with the distribution.
41  * 3. The party using or redistributing the source code and binary forms
42  *    agrees to the disclaimer below and the terms and conditions set forth
43  *    herein.
44  *
45  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
46  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
47  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
48  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
49  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
50  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
51  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
52  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
53  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
54  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
55  * SUCH DAMAGE.
56  *
57  *
58  *      $FreeBSD$
59  */
60 
61 #include <geom/geom_disk.h>
62 #include <sys/lock.h>
63 #include <sys/mutex.h>
64 
65 #define LSI_DESC_PCI "LSILogic MegaRAID 1.53"
66 
67 #ifdef AMR_DEBUG
68 # define debug(level, fmt, args...)	do {if (level <= AMR_DEBUG) printf("%s: " fmt "\n", __func__ , ##args);} while(0)
69 # define debug_called(level)		do {if (level <= AMR_DEBUG) printf("%s: called\n", __func__);} while(0)
70 #else
71 # define debug(level, fmt, args...)	do {} while (0)
72 # define debug_called(level)		do {} while (0)
73 #endif
74 #define xdebug(fmt, args...)	printf("%s: " fmt "\n", __func__ , ##args)
75 
76 /*
77  * Per-logical-drive datastructure
78  */
79 struct amr_logdrive
80 {
81     u_int32_t	al_size;
82     int		al_state;
83     int		al_properties;
84 
85     /* synthetic geometry */
86     int		al_cylinders;
87     int		al_heads;
88     int		al_sectors;
89 
90     /* driver */
91     device_t	al_disk;
92 };
93 
94 /*
95  * Due to the difficulty of using the zone allocator to create a new
96  * zone from within a module, we use our own clustering to reduce
97  * memory wastage due to allocating lots of these small structures.
98  *
99  * 16k gives us a little under 200 command structures, which should
100  * normally be plenty.  We will grab more if we need them.
101  */
102 
103 #define AMR_CMD_CLUSTERSIZE	(16 * 1024)
104 
105 typedef STAILQ_HEAD(, amr_command)	ac_qhead_t;
106 typedef STAILQ_ENTRY(amr_command)	ac_link_t;
107 
108 union amr_ccb {
109     struct amr_passthrough	ccb_pthru;
110     struct amr_ext_passthrough	ccb_epthru;
111     uint8_t			bytes[128];
112 };
113 
114 /*
115  * Per-command control structure.
116  */
117 struct amr_command
118 {
119     ac_link_t			ac_link;
120 
121     struct amr_softc		*ac_sc;
122     u_int8_t			ac_slot;
123     int				ac_status;	/* command completion status */
124     union {
125 	struct amr_sgentry	*sg32;
126 	struct amr_sg64entry	*sg64;
127     } ac_sg;
128     u_int32_t			ac_sgbusaddr;
129     u_int32_t			ac_sg64_lo;
130     u_int32_t			ac_sg64_hi;
131     struct amr_mailbox		ac_mailbox;
132     int				ac_flags;
133 #define AMR_CMD_DATAIN		(1<<0)
134 #define AMR_CMD_DATAOUT		(1<<1)
135 #define AMR_CMD_CCB		(1<<2)
136 #define AMR_CMD_PRIORITY	(1<<4)
137 #define AMR_CMD_MAPPED		(1<<5)
138 #define AMR_CMD_SLEEP		(1<<6)
139 #define AMR_CMD_BUSY		(1<<7)
140 #define AMR_CMD_SG64		(1<<8)
141 #define AC_IS_SG64(ac)		((ac)->ac_flags & AMR_CMD_SG64)
142     u_int			ac_retries;
143 
144     struct bio			*ac_bio;
145     void			(* ac_complete)(struct amr_command *ac);
146     void			*ac_private;
147 
148     void			*ac_data;
149     size_t			ac_length;
150     bus_dmamap_t		ac_dmamap;
151     bus_dmamap_t		ac_dma64map;
152 
153     bus_dma_tag_t		ac_tag;
154     bus_dmamap_t		ac_datamap;
155     int				ac_nsegments;
156     uint32_t			ac_mb_physaddr;
157 
158     union amr_ccb		*ac_ccb;
159     uint32_t			ac_ccb_busaddr;
160 };
161 
162 struct amr_command_cluster
163 {
164     TAILQ_ENTRY(amr_command_cluster)	acc_link;
165     struct amr_command		acc_command[0];
166 };
167 
168 #define AMR_CMD_CLUSTERCOUNT	((AMR_CMD_CLUSTERSIZE - sizeof(struct amr_command_cluster)) /	\
169 				 sizeof(struct amr_command))
170 
171 /*
172  * Per-controller-instance data
173  */
174 struct amr_softc
175 {
176     /* bus attachments */
177     device_t			amr_dev;
178     struct resource		*amr_reg;		/* control registers */
179     bus_space_handle_t		amr_bhandle;
180     bus_space_tag_t		amr_btag;
181     bus_dma_tag_t		amr_parent_dmat;	/* parent DMA tag */
182     bus_dma_tag_t		amr_buffer_dmat;	/* data buffer DMA tag */
183     bus_dma_tag_t		amr_buffer64_dmat;
184     struct resource		*amr_irq;		/* interrupt */
185     void			*amr_intr;
186 
187     /* mailbox */
188     volatile struct amr_mailbox		*amr_mailbox;
189     volatile struct amr_mailbox64	*amr_mailbox64;
190     u_int32_t			amr_mailboxphys;
191     bus_dma_tag_t		amr_mailbox_dmat;
192     bus_dmamap_t		amr_mailbox_dmamap;
193 
194     /* scatter/gather lists and their controller-visible mappings */
195     struct amr_sgentry		*amr_sgtable;		/* s/g lists */
196     struct amr_sg64entry	*amr_sg64table;		/* 64bit s/g lists */
197     u_int32_t			amr_sgbusaddr;		/* s/g table base address in bus space */
198     bus_dma_tag_t		amr_sg_dmat;		/* s/g buffer DMA tag */
199     bus_dmamap_t		amr_sg_dmamap;		/* map for s/g buffers */
200 
201     union amr_ccb		*amr_ccb;
202     uint32_t			amr_ccb_busaddr;
203     bus_dma_tag_t		amr_ccb_dmat;
204     bus_dmamap_t		amr_ccb_dmamap;
205 
206     /* controller limits and features */
207     int				amr_nextslot;		/* Next slot to use for newly allocated commands */
208     int				amr_maxio;		/* maximum number of I/O transactions */
209     int				amr_maxdrives;		/* max number of logical drives */
210     int				amr_maxchan;		/* count of SCSI channels */
211 
212     /* connected logical drives */
213     struct amr_logdrive		amr_drive[AMR_MAXLD];
214 
215     /* controller state */
216     int				amr_state;
217 #define AMR_STATE_OPEN		(1<<0)
218 #define AMR_STATE_SUSPEND	(1<<1)
219 #define AMR_STATE_INTEN		(1<<2)
220 #define AMR_STATE_SHUTDOWN	(1<<3)
221 #define AMR_STATE_CRASHDUMP	(1<<4)
222 #define AMR_STATE_QUEUE_FRZN	(1<<5)
223 #define AMR_STATE_LD_DELETE	(1<<6)
224 #define AMR_STATE_REMAP_LD	(1<<7)
225 
226     /* per-controller queues */
227     struct bio_queue_head 	amr_bioq;		/* pending I/O with no commands */
228     ac_qhead_t			amr_ready;		/* commands ready to be submitted */
229     struct amr_command		*amr_busycmd[AMR_MAXCMD];
230     int				amr_busyslots;
231     ac_qhead_t			amr_freecmds;
232     TAILQ_HEAD(,amr_command_cluster)	amr_cmd_clusters;
233 
234     /* CAM attachments for passthrough */
235     struct cam_sim		*amr_cam_sim[AMR_MAX_CHANNELS];
236     TAILQ_HEAD(, ccb_hdr)	amr_cam_ccbq;
237     struct cam_devq		*amr_cam_devq;
238 
239     /* control device */
240     struct cdev			*amr_dev_t;
241     struct mtx			amr_list_lock;
242 
243     /* controller type-specific support */
244     int				amr_type;
245 #define AMR_TYPE_QUARTZ		(1<<0)
246 #define AMR_IS_QUARTZ(sc)	((sc)->amr_type & AMR_TYPE_QUARTZ)
247 #define AMR_TYPE_40LD		(1<<1)
248 #define AMR_IS_40LD(sc)		((sc)->amr_type & AMR_TYPE_40LD)
249 #define AMR_TYPE_SG64		(1<<2)
250 #define AMR_IS_SG64(sc)		((sc)->amr_type & AMR_TYPE_SG64)
251     int				(* amr_submit_command)(struct amr_command *ac);
252     int				(* amr_get_work)(struct amr_softc *sc, struct amr_mailbox *mbsave);
253     int				(*amr_poll_command)(struct amr_command *ac);
254     int				(*amr_poll_command1)(struct amr_softc *sc, struct amr_command *ac);
255     int 			support_ext_cdb;	/* greater than 10 byte cdb support */
256 
257     /* misc glue */
258     device_t			amr_pass;
259     int				(*amr_cam_command)(struct amr_softc *sc, struct amr_command **acp);
260     struct intr_config_hook	amr_ich;		/* wait-for-interrupts probe hook */
261     int				amr_allow_vol_config;
262     int				amr_linux_no_adapters;
263     int				amr_ld_del_supported;
264     struct mtx			amr_hw_lock;
265 };
266 
267 /*
268  * Interface between bus connections and driver core.
269  */
270 extern int              amr_attach(struct amr_softc *sc);
271 extern void		amr_free(struct amr_softc *sc);
272 extern int		amr_flush(struct amr_softc *sc);
273 extern int		amr_done(struct amr_softc *sc);
274 extern void		amr_startio(struct amr_softc *sc);
275 
276 /*
277  * Command buffer allocation.
278  */
279 extern struct amr_command	*amr_alloccmd(struct amr_softc *sc);
280 extern void			amr_releasecmd(struct amr_command *ac);
281 
282 /*
283  * MegaRAID logical disk driver
284  */
285 struct amrd_softc
286 {
287     device_t		amrd_dev;
288     struct amr_softc	*amrd_controller;
289     struct amr_logdrive	*amrd_drive;
290     struct disk		*amrd_disk;
291     int			amrd_unit;
292 };
293 
294 /*
295  * Interface between driver core and disk driver (should be using a bus?)
296  */
297 extern int	amr_submit_bio(struct amr_softc *sc, struct bio *bio);
298 extern int 	amr_dump_blocks(struct amr_softc *sc, int unit, u_int32_t lba, void *data, int blks);
299 extern void	amrd_intr(void *data);
300 
301 /********************************************************************************
302  * Enqueue/dequeue functions
303  */
304 static __inline void
amr_enqueue_bio(struct amr_softc * sc,struct bio * bio)305 amr_enqueue_bio(struct amr_softc *sc, struct bio *bio)
306 {
307 
308     bioq_insert_tail(&sc->amr_bioq, bio);
309 }
310 
311 static __inline struct bio *
amr_dequeue_bio(struct amr_softc * sc)312 amr_dequeue_bio(struct amr_softc *sc)
313 {
314     struct bio	*bio;
315 
316     if ((bio = bioq_first(&sc->amr_bioq)) != NULL)
317 	bioq_remove(&sc->amr_bioq, bio);
318     return(bio);
319 }
320 
321 static __inline void
amr_init_qhead(ac_qhead_t * head)322 amr_init_qhead(ac_qhead_t *head)
323 {
324 
325 	STAILQ_INIT(head);
326 }
327 
328 static __inline void
amr_enqueue_ready(struct amr_command * ac)329 amr_enqueue_ready(struct amr_command *ac)
330 {
331 
332     STAILQ_INSERT_TAIL(&ac->ac_sc->amr_ready, ac, ac_link);
333 }
334 
335 static __inline void
amr_requeue_ready(struct amr_command * ac)336 amr_requeue_ready(struct amr_command *ac)
337 {
338 
339     STAILQ_INSERT_HEAD(&ac->ac_sc->amr_ready, ac, ac_link);
340 }
341 
342 static __inline struct amr_command *
amr_dequeue_ready(struct amr_softc * sc)343 amr_dequeue_ready(struct amr_softc *sc)
344 {
345     struct amr_command	*ac;
346 
347     if ((ac = STAILQ_FIRST(&sc->amr_ready)) != NULL)
348 	STAILQ_REMOVE_HEAD(&sc->amr_ready, ac_link);
349     return(ac);
350 }
351 
352 static __inline void
amr_enqueue_completed(struct amr_command * ac,ac_qhead_t * head)353 amr_enqueue_completed(struct amr_command *ac, ac_qhead_t *head)
354 {
355 
356     STAILQ_INSERT_TAIL(head, ac, ac_link);
357 }
358 
359 static __inline struct amr_command *
amr_dequeue_completed(struct amr_softc * sc,ac_qhead_t * head)360 amr_dequeue_completed(struct amr_softc *sc, ac_qhead_t *head)
361 {
362     struct amr_command	*ac;
363 
364     if ((ac = STAILQ_FIRST(head)) != NULL)
365 	STAILQ_REMOVE_HEAD(head, ac_link);
366     return(ac);
367 }
368 
369 static __inline void
amr_enqueue_free(struct amr_command * ac)370 amr_enqueue_free(struct amr_command *ac)
371 {
372 
373     STAILQ_INSERT_HEAD(&ac->ac_sc->amr_freecmds, ac, ac_link);
374 }
375 
376 static __inline struct amr_command *
amr_dequeue_free(struct amr_softc * sc)377 amr_dequeue_free(struct amr_softc *sc)
378 {
379     struct amr_command	*ac;
380 
381     if ((ac = STAILQ_FIRST(&sc->amr_freecmds)) != NULL)
382 	STAILQ_REMOVE_HEAD(&sc->amr_freecmds, ac_link);
383     return(ac);
384 }
385