drivers/baseband/fpga_5gnr_fec/fpga_5gnr_fec.h

   1 /* SPDX-License-Identifier: BSD-3-Clause
   2  * Copyright(c) 2020 Intel Corporation
   3  */
   4
   5 #ifndef _FPGA_5GNR_FEC_H_
   6 #define _FPGA_5GNR_FEC_H_
   7
   8 #include <stdint.h>
   9 #include <stdbool.h>
  10
  11 /* Helper macro for logging */
  12 #define rte_bbdev_log(level, fmt, ...) \
  13         rte_log(RTE_LOG_ ## level, fpga_5gnr_fec_logtype, fmt "\n", \
  14                 ##__VA_ARGS__)
  15
  16 #ifdef RTE_LIBRTE_BBDEV_DEBUG
  17 #define rte_bbdev_log_debug(fmt, ...) \
  18                 rte_bbdev_log(DEBUG, "fpga_5gnr_fec: " fmt, \
  19                 ##__VA_ARGS__)
  20 #else
  21 #define rte_bbdev_log_debug(fmt, ...)
  22 #endif
  23
  24 /* FPGA 5GNR FEC driver names */
  25 #define FPGA_5GNR_FEC_PF_DRIVER_NAME intel_fpga_5gnr_fec_pf
  26 #define FPGA_5GNR_FEC_VF_DRIVER_NAME intel_fpga_5gnr_fec_vf
  27
  28 /* FPGA 5GNR FEC PCI vendor & device IDs */
  29 #define FPGA_5GNR_FEC_VENDOR_ID (0x8086)
  30 #define FPGA_5GNR_FEC_PF_DEVICE_ID (0x0D8F)
  31 #define FPGA_5GNR_FEC_VF_DEVICE_ID (0x0D90)
  32
  33 /* Align DMA descriptors to 256 bytes - cache-aligned */
  34 #define FPGA_RING_DESC_ENTRY_LENGTH (8)
  35 /* Ring size is in 256 bits (32 bytes) units */
  36 #define FPGA_RING_DESC_LEN_UNIT_BYTES (32)
  37 /* Maximum size of queue */
  38 #define FPGA_RING_MAX_SIZE (1024)
  39 #define FPGA_FLR_TIMEOUT_UNIT (16.384)
  40
  41 #define FPGA_NUM_UL_QUEUES (32)
  42 #define FPGA_NUM_DL_QUEUES (32)
  43 #define FPGA_TOTAL_NUM_QUEUES (FPGA_NUM_UL_QUEUES + FPGA_NUM_DL_QUEUES)
  44 #define FPGA_NUM_INTR_VEC (FPGA_TOTAL_NUM_QUEUES - RTE_INTR_VEC_RXTX_OFFSET)
  45
  46 #define FPGA_INVALID_HW_QUEUE_ID (0xFFFFFFFF)
  47
  48 #define FPGA_QUEUE_FLUSH_TIMEOUT_US (1000)
  49 #define FPGA_HARQ_RDY_TIMEOUT (10)
  50 #define FPGA_TIMEOUT_CHECK_INTERVAL (5)
  51 #define FPGA_DDR_OVERFLOW (0x10)
  52
  53 #define FPGA_5GNR_FEC_DDR_WR_DATA_LEN_IN_BYTES 8
  54 #define FPGA_5GNR_FEC_DDR_RD_DATA_LEN_IN_BYTES 8
  55
  56
  57 /* FPGA 5GNR FEC Register mapping on BAR0 */
  58 enum {
  59         FPGA_5GNR_FEC_VERSION_ID = 0x00000000, /* len: 4B */
  60         FPGA_5GNR_FEC_CONFIGURATION = 0x00000004, /* len: 2B */
  61         FPGA_5GNR_FEC_QUEUE_PF_VF_MAP_DONE = 0x00000008, /* len: 1B */
  62         FPGA_5GNR_FEC_LOAD_BALANCE_FACTOR = 0x0000000a, /* len: 2B */
  63         FPGA_5GNR_FEC_RING_DESC_LEN = 0x0000000c, /* len: 2B */
  64         FPGA_5GNR_FEC_FLR_TIME_OUT = 0x0000000e, /* len: 2B */
  65         FPGA_5GNR_FEC_VFQ_FLUSH_STATUS_LW = 0x00000018, /* len: 4B */
  66         FPGA_5GNR_FEC_VFQ_FLUSH_STATUS_HI = 0x0000001c, /* len: 4B */
  67         FPGA_5GNR_FEC_QUEUE_MAP = 0x00000040, /* len: 256B */
  68         FPGA_5GNR_FEC_RING_CTRL_REGS = 0x00000200, /* len: 2048B */
  69         FPGA_5GNR_FEC_DDR4_WR_ADDR_REGS = 0x00000A00, /* len: 4B */
  70         FPGA_5GNR_FEC_DDR4_WR_DATA_REGS = 0x00000A08, /* len: 8B */
  71         FPGA_5GNR_FEC_DDR4_WR_DONE_REGS = 0x00000A10, /* len: 1B */
  72         FPGA_5GNR_FEC_DDR4_RD_ADDR_REGS = 0x00000A18, /* len: 4B */
  73         FPGA_5GNR_FEC_DDR4_RD_DONE_REGS = 0x00000A20, /* len: 1B */
  74         FPGA_5GNR_FEC_DDR4_RD_RDY_REGS = 0x00000A28, /* len: 1B */
  75         FPGA_5GNR_FEC_DDR4_RD_DATA_REGS = 0x00000A30, /* len: 8B */
  76         FPGA_5GNR_FEC_DDR4_ADDR_RDY_REGS = 0x00000A38, /* len: 1B */
  77         FPGA_5GNR_FEC_HARQ_BUF_SIZE_RDY_REGS = 0x00000A40, /* len: 1B */
  78         FPGA_5GNR_FEC_HARQ_BUF_SIZE_REGS = 0x00000A48  /* len: 4B */
  79 };
  80
  81 /* FPGA 5GNR FEC Ring Control Registers */
  82 enum {
  83         FPGA_5GNR_FEC_RING_HEAD_ADDR = 0x00000008,
  84         FPGA_5GNR_FEC_RING_SIZE = 0x00000010,
  85         FPGA_5GNR_FEC_RING_MISC = 0x00000014,
  86         FPGA_5GNR_FEC_RING_ENABLE = 0x00000015,
  87         FPGA_5GNR_FEC_RING_FLUSH_QUEUE_EN = 0x00000016,
  88         FPGA_5GNR_FEC_RING_SHADOW_TAIL = 0x00000018,
  89         FPGA_5GNR_FEC_RING_HEAD_POINT = 0x0000001C
  90 };
  91
  92 /* FPGA 5GNR FEC DESCRIPTOR ERROR */
  93 enum {
  94         DESC_ERR_NO_ERR = 0x0,
  95         DESC_ERR_K_P_OUT_OF_RANGE = 0x1,
  96         DESC_ERR_Z_C_NOT_LEGAL = 0x2,
  97         DESC_ERR_DESC_OFFSET_ERR = 0x3,
  98         DESC_ERR_DESC_READ_FAIL = 0x8,
  99         DESC_ERR_DESC_READ_TIMEOUT = 0x9,
 100         DESC_ERR_DESC_READ_TLP_POISONED = 0xA,
 101         DESC_ERR_CB_READ_FAIL = 0xC,
 102         DESC_ERR_CB_READ_TIMEOUT = 0xD,
 103         DESC_ERR_CB_READ_TLP_POISONED = 0xE,
 104         DESC_ERR_HBSTORE_ERR = 0xF
 105 };
 106
 107
 108 /* FPGA 5GNR FEC DMA Encoding Request Descriptor */
 109 struct __rte_packed fpga_dma_enc_desc {
 110         uint32_t done:1,
 111                 rsrvd0:7,
 112                 error:4,
 113                 rsrvd1:4,
 114                 num_null:10,
 115                 rsrvd2:6;
 116         uint32_t ncb:15,
 117                 rsrvd3:1,
 118                 k0:16;
 119         uint32_t irq_en:1,
 120                 crc_en:1,
 121                 rsrvd4:1,
 122                 qm_idx:3,
 123                 bg_idx:1,
 124                 zc:9,
 125                 desc_idx:10,
 126                 rsrvd5:6;
 127         uint16_t rm_e;
 128         uint16_t k_;
 129         uint32_t out_addr_lw;
 130         uint32_t out_addr_hi;
 131         uint32_t in_addr_lw;
 132         uint32_t in_addr_hi;
 133
 134         union {
 135                 struct {
 136                         /* Virtual addresses used to retrieve SW context info */
 137                         void *op_addr;
 138                         /* Stores information about total number of Code Blocks
 139                          * in currently processed Transport Block
 140                          */
 141                         uint64_t cbs_in_op;
 142                 };
 143
 144                 uint8_t sw_ctxt[FPGA_RING_DESC_LEN_UNIT_BYTES *
 145                                         (FPGA_RING_DESC_ENTRY_LENGTH - 1)];
 146         };
 147 };
 148
 149
 150 /* FPGA 5GNR DPC FEC DMA Decoding Request Descriptor */
 151 struct __rte_packed fpga_dma_dec_desc {
 152         uint32_t done:1,
 153                 iter:5,
 154                 et_pass:1,
 155                 crcb_pass:1,
 156                 error:4,
 157                 qm_idx:3,
 158                 max_iter:5,
 159                 bg_idx:1,
 160                 rsrvd0:1,
 161                 harqin_en:1,
 162                 zc:9;
 163         uint32_t hbstroe_offset:22,
 164                 num_null:10;
 165         uint32_t irq_en:1,
 166                 ncb:15,
 167                 desc_idx:10,
 168                 drop_crc24b:1,
 169                 crc24b_ind:1,
 170                 rv:2,
 171                 et_dis:1,
 172                 rsrvd2:1;
 173         uint32_t harq_input_length:16,
 174                 rm_e:16;/*the inbound data byte length*/
 175         uint32_t out_addr_lw;
 176         uint32_t out_addr_hi;
 177         uint32_t in_addr_lw;
 178         uint32_t in_addr_hi;
 179
 180         union {
 181                 struct {
 182                         /* Virtual addresses used to retrieve SW context info */
 183                         void *op_addr;
 184                         /* Stores information about total number of Code Blocks
 185                          * in currently processed Transport Block
 186                          */
 187                         uint8_t cbs_in_op;
 188                 };
 189
 190                 uint32_t sw_ctxt[8 * (FPGA_RING_DESC_ENTRY_LENGTH - 1)];
 191         };
 192 };
 193
 194 /* FPGA 5GNR DMA Descriptor */
 195 union fpga_dma_desc {
 196         struct fpga_dma_enc_desc enc_req;
 197         struct fpga_dma_dec_desc dec_req;
 198 };
 199
 200 /* FPGA 5GNR FEC Ring Control Register */
 201 struct __rte_packed fpga_ring_ctrl_reg {
 202         uint64_t ring_base_addr;
 203         uint64_t ring_head_addr;
 204         uint16_t ring_size:11;
 205         uint16_t rsrvd0;
 206         union { /* Miscellaneous register */
 207                 uint8_t misc;
 208                 uint8_t max_ul_dec:5,
 209                         max_ul_dec_en:1,
 210                         rsrvd1:2;
 211         };
 212         uint8_t enable;
 213         uint8_t flush_queue_en;
 214         uint8_t rsrvd2;
 215         uint16_t shadow_tail;
 216         uint16_t rsrvd3;
 217         uint16_t head_point;
 218         uint16_t rsrvd4;
 219
 220 };
 221
 222 /* Private data structure for each FPGA FEC device */
 223 struct fpga_5gnr_fec_device {
 224         /** Base address of MMIO registers (BAR0) */
 225         void *mmio_base;
 226         /** True if this is a PF FPGA FEC device */
 227         bool pf_device;
 228 };
 229
 230 /* Read a register of FPGA 5GNR FEC device */
 231 static inline uint32_t
 232 fpga_reg_read_32(void *mmio_base, uint32_t offset)
 233 {
 234         void *reg_addr = RTE_PTR_ADD(mmio_base, offset);
 235         uint32_t ret = *((volatile uint32_t *)(reg_addr));
 236         return rte_le_to_cpu_32(ret);
 237 }
 238
 239 #endif /* _FPGA_5GNR_FEC_H_ */