root/drivers/scsi/hptiop.h
/* SPDX-License-Identifier: GPL-2.0-only */
/*
 * HighPoint RR3xxx/4xxx controller driver for Linux
 * Copyright (C) 2006-2015 HighPoint Technologies, Inc. All Rights Reserved.
 *
 * Please report bugs/comments/suggestions to linux@highpoint-tech.com
 *
 * For more information, visit http://www.highpoint-tech.com
 */
#ifndef _HPTIOP_H_
#define _HPTIOP_H_

struct hpt_iopmu_itl {
        __le32 resrved0[4];
        __le32 inbound_msgaddr0;
        __le32 inbound_msgaddr1;
        __le32 outbound_msgaddr0;
        __le32 outbound_msgaddr1;
        __le32 inbound_doorbell;
        __le32 inbound_intstatus;
        __le32 inbound_intmask;
        __le32 outbound_doorbell;
        __le32 outbound_intstatus;
        __le32 outbound_intmask;
        __le32 reserved1[2];
        __le32 inbound_queue;
        __le32 outbound_queue;
};

#define IOPMU_QUEUE_EMPTY            0xffffffff
#define IOPMU_QUEUE_MASK_HOST_BITS   0xf0000000
#define IOPMU_QUEUE_ADDR_HOST_BIT    0x80000000
#define IOPMU_QUEUE_REQUEST_SIZE_BIT    0x40000000
#define IOPMU_QUEUE_REQUEST_RESULT_BIT   0x40000000

#define IOPMU_OUTBOUND_INT_MSG0      1
#define IOPMU_OUTBOUND_INT_MSG1      2
#define IOPMU_OUTBOUND_INT_DOORBELL  4
#define IOPMU_OUTBOUND_INT_POSTQUEUE 8
#define IOPMU_OUTBOUND_INT_PCI       0x10

#define IOPMU_INBOUND_INT_MSG0       1
#define IOPMU_INBOUND_INT_MSG1       2
#define IOPMU_INBOUND_INT_DOORBELL   4
#define IOPMU_INBOUND_INT_ERROR      8
#define IOPMU_INBOUND_INT_POSTQUEUE  0x10

#define MVIOP_QUEUE_LEN  512

struct hpt_iopmu_mv {
        __le32 inbound_head;
        __le32 inbound_tail;
        __le32 outbound_head;
        __le32 outbound_tail;
        __le32 inbound_msg;
        __le32 outbound_msg;
        __le32 reserve[10];
        __le64 inbound_q[MVIOP_QUEUE_LEN];
        __le64 outbound_q[MVIOP_QUEUE_LEN];
};

struct hpt_iopmv_regs {
        __le32 reserved[0x20400 / 4];
        __le32 inbound_doorbell;
        __le32 inbound_intmask;
        __le32 outbound_doorbell;
        __le32 outbound_intmask;
};

#pragma pack(1)
struct hpt_iopmu_mvfrey {
        __le32 reserved0[(0x4000 - 0) / 4];
        __le32 inbound_base;
        __le32 inbound_base_high;
        __le32 reserved1[(0x4018 - 0x4008) / 4];
        __le32 inbound_write_ptr;
        __le32 reserved2[(0x402c - 0x401c) / 4];
        __le32 inbound_conf_ctl;
        __le32 reserved3[(0x4050 - 0x4030) / 4];
        __le32 outbound_base;
        __le32 outbound_base_high;
        __le32 outbound_shadow_base;
        __le32 outbound_shadow_base_high;
        __le32 reserved4[(0x4088 - 0x4060) / 4];
        __le32 isr_cause;
        __le32 isr_enable;
        __le32 reserved5[(0x1020c - 0x4090) / 4];
        __le32 pcie_f0_int_enable;
        __le32 reserved6[(0x10400 - 0x10210) / 4];
        __le32 f0_to_cpu_msg_a;
        __le32 reserved7[(0x10420 - 0x10404) / 4];
        __le32 cpu_to_f0_msg_a;
        __le32 reserved8[(0x10480 - 0x10424) / 4];
        __le32 f0_doorbell;
        __le32 f0_doorbell_enable;
};

struct mvfrey_inlist_entry {
        dma_addr_t addr;
        __le32 intrfc_len;
        __le32 reserved;
};

struct mvfrey_outlist_entry {
        __le32 val;
};
#pragma pack()

#define MVIOP_MU_QUEUE_ADDR_HOST_MASK   (~(0x1full))
#define MVIOP_MU_QUEUE_ADDR_HOST_BIT    4

#define MVIOP_MU_QUEUE_ADDR_IOP_HIGH32  0xffffffff
#define MVIOP_MU_QUEUE_REQUEST_RESULT_BIT   1
#define MVIOP_MU_QUEUE_REQUEST_RETURN_CONTEXT 2

#define MVIOP_MU_INBOUND_INT_MSG        1
#define MVIOP_MU_INBOUND_INT_POSTQUEUE  2
#define MVIOP_MU_OUTBOUND_INT_MSG       1
#define MVIOP_MU_OUTBOUND_INT_POSTQUEUE 2

#define CL_POINTER_TOGGLE        0x00004000
#define CPU_TO_F0_DRBL_MSG_BIT   0x02000000

enum hpt_iopmu_message {
        /* host-to-iop messages */
        IOPMU_INBOUND_MSG0_NOP = 0,
        IOPMU_INBOUND_MSG0_RESET,
        IOPMU_INBOUND_MSG0_FLUSH,
        IOPMU_INBOUND_MSG0_SHUTDOWN,
        IOPMU_INBOUND_MSG0_STOP_BACKGROUND_TASK,
        IOPMU_INBOUND_MSG0_START_BACKGROUND_TASK,
        IOPMU_INBOUND_MSG0_RESET_COMM,
        IOPMU_INBOUND_MSG0_MAX = 0xff,
        /* iop-to-host messages */
        IOPMU_OUTBOUND_MSG0_REGISTER_DEVICE_0 = 0x100,
        IOPMU_OUTBOUND_MSG0_REGISTER_DEVICE_MAX = 0x1ff,
        IOPMU_OUTBOUND_MSG0_UNREGISTER_DEVICE_0 = 0x200,
        IOPMU_OUTBOUND_MSG0_UNREGISTER_DEVICE_MAX = 0x2ff,
        IOPMU_OUTBOUND_MSG0_REVALIDATE_DEVICE_0 = 0x300,
        IOPMU_OUTBOUND_MSG0_REVALIDATE_DEVICE_MAX = 0x3ff,
};

struct hpt_iop_request_header {
        __le32 size;
        __le32 type;
        __le32 flags;
        __le32 result;
        __le32 context; /* host context */
        __le32 context_hi32;
};

#define IOP_REQUEST_FLAG_SYNC_REQUEST 1
#define IOP_REQUEST_FLAG_BIST_REQUEST 2
#define IOP_REQUEST_FLAG_REMAPPED     4
#define IOP_REQUEST_FLAG_OUTPUT_CONTEXT 8
#define IOP_REQUEST_FLAG_ADDR_BITS 0x40 /* flags[31:16] is phy_addr[47:32] */

enum hpt_iop_request_type {
        IOP_REQUEST_TYPE_GET_CONFIG = 0,
        IOP_REQUEST_TYPE_SET_CONFIG,
        IOP_REQUEST_TYPE_BLOCK_COMMAND,
        IOP_REQUEST_TYPE_SCSI_COMMAND,
        IOP_REQUEST_TYPE_IOCTL_COMMAND,
        IOP_REQUEST_TYPE_MAX
};

enum hpt_iop_result_type {
        IOP_RESULT_PENDING = 0,
        IOP_RESULT_SUCCESS,
        IOP_RESULT_FAIL,
        IOP_RESULT_BUSY,
        IOP_RESULT_RESET,
        IOP_RESULT_INVALID_REQUEST,
        IOP_RESULT_BAD_TARGET,
        IOP_RESULT_CHECK_CONDITION,
};

struct hpt_iop_request_get_config {
        struct hpt_iop_request_header header;
        __le32 interface_version;
        __le32 firmware_version;
        __le32 max_requests;
        __le32 request_size;
        __le32 max_sg_count;
        __le32 data_transfer_length;
        __le32 alignment_mask;
        __le32 max_devices;
        __le32 sdram_size;
};

struct hpt_iop_request_set_config {
        struct hpt_iop_request_header header;
        __le32 iop_id;
        __le16 vbus_id;
        __le16 max_host_request_size;
        __le32 reserve[6];
};

struct hpt_iopsg {
        __le32 size;
        __le32 eot; /* non-zero: end of table */
        __le64 pci_address;
};

struct hpt_iop_request_block_command {
        struct hpt_iop_request_header header;
        u8     channel;
        u8     target;
        u8     lun;
        u8     pad1;
        __le16 command; /* IOP_BLOCK_COMMAND_{READ,WRITE} */
        __le16 sectors;
        __le64 lba;
        struct hpt_iopsg sg_list[1];
};

#define IOP_BLOCK_COMMAND_READ     1
#define IOP_BLOCK_COMMAND_WRITE    2
#define IOP_BLOCK_COMMAND_VERIFY   3
#define IOP_BLOCK_COMMAND_FLUSH    4
#define IOP_BLOCK_COMMAND_SHUTDOWN 5

struct hpt_iop_request_scsi_command {
        struct hpt_iop_request_header header;
        u8     channel;
        u8     target;
        u8     lun;
        u8     pad1;
        u8     cdb[16];
        __le32 dataxfer_length;
        struct hpt_iopsg sg_list[];
};

struct hpt_iop_request_ioctl_command {
        struct hpt_iop_request_header header;
        __le32 ioctl_code;
        __le32 inbuf_size;
        __le32 outbuf_size;
        __le32 bytes_returned;
        u8     buf[];
        /* out data should be put at buf[(inbuf_size+3)&~3] */
};

#define HPTIOP_MAX_REQUESTS  256u

struct hptiop_request {
        struct hptiop_request *next;
        void                  *req_virt;
        u32                   req_shifted_phy;
        struct scsi_cmnd      *scp;
        int                   index;
};

struct hpt_cmd_priv {
        int mapped;
        int sgcnt;
        dma_addr_t dma_handle;
};

#define HPT_SCP(scp) ((struct hpt_cmd_priv *)scsi_cmd_priv(scp))

enum hptiop_family {
        UNKNOWN_BASED_IOP,
        INTEL_BASED_IOP,
        MV_BASED_IOP,
        MVFREY_BASED_IOP
} ;

struct hptiop_hba {
        struct hptiop_adapter_ops *ops;
        union {
                struct {
                        struct hpt_iopmu_itl __iomem *iop;
                        void __iomem *plx;
                } itl;
                struct {
                        struct hpt_iopmv_regs *regs;
                        struct hpt_iopmu_mv __iomem *mu;
                        void *internal_req;
                        dma_addr_t internal_req_phy;
                } mv;
                struct {
                        struct hpt_iop_request_get_config __iomem *config;
                        struct hpt_iopmu_mvfrey __iomem *mu;

                        int internal_mem_size;
                        struct hptiop_request internal_req;
                        int list_count;
                        struct mvfrey_inlist_entry *inlist;
                        dma_addr_t inlist_phy;
                        __le32 inlist_wptr;
                        struct mvfrey_outlist_entry *outlist;
                        dma_addr_t outlist_phy;
                        __le32 *outlist_cptr; /* copy pointer shadow */
                        dma_addr_t outlist_cptr_phy;
                        __le32 outlist_rptr;
                } mvfrey;
        } u;

        struct Scsi_Host *host;
        struct pci_dev *pcidev;

        /* IOP config info */
        u32     interface_version;
        u32     firmware_version;
        u32     sdram_size;
        u32     max_devices;
        u32     max_requests;
        u32     max_request_size;
        u32     max_sg_descriptors;

        u32     req_size; /* host-allocated request buffer size */

        u32     iopintf_v2: 1;
        u32     initialized: 1;
        u32     msg_done: 1;

        struct hptiop_request * req_list;
        struct hptiop_request reqs[HPTIOP_MAX_REQUESTS];

        /* used to free allocated dma area */
        void        *dma_coherent[HPTIOP_MAX_REQUESTS];
        dma_addr_t  dma_coherent_handle[HPTIOP_MAX_REQUESTS];

        atomic_t    reset_count;
        atomic_t    resetting;

        wait_queue_head_t reset_wq;
        wait_queue_head_t ioctl_wq;
};

struct hpt_ioctl_k {
        struct hptiop_hba * hba;
        u32    ioctl_code;
        u32    inbuf_size;
        u32    outbuf_size;
        void   *inbuf;
        void   *outbuf;
        u32    *bytes_returned;
        void (*done)(struct hpt_ioctl_k *);
        int    result; /* HPT_IOCTL_RESULT_ */
};

struct hptiop_adapter_ops {
        enum hptiop_family family;
        int  (*iop_wait_ready)(struct hptiop_hba *hba, u32 millisec);
        int  (*internal_memalloc)(struct hptiop_hba *hba);
        int  (*internal_memfree)(struct hptiop_hba *hba);
        int  (*map_pci_bar)(struct hptiop_hba *hba);
        void (*unmap_pci_bar)(struct hptiop_hba *hba);
        void (*enable_intr)(struct hptiop_hba *hba);
        void (*disable_intr)(struct hptiop_hba *hba);
        int  (*get_config)(struct hptiop_hba *hba,
                                struct hpt_iop_request_get_config *config);
        int  (*set_config)(struct hptiop_hba *hba,
                                struct hpt_iop_request_set_config *config);
        int  (*iop_intr)(struct hptiop_hba *hba);
        void (*post_msg)(struct hptiop_hba *hba, u32 msg);
        void (*post_req)(struct hptiop_hba *hba, struct hptiop_request *_req);
        int  hw_dma_bit_mask;
        int  (*reset_comm)(struct hptiop_hba *hba);
        __le64  host_phy_flag;
};

#define HPT_IOCTL_RESULT_OK         0
#define HPT_IOCTL_RESULT_FAILED     (-1)

#if 0
#define dprintk(fmt, args...) do { printk(fmt, ##args); } while(0)
#else
#define dprintk(fmt, args...)
#endif

#endif