Merge master.kernel.org:/pub/scm/linux/kernel/git/torvalds/linux-2.6
[sfrench/cifs-2.6.git] / drivers / message / fusion / mptbase.h
1 /*
2  *  linux/drivers/message/fusion/mptbase.h
3  *      High performance SCSI + LAN / Fibre Channel device drivers.
4  *      For use with PCI chip/adapter(s):
5  *          LSIFC9xx/LSI409xx Fibre Channel
6  *      running LSI Logic Fusion MPT (Message Passing Technology) firmware.
7  *
8  *  Copyright (c) 1999-2007 LSI Logic Corporation
9  *  (mailto:DL-MPTFusionLinux@lsi.com)
10  *
11  */
12 /*=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=*/
13 /*
14     This program is free software; you can redistribute it and/or modify
15     it under the terms of the GNU General Public License as published by
16     the Free Software Foundation; version 2 of the License.
17
18     This program is distributed in the hope that it will be useful,
19     but WITHOUT ANY WARRANTY; without even the implied warranty of
20     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
21     GNU General Public License for more details.
22
23     NO WARRANTY
24     THE PROGRAM IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OR
25     CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED INCLUDING, WITHOUT
26     LIMITATION, ANY WARRANTIES OR CONDITIONS OF TITLE, NON-INFRINGEMENT,
27     MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Each Recipient is
28     solely responsible for determining the appropriateness of using and
29     distributing the Program and assumes all risks associated with its
30     exercise of rights under this Agreement, including but not limited to
31     the risks and costs of program errors, damage to or loss of data,
32     programs or equipment, and unavailability or interruption of operations.
33
34     DISCLAIMER OF LIABILITY
35     NEITHER RECIPIENT NOR ANY CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY
36     DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
37     DAMAGES (INCLUDING WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED AND
38     ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
39     TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
40     USE OR DISTRIBUTION OF THE PROGRAM OR THE EXERCISE OF ANY RIGHTS GRANTED
41     HEREUNDER, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES
42
43     You should have received a copy of the GNU General Public License
44     along with this program; if not, write to the Free Software
45     Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
46 */
47
48 #ifndef MPTBASE_H_INCLUDED
49 #define MPTBASE_H_INCLUDED
50 /*{-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=*/
51
52 #include <linux/kernel.h>
53 #include <linux/pci.h>
54
55 #include "lsi/mpi_type.h"
56 #include "lsi/mpi.h"            /* Fusion MPI(nterface) basic defs */
57 #include "lsi/mpi_ioc.h"        /* Fusion MPT IOC(ontroller) defs */
58 #include "lsi/mpi_cnfg.h"       /* IOC configuration support */
59 #include "lsi/mpi_init.h"       /* SCSI Host (initiator) protocol support */
60 #include "lsi/mpi_lan.h"        /* LAN over FC protocol support */
61 #include "lsi/mpi_raid.h"       /* Integrated Mirroring support */
62
63 #include "lsi/mpi_fc.h"         /* Fibre Channel (lowlevel) support */
64 #include "lsi/mpi_targ.h"       /* SCSI/FCP Target protcol support */
65 #include "lsi/mpi_tool.h"       /* Tools support */
66 #include "lsi/mpi_sas.h"        /* SAS support */
67
68 /*=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=*/
69
70 #ifndef MODULEAUTHOR
71 #define MODULEAUTHOR    "LSI Logic Corporation"
72 #endif
73
74 #ifndef COPYRIGHT
75 #define COPYRIGHT       "Copyright (c) 1999-2007 " MODULEAUTHOR
76 #endif
77
78 #define MPT_LINUX_VERSION_COMMON        "3.04.05"
79 #define MPT_LINUX_PACKAGE_NAME          "@(#)mptlinux-3.04.05"
80 #define WHAT_MAGIC_STRING               "@" "(" "#" ")"
81
82 #define show_mptmod_ver(s,ver)  \
83         printk(KERN_INFO "%s %s\n", s, ver);
84
85 /*=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=*/
86 /*
87  *  Fusion MPT(linux) driver configurable stuff...
88  */
89 #define MPT_MAX_ADAPTERS                18
90 #define MPT_MAX_PROTOCOL_DRIVERS        16
91 #define MPT_MAX_BUS                     1       /* Do not change */
92 #define MPT_MAX_FC_DEVICES              255
93 #define MPT_MAX_SCSI_DEVICES            16
94 #define MPT_LAST_LUN                    255
95 #define MPT_SENSE_BUFFER_ALLOC          64
96         /* allow for 256 max sense alloc, but only 255 max request */
97 #if MPT_SENSE_BUFFER_ALLOC >= 256
98 #       undef MPT_SENSE_BUFFER_ALLOC
99 #       define MPT_SENSE_BUFFER_ALLOC   256
100 #       define MPT_SENSE_BUFFER_SIZE    255
101 #else
102 #       define MPT_SENSE_BUFFER_SIZE    MPT_SENSE_BUFFER_ALLOC
103 #endif
104
105 #define MPT_NAME_LENGTH                 32
106
107 #define MPT_PROCFS_MPTBASEDIR           "mpt"
108                                                 /* chg it to "driver/fusion" ? */
109 #define MPT_PROCFS_SUMMARY_ALL_NODE             MPT_PROCFS_MPTBASEDIR "/summary"
110 #define MPT_PROCFS_SUMMARY_ALL_PATHNAME         "/proc/" MPT_PROCFS_SUMMARY_ALL_NODE
111 #define MPT_FW_REV_MAGIC_ID_STRING              "FwRev="
112
113 #define  MPT_MAX_REQ_DEPTH              1023
114 #define  MPT_DEFAULT_REQ_DEPTH          256
115 #define  MPT_MIN_REQ_DEPTH              128
116
117 #define  MPT_MAX_REPLY_DEPTH            MPT_MAX_REQ_DEPTH
118 #define  MPT_DEFAULT_REPLY_DEPTH        128
119 #define  MPT_MIN_REPLY_DEPTH            8
120 #define  MPT_MAX_REPLIES_PER_ISR        32
121
122 #define  MPT_MAX_FRAME_SIZE             128
123 #define  MPT_DEFAULT_FRAME_SIZE         128
124
125 #define  MPT_REPLY_FRAME_SIZE           0x50  /* Must be a multiple of 8 */
126
127 #define  MPT_SG_REQ_128_SCALE           1
128 #define  MPT_SG_REQ_96_SCALE            2
129 #define  MPT_SG_REQ_64_SCALE            4
130
131 #define  CAN_SLEEP                      1
132 #define  NO_SLEEP                       0
133
134 #define MPT_COALESCING_TIMEOUT          0x10
135
136 /*
137  * SCSI transfer rate defines.
138  */
139 #define MPT_ULTRA320                    0x08
140 #define MPT_ULTRA160                    0x09
141 #define MPT_ULTRA2                      0x0A
142 #define MPT_ULTRA                       0x0C
143 #define MPT_FAST                        0x19
144 #define MPT_SCSI                        0x32
145 #define MPT_ASYNC                       0xFF
146
147 #define MPT_NARROW                      0
148 #define MPT_WIDE                        1
149
150 #define C0_1030                         0x08
151 #define XL_929                          0x01
152
153
154 /*
155  *      Try to keep these at 2^N-1
156  */
157 #define MPT_FC_CAN_QUEUE        127
158 #define MPT_SCSI_CAN_QUEUE      127
159
160 /*
161  * Set the MAX_SGE value based on user input.
162  */
163 #ifdef  CONFIG_FUSION_MAX_SGE
164 #if     CONFIG_FUSION_MAX_SGE  < 16
165 #define MPT_SCSI_SG_DEPTH       16
166 #elif   CONFIG_FUSION_MAX_SGE  > 128
167 #define MPT_SCSI_SG_DEPTH       128
168 #else
169 #define MPT_SCSI_SG_DEPTH       CONFIG_FUSION_MAX_SGE
170 #endif
171 #else
172 #define MPT_SCSI_SG_DEPTH       40
173 #endif
174
175 /* debug print string length used for events and iocstatus */
176 # define EVENT_DESCR_STR_SZ             100
177
178 #ifdef __KERNEL__       /* { */
179 /*=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=*/
180
181 #include <linux/proc_fs.h>
182
183 /*=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=*/
184 /*
185  * Attempt semi-consistent error & warning msgs across
186  * MPT drivers.  NOTE: Users of these macro defs must
187  * themselves define their own MYNAM.
188  */
189 #define MYIOC_s_DEBUG_FMT               KERN_DEBUG MYNAM ": %s: "
190 #define MYIOC_s_INFO_FMT                KERN_INFO MYNAM ": %s: "
191 #define MYIOC_s_NOTE_FMT                KERN_NOTICE MYNAM ": %s: "
192 #define MYIOC_s_WARN_FMT                KERN_WARNING MYNAM ": %s: WARNING - "
193 #define MYIOC_s_ERR_FMT                 KERN_ERR MYNAM ": %s: ERROR - "
194
195 /*=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=*/
196 /*
197  *  MPT protocol driver defs...
198  */
199 typedef enum {
200         MPTBASE_DRIVER,         /* MPT base class */
201         MPTCTL_DRIVER,          /* MPT ioctl class */
202         MPTSPI_DRIVER,          /* MPT SPI host class */
203         MPTFC_DRIVER,           /* MPT FC host class */
204         MPTSAS_DRIVER,          /* MPT SAS host class */
205         MPTLAN_DRIVER,          /* MPT LAN class */
206         MPTSTM_DRIVER,          /* MPT SCSI target mode class */
207         MPTUNKNOWN_DRIVER
208 } MPT_DRIVER_CLASS;
209
210 struct mpt_pci_driver{
211         int  (*probe) (struct pci_dev *dev, const struct pci_device_id *id);
212         void (*remove) (struct pci_dev *dev);
213 };
214
215 /*
216  *  MPT adapter / port / bus / device info structures...
217  */
218
219 typedef union _MPT_FRAME_TRACKER {
220         struct {
221                 struct list_head        list;
222                 u32                      arg1;
223                 u32                      pad;
224                 void                    *argp1;
225         } linkage;
226         /*
227          * NOTE: When request frames are free, on the linkage structure
228          * contets are valid.  All other values are invalid.
229          * In particular, do NOT reply on offset [2]
230          * (in words) being the * message context.
231          * The message context must be reset (computed via base address
232          * + an offset) prior to issuing any command.
233          *
234          * NOTE2: On non-32-bit systems, where pointers are LARGE,
235          * using the linkage pointers destroys our sacred MsgContext
236          * field contents.  But we don't care anymore because these
237          * are now reset in mpt_put_msg_frame() just prior to sending
238          * a request off to the IOC.
239          */
240         struct {
241                 u32 __hdr[2];
242                 /*
243                  * The following _MUST_ match the location of the
244                  * MsgContext field in the MPT message headers.
245                  */
246                 union {
247                         u32              MsgContext;
248                         struct {
249                                 u16      req_idx;       /* Request index */
250                                 u8       cb_idx;        /* callback function index */
251                                 u8       rsvd;
252                         } fld;
253                 } msgctxu;
254         } hwhdr;
255         /*
256          * Remark: 32 bit identifier:
257          *  31-24: reserved
258          *  23-16: call back index
259          *  15-0 : request index
260          */
261 } MPT_FRAME_TRACKER;
262
263 /*
264  *  We might want to view/access a frame as:
265  *    1) generic request header
266  *    2) SCSIIORequest
267  *    3) SCSIIOReply
268  *    4) MPIDefaultReply
269  *    5) frame tracker
270  */
271 typedef struct _MPT_FRAME_HDR {
272         union {
273                 MPIHeader_t             hdr;
274                 SCSIIORequest_t         scsireq;
275                 SCSIIOReply_t           sreply;
276                 ConfigReply_t           configreply;
277                 MPIDefaultReply_t       reply;
278                 MPT_FRAME_TRACKER       frame;
279         } u;
280 } MPT_FRAME_HDR;
281
282 #define MPT_REQ_MSGFLAGS_DROPME         0x80
283
284 typedef struct _MPT_SGL_HDR {
285         SGESimple32_t    sge[1];
286 } MPT_SGL_HDR;
287
288 typedef struct _MPT_SGL64_HDR {
289         SGESimple64_t    sge[1];
290 } MPT_SGL64_HDR;
291
292 /*
293  *  System interface register set
294  */
295
296 typedef struct _SYSIF_REGS
297 {
298         u32     Doorbell;       /* 00     System<->IOC Doorbell reg  */
299         u32     WriteSequence;  /* 04     Write Sequence register    */
300         u32     Diagnostic;     /* 08     Diagnostic register        */
301         u32     TestBase;       /* 0C     Test Base Address          */
302         u32     DiagRwData;     /* 10     Read Write Data (fw download)   */
303         u32     DiagRwAddress;  /* 14     Read Write Address (fw download)*/
304         u32     Reserved1[6];   /* 18-2F  reserved for future use    */
305         u32     IntStatus;      /* 30     Interrupt Status           */
306         u32     IntMask;        /* 34     Interrupt Mask             */
307         u32     Reserved2[2];   /* 38-3F  reserved for future use    */
308         u32     RequestFifo;    /* 40     Request Post/Free FIFO     */
309         u32     ReplyFifo;      /* 44     Reply   Post/Free FIFO     */
310         u32     Reserved3[2];   /* 48-4F  reserved for future use    */
311         u32     HostIndex;      /* 50     Host Index register        */
312         u32     Reserved4[15];  /* 54-8F                             */
313         u32     Fubar;          /* 90     For Fubar usage            */
314         u32     Reserved5[1050];/* 94-10F8                           */
315         u32     Reset_1078;     /* 10FC   Reset 1078                 */
316 } SYSIF_REGS;
317
318 /*
319  * NOTE: Use MPI_{DOORBELL,WRITESEQ,DIAG}_xxx defs in lsi/mpi.h
320  * in conjunction with SYSIF_REGS accesses!
321  */
322
323
324 /*
325  *      Dynamic Multi-Pathing specific stuff...
326  */
327
328 /* VirtTarget negoFlags field */
329 #define MPT_TARGET_NO_NEGO_WIDE         0x01
330 #define MPT_TARGET_NO_NEGO_SYNC         0x02
331 #define MPT_TARGET_NO_NEGO_QAS          0x04
332 #define MPT_TAPE_NEGO_IDP               0x08
333
334 /*
335  *      VirtDevice - FC LUN device or SCSI target device
336  */
337 typedef struct _VirtTarget {
338         struct scsi_target      *starget;
339         u8                       tflags;
340         u8                       ioc_id;
341         u8                       id;
342         u8                       channel;
343         u8                       minSyncFactor; /* 0xFF is async */
344         u8                       maxOffset;     /* 0 if async */
345         u8                       maxWidth;      /* 0 if narrow, 1 if wide */
346         u8                       negoFlags;     /* bit field, see above */
347         u8                       raidVolume;    /* set, if RAID Volume */
348         u8                       type;          /* byte 0 of Inquiry data */
349         u8                       deleted;       /* target in process of being removed */
350         u32                      num_luns;
351 } VirtTarget;
352
353 typedef struct _VirtDevice {
354         VirtTarget              *vtarget;
355         u8                       configured_lun;
356         int                      lun;
357 } VirtDevice;
358
359 /*
360  *  Fibre Channel (SCSI) target device and associated defines...
361  */
362 #define MPT_TARGET_DEFAULT_DV_STATUS    0x00
363 #define MPT_TARGET_FLAGS_VALID_NEGO     0x01
364 #define MPT_TARGET_FLAGS_VALID_INQUIRY  0x02
365 #define MPT_TARGET_FLAGS_Q_YES          0x08
366 #define MPT_TARGET_FLAGS_VALID_56       0x10
367 #define MPT_TARGET_FLAGS_SAF_TE_ISSUED  0x20
368 #define MPT_TARGET_FLAGS_RAID_COMPONENT 0x40
369 #define MPT_TARGET_FLAGS_LED_ON         0x80
370
371 /*
372  *      /proc/mpt interface
373  */
374 typedef struct {
375         const char      *name;
376         mode_t           mode;
377         int              pad;
378         read_proc_t     *read_proc;
379         write_proc_t    *write_proc;
380 } mpt_proc_entry_t;
381
382 #define MPT_PROC_READ_RETURN(buf,start,offset,request,eof,len) \
383 do { \
384         len -= offset;                  \
385         if (len < request) {            \
386                 *eof = 1;               \
387                 if (len <= 0)           \
388                         return 0;       \
389         } else                          \
390                 len = request;          \
391         *start = buf + offset;          \
392         return len;                     \
393 } while (0)
394
395
396 /*
397  *      IOCTL structure and associated defines
398  */
399
400 #define MPT_IOCTL_STATUS_DID_IOCRESET   0x01    /* IOC Reset occurred on the current*/
401 #define MPT_IOCTL_STATUS_RF_VALID       0x02    /* The Reply Frame is VALID */
402 #define MPT_IOCTL_STATUS_TIMER_ACTIVE   0x04    /* The timer is running */
403 #define MPT_IOCTL_STATUS_SENSE_VALID    0x08    /* Sense data is valid */
404 #define MPT_IOCTL_STATUS_COMMAND_GOOD   0x10    /* Command Status GOOD */
405 #define MPT_IOCTL_STATUS_TMTIMER_ACTIVE 0x20    /* The TM timer is running */
406 #define MPT_IOCTL_STATUS_TM_FAILED      0x40    /* User TM request failed */
407
408 #define MPTCTL_RESET_OK                 0x01    /* Issue Bus Reset */
409
410 typedef struct _MPT_IOCTL {
411         struct _MPT_ADAPTER     *ioc;
412         u8                       ReplyFrame[MPT_DEFAULT_FRAME_SIZE];    /* reply frame data */
413         u8                       sense[MPT_SENSE_BUFFER_ALLOC];
414         int                      wait_done;     /* wake-up value for this ioc */
415         u8                       rsvd;
416         u8                       status;        /* current command status */
417         u8                       reset;         /* 1 if bus reset allowed */
418         u8                       id;            /* target for reset */
419         struct mutex             ioctl_mutex;
420 } MPT_IOCTL;
421
422 #define MPT_SAS_MGMT_STATUS_RF_VALID    0x02    /* The Reply Frame is VALID */
423 #define MPT_SAS_MGMT_STATUS_COMMAND_GOOD        0x10    /* Command Status GOOD */
424 #define MPT_SAS_MGMT_STATUS_TM_FAILED   0x40    /* User TM request failed */
425
426 typedef struct _MPT_SAS_MGMT {
427         struct mutex             mutex;
428         struct completion        done;
429         u8                       reply[MPT_DEFAULT_FRAME_SIZE]; /* reply frame data */
430         u8                       status;        /* current command status */
431 }MPT_SAS_MGMT;
432
433 /*
434  *  Event Structure and define
435  */
436 #define MPTCTL_EVENT_LOG_SIZE           (0x000000032)
437 typedef struct _mpt_ioctl_events {
438         u32     event;          /* Specified by define above */
439         u32     eventContext;   /* Index or counter */
440         u32     data[2];        /* First 8 bytes of Event Data */
441 } MPT_IOCTL_EVENTS;
442
443 /*
444  * CONFIGPARM status  defines
445  */
446 #define MPT_CONFIG_GOOD         MPI_IOCSTATUS_SUCCESS
447 #define MPT_CONFIG_ERROR        0x002F
448
449 /*
450  *      Substructure to store SCSI specific configuration page data
451  */
452                                                 /* dvStatus defines: */
453 #define MPT_SCSICFG_USE_NVRAM           0x01    /* WriteSDP1 using NVRAM */
454 #define MPT_SCSICFG_ALL_IDS             0x02    /* WriteSDP1 to all IDS */
455 /* #define MPT_SCSICFG_BLK_NEGO         0x10       WriteSDP1 with WDTR and SDTR disabled */
456
457 typedef struct _SpiCfgData {
458         u32              PortFlags;
459         int             *nvram;                 /* table of device NVRAM values */
460         IOCPage4_t      *pIocPg4;               /* SEP devices addressing */
461         dma_addr_t       IocPg4_dma;            /* Phys Addr of IOCPage4 data */
462         int              IocPg4Sz;              /* IOCPage4 size */
463         u8               minSyncFactor;         /* 0xFF if async */
464         u8               maxSyncOffset;         /* 0 if async */
465         u8               maxBusWidth;           /* 0 if narrow, 1 if wide */
466         u8               busType;               /* SE, LVD, HD */
467         u8               sdp1version;           /* SDP1 version */
468         u8               sdp1length;            /* SDP1 length  */
469         u8               sdp0version;           /* SDP0 version */
470         u8               sdp0length;            /* SDP0 length  */
471         u8               dvScheduled;           /* 1 if scheduled */
472         u8               noQas;                 /* Disable QAS for this adapter */
473         u8               Saf_Te;                /* 1 to force all Processors as
474                                                  * SAF-TE if Inquiry data length
475                                                  * is too short to check for SAF-TE
476                                                  */
477         u8               bus_reset;             /* 1 to allow bus reset */
478         u8               rsvd[1];
479 }SpiCfgData;
480
481 typedef struct _SasCfgData {
482         u8               ptClear;               /* 1 to automatically clear the
483                                                  * persistent table.
484                                                  * 0 to disable
485                                                  * automatic clearing.
486                                                  */
487 }SasCfgData;
488
489 /*
490  * Inactive volume link list of raid component data
491  * @inactive_list
492  */
493 struct inactive_raid_component_info {
494         struct   list_head list;
495         u8               volumeID;              /* volume target id */
496         u8               volumeBus;             /* volume channel */
497         IOC_3_PHYS_DISK  d;                     /* phys disk info */
498 };
499
500 typedef struct _RaidCfgData {
501         IOCPage2_t      *pIocPg2;               /* table of Raid Volumes */
502         IOCPage3_t      *pIocPg3;               /* table of physical disks */
503         struct semaphore        inactive_list_mutex;
504         struct list_head        inactive_list; /* link list for physical
505                                                 disk that belong in
506                                                 inactive volumes */
507 }RaidCfgData;
508
509 typedef struct _FcCfgData {
510         /* will ultimately hold fc_port_page0 also */
511         struct {
512                 FCPortPage1_t   *data;
513                 dma_addr_t       dma;
514                 int              pg_sz;
515         }                        fc_port_page1[2];
516 } FcCfgData;
517
518 #define MPT_RPORT_INFO_FLAGS_REGISTERED 0x01    /* rport registered */
519 #define MPT_RPORT_INFO_FLAGS_MISSING    0x02    /* missing from DevPage0 scan */
520
521 /*
522  * data allocated for each fc rport device
523  */
524 struct mptfc_rport_info
525 {
526         struct list_head list;
527         struct fc_rport *rport;
528         struct scsi_target *starget;
529         FCDevicePage0_t pg0;
530         u8              flags;
531 };
532
533 /*
534  *  Adapter Structure - pci_dev specific. Maximum: MPT_MAX_ADAPTERS
535  */
536 typedef struct _MPT_ADAPTER
537 {
538         int                      id;            /* Unique adapter id N {0,1,2,...} */
539         int                      pci_irq;       /* This irq           */
540         char                     name[MPT_NAME_LENGTH]; /* "iocN"             */
541         char                     prod_name[MPT_NAME_LENGTH];    /* "LSIFC9x9"         */
542         char                     board_name[16];
543         char                     board_assembly[16];
544         char                     board_tracer[16];
545         u16                      nvdata_version_persistent;
546         u16                      nvdata_version_default;
547         int                      debug_level;
548         u8                       io_missing_delay;
549         u8                       device_missing_delay;
550         SYSIF_REGS __iomem      *chip;          /* == c8817000 (mmap) */
551         SYSIF_REGS __iomem      *pio_chip;      /* Programmed IO (downloadboot) */
552         u8                       bus_type;
553         u32                      mem_phys;      /* == f4020000 (mmap) */
554         u32                      pio_mem_phys;  /* Programmed IO (downloadboot) */
555         int                      mem_size;      /* mmap memory size */
556         int                      number_of_buses;
557         int                      devices_per_bus;
558         int                      alloc_total;
559         u32                      last_state;
560         int                      active;
561         u8                      *alloc;         /* frames alloc ptr */
562         dma_addr_t               alloc_dma;
563         u32                      alloc_sz;
564         MPT_FRAME_HDR           *reply_frames;  /* Reply msg frames - rounded up! */
565         u32                      reply_frames_low_dma;
566         int                      reply_depth;   /* Num Allocated reply frames */
567         int                      reply_sz;      /* Reply frame size */
568         int                      num_chain;     /* Number of chain buffers */
569                 /* Pool of buffers for chaining. ReqToChain
570                  * and ChainToChain track index of chain buffers.
571                  * ChainBuffer (DMA) virt/phys addresses.
572                  * FreeChainQ (lock) locking mechanisms.
573                  */
574         int                     *ReqToChain;
575         int                     *RequestNB;
576         int                     *ChainToChain;
577         u8                      *ChainBuffer;
578         dma_addr_t               ChainBufferDMA;
579         struct list_head         FreeChainQ;
580         spinlock_t               FreeChainQlock;
581                 /* We (host driver) get to manage our own RequestQueue! */
582         dma_addr_t               req_frames_dma;
583         MPT_FRAME_HDR           *req_frames;    /* Request msg frames - rounded up! */
584         u32                      req_frames_low_dma;
585         int                      req_depth;     /* Number of request frames */
586         int                      req_sz;        /* Request frame size (bytes) */
587         spinlock_t               FreeQlock;
588         struct list_head         FreeQ;
589                 /* Pool of SCSI sense buffers for commands coming from
590                  * the SCSI mid-layer.  We have one 256 byte sense buffer
591                  * for each REQ entry.
592                  */
593         u8                      *sense_buf_pool;
594         dma_addr_t               sense_buf_pool_dma;
595         u32                      sense_buf_low_dma;
596         u8                      *HostPageBuffer; /* SAS - host page buffer support */
597         u32                     HostPageBuffer_sz;
598         dma_addr_t              HostPageBuffer_dma;
599         int                      mtrr_reg;
600         struct pci_dev          *pcidev;        /* struct pci_dev pointer */
601         u8                      __iomem *memmap;        /* mmap address */
602         struct Scsi_Host        *sh;            /* Scsi Host pointer */
603         SpiCfgData              spi_data;       /* Scsi config. data */
604         RaidCfgData             raid_data;      /* Raid config. data */
605         SasCfgData              sas_data;       /* Sas config. data */
606         FcCfgData               fc_data;        /* Fc config. data */
607         MPT_IOCTL               *ioctl;         /* ioctl data pointer */
608         struct proc_dir_entry   *ioc_dentry;
609         struct _MPT_ADAPTER     *alt_ioc;       /* ptr to 929 bound adapter port */
610         spinlock_t               diagLock;      /* diagnostic reset lock */
611         int                      diagPending;
612         u32                      biosVersion;   /* BIOS version from IO Unit Page 2 */
613         int                      eventTypes;    /* Event logging parameters */
614         int                      eventContext;  /* Next event context */
615         int                      eventLogSize;  /* Max number of cached events */
616         struct _mpt_ioctl_events *events;       /* pointer to event log */
617         u8                      *cached_fw;     /* Pointer to FW */
618         dma_addr_t              cached_fw_dma;
619         struct list_head         configQ;       /* linked list of config. requests */
620         int                      hs_reply_idx;
621 #ifndef MFCNT
622         u32                      pad0;
623 #else
624         u32                      mfcnt;
625 #endif
626         u32                      NB_for_64_byte_frame;
627         u32                      hs_req[MPT_MAX_FRAME_SIZE/sizeof(u32)];
628         u16                      hs_reply[MPT_MAX_FRAME_SIZE/sizeof(u16)];
629         IOCFactsReply_t          facts;
630         PortFactsReply_t         pfacts[2];
631         FCPortPage0_t            fc_port_page0[2];
632         struct timer_list        persist_timer; /* persist table timer */
633         int                      persist_wait_done; /* persist completion flag */
634         u8                       persist_reply_frame[MPT_DEFAULT_FRAME_SIZE]; /* persist reply */
635         LANPage0_t               lan_cnfg_page0;
636         LANPage1_t               lan_cnfg_page1;
637
638         u8                       ir_firmware; /* =1 if IR firmware detected */
639         /*
640          * Description: errata_flag_1064
641          * If a PCIX read occurs within 1 or 2 cycles after the chip receives
642          * a split completion for a read data, an internal address pointer incorrectly
643          * increments by 32 bytes
644          */
645         int                      errata_flag_1064;
646         int                      aen_event_read_flag; /* flag to indicate event log was read*/
647         u8                       FirstWhoInit;
648         u8                       upload_fw;     /* If set, do a fw upload */
649         u8                       reload_fw;     /* Force a FW Reload on next reset */
650         u8                       NBShiftFactor;  /* NB Shift Factor based on Block Size (Facts)  */
651         u8                       pad1[4];
652         int                      DoneCtx;
653         int                      TaskCtx;
654         int                      InternalCtx;
655         spinlock_t               initializing_hba_lock;
656         int                      initializing_hba_lock_flag;
657         struct list_head         list;
658         struct net_device       *netdev;
659         struct list_head         sas_topology;
660         struct mutex             sas_topology_mutex;
661         struct mutex             sas_discovery_mutex;
662         u8                       sas_discovery_runtime;
663         u8                       sas_discovery_ignore_events;
664         u16                      handle;
665         int                      sas_index; /* index refrencing */
666         MPT_SAS_MGMT             sas_mgmt;
667         struct work_struct       sas_persist_task;
668
669         struct work_struct       fc_setup_reset_work;
670         struct list_head         fc_rports;
671         spinlock_t               fc_rescan_work_lock;
672         struct work_struct       fc_rescan_work;
673         char                     fc_rescan_work_q_name[KOBJ_NAME_LEN];
674         struct workqueue_struct *fc_rescan_work_q;
675 } MPT_ADAPTER;
676
677 /*
678  *  New return value convention:
679  *    1 = Ok to free associated request frame
680  *    0 = not Ok ...
681  */
682 typedef int (*MPT_CALLBACK)(MPT_ADAPTER *ioc, MPT_FRAME_HDR *req, MPT_FRAME_HDR *reply);
683 typedef int (*MPT_EVHANDLER)(MPT_ADAPTER *ioc, EventNotificationReply_t *evReply);
684 typedef int (*MPT_RESETHANDLER)(MPT_ADAPTER *ioc, int reset_phase);
685 /* reset_phase defs */
686 #define MPT_IOC_PRE_RESET               0
687 #define MPT_IOC_POST_RESET              1
688 #define MPT_IOC_SETUP_RESET             2
689
690 /*
691  * Invent MPT host event (super-set of MPI Events)
692  * Fitted to 1030's 64-byte [max] request frame size
693  */
694 typedef struct _MPT_HOST_EVENT {
695         EventNotificationReply_t         MpiEvent;      /* 8 32-bit words! */
696         u32                              pad[6];
697         void                            *next;
698 } MPT_HOST_EVENT;
699
700 #define MPT_HOSTEVENT_IOC_BRINGUP       0x91
701 #define MPT_HOSTEVENT_IOC_RECOVER       0x92
702
703 /* Define the generic types based on the size
704  * of the dma_addr_t type.
705  */
706 typedef struct _mpt_sge {
707         u32             FlagsLength;
708         dma_addr_t      Address;
709 } MptSge_t;
710
711 #define mpt_addr_size() \
712         ((sizeof(dma_addr_t) == sizeof(u64)) ? MPI_SGE_FLAGS_64_BIT_ADDRESSING : \
713                 MPI_SGE_FLAGS_32_BIT_ADDRESSING)
714
715 #define mpt_msg_flags() \
716         ((sizeof(dma_addr_t) == sizeof(u64)) ? MPI_SCSIIO_MSGFLGS_SENSE_WIDTH_64 : \
717                 MPI_SCSIIO_MSGFLGS_SENSE_WIDTH_32)
718
719 /*=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=*/
720 /*
721  *  Funky (private) macros...
722  */
723 #include "mptdebug.h"
724
725 #define MPT_INDEX_2_MFPTR(ioc,idx) \
726         (MPT_FRAME_HDR*)( (u8*)(ioc)->req_frames + (ioc)->req_sz * (idx) )
727
728 #define MFPTR_2_MPT_INDEX(ioc,mf) \
729         (int)( ((u8*)mf - (u8*)(ioc)->req_frames) / (ioc)->req_sz )
730
731 #define MPT_INDEX_2_RFPTR(ioc,idx) \
732         (MPT_FRAME_HDR*)( (u8*)(ioc)->reply_frames + (ioc)->req_sz * (idx) )
733
734 /*=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=*/
735
736 #define SCSI_STD_SENSE_BYTES    18
737 #define SCSI_STD_INQUIRY_BYTES  36
738 #define SCSI_MAX_INQUIRY_BYTES  96
739
740 /*
741  * MPT_SCSI_HOST defines - Used by the IOCTL and the SCSI drivers
742  * Private to the driver.
743  */
744 /* LOCAL structure and fields used when processing
745  * internally generated commands. These include:
746  * bus scan, dv and config requests.
747  */
748 typedef struct _MPT_LOCAL_REPLY {
749         ConfigPageHeader_t header;
750         int     completion;
751         u8      sense[SCSI_STD_SENSE_BYTES];
752         u8      scsiStatus;
753         u8      skip;
754         u32     pad;
755 } MPT_LOCAL_REPLY;
756
757 #define MPT_HOST_BUS_UNKNOWN            (0xFF)
758 #define MPT_HOST_TOO_MANY_TM            (0x05)
759 #define MPT_HOST_NVRAM_INVALID          (0xFFFFFFFF)
760 #define MPT_HOST_NO_CHAIN               (0xFFFFFFFF)
761 #define MPT_NVRAM_MASK_TIMEOUT          (0x000000FF)
762 #define MPT_NVRAM_SYNC_MASK             (0x0000FF00)
763 #define MPT_NVRAM_SYNC_SHIFT            (8)
764 #define MPT_NVRAM_DISCONNECT_ENABLE     (0x00010000)
765 #define MPT_NVRAM_ID_SCAN_ENABLE        (0x00020000)
766 #define MPT_NVRAM_LUN_SCAN_ENABLE       (0x00040000)
767 #define MPT_NVRAM_TAG_QUEUE_ENABLE      (0x00080000)
768 #define MPT_NVRAM_WIDE_DISABLE          (0x00100000)
769 #define MPT_NVRAM_BOOT_CHOICE           (0x00200000)
770
771 /* The TM_STATE variable is used to provide strict single threading of TM
772  * requests as well as communicate TM error conditions.
773  */
774 #define TM_STATE_NONE          (0)
775 #define TM_STATE_IN_PROGRESS   (1)
776 #define TM_STATE_ERROR         (2)
777
778 typedef enum {
779         FC,
780         SPI,
781         SAS
782 } BUS_TYPE;
783
784 typedef struct _MPT_SCSI_HOST {
785         MPT_ADAPTER              *ioc;
786         int                       port;
787         u32                       pad0;
788         struct scsi_cmnd        **ScsiLookup;
789         MPT_LOCAL_REPLY          *pLocal;               /* used for internal commands */
790         struct timer_list         timer;
791                 /* Pool of memory for holding SCpnts before doing
792                  * OS callbacks. freeQ is the free pool.
793                  */
794         u8                        tmPending;
795         u8                        resetPending;
796         u8                        negoNvram;            /* DV disabled, nego NVRAM */
797         u8                        pad1;
798         u8                        tmState;
799         u8                        rsvd[2];
800         MPT_FRAME_HDR            *cmdPtr;               /* Ptr to nonOS request */
801         struct scsi_cmnd         *abortSCpnt;
802         MPT_LOCAL_REPLY           localReply;           /* internal cmd reply struct */
803         unsigned long             hard_resets;          /* driver forced bus resets count */
804         unsigned long             soft_resets;          /* fw/external bus resets count */
805         unsigned long             timeouts;             /* cmd timeouts */
806         ushort                    sel_timeout[MPT_MAX_FC_DEVICES];
807         char                      *info_kbuf;
808         wait_queue_head_t         scandv_waitq;
809         int                       scandv_wait_done;
810         long                      last_queue_full;
811         u16                       tm_iocstatus;
812         u16                       spi_pending;
813         struct list_head          target_reset_list;
814 } MPT_SCSI_HOST;
815
816 /*=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=*/
817 /*
818  *      More Dynamic Multi-Pathing stuff...
819  */
820
821 /* Forward decl, a strange C thing, to prevent gcc compiler warnings */
822 struct scsi_cmnd;
823
824 /*=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=*/
825 /*
826  * Generic structure passed to the base mpt_config function.
827  */
828 typedef struct _x_config_parms {
829         struct list_head         linkage;       /* linked list */
830         struct timer_list        timer;         /* timer function for this request  */
831         union {
832                 ConfigExtendedPageHeader_t      *ehdr;
833                 ConfigPageHeader_t      *hdr;
834         } cfghdr;
835         dma_addr_t               physAddr;
836         int                      wait_done;     /* wait for this request */
837         u32                      pageAddr;      /* properly formatted */
838         u8                       action;
839         u8                       dir;
840         u8                       timeout;       /* seconds */
841         u8                       pad1;
842         u16                      status;
843         u16                      pad2;
844 } CONFIGPARMS;
845
846 /*=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=*/
847 /*
848  *  Public entry points...
849  */
850 extern int       mpt_attach(struct pci_dev *pdev, const struct pci_device_id *id);
851 extern void      mpt_detach(struct pci_dev *pdev);
852 #ifdef CONFIG_PM
853 extern int       mpt_suspend(struct pci_dev *pdev, pm_message_t state);
854 extern int       mpt_resume(struct pci_dev *pdev);
855 #endif
856 extern int       mpt_register(MPT_CALLBACK cbfunc, MPT_DRIVER_CLASS dclass);
857 extern void      mpt_deregister(int cb_idx);
858 extern int       mpt_event_register(int cb_idx, MPT_EVHANDLER ev_cbfunc);
859 extern void      mpt_event_deregister(int cb_idx);
860 extern int       mpt_reset_register(int cb_idx, MPT_RESETHANDLER reset_func);
861 extern void      mpt_reset_deregister(int cb_idx);
862 extern int       mpt_device_driver_register(struct mpt_pci_driver * dd_cbfunc, int cb_idx);
863 extern void      mpt_device_driver_deregister(int cb_idx);
864 extern MPT_FRAME_HDR    *mpt_get_msg_frame(int handle, MPT_ADAPTER *ioc);
865 extern void      mpt_free_msg_frame(MPT_ADAPTER *ioc, MPT_FRAME_HDR *mf);
866 extern void      mpt_put_msg_frame(int handle, MPT_ADAPTER *ioc, MPT_FRAME_HDR *mf);
867 extern void      mpt_add_sge(char *pAddr, u32 flagslength, dma_addr_t dma_addr);
868
869 extern int       mpt_send_handshake_request(int handle, MPT_ADAPTER *ioc, int reqBytes, u32 *req, int sleepFlag);
870 extern int       mpt_verify_adapter(int iocid, MPT_ADAPTER **iocpp);
871 extern u32       mpt_GetIocState(MPT_ADAPTER *ioc, int cooked);
872 extern void      mpt_print_ioc_summary(MPT_ADAPTER *ioc, char *buf, int *size, int len, int showlan);
873 extern int       mpt_HardResetHandler(MPT_ADAPTER *ioc, int sleepFlag);
874 extern int       mpt_config(MPT_ADAPTER *ioc, CONFIGPARMS *cfg);
875 extern void      mpt_alloc_fw_memory(MPT_ADAPTER *ioc, int size);
876 extern void      mpt_free_fw_memory(MPT_ADAPTER *ioc);
877 extern int       mpt_findImVolumes(MPT_ADAPTER *ioc);
878 extern int       mptbase_sas_persist_operation(MPT_ADAPTER *ioc, u8 persist_opcode);
879 extern int       mpt_raid_phys_disk_pg0(MPT_ADAPTER *ioc, u8 phys_disk_num, pRaidPhysDiskPage0_t phys_disk);
880
881 /*
882  *  Public data decl's...
883  */
884 extern struct list_head   ioc_list;
885 extern struct proc_dir_entry    *mpt_proc_root_dir;
886
887 extern int                mpt_lan_index;        /* needed by mptlan.c */
888 extern int                mpt_stm_index;        /* needed by mptstm.c */
889
890 /*=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=*/
891 #endif          /* } __KERNEL__ */
892
893 #if defined(__alpha__) || defined(__sparc_v9__) || defined(__ia64__) || defined(__x86_64__) || defined(__powerpc__)
894 #define CAST_U32_TO_PTR(x)      ((void *)(u64)x)
895 #define CAST_PTR_TO_U32(x)      ((u32)(u64)x)
896 #else
897 #define CAST_U32_TO_PTR(x)      ((void *)x)
898 #define CAST_PTR_TO_U32(x)      ((u32)x)
899 #endif
900
901 #define MPT_PROTOCOL_FLAGS_c_c_c_c(pflags) \
902         ((pflags) & MPI_PORTFACTS_PROTOCOL_INITIATOR)   ? 'I' : 'i',    \
903         ((pflags) & MPI_PORTFACTS_PROTOCOL_TARGET)      ? 'T' : 't',    \
904         ((pflags) & MPI_PORTFACTS_PROTOCOL_LAN)         ? 'L' : 'l',    \
905         ((pflags) & MPI_PORTFACTS_PROTOCOL_LOGBUSADDR)  ? 'B' : 'b'
906
907 /*
908  *  Shifted SGE Defines - Use in SGE with FlagsLength member.
909  *  Otherwise, use MPI_xxx defines (refer to "lsi/mpi.h" header).
910  *  Defaults: 32 bit SGE, SYSTEM_ADDRESS if direction bit is 0, read
911  */
912 #define MPT_TRANSFER_IOC_TO_HOST                (0x00000000)
913 #define MPT_TRANSFER_HOST_TO_IOC                (0x04000000)
914 #define MPT_SGE_FLAGS_LAST_ELEMENT              (0x80000000)
915 #define MPT_SGE_FLAGS_END_OF_BUFFER             (0x40000000)
916 #define MPT_SGE_FLAGS_LOCAL_ADDRESS             (0x08000000)
917 #define MPT_SGE_FLAGS_DIRECTION                 (0x04000000)
918 #define MPT_SGE_FLAGS_ADDRESSING                (mpt_addr_size() << MPI_SGE_FLAGS_SHIFT)
919 #define MPT_SGE_FLAGS_END_OF_LIST               (0x01000000)
920
921 #define MPT_SGE_FLAGS_TRANSACTION_ELEMENT       (0x00000000)
922 #define MPT_SGE_FLAGS_SIMPLE_ELEMENT            (0x10000000)
923 #define MPT_SGE_FLAGS_CHAIN_ELEMENT             (0x30000000)
924 #define MPT_SGE_FLAGS_ELEMENT_MASK              (0x30000000)
925
926 #define MPT_SGE_FLAGS_SSIMPLE_READ \
927         (MPT_SGE_FLAGS_LAST_ELEMENT |   \
928          MPT_SGE_FLAGS_END_OF_BUFFER |  \
929          MPT_SGE_FLAGS_END_OF_LIST |    \
930          MPT_SGE_FLAGS_SIMPLE_ELEMENT | \
931          MPT_SGE_FLAGS_ADDRESSING | \
932          MPT_TRANSFER_IOC_TO_HOST)
933 #define MPT_SGE_FLAGS_SSIMPLE_WRITE \
934         (MPT_SGE_FLAGS_LAST_ELEMENT |   \
935          MPT_SGE_FLAGS_END_OF_BUFFER |  \
936          MPT_SGE_FLAGS_END_OF_LIST |    \
937          MPT_SGE_FLAGS_SIMPLE_ELEMENT | \
938          MPT_SGE_FLAGS_ADDRESSING | \
939          MPT_TRANSFER_HOST_TO_IOC)
940
941 /*}-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=*/
942 #endif
943