1/*-
   2 * SPDX-License-Identifier: BSD-2-Clause
   3 *
   4 * Copyright (c) 2006 IronPort Systems
   5 * All rights reserved.
   6 *
   7 * Redistribution and use in source and binary forms, with or without
   8 * modification, are permitted provided that the following conditions
   9 * are met:
  10 * 1. Redistributions of source code must retain the above copyright
  11 *    notice, this list of conditions and the following disclaimer.
  12 * 2. Redistributions in binary form must reproduce the above copyright
  13 *    notice, this list of conditions and the following disclaimer in the
  14 *    documentation and/or other materials provided with the distribution.
  15 *
  16 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  17 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  18 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  19 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  20 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  21 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  22 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  23 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  24 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  25 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  26 * SUCH DAMAGE.
  27 */
  28/*-
  29 * Copyright (c) 2007 LSI Corp.
  30 * Copyright (c) 2007 Rajesh Prabhakaran.
  31 * All rights reserved.
  32 *
  33 * Redistribution and use in source and binary forms, with or without
  34 * modification, are permitted provided that the following conditions
  35 * are met:
  36 * 1. Redistributions of source code must retain the above copyright
  37 *    notice, this list of conditions and the following disclaimer.
  38 * 2. Redistributions in binary form must reproduce the above copyright
  39 *    notice, this list of conditions and the following disclaimer in the
  40 *    documentation and/or other materials provided with the distribution.
  41 *
  42 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  43 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  44 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  45 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  46 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  47 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  48 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  49 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  50 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  51 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  52 * SUCH DAMAGE.
  53 */
  54
  55#ifndef _MFIREG_H
  56#define _MFIREG_H
  57
  58#include <sys/cdefs.h>
  59/*
  60 * MegaRAID SAS MFI firmware definitions
  61 *
  62 * Calling this driver 'MegaRAID SAS' is a bit misleading.  It's a completely
  63 * new firmware interface from the old AMI MegaRAID one, and there is no
  64 * reason why this interface should be limited to just SAS.  In any case, LSI
  65 * seems to also call this interface 'MFI', so that will be used here.
  66 */
  67#define MEGAMFI_FRAME_SIZE              64
  68/*
  69 * Start with the register set.  All registers are 32 bits wide.
  70 * The usual Intel IOP style setup.
  71 */
  72#define MFI_IMSG0	0x10	/* Inbound message 0 */
  73#define MFI_IMSG1	0x14	/* Inbound message 1 */
  74#define MFI_OMSG0	0x18	/* Outbound message 0 */
  75#define MFI_OMSG1	0x1c	/* Outbound message 1 */
  76#define MFI_IDB		0x20	/* Inbound doorbell */
  77#define MFI_ISTS	0x24	/* Inbound interrupt status */
  78#define MFI_IMSK	0x28	/* Inbound interrupt mask */
  79#define MFI_ODB		0x2c	/* Outbound doorbell */
  80#define MFI_OSTS	0x30	/* Outbound interrupt status */
  81#define MFI_OMSK	0x34	/* Outbound interrupt mask */
  82#define MFI_IQP		0x40	/* Inbound queue port */
  83#define MFI_OQP		0x44	/* Outbound queue port */
  84
  85/*
  86*  ThunderBolt specific Register
  87*/
  88
  89#define MFI_RFPI	0x48 		/* reply_free_post_host_index */
  90#define MFI_RPI		0x6c 		/* reply_post_host_index */
  91#define MFI_ILQP 	0xc0		/* inbound_low_queue_port */
  92#define MFI_IHQP 	0xc4		/* inbound_high_queue_port */
  93
  94/*
  95 * 1078 specific related register
  96 */
  97#define MFI_ODR0	0x9c 		/* outbound doorbell register0 */
  98#define MFI_ODCR0	0xa0 		/* outbound doorbell clear register0  */
  99#define MFI_OSP0	0xb0 		/* outbound scratch pad0  */
 100#define MFI_1078_EIM	0x80000004 	/* 1078 enable interrupt mask  */
 101#define MFI_RMI		0x2 		/* reply message interrupt  */
 102#define MFI_1078_RM	0x80000000 	/* reply 1078 message interrupt  */
 103#define MFI_ODC		0x4 		/* outbound doorbell change interrupt */
 104
 105/* OCR registers */
 106#define MFI_WSR		0x004		/* write sequence register */
 107#define MFI_HDR		0x008		/* host diagnostic register */
 108#define MFI_RSR		0x3c3		/* Reset Status Register */
 109
 110/*
 111 * GEN2 specific changes
 112 */
 113#define MFI_GEN2_EIM	0x00000005	/* GEN2 enable interrupt mask */
 114#define MFI_GEN2_RM	0x00000001	/* reply GEN2 message interrupt */
 115
 116/*
 117 * skinny specific changes
 118 */
 119#define MFI_SKINNY_IDB	0x00	/* Inbound doorbell is at 0x00 for skinny */
 120#define MFI_IQPL	0x000000c0
 121#define MFI_IQPH	0x000000c4
 122#define MFI_SKINNY_RM	0x00000001	/* reply skinny message interrupt */
 123
 124/* Bits for MFI_OSTS */
 125#define MFI_OSTS_INTR_VALID	0x00000002
 126
 127/* OCR specific flags */
 128#define MFI_FIRMWARE_STATE_CHANGE	0x00000002
 129#define MFI_STATE_CHANGE_INTERRUPT	0x00000004  /* MFI state change interrrupt */
 130
 131/*
 132 * Firmware state values.  Found in OMSG0 during initialization.
 133 */
 134#define MFI_FWSTATE_MASK		0xf0000000
 135#define MFI_FWSTATE_UNDEFINED		0x00000000
 136#define MFI_FWSTATE_BB_INIT		0x10000000
 137#define MFI_FWSTATE_FW_INIT		0x40000000
 138#define MFI_FWSTATE_WAIT_HANDSHAKE	0x60000000
 139#define MFI_FWSTATE_FW_INIT_2		0x70000000
 140#define MFI_FWSTATE_DEVICE_SCAN		0x80000000
 141#define MFI_FWSTATE_BOOT_MESSAGE_PENDING	0x90000000
 142#define MFI_FWSTATE_FLUSH_CACHE		0xa0000000
 143#define MFI_FWSTATE_READY		0xb0000000
 144#define MFI_FWSTATE_OPERATIONAL		0xc0000000
 145#define MFI_FWSTATE_FAULT		0xf0000000
 146#define MFI_FWSTATE_MAXSGL_MASK		0x00ff0000
 147#define MFI_FWSTATE_MAXCMD_MASK		0x0000ffff
 148#define MFI_FWSTATE_HOSTMEMREQD_MASK	0x08000000
 149#define MFI_FWSTATE_BOOT_MESSAGE_PENDING	0x90000000
 150#define MFI_RESET_REQUIRED		0x00000001
 151
 152/* ThunderBolt Support */
 153#define MFI_FWSTATE_TB_MASK		0xf0000000
 154#define MFI_FWSTATE_TB_RESET		0x00000000
 155#define MFI_FWSTATE_TB_READY		0x10000000
 156#define MFI_FWSTATE_TB_OPERATIONAL	0x20000000
 157#define MFI_FWSTATE_TB_FAULT		0x40000000
 158
 159/*
 160 * Control bits to drive the card to ready state.  These go into the IDB
 161 * register.
 162 */
 163#define MFI_FWINIT_ABORT	0x00000000 /* Abort all pending commands */
 164#define MFI_FWINIT_READY	0x00000002 /* Move from operational to ready */
 165#define MFI_FWINIT_MFIMODE	0x00000004 /* unknown */
 166#define MFI_FWINIT_CLEAR_HANDSHAKE 0x00000008 /* Respond to WAIT_HANDSHAKE */
 167#define MFI_FWINIT_HOTPLUG	0x00000010
 168
 169/* ADP reset flags */
 170#define MFI_STOP_ADP		0x00000020
 171#define MFI_ADP_RESET		0x00000040
 172#define DIAG_WRITE_ENABLE	0x00000080
 173#define DIAG_RESET_ADAPTER	0x00000004
 174
 175/* MFI Commands */
 176typedef enum {
 177	MFI_CMD_INIT =		0x00,
 178	MFI_CMD_LD_READ,
 179	MFI_CMD_LD_WRITE,
 180	MFI_CMD_LD_SCSI_IO,
 181	MFI_CMD_PD_SCSI_IO,
 182	MFI_CMD_DCMD,
 183	MFI_CMD_ABORT,
 184	MFI_CMD_SMP,
 185	MFI_CMD_STP
 186} mfi_cmd_t;
 187
 188/* Direct commands */
 189typedef enum {
 190	MFI_DCMD_CTRL_GETINFO =		0x01010000,
 191	MFI_DCMD_CTRL_MFI_HOST_MEM_ALLOC =0x0100e100,
 192	MFI_DCMD_CTRL_MFC_DEFAULTS_GET =0x010e0201,
 193	MFI_DCMD_CTRL_MFC_DEFAULTS_SET =0x010e0202,
 194	MFI_DCMD_CTRL_FLUSHCACHE =	0x01101000,
 195	MFI_DCMD_CTRL_GET_PROPS =       0x01020100,
 196	MFI_DCMD_CTRL_SET_PROPS =       0x01020200,
 197	MFI_DCMD_CTRL_SHUTDOWN =	0x01050000,
 198	MFI_DCMD_CTRL_EVENT_GETINFO =	0x01040100,
 199	MFI_DCMD_CTRL_EVENT_GET =	0x01040300,
 200	MFI_DCMD_CTRL_EVENT_WAIT =	0x01040500,
 201	MFI_DCMD_PR_GET_STATUS =	0x01070100,
 202	MFI_DCMD_PR_GET_PROPERTIES =	0x01070200,
 203	MFI_DCMD_PR_SET_PROPERTIES =	0x01070300,
 204	MFI_DCMD_PR_START =		0x01070400,
 205	MFI_DCMD_PR_STOP =		0x01070500,
 206	MFI_DCMD_TIME_SECS_GET =	0x01080201,
 207	MFI_DCMD_FLASH_FW_OPEN =	0x010f0100,
 208	MFI_DCMD_FLASH_FW_DOWNLOAD =	0x010f0200,
 209	MFI_DCMD_FLASH_FW_FLASH =	0x010f0300,
 210	MFI_DCMD_FLASH_FW_CLOSE =	0x010f0400,
 211	MFI_DCMD_PD_GET_LIST =		0x02010000,
 212	MFI_DCMD_PD_LIST_QUERY =	0x02010100,
 213	MFI_DCMD_PD_GET_INFO = 		0x02020000,
 214	MFI_DCMD_PD_STATE_SET =		0x02030100,
 215	MFI_DCMD_PD_REBUILD_START =	0x02040100,
 216	MFI_DCMD_PD_REBUILD_ABORT =	0x02040200,
 217	MFI_DCMD_PD_CLEAR_START =	0x02050100,
 218	MFI_DCMD_PD_CLEAR_ABORT =	0x02050200,
 219	MFI_DCMD_PD_GET_PROGRESS =	0x02060000,
 220	MFI_DCMD_PD_LOCATE_START =	0x02070100,
 221	MFI_DCMD_PD_LOCATE_STOP =	0x02070200,
 222	MFI_DCMD_LD_MAP_GET_INFO =	0x0300e101,
 223	MFI_DCMD_LD_SYNC =		0x0300e102,
 224	MFI_DCMD_LD_GET_LIST =		0x03010000,
 225	MFI_DCMD_LD_GET_INFO =		0x03020000,
 226	MFI_DCMD_LD_GET_PROP =		0x03030000,
 227	MFI_DCMD_LD_SET_PROP =		0x03040000,
 228	MFI_DCMD_LD_INIT_START =	0x03060100,
 229	MFI_DCMD_LD_DELETE =		0x03090000,
 230	MFI_DCMD_CFG_READ =		0x04010000,
 231	MFI_DCMD_CFG_ADD =		0x04020000,
 232	MFI_DCMD_CFG_CLEAR =		0x04030000,
 233	MFI_DCMD_CFG_MAKE_SPARE =	0x04040000,
 234	MFI_DCMD_CFG_REMOVE_SPARE =	0x04050000,
 235	MFI_DCMD_CFG_FOREIGN_SCAN =     0x04060100,
 236	MFI_DCMD_CFG_FOREIGN_DISPLAY =  0x04060200,
 237	MFI_DCMD_CFG_FOREIGN_PREVIEW =  0x04060300,
 238	MFI_DCMD_CFG_FOREIGN_IMPORT =	0x04060400,
 239	MFI_DCMD_CFG_FOREIGN_CLEAR =    0x04060500,
 240	MFI_DCMD_BBU_GET_STATUS =	0x05010000,
 241	MFI_DCMD_BBU_GET_CAPACITY_INFO =0x05020000,
 242	MFI_DCMD_BBU_GET_DESIGN_INFO =	0x05030000,
 243	MFI_DCMD_BBU_START_LEARN =	0x05040000,
 244	MFI_DCMD_BBU_GET_PROP =		0x05050100,
 245	MFI_DCMD_BBU_SET_PROP =		0x05050200,
 246	MFI_DCMD_CLUSTER =		0x08000000,
 247	MFI_DCMD_CLUSTER_RESET_ALL =	0x08010100,
 248	MFI_DCMD_CLUSTER_RESET_LD =	0x08010200
 249} mfi_dcmd_t;
 250
 251/* Modifiers for MFI_DCMD_CTRL_FLUSHCACHE */
 252#define MFI_FLUSHCACHE_CTRL	0x01
 253#define MFI_FLUSHCACHE_DISK	0x02
 254
 255/* Modifiers for MFI_DCMD_CTRL_SHUTDOWN */
 256#define MFI_SHUTDOWN_SPINDOWN	0x01
 257
 258/*
 259 * MFI Frame flags
 260 */
 261#define MFI_FRAME_POST_IN_REPLY_QUEUE		0x0000
 262#define MFI_FRAME_DONT_POST_IN_REPLY_QUEUE	0x0001
 263#define MFI_FRAME_SGL32				0x0000
 264#define MFI_FRAME_SGL64				0x0002
 265#define MFI_FRAME_SENSE32			0x0000
 266#define MFI_FRAME_SENSE64			0x0004
 267#define MFI_FRAME_DIR_NONE			0x0000
 268#define MFI_FRAME_DIR_WRITE			0x0008
 269#define MFI_FRAME_DIR_READ			0x0010
 270#define MFI_FRAME_DIR_BOTH			0x0018
 271#define MFI_FRAME_IEEE_SGL			0x0020
 272#define MFI_FRAME_FMT "\20" \
 273    "\1NOPOST" \
 274    "\2SGL64" \
 275    "\3SENSE64" \
 276    "\4WRITE" \
 277    "\5READ" \
 278    "\6IEEESGL"
 279
 280/* ThunderBolt Specific */
 281
 282/*
 283 * Pre-TB command size and TB command size.
 284 * We will be checking it at the load time for the time being
 285 */
 286#define MR_COMMAND_SIZE (MFI_FRAME_SIZE*20) /* 1280 bytes */
 287
 288#define MEGASAS_THUNDERBOLT_MSG_ALLIGNMENT  256
 289/*
 290 * We are defining only 128 byte message to reduce memory move over head
 291 * and also it will reduce the SRB extension size by 128byte compared with
 292 * 256 message size
 293 */
 294#define MEGASAS_THUNDERBOLT_NEW_MSG_SIZE	256
 295#define MEGASAS_THUNDERBOLT_MAX_COMMANDS	1024
 296#define MEGASAS_THUNDERBOLT_MAX_REPLY_COUNT	1024
 297#define MEGASAS_THUNDERBOLT_REPLY_SIZE		8
 298#define MEGASAS_THUNDERBOLT_MAX_CHAIN_COUNT	1
 299#define MEGASAS_MAX_SZ_CHAIN_FRAME		1024
 300
 301#define MPI2_FUNCTION_PASSTHRU_IO_REQUEST       0xF0
 302#define MPI2_FUNCTION_LD_IO_REQUEST             0xF1
 303
 304#define MR_INTERNAL_MFI_FRAMES_SMID             1
 305#define MR_CTRL_EVENT_WAIT_SMID                 2
 306#define MR_INTERNAL_DRIVER_RESET_SMID           3
 307
 308/* MFI Status codes */
 309typedef enum {
 310	MFI_STAT_OK =			0x00,
 311	MFI_STAT_INVALID_CMD,
 312	MFI_STAT_INVALID_DCMD,
 313	MFI_STAT_INVALID_PARAMETER,
 314	MFI_STAT_INVALID_SEQUENCE_NUMBER,
 315	MFI_STAT_ABORT_NOT_POSSIBLE,
 316	MFI_STAT_APP_HOST_CODE_NOT_FOUND,
 317	MFI_STAT_APP_IN_USE,
 318	MFI_STAT_APP_NOT_INITIALIZED,
 319	MFI_STAT_ARRAY_INDEX_INVALID,
 320	MFI_STAT_ARRAY_ROW_NOT_EMPTY,
 321	MFI_STAT_CONFIG_RESOURCE_CONFLICT,
 322	MFI_STAT_DEVICE_NOT_FOUND,
 323	MFI_STAT_DRIVE_TOO_SMALL,
 324	MFI_STAT_FLASH_ALLOC_FAIL,
 325	MFI_STAT_FLASH_BUSY,
 326	MFI_STAT_FLASH_ERROR =		0x10,
 327	MFI_STAT_FLASH_IMAGE_BAD,
 328	MFI_STAT_FLASH_IMAGE_INCOMPLETE,
 329	MFI_STAT_FLASH_NOT_OPEN,
 330	MFI_STAT_FLASH_NOT_STARTED,
 331	MFI_STAT_FLUSH_FAILED,
 332	MFI_STAT_HOST_CODE_NOT_FOUNT,
 333	MFI_STAT_LD_CC_IN_PROGRESS,
 334	MFI_STAT_LD_INIT_IN_PROGRESS,
 335	MFI_STAT_LD_LBA_OUT_OF_RANGE,
 336	MFI_STAT_LD_MAX_CONFIGURED,
 337	MFI_STAT_LD_NOT_OPTIMAL,
 338	MFI_STAT_LD_RBLD_IN_PROGRESS,
 339	MFI_STAT_LD_RECON_IN_PROGRESS,
 340	MFI_STAT_LD_WRONG_RAID_LEVEL,
 341	MFI_STAT_MAX_SPARES_EXCEEDED,
 342	MFI_STAT_MEMORY_NOT_AVAILABLE =	0x20,
 343	MFI_STAT_MFC_HW_ERROR,
 344	MFI_STAT_NO_HW_PRESENT,
 345	MFI_STAT_NOT_FOUND,
 346	MFI_STAT_NOT_IN_ENCL,
 347	MFI_STAT_PD_CLEAR_IN_PROGRESS,
 348	MFI_STAT_PD_TYPE_WRONG,
 349	MFI_STAT_PR_DISABLED,
 350	MFI_STAT_ROW_INDEX_INVALID,
 351	MFI_STAT_SAS_CONFIG_INVALID_ACTION,
 352	MFI_STAT_SAS_CONFIG_INVALID_DATA,
 353	MFI_STAT_SAS_CONFIG_INVALID_PAGE,
 354	MFI_STAT_SAS_CONFIG_INVALID_TYPE,
 355	MFI_STAT_SCSI_DONE_WITH_ERROR,
 356	MFI_STAT_SCSI_IO_FAILED,
 357	MFI_STAT_SCSI_RESERVATION_CONFLICT,
 358	MFI_STAT_SHUTDOWN_FAILED =	0x30,
 359	MFI_STAT_TIME_NOT_SET,
 360	MFI_STAT_WRONG_STATE,
 361	MFI_STAT_LD_OFFLINE,
 362	MFI_STAT_PEER_NOTIFICATION_REJECTED,
 363	MFI_STAT_PEER_NOTIFICATION_FAILED,
 364	MFI_STAT_RESERVATION_IN_PROGRESS,
 365	MFI_STAT_I2C_ERRORS_DETECTED,
 366	MFI_STAT_PCI_ERRORS_DETECTED,
 367	MFI_STAT_DIAG_FAILED,
 368	MFI_STAT_BOOT_MSG_PENDING,
 369	MFI_STAT_FOREIGN_CONFIG_INCOMPLETE,
 370	MFI_STAT_INVALID_STATUS =	0xFF
 371} mfi_status_t;
 372
 373typedef enum {
 374	MFI_EVT_CLASS_DEBUG =		-2,
 375	MFI_EVT_CLASS_PROGRESS =	-1,
 376	MFI_EVT_CLASS_INFO =		0,
 377	MFI_EVT_CLASS_WARNING =		1,
 378	MFI_EVT_CLASS_CRITICAL =	2,
 379	MFI_EVT_CLASS_FATAL =		3,
 380	MFI_EVT_CLASS_DEAD =		4
 381} mfi_evt_class_t;
 382
 383typedef enum {
 384	MFI_EVT_LOCALE_LD =		0x0001,
 385	MFI_EVT_LOCALE_PD =		0x0002,
 386	MFI_EVT_LOCALE_ENCL =		0x0004,
 387	MFI_EVT_LOCALE_BBU =		0x0008,
 388	MFI_EVT_LOCALE_SAS =		0x0010,
 389	MFI_EVT_LOCALE_CTRL =		0x0020,
 390	MFI_EVT_LOCALE_CONFIG =		0x0040,
 391	MFI_EVT_LOCALE_CLUSTER =	0x0080,
 392	MFI_EVT_LOCALE_ALL =		0xffff
 393} mfi_evt_locale_t;
 394
 395typedef enum {
 396	MR_EVT_ARGS_NONE =		0x00,
 397	MR_EVT_ARGS_CDB_SENSE,
 398	MR_EVT_ARGS_LD,
 399	MR_EVT_ARGS_LD_COUNT,
 400	MR_EVT_ARGS_LD_LBA,
 401	MR_EVT_ARGS_LD_OWNER,
 402	MR_EVT_ARGS_LD_LBA_PD_LBA,
 403	MR_EVT_ARGS_LD_PROG,
 404	MR_EVT_ARGS_LD_STATE,
 405	MR_EVT_ARGS_LD_STRIP,
 406	MR_EVT_ARGS_PD,
 407	MR_EVT_ARGS_PD_ERR,
 408	MR_EVT_ARGS_PD_LBA,
 409	MR_EVT_ARGS_PD_LBA_LD,
 410	MR_EVT_ARGS_PD_PROG,
 411	MR_EVT_ARGS_PD_STATE,
 412	MR_EVT_ARGS_PCI,
 413	MR_EVT_ARGS_RATE,
 414	MR_EVT_ARGS_STR,
 415	MR_EVT_ARGS_TIME,
 416	MR_EVT_ARGS_ECC
 417} mfi_evt_args;
 418
 419#define MR_EVT_CTRL_HOST_BUS_SCAN_REQUESTED	0x0152
 420#define MR_EVT_PD_REMOVED			0x0070
 421#define MR_EVT_PD_INSERTED			0x005b
 422#define MR_EVT_LD_CHANGE			0x0051
 423
 424typedef enum {
 425	MR_LD_CACHE_WRITE_BACK =	0x01,
 426	MR_LD_CACHE_WRITE_ADAPTIVE =	0x02,
 427	MR_LD_CACHE_READ_AHEAD =	0x04,
 428	MR_LD_CACHE_READ_ADAPTIVE =	0x08,
 429	MR_LD_CACHE_WRITE_CACHE_BAD_BBU=0x10,
 430	MR_LD_CACHE_ALLOW_WRITE_CACHE =	0x20,
 431	MR_LD_CACHE_ALLOW_READ_CACHE =	0x40
 432} mfi_ld_cache;
 433#define	MR_LD_CACHE_MASK	0x7f
 434
 435#define	MR_LD_CACHE_POLICY_READ_AHEAD_NONE		0
 436#define	MR_LD_CACHE_POLICY_READ_AHEAD_ALWAYS		MR_LD_CACHE_READ_AHEAD
 437#define	MR_LD_CACHE_POLICY_READ_AHEAD_ADAPTIVE		\
 438	(MR_LD_CACHE_READ_AHEAD | MR_LD_CACHE_READ_ADAPTIVE)
 439#define	MR_LD_CACHE_POLICY_WRITE_THROUGH		0
 440#define	MR_LD_CACHE_POLICY_WRITE_BACK			MR_LD_CACHE_WRITE_BACK
 441#define	MR_LD_CACHE_POLICY_IO_CACHED			\
 442	(MR_LD_CACHE_ALLOW_WRITE_CACHE | MR_LD_CACHE_ALLOW_READ_CACHE)
 443#define	MR_LD_CACHE_POLICY_IO_DIRECT			0
 444
 445typedef enum {
 446	MR_PD_CACHE_UNCHANGED  =	0,
 447	MR_PD_CACHE_ENABLE =		1,
 448	MR_PD_CACHE_DISABLE =		2
 449} mfi_pd_cache;
 450
 451typedef enum {
 452	MR_PD_QUERY_TYPE_ALL =		0,
 453	MR_PD_QUERY_TYPE_STATE =	1,
 454	MR_PD_QUERY_TYPE_POWER_STATE =	2,
 455	MR_PD_QUERY_TYPE_MEDIA_TYPE =	3,
 456	MR_PD_QUERY_TYPE_SPEED =	4,
 457	MR_PD_QUERY_TYPE_EXPOSED_TO_HOST = 5 /*query for system drives */
 458} mfi_pd_query_type;
 459
 460/*
 461 * Other propertities and definitions
 462 */
 463#define MFI_MAX_PD_CHANNELS	2
 464#define MFI_MAX_LD_CHANNELS	2
 465#define MFI_MAX_CHANNELS	(MFI_MAX_PD_CHANNELS + MFI_MAX_LD_CHANNELS)
 466#define MFI_MAX_CHANNEL_DEVS	128
 467#define MFI_DEFAULT_ID		-1
 468#define MFI_MAX_LUN		8
 469#define MFI_MAX_LD		64
 470#define	MFI_MAX_PD		256
 471
 472#define MFI_FRAME_SIZE		64
 473#define MFI_MBOX_SIZE		12
 474
 475/* Firmware flashing can take 50+ seconds */
 476#define MFI_POLL_TIMEOUT_SECS	60
 477
 478/* Allow for speedier math calculations */
 479#define MFI_SECTOR_LEN		512
 480
 481/* Scatter Gather elements */
 482struct mfi_sg32 {
 483	uint32_t	addr;
 484	uint32_t	len;
 485} __packed;
 486
 487struct mfi_sg64 {
 488	uint64_t	addr;
 489	uint32_t	len;
 490} __packed;
 491
 492struct mfi_sg_skinny {
 493	uint64_t	addr;
 494	uint32_t	len;
 495	uint32_t	flag;
 496} __packed;
 497
 498union mfi_sgl {
 499	struct mfi_sg32		sg32[1];
 500	struct mfi_sg64		sg64[1];
 501	struct mfi_sg_skinny	sg_skinny[1];
 502} __packed;
 503
 504/* Message frames.  All messages have a common header */
 505struct mfi_frame_header {
 506	uint8_t		cmd;
 507	uint8_t		sense_len;
 508	uint8_t		cmd_status;
 509	uint8_t		scsi_status;
 510	uint8_t		target_id;
 511	uint8_t		lun_id;
 512	uint8_t		cdb_len;
 513	uint8_t		sg_count;
 514	uint32_t	context;
 515	/*
 516	 * pad0 is MSI Specific. Not used by Driver. Zero the value before
 517	 * sending the command to f/w.
 518	 */
 519	uint32_t	pad0;
 520	uint16_t	flags;
 521#define MFI_FRAME_DATAOUT	0x08
 522#define MFI_FRAME_DATAIN	0x10
 523	uint16_t	timeout;
 524	uint32_t	data_len;
 525} __packed;
 526
 527struct mfi_init_frame {
 528	struct mfi_frame_header	header;
 529	uint32_t	qinfo_new_addr_lo;
 530	uint32_t	qinfo_new_addr_hi;
 531	uint32_t	qinfo_old_addr_lo;
 532	uint32_t	qinfo_old_addr_hi;
 533	// Start LSIP200113393
 534	uint32_t	driver_ver_lo;      /*28h */
 535	uint32_t	driver_ver_hi;      /*2Ch */
 536
 537	uint32_t	reserved[4];
 538	// End LSIP200113393
 539} __packed;
 540
 541/*
 542 * Define MFI Address Context union.
 543 */
 544#ifdef MFI_ADDRESS_IS_uint64_t
 545    typedef uint64_t     MFI_ADDRESS;
 546#else
 547    typedef union _MFI_ADDRESS {
 548        struct {
 549            uint32_t     addressLow;
 550            uint32_t     addressHigh;
 551        } u;
 552        uint64_t     address;
 553    } MFI_ADDRESS, *PMFI_ADDRESS;
 554#endif
 555
 556#define MFI_IO_FRAME_SIZE 40
 557struct mfi_io_frame {
 558	struct mfi_frame_header	header;
 559	uint32_t	sense_addr_lo;
 560	uint32_t	sense_addr_hi;
 561	uint32_t	lba_lo;
 562	uint32_t	lba_hi;
 563	union mfi_sgl	sgl;
 564} __packed;
 565
 566#define MFI_PASS_FRAME_SIZE 48
 567struct mfi_pass_frame {
 568	struct mfi_frame_header header;
 569	uint32_t	sense_addr_lo;
 570	uint32_t	sense_addr_hi;
 571	uint8_t		cdb[16];
 572	union mfi_sgl	sgl;
 573} __packed;
 574
 575#define MFI_DCMD_FRAME_SIZE 40
 576struct mfi_dcmd_frame {
 577	struct mfi_frame_header header;
 578	uint32_t	opcode;
 579	uint8_t		mbox[MFI_MBOX_SIZE];
 580	union mfi_sgl	sgl;
 581} __packed;
 582
 583struct mfi_abort_frame {
 584	struct mfi_frame_header header;
 585	uint32_t	abort_context;
 586	/* pad is changed to reserved.*/
 587	uint32_t	reserved0;
 588	uint32_t	abort_mfi_addr_lo;
 589	uint32_t	abort_mfi_addr_hi;
 590	uint32_t	reserved1[6];
 591} __packed;
 592
 593struct mfi_smp_frame {
 594	struct mfi_frame_header header;
 595	uint64_t	sas_addr;
 596	union {
 597		struct mfi_sg32 sg32[2];
 598		struct mfi_sg64 sg64[2];
 599	} sgl;
 600} __packed;
 601
 602struct mfi_stp_frame {
 603	struct mfi_frame_header header;
 604	uint16_t	fis[10];
 605	uint32_t	stp_flags;
 606	union {
 607		struct mfi_sg32 sg32[2];
 608		struct mfi_sg64 sg64[2];
 609	} sgl;
 610} __packed;
 611
 612union mfi_frame {
 613	struct mfi_frame_header header;
 614	struct mfi_init_frame	init;
 615	/* ThunderBolt Initialization */
 616	struct mfi_io_frame	io;
 617	struct mfi_pass_frame	pass;
 618	struct mfi_dcmd_frame	dcmd;
 619	struct mfi_abort_frame	abort;
 620	struct mfi_smp_frame	smp;
 621	struct mfi_stp_frame	stp;
 622	uint8_t			bytes[MFI_FRAME_SIZE];
 623};
 624
 625#define MFI_SENSE_LEN 128
 626struct mfi_sense {
 627	uint8_t		data[MFI_SENSE_LEN];
 628};
 629
 630/* The queue init structure that is passed with the init message */
 631struct mfi_init_qinfo {
 632	uint32_t	flags;
 633	uint32_t	rq_entries;
 634	uint32_t	rq_addr_lo;
 635	uint32_t	rq_addr_hi;
 636	uint32_t	pi_addr_lo;
 637	uint32_t	pi_addr_hi;
 638	uint32_t	ci_addr_lo;
 639	uint32_t	ci_addr_hi;
 640} __packed;
 641
 642/* SAS (?) controller properties, part of mfi_ctrl_info */
 643struct mfi_ctrl_props {
 644	uint16_t	seq_num;
 645	uint16_t	pred_fail_poll_interval;
 646	uint16_t	intr_throttle_cnt;
 647	uint16_t	intr_throttle_timeout;
 648	uint8_t		rebuild_rate;
 649	uint8_t		patrol_read_rate;
 650	uint8_t		bgi_rate;
 651	uint8_t		cc_rate;
 652	uint8_t		recon_rate;
 653	uint8_t		cache_flush_interval;
 654	uint8_t		spinup_drv_cnt;
 655	uint8_t		spinup_delay;
 656	uint8_t		cluster_enable;
 657	uint8_t		coercion_mode;
 658	uint8_t		alarm_enable;
 659	uint8_t		disable_auto_rebuild;
 660	uint8_t		disable_battery_warn;
 661	uint8_t		ecc_bucket_size;
 662	uint16_t	ecc_bucket_leak_rate;
 663	uint8_t		restore_hotspare_on_insertion;
 664	uint8_t		expose_encl_devices;
 665	uint8_t		maintainPdFailHistory;
 666	uint8_t		disallowHostRequestReordering;
 667	/* set TRUE to abort CC on detecting an inconsistency */
 668	uint8_t		abortCCOnError;
 669	/* load balance mode (MR_LOAD_BALANCE_MODE) */
 670	uint8_t		loadBalanceMode;
 671	/*
 672	 * 0 - use auto detect logic of backplanes like SGPIO, i2c SEP using
 673	 *     h/w mechansim like GPIO pins
 674	 * 1 - disable auto detect SGPIO,
 675	 * 2 - disable i2c SEP auto detect
 676	 * 3 - disable both auto detect
 677	 */
 678	uint8_t		disableAutoDetectBackplane;
 679	/*
 680	 * % of source LD to be reserved for a VDs snapshot in snapshot
 681	 * repository, for metadata and user data: 1=5%, 2=10%, 3=15% and so on
 682	 */
 683	uint8_t		snapVDSpace;
 684
 685	/*
 686	 * Add properties that can be controlled by a bit in the following
 687	 * structure.
 688	 */
 689	struct {
 690		/* set TRUE to disable copyBack (0=copback enabled) */
 691		uint32_t	copyBackDisabled		:1;
 692		uint32_t	SMARTerEnabled			:1;
 693		uint32_t	prCorrectUnconfiguredAreas	:1;
 694		uint32_t	useFdeOnly			:1;
 695		uint32_t	disableNCQ			:1;
 696		uint32_t	SSDSMARTerEnabled		:1;
 697		uint32_t	SSDPatrolReadEnabled		:1;
 698		uint32_t	enableSpinDownUnconfigured	:1;
 699		uint32_t	autoEnhancedImport		:1;
 700		uint32_t	enableSecretKeyControl		:1;
 701		uint32_t	disableOnlineCtrlReset		:1;
 702		uint32_t	allowBootWithPinnedCache	:1;
 703		uint32_t	disableSpinDownHS		:1;
 704		uint32_t	enableJBOD			:1;
 705		uint32_t	reserved			:18;
 706	} OnOffProperties;
 707	/*
 708	 * % of source LD to be reserved for auto snapshot in snapshot
 709	 * repository, for metadata and user data: 1=5%, 2=10%, 3=15% and so on.
 710	 */
 711	uint8_t		autoSnapVDSpace;
 712	/*
 713	 * Snapshot writeable VIEWs capacity as a % of source LD capacity:
 714	 * 0=READ only, 1=5%, 2=10%, 3=15% and so on.
 715	 */
 716	uint8_t		viewSpace;
 717	/* # of idle minutes before device is spun down (0=use FW defaults) */
 718	uint16_t	spinDownTime;
 719	uint8_t		reserved[24];
 720} __packed;
 721
 722/* PCI information about the card. */
 723struct mfi_info_pci {
 724	uint16_t	vendor;
 725	uint16_t	device;
 726	uint16_t	subvendor;
 727	uint16_t	subdevice;
 728	uint8_t		reserved[24];
 729} __packed;
 730
 731/* Host (front end) interface information */
 732struct mfi_info_host {
 733	uint8_t		type;
 734#define MFI_INFO_HOST_PCIX	0x01
 735#define MFI_INFO_HOST_PCIE	0x02
 736#define MFI_INFO_HOST_ISCSI	0x04
 737#define MFI_INFO_HOST_SAS3G	0x08
 738	uint8_t		reserved[6];
 739	uint8_t		port_count;
 740	uint64_t	port_addr[8];
 741} __packed;
 742
 743/* Device (back end) interface information */
 744struct mfi_info_device {
 745	uint8_t		type;
 746#define MFI_INFO_DEV_SPI	0x01
 747#define MFI_INFO_DEV_SAS3G	0x02
 748#define MFI_INFO_DEV_SATA1	0x04
 749#define MFI_INFO_DEV_SATA3G	0x08
 750	uint8_t		reserved[6];
 751	uint8_t		port_count;
 752	uint64_t	port_addr[8];
 753} __packed;
 754
 755/* Firmware component information */
 756struct mfi_info_component {
 757	char		 name[8];
 758	char		 version[32];
 759	char		 build_date[16];
 760	char		 build_time[16];
 761} __packed;
 762
 763/* Controller default settings */
 764struct mfi_defaults {
 765	uint64_t	sas_addr;
 766	uint8_t		phy_polarity;
 767	uint8_t		background_rate;
 768	uint8_t		stripe_size;
 769	uint8_t		flush_time;
 770	uint8_t		write_back;
 771	uint8_t		read_ahead;
 772	uint8_t		cache_when_bbu_bad;
 773	uint8_t		cached_io;
 774	uint8_t		smart_mode;
 775	uint8_t		alarm_disable;
 776	uint8_t		coercion;
 777	uint8_t		zrc_config;
 778	uint8_t		dirty_led_shows_drive_activity;
 779	uint8_t		bios_continue_on_error;
 780	uint8_t		spindown_mode;
 781	uint8_t		allowed_device_types;
 782	uint8_t		allow_mix_in_enclosure;
 783	uint8_t		allow_mix_in_ld;
 784	uint8_t		allow_sata_in_cluster;
 785	uint8_t		max_chained_enclosures;
 786	uint8_t		disable_ctrl_r;
 787	uint8_t		enabel_web_bios;
 788	uint8_t		phy_polarity_split;
 789	uint8_t		direct_pd_mapping;
 790	uint8_t		bios_enumerate_lds;
 791	uint8_t		restored_hot_spare_on_insertion;
 792	uint8_t		expose_enclosure_devices;
 793	uint8_t		maintain_pd_fail_history;
 794	uint8_t		resv[28];
 795} __packed;
 796
 797/* Controller default settings */
 798struct mfi_bios_data {
 799	uint16_t	boot_target_id;
 800	uint8_t		do_not_int_13;
 801	uint8_t		continue_on_error;
 802	uint8_t		verbose;
 803	uint8_t		geometry;
 804	uint8_t		expose_all_drives;
 805	uint8_t		reserved[56];
 806	uint8_t		check_sum;
 807} __packed;
 808
 809/* SAS (?) controller info, returned from MFI_DCMD_CTRL_GETINFO. */
 810struct mfi_ctrl_info {
 811	struct mfi_info_pci	pci;
 812	struct mfi_info_host	host;
 813	struct mfi_info_device	device;
 814
 815	/* Firmware components that are present and active. */
 816	uint32_t		image_check_word;
 817	uint32_t		image_component_count;
 818	struct mfi_info_component image_component[8];
 819
 820	/* Firmware components that have been flashed but are inactive */
 821	uint32_t		pending_image_component_count;
 822	struct mfi_info_component pending_image_component[8];
 823
 824	uint8_t			max_arms;
 825	uint8_t			max_spans;
 826	uint8_t			max_arrays;
 827	uint8_t			max_lds;
 828	char			product_name[80];
 829	char			serial_number[32];
 830	uint32_t		hw_present;
 831#define MFI_INFO_HW_BBU		0x01
 832#define MFI_INFO_HW_ALARM	0x02
 833#define MFI_INFO_HW_NVRAM	0x04
 834#define MFI_INFO_HW_UART	0x08
 835	uint32_t		current_fw_time;
 836	uint16_t		max_cmds;
 837	uint16_t		max_sg_elements;
 838	uint32_t		max_request_size;
 839	uint16_t		lds_present;
 840	uint16_t		lds_degraded;
 841	uint16_t		lds_offline;
 842	uint16_t		pd_present;
 843	uint16_t		pd_disks_present;
 844	uint16_t		pd_disks_pred_failure;
 845	uint16_t		pd_disks_failed;
 846	uint16_t		nvram_size;
 847	uint16_t		memory_size;
 848	uint16_t		flash_size;
 849	uint16_t		ram_correctable_errors;
 850	uint16_t		ram_uncorrectable_errors;
 851	uint8_t			cluster_allowed;
 852	uint8_t			cluster_active;
 853	uint16_t		max_strips_per_io;
 854
 855	uint32_t		raid_levels;
 856#define MFI_INFO_RAID_0		0x01
 857#define MFI_INFO_RAID_1		0x02
 858#define MFI_INFO_RAID_5		0x04
 859#define MFI_INFO_RAID_1E	0x08
 860#define MFI_INFO_RAID_6		0x10
 861
 862	uint32_t		adapter_ops;
 863#define MFI_INFO_AOPS_RBLD_RATE		0x0001
 864#define MFI_INFO_AOPS_CC_RATE		0x0002
 865#define MFI_INFO_AOPS_BGI_RATE		0x0004
 866#define MFI_INFO_AOPS_RECON_RATE	0x0008
 867#define MFI_INFO_AOPS_PATROL_RATE	0x0010
 868#define MFI_INFO_AOPS_ALARM_CONTROL	0x0020
 869#define MFI_INFO_AOPS_CLUSTER_SUPPORTED	0x0040
 870#define MFI_INFO_AOPS_BBU		0x0080
 871#define MFI_INFO_AOPS_SPANNING_ALLOWED	0x0100
 872#define MFI_INFO_AOPS_DEDICATED_SPARES	0x0200
 873#define MFI_INFO_AOPS_REVERTIBLE_SPARES	0x0400
 874#define MFI_INFO_AOPS_FOREIGN_IMPORT	0x0800
 875#define MFI_INFO_AOPS_SELF_DIAGNOSTIC	0x1000
 876#define MFI_INFO_AOPS_MIXED_ARRAY	0x2000
 877#define MFI_INFO_AOPS_GLOBAL_SPARES	0x4000
 878
 879	uint32_t		ld_ops;
 880#define MFI_INFO_LDOPS_READ_POLICY	0x01
 881#define MFI_INFO_LDOPS_WRITE_POLICY	0x02
 882#define MFI_INFO_LDOPS_IO_POLICY	0x04
 883#define MFI_INFO_LDOPS_ACCESS_POLICY	0x08
 884#define MFI_INFO_LDOPS_DISK_CACHE_POLICY 0x10
 885
 886	struct {
 887		uint8_t		min;
 888		uint8_t		max;
 889		uint8_t		reserved[2];
 890	} __packed stripe_sz_ops;
 891
 892	uint32_t		pd_ops;
 893#define MFI_INFO_PDOPS_FORCE_ONLINE	0x01
 894#define MFI_INFO_PDOPS_FORCE_OFFLINE	0x02
 895#define MFI_INFO_PDOPS_FORCE_REBUILD	0x04
 896
 897	uint32_t		pd_mix_support;
 898#define MFI_INFO_PDMIX_SAS		0x01
 899#define MFI_INFO_PDMIX_SATA		0x02
 900#define MFI_INFO_PDMIX_ENCL		0x04
 901#define MFI_INFO_PDMIX_LD		0x08
 902#define MFI_INFO_PDMIX_SATA_CLUSTER	0x10
 903
 904	uint8_t			ecc_bucket_count;
 905	uint8_t			reserved2[11];
 906	struct mfi_ctrl_props	properties;
 907	char			package_version[0x60];
 908	uint8_t			pad[0x800 - 0x6a0];
 909} __packed;
 910
 911/* keep track of an event. */
 912union mfi_evt {
 913	struct {
 914		uint16_t	locale;
 915		uint8_t		reserved;
 916		int8_t		evt_class;
 917	} members;
 918	uint32_t		word;
 919} __packed;
 920
 921/* event log state. */
 922struct mfi_evt_log_state {
 923	uint32_t		newest_seq_num;
 924	uint32_t		oldest_seq_num;
 925	uint32_t		clear_seq_num;
 926	uint32_t		shutdown_seq_num;
 927	uint32_t		boot_seq_num;
 928} __packed;
 929
 930struct mfi_progress {
 931	uint16_t		progress;
 932	uint16_t		elapsed_seconds;
 933} __packed;
 934
 935struct mfi_evt_ld {
 936	uint16_t		target_id;
 937	uint8_t			ld_index;
 938	uint8_t			reserved;
 939} __packed;
 940
 941struct mfi_evt_pd {
 942	uint16_t		device_id;
 943	uint8_t			enclosure_index;
 944	uint8_t			slot_number;
 945} __packed;
 946
 947/* SAS (?) event detail, returned from MFI_DCMD_CTRL_EVENT_WAIT. */
 948struct mfi_evt_detail {
 949	uint32_t		seq;
 950	uint32_t		time;
 951	uint32_t		code;
 952	union mfi_evt		evt_class;
 953	uint8_t			arg_type;
 954	uint8_t			reserved1[15];
 955
 956	union {
 957		struct {
 958			struct mfi_evt_pd	pd;
 959			uint8_t			cdb_len;
 960			uint8_t			sense_len;
 961			uint8_t			reserved[2];
 962			uint8_t			cdb[16];
 963			uint8_t			sense[64];
 964		} cdb_sense;
 965
 966		struct mfi_evt_ld		ld;
 967
 968		struct {
 969			struct mfi_evt_ld	ld;
 970			uint64_t		count;
 971		} ld_count;
 972
 973		struct {
 974			uint64_t		lba;
 975			struct mfi_evt_ld	ld;
 976		} ld_lba;
 977
 978		struct {
 979			struct mfi_evt_ld	ld;
 980			uint32_t		pre_owner;
 981			uint32_t		new_owner;
 982		} ld_owner;
 983
 984		struct {
 985			uint64_t		ld_lba;
 986			uint64_t		pd_lba;
 987			struct mfi_evt_ld	ld;
 988			struct mfi_evt_pd	pd;
 989		} ld_lba_pd_lba;
 990
 991		struct {
 992			struct mfi_evt_ld	ld;
 993			struct mfi_progress	prog;
 994		} ld_prog;
 995
 996		struct {
 997			struct mfi_evt_ld	ld;
 998			uint32_t		prev_state;
 999			uint32_t		new_state;
1000		} ld_state;
1001
1002		struct {
1003			uint64_t		strip;
1004			struct mfi_evt_ld	ld;
1005		} ld_strip;
1006
1007		struct mfi_evt_pd		pd;
1008
1009		struct {
1010			struct mfi_evt_pd	pd;
1011			uint32_t		err;
1012		} pd_err;
1013
1014		struct {
1015			uint64_t		lba;
1016			struct mfi_evt_pd	pd;
1017		} pd_lba;
1018
1019		struct {
1020			uint64_t		lba;
1021			struct mfi_evt_pd	pd;
1022			struct mfi_evt_ld	ld;
1023		} pd_lba_ld;
1024
1025		struct {
1026			struct mfi_evt_pd	pd;
1027			struct mfi_progress	prog;
1028		} pd_prog;
1029
1030		struct {
1031			struct mfi_evt_pd	ld;
1032			uint32_t		prev_state;
1033			uint32_t		new_state;
1034		} pd_state;
1035
1036		struct {
1037			uint16_t		venderId;
1038			uint16_t		deviceId;
1039			uint16_t		subVenderId;
1040			uint16_t		subDeviceId;
1041		} pci;
1042
1043		uint32_t			rate;
1044
1045		char				str[96];
1046
1047		struct {
1048			uint32_t		rtc;
1049			uint16_t		elapsedSeconds;
1050		} time;
1051
1052		struct {
1053			uint32_t		ecar;
1054			uint32_t		elog;
1055			char			str[64];
1056		} ecc;
1057
1058		uint8_t		b[96];
1059		uint16_t	s[48];
1060		uint32_t	w[24];
1061		uint64_t	d[12];
1062	} args;
1063
1064	char description[128];
1065} __packed;
1066
1067struct mfi_evt_list {
1068	uint32_t		count;
1069	uint32_t		reserved;
1070	struct mfi_evt_detail	event[1];
1071} __packed;
1072
1073union mfi_pd_ref {
1074	struct {
1075		uint16_t	device_id;
1076		uint16_t	seq_num;
1077	} v;
1078	uint32_t	ref;
1079} __packed;
1080
1081union mfi_pd_ddf_type {
1082	struct {
1083		union {
1084			struct {
1085				uint16_t	forced_pd_guid	: 1;
1086				uint16_t	in_vd		: 1;
1087				uint16_t	is_global_spare	: 1;
1088				uint16_t	is_spare	: 1;
1089				uint16_t	is_foreign	: 1;
1090				uint16_t	reserved	: 7;
1091				uint16_t	intf		: 4;
1092			} pd_type;
1093			uint16_t	type;
1094		} v;
1095		uint16_t		reserved;
1096	} ddf;
1097	struct {
1098		uint32_t		reserved;
1099	} non_disk;
1100	uint32_t			type;
1101} __packed;
1102
1103struct mfi_pd_progress {
1104	uint32_t			active;
1105#define	MFI_PD_PROGRESS_REBUILD	(1<<0)
1106#define	MFI_PD_PROGRESS_PATROL	(1<<1)
1107#define	MFI_PD_PROGRESS_CLEAR	(1<<2)
1108	struct mfi_progress		rbld;
1109	struct mfi_progress		patrol;
1110	struct mfi_progress		clear;
1111	struct mfi_progress		reserved[4];
1112} __packed;
1113
1114struct mfi_pd_info {
1115	union mfi_pd_ref		ref;
1116	uint8_t				inquiry_data[96];
1117	uint8_t				vpd_page83[64];
1118	uint8_t				not_supported;
1119	uint8_t				scsi_dev_type;
1120	uint8_t				connected_port_bitmap;
1121	uint8_t				device_speed;
1122	uint32_t			media_err_count;
1123	uint32_t			other_err_count;
1124	uint32_t			pred_fail_count;
1125	uint32_t			last_pred_fail_event_seq_num;
1126	uint16_t			fw_state;	/* MFI_PD_STATE_* */
1127	uint8_t				disabled_for_removal;
1128	uint8_t				link_speed;
1129	union mfi_pd_ddf_type		state;
1130	struct {
1131		uint8_t			count;
1132		uint8_t			is_path_broken;
1133		uint8_t			reserved[6];
1134		uint64_t		sas_addr[4];
1135	} path_info;
1136	uint64_t			raw_size;
1137	uint64_t			non_coerced_size;
1138	uint64_t			coerced_size;
1139	uint16_t			encl_device_id;
1140	uint8_t				encl_index;
1141	uint8_t				slot_number;
1142	struct mfi_pd_progress		prog_info;
1143	uint8_t				bad_block_table_full;
1144	uint8_t				unusable_in_current_config;
1145	uint8_t				vpd_page83_ext[64];
1146	uint8_t				reserved[512-358];
1147} __packed;
1148
1149struct mfi_pd_address {
1150	uint16_t		device_id;
1151	uint16_t		encl_device_id;
1152	uint8_t			encl_index;
1153	uint8_t			slot_number;
1154	uint8_t			scsi_dev_type;	/* 0 = disk */
1155	uint8_t			connect_port_bitmap;
1156	uint64_t		sas_addr[2];
1157} __packed;
1158
1159#define MAX_SYS_PDS 240
1160struct mfi_pd_list {
1161	uint32_t		size;
1162	uint32_t		count;
1163	struct mfi_pd_address	addr[MAX_SYS_PDS];
1164} __packed;
1165
1166enum mfi_pd_state {
1167	MFI_PD_STATE_UNCONFIGURED_GOOD = 0x00,
1168	MFI_PD_STATE_UNCONFIGURED_BAD = 0x01,
1169	MFI_PD_STATE_HOT_SPARE = 0x02,
1170	MFI_PD_STATE_OFFLINE = 0x10,
1171	MFI_PD_STATE_FAILED = 0x11,
1172	MFI_PD_STATE_REBUILD = 0x14,
1173	MFI_PD_STATE_ONLINE = 0x18,
1174	MFI_PD_STATE_COPYBACK = 0x20,
1175	MFI_PD_STATE_SYSTEM = 0x40
1176};
1177
1178/*
1179 * "SYSTEM" disk appears to be "JBOD" support from the RAID controller.
1180 * Adding a #define to denote this.
1181 */
1182#define MFI_PD_STATE_JBOD MFI_PD_STATE_SYSTEM
1183
1184union mfi_ld_ref {
1185	struct {
1186		uint8_t		target_id;
1187		uint8_t		reserved;
1188		uint16_t	seq;
1189	} v;
1190	uint32_t		ref;
1191} __packed;
1192
1193struct mfi_ld_list {
1194	uint32_t		ld_count;
1195	uint32_t		reserved1;
1196	struct {
1197		union mfi_ld_ref	ld;
1198		uint8_t		state;
1199		uint8_t		reserved2[3];
1200		uint64_t	size;
1201	} ld_list[MFI_MAX_LD];
1202} __packed;
1203
1204enum mfi_ld_access {
1205	MFI_LD_ACCESS_RW =	0,
1206	MFI_LD_ACCSSS_RO = 	2,
1207	MFI_LD_ACCESS_BLOCKED =	3,
1208};
1209#define MFI_LD_ACCESS_MASK	3
1210
1211enum mfi_ld_state {
1212	MFI_LD_STATE_OFFLINE =			0,
1213	MFI_LD_STATE_PARTIALLY_DEGRADED =	1,
1214	MFI_LD_STATE_DEGRADED =			2,
1215	MFI_LD_STATE_OPTIMAL =			3
1216};
1217
1218struct mfi_ld_props {
1219	union mfi_ld_ref	ld;
1220	char			name[16];
1221	uint8_t			default_cache_policy;
1222	uint8_t			access_policy;
1223	uint8_t			disk_cache_policy;
1224	uint8_t			current_cache_policy;
1225	uint8_t			no_bgi;
1226	uint8_t			reserved[7];
1227} __packed;
1228
1229struct mfi_ld_params {
1230	uint8_t			primary_raid_level;
1231	uint8_t			raid_level_qualifier;
1232	uint8_t			secondary_raid_level;
1233	uint8_t			stripe_size;
1234	uint8_t			num_drives;
1235	uint8_t			span_depth;
1236	uint8_t			state;
1237	uint8_t			init_state;
1238#define	MFI_LD_PARAMS_INIT_NO		0
1239#define	MFI_LD_PARAMS_INIT_QUICK	1
1240#define	MFI_LD_PARAMS_INIT_FULL		2
1241	uint8_t			is_consistent;
1242	uint8_t			reserved1[6];
1243	uint8_t			isSSCD;
1244	uint8_t			reserved2[16];
1245} __packed;
1246
1247struct mfi_ld_progress {
1248	uint32_t		active;
1249#define	MFI_LD_PROGRESS_CC	(1<<0)
1250#define	MFI_LD_PROGRESS_BGI	(1<<1)
1251#define	MFI_LD_PROGRESS_FGI	(1<<2)
1252#define	MFI_LD_PROGRESS_RECON	(1<<3)
1253	struct mfi_progress	cc;
1254	struct mfi_progress	bgi;
1255	struct mfi_progress	fgi;
1256	struct mfi_progress	recon;
1257	struct mfi_progress	reserved[4];
1258} __packed;
1259
1260struct mfi_span {
1261	uint64_t		start_block;
1262	uint64_t		num_blocks;
1263	uint16_t		array_ref;
1264	uint8_t			reserved[6];
1265} __packed;
1266
1267#define	MFI_MAX_SPAN_DEPTH	8
1268struct mfi_ld_config {
1269	struct mfi_ld_props	properties;
1270	struct mfi_ld_params	params;
1271	struct mfi_span		span[MFI_MAX_SPAN_DEPTH];
1272} __packed;
1273
1274struct mfi_ld_info {
1275	struct mfi_ld_config	ld_config;
1276	uint64_t		size;
1277	struct mfi_ld_progress	progress;
1278	uint16_t		cluster_owner;
1279	uint8_t			reconstruct_active;
1280	uint8_t			reserved1[1];
1281	uint8_t			vpd_page83[64];
1282	uint8_t			reserved2[16];
1283} __packed;
1284
1285#define MFI_MAX_ARRAYS 16
1286struct mfi_spare {
1287	union mfi_pd_ref	ref;
1288	uint8_t			spare_type;
1289#define	MFI_SPARE_DEDICATED	(1 << 0)
1290#define	MFI_SPARE_REVERTIBLE	(1 << 1)
1291#define	MFI_SPARE_ENCL_AFFINITY	(1 << 2)
1292	uint8_t			reserved[2];
1293	uint8_t			array_count;
1294	uint16_t		array_ref[MFI_MAX_ARRAYS];
1295} __packed;
1296
1297#define MFI_MAX_ROW_SIZE 32
1298struct mfi_array {
1299	uint64_t			size;
1300	uint8_t				num_drives;
1301	uint8_t				reserved;
1302	uint16_t			array_ref;
1303	uint8_t				pad[20];
1304	struct {
1305		union mfi_pd_ref	ref;	/* 0xffff == missing drive */
1306		uint16_t		fw_state;	/* MFI_PD_STATE_* */
1307		struct {
1308			uint8_t		pd;
1309			uint8_t		slot;
1310		} encl;
1311	} pd[MFI_MAX_ROW_SIZE];
1312} __packed;
1313
1314struct mfi_config_data {
1315	uint32_t		size;
1316	uint16_t		array_count;
1317	uint16_t		array_size;
1318	uint16_t		log_drv_count;
1319	uint16_t		log_drv_size;
1320	uint16_t		spares_count;
1321	uint16_t		spares_size;
1322	uint8_t			reserved[16];
1323	struct mfi_array	array[0];
1324	struct mfi_ld_config	ld[0];
1325	struct mfi_spare	spare[0];
1326} __packed;
1327
1328struct mfi_bbu_capacity_info {
1329	uint16_t		relative_charge;
1330	uint16_t		absolute_charge;
1331	uint16_t		remaining_capacity;
1332	uint16_t		full_charge_capacity;
1333	uint16_t		run_time_to_empty;
1334	uint16_t		average_time_to_empty;
1335	uint16_t		average_time_to_full;
1336	uint16_t		cycle_count;
1337	uint16_t		max_error;
1338	uint16_t		remaining_capacity_alarm;
1339	uint16_t		remaining_time_alarm;
1340	uint8_t			reserved[26];
1341} __packed;
1342
1343struct mfi_bbu_design_info {
1344	uint32_t		mfg_date;
1345	uint16_t		design_capacity;
1346	uint16_t		design_voltage;
1347	uint16_t		spec_info;
1348	uint16_t		serial_number;
1349	uint16_t		pack_stat_config;
1350	uint8_t			mfg_name[12];
1351	uint8_t			device_name[8];
1352	uint8_t			device_chemistry[8];
1353	uint8_t			mfg_data[8];
1354	uint8_t			reserved[17];
1355} __packed;
1356
1357struct mfi_ibbu_state {
1358	uint16_t		gas_guage_status;
1359	uint16_t		relative_charge;
1360	uint16_t		charger_system_state;
1361	uint16_t		charger_system_ctrl;
1362	uint16_t		charging_current;
1363	uint16_t		absolute_charge;
1364	uint16_t		max_error;
1365	uint8_t			reserved[18];
1366} __packed;
1367
1368struct mfi_bbu_state {
1369	uint16_t		gas_guage_status;
1370	uint16_t		relative_charge;
1371	uint16_t		charger_status;
1372	uint16_t		remaining_capacity;
1373	uint16_t		full_charge_capacity;
1374	uint8_t			is_SOH_good;
1375	uint8_t			reserved[21];
1376} __packed;
1377
1378struct mfi_bbu_properties {
1379	uint32_t		auto_learn_period;
1380	uint32_t		next_learn_time;
1381	uint8_t			learn_delay_interval;
1382	uint8_t			auto_learn_mode;
1383	uint8_t			bbu_mode;
1384	uint8_t			reserved[21];
1385} __packed;
1386
1387union mfi_bbu_status_detail {
1388	struct mfi_ibbu_state	ibbu;
1389	struct mfi_bbu_state	bbu;
1390};
1391
1392struct mfi_bbu_status {
1393	uint8_t			battery_type;
1394#define	MFI_BBU_TYPE_NONE	0
1395#define	MFI_BBU_TYPE_IBBU	1
1396#define	MFI_BBU_TYPE_BBU	2
1397	uint8_t			reserved;
1398	uint16_t		voltage;
1399	int16_t			current;
1400	uint16_t		temperature;
1401	uint32_t		fw_status;
1402#define	MFI_BBU_STATE_PACK_MISSING	(1 << 0)
1403#define	MFI_BBU_STATE_VOLTAGE_LOW	(1 << 1)
1404#define	MFI_BBU_STATE_TEMPERATURE_HIGH	(1 << 2)
1405#define	MFI_BBU_STATE_CHARGE_ACTIVE	(1 << 3)
1406#define	MFI_BBU_STATE_DISCHARGE_ACTIVE	(1 << 4)
1407#define	MFI_BBU_STATE_LEARN_CYC_REQ	(1 << 5)
1408#define	MFI_BBU_STATE_LEARN_CYC_ACTIVE	(1 << 6)
1409#define	MFI_BBU_STATE_LEARN_CYC_FAIL	(1 << 7)
1410#define	MFI_BBU_STATE_LEARN_CYC_TIMEOUT	(1 << 8)
1411#define	MFI_BBU_STATE_I2C_ERR_DETECT	(1 << 9)
1412	uint8_t			pad[20];
1413	union mfi_bbu_status_detail detail;
1414} __packed;
1415
1416enum mfi_pr_state {
1417	MFI_PR_STATE_STOPPED = 0,
1418	MFI_PR_STATE_READY = 1,
1419	MFI_PR_STATE_ACTIVE = 2,
1420	MFI_PR_STATE_ABORTED = 0xff
1421};
1422
1423struct mfi_pr_status {
1424	uint32_t		num_iteration;
1425	uint8_t			state;
1426	uint8_t			num_pd_done;
1427	uint8_t			reserved[10];
1428};
1429
1430enum mfi_pr_opmode {
1431	MFI_PR_OPMODE_AUTO = 0,
1432	MFI_PR_OPMODE_MANUAL = 1,
1433	MFI_PR_OPMODE_DISABLED = 2
1434};
1435
1436struct mfi_pr_properties {
1437	uint8_t			op_mode;
1438	uint8_t			max_pd;
1439	uint8_t			reserved;
1440	uint8_t			exclude_ld_count;
1441	uint16_t		excluded_ld[MFI_MAX_LD];
1442	uint8_t			cur_pd_map[MFI_MAX_PD / 8];
1443	uint8_t			last_pd_map[MFI_MAX_PD / 8];
1444	uint32_t		next_exec;
1445	uint32_t		exec_freq;
1446	uint32_t		clear_freq;
1447};
1448
1449/* ThunderBolt support */
1450
1451/*
1452 * Raid Context structure which describes MegaRAID specific IO Paramenters
1453 * This resides at offset 0x60 where the SGL normally starts in MPT IO Frames
1454 */
1455typedef struct _MPI2_SCSI_IO_VENDOR_UNIQUE {
1456	uint16_t	resvd0;		/* 0x00 - 0x01 */
1457	uint16_t	timeoutValue;	/* 0x02 - 0x03 */
1458	uint8_t		regLockFlags;
1459	uint8_t		armId;
1460	uint16_t	TargetID;	/* 0x06 - 0x07 */
1461
1462	uint64_t	RegLockLBA;	/* 0x08 - 0x0F */
1463
1464	uint32_t	RegLockLength;	/* 0x10 - 0x13 */
1465
1466	uint16_t	SMID;		/* 0x14 - 0x15 nextLMId */
1467	uint8_t		exStatus;	/* 0x16 */
1468	uint8_t		Status;		/* 0x17 status */
1469
1470	uint8_t		RAIDFlags;	/* 0x18 */
1471	uint8_t		numSGE;		/* 0x19 numSge */
1472	uint16_t	configSeqNum;	/* 0x1A - 0x1B */
1473	uint8_t		spanArm;	/* 0x1C */
1474	uint8_t		resvd2[3];	/* 0x1D - 0x1F */
1475} MPI2_SCSI_IO_VENDOR_UNIQUE, MPI25_SCSI_IO_VENDOR_UNIQUE;
1476
1477/*****************************************************************************
1478*
1479*        Message Functions
1480*
1481*****************************************************************************/
1482
1483#define NA_MPI2_FUNCTION_SCSI_IO_REQUEST            (0x00) /* SCSI IO */
1484#define MPI2_FUNCTION_SCSI_TASK_MGMT                (0x01) /* SCSI Task Management */
1485#define MPI2_FUNCTION_IOC_INIT                      (0x02) /* IOC Init */
1486#define MPI2_FUNCTION_IOC_FACTS                     (0x03) /* IOC Facts */
1487#define MPI2_FUNCTION_CONFIG                        (0x04) /* Configuration */
1488#define MPI2_FUNCTION_PORT_FACTS                    (0x05) /* Port Facts */
1489#define MPI2_FUNCTION_PORT_ENABLE                   (0x06) /* Port Enable */
1490#define MPI2_FUNCTION_EVENT_NOTIFICATION            (0x07) /* Event Notification */
1491#define MPI2_FUNCTION_EVENT_ACK                     (0x08) /* Event Acknowledge */
1492#define MPI2_FUNCTION_FW_DOWNLOAD                   (0x09) /* FW Download */
1493#define MPI2_FUNCTION_TARGET_ASSIST                 (0x0B) /* Target Assist */
1494#define MPI2_FUNCTION_TARGET_STATUS_SEND            (0x0C) /* Target Status Send */
1495#define MPI2_FUNCTION_TARGET_MODE_ABORT             (0x0D) /* Target Mode Abort */
1496#define MPI2_FUNCTION_FW_UPLOAD                     (0x12) /* FW Upload */
1497#define MPI2_FUNCTION_RAID_ACTION                   (0x15) /* RAID Action */
1498#define MPI2_FUNCTION_RAID_SCSI_IO_PASSTHROUGH      (0x16) /* SCSI IO RAID Passthrough */
1499#define MPI2_FUNCTION_TOOLBOX                       (0x17) /* Toolbox */
1500#define MPI2_FUNCTION_SCSI_ENCLOSURE_PROCESSOR      (0x18) /* SCSI Enclosure Processor */
1501#define MPI2_FUNCTION_SMP_PASSTHROUGH               (0x1A) /* SMP Passthrough */
1502#define MPI2_FUNCTION_SAS_IO_UNIT_CONTROL           (0x1B) /* SAS IO Unit Control */
1503#define MPI2_FUNCTION_SATA_PASSTHROUGH              (0x1C) /* SATA Passthrough */
1504#define MPI2_FUNCTION_DIAG_BUFFER_POST              (0x1D) /* Diagnostic Buffer Post */
1505#define MPI2_FUNCTION_DIAG_RELEASE                  (0x1E) /* Diagnostic Release */
1506#define MPI2_FUNCTION_TARGET_CMD_BUF_BASE_POST      (0x24) /* Target Command Buffer Post Base */
1507#define MPI2_FUNCTION_TARGET_CMD_BUF_LIST_POST      (0x25) /* Target Command Buffer Post List */
1508#define MPI2_FUNCTION_RAID_ACCELERATOR              (0x2C) /* RAID Accelerator */
1509#define MPI2_FUNCTION_HOST_BASED_DISCOVERY_ACTION   (0x2F) /* Host Based Discovery Action */
1510#define MPI2_FUNCTION_PWR_MGMT_CONTROL              (0x30) /* Power Management Control */
1511#define MPI2_FUNCTION_MIN_PRODUCT_SPECIFIC          (0xF0) /* beginning of product-specific range */
1512#define MPI2_FUNCTION_MAX_PRODUCT_SPECIFIC          (0xFF) /* end of product-specific range */
1513
1514/* Doorbell functions */
1515#define MPI2_FUNCTION_IOC_MESSAGE_UNIT_RESET        (0x40)
1516#define MPI2_FUNCTION_HANDSHAKE                     (0x42)
1517
1518/*****************************************************************************
1519*
1520*        MPI Version Definitions
1521*
1522*****************************************************************************/
1523
1524#define MPI2_VERSION_MAJOR                  (0x02)
1525#define MPI2_VERSION_MINOR                  (0x00)
1526#define MPI2_VERSION_MAJOR_MASK             (0xFF00)
1527#define MPI2_VERSION_MAJOR_SHIFT            (8)
1528#define MPI2_VERSION_MINOR_MASK             (0x00FF)
1529#define MPI2_VERSION_MINOR_SHIFT            (0)
1530#define MPI2_VERSION ((MPI2_VERSION_MAJOR << MPI2_VERSION_MAJOR_SHIFT) |   \
1531                                      MPI2_VERSION_MINOR)
1532
1533#define MPI2_VERSION_02_00                  (0x0200)
1534
1535/* versioning for this MPI header set */
1536#define MPI2_HEADER_VERSION_UNIT            (0x10)
1537#define MPI2_HEADER_VERSION_DEV             (0x00)
1538#define MPI2_HEADER_VERSION_UNIT_MASK       (0xFF00)
1539#define MPI2_HEADER_VERSION_UNIT_SHIFT      (8)
1540#define MPI2_HEADER_VERSION_DEV_MASK        (0x00FF)
1541#define MPI2_HEADER_VERSION_DEV_SHIFT       (0)
1542#define MPI2_HEADER_VERSION ((MPI2_HEADER_VERSION_UNIT << 8) |		\
1543					MPI2_HEADER_VERSION_DEV)
1544
1545/* IOCInit Request message */
1546struct MPI2_IOC_INIT_REQUEST {
1547	uint8_t		WhoInit;                        /* 0x00 */
1548	uint8_t		Reserved1;                      /* 0x01 */
1549	uint8_t		ChainOffset;                    /* 0x02 */
1550	uint8_t		Function;                       /* 0x03 */
1551	uint16_t	Reserved2;                      /* 0x04 */
1552	uint8_t		Reserved3;                      /* 0x06 */
1553	uint8_t		MsgFlags;                       /* 0x07 */
1554	uint8_t		VP_ID;                          /* 0x08 */
1555	uint8_t		VF_ID;                          /* 0x09 */
1556	uint16_t	Reserved4;                      /* 0x0A */
1557	uint16_t	MsgVersion;                     /* 0x0C */
1558	uint16_t	HeaderVersion;                  /* 0x0E */
1559	uint32_t	Reserved5;                      /* 0x10 */
1560	uint16_t	Reserved6;                      /* 0x14 */
1561	uint8_t		Reserved7;                      /* 0x16 */
1562	uint8_t		HostMSIxVectors;                /* 0x17 */
1563	uint16_t	Reserved8;                      /* 0x18 */
1564	uint16_t	SystemRequestFrameSize;         /* 0x1A */
1565	uint16_t	ReplyDescriptorPostQueueDepth;  /* 0x1C */
1566	uint16_t	ReplyFreeQueueDepth;            /* 0x1E */
1567	uint32_t	SenseBufferAddressHigh;         /* 0x20 */
1568	uint32_t	SystemReplyAddressHigh;         /* 0x24 */
1569	uint64_t	SystemRequestFrameBaseAddress;  /* 0x28 */
1570	uint64_t	ReplyDescriptorPostQueueAddress;/* 0x30 */
1571	uint64_t	ReplyFreeQueueAddress;          /* 0x38 */
1572	uint64_t	TimeStamp;                      /* 0x40 */
1573};
1574
1575/* WhoInit values */
1576#define MPI2_WHOINIT_NOT_INITIALIZED            (0x00)
1577#define MPI2_WHOINIT_SYSTEM_BIOS                (0x01)
1578#define MPI2_WHOINIT_ROM_BIOS                   (0x02)
1579#define MPI2_WHOINIT_PCI_PEER                   (0x03)
1580#define MPI2_WHOINIT_HOST_DRIVER                (0x04)
1581#define MPI2_WHOINIT_MANUFACTURER               (0x05)
1582
1583struct MPI2_SGE_CHAIN_UNION {
1584	uint16_t	Length;
1585	uint8_t		NextChainOffset;
1586	uint8_t		Flags;
1587	union {
1588		uint32_t	Address32;
1589		uint64_t	Address64;
1590	} u;
1591};
1592
1593struct MPI2_IEEE_SGE_SIMPLE32 {
1594	uint32_t	Address;
1595	uint32_t	FlagsLength;
1596};
1597
1598struct MPI2_IEEE_SGE_SIMPLE64 {
1599	uint64_t	Address;
1600	uint32_t	Length;
1601	uint16_t	Reserved1;
1602	uint8_t		Reserved2;
1603	uint8_t		Flags;
1604};
1605
1606typedef union _MPI2_IEEE_SGE_SIMPLE_UNION {
1607	struct MPI2_IEEE_SGE_SIMPLE32	Simple32;
1608	struct MPI2_IEEE_SGE_SIMPLE64	Simple64;
1609} MPI2_IEEE_SGE_SIMPLE_UNION;
1610
1611typedef struct _MPI2_SGE_SIMPLE_UNION {
1612	uint32_t	FlagsLength;
1613	union {
1614		uint32_t	Address32;
1615		uint64_t	Address64;
1616	} u;
1617} MPI2_SGE_SIMPLE_UNION;
1618
1619/****************************************************************************
1620*  IEEE SGE field definitions and masks
1621****************************************************************************/
1622
1623/* Flags field bit definitions */
1624
1625#define MPI2_IEEE_SGE_FLAGS_ELEMENT_TYPE_MASK   (0x80)
1626
1627#define MPI2_IEEE32_SGE_FLAGS_SHIFT             (24)
1628
1629#define MPI2_IEEE32_SGE_LENGTH_MASK             (0x00FFFFFF)
1630
1631/* Element Type */
1632
1633#define MPI2_IEEE_SGE_FLAGS_SIMPLE_ELEMENT      (0x00)
1634#define MPI2_IEEE_SGE_FLAGS_CHAIN_ELEMENT       (0x80)
1635
1636/* Data Location Address Space */
1637
1638#define MPI2_IEEE_SGE_FLAGS_ADDR_MASK           (0x03)
1639#define MPI2_IEEE_SGE_FLAGS_SYSTEM_ADDR         (0x00)
1640#define MPI2_IEEE_SGE_FLAGS_IOCDDR_ADDR         (0x01)
1641#define MPI2_IEEE_SGE_FLAGS_IOCPLB_ADDR         (0x02)
1642#define MPI2_IEEE_SGE_FLAGS_IOCPLBNTA_ADDR      (0x03)
1643
1644/* Address Size */
1645
1646#define MPI2_SGE_FLAGS_32_BIT_ADDRESSING        (0x00)
1647#define MPI2_SGE_FLAGS_64_BIT_ADDRESSING        (0x02)
1648
1649/*******************/
1650/* SCSI IO Control bits */
1651#define MPI2_SCSIIO_CONTROL_ADDCDBLEN_MASK      (0xFC000000)
1652#define MPI2_SCSIIO_CONTROL_ADDCDBLEN_SHIFT     (26)
1653
1654#define MPI2_SCSIIO_CONTROL_DATADIRECTION_MASK  (0x03000000)
1655#define MPI2_SCSIIO_CONTROL_NODATATRANSFER      (0x00000000)
1656#define MPI2_SCSIIO_CONTROL_WRITE               (0x01000000)
1657#define MPI2_SCSIIO_CONTROL_READ                (0x02000000)
1658#define MPI2_SCSIIO_CONTROL_BIDIRECTIONAL       (0x03000000)
1659
1660#define MPI2_SCSIIO_CONTROL_TASKPRI_MASK        (0x00007800)
1661#define MPI2_SCSIIO_CONTROL_TASKPRI_SHIFT       (11)
1662
1663#define MPI2_SCSIIO_CONTROL_TASKATTRIBUTE_MASK  (0x00000700)
1664#define MPI2_SCSIIO_CONTROL_SIMPLEQ             (0x00000000)
1665#define MPI2_SCSIIO_CONTROL_HEADOFQ             (0x00000100)
1666#define MPI2_SCSIIO_CONTROL_ORDEREDQ            (0x00000200)
1667#define MPI2_SCSIIO_CONTROL_ACAQ                (0x00000400)
1668
1669#define MPI2_SCSIIO_CONTROL_TLR_MASK            (0x000000C0)
1670#define MPI2_SCSIIO_CONTROL_NO_TLR              (0x00000000)
1671#define MPI2_SCSIIO_CONTROL_TLR_ON              (0x00000040)
1672#define MPI2_SCSIIO_CONTROL_TLR_OFF             (0x00000080)
1673
1674/*******************/
1675
1676typedef struct {
1677	uint8_t		CDB[20];                    /* 0x00 */
1678	uint32_t	PrimaryReferenceTag;        /* 0x14 */
1679	uint16_t	PrimaryApplicationTag;      /* 0x18 */
1680	uint16_t	PrimaryApplicationTagMask;  /* 0x1A */
1681	uint32_t	TransferLength;             /* 0x1C */
1682} MPI2_SCSI_IO_CDB_EEDP32;
1683
1684typedef union _MPI2_IEEE_SGE_CHAIN_UNION {
1685	struct MPI2_IEEE_SGE_SIMPLE32	Chain32;
1686	struct MPI2_IEEE_SGE_SIMPLE64	Chain64;
1687} MPI2_IEEE_SGE_CHAIN_UNION;
1688
1689typedef union _MPI2_SIMPLE_SGE_UNION {
1690	MPI2_SGE_SIMPLE_UNION		MpiSimple;
1691	MPI2_IEEE_SGE_SIMPLE_UNION	IeeeSimple;
1692} MPI2_SIMPLE_SGE_UNION;
1693
1694typedef union _MPI2_SGE_IO_UNION {
1695	MPI2_SGE_SIMPLE_UNION		MpiSimple;
1696	struct MPI2_SGE_CHAIN_UNION	MpiChain;
1697	MPI2_IEEE_SGE_SIMPLE_UNION	IeeeSimple;
1698	MPI2_IEEE_SGE_CHAIN_UNION	IeeeChain;
1699} MPI2_SGE_IO_UNION;
1700
1701typedef union {
1702	uint8_t			CDB32[32];
1703	MPI2_SCSI_IO_CDB_EEDP32	EEDP32;
1704	MPI2_SGE_SIMPLE_UNION	SGE;
1705} MPI2_SCSI_IO_CDB_UNION;
1706
1707/* MPI 2.5 SGLs */
1708
1709#define MPI25_IEEE_SGE_FLAGS_END_OF_LIST        (0x40)
1710
1711typedef struct _MPI25_IEEE_SGE_CHAIN64 {
1712	uint64_t	Address;
1713	uint32_t	Length;
1714	uint16_t	Reserved1;
1715	uint8_t		NextChainOffset;
1716	uint8_t		Flags;
1717} MPI25_IEEE_SGE_CHAIN64, *pMpi25IeeeSgeChain64_t;
1718
1719/* use MPI2_IEEE_SGE_FLAGS_ defines for the Flags field */
1720
1721/********/
1722
1723/*
1724 * RAID SCSI IO Request Message
1725 * Total SGE count will be one less than  _MPI2_SCSI_IO_REQUEST
1726 */
1727struct mfi_mpi2_request_raid_scsi_io {
1728	uint16_t		DevHandle;                      /* 0x00 */
1729	uint8_t			ChainOffset;                    /* 0x02 */
1730	uint8_t			Function;                       /* 0x03 */
1731	uint16_t		Reserved1;                      /* 0x04 */
1732	uint8_t			Reserved2;                      /* 0x06 */
1733	uint8_t			MsgFlags;                       /* 0x07 */
1734	uint8_t			VP_ID;                          /* 0x08 */
1735	uint8_t			VF_ID;                          /* 0x09 */
1736	uint16_t		Reserved3;                      /* 0x0A */
1737	uint32_t		SenseBufferLowAddress;          /* 0x0C */
1738	uint16_t		SGLFlags;                       /* 0x10 */
1739	uint8_t			SenseBufferLength;              /* 0x12 */
1740	uint8_t			Reserved4;                      /* 0x13 */
1741	uint8_t			SGLOffset0;                     /* 0x14 */
1742	uint8_t			SGLOffset1;                     /* 0x15 */
1743	uint8_t			SGLOffset2;                     /* 0x16 */
1744	uint8_t			SGLOffset3;                     /* 0x17 */
1745	uint32_t		SkipCount;                      /* 0x18 */
1746	uint32_t		DataLength;                     /* 0x1C */
1747	uint32_t		BidirectionalDataLength;        /* 0x20 */
1748	uint16_t		IoFlags;                        /* 0x24 */
1749	uint16_t		EEDPFlags;                      /* 0x26 */
1750	uint32_t		EEDPBlockSize;                  /* 0x28 */
1751	uint32_t		SecondaryReferenceTag;          /* 0x2C */
1752	uint16_t		SecondaryApplicationTag;        /* 0x30 */
1753	uint16_t		ApplicationTagTranslationMask;  /* 0x32 */
1754	uint8_t			LUN[8];                         /* 0x34 */
1755	uint32_t		Control;                        /* 0x3C */
1756	MPI2_SCSI_IO_CDB_UNION	CDB;                            /* 0x40 */
1757	MPI2_SCSI_IO_VENDOR_UNIQUE	RaidContext;              /* 0x60 */
1758	MPI2_SGE_IO_UNION	SGL;                            /* 0x80 */
1759} __packed;
1760
1761/*
1762 * MPT RAID MFA IO Descriptor.
1763 */
1764typedef struct _MFI_RAID_MFA_IO_DESCRIPTOR {
1765	uint32_t	RequestFlags : 8;
1766	uint32_t	MessageAddress1 : 24; /* bits 31:8*/
1767	uint32_t	MessageAddress2;      /* bits 61:32 */
1768} MFI_RAID_MFA_IO_REQUEST_DESCRIPTOR,*PMFI_RAID_MFA_IO_REQUEST_DESCRIPTOR;
1769
1770struct mfi_mpi2_request_header {
1771	uint8_t		RequestFlags;       /* 0x00 */
1772	uint8_t		MSIxIndex;          /* 0x01 */
1773	uint16_t	SMID;               /* 0x02 */
1774	uint16_t	LMID;               /* 0x04 */
1775};
1776
1777/* defines for the RequestFlags field */
1778#define MPI2_REQ_DESCRIPT_FLAGS_TYPE_MASK               (0x0E)
1779#define MPI2_REQ_DESCRIPT_FLAGS_SCSI_IO                 (0x00)
1780#define MPI2_REQ_DESCRIPT_FLAGS_SCSI_TARGET             (0x02)
1781#define MPI2_REQ_DESCRIPT_FLAGS_HIGH_PRIORITY           (0x06)
1782#define MPI2_REQ_DESCRIPT_FLAGS_DEFAULT_TYPE            (0x08)
1783#define MPI2_REQ_DESCRIPT_FLAGS_RAID_ACCELERATOR        (0x0A)
1784
1785#define MPI2_REQ_DESCRIPT_FLAGS_IOC_FIFO_MARKER (0x01)
1786
1787struct mfi_mpi2_request_high_priority {
1788	struct mfi_mpi2_request_header	header;
1789	uint16_t			reserved;
1790};
1791
1792struct mfi_mpi2_request_scsi_io {
1793	struct mfi_mpi2_request_header	header;
1794	uint16_t			scsi_io_dev_handle;
1795};
1796
1797struct mfi_mpi2_request_scsi_target {
1798	struct mfi_mpi2_request_header	header;
1799	uint16_t			scsi_target_io_index;
1800};
1801
1802/* Request Descriptors */
1803union mfi_mpi2_request_descriptor {
1804	struct mfi_mpi2_request_header		header;
1805	struct mfi_mpi2_request_high_priority	high_priority;
1806	struct mfi_mpi2_request_scsi_io		scsi_io;
1807	struct mfi_mpi2_request_scsi_target	scsi_target;
1808	uint64_t				words;
1809};
1810
1811struct mfi_mpi2_reply_header {
1812	uint8_t		ReplyFlags;                 /* 0x00 */
1813	uint8_t		MSIxIndex;                  /* 0x01 */
1814	uint16_t	SMID;                       /* 0x02 */
1815};
1816
1817/* defines for the ReplyFlags field */
1818#define MPI2_RPY_DESCRIPT_FLAGS_TYPE_MASK                   (0x0F)
1819#define MPI2_RPY_DESCRIPT_FLAGS_SCSI_IO_SUCCESS             (0x00)
1820#define MPI2_RPY_DESCRIPT_FLAGS_ADDRESS_REPLY               (0x01)
1821#define MPI2_RPY_DESCRIPT_FLAGS_TARGETASSIST_SUCCESS        (0x02)
1822#define MPI2_RPY_DESCRIPT_FLAGS_TARGET_COMMAND_BUFFER       (0x03)
1823#define MPI2_RPY_DESCRIPT_FLAGS_RAID_ACCELERATOR_SUCCESS    (0x05)
1824#define MPI2_RPY_DESCRIPT_FLAGS_UNUSED                      (0x0F)
1825
1826/* values for marking a reply descriptor as unused */
1827#define MPI2_RPY_DESCRIPT_UNUSED_WORD0_MARK             (0xFFFFFFFF)
1828#define MPI2_RPY_DESCRIPT_UNUSED_WORD1_MARK             (0xFFFFFFFF)
1829
1830struct mfi_mpi2_reply_default {
1831	struct mfi_mpi2_reply_header	header;
1832	uint32_t			DescriptorTypeDependent2;
1833};
1834
1835struct mfi_mpi2_reply_address {
1836	struct mfi_mpi2_reply_header	header;
1837	uint32_t			ReplyFrameAddress;
1838};
1839
1840struct mfi_mpi2_reply_scsi_io {
1841	struct mfi_mpi2_reply_header	header;
1842	uint16_t			TaskTag;		/* 0x04 */
1843	uint16_t			Reserved1;		/* 0x06 */
1844};
1845
1846struct mfi_mpi2_reply_target_assist {
1847	struct mfi_mpi2_reply_header	header;
1848	uint8_t				SequenceNumber;		/* 0x04 */
1849	uint8_t				Reserved1;		/* 0x04 */
1850	uint16_t			IoIndex;		/* 0x06 */
1851};
1852
1853struct mfi_mpi2_reply_target_cmd_buffer {
1854	struct mfi_mpi2_reply_header	header;
1855	uint8_t				SequenceNumber;		/* 0x04 */
1856	uint8_t				Flags;			/* 0x04 */
1857	uint16_t			InitiatorDevHandle;	/* 0x06 */
1858	uint16_t			IoIndex;		/* 0x06 */
1859};
1860
1861struct mfi_mpi2_reply_raid_accel {
1862	struct mfi_mpi2_reply_header	header;
1863	uint8_t				SequenceNumber;		/* 0x04 */
1864	uint32_t			Reserved;		/* 0x04 */
1865};
1866
1867/* union of Reply Descriptors */
1868union mfi_mpi2_reply_descriptor {
1869	struct mfi_mpi2_reply_header		header;
1870	struct mfi_mpi2_reply_scsi_io		scsi_io;
1871	struct mfi_mpi2_reply_target_assist	target_assist;
1872	struct mfi_mpi2_reply_target_cmd_buffer	target_cmd;
1873	struct mfi_mpi2_reply_raid_accel	raid_accel;
1874	struct mfi_mpi2_reply_default		reply_default;
1875	uint64_t				words;
1876};
1877
1878struct IO_REQUEST_INFO {
1879	uint64_t	ldStartBlock;
1880	uint32_t	numBlocks;
1881	uint16_t	ldTgtId;
1882	uint8_t		isRead;
1883	uint16_t	devHandle;
1884	uint64_t	pdBlock;
1885	uint8_t		fpOkForIo;
1886};
1887
1888#define MFI_SCSI_MAX_TARGETS	128
1889#define MFI_SCSI_MAX_LUNS	8
1890#define MFI_SCSI_INITIATOR_ID	255
1891#define MFI_SCSI_MAX_CMDS	8
1892#define MFI_SCSI_MAX_CDB_LEN	16
1893
1894#endif /* _MFIREG_H */