spcdefs.h revision 296373
1/*******************************************************************************
2*Copyright (c) 2014 PMC-Sierra, Inc.  All rights reserved.
3*
4*Redistribution and use in source and binary forms, with or without modification, are permitted provided
5*that the following conditions are met:
6*1. Redistributions of source code must retain the above copyright notice, this list of conditions and the
7*following disclaimer.
8*2. Redistributions in binary form must reproduce the above copyright notice,
9*this list of conditions and the following disclaimer in the documentation and/or other materials provided
10*with the distribution.
11*
12*THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED
13*WARRANTIES,INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
14*FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
15*FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
16*NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
17*BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
18*LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
19*SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE
20*
21* $FreeBSD$
22*
23********************************************************************************/
24/*******************************************************************************/
25/*! \file spcdefs.h
26 *  \brief The file defines the MPI Application Programming Interface (API)
27 *
28 * The file defines the MPI Application Programming Interfacde (API)
29 *
30 */
31/*******************************************************************************/
32#ifndef __SPCDEFS_H__
33#define __SPCDEFS_H__
34
35/*******************************************************************************/
36/*******************************************************************************/
37/* CONSTANTS                                                                    */
38/*******************************************************************************/
39/*******************************************************************************/
40/*******************************************************************************/
41/* MSGU CONFIGURATION TABLE                                                    */
42/*******************************************************************************/
43#define SPC_MSGU_CFG_TABLE_UPDATE               0x001   /* Inbound doorbell bit0 */
44#define SPC_MSGU_CFG_TABLE_RESET                0x002   /* Inbound doorbell bit1 */
45#define SPC_MSGU_CFG_TABLE_FREEZE               0x004   /* Inbound doorbell bit2 */
46#define SPC_MSGU_CFG_TABLE_UNFREEZE             0x008   /* Inbound doorbell bit4 */
47#define SPCV_MSGU_CFG_TABLE_TRANSFER_DEBUG_INFO 0x080   /* Inbound doorbell bit7 SPCV */
48#define SPCV_MSGU_HALT_CPUS                     0x100   /* Inbound doorbell bit8 SPCV */
49
50/***** Notes *****/
51/* The firmware side is using Little Endian (MIPs). */
52/* So anything sending or receiving from FW must be in Little Endian */
53/*******************************************************************************/
54/** \struct mpiMsgHeader_s
55 *  \brief MPI message header
56 *
57 * The mpiMsgHeader_s defines the fields in the header of every message
58 */
59/*******************************************************************************/
60/* This structire defines the fields in the header of every message */
61
62
63struct mpiMsgHeader_s
64{
65  bit32 Header;             /* Bits [11:0]  - Message operation code */
66                            /* Bits [15:12] - Message Category */
67                            /* Bits [21:16] - Outboundqueue ID for the operation completion message */
68                            /* Bits [23:22] - Reserved */
69                            /* Bits [28:24] - Buffer Count, indicates how many buffer are allocated for the massage */
70                            /* Bits [30:29] - Reserved */
71                            /* Bits [31]    - Message Valid bit */
72};
73
74typedef struct mpiMsgHeader_s  mpiMsgHeader_t;
75
76#define V_BIT          0x1
77
78#define V_MASK         0x1
79#define BC_MASK        0x1F
80#define OBID_MASK      0x3F
81#define CAT_MASK       0x0F
82#define OPCODE_MASK    0xFFF
83#define HEADER_V_MASK  0x80000000
84#define HEADER_BC_MASK 0x1f000000
85
86#ifndef SPC_CONFIG
87/*******************************************************************************/
88/** \struct spc_ConfigMainDescriptor_s
89 *  \brief This structure is used to configure main part of Configuration Table
90 *
91 * This structure specifies all required attributes to configuration table
92 */
93/*******************************************************************************/
94/* new MPI configuration main table */
95struct  spc_configMainDescriptor_s
96{
97  bit8  Signature[4];                      /**< DW0 signature - Indicate coherent table */
98  bit32 InterfaceRev;                      /**< DW1 Revsion of Interface */
99  bit32 FWRevision;                        /**< DW2 Revsion of FW */
100  bit32 MaxOutstandingIO;                  /**< DW3 Max outstanding IO */
101  bit32 MDevMaxSGL;                        /**< DW4 Maximum SGL elements  & Max Devices */
102        /* bit0-15  Maximum SGL */
103        /* bit16-31 Maximum Devices */
104  bit32 ContrlCapFlag;                     /**< DW5 Controller Capability */
105        /* bit0-7   Max number of inbound queue */
106        /* bit8-15  Max number of outbound queue */
107        /* bit16    high priority of inbound queue is supported */
108        /* bit17    reserved */
109        /* bit18    interrupt coalescing is supported, SPCV-reserved */
110        /* bit19-24 Maximum number of valid phys */
111        /* bit25-31 SAS Revision SPecification */
112  bit32 GSTOffset;                         /**< DW6 General Status Table */
113  bit32 inboundQueueOffset;                /**< DW7 inbound configuration table offset */
114        /* bit23-0  inbound queue table offset */
115        /* bit31-24 entry size, new in SPCV */
116  bit32 outboundQueueOffset;               /**< DW8 outbound configuration table offset */
117        /* bit23-0  outbound queue table offset */
118        /* bit31-24 entry size, new in SPCV */
119  bit32 iQNPPD_HPPD_GEvent;                /**< DW9 inbound Queue Process depth and General Event */
120        /* bit0-7   inbound normal priority process depth */
121        /* bit8-15  inbound high priority process depth */
122        /* bit16-23 OQ number to receive GENERAL_EVENT Notification */
123        /* bit24-31 OQ number to receive DEVICE_HANDLE_REMOVAL Notification */
124  bit32 outboundHWEventPID0_3;             /**< DWA outbound HW event for PortId 0 to 3, SPCV-reserved */
125        /* bit0-7   outbound queue number of SAS_HW event for PhyId 0 */
126        /* bit8-15  outbound queue number of SAS_HW event for PhyId 1 */
127        /* bit16-23 outbound queue number of SAS_HW event for PhyId 2 */
128        /* bit24-31 outbound queue number of SAS_HW event for PhyId 3 */
129  bit32 outboundHWEventPID4_7;             /**< DWB outbound HW event for PortId 4 to 7, SPCV-reserved */
130        /* bit0-7   outbound queue number of SAS_HW event for PhyId 4 */
131        /* bit8-15  outbound queue number of SAS_HW event for PhyId 5 */
132        /* bit16-23 outbound queue number of SAS_HW event for PhyId 6 */
133        /* bit24-31 outbound queue number of SAS_HW event for PhyId 7 */
134  bit32 outboundNCQEventPID0_3;            /**< DWC outbound NCQ event for PortId 0 to 3, SPCV-reserved */
135        /* bit0-7   outbound queue number of SATA_NCQ event for PhyId 0 */
136        /* bit8-15  outbound queue number of SATA_NCQ event for PhyId 1 */
137        /* bit16-23 outbound queue number of SATA_NCQ event for PhyId 2 */
138        /* bit24-31 outbound queue number of SATA_NCQ event for PortId 3 */
139  bit32 outboundNCQEventPID4_7;            /**< DWD outbound NCQ event for PortId 4 to 7, SPCV-reserved*/
140        /* bit0-7   outbound queue number of SATA_NCQ event for PhyId 4 */
141        /* bit8-15  outbound queue number of SATA_NCQ event for PhyId 5 */
142        /* bit16-23 outbound queue number of SATA_NCQ event for PhyId 6 */
143        /* bit24-31 outbound queue number of SATA_NCQ event for PhyId 7 */
144  bit32 outboundTargetITNexusEventPID0_3;  /**< DWE outbound target ITNexus Event for PortId 0 to 3, SPCV-reserved */
145        /* bit0-7   outbound queue number of ITNexus event for PhyId 0 */
146        /* bit8-15  outbound queue number of ITNexus event for PhyId 1 */
147        /* bit16-23 outbound queue number of ITNexus event for PhyId 2 */
148        /* bit24-31 outbound queue number of ITNexus event for PhyId 3 */
149  bit32 outboundTargetITNexusEventPID4_7;  /**< DWF outbound target ITNexus Event for PortId 4 to 7, SPCV-reserved */
150        /* bit0-7   outbound queue number of ITNexus event for PhyId 4 */
151        /* bit8-15  outbound queue number of ITNexus event for PhyId 5 */
152        /* bit16-23 outbound queue number of ITNexus event for PhyId 6 */
153        /* bit24-31 outbound queue number of ITNexus event for PhyId 7 */
154  bit32 outboundTargetSSPEventPID0_3;      /**< DW10 outbound target SSP event for PordId 0 to 3, SPCV-reserved */
155        /* bit0-7   outbound queue number of SSP event for PhyId 0 */
156        /* bit8-15  outbound queue number of SSP event for PhyId 1 */
157        /* bit16-23 outbound queue number of SSP event for PhyId 2 */
158        /* bit24-31 outbound queue number of SSP event for PhyId 3 */
159  bit32 outboundTargetSSPEventPID4_7;      /**< DW11 outbound target SSP event for PordId 4 to 7, SPCV-reserved */
160        /* bit0-7   outbound queue number of SSP event for PhyId 4 */
161        /* bit8-15  outbound queue number of SSP event for PhyId 5 */
162        /* bit16-23 outbound queue number of SSP event for PhyId 6 */
163        /* bit24-31 outbound queue number of SSP event for PhyId 7 */
164  bit32 ioAbortDelay;                      /**< DW12 IO Abort Delay (bit15:0) MPI_TABLE_CHANGE*/
165  bit32 custset;                           /**< DW13 custset */
166  bit32 upperEventLogAddress;              /**< DW14 Upper physical MSGU Event log address */
167  bit32 lowerEventLogAddress;              /**< DW15 Lower physical MSGU Event log address */
168  bit32 eventLogSize;                      /**< DW16 Size of MSGU Event log, 0 means log disable */
169  bit32 eventLogOption;                    /**< DW17 Option of MSGU Event log */
170        /* bit3-0 log severity, 0x0 Disable Logging */
171        /*                      0x1 Critical Error */
172        /*                      0x2 Minor Error    */
173        /*                      0x3 Warning        */
174        /*                      0x4 Information    */
175        /*                      0x5 Debugging      */
176        /*                      0x6 - 0xF Reserved */
177  bit32 upperIOPeventLogAddress;           /**< DW18 Upper physical IOP Event log address */
178  bit32 lowerIOPeventLogAddress;           /**< DW19 Lower physical IOP Event log address */
179  bit32 IOPeventLogSize;                   /**< DW1A Size of IOP Event log, 0 means log disable */
180  bit32 IOPeventLogOption;                 /**< DW1B Option of IOP Event log */
181        /* bit3-0 log severity, 0x0 Critical Error */
182        /*                      0x1 Minor Error    */
183        /*                      0x2 Warning        */
184        /*                      0x3 Information    */
185        /*                      0x4 Unknown        */
186        /*                      0x5 - 0xF Reserved */
187  bit32 FatalErrorInterrupt;               /**< DW1C Fatal Error Interrupt enable and vector */
188        /* bit0     Fatal Error Interrupt Enable   */
189        /* bit1     PI/CI 64bit address            */
190        /* bit2     SGPIO IOMB support */
191        /* bit6-2   Reserved                       */
192        /* bit7     OQ NP/HPriority Path enable    */
193        /* bit15-8  Fatal Error Interrupt Vector   */
194        /* bit16    Enable IQ/OQ 64                */
195        /* bit17    Interrupt Reassertion Enable   */
196        /* bit18    Interrupt Reassertion Delay in ms          */
197        /* bit31-19 Interrupt Reassertion delay, 0-default 1ms */
198  bit32 FatalErrorDumpOffset0;             /**< DW1D FERDOMS-GU Fatal Error Register Dump Offset for MSGU */
199  bit32 FatalErrorDumpLength0;             /**< DW1E FERDLMS-GU Fatal Error Register Dump Length for MSGU */
200  bit32 FatalErrorDumpOffset1;             /**< DW1F FERDO-SSTRUCPCS Fatal Error Register Dump Offset for IOP */
201  bit32 FatalErrorDumpLength1;             /**< DW20 FERDLSTRUCTTPCS  Fatal Error Register Dump Length for IOP */
202  bit32 HDAModeFlags;                      /**< DW21 HDA Mode Flags, SPCV-reserved */
203  bit32 analogSetupTblOffset;              /**< DW22 SPASTO Phy Calibration Table offset */
204        /* bit23-0  phy calib table offset */
205        /* bit31-24 entry size */
206  bit32 InterruptVecTblOffset;             /**< DW23 Interrupt Vector Table MPI_TABLE_CHANG */
207        /* bit23-0  interrupt vector table offset */
208        /* bit31-24 entry size */
209  bit32 phyAttributeTblOffset;             /**< DW24 SAS Phy Attribute Table Offset MPI_TABLE_CHANG*/
210        /* bit23-0  phy attribute table offset */
211        /* bit31-24 entry size */
212  bit32 portRecoveryResetTimer;            /* Offset 0x25 [31:16] Port recovery timer default that is 0
213                                              used for all SAS ports. Granularity of this timer is 100ms. The host can
214                                              change the individual port recovery timer by using the PORT_CONTROL
215                                              [15:0] Port reset timer default that is used 3 (i.e 300ms) for all
216                                              SAS ports. Granularity of this timer is 100ms. Host can change the
217                                              individual port recovery timer by using PORT_CONTROL Command */
218  bit32 interruptReassertionDelay;         /* Offset 0x26 [23:0] Remind host of outbound completion 0 disabled 100usec per increment */
219
220  bit32     ilaRevision;                   /* Offset 0x27 */
221};
222
223/* main configuration offset - byte offset */
224#define MAIN_SIGNATURE_OFFSET          0x00    /* DWORD 0x00 (R) */
225#define MAIN_INTERFACE_REVISION        0x04    /* DWORD 0x01 (R) */
226#define MAIN_FW_REVISION               0x08    /* DWORD 0x02 (R) */
227#define MAIN_MAX_OUTSTANDING_IO_OFFSET 0x0C    /* DWORD 0x03 (R) */
228#define MAIN_MAX_SGL_OFFSET            0x10    /* DWORD 0x04 (R) */
229#define MAIN_CNTRL_CAP_OFFSET          0x14    /* DWORD 0x05 (R) */
230#define MAIN_GST_OFFSET                0x18    /* DWORD 0x06 (R) */
231#define MAIN_IBQ_OFFSET                0x1C    /* DWORD 0x07 (R) */
232#define MAIN_OBQ_OFFSET                0x20    /* DWORD 0x08 (R) */
233#define MAIN_IQNPPD_HPPD_OFFSET        0x24    /* DWORD 0x09 (W) */
234#define MAIN_OB_HW_EVENT_PID03_OFFSET  0x28    /* DWORD 0x0A (W) */ /* reserved for SPCV */
235#define MAIN_OB_HW_EVENT_PID47_OFFSET  0x2C    /* DWORD 0x0B (W) */ /* reserved for SPCV */
236#define MAIN_OB_NCQ_EVENT_PID03_OFFSET 0x30    /* DWORD 0x0C (W) */ /* reserved for SPCV */
237#define MAIN_OB_NCQ_EVENT_PID47_OFFSET 0x34    /* DWORD 0x0D (W) */ /* reserved for SPCV */
238#define MAIN_TITNX_EVENT_PID03_OFFSET  0x38    /* DWORD 0x0E (W) */ /* reserved for SPCV */
239#define MAIN_TITNX_EVENT_PID47_OFFSET  0x3C    /* DWORD 0x0F (W) */ /* reserved for SPCV */
240#define MAIN_OB_SSP_EVENT_PID03_OFFSET 0x40    /* DWORD 0x10 (W) */ /* reserved for SPCV */
241#define MAIN_OB_SSP_EVENT_PID47_OFFSET 0x44    /* DWORD 0x11 (W) */ /* reserved for SPCV */
242#define MAIN_IO_ABORT_DELAY            0x48    /* DWORD 0x12 (W) */ /* reserved for SPCV */
243#define MAIN_CUSTOMER_SETTING          0x4C    /* DWORD 0x13 (W) */ /* reserved for SPCV */
244#define MAIN_EVENT_LOG_ADDR_HI         0x50    /* DWORD 0x14 (W) */
245#define MAIN_EVENT_LOG_ADDR_LO         0x54    /* DWORD 0x15 (W) */
246#define MAIN_EVENT_LOG_BUFF_SIZE       0x58    /* DWORD 0x16 (W) */
247#define MAIN_EVENT_LOG_OPTION          0x5C    /* DWORD 0x17 (W) */
248#define MAIN_IOP_EVENT_LOG_ADDR_HI     0x60    /* DWORD 0x18 (W) */
249#define MAIN_IOP_EVENT_LOG_ADDR_LO     0x64    /* DWORD 0x19 (W) */
250#define MAIN_IOP_EVENT_LOG_BUFF_SIZE   0x68    /* DWORD 0x1A (W) */
251#define MAIN_IOP_EVENT_LOG_OPTION      0x6C    /* DWORD 0x1B (W) */
252#define MAIN_FATAL_ERROR_INTERRUPT     0x70    /* DWORD 0x1C (W) */
253#define MAIN_FATAL_ERROR_RDUMP0_OFFSET 0x74    /* DWORD 0x1D (R) */
254#define MAIN_FATAL_ERROR_RDUMP0_LENGTH 0x78    /* DWORD 0x1E (R) */
255#define MAIN_FATAL_ERROR_RDUMP1_OFFSET 0x7C    /* DWORD 0x1F (R) */
256#define MAIN_FATAL_ERROR_RDUMP1_LENGTH 0x80    /* DWORD 0x20 (R) */
257#define MAIN_HDA_FLAGS_OFFSET          0x84    /* DWORD 0x21 (R) */ /* reserved for SPCV */
258#define MAIN_ANALOG_SETUP_OFFSET       0x88    /* DWORD 0x22 (R) */
259#define MAIN_INT_VEC_TABLE_OFFSET      0x8C    /* DWORD 0x23 (W) */ /*  for SPCV */
260#define MAIN_PHY_ATTRIBUTE_OFFSET      0x90    /* DWORD 0x24 (W) */ /*  for SPCV */
261#define MAIN_PRECTD_PRESETD            0x94    /* DWORD 0x25 (W) */ /*  for SPCV */
262#define MAIN_IRAD_RESERVED             0x98    /* DWORD 0x26 (W) */ /*  for SPCV */
263#define MAIN_MOQFOT_MOQFOES            0x9C    /* DWORD 0x27 (W) */ /*  for SPCV */
264#define MAIN_MERRDCTO_MERRDCES         0xA0    /* DWORD 0x28 (W) */ /*  for SPCV */
265#define MAIN_ILAT_ILAV_ILASMRN_ILAMRN_ILAMJN  0xA4 /* DWORD 0x29 (W) */ /*  for SPCV */
266#define MAIN_INACTIVE_ILA_REVSION      0xA8    /* DWORD 0x2A (W) */ /*  for SPCV V 3.02 */
267#define MAIN_SEEPROM_REVSION           0xAC    /* DWORD 0x2B (W) */ /*  for SPCV V 3.02 */
268#define MAIN_UNKNOWN1                  0xB0    /* DWORD 0x2C (W) */ /*  for SPCV V 3.03 */
269#define MAIN_UNKNOWN2                  0xB4    /* DWORD 0x2D (W) */ /*  for SPCV V 3.03 */
270#define MAIN_UNKNOWN3                  0xB8    /* DWORD 0x2E (W) */ /*  for SPCV V 3.03 */
271#define MAIN_XCBI_REF_TAG_PAT          0xBC    /* DWORD 0x2F (W) */ /*  for SPCV V 3.03 */
272#define MAIN_AWT_MIDRANGE              0xC0    /* DWORD 0x30 (W) */ /*  for SPCV V 3.03 */
273
274
275typedef struct spc_configMainDescriptor_s spc_configMainDescriptor_t;
276#define SPC_CONFIG
277#endif
278
279/* bit to disable end to end crc checking ins SPCv */
280#define MAIN_IO_ABORT_DELAY_END_TO_END_CRC_DISABLE 0x00010000
281
282/* bit mask for field Controller Capability in main part */
283#define MAIN_MAX_IB_MASK               0x000000ff  /* bit7-0 */
284#define MAIN_MAX_OB_MASK               0x0000ff00  /* bit15-8 */
285#define MAIN_PHY_COUNT_MASK            0x01f80000  /* bit24-19 */
286#define MAIN_QSUPPORT_BITS             0x0007ffff
287#define MAIN_SAS_SUPPORT_BITS          0xfe000000
288
289/* bit mask for field max sgl in main part */
290#define MAIN_MAX_SGL_BITS              0xFFFF
291#define MAIN_MAX_DEV_BITS              0xFFFF0000
292
293/* bit mask for HDA flags field */
294#define MAIN_HDA_FLAG_BITS             0x000000FF
295
296#define FATAL_ERROR_INT_BITS           0xFF
297#define INT_REASRT_ENABLE              0x00020000
298#define INT_REASRT_MS_ENABLE           0x00040000
299#define INT_REASRT_DELAY_BITS          0xFFF80000
300
301#define MAX_VALID_PHYS                 8
302#define IB_QUEUE_CFGSIZE               64
303#define OB_QUEUE_CFGSIZE               64
304
305/* inbound queue configuration offset - byte offset */
306#define IB_PROPERITY_OFFSET            0x00
307#define IB_BASE_ADDR_HI_OFFSET         0x04
308#define IB_BASE_ADDR_LO_OFFSET         0x08
309#define IB_CI_BASE_ADDR_HI_OFFSET      0x0C
310#define IB_CI_BASE_ADDR_LO_OFFSET      0x10
311#define IB_PIPCI_BAR                   0x14
312#define IB_PIPCI_BAR_OFFSET            0x18
313#define IB_RESERVED_OFFSET             0x1C
314
315/* outbound queue configuration offset - byte offset */
316#define OB_PROPERITY_OFFSET            0x00
317#define OB_BASE_ADDR_HI_OFFSET         0x04
318#define OB_BASE_ADDR_LO_OFFSET         0x08
319#define OB_PI_BASE_ADDR_HI_OFFSET      0x0C
320#define OB_PI_BASE_ADDR_LO_OFFSET      0x10
321#define OB_CIPCI_BAR                   0x14
322#define OB_CIPCI_BAR_OFFSET            0x18
323#define OB_INTERRUPT_COALES_OFFSET     0x1C
324#define OB_DYNAMIC_COALES_OFFSET       0x20
325
326#define OB_PROPERTY_INT_ENABLE         0x40000000
327
328/* General Status Table offset - byte offset */
329#define GST_GSTLEN_MPIS_OFFSET         0x00
330#define GST_IQ_FREEZE_STATE0_OFFSET    0x04
331#define GST_IQ_FREEZE_STATE1_OFFSET    0x08
332#define GST_MSGUTCNT_OFFSET            0x0C
333#define GST_IOPTCNT_OFFSET             0x10
334#define GST_IOP1TCNT_OFFSET            0x14
335#define GST_PHYSTATE_OFFSET            0x18  /* SPCV reserved */
336#define GST_PHYSTATE0_OFFSET           0x18  /* SPCV reserved */
337#define GST_PHYSTATE1_OFFSET           0x1C  /* SPCV reserved */
338#define GST_PHYSTATE2_OFFSET           0x20  /* SPCV reserved */
339#define GST_PHYSTATE3_OFFSET           0x24  /* SPCV reserved */
340#define GST_PHYSTATE4_OFFSET           0x28  /* SPCV reserved */
341#define GST_PHYSTATE5_OFFSET           0x2C  /* SPCV reserved */
342#define GST_PHYSTATE6_OFFSET           0x30  /* SPCV reserved */
343#define GST_PHYSTATE7_OFFSET           0x34  /* SPCV reserved */
344#define GST_GPIO_PINS_OFFSET           0x38
345#define GST_RERRINFO_OFFSET            0x44
346
347/* General Status Table - MPI state */
348#define GST_MPI_STATE_UNINIT           0x00
349#define GST_MPI_STATE_INIT             0x01
350#define GST_MPI_STATE_TERMINATION      0x02
351#define GST_MPI_STATE_ERROR            0x03
352#define GST_MPI_STATE_MASK             0x07
353
354#define GST_INF_STATE_BITS             0xfffe0007
355
356
357/* MPI fatal and non fatal offset mask */
358#define MPI_FATAL_ERROR_TABLE_OFFSET_MASK 0xFFFFFF
359#define MPI_FATAL_ERROR_TABLE_SIZE(value) ((0xFF000000 & value) >> SHIFT24)    /*  for SPCV */
360
361/* MPI fatal and non fatal Error dump capture table offset - byte offset */
362#define MPI_FATAL_EDUMP_TABLE_LO_OFFSET            0x00     /* HNFBUFL */
363#define MPI_FATAL_EDUMP_TABLE_HI_OFFSET            0x04     /* HNFBUFH */
364#define MPI_FATAL_EDUMP_TABLE_LENGTH               0x08     /* HNFBLEN */
365#define MPI_FATAL_EDUMP_TABLE_HANDSHAKE            0x0C     /* FDDHSHK */
366#define MPI_FATAL_EDUMP_TABLE_STATUS               0x10     /* FDDTSTAT */
367#define MPI_FATAL_EDUMP_TABLE_ACCUM_LEN            0x14     /* ACCDDLEN */
368/*  */
369#define MPI_FATAL_EDUMP_HANDSHAKE_RDY              0x1
370#define MPI_FATAL_EDUMP_HANDSHAKE_BUSY             0x0
371/*  */
372#define MPI_FATAL_EDUMP_TABLE_STAT_RSVD                 0x0
373#define MPI_FATAL_EDUMP_TABLE_STAT_DMA_FAILED           0x1
374#define MPI_FATAL_EDUMP_TABLE_STAT_NF_SUCCESS_MORE_DATA 0x2
375#define MPI_FATAL_EDUMP_TABLE_STAT_NF_SUCCESS_DONE      0x3
376
377#define IOCTL_ERROR_NO_FATAL_ERROR           0x77
378
379/*******************************************************************************/
380/** \struct spc_GSTableDescriptor_s
381 *  \brief This structure is used for SPC MPI General Status Table
382 *
383 * This structure specifies all required attributes to Gereral Status Table
384 */
385/*******************************************************************************/
386struct spc_GSTableDescriptor_s
387{
388  bit32    GSTLenMPIS;           /**< DW0 - GST Length, MPI State */
389                                  /**< bit02-00 MPI state */
390                                  /**< 000 - not initialized, 001 - initialized,
391                                       010 - Configuration termination in progress */
392                                  /**< bit3 - IQ Frozen */
393                                  /**< bit15-04 GST Length */
394                                  /**< bit31-16 MPI-S Initialize Error */
395  bit32    IQFreezeState0;       /**< DW1 - Inbound Queue Freeze State0 */
396  bit32    IQFreezeState1;       /**< DW2 - Inbound Qeue Freeze State1 */
397  bit32    MsguTcnt;             /**< DW3 - MSGU Tick count */
398  bit32    IopTcnt;              /**< DW4 - IOP Tick count */
399  bit32    Iop1Tcnt;             /**< DW5 - IOP1 Tick count */
400  bit32    PhyState[MAX_VALID_PHYS];  /* SPCV = reserved */
401                                 /**< DW6 to DW 0D - Phy Link state 0 to 7, Phy Start State 0 to 7 */
402                                  /**< bit00 Phy Start state n, 0 not started, 1 started */
403                                  /**< bit01 Phy Link state n, 0 link down, 1 link up */
404                                  /**< bit31-2 Reserved */
405  bit32    GPIOpins;             /**< DWE - GPIO pins */
406  bit32    reserved1;            /**< DWF - reserved */
407  bit32    reserved2;            /**< DW10 - reserved */
408  bit32    recoverErrInfo[8];    /**< DW11 to DW18 - Recoverable Error Information */
409};
410
411typedef struct spc_GSTableDescriptor_s spc_GSTableDescriptor_t;
412
413/*******************************************************************************/
414/** \struct spc_SPASTable_s
415 *  \brief SAS Phy Analog Setup Table
416 *
417 * The spc_SPASTable_s structure is used to set Phy Calibration
418 * attributes
419 */
420/*******************************************************************************/
421struct spc_SPASTable_s
422{
423  bit32   spaReg0;            /* transmitter per port configuration 1 SAS_SATA G1 */
424  bit32   spaReg1;            /* transmitter per port configuration 2 SAS_SATA G1*/
425  bit32   spaReg2;            /* transmitter per port configuration 3 SAS_SATA G1*/
426  bit32   spaReg3;            /* transmitter configuration 1 */
427  bit32   spaReg4;            /* reveiver per port configuration 1 SAS_SATA G1G2 */
428  bit32   spaReg5;            /* reveiver per port configuration 2 SAS_SATA G3 */
429  bit32   spaReg6;            /* reveiver per configuration 1 */
430  bit32   spaReg7;            /* reveiver per configuration 2 */
431  bit32   reserved[2];        /* reserved */
432};
433
434typedef struct spc_SPASTable_s spc_SPASTable_t;
435
436/*******************************************************************************/
437/** \struct spc_inboundQueueDescriptor_s
438 *  \brief This structure is used to configure inbound queues
439 *
440 * This structure specifies all required attributes to configure inbound queues
441 */
442/*******************************************************************************/
443struct spc_inboundQueueDescriptor_s
444{
445  bit32    elementPriSizeCount;  /**< Priority, Size, Count in the queue */
446                                  /**< bit00-15 Count */
447                                  /**< When set to 0, this queue is disabled */
448                                  /**< bit16-29 Size */
449                                  /**< bit30-31 Priority 00:Normal, 01:High Priority */
450  bit32    upperBaseAddress;     /**< Upper address bits for the queue message buffer pool */
451  bit32    lowerBaseAddress;     /**< Lower address bits for the queue message buffer pool */
452  bit32    ciUpperBaseAddress;   /**< Upper physical address for inbound queue CI */
453  bit32    ciLowerBaseAddress;   /**< Lower physical address for inbound queue CI */
454  bit32    PIPCIBar;             /**< PCI BAR for PI Offset */
455  bit32    PIOffset;             /**< Offset address for inbound queue PI */
456  bit32    reserved;             /**< reserved */
457};
458
459typedef struct spc_inboundQueueDescriptor_s spc_inboundQueueDescriptor_t;
460
461/*******************************************************************************/
462/** \struct spc_outboundQueueDescriptor_s
463 *  \brief This structure is used to configure outbound queues
464 *
465 * This structure specifies all required attributes to configure outbound queues
466 */
467/*******************************************************************************/
468struct spc_outboundQueueDescriptor_s
469{
470  bit32    elementSizeCount;      /**< Size & Count of each element (slot) in the queue) */
471                                   /**< bit00-15 Count */
472                                   /**< When set to 0, this queue is disabled */
473                                   /**< bit16-29 Size */
474                                   /**< bit30    Interrupt enable/disable */
475                                   /**< bit31    reserved */
476  bit32    upperBaseAddress;      /**< Upper address bits for the queue message buffer pool */
477  bit32    lowerBaseAddress;      /**< Lower address bits for the queue message buffer pool */
478  bit32    piUpperBaseAddress;    /**< PI Upper Base Address for outbound queue */
479  bit32    piLowerBaseAddress;    /**< PI Lower Base Address for outbound queue */
480  bit32    CIPCIBar;              /**< PCI BAR for CI Offset */
481  bit32    CIOffset;              /**< Offset address for outbound queue CI */
482  bit32    interruptVecCntDelay;  /**< Delay in microseconds before the interrupt is asserted */
483                                   /**< if the interrupt threshold has not been reached */
484                                   /**< Number of interrupt events before the interrupt is asserted */
485                                   /**< If set to 0, interrupts for this queue are disable */
486                                   /**< Interrupt vector number for this queue */
487                                   /**< Note that the interrupt type can be MSI or MSI-X */
488                                   /**< depending on the system configuration */
489                                   /**< bit00-15 Delay */
490                                   /**< bit16-23 Count */
491                                   /**< bit24-31 Vector */
492  bit32    DInterruptTOPCIOffset; /**< Dynamic Interrupt Coalescing Timeout PCI Bar Offset */
493};
494
495typedef struct spc_outboundQueueDescriptor_s spc_outboundQueueDescriptor_t;
496
497typedef struct InterruptVT_s
498{
499  bit32 iccict;        /**< DW0 - Interrupt Colescing Control and Timer */
500  bit32 iraeirad;      /**< DW1 - Interrupt Reassertion Enable/Delay */
501} InterruptVT_t;
502
503typedef struct mpiInterruptVT_s
504{
505  InterruptVT_t IntVecTble[MAX_NUM_VECTOR << 1];
506} mpiInterruptVT_t;
507
508#define INT_VT_Coal_CNT_TO 0
509#define INT_VT_Coal_ReAssert_Enab 4
510
511typedef struct phyAttrb_s
512{
513  bit32    phyState;
514  bit32    phyEventOQ;
515} phyAttrb_t;
516
517typedef struct sasPhyAttribute_s
518{
519  phyAttrb_t phyAttribute[MAX_VALID_PHYS];
520}sasPhyAttribute_t;
521
522
523#define PHY_STATE    0
524#define PHY_EVENT_OQ 4
525
526/*******************************************************************************/
527/** \struct spcMSGUConfig_s
528 *  \brief This structure is used to configure controller's message unit
529 *
530 */
531/*******************************************************************************/
532typedef struct fwMSGUConfig_s
533{
534  spc_configMainDescriptor_t      mainConfiguration;                /**< main part of Configuration Table */
535  spc_GSTableDescriptor_t         GeneralStatusTable;               /**< MPI general status table */
536  spc_inboundQueueDescriptor_t    inboundQueue[IB_QUEUE_CFGSIZE];   /**< Inbound queue configuration array */
537  spc_outboundQueueDescriptor_t   outboundQueue[OB_QUEUE_CFGSIZE];  /**< Outbound queue configuration array */
538  agsaPhyAnalogSetupTable_t       phyAnalogConfig;
539  mpiInterruptVT_t                interruptVTable;
540  sasPhyAttribute_t               phyAttributeTable;
541}fwMSGUConfig_t;
542
543
544typedef void (*EnadDisabHandler_t)(
545                            agsaRoot_t  *agRoot,
546                            bit32       interruptVectorIndex
547                              );
548
549typedef bit32 (*InterruptOurs_t)(
550                            agsaRoot_t  *agRoot,
551                            bit32       interruptVectorIndex
552                              );
553#endif /* __SPC_DEFS__ */
554