drivers/raw/ifpga/base/opae_ifpga_hw_api.h

   1 /* SPDX-License-Identifier: BSD-3-Clause
   2  * Copyright(c) 2010-2018 Intel Corporation
   3  */
   4
   5 #ifndef _OPAE_IFPGA_HW_API_H_
   6 #define _OPAE_IFPGA_HW_API_H_
   7
   8 #include "opae_hw_api.h"
   9
  10 /**
  11  * struct feature_prop - data structure for feature property
  12  * @feature_id: id of this feature.
  13  * @prop_id: id of this property under this feature.
  14  * @data: property value to set/get.
  15  */
  16 struct feature_prop {
  17         u64 feature_id;
  18         u64 prop_id;
  19         u64 data;
  20 };
  21
  22 #define IFPGA_FIU_ID_FME        0x0
  23 #define IFPGA_FIU_ID_PORT       0x1
  24
  25 #define IFPGA_FME_FEATURE_ID_HEADER             0x0
  26 #define IFPGA_FME_FEATURE_ID_THERMAL_MGMT       0x1
  27 #define IFPGA_FME_FEATURE_ID_POWER_MGMT         0x2
  28 #define IFPGA_FME_FEATURE_ID_GLOBAL_IPERF       0x3
  29 #define IFPGA_FME_FEATURE_ID_GLOBAL_ERR         0x4
  30 #define IFPGA_FME_FEATURE_ID_PR_MGMT            0x5
  31 #define IFPGA_FME_FEATURE_ID_HSSI               0x6
  32 #define IFPGA_FME_FEATURE_ID_GLOBAL_DPERF       0x7
  33
  34 #define IFPGA_PORT_FEATURE_ID_HEADER            0x0
  35 #define IFPGA_PORT_FEATURE_ID_AFU               0xff
  36 #define IFPGA_PORT_FEATURE_ID_ERROR             0x10
  37 #define IFPGA_PORT_FEATURE_ID_UMSG              0x11
  38 #define IFPGA_PORT_FEATURE_ID_UINT              0x12
  39 #define IFPGA_PORT_FEATURE_ID_STP               0x13
  40
  41 /*
  42  * PROP format (TOP + SUB + ID)
  43  *
  44  * (~0x0) means this field is unused.
  45  */
  46 #define PROP_TOP        GENMASK(31, 24)
  47 #define PROP_TOP_UNUSED 0xff
  48 #define PROP_SUB        GENMASK(23, 16)
  49 #define PROP_SUB_UNUSED 0xff
  50 #define PROP_ID         GENMASK(15, 0)
  51
  52 #define PROP(_top, _sub, _id) \
  53         (SET_FIELD(PROP_TOP, _top) | SET_FIELD(PROP_SUB, _sub) |\
  54          SET_FIELD(PROP_ID, _id))
  55
  56 /* FME head feature's properties*/
  57 #define FME_HDR_PROP_REVISION           0x1     /* RDONLY */
  58 #define FME_HDR_PROP_PORTS_NUM          0x2     /* RDONLY */
  59 #define FME_HDR_PROP_CACHE_SIZE         0x3     /* RDONLY */
  60 #define FME_HDR_PROP_VERSION                    0x4     /* RDONLY */
  61 #define FME_HDR_PROP_SOCKET_ID          0x5     /* RDONLY */
  62 #define FME_HDR_PROP_BITSTREAM_ID               0x6     /* RDONLY */
  63 #define FME_HDR_PROP_BITSTREAM_METADATA 0x7     /* RDONLY */
  64
  65 /* FME error reporting feature's properties */
  66 /* FME error reporting properties format */
  67 #define ERR_PROP(_top, _id)             PROP(_top, 0xff, _id)
  68 #define ERR_PROP_TOP_UNUSED             PROP_TOP_UNUSED
  69 #define ERR_PROP_TOP_FME_ERR            0x1
  70 #define ERR_PROP_ROOT(_id)              ERR_PROP(0xff, _id)
  71 #define ERR_PROP_FME_ERR(_id)           ERR_PROP(ERR_PROP_TOP_FME_ERR, _id)
  72
  73 #define FME_ERR_PROP_ERRORS             ERR_PROP_FME_ERR(0x1)
  74 #define FME_ERR_PROP_FIRST_ERROR        ERR_PROP_FME_ERR(0x2)
  75 #define FME_ERR_PROP_NEXT_ERROR         ERR_PROP_FME_ERR(0x3)
  76 #define FME_ERR_PROP_CLEAR              ERR_PROP_FME_ERR(0x4)   /* WO */
  77 #define FME_ERR_PROP_SEU_EMR_LOW        ERR_PROP_FME_ERR(0x5)
  78 #define FME_ERR_PROP_SEU_EMR_HIGH       ERR_PROP_FME_ERR(0x6)
  79 #define FME_ERR_PROP_REVISION           ERR_PROP_ROOT(0x5)
  80 #define FME_ERR_PROP_PCIE0_ERRORS       ERR_PROP_ROOT(0x6)      /* RW */
  81 #define FME_ERR_PROP_PCIE1_ERRORS       ERR_PROP_ROOT(0x7)      /* RW */
  82 #define FME_ERR_PROP_NONFATAL_ERRORS    ERR_PROP_ROOT(0x8)
  83 #define FME_ERR_PROP_CATFATAL_ERRORS    ERR_PROP_ROOT(0x9)
  84 #define FME_ERR_PROP_INJECT_ERRORS      ERR_PROP_ROOT(0xa)      /* RW */
  85
  86 /* FME thermal feature's properties */
  87 #define FME_THERMAL_PROP_THRESHOLD1             0x1     /* RW */
  88 #define FME_THERMAL_PROP_THRESHOLD2             0x2     /* RW */
  89 #define FME_THERMAL_PROP_THRESHOLD_TRIP         0x3     /* RDONLY */
  90 #define FME_THERMAL_PROP_THRESHOLD1_REACHED     0x4     /* RDONLY */
  91 #define FME_THERMAL_PROP_THRESHOLD2_REACHED     0x5     /* RDONLY */
  92 #define FME_THERMAL_PROP_THRESHOLD1_POLICY      0x6     /* RW */
  93 #define FME_THERMAL_PROP_TEMPERATURE            0x7     /* RDONLY */
  94 #define FME_THERMAL_PROP_REVISION               0x8     /* RDONLY */
  95
  96 /* FME power feature's properties */
  97 #define FME_PWR_PROP_CONSUMED                   0x1     /* RDONLY */
  98 #define FME_PWR_PROP_THRESHOLD1                 0x2     /* RW */
  99 #define FME_PWR_PROP_THRESHOLD2                 0x3     /* RW */
 100 #define FME_PWR_PROP_THRESHOLD1_STATUS          0x4     /* RDONLY */
 101 #define FME_PWR_PROP_THRESHOLD2_STATUS          0x5     /* RDONLY */
 102 #define FME_PWR_PROP_RTL                        0x6     /* RDONLY */
 103 #define FME_PWR_PROP_XEON_LIMIT                 0x7     /* RDONLY */
 104 #define FME_PWR_PROP_FPGA_LIMIT                 0x8     /* RDONLY */
 105 #define FME_PWR_PROP_REVISION                   0x9     /* RDONLY */
 106
 107 /* FME iperf/dperf PROP format */
 108 #define PERF_PROP_TOP_CACHE                     0x1
 109 #define PERF_PROP_TOP_VTD                       0x2
 110 #define PERF_PROP_TOP_FAB                       0x3
 111 #define PERF_PROP_TOP_UNUSED                    PROP_TOP_UNUSED
 112 #define PERF_PROP_SUB_UNUSED                    PROP_SUB_UNUSED
 113
 114 #define PERF_PROP_ROOT(_id)             PROP(0xff, 0xff, _id)
 115 #define PERF_PROP_CACHE(_id)            PROP(PERF_PROP_TOP_CACHE, 0xff, _id)
 116 #define PERF_PROP_VTD(_sub, _id)        PROP(PERF_PROP_TOP_VTD, _sub, _id)
 117 #define PERF_PROP_VTD_ROOT(_id)         PROP(PERF_PROP_TOP_VTD, 0xff, _id)
 118 #define PERF_PROP_FAB(_sub, _id)        PROP(PERF_PROP_TOP_FAB, _sub, _id)
 119 #define PERF_PROP_FAB_ROOT(_id)         PROP(PERF_PROP_TOP_FAB, 0xff, _id)
 120
 121 /* FME iperf feature's properties */
 122 #define FME_IPERF_PROP_CLOCK                    PERF_PROP_ROOT(0x1)
 123 #define FME_IPERF_PROP_REVISION                 PERF_PROP_ROOT(0x2)
 124
 125 /* iperf CACHE properties */
 126 #define FME_IPERF_PROP_CACHE_FREEZE             PERF_PROP_CACHE(0x1) /* RW */
 127 #define FME_IPERF_PROP_CACHE_READ_HIT           PERF_PROP_CACHE(0x2)
 128 #define FME_IPERF_PROP_CACHE_READ_MISS          PERF_PROP_CACHE(0x3)
 129 #define FME_IPERF_PROP_CACHE_WRITE_HIT          PERF_PROP_CACHE(0x4)
 130 #define FME_IPERF_PROP_CACHE_WRITE_MISS         PERF_PROP_CACHE(0x5)
 131 #define FME_IPERF_PROP_CACHE_HOLD_REQUEST       PERF_PROP_CACHE(0x6)
 132 #define FME_IPERF_PROP_CACHE_TX_REQ_STALL       PERF_PROP_CACHE(0x7)
 133 #define FME_IPERF_PROP_CACHE_RX_REQ_STALL       PERF_PROP_CACHE(0x8)
 134 #define FME_IPERF_PROP_CACHE_RX_EVICTION        PERF_PROP_CACHE(0x9)
 135 #define FME_IPERF_PROP_CACHE_DATA_WRITE_PORT_CONTENTION PERF_PROP_CACHE(0xa)
 136 #define FME_IPERF_PROP_CACHE_TAG_WRITE_PORT_CONTENTION  PERF_PROP_CACHE(0xb)
 137 /* iperf VTD properties */
 138 #define FME_IPERF_PROP_VTD_FREEZE               PERF_PROP_VTD_ROOT(0x1) /* RW */
 139 #define FME_IPERF_PROP_VTD_SIP_IOTLB_4K_HIT     PERF_PROP_VTD_ROOT(0x2)
 140 #define FME_IPERF_PROP_VTD_SIP_IOTLB_2M_HIT     PERF_PROP_VTD_ROOT(0x3)
 141 #define FME_IPERF_PROP_VTD_SIP_IOTLB_1G_HIT     PERF_PROP_VTD_ROOT(0x4)
 142 #define FME_IPERF_PROP_VTD_SIP_SLPWC_L3_HIT     PERF_PROP_VTD_ROOT(0x5)
 143 #define FME_IPERF_PROP_VTD_SIP_SLPWC_L4_HIT     PERF_PROP_VTD_ROOT(0x6)
 144 #define FME_IPERF_PROP_VTD_SIP_RCC_HIT          PERF_PROP_VTD_ROOT(0x7)
 145 #define FME_IPERF_PROP_VTD_SIP_IOTLB_4K_MISS    PERF_PROP_VTD_ROOT(0x8)
 146 #define FME_IPERF_PROP_VTD_SIP_IOTLB_2M_MISS    PERF_PROP_VTD_ROOT(0x9)
 147 #define FME_IPERF_PROP_VTD_SIP_IOTLB_1G_MISS    PERF_PROP_VTD_ROOT(0xa)
 148 #define FME_IPERF_PROP_VTD_SIP_SLPWC_L3_MISS    PERF_PROP_VTD_ROOT(0xb)
 149 #define FME_IPERF_PROP_VTD_SIP_SLPWC_L4_MISS    PERF_PROP_VTD_ROOT(0xc)
 150 #define FME_IPERF_PROP_VTD_SIP_RCC_MISS         PERF_PROP_VTD_ROOT(0xd)
 151 #define FME_IPERF_PROP_VTD_PORT_READ_TRANSACTION(n)     PERF_PROP_VTD(n, 0xe)
 152 #define FME_IPERF_PROP_VTD_PORT_WRITE_TRANSACTION(n)    PERF_PROP_VTD(n, 0xf)
 153 #define FME_IPERF_PROP_VTD_PORT_DEVTLB_READ_HIT(n)      PERF_PROP_VTD(n, 0x10)
 154 #define FME_IPERF_PROP_VTD_PORT_DEVTLB_WRITE_HIT(n)     PERF_PROP_VTD(n, 0x11)
 155 #define FME_IPERF_PROP_VTD_PORT_DEVTLB_4K_FILL(n)       PERF_PROP_VTD(n, 0x12)
 156 #define FME_IPERF_PROP_VTD_PORT_DEVTLB_2M_FILL(n)       PERF_PROP_VTD(n, 0x13)
 157 #define FME_IPERF_PROP_VTD_PORT_DEVTLB_1G_FILL(n)       PERF_PROP_VTD(n, 0x14)
 158 /* iperf FAB properties */
 159 #define FME_IPERF_PROP_FAB_FREEZE               PERF_PROP_FAB_ROOT(0x1) /* RW */
 160 #define FME_IPERF_PROP_FAB_PCIE0_READ           PERF_PROP_FAB_ROOT(0x2)
 161 #define FME_IPERF_PROP_FAB_PORT_PCIE0_READ(n)   PERF_PROP_FAB(n, 0x2)
 162 #define FME_IPERF_PROP_FAB_PCIE0_WRITE          PERF_PROP_FAB_ROOT(0x3)
 163 #define FME_IPERF_PROP_FAB_PORT_PCIE0_WRITE(n)  PERF_PROP_FAB(n, 0x3)
 164 #define FME_IPERF_PROP_FAB_PCIE1_READ           PERF_PROP_FAB_ROOT(0x4)
 165 #define FME_IPERF_PROP_FAB_PORT_PCIE1_READ(n)   PERF_PROP_FAB(n, 0x4)
 166 #define FME_IPERF_PROP_FAB_PCIE1_WRITE          PERF_PROP_FAB_ROOT(0x5)
 167 #define FME_IPERF_PROP_FAB_PORT_PCIE1_WRITE(n)  PERF_PROP_FAB(n, 0x5)
 168 #define FME_IPERF_PROP_FAB_UPI_READ             PERF_PROP_FAB_ROOT(0x6)
 169 #define FME_IPERF_PROP_FAB_PORT_UPI_READ(n)     PERF_PROP_FAB(n, 0x6)
 170 #define FME_IPERF_PROP_FAB_UPI_WRITE            PERF_PROP_FAB_ROOT(0x7)
 171 #define FME_IPERF_PROP_FAB_PORT_UPI_WRITE(n)    PERF_PROP_FAB(n, 0x7)
 172 #define FME_IPERF_PROP_FAB_MMIO_READ            PERF_PROP_FAB_ROOT(0x8)
 173 #define FME_IPERF_PROP_FAB_PORT_MMIO_READ(n)    PERF_PROP_FAB(n, 0x8)
 174 #define FME_IPERF_PROP_FAB_MMIO_WRITE           PERF_PROP_FAB_ROOT(0x9)
 175 #define FME_IPERF_PROP_FAB_PORT_MMIO_WRITE(n)   PERF_PROP_FAB(n, 0x9)
 176 #define FME_IPERF_PROP_FAB_ENABLE               PERF_PROP_FAB_ROOT(0xa) /* RW */
 177 #define FME_IPERF_PROP_FAB_PORT_ENABLE(n)       PERF_PROP_FAB(n, 0xa)   /* RW */
 178
 179 /* FME dperf properties */
 180 #define FME_DPERF_PROP_CLOCK                    PERF_PROP_ROOT(0x1)
 181 #define FME_DPERF_PROP_REVISION                 PERF_PROP_ROOT(0x2)
 182
 183 /* dperf FAB properties */
 184 #define FME_DPERF_PROP_FAB_FREEZE               PERF_PROP_FAB_ROOT(0x1) /* RW */
 185 #define FME_DPERF_PROP_FAB_PCIE0_READ           PERF_PROP_FAB_ROOT(0x2)
 186 #define FME_DPERF_PROP_FAB_PORT_PCIE0_READ(n)   PERF_PROP_FAB(n, 0x2)
 187 #define FME_DPERF_PROP_FAB_PCIE0_WRITE          PERF_PROP_FAB_ROOT(0x3)
 188 #define FME_DPERF_PROP_FAB_PORT_PCIE0_WRITE(n)  PERF_PROP_FAB(n, 0x3)
 189 #define FME_DPERF_PROP_FAB_MMIO_READ            PERF_PROP_FAB_ROOT(0x4)
 190 #define FME_DPERF_PROP_FAB_PORT_MMIO_READ(n)    PERF_PROP_FAB(n, 0x4)
 191 #define FME_DPERF_PROP_FAB_MMIO_WRITE           PERF_PROP_FAB_ROOT(0x5)
 192 #define FME_DPERF_PROP_FAB_PORT_MMIO_WRITE(n)   PERF_PROP_FAB(n, 0x5)
 193 #define FME_DPERF_PROP_FAB_ENABLE               PERF_PROP_FAB_ROOT(0x6) /* RW */
 194 #define FME_DPERF_PROP_FAB_PORT_ENABLE(n)       PERF_PROP_FAB(n, 0x6)   /* RW */
 195
 196 /*PORT hdr feature's properties*/
 197 #define PORT_HDR_PROP_REVISION                  0x1     /* RDONLY */
 198 #define PORT_HDR_PROP_PORTIDX                   0x2     /* RDONLY */
 199 #define PORT_HDR_PROP_LATENCY_TOLERANCE         0x3     /* RDONLY */
 200 #define PORT_HDR_PROP_AP1_EVENT                 0x4     /* RW */
 201 #define PORT_HDR_PROP_AP2_EVENT                 0x5     /* RW */
 202 #define PORT_HDR_PROP_POWER_STATE               0x6     /* RDONLY */
 203 #define PORT_HDR_PROP_USERCLK_FREQCMD           0x7     /* RW */
 204 #define PORT_HDR_PROP_USERCLK_FREQCNTRCMD       0x8     /* RW */
 205 #define PORT_HDR_PROP_USERCLK_FREQSTS           0x9     /* RDONLY */
 206 #define PORT_HDR_PROP_USERCLK_CNTRSTS           0xa     /* RDONLY */
 207
 208 /*PORT error feature's properties*/
 209 #define PORT_ERR_PROP_REVISION                  0x1     /* RDONLY */
 210 #define PORT_ERR_PROP_ERRORS                    0x2     /* RDONLY */
 211 #define PORT_ERR_PROP_FIRST_ERROR               0x3     /* RDONLY */
 212 #define PORT_ERR_PROP_FIRST_MALFORMED_REQ_LSB   0x4     /* RDONLY */
 213 #define PORT_ERR_PROP_FIRST_MALFORMED_REQ_MSB   0x5     /* RDONLY */
 214 #define PORT_ERR_PROP_CLEAR                     0x6     /* WRONLY */
 215
 216 int opae_manager_ifpga_get_prop(struct opae_manager *mgr,
 217                                 struct feature_prop *prop);
 218 int opae_manager_ifpga_set_prop(struct opae_manager *mgr,
 219                                 struct feature_prop *prop);
 220 int opae_bridge_ifpga_get_prop(struct opae_bridge *br,
 221                                struct feature_prop *prop);
 222 int opae_bridge_ifpga_set_prop(struct opae_bridge *br,
 223                                struct feature_prop *prop);
 224
 225 /*
 226  * Retrieve information about the fpga fme.
 227  * Driver fills the info in provided struct fpga_fme_info.
 228  */
 229 struct fpga_fme_info {
 230         u32 capability;         /* The capability of FME device */
 231 #define FPGA_FME_CAP_ERR_IRQ    (1 << 0) /* Support fme error interrupt */
 232 };
 233
 234 int opae_manager_ifpga_get_info(struct opae_manager *mgr,
 235                                 struct fpga_fme_info *fme_info);
 236
 237 /* Set eventfd information for ifpga FME error interrupt */
 238 struct fpga_fme_err_irq_set {
 239         s32 evtfd;              /* Eventfd handler */
 240 };
 241
 242 int opae_manager_ifpga_set_err_irq(struct opae_manager *mgr,
 243                                    struct fpga_fme_err_irq_set *err_irq_set);
 244
 245 /*
 246  * Retrieve information about the fpga port.
 247  * Driver fills the info in provided struct fpga_port_info.
 248  */
 249 struct fpga_port_info {
 250         u32 capability; /* The capability of port device */
 251 #define FPGA_PORT_CAP_ERR_IRQ   (1 << 0) /* Support port error interrupt */
 252 #define FPGA_PORT_CAP_UAFU_IRQ  (1 << 1) /* Support uafu error interrupt */
 253         u32 num_umsgs;  /* The number of allocated umsgs */
 254         u32 num_uafu_irqs;      /* The number of uafu interrupts */
 255 };
 256
 257 int opae_bridge_ifpga_get_info(struct opae_bridge *br,
 258                                struct fpga_port_info *port_info);
 259 /*
 260  * Retrieve region information about the fpga port.
 261  * Driver needs to fill the index of struct fpga_port_region_info.
 262  */
 263 struct fpga_port_region_info {
 264         u32 index;
 265 #define PORT_REGION_INDEX_STP   (1 << 1)        /* Signal Tap Region */
 266         u64 size;       /* Region Size */
 267         u8 *addr;       /* Base address of the region */
 268 };
 269
 270 int opae_bridge_ifpga_get_region_info(struct opae_bridge *br,
 271                                       struct fpga_port_region_info *info);
 272
 273 /* Set eventfd information for ifpga port error interrupt */
 274 struct fpga_port_err_irq_set {
 275         s32 evtfd;              /* Eventfd handler */
 276 };
 277
 278 int opae_bridge_ifpga_set_err_irq(struct opae_bridge *br,
 279                                   struct fpga_port_err_irq_set *err_irq_set);
 280
 281 #endif /* _OPAE_IFPGA_HW_API_H_ */