[linux-2.6-block.git] / drivers / block / skd_s1120.h

/*
 * Copyright 2012 STEC, Inc.
 * Copyright (c) 2017 Western Digital Corporation or its affiliates.
 *
 * This file is part of the Linux kernel, and is made available under
 * the terms of the GNU General Public License version 2.
 */


#ifndef SKD_S1120_H
#define SKD_S1120_H

#pragma pack(push, s1120_h, 1)

/*
 * Q-channel, 64-bit r/w
 */
#define FIT_Q_COMMAND			0x400u
#define FIT_QCMD_QID_MASK		(0x3 << 1)
#define  FIT_QCMD_QID0			(0x0 << 1)
#define  FIT_QCMD_QID_NORMAL		FIT_QCMD_QID0
#define  FIT_QCMD_QID1			(0x1 << 1)
#define  FIT_QCMD_QID2			(0x2 << 1)
#define  FIT_QCMD_QID3			(0x3 << 1)
#define  FIT_QCMD_FLUSH_QUEUE		(0ull)	/* add QID */
#define  FIT_QCMD_MSGSIZE_MASK		(0x3 << 4)
#define  FIT_QCMD_MSGSIZE_64		(0x0 << 4)
#define  FIT_QCMD_MSGSIZE_128		(0x1 << 4)
#define  FIT_QCMD_MSGSIZE_256		(0x2 << 4)
#define  FIT_QCMD_MSGSIZE_512		(0x3 << 4)
#define  FIT_QCMD_BASE_ADDRESS_MASK	(0xFFFFFFFFFFFFFFC0ull)

/*
 * Control, 32-bit r/w
 */
#define FIT_CONTROL			0x500u
#define  FIT_CR_HARD_RESET		(1u << 0u)
#define  FIT_CR_SOFT_RESET		(1u << 1u)
#define  FIT_CR_DIS_TIMESTAMPS		(1u << 6u)
#define  FIT_CR_ENABLE_INTERRUPTS	(1u << 7u)

/*
 * Status, 32-bit, r/o
 */
#define FIT_STATUS			0x510u
#define FIT_SR_DRIVE_STATE_MASK		0x000000FFu
#define	FIT_SR_SIGNATURE		(0xFF << 8)
#define	FIT_SR_PIO_DMA			(1 << 16)
#define FIT_SR_DRIVE_OFFLINE		0x00
#define FIT_SR_DRIVE_INIT		0x01
/* #define FIT_SR_DRIVE_READY		0x02 */
#define FIT_SR_DRIVE_ONLINE		0x03
#define FIT_SR_DRIVE_BUSY		0x04
#define FIT_SR_DRIVE_FAULT		0x05
#define FIT_SR_DRIVE_DEGRADED		0x06
#define FIT_SR_PCIE_LINK_DOWN		0x07
#define FIT_SR_DRIVE_SOFT_RESET		0x08
#define FIT_SR_DRIVE_INIT_FAULT		0x09
#define FIT_SR_DRIVE_BUSY_SANITIZE	0x0A
#define FIT_SR_DRIVE_BUSY_ERASE		0x0B
#define FIT_SR_DRIVE_FW_BOOTING		0x0C
#define FIT_SR_DRIVE_NEED_FW_DOWNLOAD	0xFE
#define FIT_SR_DEVICE_MISSING		0xFF
#define FIT_SR__RESERVED		0xFFFFFF00u

/*
 * FIT_STATUS - Status register data definition
 */
#define FIT_SR_STATE_MASK		(0xFF << 0)
#define FIT_SR_SIGNATURE		(0xFF << 8)
#define FIT_SR_PIO_DMA			(1 << 16)

/*
 * Interrupt status, 32-bit r/w1c (w1c ==> write 1 to clear)
 */
#define FIT_INT_STATUS_HOST		0x520u
#define  FIT_ISH_FW_STATE_CHANGE	(1u << 0u)
#define  FIT_ISH_COMPLETION_POSTED	(1u << 1u)
#define  FIT_ISH_MSG_FROM_DEV		(1u << 2u)
#define  FIT_ISH_UNDEFINED_3		(1u << 3u)
#define  FIT_ISH_UNDEFINED_4		(1u << 4u)
#define  FIT_ISH_Q0_FULL		(1u << 5u)
#define  FIT_ISH_Q1_FULL		(1u << 6u)
#define  FIT_ISH_Q2_FULL		(1u << 7u)
#define  FIT_ISH_Q3_FULL		(1u << 8u)
#define  FIT_ISH_QCMD_FIFO_OVERRUN	(1u << 9u)
#define  FIT_ISH_BAD_EXP_ROM_READ	(1u << 10u)

#define FIT_INT_DEF_MASK \
	(FIT_ISH_FW_STATE_CHANGE | \
	 FIT_ISH_COMPLETION_POSTED | \
	 FIT_ISH_MSG_FROM_DEV | \
	 FIT_ISH_Q0_FULL | \
	 FIT_ISH_Q1_FULL | \
	 FIT_ISH_Q2_FULL | \
	 FIT_ISH_Q3_FULL | \
	 FIT_ISH_QCMD_FIFO_OVERRUN | \
	 FIT_ISH_BAD_EXP_ROM_READ)

#define FIT_INT_QUEUE_FULL \
	(FIT_ISH_Q0_FULL | \
	 FIT_ISH_Q1_FULL | \
	 FIT_ISH_Q2_FULL | \
	 FIT_ISH_Q3_FULL)

#define MSI_MSG_NWL_ERROR_0		0x00000000
#define MSI_MSG_NWL_ERROR_1		0x00000001
#define MSI_MSG_NWL_ERROR_2		0x00000002
#define MSI_MSG_NWL_ERROR_3		0x00000003
#define MSI_MSG_STATE_CHANGE		0x00000004
#define MSI_MSG_COMPLETION_POSTED	0x00000005
#define MSI_MSG_MSG_FROM_DEV		0x00000006
#define MSI_MSG_RESERVED_0		0x00000007
#define MSI_MSG_RESERVED_1		0x00000008
#define MSI_MSG_QUEUE_0_FULL		0x00000009
#define MSI_MSG_QUEUE_1_FULL		0x0000000A
#define MSI_MSG_QUEUE_2_FULL		0x0000000B
#define MSI_MSG_QUEUE_3_FULL		0x0000000C

#define FIT_INT_RESERVED_MASK \
	(FIT_ISH_UNDEFINED_3 | \
	 FIT_ISH_UNDEFINED_4)

/*
 * Interrupt mask, 32-bit r/w
 * Bit definitions are the same as FIT_INT_STATUS_HOST
 */
#define FIT_INT_MASK_HOST		0x528u

/*
 * Message to device, 32-bit r/w
 */
#define FIT_MSG_TO_DEVICE		0x540u

/*
 * Message from device, 32-bit, r/o
 */
#define FIT_MSG_FROM_DEVICE		0x548u

/*
 * 32-bit messages to/from device, composition/extraction macros
 */
#define FIT_MXD_CONS(TYPE, PARAM, DATA) \
	((((TYPE)  & 0xFFu) << 24u) | \
	(((PARAM) & 0xFFu) << 16u) | \
	(((DATA)  & 0xFFFFu) << 0u))
#define FIT_MXD_TYPE(MXD)		(((MXD) >> 24u) & 0xFFu)
#define FIT_MXD_PARAM(MXD)		(((MXD) >> 16u) & 0xFFu)
#define FIT_MXD_DATA(MXD)		(((MXD) >> 0u) & 0xFFFFu)

/*
 * Types of messages to/from device
 */
#define FIT_MTD_FITFW_INIT		0x01u
#define FIT_MTD_GET_CMDQ_DEPTH		0x02u
#define FIT_MTD_SET_COMPQ_DEPTH		0x03u
#define FIT_MTD_SET_COMPQ_ADDR		0x04u
#define FIT_MTD_ARM_QUEUE		0x05u
#define FIT_MTD_CMD_LOG_HOST_ID		0x07u
#define FIT_MTD_CMD_LOG_TIME_STAMP_LO	0x08u
#define FIT_MTD_CMD_LOG_TIME_STAMP_HI	0x09u
#define FIT_MFD_SMART_EXCEEDED		0x10u
#define FIT_MFD_POWER_DOWN		0x11u
#define FIT_MFD_OFFLINE			0x12u
#define FIT_MFD_ONLINE			0x13u
#define FIT_MFD_FW_RESTARTING		0x14u
#define FIT_MFD_PM_ACTIVE		0x15u
#define FIT_MFD_PM_STANDBY		0x16u
#define FIT_MFD_PM_SLEEP		0x17u
#define FIT_MFD_CMD_PROGRESS		0x18u

#define FIT_MTD_DEBUG			0xFEu
#define FIT_MFD_DEBUG			0xFFu

#define FIT_MFD_MASK			(0xFFu)
#define FIT_MFD_DATA_MASK		(0xFFu)
#define FIT_MFD_MSG(x)			(((x) >> 24) & FIT_MFD_MASK)
#define FIT_MFD_DATA(x)			((x) & FIT_MFD_MASK)

/*
 * Extra arg to FIT_MSG_TO_DEVICE, 64-bit r/w
 * Used to set completion queue address (FIT_MTD_SET_COMPQ_ADDR)
 * (was Response buffer in docs)
 */
#define FIT_MSG_TO_DEVICE_ARG		0x580u

/*
 * Hardware (ASIC) version, 32-bit r/o
 */
#define FIT_HW_VERSION			0x588u

/*
 * Scatter/gather list descriptor.
 * 32-bytes and must be aligned on a 32-byte boundary.
 * All fields are in little endian order.
 */
struct fit_sg_descriptor {
	uint32_t control;
	uint32_t byte_count;
	uint64_t host_side_addr;
	uint64_t dev_side_addr;
	uint64_t next_desc_ptr;
};

#define FIT_SGD_CONTROL_NOT_LAST	0x000u
#define FIT_SGD_CONTROL_LAST		0x40Eu

/*
 * Header at the beginning of a FIT message. The header
 * is followed by SSDI requests each 64 bytes.
 * A FIT message can be up to 512 bytes long and must start
 * on a 64-byte boundary.
 */
struct fit_msg_hdr {
	uint8_t protocol_id;
	uint8_t num_protocol_cmds_coalesced;
	uint8_t _reserved[62];
};

#define FIT_PROTOCOL_ID_FIT	1
#define FIT_PROTOCOL_ID_SSDI	2
#define FIT_PROTOCOL_ID_SOFIT	3


#define FIT_PROTOCOL_MINOR_VER(mtd_val) ((mtd_val >> 16) & 0xF)
#define FIT_PROTOCOL_MAJOR_VER(mtd_val) ((mtd_val >> 20) & 0xF)

/*
 * Format of a completion entry. The completion queue is circular
 * and must have at least as many entries as the maximum number
 * of commands that may be issued to the device.
 *
 * There are no head/tail pointers. The cycle value is used to
 * infer the presence of new completion records.
 * Initially the cycle in all entries is 0, the index is 0, and
 * the cycle value to expect is 1. When completions are added
 * their cycle values are set to 1. When the index wraps the
 * cycle value to expect is incremented.
 *
 * Command_context is opaque and taken verbatim from the SSDI command.
 * All other fields are big endian.
 */
#define FIT_PROTOCOL_VERSION_0		0

/*
 *  Protocol major version 1 completion entry.
 *  The major protocol version is found in bits
 *  20-23 of the FIT_MTD_FITFW_INIT response.
 */
struct fit_completion_entry_v1 {
	__be32		num_returned_bytes;
	uint16_t	tag;
	uint8_t		status;  /* SCSI status */
	uint8_t		cycle;
};
#define FIT_PROTOCOL_VERSION_1		1
#define FIT_PROTOCOL_VERSION_CURRENT	FIT_PROTOCOL_VERSION_1

struct fit_comp_error_info {
	uint8_t		type:7; /* 00: Bits0-6 indicates the type of sense data. */
	uint8_t		valid:1; /* 00: Bit 7 := 1 ==> info field is valid. */
	uint8_t		reserved0; /* 01: Obsolete field */
	uint8_t		key:4; /* 02: Bits0-3 indicate the sense key. */
	uint8_t		reserved2:1; /* 02: Reserved bit. */
	uint8_t		bad_length:1; /* 02: Incorrect Length Indicator */
	uint8_t		end_medium:1; /* 02: End of Medium */
	uint8_t		file_mark:1; /* 02: Filemark */
	uint8_t		info[4]; /* 03: */
	uint8_t		reserved1; /* 07: Additional Sense Length */
	uint8_t		cmd_spec[4]; /* 08: Command Specific Information */
	uint8_t		code; /* 0C: Additional Sense Code */
	uint8_t		qual; /* 0D: Additional Sense Code Qualifier */
	uint8_t		fruc; /* 0E: Field Replaceable Unit Code */
	uint8_t		sks_high:7; /* 0F: Sense Key Specific (MSB) */
	uint8_t		sks_valid:1; /* 0F: Sense Key Specific Valid */
	uint16_t	sks_low; /* 10: Sense Key Specific (LSW) */
	uint16_t	reserved3; /* 12: Part of additional sense bytes (unused) */
	uint16_t	uec; /* 14: Additional Sense Bytes */
	uint64_t	per; /* 16: Additional Sense Bytes */
	uint8_t		reserved4[2]; /* 1E: Additional Sense Bytes (unused) */
};


/* Task management constants */
#define SOFT_TASK_SIMPLE		0x00
#define SOFT_TASK_HEAD_OF_QUEUE		0x01
#define SOFT_TASK_ORDERED		0x02

/* Version zero has the last 32 bits reserved,
 * Version one has the last 32 bits sg_list_len_bytes;
 */
struct skd_command_header {
	__be64		sg_list_dma_address;
	uint16_t	tag;
	uint8_t		attribute;
	uint8_t		add_cdb_len;     /* In 32 bit words */
	__be32		sg_list_len_bytes;
};

struct skd_scsi_request {
	struct		skd_command_header hdr;
	unsigned char	cdb[16];
/*	unsigned char _reserved[16]; */
};

struct driver_inquiry_data {
	uint8_t		peripheral_device_type:5;
	uint8_t		qualifier:3;
	uint8_t		page_code;
	__be16		page_length;
	__be16		pcie_bus_number;
	uint8_t		pcie_device_number;
	uint8_t		pcie_function_number;
	uint8_t		pcie_link_speed;
	uint8_t		pcie_link_lanes;
	__be16		pcie_vendor_id;
	__be16		pcie_device_id;
	__be16		pcie_subsystem_vendor_id;
	__be16		pcie_subsystem_device_id;
	uint8_t		reserved1[2];
	uint8_t		reserved2[3];
	uint8_t		driver_version_length;
	uint8_t		driver_version[0x14];
};

#pragma pack(pop, s1120_h)

#endif /* SKD_S1120_H */
Commit	Line	Data
bec9e8ac BVA	1	/*
	2	* Copyright 2012 STEC, Inc.
	3	* Copyright (c) 2017 Western Digital Corporation or its affiliates.
e67f86b3	4	*
bec9e8ac BVA	5	* This file is part of the Linux kernel, and is made available under
bec9e8ac BVA	6	* the terms of the GNU General Public License version 2.
e67f86b3 AB	7	*/
	8
	9
	10	#ifndef SKD_S1120_H
	11	#define SKD_S1120_H
	12
	13	#pragma pack(push, s1120_h, 1)
	14
	15	/*
	16	* Q-channel, 64-bit r/w
	17	*/
f1a3c619 BZ	18	#define FIT_Q_COMMAND 0x400u
	19	#define FIT_QCMD_QID_MASK (0x3 << 1)
	20	#define FIT_QCMD_QID0 (0x0 << 1)
	21	#define FIT_QCMD_QID_NORMAL FIT_QCMD_QID0
	22	#define FIT_QCMD_QID1 (0x1 << 1)
	23	#define FIT_QCMD_QID2 (0x2 << 1)
	24	#define FIT_QCMD_QID3 (0x3 << 1)
	25	#define FIT_QCMD_FLUSH_QUEUE (0ull) /* add QID */
	26	#define FIT_QCMD_MSGSIZE_MASK (0x3 << 4)
	27	#define FIT_QCMD_MSGSIZE_64 (0x0 << 4)
	28	#define FIT_QCMD_MSGSIZE_128 (0x1 << 4)
	29	#define FIT_QCMD_MSGSIZE_256 (0x2 << 4)
	30	#define FIT_QCMD_MSGSIZE_512 (0x3 << 4)
	31	#define FIT_QCMD_BASE_ADDRESS_MASK (0xFFFFFFFFFFFFFFC0ull)
e67f86b3 AB	32
	33	/*
	34	* Control, 32-bit r/w
	35	*/
f1a3c619 BZ	36	#define FIT_CONTROL 0x500u
	37	#define FIT_CR_HARD_RESET (1u << 0u)
	38	#define FIT_CR_SOFT_RESET (1u << 1u)
	39	#define FIT_CR_DIS_TIMESTAMPS (1u << 6u)
	40	#define FIT_CR_ENABLE_INTERRUPTS (1u << 7u)
e67f86b3 AB	41
	42	/*
	43	* Status, 32-bit, r/o
	44	*/
	45	#define FIT_STATUS 0x510u
	46	#define FIT_SR_DRIVE_STATE_MASK 0x000000FFu
e67f86b3 AB	47	#define FIT_SR_SIGNATURE (0xFF << 8)
e67f86b3 AB	48	#define FIT_SR_PIO_DMA (1 << 16)
e67f86b3 AB	49	#define FIT_SR_DRIVE_OFFLINE 0x00
	50	#define FIT_SR_DRIVE_INIT 0x01
	51	/* #define FIT_SR_DRIVE_READY 0x02 */
	52	#define FIT_SR_DRIVE_ONLINE 0x03
	53	#define FIT_SR_DRIVE_BUSY 0x04
	54	#define FIT_SR_DRIVE_FAULT 0x05
	55	#define FIT_SR_DRIVE_DEGRADED 0x06
	56	#define FIT_SR_PCIE_LINK_DOWN 0x07
	57	#define FIT_SR_DRIVE_SOFT_RESET 0x08
	58	#define FIT_SR_DRIVE_INIT_FAULT 0x09
	59	#define FIT_SR_DRIVE_BUSY_SANITIZE 0x0A
	60	#define FIT_SR_DRIVE_BUSY_ERASE 0x0B
	61	#define FIT_SR_DRIVE_FW_BOOTING 0x0C
	62	#define FIT_SR_DRIVE_NEED_FW_DOWNLOAD 0xFE
f1a3c619	63	#define FIT_SR_DEVICE_MISSING 0xFF
e67f86b3 AB	64	#define FIT_SR__RESERVED 0xFFFFFF00u
e67f86b3 AB	65
e67f86b3 AB	66	/*
	67	* FIT_STATUS - Status register data definition
	68	*/
f1a3c619 BZ	69	#define FIT_SR_STATE_MASK (0xFF << 0)
	70	#define FIT_SR_SIGNATURE (0xFF << 8)
	71	#define FIT_SR_PIO_DMA (1 << 16)
e67f86b3 AB	72
	73	/*
	74	* Interrupt status, 32-bit r/w1c (w1c ==> write 1 to clear)
	75	*/
f1a3c619 BZ	76	#define FIT_INT_STATUS_HOST 0x520u
	77	#define FIT_ISH_FW_STATE_CHANGE (1u << 0u)
	78	#define FIT_ISH_COMPLETION_POSTED (1u << 1u)
	79	#define FIT_ISH_MSG_FROM_DEV (1u << 2u)
	80	#define FIT_ISH_UNDEFINED_3 (1u << 3u)
	81	#define FIT_ISH_UNDEFINED_4 (1u << 4u)
	82	#define FIT_ISH_Q0_FULL (1u << 5u)
	83	#define FIT_ISH_Q1_FULL (1u << 6u)
	84	#define FIT_ISH_Q2_FULL (1u << 7u)
	85	#define FIT_ISH_Q3_FULL (1u << 8u)
	86	#define FIT_ISH_QCMD_FIFO_OVERRUN (1u << 9u)
	87	#define FIT_ISH_BAD_EXP_ROM_READ (1u << 10u)
	88
	89	#define FIT_INT_DEF_MASK \
	90	(FIT_ISH_FW_STATE_CHANGE \| \
	91	FIT_ISH_COMPLETION_POSTED \| \
	92	FIT_ISH_MSG_FROM_DEV \| \
	93	FIT_ISH_Q0_FULL \| \
	94	FIT_ISH_Q1_FULL \| \
	95	FIT_ISH_Q2_FULL \| \
	96	FIT_ISH_Q3_FULL \| \
	97	FIT_ISH_QCMD_FIFO_OVERRUN \| \
	98	FIT_ISH_BAD_EXP_ROM_READ)
	99
	100	#define FIT_INT_QUEUE_FULL \
	101	(FIT_ISH_Q0_FULL \| \
	102	FIT_ISH_Q1_FULL \| \
	103	FIT_ISH_Q2_FULL \| \
	104	FIT_ISH_Q3_FULL)
	105
	106	#define MSI_MSG_NWL_ERROR_0 0x00000000
	107	#define MSI_MSG_NWL_ERROR_1 0x00000001
	108	#define MSI_MSG_NWL_ERROR_2 0x00000002
	109	#define MSI_MSG_NWL_ERROR_3 0x00000003
	110	#define MSI_MSG_STATE_CHANGE 0x00000004
	111	#define MSI_MSG_COMPLETION_POSTED 0x00000005
	112	#define MSI_MSG_MSG_FROM_DEV 0x00000006
	113	#define MSI_MSG_RESERVED_0 0x00000007
	114	#define MSI_MSG_RESERVED_1 0x00000008
	115	#define MSI_MSG_QUEUE_0_FULL 0x00000009
	116	#define MSI_MSG_QUEUE_1_FULL 0x0000000A
	117	#define MSI_MSG_QUEUE_2_FULL 0x0000000B
	118	#define MSI_MSG_QUEUE_3_FULL 0x0000000C
	119
	120	#define FIT_INT_RESERVED_MASK \
	121	(FIT_ISH_UNDEFINED_3 \| \
	122	FIT_ISH_UNDEFINED_4)
	123
e67f86b3 AB	124	/*
	125	* Interrupt mask, 32-bit r/w
	126	* Bit definitions are the same as FIT_INT_STATUS_HOST
	127	*/
f1a3c619	128	#define FIT_INT_MASK_HOST 0x528u
e67f86b3 AB	129
	130	/*
	131	* Message to device, 32-bit r/w
	132	*/
f1a3c619	133	#define FIT_MSG_TO_DEVICE 0x540u
e67f86b3 AB	134
	135	/*
	136	* Message from device, 32-bit, r/o
	137	*/
f1a3c619	138	#define FIT_MSG_FROM_DEVICE 0x548u
e67f86b3 AB	139
	140	/*
	141	* 32-bit messages to/from device, composition/extraction macros
	142	*/
	143	#define FIT_MXD_CONS(TYPE, PARAM, DATA) \
	144	((((TYPE) & 0xFFu) << 24u) \| \
	145	(((PARAM) & 0xFFu) << 16u) \| \
	146	(((DATA) & 0xFFFFu) << 0u))
f1a3c619 BZ	147	#define FIT_MXD_TYPE(MXD) (((MXD) >> 24u) & 0xFFu)
	148	#define FIT_MXD_PARAM(MXD) (((MXD) >> 16u) & 0xFFu)
	149	#define FIT_MXD_DATA(MXD) (((MXD) >> 0u) & 0xFFFFu)
e67f86b3 AB	150
	151	/*
	152	* Types of messages to/from device
	153	*/
f1a3c619 BZ	154	#define FIT_MTD_FITFW_INIT 0x01u
	155	#define FIT_MTD_GET_CMDQ_DEPTH 0x02u
	156	#define FIT_MTD_SET_COMPQ_DEPTH 0x03u
	157	#define FIT_MTD_SET_COMPQ_ADDR 0x04u
	158	#define FIT_MTD_ARM_QUEUE 0x05u
	159	#define FIT_MTD_CMD_LOG_HOST_ID 0x07u
	160	#define FIT_MTD_CMD_LOG_TIME_STAMP_LO 0x08u
	161	#define FIT_MTD_CMD_LOG_TIME_STAMP_HI 0x09u
	162	#define FIT_MFD_SMART_EXCEEDED 0x10u
	163	#define FIT_MFD_POWER_DOWN 0x11u
	164	#define FIT_MFD_OFFLINE 0x12u
	165	#define FIT_MFD_ONLINE 0x13u
	166	#define FIT_MFD_FW_RESTARTING 0x14u
	167	#define FIT_MFD_PM_ACTIVE 0x15u
	168	#define FIT_MFD_PM_STANDBY 0x16u
	169	#define FIT_MFD_PM_SLEEP 0x17u
	170	#define FIT_MFD_CMD_PROGRESS 0x18u
	171
	172	#define FIT_MTD_DEBUG 0xFEu
	173	#define FIT_MFD_DEBUG 0xFFu
e67f86b3 AB	174
	175	#define FIT_MFD_MASK (0xFFu)
	176	#define FIT_MFD_DATA_MASK (0xFFu)
	177	#define FIT_MFD_MSG(x) (((x) >> 24) & FIT_MFD_MASK)
	178	#define FIT_MFD_DATA(x) ((x) & FIT_MFD_MASK)
	179
e67f86b3 AB	180	/*
	181	* Extra arg to FIT_MSG_TO_DEVICE, 64-bit r/w
	182	* Used to set completion queue address (FIT_MTD_SET_COMPQ_ADDR)
	183	* (was Response buffer in docs)
	184	*/
f1a3c619	185	#define FIT_MSG_TO_DEVICE_ARG 0x580u
e67f86b3 AB	186
	187	/*
	188	* Hardware (ASIC) version, 32-bit r/o
	189	*/
f1a3c619	190	#define FIT_HW_VERSION 0x588u
e67f86b3 AB	191
	192	/*
	193	* Scatter/gather list descriptor.
	194	* 32-bytes and must be aligned on a 32-byte boundary.
	195	* All fields are in little endian order.
	196	*/
	197	struct fit_sg_descriptor {
	198	uint32_t control;
	199	uint32_t byte_count;
	200	uint64_t host_side_addr;
	201	uint64_t dev_side_addr;
	202	uint64_t next_desc_ptr;
	203	};
	204
f1a3c619 BZ	205	#define FIT_SGD_CONTROL_NOT_LAST 0x000u
f1a3c619 BZ	206	#define FIT_SGD_CONTROL_LAST 0x40Eu
e67f86b3 AB	207
	208	/*
	209	* Header at the beginning of a FIT message. The header
	210	* is followed by SSDI requests each 64 bytes.
	211	* A FIT message can be up to 512 bytes long and must start
	212	* on a 64-byte boundary.
	213	*/
	214	struct fit_msg_hdr {
	215	uint8_t protocol_id;
	216	uint8_t num_protocol_cmds_coalesced;
	217	uint8_t _reserved[62];
	218	};
	219
f1a3c619 BZ	220	#define FIT_PROTOCOL_ID_FIT 1
	221	#define FIT_PROTOCOL_ID_SSDI 2
	222	#define FIT_PROTOCOL_ID_SOFIT 3
e67f86b3 AB	223
	224
	225	#define FIT_PROTOCOL_MINOR_VER(mtd_val) ((mtd_val >> 16) & 0xF)
	226	#define FIT_PROTOCOL_MAJOR_VER(mtd_val) ((mtd_val >> 20) & 0xF)
	227
e67f86b3 AB	228	/*
	229	* Format of a completion entry. The completion queue is circular
	230	* and must have at least as many entries as the maximum number
	231	* of commands that may be issued to the device.
	232	*
	233	* There are no head/tail pointers. The cycle value is used to
	234	* infer the presence of new completion records.
	235	* Initially the cycle in all entries is 0, the index is 0, and
	236	* the cycle value to expect is 1. When completions are added
	237	* their cycle values are set to 1. When the index wraps the
	238	* cycle value to expect is incremented.
	239	*
	240	* Command_context is opaque and taken verbatim from the SSDI command.
	241	* All other fields are big endian.
	242	*/
f1a3c619	243	#define FIT_PROTOCOL_VERSION_0 0
e67f86b3 AB	244
	245	/*
	246	* Protocol major version 1 completion entry.
	247	* The major protocol version is found in bits
	248	* 20-23 of the FIT_MTD_FITFW_INIT response.
	249	*/
	250	struct fit_completion_entry_v1 {
4854afe3	251	__be32 num_returned_bytes;
e67f86b3 AB	252	uint16_t tag;
	253	uint8_t status; /* SCSI status */
	254	uint8_t cycle;
	255	};
f1a3c619 BZ	256	#define FIT_PROTOCOL_VERSION_1 1
f1a3c619 BZ	257	#define FIT_PROTOCOL_VERSION_CURRENT FIT_PROTOCOL_VERSION_1
e67f86b3 AB	258
	259	struct fit_comp_error_info {
	260	uint8_t type:7; /* 00: Bits0-6 indicates the type of sense data. */
	261	uint8_t valid:1; /* 00: Bit 7 := 1 ==> info field is valid. */
	262	uint8_t reserved0; /* 01: Obsolete field */
	263	uint8_t key:4; /* 02: Bits0-3 indicate the sense key. */
	264	uint8_t reserved2:1; /* 02: Reserved bit. */
	265	uint8_t bad_length:1; /* 02: Incorrect Length Indicator */
	266	uint8_t end_medium:1; /* 02: End of Medium */
	267	uint8_t file_mark:1; /* 02: Filemark */
	268	uint8_t info[4]; /* 03: */
	269	uint8_t reserved1; /* 07: Additional Sense Length */
	270	uint8_t cmd_spec[4]; /* 08: Command Specific Information */
	271	uint8_t code; /* 0C: Additional Sense Code */
	272	uint8_t qual; /* 0D: Additional Sense Code Qualifier */
	273	uint8_t fruc; /* 0E: Field Replaceable Unit Code */
	274	uint8_t sks_high:7; /* 0F: Sense Key Specific (MSB) */
	275	uint8_t sks_valid:1; /* 0F: Sense Key Specific Valid */
	276	uint16_t sks_low; /* 10: Sense Key Specific (LSW) */
	277	uint16_t reserved3; /* 12: Part of additional sense bytes (unused) */
	278	uint16_t uec; /* 14: Additional Sense Bytes */
	279	uint64_t per; /* 16: Additional Sense Bytes */
	280	uint8_t reserved4[2]; /* 1E: Additional Sense Bytes (unused) */
	281	};
	282
	283
	284	/* Task management constants */
f1a3c619 BZ	285	#define SOFT_TASK_SIMPLE 0x00
	286	#define SOFT_TASK_HEAD_OF_QUEUE 0x01
	287	#define SOFT_TASK_ORDERED 0x02
e67f86b3 AB	288
	289	/* Version zero has the last 32 bits reserved,
	290	* Version one has the last 32 bits sg_list_len_bytes;
	291	*/
	292	struct skd_command_header {
4854afe3	293	__be64 sg_list_dma_address;
e67f86b3 AB	294	uint16_t tag;
	295	uint8_t attribute;
	296	uint8_t add_cdb_len; /* In 32 bit words */
4854afe3	297	__be32 sg_list_len_bytes;
e67f86b3 AB	298	};
	299
	300	struct skd_scsi_request {
	301	struct skd_command_header hdr;
	302	unsigned char cdb[16];
	303	/* unsigned char _reserved[16]; */
	304	};
	305
	306	struct driver_inquiry_data {
	307	uint8_t peripheral_device_type:5;
	308	uint8_t qualifier:3;
	309	uint8_t page_code;
4854afe3 BVA	310	__be16 page_length;
4854afe3 BVA	311	__be16 pcie_bus_number;
e67f86b3 AB	312	uint8_t pcie_device_number;
	313	uint8_t pcie_function_number;
	314	uint8_t pcie_link_speed;
	315	uint8_t pcie_link_lanes;
4854afe3 BVA	316	__be16 pcie_vendor_id;
	317	__be16 pcie_device_id;
	318	__be16 pcie_subsystem_vendor_id;
	319	__be16 pcie_subsystem_device_id;
e67f86b3 AB	320	uint8_t reserved1[2];
	321	uint8_t reserved2[3];
	322	uint8_t driver_version_length;
	323	uint8_t driver_version[0x14];
	324	};
	325
	326	#pragma pack(pop, s1120_h)
	327
	328	#endif /* SKD_S1120_H */