FreeBSD/Linux Kernel Cross Reference
sys/dev/twa/twa.h
1 /*-
2 * Copyright (c) 2003-04 3ware, Inc.
3 * Copyright (c) 2000 Michael Smith
4 * Copyright (c) 2000 BSDi
5 * All rights reserved.
6 *
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
9 * are met:
10 * 1. Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 * 2. Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
15 *
16 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26 * SUCH DAMAGE.
27 *
28 * $FreeBSD: releng/5.3/sys/dev/twa/twa.h 130585 2004-06-16 09:47:26Z phk $
29 */
30
31 /*
32 * 3ware driver for 9000 series storage controllers.
33 *
34 * Author: Vinod Kashyap
35 */
36
37
38 /*
39 * The scheme for the driver version is:
40 * <major change>.<external release>.<3ware internal release>.<development release>
41 */
42 #define TWA_DRIVER_VERSION_STRING "2.50.00.000"
43
44 #define TWA_CDEV_MAJOR MAJOR_AUTO
45
46 #define TWA_REQUEST_TIMEOUT_PERIOD 60 /* seconds */
47 #define TWA_MESSAGE_SOURCE_CONTROLLER_ERROR 3
48 #define TWA_MESSAGE_SOURCE_CONTROLLER_EVENT 4
49 #define TWA_MESSAGE_SOURCE_FREEBSD_DRIVER 6
50 #define TWA_MESSAGE_SOURCE_FREEBSD_OS 9
51
52 #define TWA_MALLOC_CLASS M_TWA
53
54 /* Macros for bus-space calls. */
55 #define TWA_READ_REGISTER(sc, offset) \
56 (u_int32_t)bus_space_read_4(sc->twa_bus_tag, sc->twa_bus_handle, offset)
57 #define TWA_WRITE_REGISTER(sc, offset, val) \
58 bus_space_write_4(sc->twa_bus_tag, sc->twa_bus_handle, offset, (u_int32_t)val)
59
60 /* Possible values of tr->tr_status. */
61 #define TWA_CMD_SETUP 0x0 /* being assembled */
62 #define TWA_CMD_BUSY 0x1 /* submitted to controller */
63 #define TWA_CMD_PENDING 0x2 /* in pending queue */
64 #define TWA_CMD_COMPLETE 0x3 /* completed by controller (maybe with error) */
65
66 /* Possible values of tr->tr_flags. */
67 #define TWA_CMD_DATA_IN (1<<0) /* read request */
68 #define TWA_CMD_DATA_OUT (1<<1) /* write request */
69 #define TWA_CMD_DATA_COPY_NEEDED (1<<2) /* data in ccb is misaligned, have to copy to/from private buffer */
70 #define TWA_CMD_SLEEP_ON_REQUEST (1<<3) /* owner is sleeping on this command */
71 #define TWA_CMD_IN_PROGRESS (1<<4) /* bus_dmamap_load returned EINPROGRESS */
72
73 /* Possible values of tr->tr_cmd_pkt_type. */
74 #define TWA_CMD_PKT_TYPE_7K (1<<0)
75 #define TWA_CMD_PKT_TYPE_9K (1<<1)
76 #define TWA_CMD_PKT_TYPE_INTERNAL (1<<2)
77 #define TWA_CMD_PKT_TYPE_IOCTL (1<<3)
78 #define TWA_CMD_PKT_TYPE_EXTERNAL (1<<4)
79
80 /* Possible values of sc->twa_state. */
81 #define TWA_STATE_INTR_ENABLED (1<<0) /* interrupts have been enabled */
82 #define TWA_STATE_SHUTDOWN (1<<1) /* controller is shut down */
83 #define TWA_STATE_OPEN (1<<2) /* control device is open */
84 #define TWA_STATE_SUSPEND (1<<3) /* controller is suspended */
85 #define TWA_STATE_SIMQ_FROZEN (1<<4) /* simq frozen */
86
87 /* Possible values of sc->twa_ioctl_lock.lock. */
88 #define TWA_LOCK_FREE 0x0 /* lock is free */
89 #define TWA_LOCK_HELD 0x1 /* lock is held */
90
91
92 /* Error/AEN message structure. */
93 struct twa_message {
94 u_int32_t code;
95 char *message;
96 };
97
98 #ifdef TWA_DEBUG
99 struct twa_q_statistics {
100 u_int32_t q_length;
101 u_int32_t q_max;
102 };
103
104 #define TWAQ_FREE 0
105 #define TWAQ_BUSY 1
106 #define TWAQ_PENDING 2
107 #define TWAQ_COMPLETE 3
108 #define TWAQ_COUNT 4 /* total number of queues */
109 #endif /* TWA_DEBUG */
110
111 /* Driver's request packet. */
112 struct twa_request {
113 struct twa_command_packet *tr_command; /* ptr to cmd pkt submitted to controller */
114 u_int32_t tr_request_id; /* request id for tracking with firmware */
115
116 void *tr_data; /* ptr to data being passed to firmware */
117 size_t tr_length; /* length of buffer being passed to firmware */
118
119 void *tr_real_data; /* ptr to, and length of data passed */
120 size_t tr_real_length; /* to us from above, in case a buffer copy
121 was done due to non-compliance to
122 alignment requirements */
123
124 TAILQ_ENTRY(twa_request) tr_link; /* to link this request in a list */
125 struct twa_softc *tr_sc; /* controller that owns us */
126
127 u_int32_t tr_status; /* command status */
128 u_int32_t tr_flags; /* request flags */
129 u_int32_t tr_error; /* error encountered before request submission */
130 u_int32_t tr_cmd_pkt_type;/* type of request */
131 void *tr_private; /* request specific data to use during callback */
132 void (*tr_callback)(struct twa_request *tr);/* callback handler */
133 bus_addr_t tr_cmd_phys; /* physical address of command in controller space */
134 bus_dmamap_t tr_dma_map; /* DMA map for data */
135 } __attribute__ ((packed));
136
137
138 /* Per-controller structure. */
139 struct twa_softc {
140 /* Request queues and arrays. */
141 TAILQ_HEAD(, twa_request) twa_free; /* free request packets */
142 TAILQ_HEAD(, twa_request) twa_busy; /* requests busy in the controller */
143 TAILQ_HEAD(, twa_request) twa_pending; /* internal requests pending */
144 TAILQ_HEAD(, twa_request) twa_complete; /* requests completed by firmware (not by us) */
145
146 struct twa_request *twa_lookup[TWA_Q_LENGTH];/* requests indexed by request_id */
147
148 struct twa_request *twa_req_buf;
149 struct twa_command_packet *twa_cmd_pkt_buf;
150
151 /* AEN handler fields. */
152 struct twa_event_packet *twa_aen_queue[TWA_Q_LENGTH];/* circular queue of AENs from firmware */
153 uint16_t working_srl; /* driver & firmware negotiated srl */
154 uint16_t working_branch; /* branch # of the firmware that the driver is compatible with */
155 uint16_t working_build; /* build # of the firmware that the driver is compatible with */
156 u_int32_t twa_operating_mode; /* base mode/current mode */
157 u_int32_t twa_aen_head; /* AEN queue head */
158 u_int32_t twa_aen_tail; /* AEN queue tail */
159 u_int32_t twa_current_sequence_id;/* index of the last event + 1 */
160 u_int32_t twa_aen_queue_overflow; /* indicates if unretrieved events were overwritten */
161 u_int32_t twa_aen_queue_wrapped; /* indicates if AEN queue ever wrapped */
162 u_int32_t twa_wait_timeout; /* identifier for calling tsleep */
163
164 /* Controller state. */
165 u_int32_t twa_state;
166 #ifdef TWA_DEBUG
167 struct twa_q_statistics twa_qstats[TWAQ_COUNT]; /* queue statistics */
168 #endif /* TWA_DEBUG */
169 struct {
170 u_int32_t lock; /* lock state */
171 u_int32_t timeout;/* time at which the lock will become available,
172 even if not released */
173 } twa_ioctl_lock; /* lock for use by user applications, for synchronization
174 between ioctl calls */
175
176 device_t twa_bus_dev; /* bus device */
177 struct cdev *twa_ctrl_dev; /* control device */
178 struct resource *twa_io_res; /* register interface window */
179 bus_space_handle_t twa_bus_handle; /* bus space handle */
180 bus_space_tag_t twa_bus_tag; /* bus space tag */
181 bus_dma_tag_t twa_dma_tag; /* data buffer DMA tag */
182 bus_dmamap_t twa_cmd_map; /* DMA map for the array of cmd pkts */
183 bus_addr_t twa_cmd_pkt_phys;/* phys addr of first of array of cmd pkts */
184 struct resource *twa_irq_res; /* interrupt resource*/
185 void *twa_intr_handle;/* interrupt handle */
186 struct intr_config_hook twa_ich; /* delayed-startup hook */
187
188 struct sysctl_ctx_list twa_sysctl_ctx;
189 struct sysctl_oid *twa_sysctl_tree;
190
191 struct cam_sim *twa_sim; /* sim for this controller */
192 struct cam_path *twa_path; /* peripheral, path, tgt, lun
193 associated with this controller */
194 };
195
196
197 /*
198 * Queue primitives
199 */
200
201 #ifdef TWA_DEBUG
202
203 #define TWAQ_INIT(sc, qname) \
204 do { \
205 sc->twa_qstats[qname].q_length = 0; \
206 sc->twa_qstats[qname].q_max = 0; \
207 } while(0)
208
209 #define TWAQ_ADD(sc, qname) \
210 do { \
211 struct twa_q_statistics *qs = &(sc)->twa_qstats[qname]; \
212 \
213 qs->q_length++; \
214 if (qs->q_length > qs->q_max) \
215 qs->q_max = qs->q_length; \
216 } while(0)
217
218 #define TWAQ_REMOVE(sc, qname) (sc)->twa_qstats[qname].q_length--
219
220 #else /* TWA_DEBUG */
221
222 #define TWAQ_INIT(sc, qname)
223 #define TWAQ_ADD(sc, qname)
224 #define TWAQ_REMOVE(sc, qname)
225
226 #endif /* TWA_DEBUG */
227
228 #define TWAQ_REQUEST_QUEUE(name, index) \
229 static __inline void twa_initq_ ## name(struct twa_softc *sc) \
230 { \
231 TAILQ_INIT(&sc->twa_ ## name); \
232 TWAQ_INIT(sc, index); \
233 } \
234 static __inline void twa_enqueue_ ## name(struct twa_request *tr) \
235 { \
236 int s; \
237 \
238 s = splcam(); \
239 TAILQ_INSERT_TAIL(&tr->tr_sc->twa_ ## name, tr, tr_link); \
240 TWAQ_ADD(tr->tr_sc, index); \
241 splx(s); \
242 } \
243 static __inline void twa_requeue_ ## name(struct twa_request *tr) \
244 { \
245 int s; \
246 \
247 s = splcam(); \
248 TAILQ_INSERT_HEAD(&tr->tr_sc->twa_ ## name, tr, tr_link); \
249 TWAQ_ADD(tr->tr_sc, index); \
250 splx(s); \
251 } \
252 static __inline struct twa_request *twa_dequeue_ ## name(struct twa_softc *sc)\
253 { \
254 struct twa_request *tr; \
255 int s; \
256 \
257 s = splcam(); \
258 if ((tr = TAILQ_FIRST(&sc->twa_ ## name)) != NULL) { \
259 TAILQ_REMOVE(&sc->twa_ ## name, tr, tr_link); \
260 TWAQ_REMOVE(sc, index); \
261 } \
262 splx(s); \
263 return(tr); \
264 } \
265 static __inline void twa_remove_ ## name(struct twa_request *tr) \
266 { \
267 int s; \
268 \
269 s = splcam(); \
270 TAILQ_REMOVE(&tr->tr_sc->twa_ ## name, tr, tr_link); \
271 TWAQ_REMOVE(tr->tr_sc, index); \
272 splx(s); \
273 }
274
275 TWAQ_REQUEST_QUEUE(free, TWAQ_FREE)
276 TWAQ_REQUEST_QUEUE(busy, TWAQ_BUSY)
277 TWAQ_REQUEST_QUEUE(pending, TWAQ_PENDING)
278 TWAQ_REQUEST_QUEUE(complete, TWAQ_COMPLETE)
279
280
281 #ifdef TWA_DEBUG
282
283 extern u_int8_t twa_dbg_level;
284 extern u_int8_t twa_call_dbg_level;
285
286 /* Printf with the bus device in question. */
287 #define twa_dbg_dprint(dbg_level, sc, fmt, args...) \
288 do { \
289 if (dbg_level <= twa_dbg_level) \
290 device_printf(sc->twa_bus_dev, \
291 "%s: " fmt "\n", __func__ , ##args);\
292 } while(0)
293
294 #define twa_dbg_dprint_enter(dbg_level, sc) \
295 do { \
296 if (dbg_level <= twa_call_dbg_level) \
297 device_printf(sc->twa_bus_dev, \
298 "%s: entered.\n", __func__); \
299 } while(0)
300
301 #define twa_dbg_dprint_exit(dbg_level, sc) \
302 do { \
303 if (dbg_level <= twa_call_dbg_level) \
304 device_printf(sc->twa_bus_dev, \
305 "%s: exiting.\n", __func__); \
306 } while(0)
307
308 #define twa_dbg_print(dbg_level, fmt, args...) \
309 do { \
310 if (dbg_level <= twa_dbg_level) \
311 printf("%s: " fmt "\n", __func__ , ##args);\
312 } while(0)
313
314 #else
315 #define twa_dbg_dprint(dbg_level, sc, fmt, args...)
316 #define twa_dbg_dprint_enter(dbg_level, sc)
317 #define twa_dbg_dprint_exit(dbg_level, sc)
318 #define twa_dbg_print(dbg_level, fmt, args...)
319 #endif
320
321 #define twa_printf(sc, fmt, args...) \
322 device_printf(sc->twa_bus_dev, fmt, ##args)
Cache object: 5a1cd4170edaef1f3e4bb317c698239f
|