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 */
79struct 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
105typedef STAILQ_HEAD(, amr_command)	ac_qhead_t;
106typedef STAILQ_ENTRY(amr_command)	ac_link_t;
107
108union 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 */
117struct 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
162struct 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 */
174struct 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 */
270extern int              amr_attach(struct amr_softc *sc);
271extern void		amr_free(struct amr_softc *sc);
272extern int		amr_flush(struct amr_softc *sc);
273extern int		amr_done(struct amr_softc *sc);
274extern void		amr_startio(struct amr_softc *sc);
275
276/*
277 * Command buffer allocation.
278 */
279extern struct amr_command	*amr_alloccmd(struct amr_softc *sc);
280extern void			amr_releasecmd(struct amr_command *ac);
281
282/*
283 * MegaRAID logical disk driver
284 */
285struct 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 */
297extern int	amr_submit_bio(struct amr_softc *sc, struct bio *bio);
298extern int 	amr_dump_blocks(struct amr_softc *sc, int unit, u_int32_t lba, void *data, int blks);
299extern void	amrd_intr(void *data);
300
301/********************************************************************************
302 * Enqueue/dequeue functions
303 */
304static __inline void
305amr_enqueue_bio(struct amr_softc *sc, struct bio *bio)
306{
307
308    bioq_insert_tail(&sc->amr_bioq, bio);
309}
310
311static __inline struct bio *
312amr_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
321static __inline void
322amr_init_qhead(ac_qhead_t *head)
323{
324
325	STAILQ_INIT(head);
326}
327
328static __inline void
329amr_enqueue_ready(struct amr_command *ac)
330{
331
332    STAILQ_INSERT_TAIL(&ac->ac_sc->amr_ready, ac, ac_link);
333}
334
335static __inline void
336amr_requeue_ready(struct amr_command *ac)
337{
338
339    STAILQ_INSERT_HEAD(&ac->ac_sc->amr_ready, ac, ac_link);
340}
341
342static __inline struct amr_command *
343amr_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
352static __inline void
353amr_enqueue_completed(struct amr_command *ac, ac_qhead_t *head)
354{
355
356    STAILQ_INSERT_TAIL(head, ac, ac_link);
357}
358
359static __inline struct amr_command *
360amr_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
369static __inline void
370amr_enqueue_free(struct amr_command *ac)
371{
372
373    STAILQ_INSERT_HEAD(&ac->ac_sc->amr_freecmds, ac, ac_link);
374}
375
376static __inline struct amr_command *
377amr_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