xref: /netbsd-src/sys/dev/ic/mlxvar.h (revision b1c86f5f087524e68db12794ee9c3e3da1ab17a0)
1 /*	$NetBSD: mlxvar.h,v 1.14 2008/04/28 20:23:50 martin Exp $	*/
2 
3 /*-
4  * Copyright (c) 2001 The NetBSD Foundation, Inc.
5  * All rights reserved.
6  *
7  * This code is derived from software contributed to The NetBSD Foundation
8  * by Andrew Doran.
9  *
10  * Redistribution and use in source and binary forms, with or without
11  * modification, are permitted provided that the following conditions
12  * are met:
13  * 1. Redistributions of source code must retain the above copyright
14  *    notice, this list of conditions and the following disclaimer.
15  * 2. Redistributions in binary form must reproduce the above copyright
16  *    notice, this list of conditions and the following disclaimer in the
17  *    documentation and/or other materials provided with the distribution.
18  *
19  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
20  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
21  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
22  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
23  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
29  * POSSIBILITY OF SUCH DAMAGE.
30  */
31 
32 /*-
33  * Copyright (c) 1999 Michael Smith
34  * All rights reserved.
35  *
36  * Redistribution and use in source and binary forms, with or without
37  * modification, are permitted provided that the following conditions
38  * are met:
39  * 1. Redistributions of source code must retain the above copyright
40  *    notice, this list of conditions and the following disclaimer.
41  * 2. Redistributions in binary form must reproduce the above copyright
42  *    notice, this list of conditions and the following disclaimer in the
43  *    documentation and/or other materials provided with the distribution.
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  * from FreeBSD: mlxvar.h,v 1.5.2.2 2000/04/24 19:40:50 msmith Exp
58  */
59 
60 #ifndef _IC_MLXVAR_H_
61 #define	_IC_MLXVAR_H_
62 
63 /* Older boards allow up to 17 segments and 64kB transfers. */
64 #define	MLX_MAX_SEGS		17
65 #define	MLX_MAX_XFER		65536
66 #define MLX_SGL_SIZE		(sizeof(struct mlx_sgentry) * MLX_MAX_SEGS)
67 
68 /* This shouldn't be ajusted lightly... */
69 #define MLX_MAX_DRIVES		32
70 
71 /* Maximum queue depth, matching the older controllers. */
72 #define	MLX_MAX_QUEUECNT	63
73 
74 /* Number of CCBs to reserve for control operations. */
75 #define	MLX_NCCBS_CONTROL	7
76 
77 /* Structure describing a system drive as attached to the controller. */
78 struct mlx_sysdrive {
79 	u_int32_t	ms_size;
80 	u_short		ms_state;
81 	u_short		ms_raidlevel;
82 	struct device	*ms_dv;
83 };
84 
85 /* Optional per-CCB context. */
86 struct mlx_ccb;
87 struct mlx_context {
88 	void	(*mx_handler)(struct mlx_ccb *);
89 	void 	*mx_context;
90 	struct	device	*mx_dv;
91 };
92 
93 /* Command control block. */
94 struct mlx_ccb {
95 	union {
96 		SIMPLEQ_ENTRY(mlx_ccb) simpleq;
97 		SLIST_ENTRY(mlx_ccb) slist;
98 		TAILQ_ENTRY(mlx_ccb) tailq;
99 	} mc_chain;
100 	u_int		mc_flags;
101 	u_int		mc_status;
102 	u_int		mc_ident;
103 	time_t		mc_expiry;
104 	u_int		mc_nsgent;
105 	u_int		mc_xfer_size;
106 	bus_addr_t	mc_xfer_phys;
107 	bus_dmamap_t	mc_xfer_map;
108 	struct mlx_context mc_mx;
109 	u_int8_t	mc_mbox[16];
110 };
111 #define	MC_XFER_IN	MU_XFER_IN	/* Map describes inbound xfer */
112 #define	MC_XFER_OUT	MU_XFER_OUT	/* Map describes outbound xfer */
113 #define	MC_WAITING	0x0400		/* We have waiters */
114 #define	MC_CONTROL	0x0800		/* Control operation */
115 
116 /*
117  * Per-controller state.
118  */
119 struct mlx_softc {
120 	struct device		mlx_dv;
121 	bus_space_tag_t		mlx_iot;
122 	bus_space_handle_t	mlx_ioh;
123 	bus_dma_tag_t		mlx_dmat;
124 	bus_dmamap_t		mlx_dmamap;
125 	void			*mlx_ih;
126 
127 	SLIST_HEAD(, mlx_ccb)	mlx_ccb_freelist;
128 	TAILQ_HEAD(, mlx_ccb)	mlx_ccb_worklist;
129 	SIMPLEQ_HEAD(, mlx_ccb)	mlx_ccb_queue;
130 	struct mlx_ccb		*mlx_ccbs;
131 	int			mlx_nccbs;
132 	int			mlx_nccbs_ctrl;
133 
134 	void *			mlx_sgls;
135 	bus_addr_t		mlx_sgls_paddr;
136 
137 	int	(*mlx_submit)(struct mlx_softc *, struct mlx_ccb *);
138 	int	(*mlx_findcomplete)(struct mlx_softc *, u_int *, u_int *);
139 	void	(*mlx_intaction)(struct mlx_softc *, int);
140 	int	(*mlx_fw_handshake)(struct mlx_softc *, int *, int *, int *);
141 	int	(*mlx_reset)(struct mlx_softc *);
142 
143 	int			mlx_max_queuecnt;
144 	struct mlx_cinfo	mlx_ci;
145 
146 	time_t			mlx_lastpoll;
147 	u_int			mlx_lastevent;
148 	u_int			mlx_currevent;
149 	u_int			mlx_bg;
150 	struct mlx_rebuild_status mlx_rebuildstat;
151 	struct mlx_pause	mlx_pause;
152 	int			mlx_flags;
153 
154 	struct mlx_sysdrive	mlx_sysdrive[MLX_MAX_DRIVES];
155 	int			mlx_numsysdrives;
156 };
157 
158 #define MLX_BG_CHECK		1	/* we started a check */
159 #define MLX_BG_REBUILD		2	/* we started a rebuild */
160 #define MLX_BG_SPONTANEOUS	3	/* it just happened somehow */
161 
162 #define MLXF_SPINUP_REPORTED	0x0001	/* "spinning up drives" displayed */
163 #define MLXF_EVENTLOG_BUSY	0x0002	/* currently reading event log */
164 #define MLXF_FW_INITTED		0x0004	/* firmware init crap done */
165 #define MLXF_PAUSEWORKS		0x0008	/* channel pause works as expected */
166 #define MLXF_OPEN		0x0010	/* control device is open */
167 #define	MLXF_INITOK		0x0020	/* controller initialised OK */
168 #define	MLXF_PERIODIC_CTLR	0x0040	/* periodic check running */
169 #define	MLXF_PERIODIC_DRIVE	0x0080	/* periodic check running */
170 #define	MLXF_PERIODIC_REBUILD	0x0100	/* periodic check running */
171 #define	MLXF_RESCANNING		0x0400	/* rescanning drive table */
172 
173 struct mlx_attach_args {
174 	int		mlxa_unit;
175 };
176 
177 int	mlx_flush(struct mlx_softc *, int);
178 void	mlx_init(struct mlx_softc *, const char *);
179 int	mlx_intr(void *);
180 
181 int	mlx_ccb_alloc(struct mlx_softc *, struct mlx_ccb **, int);
182 const char *mlx_ccb_diagnose(struct mlx_ccb *);
183 void	mlx_ccb_enqueue(struct mlx_softc *, struct mlx_ccb *);
184 void	mlx_ccb_free(struct mlx_softc *, struct mlx_ccb *);
185 int	mlx_ccb_map(struct mlx_softc *, struct mlx_ccb *, void *, int, int);
186 int	mlx_ccb_poll(struct mlx_softc *, struct mlx_ccb *, int);
187 void	mlx_ccb_unmap(struct mlx_softc *, struct mlx_ccb *);
188 int	mlx_ccb_wait(struct mlx_softc *, struct mlx_ccb *);
189 
190 static __inline void	mlx_make_type1(struct mlx_ccb *, u_int8_t, u_int16_t,
191 				       u_int32_t, u_int8_t, u_int32_t,
192 				       u_int8_t);
193 static __inline void	mlx_make_type2(struct mlx_ccb *, u_int8_t, u_int8_t,
194 				       u_int8_t, u_int8_t, u_int8_t,
195 				       u_int8_t, u_int8_t, u_int32_t,
196 				       u_int8_t);
197 static __inline void	mlx_make_type3(struct mlx_ccb *, u_int8_t, u_int8_t,
198 				       u_int8_t, u_int16_t, u_int8_t,
199 				       u_int8_t, u_int32_t, u_int8_t);
200 static __inline void	mlx_make_type4(struct mlx_ccb *, u_int8_t, u_int16_t,
201 				       u_int32_t, u_int32_t, u_int8_t);
202 static __inline void	mlx_make_type5(struct mlx_ccb *, u_int8_t,  u_int8_t,
203 				       u_int8_t, u_int32_t, u_int32_t,
204 				       u_int8_t);
205 
206 static __inline u_int8_t	mlx_inb(struct mlx_softc *, int);
207 static __inline u_int16_t	mlx_inw(struct mlx_softc *, int);
208 static __inline u_int32_t	mlx_inl(struct mlx_softc *, int);
209 static __inline void		mlx_outb(struct mlx_softc *, int, u_int8_t);
210 static __inline void		mlx_outw(struct mlx_softc *, int, u_int16_t);
211 static __inline void		mlx_outl(struct mlx_softc *, int, u_int32_t);
212 
213 static __inline void
214 mlx_make_type1(struct mlx_ccb *mc, u_int8_t code, u_int16_t f1, u_int32_t f2,
215 	       u_int8_t f3, u_int32_t f4, u_int8_t f5)
216 {
217 
218 	mc->mc_mbox[0x0] = code;
219 	mc->mc_mbox[0x2] = f1;
220 	mc->mc_mbox[0x3] = ((f2 >> 18) & 0xc0) | ((f1 >> 8) & 0x3f);
221 	mc->mc_mbox[0x4] = f2;
222 	mc->mc_mbox[0x5] = (f2 >> 8);
223 	mc->mc_mbox[0x6] = (f2 >> 16);
224 	mc->mc_mbox[0x7] = f3;
225 	mc->mc_mbox[0x8] = f4;
226 	mc->mc_mbox[0x9] = (f4 >> 8);
227 	mc->mc_mbox[0xa] = (f4 >> 16);
228 	mc->mc_mbox[0xb] = (f4 >> 24);
229 	mc->mc_mbox[0xc] = f5;
230 }
231 
232 static __inline void
233 mlx_make_type2(struct mlx_ccb *mc, u_int8_t code, u_int8_t f1, u_int8_t f2,
234 	       u_int8_t f3, u_int8_t f4, u_int8_t f5, u_int8_t f6,
235 	       u_int32_t f7, u_int8_t f8)
236 {
237 
238 	mc->mc_mbox[0x0] = code;
239 	mc->mc_mbox[0x2] = f1;
240 	mc->mc_mbox[0x3] = f2;
241 	mc->mc_mbox[0x4] = f3;
242 	mc->mc_mbox[0x5] = f4;
243 	mc->mc_mbox[0x6] = f5;
244 	mc->mc_mbox[0x7] = f6;
245 	mc->mc_mbox[0x8] = f7;
246 	mc->mc_mbox[0x9] = (f7 >> 8);
247 	mc->mc_mbox[0xa] = (f7 >> 16);
248 	mc->mc_mbox[0xb] = (f7 >> 24);
249 	mc->mc_mbox[0xc] = f8;
250 }
251 
252 static __inline void
253 mlx_make_type3(struct mlx_ccb *mc, u_int8_t code, u_int8_t f1, u_int8_t f2,
254 	       u_int16_t f3, u_int8_t f4, u_int8_t f5, u_int32_t f6,
255 	       u_int8_t f7)
256 {
257 
258 	mc->mc_mbox[0x0] = code;
259 	mc->mc_mbox[0x2] = f1;
260 	mc->mc_mbox[0x3] = f2;
261 	mc->mc_mbox[0x4] = f3;
262 	mc->mc_mbox[0x5] = (f3 >> 8);
263 	mc->mc_mbox[0x6] = f4;
264 	mc->mc_mbox[0x7] = f5;
265 	mc->mc_mbox[0x8] = f6;
266 	mc->mc_mbox[0x9] = (f6 >> 8);
267 	mc->mc_mbox[0xa] = (f6 >> 16);
268 	mc->mc_mbox[0xb] = (f6 >> 24);
269 	mc->mc_mbox[0xc] = f7;
270 }
271 
272 static __inline void
273 mlx_make_type4(struct mlx_ccb *mc, u_int8_t code,  u_int16_t f1, u_int32_t f2,
274 	       u_int32_t f3, u_int8_t f4)
275 {
276 
277 	mc->mc_mbox[0x0] = code;
278 	mc->mc_mbox[0x2] = f1;
279 	mc->mc_mbox[0x3] = (f1 >> 8);
280 	mc->mc_mbox[0x4] = f2;
281 	mc->mc_mbox[0x5] = (f2 >> 8);
282 	mc->mc_mbox[0x6] = (f2 >> 16);
283 	mc->mc_mbox[0x7] = (f2 >> 24);
284 	mc->mc_mbox[0x8] = f3;
285 	mc->mc_mbox[0x9] = (f3 >> 8);
286 	mc->mc_mbox[0xa] = (f3 >> 16);
287 	mc->mc_mbox[0xb] = (f3 >> 24);
288 	mc->mc_mbox[0xc] = f4;
289 }
290 
291 static __inline void
292 mlx_make_type5(struct mlx_ccb *mc, u_int8_t code, u_int8_t f1, u_int8_t f2,
293 	       u_int32_t f3, u_int32_t f4, u_int8_t f5)
294 {
295 
296 	mc->mc_mbox[0x0] = code;
297 	mc->mc_mbox[0x2] = f1;
298 	mc->mc_mbox[0x3] = f2;
299 	mc->mc_mbox[0x4] = f3;
300 	mc->mc_mbox[0x5] = (f3 >> 8);
301 	mc->mc_mbox[0x6] = (f3 >> 16);
302 	mc->mc_mbox[0x7] = (f3 >> 24);
303 	mc->mc_mbox[0x8] = f4;
304 	mc->mc_mbox[0x9] = (f4 >> 8);
305 	mc->mc_mbox[0xa] = (f4 >> 16);
306 	mc->mc_mbox[0xb] = (f4 >> 24);
307 	mc->mc_mbox[0xc] = f5;
308 }
309 
310 static __inline u_int8_t
311 mlx_inb(struct mlx_softc *mlx, int off)
312 {
313 
314 	bus_space_barrier(mlx->mlx_iot, mlx->mlx_ioh, off, 1,
315 	    BUS_SPACE_BARRIER_WRITE | BUS_SPACE_BARRIER_READ);
316 	return (bus_space_read_1(mlx->mlx_iot, mlx->mlx_ioh, off));
317 }
318 
319 static __inline u_int16_t
320 mlx_inw(struct mlx_softc *mlx, int off)
321 {
322 
323 	bus_space_barrier(mlx->mlx_iot, mlx->mlx_ioh, off, 2,
324 	    BUS_SPACE_BARRIER_WRITE | BUS_SPACE_BARRIER_READ);
325 	return (bus_space_read_2(mlx->mlx_iot, mlx->mlx_ioh, off));
326 }
327 
328 static __inline u_int32_t
329 mlx_inl(struct mlx_softc *mlx, int off)
330 {
331 
332 	bus_space_barrier(mlx->mlx_iot, mlx->mlx_ioh, off, 4,
333 	    BUS_SPACE_BARRIER_WRITE | BUS_SPACE_BARRIER_READ);
334 	return (bus_space_read_4(mlx->mlx_iot, mlx->mlx_ioh, off));
335 }
336 
337 static __inline void
338 mlx_outb(struct mlx_softc *mlx, int off, u_int8_t val)
339 {
340 
341 	bus_space_write_1(mlx->mlx_iot, mlx->mlx_ioh, off, val);
342 	bus_space_barrier(mlx->mlx_iot, mlx->mlx_ioh, off, 1,
343 	    BUS_SPACE_BARRIER_WRITE);
344 }
345 
346 static __inline void
347 mlx_outw(struct mlx_softc *mlx, int off, u_int16_t val)
348 {
349 
350 	bus_space_write_2(mlx->mlx_iot, mlx->mlx_ioh, off, val);
351 	bus_space_barrier(mlx->mlx_iot, mlx->mlx_ioh, off, 2,
352 	    BUS_SPACE_BARRIER_WRITE);
353 }
354 
355 static __inline void
356 mlx_outl(struct mlx_softc *mlx, int off, u_int32_t val)
357 {
358 
359 	bus_space_write_4(mlx->mlx_iot, mlx->mlx_ioh, off, val);
360 	bus_space_barrier(mlx->mlx_iot, mlx->mlx_ioh, off, 4,
361 	    BUS_SPACE_BARRIER_WRITE);
362 }
363 
364 #endif	/* !_IC_MLXVAR_H_ */
365