xref: /netbsd-src/sys/dev/ic/esiopvar.h (revision d20841bb642898112fe68f0ad3f7b26dddf56f07)
1 /*	$NetBSD: esiopvar.h,v 1.8 2003/11/02 11:07:45 wiz Exp $	*/
2 
3 /*
4  * Copyright (c) 2002 Manuel Bouyer.
5  *
6  * Redistribution and use in source and binary forms, with or without
7  * modification, are permitted provided that the following conditions
8  * are met:
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.
14  * 3. All advertising materials mentioning features or use of this software
15  *    must display the following acknowledgement:
16  *	This product includes software developed by Manuel Bouyer.
17  * 4. The name of the author may not be used to endorse or promote products
18  *    derived from this software without specific prior written permission.
19  *
20  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
21  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
22  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
23  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
24  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
25  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
26  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
27  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
28  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
29  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
30  *
31  */
32 
33 /* structure and definitions for the siop driver */
34 
35 /* Number of tag */
36 #define ESIOP_NTAG 256
37 
38 /*
39  * description of a command scheduler slot. The script uses a ring of
40  * A_ncmd_slots of this.
41  */
42 struct esiop_slot {
43 	u_int32_t dsa; /* DSA of the xfer. The first 2 bits holds flags */
44 } __attribute__((__packed__));
45 
46 #define CMD_SLOTSIZE (sizeof(struct esiop_slot) / sizeof(u_int32_t))
47 
48 /*
49  * xfer description of the script: tables and reselect script
50  * In struct siop_common_cmd siop_xfer will point to this.
51  * If you change this don't forget to update o_cmd_* and cmd_slot_size in script
52  */
53 struct esiop_xfer {
54 	struct siop_common_xfer siop_tables;
55 	u_int32_t tlq; /* target/lun/tag loaded in scratchC by script */
56 } __attribute__((__packed__));
57 
58 /*
59  * This describes a command handled by the SCSI controller
60  * These are chained in either a free list or a active list
61  * We have one queue per target
62  */
63 
64 struct esiop_cmd {
65 	TAILQ_ENTRY (esiop_cmd) next;
66 	struct siop_common_cmd cmd_c;
67 	struct esiop_cbd *esiop_cbdp; /* pointer to our siop_cbd */
68 };
69 #define cmd_tables cmd_c.siop_tables
70 
71 /* command block descriptors: an array of siop_cmd + an array of siop_xfer */
72 struct esiop_cbd {
73 	TAILQ_ENTRY (esiop_cbd) next;
74 	struct esiop_cmd *cmds;
75 	struct esiop_xfer *xfers;
76 	bus_dmamap_t xferdma; /* DMA map for this block of xfers */
77 };
78 
79 TAILQ_HEAD(cmd_list, esiop_cmd);
80 TAILQ_HEAD(cbd_list, esiop_cbd);
81 
82 /* DSA table descriptor for tags. Free tables are in a list */
83 struct esiop_dsatbl {
84 	TAILQ_ENTRY (esiop_dsatbl) next;
85 	u_int32_t *tbl; /* the table itself */
86 	u_int32_t tbl_dsa; /* DSA of base of this table */
87 	bus_addr_t tbl_offset; /* offset of this table in the map */
88 	struct esiop_dsatblblk *tblblk; /* pointer back to our block */
89 };
90 
91 /* DSA table block descriptor. */
92 struct esiop_dsatblblk {
93 	TAILQ_ENTRY (esiop_dsatblblk) next;
94 	bus_dmamap_t blkmap; /* DMA map of this block */
95 };
96 
97 TAILQ_HEAD(tbl_list, esiop_dsatbl);
98 TAILQ_HEAD(tblblk_list, esiop_dsatblblk);
99 
100 /* Number of table per block */
101 #define ESIOP_NTPB ((PAGE_SIZE) / (sizeof(u_int32_t) * ESIOP_NTAG))
102 
103 /* per lun struct */
104 struct esiop_lun {
105 	struct esiop_cmd *active; /* active non-tagged command */
106 	struct esiop_cmd *tactive[ESIOP_NTAG]; /* active tagged commands */
107 	int lun_flags; /* per-lun flags */
108 	struct esiop_dsatbl *lun_tagtbl; /* the tag DSA table */
109 };
110 
111 /*
112  * per target struct; siop_common_cmd->target and siop_common_softc->targets[]
113  * will point to this
114  */
115 struct esiop_target {
116 	struct siop_common_target target_c;
117 	struct esiop_lun *esiop_lun[8]; /* per-lun state */
118 	u_int32_t lun_table_offset; /* pointer to our DSA table */
119 };
120 
121 static __inline__ void esiop_table_sync __P((struct esiop_cmd *, int));
122 static __inline__ void
123 esiop_table_sync(esiop_cmd, ops)
124 	struct esiop_cmd *esiop_cmd;
125 	int ops;
126 {
127 	struct siop_common_softc *sc  = esiop_cmd->cmd_c.siop_sc;
128 	bus_addr_t offset;
129 
130 	offset = esiop_cmd->cmd_c.dsa -
131 	    esiop_cmd->esiop_cbdp->xferdma->dm_segs[0].ds_addr;
132 	bus_dmamap_sync(sc->sc_dmat, esiop_cmd->esiop_cbdp->xferdma, offset,
133 	    sizeof(struct esiop_xfer), ops);
134 }
135 
136 
137 
138 /* Driver internal state */
139 struct esiop_softc {
140 	struct siop_common_softc sc_c;
141 	u_int32_t sc_semoffset;		/* semaphore */
142 	u_int32_t sc_shedoffset;	/* base of scheduler ring */
143 	int sc_currschedslot;		/* current scheduler slot */
144 	struct cbd_list cmds;		/* list of command block descriptors */
145 	struct cmd_list free_list;	/* cmd descr free list */
146 	struct tbl_list free_tagtbl;	/* list of free tag DSA tables */
147 	struct tblblk_list tag_tblblk;	/* tag DSA table blocks */
148 	u_int32_t sc_flags;
149 	u_int32_t sc_free_offset;	/* pointer to free RAM */
150 	u_int32_t sc_target_table_offset;/* pointer to target DSA table */
151 	int sc_currdoneslot;		/* current done slot */
152 	bus_dmamap_t sc_done_map;	/* dma map for done ring (shared) */
153 	bus_addr_t sc_done_offset; 	/* offset of ring in sc_done_map */
154 	u_int32_t *sc_done_slot;	/* The done ring itself */
155 };
156 
157 /* defs for sc_flags */
158 #define SCF_CHAN_NOSLOT	0x0001		/* channel out of scheduler slot */
159 #define SCF_CHAN_ADAPTREQ 0x0002	/* esiop_scsipi_request() is running */
160 
161 void    esiop_attach __P((struct esiop_softc *));
162 int	esiop_intr __P((void *));
163 void	esiop_add_dev __P((struct esiop_softc *, int, int));
164 void	esiop_del_dev __P((struct esiop_softc *, int, int));
165