[mirror_ubuntu-zesty-kernel.git] / drivers / scsi / cxlflash / sislite.h

/*
 * CXL Flash Device Driver
 *
 * Written by: Manoj N. Kumar <manoj@linux.vnet.ibm.com>, IBM Corporation
 *             Matthew R. Ochs <mrochs@linux.vnet.ibm.com>, IBM Corporation
 *
 * Copyright (C) 2015 IBM Corporation
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * as published by the Free Software Foundation; either version
 * 2 of the License, or (at your option) any later version.
 */

#ifndef _SISLITE_H
#define _SISLITE_H

#include <linux/types.h>

typedef u16 ctx_hndl_t;
typedef u32 res_hndl_t;

#define SIZE_4K		4096
#define SIZE_64K	65536

/*
 * IOARCB: 64 bytes, min 16 byte alignment required, host native endianness
 * except for SCSI CDB which remains big endian per SCSI standards.
 */
struct sisl_ioarcb {
	u16 ctx_id;		/* ctx_hndl_t */
	u16 req_flags;
#define SISL_REQ_FLAGS_RES_HNDL       0x8000U	/* bit 0 (MSB) */
#define SISL_REQ_FLAGS_PORT_LUN_ID    0x0000U

#define SISL_REQ_FLAGS_SUP_UNDERRUN   0x4000U	/* bit 1 */

#define SISL_REQ_FLAGS_TIMEOUT_SECS   0x0000U	/* bits 8,9 */
#define SISL_REQ_FLAGS_TIMEOUT_MSECS  0x0040U
#define SISL_REQ_FLAGS_TIMEOUT_USECS  0x0080U
#define SISL_REQ_FLAGS_TIMEOUT_CYCLES 0x00C0U

#define SISL_REQ_FLAGS_TMF_CMD        0x0004u	/* bit 13 */

#define SISL_REQ_FLAGS_AFU_CMD        0x0002U	/* bit 14 */

#define SISL_REQ_FLAGS_HOST_WRITE     0x0001U	/* bit 15 (LSB) */
#define SISL_REQ_FLAGS_HOST_READ      0x0000U

	union {
		u32 res_hndl;	/* res_hndl_t */
		u32 port_sel;	/* this is a selection mask:
				 * 0x1 -> port#0 can be selected,
				 * 0x2 -> port#1 can be selected.
				 * Can be bitwise ORed.
				 */
	};
	u64 lun_id;
	u32 data_len;		/* 4K for read/write */
	u32 ioadl_len;
	union {
		u64 data_ea;	/* min 16 byte aligned */
		u64 ioadl_ea;
	};
	u8 msi;			/* LISN to send on RRQ write */
#define SISL_MSI_CXL_PFAULT        0	/* reserved for CXL page faults */
#define SISL_MSI_SYNC_ERROR        1	/* recommended for AFU sync error */
#define SISL_MSI_RRQ_UPDATED       2	/* recommended for IO completion */
#define SISL_MSI_ASYNC_ERROR       3	/* master only - for AFU async error */

	u8 rrq;			/* 0 for a single RRQ */
	u16 timeout;		/* in units specified by req_flags */
	u32 rsvd1;
	u8 cdb[16];		/* must be in big endian */
#define SISL_AFU_CMD_SYNC		0xC0	/* AFU sync command */
#define SISL_AFU_CMD_LUN_PROVISION	0xD0	/* AFU LUN provision command */
#define SISL_AFU_CMD_DEBUG		0xE0	/* AFU debug command */

#define SISL_AFU_LUN_PROVISION_CREATE	0x00	/* LUN provision create type */
#define SISL_AFU_LUN_PROVISION_DELETE	0x01	/* LUN provision delete type */

	union {
		u64 reserved;			/* Reserved for IOARRIN mode */
		struct sisl_ioasa *ioasa;	/* IOASA EA for SQ Mode */
	};
} __packed;

struct sisl_rc {
	u8 flags;
#define SISL_RC_FLAGS_SENSE_VALID         0x80U
#define SISL_RC_FLAGS_FCP_RSP_CODE_VALID  0x40U
#define SISL_RC_FLAGS_OVERRUN             0x20U
#define SISL_RC_FLAGS_UNDERRUN            0x10U

	u8 afu_rc;
#define SISL_AFU_RC_RHT_INVALID           0x01U	/* user error */
#define SISL_AFU_RC_RHT_UNALIGNED         0x02U	/* should never happen */
#define SISL_AFU_RC_RHT_OUT_OF_BOUNDS     0x03u	/* user error */
#define SISL_AFU_RC_RHT_DMA_ERR           0x04u	/* see afu_extra
						 * may retry if afu_retry is off
						 * possible on master exit
						 */
#define SISL_AFU_RC_RHT_RW_PERM           0x05u	/* no RW perms, user error */
#define SISL_AFU_RC_LXT_UNALIGNED         0x12U	/* should never happen */
#define SISL_AFU_RC_LXT_OUT_OF_BOUNDS     0x13u	/* user error */
#define SISL_AFU_RC_LXT_DMA_ERR           0x14u	/* see afu_extra
						 * may retry if afu_retry is off
						 * possible on master exit
						 */
#define SISL_AFU_RC_LXT_RW_PERM           0x15u	/* no RW perms, user error */

#define SISL_AFU_RC_NOT_XLATE_HOST        0x1au	/* possible if master exited */

	/* NO_CHANNELS means the FC ports selected by dest_port in
	 * IOARCB or in the LXT entry are down when the AFU tried to select
	 * a FC port. If the port went down on an active IO, it will set
	 * fc_rc to =0x54(NOLOGI) or 0x57(LINKDOWN) instead.
	 */
#define SISL_AFU_RC_NO_CHANNELS           0x20U	/* see afu_extra, may retry */
#define SISL_AFU_RC_CAP_VIOLATION         0x21U	/* either user error or
						 * afu reset/master restart
						 */
#define SISL_AFU_RC_OUT_OF_DATA_BUFS      0x30U	/* always retry */
#define SISL_AFU_RC_DATA_DMA_ERR          0x31U	/* see afu_extra
						 * may retry if afu_retry is off
						 */

	u8 scsi_rc;		/* SCSI status byte, retry as appropriate */
#define SISL_SCSI_RC_CHECK                0x02U
#define SISL_SCSI_RC_BUSY                 0x08u

	u8 fc_rc;		/* retry */
	/*
	 * We should only see fc_rc=0x57 (LINKDOWN) or 0x54(NOLOGI) for
	 * commands that are in flight when a link goes down or is logged out.
	 * If the link is down or logged out before AFU selects the port, either
	 * it will choose the other port or we will get afu_rc=0x20 (no_channel)
	 * if there is no valid port to use.
	 *
	 * ABORTPEND/ABORTOK/ABORTFAIL/TGTABORT can be retried, typically these
	 * would happen if a frame is dropped and something times out.
	 * NOLOGI or LINKDOWN can be retried if the other port is up.
	 * RESIDERR can be retried as well.
	 *
	 * ABORTFAIL might indicate that lots of frames are getting CRC errors.
	 * So it maybe retried once and reset the link if it happens again.
	 * The link can also be reset on the CRC error threshold interrupt.
	 */
#define SISL_FC_RC_ABORTPEND	0x52	/* exchange timeout or abort request */
#define SISL_FC_RC_WRABORTPEND	0x53	/* due to write XFER_RDY invalid */
#define SISL_FC_RC_NOLOGI	0x54	/* port not logged in, in-flight cmds */
#define SISL_FC_RC_NOEXP	0x55	/* FC protocol error or HW bug */
#define SISL_FC_RC_INUSE	0x56	/* tag already in use, HW bug */
#define SISL_FC_RC_LINKDOWN	0x57	/* link down, in-flight cmds */
#define SISL_FC_RC_ABORTOK	0x58	/* pending abort completed w/success */
#define SISL_FC_RC_ABORTFAIL	0x59	/* pending abort completed w/fail */
#define SISL_FC_RC_RESID	0x5A	/* ioasa underrun/overrun flags set */
#define SISL_FC_RC_RESIDERR	0x5B	/* actual data len does not match SCSI
					 * reported len, possibly due to dropped
					 * frames
					 */
#define SISL_FC_RC_TGTABORT	0x5C	/* command aborted by target */
};

#define SISL_SENSE_DATA_LEN     20	/* Sense data length         */
#define SISL_WWID_DATA_LEN	16	/* WWID data length          */

/*
 * IOASA: 64 bytes & must follow IOARCB, min 16 byte alignment required,
 * host native endianness
 */
struct sisl_ioasa {
	union {
		struct sisl_rc rc;
		u32 ioasc;
#define SISL_IOASC_GOOD_COMPLETION        0x00000000U
	};

	union {
		u32 resid;
		u32 lunid_hi;
	};

	u8 port;
	u8 afu_extra;
	/* when afu_rc=0x04, 0x14, 0x31 (_xxx_DMA_ERR):
	 * afu_exta contains PSL response code. Useful codes are:
	 */
#define SISL_AFU_DMA_ERR_PAGE_IN	0x0A	/* AFU_retry_on_pagein Action
						 *  Enabled            N/A
						 *  Disabled           retry
						 */
#define SISL_AFU_DMA_ERR_INVALID_EA	0x0B	/* this is a hard error
						 * afu_rc	Implies
						 * 0x04, 0x14	master exit.
						 * 0x31         user error.
						 */
	/* when afu rc=0x20 (no channels):
	 * afu_extra bits [4:5]: available portmask,  [6:7]: requested portmask.
	 */
#define SISL_AFU_NO_CLANNELS_AMASK(afu_extra) (((afu_extra) & 0x0C) >> 2)
#define SISL_AFU_NO_CLANNELS_RMASK(afu_extra) ((afu_extra) & 0x03)

	u8 scsi_extra;
	u8 fc_extra;

	union {
		u8 sense_data[SISL_SENSE_DATA_LEN];
		struct {
			u32 lunid_lo;
			u8 wwid[SISL_WWID_DATA_LEN];
		};
	};

	/* These fields are defined by the SISlite architecture for the
	 * host to use as they see fit for their implementation.
	 */
	union {
		u64 host_use[4];
		u8 host_use_b[32];
	};
} __packed;

#define SISL_RESP_HANDLE_T_BIT        0x1ULL	/* Toggle bit */

/* MMIO space is required to support only 64-bit access */

/*
 * This AFU has two mechanisms to deal with endian-ness.
 * One is a global configuration (in the afu_config) register
 * below that specifies the endian-ness of the host.
 * The other is a per context (i.e. application) specification
 * controlled by the endian_ctrl field here. Since the master
 * context is one such application the master context's
 * endian-ness is set to be the same as the host.
 *
 * As per the SISlite spec, the MMIO registers are always
 * big endian.
 */
#define SISL_ENDIAN_CTRL_BE           0x8000000000000080ULL
#define SISL_ENDIAN_CTRL_LE           0x0000000000000000ULL

#ifdef __BIG_ENDIAN
#define SISL_ENDIAN_CTRL              SISL_ENDIAN_CTRL_BE
#else
#define SISL_ENDIAN_CTRL              SISL_ENDIAN_CTRL_LE
#endif

/* per context host transport MMIO  */
struct sisl_host_map {
	__be64 endian_ctrl;	/* Per context Endian Control. The AFU will
				 * operate on whatever the context is of the
				 * host application.
				 */

	__be64 intr_status;	/* this sends LISN# programmed in ctx_ctrl.
				 * Only recovery in a PERM_ERR is a context
				 * exit since there is no way to tell which
				 * command caused the error.
				 */
#define SISL_ISTATUS_PERM_ERR_CMDROOM    0x0010ULL	/* b59, user error */
#define SISL_ISTATUS_PERM_ERR_RCB_READ   0x0008ULL	/* b60, user error */
#define SISL_ISTATUS_PERM_ERR_SA_WRITE   0x0004ULL	/* b61, user error */
#define SISL_ISTATUS_PERM_ERR_RRQ_WRITE  0x0002ULL	/* b62, user error */
	/* Page in wait accessing RCB/IOASA/RRQ is reported in b63.
	 * Same error in data/LXT/RHT access is reported via IOASA.
	 */
#define SISL_ISTATUS_TEMP_ERR_PAGEIN     0x0001ULL	/* b63, can be generated
							 * only when AFU auto
							 * retry is disabled.
							 * If user can determine
							 * the command that
							 * caused the error, it
							 * can be retried.
							 */
#define SISL_ISTATUS_UNMASK  (0x001FULL)	/* 1 means unmasked */
#define SISL_ISTATUS_MASK    ~(SISL_ISTATUS_UNMASK)	/* 1 means masked */

	__be64 intr_clear;
	__be64 intr_mask;
	__be64 ioarrin;		/* only write what cmd_room permits */
	__be64 rrq_start;	/* start & end are both inclusive */
	__be64 rrq_end;		/* write sequence: start followed by end */
	__be64 cmd_room;
	__be64 ctx_ctrl;	/* least significant byte or b56:63 is LISN# */
	__be64 mbox_w;		/* restricted use */
	__be64 sq_start;	/* Submission Queue (R/W): write sequence and */
	__be64 sq_end;		/* inclusion semantics are the same as RRQ    */
	__be64 sq_head;		/* Submission Queue Head (R): for debugging   */
	__be64 sq_tail;		/* Submission Queue TAIL (R/W): next IOARCB   */
	__be64 sq_ctx_reset;	/* Submission Queue Context Reset (R/W)	      */
};

/* per context provisioning & control MMIO */
struct sisl_ctrl_map {
	__be64 rht_start;
	__be64 rht_cnt_id;
	/* both cnt & ctx_id args must be ULL */
#define SISL_RHT_CNT_ID(cnt, ctx_id)  (((cnt) << 48) | ((ctx_id) << 32))

	__be64 ctx_cap;	/* afu_rc below is when the capability is violated */
#define SISL_CTX_CAP_PROXY_ISSUE       0x8000000000000000ULL /* afu_rc 0x21 */
#define SISL_CTX_CAP_REAL_MODE         0x4000000000000000ULL /* afu_rc 0x21 */
#define SISL_CTX_CAP_HOST_XLATE        0x2000000000000000ULL /* afu_rc 0x1a */
#define SISL_CTX_CAP_PROXY_TARGET      0x1000000000000000ULL /* afu_rc 0x21 */
#define SISL_CTX_CAP_AFU_CMD           0x0000000000000008ULL /* afu_rc 0x21 */
#define SISL_CTX_CAP_GSCSI_CMD         0x0000000000000004ULL /* afu_rc 0x21 */
#define SISL_CTX_CAP_WRITE_CMD         0x0000000000000002ULL /* afu_rc 0x21 */
#define SISL_CTX_CAP_READ_CMD          0x0000000000000001ULL /* afu_rc 0x21 */
	__be64 mbox_r;
};

/* single copy global regs */
struct sisl_global_regs {
	__be64 aintr_status;
	/*
	 * In cxlflash, FC port/link are arranged in port pairs, each
	 * gets a byte of status:
	 *
	 *	*_OTHER:	other err, FC_ERRCAP[31:20]
	 *	*_LOGO:		target sent FLOGI/PLOGI/LOGO while logged in
	 *	*_CRC_T:	CRC threshold exceeded
	 *	*_LOGI_R:	login state machine timed out and retrying
	 *	*_LOGI_F:	login failed, FC_ERROR[19:0]
	 *	*_LOGI_S:	login succeeded
	 *	*_LINK_DN:	link online to offline
	 *	*_LINK_UP:	link offline to online
	 */
#define SISL_ASTATUS_FC2_OTHER	 0x80000000ULL /* b32 */
#define SISL_ASTATUS_FC2_LOGO    0x40000000ULL /* b33 */
#define SISL_ASTATUS_FC2_CRC_T   0x20000000ULL /* b34 */
#define SISL_ASTATUS_FC2_LOGI_R  0x10000000ULL /* b35 */
#define SISL_ASTATUS_FC2_LOGI_F  0x08000000ULL /* b36 */
#define SISL_ASTATUS_FC2_LOGI_S  0x04000000ULL /* b37 */
#define SISL_ASTATUS_FC2_LINK_DN 0x02000000ULL /* b38 */
#define SISL_ASTATUS_FC2_LINK_UP 0x01000000ULL /* b39 */

#define SISL_ASTATUS_FC3_OTHER   0x00800000ULL /* b40 */
#define SISL_ASTATUS_FC3_LOGO    0x00400000ULL /* b41 */
#define SISL_ASTATUS_FC3_CRC_T   0x00200000ULL /* b42 */
#define SISL_ASTATUS_FC3_LOGI_R  0x00100000ULL /* b43 */
#define SISL_ASTATUS_FC3_LOGI_F  0x00080000ULL /* b44 */
#define SISL_ASTATUS_FC3_LOGI_S  0x00040000ULL /* b45 */
#define SISL_ASTATUS_FC3_LINK_DN 0x00020000ULL /* b46 */
#define SISL_ASTATUS_FC3_LINK_UP 0x00010000ULL /* b47 */

#define SISL_ASTATUS_FC0_OTHER	 0x00008000ULL /* b48 */
#define SISL_ASTATUS_FC0_LOGO    0x00004000ULL /* b49 */
#define SISL_ASTATUS_FC0_CRC_T   0x00002000ULL /* b50 */
#define SISL_ASTATUS_FC0_LOGI_R  0x00001000ULL /* b51 */
#define SISL_ASTATUS_FC0_LOGI_F  0x00000800ULL /* b52 */
#define SISL_ASTATUS_FC0_LOGI_S  0x00000400ULL /* b53 */
#define SISL_ASTATUS_FC0_LINK_DN 0x00000200ULL /* b54 */
#define SISL_ASTATUS_FC0_LINK_UP 0x00000100ULL /* b55 */

#define SISL_ASTATUS_FC1_OTHER   0x00000080ULL /* b56 */
#define SISL_ASTATUS_FC1_LOGO    0x00000040ULL /* b57 */
#define SISL_ASTATUS_FC1_CRC_T   0x00000020ULL /* b58 */
#define SISL_ASTATUS_FC1_LOGI_R  0x00000010ULL /* b59 */
#define SISL_ASTATUS_FC1_LOGI_F  0x00000008ULL /* b60 */
#define SISL_ASTATUS_FC1_LOGI_S  0x00000004ULL /* b61 */
#define SISL_ASTATUS_FC1_LINK_DN 0x00000002ULL /* b62 */
#define SISL_ASTATUS_FC1_LINK_UP 0x00000001ULL /* b63 */

#define SISL_FC_INTERNAL_UNMASK	0x0000000300000000ULL	/* 1 means unmasked */
#define SISL_FC_INTERNAL_MASK	~(SISL_FC_INTERNAL_UNMASK)
#define SISL_FC_INTERNAL_SHIFT	32

#define SISL_FC_SHUTDOWN_NORMAL		0x0000000000000010ULL
#define SISL_FC_SHUTDOWN_ABRUPT		0x0000000000000020ULL

#define SISL_STATUS_SHUTDOWN_ACTIVE	0x0000000000000010ULL
#define SISL_STATUS_SHUTDOWN_COMPLETE	0x0000000000000020ULL

#define SISL_ASTATUS_UNMASK	0xFFFFFFFFULL		/* 1 means unmasked */
#define SISL_ASTATUS_MASK	~(SISL_ASTATUS_UNMASK)	/* 1 means masked */

	__be64 aintr_clear;
	__be64 aintr_mask;
	__be64 afu_ctrl;
	__be64 afu_hb;
	__be64 afu_scratch_pad;
	__be64 afu_port_sel;
#define SISL_AFUCONF_AR_IOARCB	0x4000ULL
#define SISL_AFUCONF_AR_LXT	0x2000ULL
#define SISL_AFUCONF_AR_RHT	0x1000ULL
#define SISL_AFUCONF_AR_DATA	0x0800ULL
#define SISL_AFUCONF_AR_RSRC	0x0400ULL
#define SISL_AFUCONF_AR_IOASA	0x0200ULL
#define SISL_AFUCONF_AR_RRQ	0x0100ULL
/* Aggregate all Auto Retry Bits */
#define SISL_AFUCONF_AR_ALL	(SISL_AFUCONF_AR_IOARCB|SISL_AFUCONF_AR_LXT| \
				 SISL_AFUCONF_AR_RHT|SISL_AFUCONF_AR_DATA|   \
				 SISL_AFUCONF_AR_RSRC|SISL_AFUCONF_AR_IOASA| \
				 SISL_AFUCONF_AR_RRQ)
#ifdef __BIG_ENDIAN
#define SISL_AFUCONF_ENDIAN            0x0000ULL
#else
#define SISL_AFUCONF_ENDIAN            0x0020ULL
#endif
#define SISL_AFUCONF_MBOX_CLR_READ     0x0010ULL
	__be64 afu_config;
	__be64 rsvd[0xf8];
	__le64 afu_version;
	__be64 interface_version;
#define SISL_INTVER_CAP_SHIFT			16
#define SISL_INTVER_MAJ_SHIFT			8
#define SISL_INTVER_CAP_MASK			0xFFFFFFFF00000000ULL
#define SISL_INTVER_MAJ_MASK			0x00000000FFFF0000ULL
#define SISL_INTVER_MIN_MASK			0x000000000000FFFFULL
#define SISL_INTVER_CAP_IOARRIN_CMD_MODE	0x800000000000ULL
#define SISL_INTVER_CAP_SQ_CMD_MODE		0x400000000000ULL
#define SISL_INTVER_CAP_RESERVED_CMD_MODE_A	0x200000000000ULL
#define SISL_INTVER_CAP_RESERVED_CMD_MODE_B	0x100000000000ULL
#define SISL_INTVER_CAP_LUN_PROVISION		0x080000000000ULL
#define SISL_INTVER_CAP_AFU_DEBUG		0x040000000000ULL
};

#define CXLFLASH_NUM_FC_PORTS_PER_BANK	2	/* fixed # of ports per bank */
#define CXLFLASH_MAX_FC_BANKS		2	/* max # of banks supported */
#define CXLFLASH_MAX_FC_PORTS	(CXLFLASH_NUM_FC_PORTS_PER_BANK *	\
				 CXLFLASH_MAX_FC_BANKS)
#define CXLFLASH_MAX_CONTEXT	512	/* number of contexts per AFU */
#define CXLFLASH_NUM_VLUNS	512	/* number of vluns per AFU/port */
#define CXLFLASH_NUM_REGS	512	/* number of registers per port */

struct fc_port_bank {
	__be64 fc_port_regs[CXLFLASH_NUM_FC_PORTS_PER_BANK][CXLFLASH_NUM_REGS];
	__be64 fc_port_luns[CXLFLASH_NUM_FC_PORTS_PER_BANK][CXLFLASH_NUM_VLUNS];
};

struct sisl_global_map {
	union {
		struct sisl_global_regs regs;
		char page0[SIZE_4K];	/* page 0 */
	};

	char page1[SIZE_4K];	/* page 1 */

	struct fc_port_bank bank[CXLFLASH_MAX_FC_BANKS]; /* pages 2 - 9 */

	/* pages 10 - 15 are reserved */

};

/*
 * CXL Flash Memory Map
 *
 *	+-------------------------------+
 *	|    512 * 64 KB User MMIO      |
 *	|        (per context)          |
 *	|       User Accessible         |
 *	+-------------------------------+
 *	|    512 * 128 B per context    |
 *	|    Provisioning and Control   |
 *	|   Trusted Process accessible  |
 *	+-------------------------------+
 *	|         64 KB Global          |
 *	|   Trusted Process accessible  |
 *	+-------------------------------+
 */
struct cxlflash_afu_map {
	union {
		struct sisl_host_map host;
		char harea[SIZE_64K];	/* 64KB each */
	} hosts[CXLFLASH_MAX_CONTEXT];

	union {
		struct sisl_ctrl_map ctrl;
		char carea[cache_line_size()];	/* 128B each */
	} ctrls[CXLFLASH_MAX_CONTEXT];

	union {
		struct sisl_global_map global;
		char garea[SIZE_64K];	/* 64KB single block */
	};
};

/*
 * LXT - LBA Translation Table
 * LXT control blocks
 */
struct sisl_lxt_entry {
	u64 rlba_base;	/* bits 0:47 is base
			 * b48:55 is lun index
			 * b58:59 is write & read perms
			 * (if no perm, afu_rc=0x15)
			 * b60:63 is port_sel mask
			 */
};

/*
 * RHT - Resource Handle Table
 * Per the SISlite spec, RHT entries are to be 16-byte aligned
 */
struct sisl_rht_entry {
	struct sisl_lxt_entry *lxt_start;
	u32 lxt_cnt;
	u16 rsvd;
	u8 fp;			/* format & perm nibbles.
				 * (if no perm, afu_rc=0x05)
				 */
	u8 nmask;
} __packed __aligned(16);

struct sisl_rht_entry_f1 {
	u64 lun_id;
	union {
		struct {
			u8 valid;
			u8 rsvd[5];
			u8 fp;
			u8 port_sel;
		};

		u64 dw;
	};
} __packed __aligned(16);

/* make the fp byte */
#define SISL_RHT_FP(fmt, perm) (((fmt) << 4) | (perm))

/* make the fp byte for a clone from a source fp and clone flags
 * flags must be only 2 LSB bits.
 */
#define SISL_RHT_FP_CLONE(src_fp, cln_flags) ((src_fp) & (0xFC | (cln_flags)))

#define RHT_PERM_READ  0x01U
#define RHT_PERM_WRITE 0x02U
#define RHT_PERM_RW    (RHT_PERM_READ | RHT_PERM_WRITE)

/* extract the perm bits from a fp */
#define SISL_RHT_PERM(fp) ((fp) & RHT_PERM_RW)

#define PORT0  0x01U
#define PORT1  0x02U
#define PORT2  0x04U
#define PORT3  0x08U
#define PORT_MASK(_n)	((1 << (_n)) - 1)

/* AFU Sync Mode byte */
#define AFU_LW_SYNC 0x0U
#define AFU_HW_SYNC 0x1U
#define AFU_GSYNC   0x2U

/* Special Task Management Function CDB */
#define TMF_LUN_RESET  0x1U
#define TMF_CLEAR_ACA  0x2U


#define SISLITE_MAX_WS_BLOCKS 512

#endif /* _SISLITE_H */
Commit	Line	Data
c21e0bbf MO	1	/*
	2	* CXL Flash Device Driver
	3	*
	4	* Written by: Manoj N. Kumar <manoj@linux.vnet.ibm.com>, IBM Corporation
	5	* Matthew R. Ochs <mrochs@linux.vnet.ibm.com>, IBM Corporation
	6	*
	7	* Copyright (C) 2015 IBM Corporation
	8	*
	9	* This program is free software; you can redistribute it and/or
	10	* modify it under the terms of the GNU General Public License
	11	* as published by the Free Software Foundation; either version
	12	* 2 of the License, or (at your option) any later version.
	13	*/
	14
	15	#ifndef _SISLITE_H
	16	#define _SISLITE_H
	17
	18	#include <linux/types.h>
	19
	20	typedef u16 ctx_hndl_t;
	21	typedef u32 res_hndl_t;
	22
	23	#define SIZE_4K 4096
	24	#define SIZE_64K 65536
	25
	26	/*
	27	* IOARCB: 64 bytes, min 16 byte alignment required, host native endianness
	28	* except for SCSI CDB which remains big endian per SCSI standards.
	29	*/
	30	struct sisl_ioarcb {
	31	u16 ctx_id; /* ctx_hndl_t */
	32	u16 req_flags;
	33	#define SISL_REQ_FLAGS_RES_HNDL 0x8000U /* bit 0 (MSB) */
	34	#define SISL_REQ_FLAGS_PORT_LUN_ID 0x0000U
	35
	36	#define SISL_REQ_FLAGS_SUP_UNDERRUN 0x4000U /* bit 1 */
	37
	38	#define SISL_REQ_FLAGS_TIMEOUT_SECS 0x0000U /* bits 8,9 */
	39	#define SISL_REQ_FLAGS_TIMEOUT_MSECS 0x0040U
	40	#define SISL_REQ_FLAGS_TIMEOUT_USECS 0x0080U
	41	#define SISL_REQ_FLAGS_TIMEOUT_CYCLES 0x00C0U
	42
	43	#define SISL_REQ_FLAGS_TMF_CMD 0x0004u /* bit 13 */
	44
	45	#define SISL_REQ_FLAGS_AFU_CMD 0x0002U /* bit 14 */
	46
	47	#define SISL_REQ_FLAGS_HOST_WRITE 0x0001U /* bit 15 (LSB) */
	48	#define SISL_REQ_FLAGS_HOST_READ 0x0000U
	49
	50	union {
	51	u32 res_hndl; /* res_hndl_t */
	52	u32 port_sel; /* this is a selection mask:
	53	* 0x1 -> port#0 can be selected,
	54	* 0x2 -> port#1 can be selected.
	55	* Can be bitwise ORed.
	56	*/
	57	};
	58	u64 lun_id;
	59	u32 data_len; /* 4K for read/write */
	60	u32 ioadl_len;
	61	union {
	62	u64 data_ea; /* min 16 byte aligned */
	63	u64 ioadl_ea;
	64	};
65	u8 msi; /* LISN to send on RRQ write */
66	#define SISL_MSI_CXL_PFAULT 0 /* reserved for CXL page faults */
67	#define SISL_MSI_SYNC_ERROR 1 /* recommended for AFU sync error */
68	#define SISL_MSI_RRQ_UPDATED 2 /* recommended for IO completion */
69	#define SISL_MSI_ASYNC_ERROR 3 /* master only - for AFU async error */
70
71	u8 rrq; /* 0 for a single RRQ */
72	u16 timeout; /* in units specified by req_flags */
73	u32 rsvd1;
74	u8 cdb[16]; /* must be in big endian */
b413ed3b	75	#define SISL_AFU_CMD_SYNC 0xC0 /* AFU sync command */
1f829583	76	#define SISL_AFU_CMD_LUN_PROVISION 0xD0 /* AFU LUN provision command */
d3c606a7	77	#define SISL_AFU_CMD_DEBUG 0xE0 /* AFU debug command */
1f829583 MO	78
	79	#define SISL_AFU_LUN_PROVISION_CREATE 0x00 /* LUN provision create type */
	80	#define SISL_AFU_LUN_PROVISION_DELETE 0x01 /* LUN provision delete type */
b413ed3b	81
bae0ac69 MO	82	union {
	83	u64 reserved; /* Reserved for IOARRIN mode */
	84	struct sisl_ioasa ioasa; / IOASA EA for SQ Mode */
	85	};
c21e0bbf MO	86	} __packed;
	87
	88	struct sisl_rc {
	89	u8 flags;
	90	#define SISL_RC_FLAGS_SENSE_VALID 0x80U
	91	#define SISL_RC_FLAGS_FCP_RSP_CODE_VALID 0x40U
	92	#define SISL_RC_FLAGS_OVERRUN 0x20U
	93	#define SISL_RC_FLAGS_UNDERRUN 0x10U
	94
	95	u8 afu_rc;
	96	#define SISL_AFU_RC_RHT_INVALID 0x01U /* user error */
	97	#define SISL_AFU_RC_RHT_UNALIGNED 0x02U /* should never happen */
	98	#define SISL_AFU_RC_RHT_OUT_OF_BOUNDS 0x03u /* user error */
	99	#define SISL_AFU_RC_RHT_DMA_ERR 0x04u /* see afu_extra
39e9d618 MO	100	* may retry if afu_retry is off
39e9d618 MO	101	* possible on master exit
c21e0bbf MO	102	*/
	103	#define SISL_AFU_RC_RHT_RW_PERM 0x05u /* no RW perms, user error */
	104	#define SISL_AFU_RC_LXT_UNALIGNED 0x12U /* should never happen */
	105	#define SISL_AFU_RC_LXT_OUT_OF_BOUNDS 0x13u /* user error */
	106	#define SISL_AFU_RC_LXT_DMA_ERR 0x14u /* see afu_extra
39e9d618 MO	107	* may retry if afu_retry is off
39e9d618 MO	108	* possible on master exit
c21e0bbf MO	109	*/
	110	#define SISL_AFU_RC_LXT_RW_PERM 0x15u /* no RW perms, user error */
	111
	112	#define SISL_AFU_RC_NOT_XLATE_HOST 0x1au /* possible if master exited */
	113
	114	/* NO_CHANNELS means the FC ports selected by dest_port in
	115	* IOARCB or in the LXT entry are down when the AFU tried to select
	116	* a FC port. If the port went down on an active IO, it will set
	117	* fc_rc to =0x54(NOLOGI) or 0x57(LINKDOWN) instead.
	118	*/
	119	#define SISL_AFU_RC_NO_CHANNELS 0x20U /* see afu_extra, may retry */
	120	#define SISL_AFU_RC_CAP_VIOLATION 0x21U /* either user error or
39e9d618	121	* afu reset/master restart
c21e0bbf MO	122	*/
	123	#define SISL_AFU_RC_OUT_OF_DATA_BUFS 0x30U /* always retry */
	124	#define SISL_AFU_RC_DATA_DMA_ERR 0x31U /* see afu_extra
39e9d618	125	* may retry if afu_retry is off
c21e0bbf MO	126	*/
	127
	128	u8 scsi_rc; /* SCSI status byte, retry as appropriate */
	129	#define SISL_SCSI_RC_CHECK 0x02U
	130	#define SISL_SCSI_RC_BUSY 0x08u
	131
	132	u8 fc_rc; /* retry */
	133	/*
	134	* We should only see fc_rc=0x57 (LINKDOWN) or 0x54(NOLOGI) for
	135	* commands that are in flight when a link goes down or is logged out.
	136	* If the link is down or logged out before AFU selects the port, either
	137	* it will choose the other port or we will get afu_rc=0x20 (no_channel)
	138	* if there is no valid port to use.
	139	*
	140	* ABORTPEND/ABORTOK/ABORTFAIL/TGTABORT can be retried, typically these
	141	* would happen if a frame is dropped and something times out.
	142	* NOLOGI or LINKDOWN can be retried if the other port is up.
	143	* RESIDERR can be retried as well.
	144	*
	145	* ABORTFAIL might indicate that lots of frames are getting CRC errors.
	146	* So it maybe retried once and reset the link if it happens again.
	147	* The link can also be reset on the CRC error threshold interrupt.
	148	*/
	149	#define SISL_FC_RC_ABORTPEND 0x52 /* exchange timeout or abort request */
	150	#define SISL_FC_RC_WRABORTPEND 0x53 /* due to write XFER_RDY invalid */
	151	#define SISL_FC_RC_NOLOGI 0x54 /* port not logged in, in-flight cmds */
	152	#define SISL_FC_RC_NOEXP 0x55 /* FC protocol error or HW bug */
	153	#define SISL_FC_RC_INUSE 0x56 /* tag already in use, HW bug */
	154	#define SISL_FC_RC_LINKDOWN 0x57 /* link down, in-flight cmds */
	155	#define SISL_FC_RC_ABORTOK 0x58 /* pending abort completed w/success */
	156	#define SISL_FC_RC_ABORTFAIL 0x59 /* pending abort completed w/fail */
	157	#define SISL_FC_RC_RESID 0x5A /* ioasa underrun/overrun flags set */
	158	#define SISL_FC_RC_RESIDERR 0x5B /* actual data len does not match SCSI
39e9d618 MO	159	* reported len, possibly due to dropped
	160	* frames
	161	*/
c21e0bbf MO	162	#define SISL_FC_RC_TGTABORT 0x5C /* command aborted by target */
	163	};
	164
	165	#define SISL_SENSE_DATA_LEN 20 /* Sense data length */
1f829583	166	#define SISL_WWID_DATA_LEN 16 /* WWID data length */
c21e0bbf MO	167
	168	/*
	169	* IOASA: 64 bytes & must follow IOARCB, min 16 byte alignment required,
	170	* host native endianness
	171	*/
	172	struct sisl_ioasa {
	173	union {
	174	struct sisl_rc rc;
	175	u32 ioasc;
	176	#define SISL_IOASC_GOOD_COMPLETION 0x00000000U
	177	};
1f829583 MO	178
	179	union {
	180	u32 resid;
	181	u32 lunid_hi;
	182	};
	183
c21e0bbf MO	184	u8 port;
	185	u8 afu_extra;
	186	/* when afu_rc=0x04, 0x14, 0x31 (_xxx_DMA_ERR):
	187	* afu_exta contains PSL response code. Useful codes are:
	188	*/
	189	#define SISL_AFU_DMA_ERR_PAGE_IN 0x0A /* AFU_retry_on_pagein Action
	190	* Enabled N/A
	191	* Disabled retry
	192	*/
	193	#define SISL_AFU_DMA_ERR_INVALID_EA 0x0B /* this is a hard error
	194	* afu_rc Implies
	195	* 0x04, 0x14 master exit.
	196	* 0x31 user error.
	197	*/
	198	/* when afu rc=0x20 (no channels):
	199	* afu_extra bits [4:5]: available portmask, [6:7]: requested portmask.
	200	*/
	201	#define SISL_AFU_NO_CLANNELS_AMASK(afu_extra) (((afu_extra) & 0x0C) >> 2)
	202	#define SISL_AFU_NO_CLANNELS_RMASK(afu_extra) ((afu_extra) & 0x03)
	203
	204	u8 scsi_extra;
	205	u8 fc_extra;
1f829583 MO	206
	207	union {
	208	u8 sense_data[SISL_SENSE_DATA_LEN];
	209	struct {
	210	u32 lunid_lo;
	211	u8 wwid[SISL_WWID_DATA_LEN];
	212	};
	213	};
c21e0bbf MO	214
	215	/* These fields are defined by the SISlite architecture for the
	216	* host to use as they see fit for their implementation.
	217	*/
	218	union {
	219	u64 host_use[4];
	220	u8 host_use_b[32];
	221	};
	222	} __packed;
	223
	224	#define SISL_RESP_HANDLE_T_BIT 0x1ULL /* Toggle bit */
	225
	226	/* MMIO space is required to support only 64-bit access */
	227
	228	/*
	229	* This AFU has two mechanisms to deal with endian-ness.
	230	* One is a global configuration (in the afu_config) register
	231	* below that specifies the endian-ness of the host.
	232	* The other is a per context (i.e. application) specification
	233	* controlled by the endian_ctrl field here. Since the master
	234	* context is one such application the master context's
	235	* endian-ness is set to be the same as the host.
	236	*
	237	* As per the SISlite spec, the MMIO registers are always
	238	* big endian.
	239	*/
	240	#define SISL_ENDIAN_CTRL_BE 0x8000000000000080ULL
	241	#define SISL_ENDIAN_CTRL_LE 0x0000000000000000ULL
	242
	243	#ifdef __BIG_ENDIAN
	244	#define SISL_ENDIAN_CTRL SISL_ENDIAN_CTRL_BE
	245	#else
	246	#define SISL_ENDIAN_CTRL SISL_ENDIAN_CTRL_LE
	247	#endif
	248
	249	/* per context host transport MMIO */
	250	struct sisl_host_map {
39e9d618 MO	251	__be64 endian_ctrl; /* Per context Endian Control. The AFU will
	252	* operate on whatever the context is of the
	253	* host application.
	254	*/
c21e0bbf MO	255
	256	__be64 intr_status; /* this sends LISN# programmed in ctx_ctrl.
	257	* Only recovery in a PERM_ERR is a context
	258	* exit since there is no way to tell which
	259	* command caused the error.
	260	*/
	261	#define SISL_ISTATUS_PERM_ERR_CMDROOM 0x0010ULL /* b59, user error */
	262	#define SISL_ISTATUS_PERM_ERR_RCB_READ 0x0008ULL /* b60, user error */
	263	#define SISL_ISTATUS_PERM_ERR_SA_WRITE 0x0004ULL /* b61, user error */
	264	#define SISL_ISTATUS_PERM_ERR_RRQ_WRITE 0x0002ULL /* b62, user error */
	265	/* Page in wait accessing RCB/IOASA/RRQ is reported in b63.
	266	* Same error in data/LXT/RHT access is reported via IOASA.
	267	*/
	268	#define SISL_ISTATUS_TEMP_ERR_PAGEIN 0x0001ULL /* b63, can be generated
	269	* only when AFU auto
	270	* retry is disabled.
	271	* If user can determine
	272	* the command that
	273	* caused the error, it
	274	* can be retried.
	275	*/
	276	#define SISL_ISTATUS_UNMASK (0x001FULL) /* 1 means unmasked */
	277	#define SISL_ISTATUS_MASK ~(SISL_ISTATUS_UNMASK) /* 1 means masked */
	278
	279	__be64 intr_clear;
	280	__be64 intr_mask;
	281	__be64 ioarrin; /* only write what cmd_room permits */
	282	__be64 rrq_start; /* start & end are both inclusive */
	283	__be64 rrq_end; /* write sequence: start followed by end */
	284	__be64 cmd_room;
f15fbf8d	285	__be64 ctx_ctrl; /* least significant byte or b56:63 is LISN# */
c21e0bbf	286	__be64 mbox_w; /* restricted use */
bae0ac69 MO	287	__be64 sq_start; /* Submission Queue (R/W): write sequence and */
	288	__be64 sq_end; /* inclusion semantics are the same as RRQ */
	289	__be64 sq_head; /* Submission Queue Head (R): for debugging */
	290	__be64 sq_tail; /* Submission Queue TAIL (R/W): next IOARCB */
	291	__be64 sq_ctx_reset; /* Submission Queue Context Reset (R/W) */
c21e0bbf MO	292	};
	293
	294	/* per context provisioning & control MMIO */
	295	struct sisl_ctrl_map {
	296	__be64 rht_start;
	297	__be64 rht_cnt_id;
	298	/* both cnt & ctx_id args must be ULL */
	299	#define SISL_RHT_CNT_ID(cnt, ctx_id) (((cnt) << 48) \| ((ctx_id) << 32))
	300
	301	__be64 ctx_cap; /* afu_rc below is when the capability is violated */
	302	#define SISL_CTX_CAP_PROXY_ISSUE 0x8000000000000000ULL /* afu_rc 0x21 */
	303	#define SISL_CTX_CAP_REAL_MODE 0x4000000000000000ULL /* afu_rc 0x21 */
	304	#define SISL_CTX_CAP_HOST_XLATE 0x2000000000000000ULL /* afu_rc 0x1a */
	305	#define SISL_CTX_CAP_PROXY_TARGET 0x1000000000000000ULL /* afu_rc 0x21 */
	306	#define SISL_CTX_CAP_AFU_CMD 0x0000000000000008ULL /* afu_rc 0x21 */
	307	#define SISL_CTX_CAP_GSCSI_CMD 0x0000000000000004ULL /* afu_rc 0x21 */
	308	#define SISL_CTX_CAP_WRITE_CMD 0x0000000000000002ULL /* afu_rc 0x21 */
	309	#define SISL_CTX_CAP_READ_CMD 0x0000000000000001ULL /* afu_rc 0x21 */
	310	__be64 mbox_r;
	311	};
	312
	313	/* single copy global regs */
	314	struct sisl_global_regs {
	315	__be64 aintr_status;
a290b480 MO	316	/*
	317	* In cxlflash, FC port/link are arranged in port pairs, each
	318	* gets a byte of status:
	319	*
	320	* *_OTHER: other err, FC_ERRCAP[31:20]
	321	* *_LOGO: target sent FLOGI/PLOGI/LOGO while logged in
	322	* *_CRC_T: CRC threshold exceeded
	323	* *_LOGI_R: login state machine timed out and retrying
	324	* *_LOGI_F: login failed, FC_ERROR[19:0]
	325	* *_LOGI_S: login succeeded
	326	* *_LINK_DN: link online to offline
	327	* *_LINK_UP: link offline to online
	328	*/
	329	#define SISL_ASTATUS_FC2_OTHER 0x80000000ULL /* b32 */
	330	#define SISL_ASTATUS_FC2_LOGO 0x40000000ULL /* b33 */
	331	#define SISL_ASTATUS_FC2_CRC_T 0x20000000ULL /* b34 */
	332	#define SISL_ASTATUS_FC2_LOGI_R 0x10000000ULL /* b35 */
	333	#define SISL_ASTATUS_FC2_LOGI_F 0x08000000ULL /* b36 */
	334	#define SISL_ASTATUS_FC2_LOGI_S 0x04000000ULL /* b37 */
	335	#define SISL_ASTATUS_FC2_LINK_DN 0x02000000ULL /* b38 */
	336	#define SISL_ASTATUS_FC2_LINK_UP 0x01000000ULL /* b39 */
	337
	338	#define SISL_ASTATUS_FC3_OTHER 0x00800000ULL /* b40 */
	339	#define SISL_ASTATUS_FC3_LOGO 0x00400000ULL /* b41 */
	340	#define SISL_ASTATUS_FC3_CRC_T 0x00200000ULL /* b42 */
	341	#define SISL_ASTATUS_FC3_LOGI_R 0x00100000ULL /* b43 */
	342	#define SISL_ASTATUS_FC3_LOGI_F 0x00080000ULL /* b44 */
	343	#define SISL_ASTATUS_FC3_LOGI_S 0x00040000ULL /* b45 */
	344	#define SISL_ASTATUS_FC3_LINK_DN 0x00020000ULL /* b46 */
	345	#define SISL_ASTATUS_FC3_LINK_UP 0x00010000ULL /* b47 */
	346
	347	#define SISL_ASTATUS_FC0_OTHER 0x00008000ULL /* b48 */
	348	#define SISL_ASTATUS_FC0_LOGO 0x00004000ULL /* b49 */
	349	#define SISL_ASTATUS_FC0_CRC_T 0x00002000ULL /* b50 */
	350	#define SISL_ASTATUS_FC0_LOGI_R 0x00001000ULL /* b51 */
	351	#define SISL_ASTATUS_FC0_LOGI_F 0x00000800ULL /* b52 */
	352	#define SISL_ASTATUS_FC0_LOGI_S 0x00000400ULL /* b53 */
	353	#define SISL_ASTATUS_FC0_LINK_DN 0x00000200ULL /* b54 */
	354	#define SISL_ASTATUS_FC0_LINK_UP 0x00000100ULL /* b55 */
	355
	356	#define SISL_ASTATUS_FC1_OTHER 0x00000080ULL /* b56 */
	357	#define SISL_ASTATUS_FC1_LOGO 0x00000040ULL /* b57 */
	358	#define SISL_ASTATUS_FC1_CRC_T 0x00000020ULL /* b58 */
	359	#define SISL_ASTATUS_FC1_LOGI_R 0x00000010ULL /* b59 */
	360	#define SISL_ASTATUS_FC1_LOGI_F 0x00000008ULL /* b60 */
	361	#define SISL_ASTATUS_FC1_LOGI_S 0x00000004ULL /* b61 */
	362	#define SISL_ASTATUS_FC1_LINK_DN 0x00000002ULL /* b62 */
	363	#define SISL_ASTATUS_FC1_LINK_UP 0x00000001ULL /* b63 */
c21e0bbf MO	364
	365	#define SISL_FC_INTERNAL_UNMASK 0x0000000300000000ULL /* 1 means unmasked */
	366	#define SISL_FC_INTERNAL_MASK ~(SISL_FC_INTERNAL_UNMASK)
	367	#define SISL_FC_INTERNAL_SHIFT 32
	368
704c4b0d UK	369	#define SISL_FC_SHUTDOWN_NORMAL 0x0000000000000010ULL
	370	#define SISL_FC_SHUTDOWN_ABRUPT 0x0000000000000020ULL
	371
	372	#define SISL_STATUS_SHUTDOWN_ACTIVE 0x0000000000000010ULL
	373	#define SISL_STATUS_SHUTDOWN_COMPLETE 0x0000000000000020ULL
	374
a290b480	375	#define SISL_ASTATUS_UNMASK 0xFFFFFFFFULL /* 1 means unmasked */
c21e0bbf MO	376	#define SISL_ASTATUS_MASK ~(SISL_ASTATUS_UNMASK) /* 1 means masked */
	377
	378	__be64 aintr_clear;
	379	__be64 aintr_mask;
	380	__be64 afu_ctrl;
	381	__be64 afu_hb;
	382	__be64 afu_scratch_pad;
	383	__be64 afu_port_sel;
	384	#define SISL_AFUCONF_AR_IOARCB 0x4000ULL
	385	#define SISL_AFUCONF_AR_LXT 0x2000ULL
	386	#define SISL_AFUCONF_AR_RHT 0x1000ULL
	387	#define SISL_AFUCONF_AR_DATA 0x0800ULL
	388	#define SISL_AFUCONF_AR_RSRC 0x0400ULL
	389	#define SISL_AFUCONF_AR_IOASA 0x0200ULL
	390	#define SISL_AFUCONF_AR_RRQ 0x0100ULL
	391	/* Aggregate all Auto Retry Bits */
	392	#define SISL_AFUCONF_AR_ALL (SISL_AFUCONF_AR_IOARCB\|SISL_AFUCONF_AR_LXT\| \
	393	SISL_AFUCONF_AR_RHT\|SISL_AFUCONF_AR_DATA\| \
	394	SISL_AFUCONF_AR_RSRC\|SISL_AFUCONF_AR_IOASA\| \
	395	SISL_AFUCONF_AR_RRQ)
	396	#ifdef __BIG_ENDIAN
	397	#define SISL_AFUCONF_ENDIAN 0x0000ULL
	398	#else
	399	#define SISL_AFUCONF_ENDIAN 0x0020ULL
	400	#endif
	401	#define SISL_AFUCONF_MBOX_CLR_READ 0x0010ULL
	402	__be64 afu_config;
	403	__be64 rsvd[0xf8];
e5ce067b	404	__le64 afu_version;
c21e0bbf	405	__be64 interface_version;
bae0ac69 MO	406	#define SISL_INTVER_CAP_SHIFT 16
	407	#define SISL_INTVER_MAJ_SHIFT 8
	408	#define SISL_INTVER_CAP_MASK 0xFFFFFFFF00000000ULL
	409	#define SISL_INTVER_MAJ_MASK 0x00000000FFFF0000ULL
	410	#define SISL_INTVER_MIN_MASK 0x000000000000FFFFULL
	411	#define SISL_INTVER_CAP_IOARRIN_CMD_MODE 0x800000000000ULL
	412	#define SISL_INTVER_CAP_SQ_CMD_MODE 0x400000000000ULL
	413	#define SISL_INTVER_CAP_RESERVED_CMD_MODE_A 0x200000000000ULL
	414	#define SISL_INTVER_CAP_RESERVED_CMD_MODE_B 0x100000000000ULL
1f829583	415	#define SISL_INTVER_CAP_LUN_PROVISION 0x080000000000ULL
d3c606a7	416	#define SISL_INTVER_CAP_AFU_DEBUG 0x040000000000ULL
c21e0bbf MO	417	};
c21e0bbf MO	418
a290b480	419	#define CXLFLASH_NUM_FC_PORTS_PER_BANK 2 /* fixed # of ports per bank */
bdcff1c5	420	#define CXLFLASH_MAX_FC_BANKS 2 /* max # of banks supported */
a290b480 MO	421	#define CXLFLASH_MAX_FC_PORTS (CXLFLASH_NUM_FC_PORTS_PER_BANK * \
	422	CXLFLASH_MAX_FC_BANKS)
	423	#define CXLFLASH_MAX_CONTEXT 512 /* number of contexts per AFU */
	424	#define CXLFLASH_NUM_VLUNS 512 /* number of vluns per AFU/port */
	425	#define CXLFLASH_NUM_REGS 512 /* number of registers per port */
	426
	427	struct fc_port_bank {
	428	__be64 fc_port_regs[CXLFLASH_NUM_FC_PORTS_PER_BANK][CXLFLASH_NUM_REGS];
	429	__be64 fc_port_luns[CXLFLASH_NUM_FC_PORTS_PER_BANK][CXLFLASH_NUM_VLUNS];
	430	};
c21e0bbf MO	431
	432	struct sisl_global_map {
	433	union {
	434	struct sisl_global_regs regs;
	435	char page0[SIZE_4K]; /* page 0 */
	436	};
	437
	438	char page1[SIZE_4K]; /* page 1 */
	439
bdcff1c5	440	struct fc_port_bank bank[CXLFLASH_MAX_FC_BANKS]; /* pages 2 - 9 */
c21e0bbf	441
bdcff1c5	442	/* pages 10 - 15 are reserved */
c21e0bbf MO	443
	444	};
	445
	446	/*
	447	* CXL Flash Memory Map
	448	*
	449	* +-------------------------------+
	450	* \| 512 * 64 KB User MMIO \|
	451	* \| (per context) \|
	452	* \| User Accessible \|
	453	* +-------------------------------+
	454	* \| 512 * 128 B per context \|
	455	* \| Provisioning and Control \|
	456	* \| Trusted Process accessible \|
	457	* +-------------------------------+
	458	* \| 64 KB Global \|
	459	* \| Trusted Process accessible \|
	460	* +-------------------------------+
39e9d618	461	*/
c21e0bbf MO	462	struct cxlflash_afu_map {
	463	union {
	464	struct sisl_host_map host;
	465	char harea[SIZE_64K]; /* 64KB each */
	466	} hosts[CXLFLASH_MAX_CONTEXT];
	467
	468	union {
	469	struct sisl_ctrl_map ctrl;
	470	char carea[cache_line_size()]; /* 128B each */
	471	} ctrls[CXLFLASH_MAX_CONTEXT];
	472
	473	union {
	474	struct sisl_global_map global;
	475	char garea[SIZE_64K]; /* 64KB single block */
	476	};
	477	};
	478
2cb79266 MO	479	/*
	480	* LXT - LBA Translation Table
	481	* LXT control blocks
	482	*/
c21e0bbf MO	483	struct sisl_lxt_entry {
c21e0bbf MO	484	u64 rlba_base; /* bits 0:47 is base
2cb79266 MO	485	* b48:55 is lun index
	486	* b58:59 is write & read perms
	487	* (if no perm, afu_rc=0x15)
	488	* b60:63 is port_sel mask
	489	*/
c21e0bbf MO	490	};
c21e0bbf MO	491
65be2c79 MO	492	/*
	493	* RHT - Resource Handle Table
	494	* Per the SISlite spec, RHT entries are to be 16-byte aligned
	495	*/
c21e0bbf MO	496	struct sisl_rht_entry {
	497	struct sisl_lxt_entry *lxt_start;
	498	u32 lxt_cnt;
	499	u16 rsvd;
	500	u8 fp; /* format & perm nibbles.
	501	* (if no perm, afu_rc=0x05)
	502	*/
	503	u8 nmask;
	504	} __packed __aligned(16);
	505
	506	struct sisl_rht_entry_f1 {
	507	u64 lun_id;
	508	union {
	509	struct {
	510	u8 valid;
	511	u8 rsvd[5];
	512	u8 fp;
	513	u8 port_sel;
	514	};
	515
	516	u64 dw;
	517	};
	518	} __packed __aligned(16);
	519
	520	/* make the fp byte */
	521	#define SISL_RHT_FP(fmt, perm) (((fmt) << 4) \| (perm))
	522
	523	/* make the fp byte for a clone from a source fp and clone flags
	524	* flags must be only 2 LSB bits.
	525	*/
	526	#define SISL_RHT_FP_CLONE(src_fp, cln_flags) ((src_fp) & (0xFC \| (cln_flags)))
	527
	528	#define RHT_PERM_READ 0x01U
	529	#define RHT_PERM_WRITE 0x02U
	530	#define RHT_PERM_RW (RHT_PERM_READ \| RHT_PERM_WRITE)
	531
	532	/* extract the perm bits from a fp */
	533	#define SISL_RHT_PERM(fp) ((fp) & RHT_PERM_RW)
	534
	535	#define PORT0 0x01U
	536	#define PORT1 0x02U
a290b480 MO	537	#define PORT2 0x04U
a290b480 MO	538	#define PORT3 0x08U
e8e17ea6	539	#define PORT_MASK(_n) ((1 << (_n)) - 1)
c21e0bbf MO	540
	541	/* AFU Sync Mode byte */
	542	#define AFU_LW_SYNC 0x0U
	543	#define AFU_HW_SYNC 0x1U
	544	#define AFU_GSYNC 0x2U
	545
	546	/* Special Task Management Function CDB */
	547	#define TMF_LUN_RESET 0x1U
	548	#define TMF_CLEAR_ACA 0x2U
	549
2cb79266 MO	550
	551	#define SISLITE_MAX_WS_BLOCKS 512
	552
c21e0bbf	553	#endif /* _SISLITE_H */