xref: /netbsd-src/sys/dev/pci/arcmsrvar.h (revision 8b0f9554ff8762542c4defc4f70e1eb76fb508fa)
1 /*	$NetBSD: arcmsrvar.h,v 1.6 2007/12/09 00:24:46 xtraeme 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@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