1/*
2 * HighPoint RR3xxx controller driver for Linux
3 * Copyright (C) 2006 HighPoint Technologies, Inc. All Rights Reserved.
4 *
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; version 2 of the License.
8 *
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12 * GNU General Public License for more details.
13 *
14 * Please report bugs/comments/suggestions to linux@highpoint-tech.com
15 *
16 * For more information, visit http://www.highpoint-tech.com
17 */
18#ifndef _HPTIOP_H_
19#define _HPTIOP_H_
20
21/*
22 * logical device type.
23 * Identify array (logical device) and physical device.
24 */
25#define LDT_ARRAY   1
26#define LDT_DEVICE  2
27
28/*
29 * Array types
30 */
31#define AT_UNKNOWN  0
32#define AT_RAID0    1
33#define AT_RAID1    2
34#define AT_RAID5    3
35#define AT_RAID6    4
36#define AT_JBOD     7
37
38#define MAX_NAME_LENGTH     36
39#define MAX_ARRAYNAME_LEN   16
40
41#define MAX_ARRAY_MEMBERS_V1 8
42#define MAX_ARRAY_MEMBERS_V2 16
43
44/* keep definition for source code compatiblity */
45#define MAX_ARRAY_MEMBERS MAX_ARRAY_MEMBERS_V1
46
47/*
48 * array flags
49 */
50#define ARRAY_FLAG_DISABLED         0x00000001 /* The array is disabled */
51#define ARRAY_FLAG_NEEDBUILDING     0x00000002 /* need to be rebuilt */
52#define ARRAY_FLAG_REBUILDING       0x00000004 /* in rebuilding process */
53#define ARRAY_FLAG_BROKEN           0x00000008 /* broken but still working */
54#define ARRAY_FLAG_BOOTDISK         0x00000010 /* has a active partition */
55#define ARRAY_FLAG_BOOTMARK         0x00000040 /* array has boot mark set */
56#define ARRAY_FLAG_NEED_AUTOREBUILD 0x00000080 /* auto-rebuild should start */
57#define ARRAY_FLAG_VERIFYING        0x00000100 /* is being verified */
58#define ARRAY_FLAG_INITIALIZING     0x00000200 /* is being initialized */
59#define ARRAY_FLAG_TRANSFORMING     0x00000400 /* tranform in progress */
60#define ARRAY_FLAG_NEEDTRANSFORM    0x00000800 /* array need tranform */
61#define ARRAY_FLAG_NEEDINITIALIZING 0x00001000 /* initialization not done */
62#define ARRAY_FLAG_BROKEN_REDUNDANT 0x00002000 /* broken but redundant */
63
64/*
65 * device flags
66 */
67#define DEVICE_FLAG_DISABLED        0x00000001 /* device is disabled */
68#define DEVICE_FLAG_UNINITIALIZED   0x00010000 /* device is not initialized */
69#define DEVICE_FLAG_LEGACY          0x00020000 /* lagacy drive */
70#define DEVICE_FLAG_IS_SPARE        0x80000000 /* is a spare disk */
71
72/*
73 * ioctl codes
74 */
75#define HPT_CTL_CODE(x) (x+0xFF00)
76#define HPT_CTL_CODE_LINUX_TO_IOP(x) ((x)-0xff00)
77
78#define HPT_IOCTL_GET_CONTROLLER_INFO       HPT_CTL_CODE(2)
79#define HPT_IOCTL_GET_CHANNEL_INFO          HPT_CTL_CODE(3)
80#define HPT_IOCTL_GET_LOGICAL_DEVICES       HPT_CTL_CODE(4)
81#define HPT_IOCTL_GET_DRIVER_CAPABILITIES   HPT_CTL_CODE(19)
82#define HPT_IOCTL_GET_DEVICE_INFO_V3        HPT_CTL_CODE(46)
83#define HPT_IOCTL_GET_CONTROLLER_INFO_V2    HPT_CTL_CODE(47)
84
85/*
86 * Controller information.
87 */
88struct hpt_controller_info {
89	u8      chip_type;                    /* chip type */
90	u8      interrupt_level;              /* IRQ level */
91	u8      num_buses;                    /* bus count */
92	u8      chip_flags;
93
94	u8      product_id[MAX_NAME_LENGTH];/* product name */
95	u8      vendor_id[MAX_NAME_LENGTH]; /* vendor name */
96}
97__attribute__((packed));
98
99/*
100 * Channel information.
101 */
102struct hpt_channel_info {
103	__le32  io_port;         /* IDE Base Port Address */
104	__le32  control_port;    /* IDE Control Port Address */
105	__le32  devices[2];      /* device connected to this channel */
106}
107__attribute__((packed));
108
109/*
110 * Array information.
111 */
112struct hpt_array_info_v3 {
113	u8      name[MAX_ARRAYNAME_LEN]; /* array name */
114	u8      description[64];         /* array description */
115	u8      create_manager[16];      /* who created it */
116	__le32  create_time;             /* when created it */
117
118	u8      array_type;              /* array type */
119	u8      block_size_shift;        /* stripe size */
120	u8      ndisk;                   /* Number of ID in Members[] */
121	u8      reserved;
122
123	__le32  flags;                   /* working flags, see ARRAY_FLAG_XXX */
124	__le32  members[MAX_ARRAY_MEMBERS_V2];  /* member array/disks */
125
126	__le32  rebuilding_progress;
127	__le64  rebuilt_sectors; /* rebuilding point (LBA) for single member */
128
129	__le32  transform_source;
130	__le32  transform_target;    /* destination device ID */
131	__le32  transforming_progress;
132	__le32  signature;              /* persistent identification*/
133	__le16  critical_members;       /* bit mask of critical members */
134	__le16  reserve2;
135	__le32  reserve;
136}
137__attribute__((packed));
138
139/*
140 * physical device information.
141 */
142#define MAX_PARENTS_PER_DISK    8
143
144struct hpt_device_info_v2 {
145	u8   ctlr_id;             /* controller id */
146	u8   path_id;             /* bus */
147	u8   target_id;           /* id */
148	u8   device_mode_setting; /* Current Data Transfer mode: 0-4 PIO0-4 */
149				  /* 5-7 MW DMA0-2, 8-13 UDMA0-5 */
150	u8   device_type;         /* device type */
151	u8   usable_mode;         /* highest usable mode */
152
153#ifdef __BIG_ENDIAN_BITFIELD
154	u8   NCQ_enabled: 1;
155	u8   NCQ_supported: 1;
156	u8   TCQ_enabled: 1;
157	u8   TCQ_supported: 1;
158	u8   write_cache_enabled: 1;
159	u8   write_cache_supported: 1;
160	u8   read_ahead_enabled: 1;
161	u8   read_ahead_supported: 1;
162	u8   reserved6: 6;
163	u8   spin_up_mode: 2;
164#else
165	u8   read_ahead_supported: 1;
166	u8   read_ahead_enabled: 1;
167	u8   write_cache_supported: 1;
168	u8   write_cache_enabled: 1;
169	u8   TCQ_supported: 1;
170	u8   TCQ_enabled: 1;
171	u8   NCQ_supported: 1;
172	u8   NCQ_enabled: 1;
173	u8   spin_up_mode: 2;
174	u8   reserved6: 6;
175#endif
176
177	__le32  flags;         /* working flags, see DEVICE_FLAG_XXX */
178	u8      ident[150];    /* (partitial) Identify Data of this device */
179
180	__le64  total_free;
181	__le64  max_free;
182	__le64  bad_sectors;
183	__le32  parent_arrays[MAX_PARENTS_PER_DISK];
184}
185__attribute__((packed));
186
187/*
188 * Logical device information.
189 */
190#define INVALID_TARGET_ID   0xFF
191#define INVALID_BUS_ID      0xFF
192
193struct hpt_logical_device_info_v3 {
194	u8       type;                   /* LDT_ARRAY or LDT_DEVICE */
195	u8       cache_policy;           /* refer to CACHE_POLICY_xxx */
196	u8       vbus_id;                /* vbus sequence in vbus_list */
197	u8       target_id;              /* OS target id. 0xFF is invalid */
198					 /* OS name: DISK $VBusId_$TargetId */
199	__le64   capacity;               /* array capacity */
200	__le32   parent_array;           /* don't use this field for physical
201					    device. use ParentArrays field in
202					    hpt_device_info_v2 */
203	/* reserved statistic fields */
204	__le32   stat1;
205	__le32   stat2;
206	__le32   stat3;
207	__le32   stat4;
208
209	union {
210		struct hpt_array_info_v3 array;
211		struct hpt_device_info_v2 device;
212	} __attribute__((packed)) u;
213
214}
215__attribute__((packed));
216
217/*
218 * ioctl structure
219 */
220#define HPT_IOCTL_MAGIC   0xA1B2C3D4
221
222struct hpt_ioctl_u {
223	u32   magic;            /* used to check if it's a valid ioctl packet */
224	u32   ioctl_code;       /* operation control code */
225	void __user *inbuf;     /* input data buffer */
226	u32   inbuf_size;       /* size of input data buffer */
227	void __user *outbuf;    /* output data buffer */
228	u32   outbuf_size;      /* size of output data buffer */
229	void __user *bytes_returned;   /* count of bytes returned */
230}
231__attribute__((packed));
232
233
234struct hpt_iopmu
235{
236	__le32 resrved0[4];
237	__le32 inbound_msgaddr0;
238	__le32 inbound_msgaddr1;
239	__le32 outbound_msgaddr0;
240	__le32 outbound_msgaddr1;
241	__le32 inbound_doorbell;
242	__le32 inbound_intstatus;
243	__le32 inbound_intmask;
244	__le32 outbound_doorbell;
245	__le32 outbound_intstatus;
246	__le32 outbound_intmask;
247	__le32 reserved1[2];
248	__le32 inbound_queue;
249	__le32 outbound_queue;
250};
251
252#define IOPMU_QUEUE_EMPTY            0xffffffff
253#define IOPMU_QUEUE_MASK_HOST_BITS   0xf0000000
254#define IOPMU_QUEUE_ADDR_HOST_BIT    0x80000000
255
256#define IOPMU_OUTBOUND_INT_MSG0      1
257#define IOPMU_OUTBOUND_INT_MSG1      2
258#define IOPMU_OUTBOUND_INT_DOORBELL  4
259#define IOPMU_OUTBOUND_INT_POSTQUEUE 8
260#define IOPMU_OUTBOUND_INT_PCI       0x10
261
262#define IOPMU_INBOUND_INT_MSG0       1
263#define IOPMU_INBOUND_INT_MSG1       2
264#define IOPMU_INBOUND_INT_DOORBELL   4
265#define IOPMU_INBOUND_INT_ERROR      8
266#define IOPMU_INBOUND_INT_POSTQUEUE  0x10
267
268enum hpt_iopmu_message {
269	/* host-to-iop messages */
270	IOPMU_INBOUND_MSG0_NOP = 0,
271	IOPMU_INBOUND_MSG0_RESET,
272	IOPMU_INBOUND_MSG0_FLUSH,
273	IOPMU_INBOUND_MSG0_SHUTDOWN,
274	IOPMU_INBOUND_MSG0_STOP_BACKGROUND_TASK,
275	IOPMU_INBOUND_MSG0_START_BACKGROUND_TASK,
276	IOPMU_INBOUND_MSG0_MAX = 0xff,
277	/* iop-to-host messages */
278	IOPMU_OUTBOUND_MSG0_REGISTER_DEVICE_0 = 0x100,
279	IOPMU_OUTBOUND_MSG0_REGISTER_DEVICE_MAX = 0x1ff,
280	IOPMU_OUTBOUND_MSG0_UNREGISTER_DEVICE_0 = 0x200,
281	IOPMU_OUTBOUND_MSG0_UNREGISTER_DEVICE_MAX = 0x2ff,
282	IOPMU_OUTBOUND_MSG0_REVALIDATE_DEVICE_0 = 0x300,
283	IOPMU_OUTBOUND_MSG0_REVALIDATE_DEVICE_MAX = 0x3ff,
284};
285
286struct hpt_iop_request_header
287{
288	__le32 size;
289	__le32 type;
290	__le32 flags;
291	__le32 result;
292	__le32 context; /* host context */
293	__le32 context_hi32;
294};
295
296#define IOP_REQUEST_FLAG_SYNC_REQUEST 1
297#define IOP_REQUEST_FLAG_BIST_REQUEST 2
298#define IOP_REQUEST_FLAG_REMAPPED     4
299#define IOP_REQUEST_FLAG_OUTPUT_CONTEXT 8
300
301enum hpt_iop_request_type {
302	IOP_REQUEST_TYPE_GET_CONFIG = 0,
303	IOP_REQUEST_TYPE_SET_CONFIG,
304	IOP_REQUEST_TYPE_BLOCK_COMMAND,
305	IOP_REQUEST_TYPE_SCSI_COMMAND,
306	IOP_REQUEST_TYPE_IOCTL_COMMAND,
307	IOP_REQUEST_TYPE_MAX
308};
309
310enum hpt_iop_result_type {
311	IOP_RESULT_PENDING = 0,
312	IOP_RESULT_SUCCESS,
313	IOP_RESULT_FAIL,
314	IOP_RESULT_BUSY,
315	IOP_RESULT_RESET,
316	IOP_RESULT_INVALID_REQUEST,
317	IOP_RESULT_BAD_TARGET,
318	IOP_RESULT_MODE_SENSE_CHECK_CONDITION,
319};
320
321struct hpt_iop_request_get_config
322{
323	struct hpt_iop_request_header header;
324	__le32 interface_version;
325	__le32 firmware_version;
326	__le32 max_requests;
327	__le32 request_size;
328	__le32 max_sg_count;
329	__le32 data_transfer_length;
330	__le32 alignment_mask;
331	__le32 max_devices;
332	__le32 sdram_size;
333};
334
335struct hpt_iop_request_set_config
336{
337	struct hpt_iop_request_header header;
338	__le32 iop_id;
339	__le32 vbus_id;
340	__le32 reserve[6];
341};
342
343struct hpt_iopsg
344{
345	__le32 size;
346	__le32 eot; /* non-zero: end of table */
347	__le64 pci_address;
348};
349
350struct hpt_iop_request_block_command
351{
352	struct hpt_iop_request_header header;
353	u8     channel;
354	u8     target;
355	u8     lun;
356	u8     pad1;
357	__le16 command; /* IOP_BLOCK_COMMAND_{READ,WRITE} */
358	__le16 sectors;
359	__le64 lba;
360	struct hpt_iopsg sg_list[1];
361};
362
363#define IOP_BLOCK_COMMAND_READ     1
364#define IOP_BLOCK_COMMAND_WRITE    2
365#define IOP_BLOCK_COMMAND_VERIFY   3
366#define IOP_BLOCK_COMMAND_FLUSH    4
367#define IOP_BLOCK_COMMAND_SHUTDOWN 5
368
369struct hpt_iop_request_scsi_command
370{
371	struct hpt_iop_request_header header;
372	u8     channel;
373	u8     target;
374	u8     lun;
375	u8     pad1;
376	u8     cdb[16];
377	__le32 dataxfer_length;
378	struct hpt_iopsg sg_list[1];
379};
380
381struct hpt_iop_request_ioctl_command
382{
383	struct hpt_iop_request_header header;
384	__le32 ioctl_code;
385	__le32 inbuf_size;
386	__le32 outbuf_size;
387	__le32 bytes_returned;
388	u8     buf[1];
389	/* out data should be put at buf[(inbuf_size+3)&~3] */
390};
391
392#define HPTIOP_MAX_REQUESTS  256u
393
394struct hptiop_request {
395	struct hptiop_request * next;
396	void *                  req_virt;
397	u32                     req_shifted_phy;
398	struct scsi_cmnd *      scp;
399	int                     index;
400};
401
402struct hpt_scsi_pointer {
403	int mapped;
404	int sgcnt;
405	dma_addr_t dma_handle;
406};
407
408#define HPT_SCP(scp) ((struct hpt_scsi_pointer *)&(scp)->SCp)
409
410struct hptiop_hba {
411	struct hpt_iopmu __iomem * iop;
412	struct Scsi_Host * host;
413	struct pci_dev * pcidev;
414
415	struct list_head link;
416
417	/* IOP config info */
418	u32     firmware_version;
419	u32     sdram_size;
420	u32     max_devices;
421	u32     max_requests;
422	u32     max_request_size;
423	u32     max_sg_descriptors;
424
425	u32     req_size; /* host-allocated request buffer size */
426	int     initialized;
427	int     msg_done;
428
429	struct hptiop_request * req_list;
430	struct hptiop_request reqs[HPTIOP_MAX_REQUESTS];
431
432	/* used to free allocated dma area */
433	void *      dma_coherent;
434	dma_addr_t  dma_coherent_handle;
435
436	atomic_t    reset_count;
437	atomic_t    resetting;
438
439	wait_queue_head_t reset_wq;
440	wait_queue_head_t ioctl_wq;
441};
442
443struct hpt_ioctl_k
444{
445	struct hptiop_hba * hba;
446	u32    ioctl_code;
447	u32    inbuf_size;
448	u32    outbuf_size;
449	void * inbuf;
450	void * outbuf;
451	u32  * bytes_returned;
452	void (*done)(struct hpt_ioctl_k *);
453	int    result; /* HPT_IOCTL_RESULT_ */
454};
455
456#define HPT_IOCTL_RESULT_OK         0
457#define HPT_IOCTL_RESULT_FAILED     (-1)
458
459#define dprintk(fmt, args...)
460
461#endif
462