[deliverable/linux.git] / drivers / block / cciss_cmd.h

#ifndef CCISS_CMD_H
#define CCISS_CMD_H
//###########################################################################
//DEFINES
//###########################################################################
#define CISS_VERSION "1.00"

//general boundary defintions
#define SENSEINFOBYTES          32//note that this value may vary between host implementations
#define MAXSGENTRIES            31
#define MAXREPLYQS              256

//Command Status value
#define CMD_SUCCESS             0x0000
#define CMD_TARGET_STATUS       0x0001
#define CMD_DATA_UNDERRUN       0x0002
#define CMD_DATA_OVERRUN        0x0003
#define CMD_INVALID             0x0004
#define CMD_PROTOCOL_ERR        0x0005
#define CMD_HARDWARE_ERR        0x0006
#define CMD_CONNECTION_LOST     0x0007
#define CMD_ABORTED             0x0008
#define CMD_ABORT_FAILED        0x0009
#define CMD_UNSOLICITED_ABORT   0x000A
#define CMD_TIMEOUT             0x000B
#define CMD_UNABORTABLE		0x000C

/* Unit Attentions ASC's as defined for the MSA2012sa */
#define POWER_OR_RESET			0x29
#define STATE_CHANGED			0x2a
#define UNIT_ATTENTION_CLEARED		0x2f
#define LUN_FAILED			0x3e
#define REPORT_LUNS_CHANGED		0x3f

/* Unit Attentions ASCQ's as defined for the MSA2012sa */

	/* These ASCQ's defined for ASC = POWER_OR_RESET */
#define POWER_ON_RESET			0x00
#define POWER_ON_REBOOT			0x01
#define SCSI_BUS_RESET			0x02
#define MSA_TARGET_RESET		0x03
#define CONTROLLER_FAILOVER		0x04
#define TRANSCEIVER_SE			0x05
#define TRANSCEIVER_LVD			0x06

	/* These ASCQ's defined for ASC = STATE_CHANGED */
#define RESERVATION_PREEMPTED		0x03
#define ASYM_ACCESS_CHANGED		0x06
#define LUN_CAPACITY_CHANGED		0x09

//transfer direction
#define XFER_NONE               0x00
#define XFER_WRITE              0x01
#define XFER_READ               0x02
#define XFER_RSVD               0x03

//task attribute
#define ATTR_UNTAGGED           0x00
#define ATTR_SIMPLE             0x04
#define ATTR_HEADOFQUEUE        0x05
#define ATTR_ORDERED            0x06
#define ATTR_ACA                0x07

//cdb type
#define TYPE_CMD				0x00
#define TYPE_MSG				0x01

//config space register offsets
#define CFG_VENDORID            0x00
#define CFG_DEVICEID            0x02
#define CFG_I2OBAR              0x10
#define CFG_MEM1BAR             0x14

//i2o space register offsets
#define I2O_IBDB_SET            0x20
#define I2O_IBDB_CLEAR          0x70
#define I2O_INT_STATUS          0x30
#define I2O_INT_MASK            0x34
#define I2O_IBPOST_Q            0x40
#define I2O_OBPOST_Q            0x44
#define I2O_DMA1_CFG		0x214

//Configuration Table
#define CFGTBL_ChangeReq        0x00000001l
#define CFGTBL_AccCmds          0x00000001l

#define CFGTBL_Trans_Simple     0x00000002l

#define CFGTBL_BusType_Ultra2   0x00000001l
#define CFGTBL_BusType_Ultra3   0x00000002l
#define CFGTBL_BusType_Fibre1G  0x00000100l
#define CFGTBL_BusType_Fibre2G  0x00000200l
typedef struct _vals32
{
        __u32   lower;
        __u32   upper;
} vals32;

typedef union _u64bit
{
   vals32	val32;
   __u64	val;
} u64bit;

// Type defs used in the following structs
#define BYTE __u8
#define WORD __u16
#define HWORD __u16
#define DWORD __u32
#define QWORD vals32 

//###########################################################################
//STRUCTURES
//###########################################################################
#define CISS_MAX_LUN	1024
#define CISS_MAX_PHYS_LUN	1024
// SCSI-3 Cmmands 

#pragma pack(1)	

#define CISS_INQUIRY 0x12
//Date returned
typedef struct _InquiryData_struct
{
  BYTE data_byte[36];
} InquiryData_struct;

#define CISS_REPORT_LOG 0xc2    /* Report Logical LUNs */
#define CISS_REPORT_PHYS 0xc3   /* Report Physical LUNs */
// Data returned
typedef struct _ReportLUNdata_struct
{
  BYTE LUNListLength[4];
  DWORD reserved;
  BYTE LUN[CISS_MAX_LUN][8];
} ReportLunData_struct;

#define CCISS_READ_CAPACITY 0x25 /* Read Capacity */ 
typedef struct _ReadCapdata_struct
{
  BYTE total_size[4];	// Total size in blocks
  BYTE block_size[4];	// Size of blocks in bytes
} ReadCapdata_struct;

#define CCISS_READ_CAPACITY_16 0x9e /* Read Capacity 16 */

/* service action to differentiate a 16 byte read capacity from
   other commands that use the 0x9e SCSI op code */

#define CCISS_READ_CAPACITY_16_SERVICE_ACT 0x10

typedef struct _ReadCapdata_struct_16
{
	BYTE total_size[8];   /* Total size in blocks */
	BYTE block_size[4];   /* Size of blocks in bytes */
	BYTE prot_en:1;       /* protection enable bit */
	BYTE rto_en:1;        /* reference tag own enable bit */
	BYTE reserved:6;      /* reserved bits */
	BYTE reserved2[18];   /* reserved bytes per spec */
} ReadCapdata_struct_16;

/* Define the supported read/write commands for cciss based controllers */

#define CCISS_READ_10   0x28    /* Read(10)  */
#define CCISS_WRITE_10  0x2a    /* Write(10) */
#define CCISS_READ_16   0x88    /* Read(16)  */
#define CCISS_WRITE_16  0x8a    /* Write(16) */

/* Define the CDB lengths supported by cciss based controllers */

#define CDB_LEN10	10
#define CDB_LEN16	16

// BMIC commands 
#define BMIC_READ 0x26
#define BMIC_WRITE 0x27
#define BMIC_CACHE_FLUSH 0xc2
#define CCISS_CACHE_FLUSH 0x01	//C2 was already being used by CCISS

//Command List Structure
typedef union _SCSI3Addr_struct {
   struct {
    BYTE Dev;
    BYTE Bus:6;
    BYTE Mode:2;        // b00
  } PeripDev;
   struct {
    BYTE DevLSB;
    BYTE DevMSB:6;
    BYTE Mode:2;        // b01
  } LogDev;
   struct {
    BYTE Dev:5;
    BYTE Bus:3;
    BYTE Targ:6;
    BYTE Mode:2;        // b10
  } LogUnit;
} SCSI3Addr_struct;

typedef struct _PhysDevAddr_struct {
  DWORD             TargetId:24;
  DWORD             Bus:6;
  DWORD             Mode:2;
  SCSI3Addr_struct  Target[2]; //2 level target device addr
} PhysDevAddr_struct;
  
typedef struct _LogDevAddr_struct {
  DWORD            VolId:30;
  DWORD            Mode:2;
  BYTE             reserved[4];
} LogDevAddr_struct;

typedef union _LUNAddr_struct {
  BYTE               LunAddrBytes[8];
  SCSI3Addr_struct   SCSI3Lun[4];
  PhysDevAddr_struct PhysDev;
  LogDevAddr_struct  LogDev;
} LUNAddr_struct;

#define CTLR_LUNID "\0\0\0\0\0\0\0\0"

typedef struct _CommandListHeader_struct {
  BYTE              ReplyQueue;
  BYTE              SGList;
  HWORD             SGTotal;
  QWORD             Tag;
  LUNAddr_struct    LUN;
} CommandListHeader_struct;
typedef struct _RequestBlock_struct {
  BYTE   CDBLen;
  struct {
    BYTE Type:3;
    BYTE Attribute:3;
    BYTE Direction:2;
  } Type;
  HWORD  Timeout;
  BYTE   CDB[16];
} RequestBlock_struct;
typedef struct _ErrDescriptor_struct {
  QWORD  Addr;
  DWORD  Len;
} ErrDescriptor_struct;
typedef struct _SGDescriptor_struct {
  QWORD  Addr;
  DWORD  Len;
  DWORD  Ext;
} SGDescriptor_struct;

typedef union _MoreErrInfo_struct{
  struct {
    BYTE  Reserved[3];
    BYTE  Type;
    DWORD ErrorInfo;
  }Common_Info;
  struct{
    BYTE  Reserved[2];
    BYTE  offense_size;//size of offending entry
    BYTE  offense_num; //byte # of offense 0-base
    DWORD offense_value;
  }Invalid_Cmd;
}MoreErrInfo_struct;
typedef struct _ErrorInfo_struct {
  BYTE               ScsiStatus;
  BYTE               SenseLen;
  HWORD              CommandStatus;
  DWORD              ResidualCnt;
  MoreErrInfo_struct MoreErrInfo;
  BYTE               SenseInfo[SENSEINFOBYTES];
} ErrorInfo_struct;

/* Command types */
#define CMD_RWREQ       0x00
#define CMD_IOCTL_PEND  0x01
#define CMD_SCSI	0x03
#define CMD_MSG_DONE	0x04
#define CMD_MSG_TIMEOUT 0x05
#define CMD_MSG_STALE	0xff

/* This structure needs to be divisible by 8 for new
 * indexing method.
 */
#define PADSIZE (sizeof(long) - 4)
typedef struct _CommandList_struct {
  CommandListHeader_struct Header;
  RequestBlock_struct      Request;
  ErrDescriptor_struct     ErrDesc;
  SGDescriptor_struct      SG[MAXSGENTRIES];
	/* information associated with the command */ 
  __u32			   busaddr; /* physical address of this record */
  ErrorInfo_struct * 	   err_info; /* pointer to the allocated mem */ 
  int			   ctlr;
  int			   cmd_type; 
  long			   cmdindex;
  struct hlist_node list;
  struct request *	   rq;
  struct completion *waiting;
  int	 retry_count;
  void * scsi_cmd;
  char   pad[PADSIZE];
} CommandList_struct;

//Configuration Table Structure
typedef struct _HostWrite_struct {
  DWORD TransportRequest;
  DWORD Reserved;
  DWORD CoalIntDelay;
  DWORD CoalIntCount;
} HostWrite_struct;

typedef struct _CfgTable_struct {
  BYTE             Signature[4];
  DWORD            SpecValence;
  DWORD            TransportSupport;
  DWORD            TransportActive;
  HostWrite_struct HostWrite;
  DWORD            CmdsOutMax;
  DWORD            BusTypes;
  DWORD            Reserved; 
  BYTE             ServerName[16];
  DWORD            HeartBeat;
  DWORD            SCSI_Prefetch;
} CfgTable_struct;
#pragma pack()	 
#endif // CCISS_CMD_H
Commit	Line	Data
1da177e4 LT	1	#ifndef CCISS_CMD_H
	2	#define CCISS_CMD_H
	3	//###########################################################################
	4	//DEFINES
	5	//###########################################################################
	6	#define CISS_VERSION "1.00"
	7
	8	//general boundary defintions
	9	#define SENSEINFOBYTES 32//note that this value may vary between host implementations
	10	#define MAXSGENTRIES 31
	11	#define MAXREPLYQS 256
	12
	13	//Command Status value
	14	#define CMD_SUCCESS 0x0000
	15	#define CMD_TARGET_STATUS 0x0001
	16	#define CMD_DATA_UNDERRUN 0x0002
	17	#define CMD_DATA_OVERRUN 0x0003
	18	#define CMD_INVALID 0x0004
	19	#define CMD_PROTOCOL_ERR 0x0005
	20	#define CMD_HARDWARE_ERR 0x0006
	21	#define CMD_CONNECTION_LOST 0x0007
	22	#define CMD_ABORTED 0x0008
	23	#define CMD_ABORT_FAILED 0x0009
	24	#define CMD_UNSOLICITED_ABORT 0x000A
	25	#define CMD_TIMEOUT 0x000B
	26	#define CMD_UNABORTABLE 0x000C
	27
0a9279cc MM	28	/* Unit Attentions ASC's as defined for the MSA2012sa */
	29	#define POWER_OR_RESET 0x29
	30	#define STATE_CHANGED 0x2a
	31	#define UNIT_ATTENTION_CLEARED 0x2f
	32	#define LUN_FAILED 0x3e
	33	#define REPORT_LUNS_CHANGED 0x3f
	34
	35	/* Unit Attentions ASCQ's as defined for the MSA2012sa */
	36
	37	/* These ASCQ's defined for ASC = POWER_OR_RESET */
	38	#define POWER_ON_RESET 0x00
	39	#define POWER_ON_REBOOT 0x01
	40	#define SCSI_BUS_RESET 0x02
	41	#define MSA_TARGET_RESET 0x03
	42	#define CONTROLLER_FAILOVER 0x04
	43	#define TRANSCEIVER_SE 0x05
	44	#define TRANSCEIVER_LVD 0x06
	45
	46	/* These ASCQ's defined for ASC = STATE_CHANGED */
	47	#define RESERVATION_PREEMPTED 0x03
	48	#define ASYM_ACCESS_CHANGED 0x06
	49	#define LUN_CAPACITY_CHANGED 0x09
	50
1da177e4 LT	51	//transfer direction
	52	#define XFER_NONE 0x00
	53	#define XFER_WRITE 0x01
	54	#define XFER_READ 0x02
	55	#define XFER_RSVD 0x03
	56
	57	//task attribute
	58	#define ATTR_UNTAGGED 0x00
	59	#define ATTR_SIMPLE 0x04
	60	#define ATTR_HEADOFQUEUE 0x05
	61	#define ATTR_ORDERED 0x06
	62	#define ATTR_ACA 0x07
	63
	64	//cdb type
	65	#define TYPE_CMD 0x00
	66	#define TYPE_MSG 0x01
	67
	68	//config space register offsets
	69	#define CFG_VENDORID 0x00
	70	#define CFG_DEVICEID 0x02
	71	#define CFG_I2OBAR 0x10
	72	#define CFG_MEM1BAR 0x14
	73
	74	//i2o space register offsets
	75	#define I2O_IBDB_SET 0x20
	76	#define I2O_IBDB_CLEAR 0x70
	77	#define I2O_INT_STATUS 0x30
	78	#define I2O_INT_MASK 0x34
	79	#define I2O_IBPOST_Q 0x40
	80	#define I2O_OBPOST_Q 0x44
f92e2f5f	81	#define I2O_DMA1_CFG 0x214
1da177e4 LT	82
	83	//Configuration Table
	84	#define CFGTBL_ChangeReq 0x00000001l
	85	#define CFGTBL_AccCmds 0x00000001l
	86
	87	#define CFGTBL_Trans_Simple 0x00000002l
	88
	89	#define CFGTBL_BusType_Ultra2 0x00000001l
	90	#define CFGTBL_BusType_Ultra3 0x00000002l
	91	#define CFGTBL_BusType_Fibre1G 0x00000100l
	92	#define CFGTBL_BusType_Fibre2G 0x00000200l
	93	typedef struct _vals32
	94	{
	95	__u32 lower;
	96	__u32 upper;
	97	} vals32;
	98
	99	typedef union _u64bit
	100	{
	101	vals32 val32;
	102	__u64 val;
	103	} u64bit;
	104
	105	// Type defs used in the following structs
	106	#define BYTE __u8
	107	#define WORD __u16
	108	#define HWORD __u16
	109	#define DWORD __u32
	110	#define QWORD vals32
	111
	112	//###########################################################################
	113	//STRUCTURES
	114	//###########################################################################
799202cb	115	#define CISS_MAX_LUN 1024
1da177e4 LT	116	#define CISS_MAX_PHYS_LUN 1024
	117	// SCSI-3 Cmmands
	118
	119	#pragma pack(1)
	120
	121	#define CISS_INQUIRY 0x12
	122	//Date returned
	123	typedef struct _InquiryData_struct
	124	{
	125	BYTE data_byte[36];
	126	} InquiryData_struct;
	127
	128	#define CISS_REPORT_LOG 0xc2 /* Report Logical LUNs */
	129	#define CISS_REPORT_PHYS 0xc3 /* Report Physical LUNs */
	130	// Data returned
	131	typedef struct _ReportLUNdata_struct
	132	{
	133	BYTE LUNListLength[4];
	134	DWORD reserved;
	135	BYTE LUN[CISS_MAX_LUN][8];
	136	} ReportLunData_struct;
	137
	138	#define CCISS_READ_CAPACITY 0x25 /* Read Capacity */
	139	typedef struct _ReadCapdata_struct
	140	{
	141	BYTE total_size[4]; // Total size in blocks
	142	BYTE block_size[4]; // Size of blocks in bytes
	143	} ReadCapdata_struct;
	144
00988a35 MMOD	145	#define CCISS_READ_CAPACITY_16 0x9e /* Read Capacity 16 */
	146
	147	/* service action to differentiate a 16 byte read capacity from
	148	other commands that use the 0x9e SCSI op code */
	149
	150	#define CCISS_READ_CAPACITY_16_SERVICE_ACT 0x10
	151
	152	typedef struct _ReadCapdata_struct_16
	153	{
	154	BYTE total_size[8]; /* Total size in blocks */
	155	BYTE block_size[4]; /* Size of blocks in bytes */
	156	BYTE prot_en:1; /* protection enable bit */
	157	BYTE rto_en:1; /* reference tag own enable bit */
	158	BYTE reserved:6; /* reserved bits */
	159	BYTE reserved2[18]; /* reserved bytes per spec */
	160	} ReadCapdata_struct_16;
	161
	162	/* Define the supported read/write commands for cciss based controllers */
	163
	164	#define CCISS_READ_10 0x28 /* Read(10) */
	165	#define CCISS_WRITE_10 0x2a /* Write(10) */
	166	#define CCISS_READ_16 0x88 /* Read(16) */
	167	#define CCISS_WRITE_16 0x8a /* Write(16) */
	168
	169	/* Define the CDB lengths supported by cciss based controllers */
	170
	171	#define CDB_LEN10 10
	172	#define CDB_LEN16 16
1da177e4 LT	173
	174	// BMIC commands
	175	#define BMIC_READ 0x26
	176	#define BMIC_WRITE 0x27
	177	#define BMIC_CACHE_FLUSH 0xc2
	178	#define CCISS_CACHE_FLUSH 0x01 //C2 was already being used by CCISS
	179
	180	//Command List Structure
	181	typedef union _SCSI3Addr_struct {
	182	struct {
	183	BYTE Dev;
	184	BYTE Bus:6;
	185	BYTE Mode:2; // b00
	186	} PeripDev;
	187	struct {
	188	BYTE DevLSB;
	189	BYTE DevMSB:6;
	190	BYTE Mode:2; // b01
	191	} LogDev;
	192	struct {
	193	BYTE Dev:5;
	194	BYTE Bus:3;
	195	BYTE Targ:6;
	196	BYTE Mode:2; // b10
	197	} LogUnit;
	198	} SCSI3Addr_struct;
	199
	200	typedef struct _PhysDevAddr_struct {
	201	DWORD TargetId:24;
	202	DWORD Bus:6;
	203	DWORD Mode:2;
	204	SCSI3Addr_struct Target[2]; //2 level target device addr
	205	} PhysDevAddr_struct;
	206
	207	typedef struct _LogDevAddr_struct {
	208	DWORD VolId:30;
	209	DWORD Mode:2;
	210	BYTE reserved[4];
	211	} LogDevAddr_struct;
	212
	213	typedef union _LUNAddr_struct {
	214	BYTE LunAddrBytes[8];
	215	SCSI3Addr_struct SCSI3Lun[4];
	216	PhysDevAddr_struct PhysDev;
	217	LogDevAddr_struct LogDev;
	218	} LUNAddr_struct;
	219
b57695fe	220	#define CTLR_LUNID "\0\0\0\0\0\0\0\0"
b57695fe	221
1da177e4 LT	222	typedef struct _CommandListHeader_struct {
	223	BYTE ReplyQueue;
	224	BYTE SGList;
	225	HWORD SGTotal;
	226	QWORD Tag;
	227	LUNAddr_struct LUN;
	228	} CommandListHeader_struct;
	229	typedef struct _RequestBlock_struct {
	230	BYTE CDBLen;
	231	struct {
	232	BYTE Type:3;
	233	BYTE Attribute:3;
	234	BYTE Direction:2;
	235	} Type;
	236	HWORD Timeout;
	237	BYTE CDB[16];
	238	} RequestBlock_struct;
	239	typedef struct _ErrDescriptor_struct {
	240	QWORD Addr;
	241	DWORD Len;
	242	} ErrDescriptor_struct;
	243	typedef struct _SGDescriptor_struct {
	244	QWORD Addr;
	245	DWORD Len;
	246	DWORD Ext;
	247	} SGDescriptor_struct;
	248
	249	typedef union _MoreErrInfo_struct{
	250	struct {
	251	BYTE Reserved[3];
	252	BYTE Type;
	253	DWORD ErrorInfo;
	254	}Common_Info;
	255	struct{
	256	BYTE Reserved[2];
	257	BYTE offense_size;//size of offending entry
	258	BYTE offense_num; //byte # of offense 0-base
	259	DWORD offense_value;
	260	}Invalid_Cmd;
	261	}MoreErrInfo_struct;
	262	typedef struct _ErrorInfo_struct {
	263	BYTE ScsiStatus;
	264	BYTE SenseLen;
	265	HWORD CommandStatus;
	266	DWORD ResidualCnt;
	267	MoreErrInfo_struct MoreErrInfo;
	268	BYTE SenseInfo[SENSEINFOBYTES];
	269	} ErrorInfo_struct;
	270
	271	/* Command types */
	272	#define CMD_RWREQ 0x00
	273	#define CMD_IOCTL_PEND 0x01
	274	#define CMD_SCSI 0x03
	275	#define CMD_MSG_DONE 0x04
	276	#define CMD_MSG_TIMEOUT 0x05
b59e64d0	277	#define CMD_MSG_STALE 0xff
1da177e4	278
33079b21 MM	279	/* This structure needs to be divisible by 8 for new
	280	* indexing method.
	281	*/
	282	#define PADSIZE (sizeof(long) - 4)
1da177e4 LT	283	typedef struct _CommandList_struct {
	284	CommandListHeader_struct Header;
	285	RequestBlock_struct Request;
	286	ErrDescriptor_struct ErrDesc;
	287	SGDescriptor_struct SG[MAXSGENTRIES];
	288	/* information associated with the command */
	289	__u32 busaddr; /* physical address of this record */
	290	ErrorInfo_struct * err_info; /* pointer to the allocated mem */
	291	int ctlr;
	292	int cmd_type;
33079b21	293	long cmdindex;
8a3173de	294	struct hlist_node list;
1da177e4 LT	295	struct request * rq;
	296	struct completion *waiting;
	297	int retry_count;
1da177e4	298	void * scsi_cmd;
33079b21	299	char pad[PADSIZE];
1da177e4 LT	300	} CommandList_struct;
	301
	302	//Configuration Table Structure
	303	typedef struct _HostWrite_struct {
	304	DWORD TransportRequest;
	305	DWORD Reserved;
	306	DWORD CoalIntDelay;
	307	DWORD CoalIntCount;
	308	} HostWrite_struct;
	309
	310	typedef struct _CfgTable_struct {
	311	BYTE Signature[4];
	312	DWORD SpecValence;
	313	DWORD TransportSupport;
	314	DWORD TransportActive;
	315	HostWrite_struct HostWrite;
	316	DWORD CmdsOutMax;
	317	DWORD BusTypes;
	318	DWORD Reserved;
	319	BYTE ServerName[16];
	320	DWORD HeartBeat;
	321	DWORD SCSI_Prefetch;
	322	} CfgTable_struct;
	323	#pragma pack()
	324	#endif // CCISS_CMD_H