arcmsrvar.h revision 1.5.4.3 1 /* $NetBSD: arcmsrvar.h,v 1.5.4.3 2007/12/27 00:45:14 mjf Exp $ */
2 /* Derived from $OpenBSD: arc.c,v 1.68 2007/10/27 03:28:27 dlg Exp $ */
3
4 /*
5 * Copyright (c) 2006 David Gwynne <dlg (at) openbsd.org>
6 *
7 * Permission to use, copy, modify, and distribute this software for any
8 * purpose with or without fee is hereby granted, provided that the above
9 * copyright notice and this permission notice appear in all copies.
10 *
11 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
12 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
13 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
14 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
15 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
16 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
17 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
18 */
19
20 #ifndef _PCI_ARCMSRVAR_H_
21 #define _PCI_ARCMSRVAR_H_
22
23 #define ARC_PCI_BAR PCI_MAPREG_START
24
25 #define ARC_REG_INB_MSG0 0x0010
26 #define ARC_REG_INB_MSG0_NOP (0x00000000)
27 #define ARC_REG_INB_MSG0_GET_CONFIG (0x00000001)
28 #define ARC_REG_INB_MSG0_SET_CONFIG (0x00000002)
29 #define ARC_REG_INB_MSG0_ABORT_CMD (0x00000003)
30 #define ARC_REG_INB_MSG0_STOP_BGRB (0x00000004)
31 #define ARC_REG_INB_MSG0_FLUSH_CACHE (0x00000005)
32 #define ARC_REG_INB_MSG0_START_BGRB (0x00000006)
33 #define ARC_REG_INB_MSG0_CHK331PENDING (0x00000007)
34 #define ARC_REG_INB_MSG0_SYNC_TIMER (0x00000008)
35 #define ARC_REG_INB_MSG1 0x0014
36 #define ARC_REG_OUTB_ADDR0 0x0018
37 #define ARC_REG_OUTB_ADDR1 0x001c
38 #define ARC_REG_OUTB_ADDR1_FIRMWARE_OK (1<<31)
39 #define ARC_REG_INB_DOORBELL 0x0020
40 #define ARC_REG_INB_DOORBELL_WRITE_OK (1<<0)
41 #define ARC_REG_INB_DOORBELL_READ_OK (1<<1)
42 #define ARC_REG_OUTB_DOORBELL 0x002c
43 #define ARC_REG_OUTB_DOORBELL_WRITE_OK (1<<0)
44 #define ARC_REG_OUTB_DOORBELL_READ_OK (1<<1)
45 #define ARC_REG_INTRSTAT 0x0030
46 #define ARC_REG_INTRSTAT_MSG0 (1<<0)
47 #define ARC_REG_INTRSTAT_MSG1 (1<<1)
48 #define ARC_REG_INTRSTAT_DOORBELL (1<<2)
49 #define ARC_REG_INTRSTAT_POSTQUEUE (1<<3)
50 #define ARC_REG_INTRSTAT_PCI (1<<4)
51 #define ARC_REG_INTRMASK 0x0034
52 #define ARC_REG_INTRMASK_MSG0 (1<<0)
53 #define ARC_REG_INTRMASK_MSG1 (1<<1)
54 #define ARC_REG_INTRMASK_DOORBELL (1<<2)
55 #define ARC_REG_INTRMASK_POSTQUEUE (1<<3)
56 #define ARC_REG_INTRMASK_PCI (1<<4)
57 #define ARC_REG_POST_QUEUE 0x0040
58 #define ARC_REG_POST_QUEUE_ADDR_SHIFT 5
59 #define ARC_REG_POST_QUEUE_IAMBIOS (1<<30)
60 #define ARC_REG_POST_QUEUE_BIGFRAME (1<<31)
61 #define ARC_REG_REPLY_QUEUE 0x0044
62 #define ARC_REG_REPLY_QUEUE_ADDR_SHIFT 5
63 #define ARC_REG_REPLY_QUEUE_ERR (1<<28)
64 #define ARC_REG_REPLY_QUEUE_IAMBIOS (1<<30)
65 #define ARC_REG_MSGBUF 0x0a00
66 #define ARC_REG_MSGBUF_LEN 1024
67 #define ARC_REG_IOC_WBUF_LEN 0x0e00
68 #define ARC_REG_IOC_WBUF 0x0e04
69 #define ARC_REG_IOC_RBUF_LEN 0x0f00
70 #define ARC_REG_IOC_RBUF 0x0f04
71 #define ARC_REG_IOC_RWBUF_MAXLEN 124 /* for both RBUF and WBUF */
72
73 struct arc_msg_firmware_info {
74 uint32_t signature;
75 #define ARC_FWINFO_SIGNATURE_GET_CONFIG (0x87974060)
76 uint32_t request_len;
77 uint32_t queue_len;
78 uint32_t sdram_size;
79 uint32_t sata_ports;
80 uint8_t vendor[40];
81 uint8_t model[8];
82 uint8_t fw_version[16];
83 uint8_t device_map[16];
84 } __packed;
85
86 struct arc_msg_scsicmd {
87 uint8_t bus;
88 uint8_t target;
89 uint8_t lun;
90 uint8_t function;
91
92 uint8_t cdb_len;
93 uint8_t sgl_len;
94 uint8_t flags;
95 #define ARC_MSG_SCSICMD_FLAG_SGL_BSIZE_512 (1<<0)
96 #define ARC_MSG_SCSICMD_FLAG_FROM_BIOS (1<<1)
97 #define ARC_MSG_SCSICMD_FLAG_WRITE (1<<2)
98 #define ARC_MSG_SCSICMD_FLAG_SIMPLEQ (0x00)
99 #define ARC_MSG_SCSICMD_FLAG_HEADQ (0x08)
100 #define ARC_MSG_SCSICMD_FLAG_ORDERQ (0x10)
101 uint8_t reserved;
102
103 uint32_t context;
104 uint32_t data_len;
105
106 #define ARC_MSG_CDBLEN 16
107 uint8_t cdb[ARC_MSG_CDBLEN];
108
109 uint8_t status;
110 #define ARC_MSG_STATUS_SELTIMEOUT 0xf0
111 #define ARC_MSG_STATUS_ABORTED 0xf1
112 #define ARC_MSG_STATUS_INIT_FAIL 0xf2
113 #define ARC_MSG_SENSELEN 15
114 uint8_t sense_data[ARC_MSG_SENSELEN];
115
116 /* followed by an sgl */
117 } __packed;
118
119 struct arc_sge {
120 uint32_t sg_hdr;
121 #define ARC_SGE_64BIT (1<<24)
122 uint32_t sg_lo_addr;
123 uint32_t sg_hi_addr;
124 } __packed;
125
126 #define ARC_MAX_TARGET 16
127 #define ARC_MAX_LUN 8
128 #define ARC_MAX_IOCMDLEN 512
129 #define ARC_BLOCKSIZE 512
130
131 /*
132 * the firmware deals with up to 256 or 512 byte command frames.
133 */
134
135 /*
136 * sizeof(struct arc_msg_scsicmd) + (sizeof(struct arc_sge) * 38) == 508.
137 */
138 #define ARC_SGL_MAXLEN 38
139 /*
140 * sizeof(struct arc_msg_scsicmd) + (sizeof(struct arc_sge) * 17) == 252.
141 */
142 #define ARC_SGL_256LEN 17
143
144 struct arc_io_cmd {
145 struct arc_msg_scsicmd cmd;
146 struct arc_sge sgl[ARC_SGL_MAXLEN];
147 } __packed;
148
149 /*
150 * definitions of the firmware commands sent via the doorbells.
151 */
152 struct arc_fw_hdr {
153 uint8_t byte1;
154 uint8_t byte2;
155 uint8_t byte3;
156 } __packed;
157
158 struct arc_fw_bufhdr {
159 struct arc_fw_hdr hdr;
160 uint16_t len;
161 } __packed;
162
163 /* Firmware command codes */
164 #define ARC_FW_CHECK_PASS 0x14 /* opcode + 1 byte length + password */
165 #define ARC_FW_GETEVENTS 0x1a /* opcode + 1 byte for page 0/1/2/3 */
166 #define ARC_FW_RAIDINFO 0x20 /* opcode + raid# */
167 #define ARC_FW_VOLINFO 0x21 /* opcode + vol# */
168 #define ARC_FW_DISKINFO 0x22 /* opcode + physdisk# */
169 #define ARC_FW_SYSINFO 0x23 /* opcode. reply is fw_sysinfo */
170 #define ARC_FW_CLEAREVENTS 0x24 /* opcode only */
171 #define ARC_FW_MUTE_ALARM 0x30 /* opcode only */
172 #define ARC_FW_SET_ALARM 0x31 /* opcode + 1 byte for setting */
173 #define ARC_FW_SET_ALARM_DISABLE 0x00
174 #define ARC_FW_SET_ALARM_ENABLE 0x01
175 #define ARC_FW_SET_PASS 0x32 /* opcode + 1 byte length + password */
176 #define ARC_FW_REBUILD_PRIO 0x34 /* Rebuild priority for disks */
177 #define ARC_FW_REBUILD_PRIO_ULTRALOW (1<<0)
178 #define ARC_FW_REBUILD_PRIO_LOW (1<<1)
179 #define ARC_FW_REBUILD_PRIO_NORMAL (1<<2)
180 #define ARC_FW_REBUILD_PRIO_HIGH (1<<3)
181 #define ARC_FW_SET_MAXATA_MODE 0x35 /* opcode + 1 byte mode */
182 #define ARC_FW_SET_MAXATA_MODE_133 (1<<0)
183 #define ARC_FW_SET_MAXATA_MODE_100 (1<<1)
184 #define ARC_FW_SET_MAXATA_MODE_66 (1<<2)
185 #define ARC_FW_SET_MAXATA_MODE_33 (1<<3)
186 #define ARC_FW_NOP 0x38 /* opcode only */
187
188 /* Status codes for the firmware command codes */
189 #define ARC_FW_CMD_OK 0x41
190 #define ARC_FW_CMD_RAIDINVAL 0x42
191 #define ARC_FW_CMD_VOLINVAL 0x43
192 #define ARC_FW_CMD_NORAID 0x44
193 #define ARC_FW_CMD_NOVOLUME 0x45
194 #define ARC_FW_CMD_NOPHYSDRV 0x46
195 #define ARC_FW_CMD_PARAM_ERR 0x47
196 #define ARC_FW_CMD_UNSUPPORTED 0x48
197 #define ARC_FW_CMD_DISKCFG_CHGD 0x49
198 #define ARC_FW_CMD_PASS_INVAL 0x4a
199 #define ARC_FW_CMD_NODISKSPACE 0x4b
200 #define ARC_FW_CMD_PASS_REQD 0x4d
201 #define ARC_FW_CMD_CHECKSUM_ERR 0x4c
202
203 struct arc_fw_comminfo {
204 uint8_t baud_rate;
205 uint8_t data_bits;
206 uint8_t stop_bits;
207 uint8_t parity;
208 uint8_t flow_control;
209 } __packed;
210
211 struct arc_fw_scsiattr {
212 uint8_t channel; /* channel for SCSI target (0/1) */
213 uint8_t target;
214 uint8_t lun;
215 uint8_t tagged;
216 uint8_t cache;
217 uint8_t speed;
218 } __packed;
219
220 struct arc_fw_raidinfo {
221 uint8_t set_name[16];
222 uint32_t capacity;
223 uint32_t capacity2;
224 uint32_t fail_mask;
225 uint8_t device_array[32];
226 uint8_t member_devices;
227 uint8_t new_member_devices;
228 uint8_t raid_state;
229 uint8_t volumes;
230 uint8_t volume_list[16];
231 uint8_t reserved1[3];
232 uint8_t free_segments;
233 uint32_t raw_stripes[8];
234 uint8_t reserved2[12];
235 } __packed;
236
237 struct arc_fw_volinfo {
238 uint8_t set_name[16];
239 uint32_t capacity;
240 uint32_t capacity2;
241 uint32_t fail_mask;
242 uint32_t stripe_size; /* in blocks */
243 uint32_t new_fail_mask;
244 uint32_t new_stripe_size;
245 uint32_t volume_status;
246 #define ARC_FW_VOL_STATUS_NORMAL 0x00
247 #define ARC_FW_VOL_STATUS_INITTING (1<<0)
248 #define ARC_FW_VOL_STATUS_FAILED (1<<1)
249 #define ARC_FW_VOL_STATUS_MIGRATING (1<<2)
250 #define ARC_FW_VOL_STATUS_REBUILDING (1<<3)
251 #define ARC_FW_VOL_STATUS_NEED_INIT (1<<4)
252 #define ARC_FW_VOL_STATUS_NEED_MIGRATE (1<<5)
253 #define ARC_FW_VOL_STATUS_INIT_FLAG (1<<6)
254 #define ARC_FW_VOL_STATUS_NEED_REGEN (1<<7)
255 #define ARC_FW_VOL_STATUS_CHECKING (1<<8)
256 #define ARC_FW_VOL_STATUS_NEED_CHECK (1<<9)
257 uint32_t progress;
258 struct arc_fw_scsiattr scsi_attr;
259 uint8_t member_disks;
260 uint8_t raid_level;
261 #define ARC_FW_VOL_RAIDLEVEL_0 0x00
262 #define ARC_FW_VOL_RAIDLEVEL_1 0x01
263 #define ARC_FW_VOL_RAIDLEVEL_3 0x02
264 #define ARC_FW_VOL_RAIDLEVEL_5 0x03
265 #define ARC_FW_VOL_RAIDLEVEL_6 0x04
266 #define ARC_FW_VOL_RAIDLEVEL_PASSTHRU 0x05
267 uint8_t new_member_disks;
268 uint8_t new_raid_level;
269 uint8_t raid_set_number;
270 uint8_t reserved[5];
271 } __packed;
272
273 struct arc_fw_diskinfo {
274 uint8_t model[40];
275 uint8_t serial[20];
276 uint8_t firmware_rev[8];
277 uint32_t capacity;
278 uint32_t capacity2;
279 uint8_t device_state;
280 uint8_t pio_mode;
281 uint8_t current_udma_mode;
282 uint8_t udma_mode;
283 uint8_t drive_select;
284 uint8_t raid_number; /* 0xff unowned */
285 struct arc_fw_scsiattr scsi_attr;
286 uint8_t reserved[40];
287 } __packed;
288
289 struct arc_fw_sysinfo {
290 uint8_t vendor_name[40];
291 uint8_t serial_number[16];
292 uint8_t firmware_version[16];
293 uint8_t boot_version[16];
294 uint8_t mb_version[16];
295 uint8_t model_name[8];
296
297 uint8_t local_ip[4];
298 uint8_t current_ip[4];
299
300 uint32_t time_tick;
301 uint32_t cpu_speed;
302 uint32_t icache;
303 uint32_t dcache;
304 uint32_t scache;
305 uint32_t memory_size;
306 uint32_t memory_speed;
307 uint32_t events;
308
309 uint8_t gsiMacAddress[6];
310 uint8_t gsiDhcp;
311
312 uint8_t alarm;
313 uint8_t channel_usage;
314 uint8_t max_ata_mode;
315 uint8_t sdram_ecc;
316 uint8_t rebuild_priority;
317 struct arc_fw_comminfo comm_a;
318 struct arc_fw_comminfo comm_b;
319 uint8_t ide_channels;
320 uint8_t scsi_host_channels;
321 uint8_t ide_host_channels;
322 uint8_t max_volume_set;
323 uint8_t max_raid_set;
324 uint8_t ether_port;
325 uint8_t raid6_engine;
326 uint8_t reserved[75];
327 } __packed;
328
329 /*
330 * autconf(9) glue.
331 */
332 struct arc_ccb;
333 TAILQ_HEAD(arc_ccb_list, arc_ccb);
334
335 struct arc_softc {
336 struct device sc_dev;
337 struct scsipi_channel sc_chan;
338 struct scsipi_adapter sc_adapter;
339
340 pci_chipset_tag_t sc_pc;
341 pcitag_t sc_tag;
342
343 bus_space_tag_t sc_iot;
344 bus_space_handle_t sc_ioh;
345 bus_size_t sc_ios;
346 bus_dma_tag_t sc_dmat;
347
348 void *sc_ih;
349
350 void *sc_shutdownhook;
351
352 int sc_req_count;
353
354 struct arc_dmamem *sc_requests;
355 struct arc_ccb *sc_ccbs;
356 struct arc_ccb_list sc_ccb_free;
357
358 struct lwp *sc_lwp;
359 volatile int sc_talking;
360 kmutex_t sc_mutex;
361 kcondvar_t sc_condvar;
362 krwlock_t sc_rwlock;
363
364 struct sysmon_envsys *sc_sme;
365 envsys_data_t *sc_sensors;
366 int sc_nsensors;
367 };
368
369 /*
370 * interface for scsi midlayer to talk to.
371 */
372 void arc_scsi_cmd(struct scsipi_channel *, scsipi_adapter_req_t, void *);
373
374 /*
375 * code to deal with getting bits in and out of the bus space.
376 */
377 uint32_t arc_read(struct arc_softc *, bus_size_t);
378 void arc_read_region(struct arc_softc *, bus_size_t, void *, size_t);
379 void arc_write(struct arc_softc *, bus_size_t, uint32_t);
380 void arc_write_region(struct arc_softc *, bus_size_t, void *, size_t);
381 int arc_wait_eq(struct arc_softc *, bus_size_t, uint32_t, uint32_t);
382 int arc_wait_ne(struct arc_softc *, bus_size_t, uint32_t, uint32_t);
383 int arc_msg0(struct arc_softc *, uint32_t);
384
385 #define arc_push(_s, _r) arc_write((_s), ARC_REG_POST_QUEUE, (_r))
386 #define arc_pop(_s) arc_read((_s), ARC_REG_REPLY_QUEUE)
387
388 /*
389 * wrap up the bus_dma api.
390 */
391 struct arc_dmamem {
392 bus_dmamap_t adm_map;
393 bus_dma_segment_t adm_seg;
394 size_t adm_size;
395 void *adm_kva;
396 };
397 #define ARC_DMA_MAP(_adm) ((_adm)->adm_map)
398 #define ARC_DMA_DVA(_adm) ((_adm)->adm_map->dm_segs[0].ds_addr)
399 #define ARC_DMA_KVA(_adm) ((void *)(_adm)->adm_kva)
400
401 struct arc_dmamem *arc_dmamem_alloc(struct arc_softc *, size_t);
402 void arc_dmamem_free(struct arc_softc *, struct arc_dmamem *);
403
404 /*
405 * stuff to manage a scsi command.
406 */
407 struct arc_ccb {
408 struct arc_softc *ccb_sc;
409 int ccb_id;
410
411 struct scsipi_xfer *ccb_xs;
412
413 bus_dmamap_t ccb_dmamap;
414 bus_addr_t ccb_offset;
415 struct arc_io_cmd *ccb_cmd;
416 uint32_t ccb_cmd_post;
417
418 TAILQ_ENTRY(arc_ccb) ccb_link;
419 };
420
421 int arc_alloc_ccbs(struct arc_softc *);
422 struct arc_ccb *arc_get_ccb(struct arc_softc *);
423 void arc_put_ccb(struct arc_softc *, struct arc_ccb *);
424 int arc_load_xs(struct arc_ccb *);
425 int arc_complete(struct arc_softc *, struct arc_ccb *, int);
426 void arc_scsi_cmd_done(struct arc_softc *, struct arc_ccb *, uint32_t);
427
428 /*
429 * real stuff for dealing with the hardware.
430 */
431 int arc_map_pci_resources(struct arc_softc *, struct pci_attach_args *);
432 void arc_unmap_pci_resources(struct arc_softc *);
433 int arc_query_firmware(struct arc_softc *);
434
435 /*
436 * stuff to do messaging via the doorbells.
437 */
438 void arc_lock(struct arc_softc *);
439 void arc_unlock(struct arc_softc *);
440 void arc_wait(struct arc_softc *);
441 uint8_t arc_msg_cksum(void *, uint16_t);
442 int arc_msgbuf(struct arc_softc *, void *, size_t, void *, size_t);
443
444 #endif /* ! _PCI_ARCMSRVAR_H_ */
445