root/drivers/net/ethernet/intel/iavf/iavf_client.h

INCLUDED FROM

   1 /* SPDX-License-Identifier: GPL-2.0 */
   2 /* Copyright(c) 2013 - 2018 Intel Corporation. */
   3 
   4 #ifndef _IAVF_CLIENT_H_
   5 #define _IAVF_CLIENT_H_
   6 
   7 #define IAVF_CLIENT_STR_LENGTH 10
   8 
   9 /* Client interface version should be updated anytime there is a change in the
  10  * existing APIs or data structures.
  11  */
  12 #define IAVF_CLIENT_VERSION_MAJOR 0
  13 #define IAVF_CLIENT_VERSION_MINOR 01
  14 #define IAVF_CLIENT_VERSION_BUILD 00
  15 #define IAVF_CLIENT_VERSION_STR     \
  16         __stringify(IAVF_CLIENT_VERSION_MAJOR) "." \
  17         __stringify(IAVF_CLIENT_VERSION_MINOR) "." \
  18         __stringify(IAVF_CLIENT_VERSION_BUILD)
  19 
  20 struct iavf_client_version {
  21         u8 major;
  22         u8 minor;
  23         u8 build;
  24         u8 rsvd;
  25 };
  26 
  27 enum iavf_client_state {
  28         __IAVF_CLIENT_NULL,
  29         __IAVF_CLIENT_REGISTERED
  30 };
  31 
  32 enum iavf_client_instance_state {
  33         __IAVF_CLIENT_INSTANCE_NONE,
  34         __IAVF_CLIENT_INSTANCE_OPENED,
  35 };
  36 
  37 struct iavf_ops;
  38 struct iavf_client;
  39 
  40 /* HW does not define a type value for AEQ; only for RX/TX and CEQ.
  41  * In order for us to keep the interface simple, SW will define a
  42  * unique type value for AEQ.
  43  */
  44 #define IAVF_QUEUE_TYPE_PE_AEQ  0x80
  45 #define IAVF_QUEUE_INVALID_IDX  0xFFFF
  46 
  47 struct iavf_qv_info {
  48         u32 v_idx; /* msix_vector */
  49         u16 ceq_idx;
  50         u16 aeq_idx;
  51         u8 itr_idx;
  52 };
  53 
  54 struct iavf_qvlist_info {
  55         u32 num_vectors;
  56         struct iavf_qv_info qv_info[1];
  57 };
  58 
  59 #define IAVF_CLIENT_MSIX_ALL 0xFFFFFFFF
  60 
  61 /* set of LAN parameters useful for clients managed by LAN */
  62 
  63 /* Struct to hold per priority info */
  64 struct iavf_prio_qos_params {
  65         u16 qs_handle; /* qs handle for prio */
  66         u8 tc; /* TC mapped to prio */
  67         u8 reserved;
  68 };
  69 
  70 #define IAVF_CLIENT_MAX_USER_PRIORITY   8
  71 /* Struct to hold Client QoS */
  72 struct iavf_qos_params {
  73         struct iavf_prio_qos_params prio_qos[IAVF_CLIENT_MAX_USER_PRIORITY];
  74 };
  75 
  76 struct iavf_params {
  77         struct iavf_qos_params qos;
  78         u16 mtu;
  79         u16 link_up; /* boolean */
  80 };
  81 
  82 /* Structure to hold LAN device info for a client device */
  83 struct iavf_info {
  84         struct iavf_client_version version;
  85         u8 lanmac[6];
  86         struct net_device *netdev;
  87         struct pci_dev *pcidev;
  88         u8 __iomem *hw_addr;
  89         u8 fid; /* function id, PF id or VF id */
  90 #define IAVF_CLIENT_FTYPE_PF 0
  91 #define IAVF_CLIENT_FTYPE_VF 1
  92         u8 ftype; /* function type, PF or VF */
  93         void *vf; /* cast to iavf_adapter */
  94 
  95         /* All L2 params that could change during the life span of the device
  96          * and needs to be communicated to the client when they change
  97          */
  98         struct iavf_params params;
  99         struct iavf_ops *ops;
 100 
 101         u16 msix_count;  /* number of msix vectors*/
 102         /* Array down below will be dynamically allocated based on msix_count */
 103         struct msix_entry *msix_entries;
 104         u16 itr_index; /* Which ITR index the PE driver is suppose to use */
 105 };
 106 
 107 struct iavf_ops {
 108         /* setup_q_vector_list enables queues with a particular vector */
 109         int (*setup_qvlist)(struct iavf_info *ldev, struct iavf_client *client,
 110                             struct iavf_qvlist_info *qv_info);
 111 
 112         u32 (*virtchnl_send)(struct iavf_info *ldev, struct iavf_client *client,
 113                              u8 *msg, u16 len);
 114 
 115         /* If the PE Engine is unresponsive, RDMA driver can request a reset.*/
 116         void (*request_reset)(struct iavf_info *ldev,
 117                               struct iavf_client *client);
 118 };
 119 
 120 struct iavf_client_ops {
 121         /* Should be called from register_client() or whenever the driver is
 122          * ready to create a specific client instance.
 123          */
 124         int (*open)(struct iavf_info *ldev, struct iavf_client *client);
 125 
 126         /* Should be closed when netdev is unavailable or when unregister
 127          * call comes in. If the close happens due to a reset, set the reset
 128          * bit to true.
 129          */
 130         void (*close)(struct iavf_info *ldev, struct iavf_client *client,
 131                       bool reset);
 132 
 133         /* called when some l2 managed parameters changes - mss */
 134         void (*l2_param_change)(struct iavf_info *ldev,
 135                                 struct iavf_client *client,
 136                                 struct iavf_params *params);
 137 
 138         /* called when a message is received from the PF */
 139         int (*virtchnl_receive)(struct iavf_info *ldev,
 140                                 struct iavf_client *client,
 141                                 u8 *msg, u16 len);
 142 };
 143 
 144 /* Client device */
 145 struct iavf_client_instance {
 146         struct list_head list;
 147         struct iavf_info lan_info;
 148         struct iavf_client *client;
 149         unsigned long  state;
 150 };
 151 
 152 struct iavf_client {
 153         struct list_head list;          /* list of registered clients */
 154         char name[IAVF_CLIENT_STR_LENGTH];
 155         struct iavf_client_version version;
 156         unsigned long state;            /* client state */
 157         atomic_t ref_cnt;  /* Count of all the client devices of this kind */
 158         u32 flags;
 159 #define IAVF_CLIENT_FLAGS_LAUNCH_ON_PROBE       BIT(0)
 160 #define IAVF_TX_FLAGS_NOTIFY_OTHER_EVENTS       BIT(2)
 161         u8 type;
 162 #define IAVF_CLIENT_IWARP 0
 163         struct iavf_client_ops *ops;    /* client ops provided by the client */
 164 };
 165 
 166 /* used by clients */
 167 int iavf_register_client(struct iavf_client *client);
 168 int iavf_unregister_client(struct iavf_client *client);
 169 #endif /* _IAVF_CLIENT_H_ */