| /* SPDX-License-Identifier: GPL-2.0-or-later WITH Linux-syscall-note */ |
| /* |
| * Driver for Broadcom MPI3 Storage Controllers |
| * |
| * Copyright (C) 2017-2022 Broadcom Inc. |
| * (mailto: mpi3mr-linuxdrv.pdl@broadcom.com) |
| * |
| */ |
| |
| #ifndef SCSI_BSG_MPI3MR_H_INCLUDED |
| #define SCSI_BSG_MPI3MR_H_INCLUDED |
| |
| #include <linux/types.h> |
| |
| /* Definitions for BSG commands */ |
| #define MPI3MR_IOCTL_VERSION 0x06 |
| |
| #define MPI3MR_APP_DEFAULT_TIMEOUT (60) /*seconds*/ |
| |
| #define MPI3MR_BSG_ADPTYPE_UNKNOWN 0 |
| #define MPI3MR_BSG_ADPTYPE_AVGFAMILY 1 |
| |
| #define MPI3MR_BSG_ADPSTATE_UNKNOWN 0 |
| #define MPI3MR_BSG_ADPSTATE_OPERATIONAL 1 |
| #define MPI3MR_BSG_ADPSTATE_FAULT 2 |
| #define MPI3MR_BSG_ADPSTATE_IN_RESET 3 |
| #define MPI3MR_BSG_ADPSTATE_UNRECOVERABLE 4 |
| |
| #define MPI3MR_BSG_ADPRESET_UNKNOWN 0 |
| #define MPI3MR_BSG_ADPRESET_SOFT 1 |
| #define MPI3MR_BSG_ADPRESET_DIAG_FAULT 2 |
| |
| #define MPI3MR_BSG_LOGDATA_MAX_ENTRIES 400 |
| #define MPI3MR_BSG_LOGDATA_ENTRY_HEADER_SZ 4 |
| |
| #define MPI3MR_DRVBSG_OPCODE_UNKNOWN 0 |
| #define MPI3MR_DRVBSG_OPCODE_ADPINFO 1 |
| #define MPI3MR_DRVBSG_OPCODE_ADPRESET 2 |
| #define MPI3MR_DRVBSG_OPCODE_ALLTGTDEVINFO 4 |
| #define MPI3MR_DRVBSG_OPCODE_GETCHGCNT 5 |
| #define MPI3MR_DRVBSG_OPCODE_LOGDATAENABLE 6 |
| #define MPI3MR_DRVBSG_OPCODE_PELENABLE 7 |
| #define MPI3MR_DRVBSG_OPCODE_GETLOGDATA 8 |
| #define MPI3MR_DRVBSG_OPCODE_QUERY_HDB 9 |
| #define MPI3MR_DRVBSG_OPCODE_REPOST_HDB 10 |
| #define MPI3MR_DRVBSG_OPCODE_UPLOAD_HDB 11 |
| #define MPI3MR_DRVBSG_OPCODE_REFRESH_HDB_TRIGGERS 12 |
| |
| |
| #define MPI3MR_BSG_BUFTYPE_UNKNOWN 0 |
| #define MPI3MR_BSG_BUFTYPE_RAIDMGMT_CMD 1 |
| #define MPI3MR_BSG_BUFTYPE_RAIDMGMT_RESP 2 |
| #define MPI3MR_BSG_BUFTYPE_DATA_IN 3 |
| #define MPI3MR_BSG_BUFTYPE_DATA_OUT 4 |
| #define MPI3MR_BSG_BUFTYPE_MPI_REPLY 5 |
| #define MPI3MR_BSG_BUFTYPE_ERR_RESPONSE 6 |
| #define MPI3MR_BSG_BUFTYPE_MPI_REQUEST 0xFE |
| |
| #define MPI3MR_BSG_MPI_REPLY_BUFTYPE_UNKNOWN 0 |
| #define MPI3MR_BSG_MPI_REPLY_BUFTYPE_STATUS 1 |
| #define MPI3MR_BSG_MPI_REPLY_BUFTYPE_ADDRESS 2 |
| |
| #define MPI3MR_HDB_BUFTYPE_UNKNOWN 0 |
| #define MPI3MR_HDB_BUFTYPE_TRACE 1 |
| #define MPI3MR_HDB_BUFTYPE_FIRMWARE 2 |
| #define MPI3MR_HDB_BUFTYPE_RESERVED 3 |
| |
| #define MPI3MR_HDB_BUFSTATUS_UNKNOWN 0 |
| #define MPI3MR_HDB_BUFSTATUS_NOT_ALLOCATED 1 |
| #define MPI3MR_HDB_BUFSTATUS_POSTED_UNPAUSED 2 |
| #define MPI3MR_HDB_BUFSTATUS_POSTED_PAUSED 3 |
| #define MPI3MR_HDB_BUFSTATUS_RELEASED 4 |
| |
| #define MPI3MR_HDB_TRIGGER_TYPE_UNKNOWN 0 |
| #define MPI3MR_HDB_TRIGGER_TYPE_DIAGFAULT 1 |
| #define MPI3MR_HDB_TRIGGER_TYPE_ELEMENT 2 |
| #define MPI3MR_HDB_TRIGGER_TYPE_MASTER 3 |
| |
| |
| /* Supported BSG commands */ |
| enum command { |
| MPI3MR_DRV_CMD = 1, |
| MPI3MR_MPT_CMD = 2, |
| }; |
| |
| /** |
| * struct mpi3_driver_info_layout - Information about driver |
| * |
| * @information_length: Length of this structure in bytes |
| * @driver_signature: Driver Vendor name |
| * @os_name: Operating System Name |
| * @driver_name: Driver name |
| * @driver_version: Driver version |
| * @driver_release_date: Driver release date |
| * @driver_capabilities: Driver capabilities |
| */ |
| struct mpi3_driver_info_layout { |
| __le32 information_length; |
| __u8 driver_signature[12]; |
| __u8 os_name[16]; |
| __u8 os_version[12]; |
| __u8 driver_name[20]; |
| __u8 driver_version[32]; |
| __u8 driver_release_date[20]; |
| __le32 driver_capabilities; |
| }; |
| |
| /** |
| * struct mpi3mr_bsg_in_adpinfo - Adapter information request |
| * data returned by the driver. |
| * |
| * @adp_type: Adapter type |
| * @rsvd1: Reserved |
| * @pci_dev_id: PCI device ID of the adapter |
| * @pci_dev_hw_rev: PCI revision of the adapter |
| * @pci_subsys_dev_id: PCI subsystem device ID of the adapter |
| * @pci_subsys_ven_id: PCI subsystem vendor ID of the adapter |
| * @pci_dev: PCI device |
| * @pci_func: PCI function |
| * @pci_bus: PCI bus |
| * @rsvd2: Reserved |
| * @pci_seg_id: PCI segment ID |
| * @app_intfc_ver: version of the application interface definition |
| * @rsvd3: Reserved |
| * @rsvd4: Reserved |
| * @rsvd5: Reserved |
| * @driver_info: Driver Information (Version/Name) |
| */ |
| struct mpi3mr_bsg_in_adpinfo { |
| __u32 adp_type; |
| __u32 rsvd1; |
| __u32 pci_dev_id; |
| __u32 pci_dev_hw_rev; |
| __u32 pci_subsys_dev_id; |
| __u32 pci_subsys_ven_id; |
| __u32 pci_dev:5; |
| __u32 pci_func:3; |
| __u32 pci_bus:8; |
| __u16 rsvd2; |
| __u32 pci_seg_id; |
| __u32 app_intfc_ver; |
| __u8 adp_state; |
| __u8 rsvd3; |
| __u16 rsvd4; |
| __u32 rsvd5[2]; |
| struct mpi3_driver_info_layout driver_info; |
| }; |
| |
| /** |
| * struct mpi3mr_bsg_adp_reset - Adapter reset request |
| * payload data to the driver. |
| * |
| * @reset_type: Reset type |
| * @rsvd1: Reserved |
| * @rsvd2: Reserved |
| */ |
| struct mpi3mr_bsg_adp_reset { |
| __u8 reset_type; |
| __u8 rsvd1; |
| __u16 rsvd2; |
| }; |
| |
| /** |
| * struct mpi3mr_change_count - Topology change count |
| * returned by the driver. |
| * |
| * @change_count: Topology change count |
| * @rsvd: Reserved |
| */ |
| struct mpi3mr_change_count { |
| __u16 change_count; |
| __u16 rsvd; |
| }; |
| |
| /** |
| * struct mpi3mr_device_map_info - Target device mapping |
| * information |
| * |
| * @handle: Firmware device handle |
| * @perst_id: Persistent ID assigned by the firmware |
| * @target_id: Target ID assigned by the driver |
| * @bus_id: Bus ID assigned by the driver |
| * @rsvd1: Reserved |
| * @rsvd2: Reserved |
| */ |
| struct mpi3mr_device_map_info { |
| __u16 handle; |
| __u16 perst_id; |
| __u32 target_id; |
| __u8 bus_id; |
| __u8 rsvd1; |
| __u16 rsvd2; |
| }; |
| |
| /** |
| * struct mpi3mr_all_tgt_info - Target device mapping |
| * information returned by the driver |
| * |
| * @num_devices: The number of devices in driver's inventory |
| * @rsvd1: Reserved |
| * @rsvd2: Reserved |
| * @dmi: Variable length array of mapping information of targets |
| */ |
| struct mpi3mr_all_tgt_info { |
| __u16 num_devices; |
| __u16 rsvd1; |
| __u32 rsvd2; |
| struct mpi3mr_device_map_info dmi[1]; |
| }; |
| |
| /** |
| * struct mpi3mr_logdata_enable - Number of log data |
| * entries saved by the driver returned as payload data for |
| * enable logdata BSG request by the driver. |
| * |
| * @max_entries: Number of log data entries cached by the driver |
| * @rsvd: Reserved |
| */ |
| struct mpi3mr_logdata_enable { |
| __u16 max_entries; |
| __u16 rsvd; |
| }; |
| |
| /** |
| * struct mpi3mr_bsg_out_pel_enable - PEL enable request payload |
| * data to the driver. |
| * |
| * @pel_locale: PEL locale to the firmware |
| * @pel_class: PEL class to the firmware |
| * @rsvd: Reserved |
| */ |
| struct mpi3mr_bsg_out_pel_enable { |
| __u16 pel_locale; |
| __u8 pel_class; |
| __u8 rsvd; |
| }; |
| |
| /** |
| * struct mpi3mr_logdata_entry - Log data entry cached by the |
| * driver. |
| * |
| * @valid_entry: Is the entry valid |
| * @rsvd1: Reserved |
| * @rsvd2: Reserved |
| * @data: Variable length Log entry data |
| */ |
| struct mpi3mr_logdata_entry { |
| __u8 valid_entry; |
| __u8 rsvd1; |
| __u16 rsvd2; |
| __u8 data[1]; /* Variable length Array */ |
| }; |
| |
| /** |
| * struct mpi3mr_bsg_in_log_data - Log data entries saved by |
| * the driver returned as payload data for Get logdata request |
| * by the driver. |
| * |
| * @entry: Variable length Log data entry array |
| */ |
| struct mpi3mr_bsg_in_log_data { |
| struct mpi3mr_logdata_entry entry[1]; |
| }; |
| |
| /** |
| * struct mpi3mr_hdb_entry - host diag buffer entry. |
| * |
| * @buf_type: Buffer type |
| * @status: Buffer status |
| * @trigger_type: Trigger type |
| * @rsvd1: Reserved |
| * @size: Buffer size |
| * @rsvd2: Reserved |
| * @trigger_data: Trigger specific data |
| * @rsvd3: Reserved |
| * @rsvd4: Reserved |
| */ |
| struct mpi3mr_hdb_entry { |
| __u8 buf_type; |
| __u8 status; |
| __u8 trigger_type; |
| __u8 rsvd1; |
| __u16 size; |
| __u16 rsvd2; |
| __u64 trigger_data; |
| __u32 rsvd3; |
| __u32 rsvd4; |
| }; |
| |
| |
| /** |
| * struct mpi3mr_bsg_in_hdb_status - This structure contains |
| * return data for the BSG request to retrieve the number of host |
| * diagnostic buffers supported by the driver and their current |
| * status and additional status specific data if any in forms of |
| * multiple hdb entries. |
| * |
| * @num_hdb_types: Number of host diag buffer types supported |
| * @element_trigger_format: Element trigger format |
| * @rsvd1: Reserved |
| * @rsvd2: Reserved |
| * @rsvd3: Reserved |
| * @entry: Variable length Diag buffer status entry array |
| */ |
| struct mpi3mr_bsg_in_hdb_status { |
| __u8 num_hdb_types; |
| __u8 element_trigger_format; |
| __u16 rsvd2; |
| __u32 rsvd3; |
| struct mpi3mr_hdb_entry entry[1]; |
| }; |
| |
| /** |
| * struct mpi3mr_bsg_out_repost_hdb - Repost host diagnostic |
| * buffer request payload data to the driver. |
| * |
| * @buf_type: Buffer type |
| * @rsvd1: Reserved |
| * @rsvd2: Reserved |
| */ |
| struct mpi3mr_bsg_out_repost_hdb { |
| __u8 buf_type; |
| __u8 rsvd1; |
| __u16 rsvd2; |
| }; |
| |
| /** |
| * struct mpi3mr_bsg_out_upload_hdb - Upload host diagnostic |
| * buffer request payload data to the driver. |
| * |
| * @buf_type: Buffer type |
| * @rsvd1: Reserved |
| * @rsvd2: Reserved |
| * @start_offset: Start offset of the buffer from where to copy |
| * @length: Length of the buffer to copy |
| */ |
| struct mpi3mr_bsg_out_upload_hdb { |
| __u8 buf_type; |
| __u8 rsvd1; |
| __u16 rsvd2; |
| __u32 start_offset; |
| __u32 length; |
| }; |
| |
| /** |
| * struct mpi3mr_bsg_out_refresh_hdb_triggers - Refresh host |
| * diagnostic buffer triggers request payload data to the driver. |
| * |
| * @page_type: Page type |
| * @rsvd1: Reserved |
| * @rsvd2: Reserved |
| */ |
| struct mpi3mr_bsg_out_refresh_hdb_triggers { |
| __u8 page_type; |
| __u8 rsvd1; |
| __u16 rsvd2; |
| }; |
| /** |
| * struct mpi3mr_bsg_drv_cmd - Generic bsg data |
| * structure for all driver specific requests. |
| * |
| * @mrioc_id: Controller ID |
| * @opcode: Driver specific opcode |
| * @rsvd1: Reserved |
| * @rsvd2: Reserved |
| */ |
| struct mpi3mr_bsg_drv_cmd { |
| __u8 mrioc_id; |
| __u8 opcode; |
| __u16 rsvd1; |
| __u32 rsvd2[4]; |
| }; |
| /** |
| * struct mpi3mr_bsg_in_reply_buf - MPI reply buffer returned |
| * for MPI Passthrough request . |
| * |
| * @mpi_reply_type: Type of MPI reply |
| * @rsvd1: Reserved |
| * @rsvd2: Reserved |
| * @reply_buf: Variable Length buffer based on mpirep type |
| */ |
| struct mpi3mr_bsg_in_reply_buf { |
| __u8 mpi_reply_type; |
| __u8 rsvd1; |
| __u16 rsvd2; |
| __u8 reply_buf[]; |
| }; |
| |
| /** |
| * struct mpi3mr_buf_entry - User buffer descriptor for MPI |
| * Passthrough requests. |
| * |
| * @buf_type: Buffer type |
| * @rsvd1: Reserved |
| * @rsvd2: Reserved |
| * @buf_len: Buffer length |
| */ |
| struct mpi3mr_buf_entry { |
| __u8 buf_type; |
| __u8 rsvd1; |
| __u16 rsvd2; |
| __u32 buf_len; |
| }; |
| /** |
| * struct mpi3mr_buf_entry_list - list of user buffer |
| * descriptor for MPI Passthrough requests. |
| * |
| * @num_of_entries: Number of buffer descriptors |
| * @rsvd1: Reserved |
| * @rsvd2: Reserved |
| * @rsvd3: Reserved |
| * @buf_entry: Variable length array of buffer descriptors |
| */ |
| struct mpi3mr_buf_entry_list { |
| __u8 num_of_entries; |
| __u8 rsvd1; |
| __u16 rsvd2; |
| __u32 rsvd3; |
| struct mpi3mr_buf_entry buf_entry[1]; |
| }; |
| /** |
| * struct mpi3mr_bsg_mptcmd - Generic bsg data |
| * structure for all MPI Passthrough requests . |
| * |
| * @mrioc_id: Controller ID |
| * @rsvd1: Reserved |
| * @timeout: MPI request timeout |
| * @rsvd2: Reserved |
| * @buf_entry_list: Buffer descriptor list |
| */ |
| struct mpi3mr_bsg_mptcmd { |
| __u8 mrioc_id; |
| __u8 rsvd1; |
| __u16 timeout; |
| __u32 rsvd2; |
| struct mpi3mr_buf_entry_list buf_entry_list; |
| }; |
| |
| /** |
| * struct mpi3mr_bsg_packet - Generic bsg data |
| * structure for all supported requests . |
| * |
| * @cmd_type: represents drvrcmd or mptcmd |
| * @rsvd1: Reserved |
| * @rsvd2: Reserved |
| * @rsvd3: Reserved |
| * @cmd.drvrcmd: driver request structure |
| * @cmd.mptcmd: mpt request structure |
| */ |
| struct mpi3mr_bsg_packet { |
| __u8 cmd_type; |
| __u8 rsvd1; |
| __u16 rsvd2; |
| __u32 rsvd3; |
| union { |
| struct mpi3mr_bsg_drv_cmd drvrcmd; |
| struct mpi3mr_bsg_mptcmd mptcmd; |
| } cmd; |
| }; |
| |
| struct mpi3_nvme_encapsulated_request { |
| __le16 host_tag; |
| __u8 ioc_use_only02; |
| __u8 function; |
| __le16 ioc_use_only04; |
| __u8 ioc_use_only06; |
| __u8 msg_flags; |
| __le16 change_count; |
| __le16 dev_handle; |
| __le16 encapsulated_command_length; |
| __le16 flags; |
| __le32 data_length; |
| __le32 reserved14[3]; |
| __le32 command[]; |
| }; |
| |
| struct mpi3_nvme_encapsulated_error_reply { |
| __le16 host_tag; |
| __u8 ioc_use_only02; |
| __u8 function; |
| __le16 ioc_use_only04; |
| __u8 ioc_use_only06; |
| __u8 msg_flags; |
| __le16 ioc_use_only08; |
| __le16 ioc_status; |
| __le32 ioc_log_info; |
| __le32 nvme_completion_entry[4]; |
| }; |
| |
| #define MPI3MR_NVME_PRP_SIZE 8 /* PRP size */ |
| #define MPI3MR_NVME_CMD_PRP1_OFFSET 24 /* PRP1 offset in NVMe cmd */ |
| #define MPI3MR_NVME_CMD_PRP2_OFFSET 32 /* PRP2 offset in NVMe cmd */ |
| #define MPI3MR_NVME_CMD_SGL_OFFSET 24 /* SGL offset in NVMe cmd */ |
| #define MPI3MR_NVME_DATA_FORMAT_PRP 0 |
| #define MPI3MR_NVME_DATA_FORMAT_SGL1 1 |
| #define MPI3MR_NVME_DATA_FORMAT_SGL2 2 |
| #define MPI3MR_NVMESGL_DATA_SEGMENT 0x00 |
| #define MPI3MR_NVMESGL_LAST_SEGMENT 0x03 |
| |
| /* MPI3: task management related definitions */ |
| struct mpi3_scsi_task_mgmt_request { |
| __le16 host_tag; |
| __u8 ioc_use_only02; |
| __u8 function; |
| __le16 ioc_use_only04; |
| __u8 ioc_use_only06; |
| __u8 msg_flags; |
| __le16 change_count; |
| __le16 dev_handle; |
| __le16 task_host_tag; |
| __u8 task_type; |
| __u8 reserved0f; |
| __le16 task_request_queue_id; |
| __le16 reserved12; |
| __le32 reserved14; |
| __u8 lun[8]; |
| }; |
| |
| #define MPI3_SCSITASKMGMT_MSGFLAGS_DO_NOT_SEND_TASK_IU (0x08) |
| #define MPI3_SCSITASKMGMT_TASKTYPE_ABORT_TASK (0x01) |
| #define MPI3_SCSITASKMGMT_TASKTYPE_ABORT_TASK_SET (0x02) |
| #define MPI3_SCSITASKMGMT_TASKTYPE_TARGET_RESET (0x03) |
| #define MPI3_SCSITASKMGMT_TASKTYPE_LOGICAL_UNIT_RESET (0x05) |
| #define MPI3_SCSITASKMGMT_TASKTYPE_CLEAR_TASK_SET (0x06) |
| #define MPI3_SCSITASKMGMT_TASKTYPE_QUERY_TASK (0x07) |
| #define MPI3_SCSITASKMGMT_TASKTYPE_CLEAR_ACA (0x08) |
| #define MPI3_SCSITASKMGMT_TASKTYPE_QUERY_TASK_SET (0x09) |
| #define MPI3_SCSITASKMGMT_TASKTYPE_QUERY_ASYNC_EVENT (0x0a) |
| #define MPI3_SCSITASKMGMT_TASKTYPE_I_T_NEXUS_RESET (0x0b) |
| struct mpi3_scsi_task_mgmt_reply { |
| __le16 host_tag; |
| __u8 ioc_use_only02; |
| __u8 function; |
| __le16 ioc_use_only04; |
| __u8 ioc_use_only06; |
| __u8 msg_flags; |
| __le16 ioc_use_only08; |
| __le16 ioc_status; |
| __le32 ioc_log_info; |
| __le32 termination_count; |
| __le32 response_data; |
| __le32 reserved18; |
| }; |
| |
| #define MPI3_SCSITASKMGMT_RSPCODE_TM_COMPLETE (0x00) |
| #define MPI3_SCSITASKMGMT_RSPCODE_INVALID_FRAME (0x02) |
| #define MPI3_SCSITASKMGMT_RSPCODE_TM_FUNCTION_NOT_SUPPORTED (0x04) |
| #define MPI3_SCSITASKMGMT_RSPCODE_TM_FAILED (0x05) |
| #define MPI3_SCSITASKMGMT_RSPCODE_TM_SUCCEEDED (0x08) |
| #define MPI3_SCSITASKMGMT_RSPCODE_TM_INVALID_LUN (0x09) |
| #define MPI3_SCSITASKMGMT_RSPCODE_TM_OVERLAPPED_TAG (0x0a) |
| #define MPI3_SCSITASKMGMT_RSPCODE_IO_QUEUED_ON_IOC (0x80) |
| #define MPI3_SCSITASKMGMT_RSPCODE_TM_NVME_DENIED (0x81) |
| |
| /* MPI3: PEL related definitions */ |
| #define MPI3_PEL_LOCALE_FLAGS_NON_BLOCKING_BOOT_EVENT (0x0200) |
| #define MPI3_PEL_LOCALE_FLAGS_BLOCKING_BOOT_EVENT (0x0100) |
| #define MPI3_PEL_LOCALE_FLAGS_PCIE (0x0080) |
| #define MPI3_PEL_LOCALE_FLAGS_CONFIGURATION (0x0040) |
| #define MPI3_PEL_LOCALE_FLAGS_CONTROLER (0x0020) |
| #define MPI3_PEL_LOCALE_FLAGS_SAS (0x0010) |
| #define MPI3_PEL_LOCALE_FLAGS_EPACK (0x0008) |
| #define MPI3_PEL_LOCALE_FLAGS_ENCLOSURE (0x0004) |
| #define MPI3_PEL_LOCALE_FLAGS_PD (0x0002) |
| #define MPI3_PEL_LOCALE_FLAGS_VD (0x0001) |
| #define MPI3_PEL_CLASS_DEBUG (0x00) |
| #define MPI3_PEL_CLASS_PROGRESS (0x01) |
| #define MPI3_PEL_CLASS_INFORMATIONAL (0x02) |
| #define MPI3_PEL_CLASS_WARNING (0x03) |
| #define MPI3_PEL_CLASS_CRITICAL (0x04) |
| #define MPI3_PEL_CLASS_FATAL (0x05) |
| #define MPI3_PEL_CLASS_FAULT (0x06) |
| |
| /* MPI3: Function definitions */ |
| #define MPI3_BSG_FUNCTION_MGMT_PASSTHROUGH (0x0a) |
| #define MPI3_BSG_FUNCTION_SCSI_IO (0x20) |
| #define MPI3_BSG_FUNCTION_SCSI_TASK_MGMT (0x21) |
| #define MPI3_BSG_FUNCTION_SMP_PASSTHROUGH (0x22) |
| #define MPI3_BSG_FUNCTION_NVME_ENCAPSULATED (0x24) |
| |
| #endif |
