1 /* SPDX-License-Identifier: BSD-3-Clause 2 * Copyright (c) 2016 - 2018 Cavium Inc. 3 * All rights reserved. 4 * www.cavium.com 5 */ 6 7 #ifndef __ECORE_VF_H__ 8 #define __ECORE_VF_H__ 9 10 #include "ecore_status.h" 11 #include "ecore_vf_api.h" 12 #include "ecore_l2_api.h" 13 #include "ecore_vfpf_if.h" 14 #include "ecore_dev_api.h" 15 16 /* Default number of CIDs [total of both Rx and Tx] to be requested 17 * by default. 18 */ 19 #define ECORE_ETH_VF_DEFAULT_NUM_CIDS (32) 20 21 /* This data is held in the ecore_hwfn structure for VFs only. */ 22 struct ecore_vf_iov { 23 union vfpf_tlvs *vf2pf_request; 24 dma_addr_t vf2pf_request_phys; 25 union pfvf_tlvs *pf2vf_reply; 26 dma_addr_t pf2vf_reply_phys; 27 28 /* Should be taken whenever the mailbox buffers are accessed */ 29 osal_mutex_t mutex; 30 u8 *offset; 31 32 /* Bulletin Board */ 33 struct ecore_bulletin bulletin; 34 struct ecore_bulletin_content bulletin_shadow; 35 36 /* we set aside a copy of the acquire response */ 37 struct pfvf_acquire_resp_tlv acquire_resp; 38 39 /* In case PF originates prior to the fp-hsi version comparison, 40 * this has to be propagated as it affects the fastpath. 41 */ 42 bool b_pre_fp_hsi; 43 44 /* Current day VFs are passing the SBs physical address on vport 45 * start, and as they lack an IGU mapping they need to store the 46 * addresses of previously registered SBs. 47 * Even if we were to change configuration flow, due to backward 48 * compatibility [with older PFs] we'd still need to store these. 49 */ 50 struct ecore_sb_info *sbs_info[PFVF_MAX_SBS_PER_VF]; 51 52 #ifdef CONFIG_ECORE_SW_CHANNEL 53 /* Would be set if the VF is to try communicating with it PF 54 * using a hw channel. 55 */ 56 bool b_hw_channel; 57 #endif 58 59 /* Determines whether VF utilizes doorbells via limited register 60 * bar or via the doorbell bar. 61 */ 62 bool b_doorbell_bar; 63 64 /* retry count for VF acquire on channel timeout */ 65 u8 acquire_retry_cnt; 66 }; 67 68 /** 69 * @brief VF - Get coalesce per VF's relative queue. 70 * 71 * @param p_hwfn 72 * @param p_coal - coalesce value in micro second for VF queues. 73 * @param p_cid - queue cid 74 * 75 **/ 76 enum _ecore_status_t ecore_vf_pf_get_coalesce(struct ecore_hwfn *p_hwfn, 77 u16 *p_coal, 78 struct ecore_queue_cid *p_cid); 79 80 enum _ecore_status_t ecore_vf_pf_acquire(struct ecore_hwfn *p_hwfn); 81 /** 82 * @brief VF - Set Rx/Tx coalesce per VF's relative queue. 83 * Coalesce value '0' will omit the configuration. 84 * 85 * @param p_hwfn 86 * @param rx_coal - coalesce value in micro second for rx queue 87 * @param tx_coal - coalesce value in micro second for tx queue 88 * @param p_cid - queue cid 89 * 90 **/ 91 enum _ecore_status_t ecore_vf_pf_set_coalesce(struct ecore_hwfn *p_hwfn, 92 u16 rx_coal, u16 tx_coal, 93 struct ecore_queue_cid *p_cid); 94 95 #ifdef CONFIG_ECORE_SRIOV 96 /** 97 * @brief hw preparation for VF 98 * sends ACQUIRE message 99 * 100 * @param p_hwfn 101 * @param p_params 102 * 103 * @return enum _ecore_status_t 104 */ 105 enum _ecore_status_t 106 ecore_vf_hw_prepare(struct ecore_hwfn *p_hwfn, 107 struct ecore_hw_prepare_params *p_params); 108 109 /** 110 * @brief VF - start the RX Queue by sending a message to the PF 111 * 112 * @param p_hwfn 113 * @param p_cid - Only relative fields are relevant 114 * @param bd_max_bytes - maximum number of bytes per bd 115 * @param bd_chain_phys_addr - physical address of bd chain 116 * @param cqe_pbl_addr - physical address of pbl 117 * @param cqe_pbl_size - pbl size 118 * @param pp_prod - pointer to the producer to be 119 * used in fasthpath 120 * 121 * @return enum _ecore_status_t 122 */ 123 enum _ecore_status_t ecore_vf_pf_rxq_start(struct ecore_hwfn *p_hwfn, 124 struct ecore_queue_cid *p_cid, 125 u16 bd_max_bytes, 126 dma_addr_t bd_chain_phys_addr, 127 dma_addr_t cqe_pbl_addr, 128 u16 cqe_pbl_size, 129 void OSAL_IOMEM **pp_prod); 130 131 /** 132 * @brief VF - start the TX queue by sending a message to the 133 * PF. 134 * 135 * @param p_hwfn 136 * @param p_cid 137 * @param bd_chain_phys_addr - physical address of tx chain 138 * @param pp_doorbell - pointer to address to which to 139 * write the doorbell too.. 140 * 141 * @return enum _ecore_status_t 142 */ 143 enum _ecore_status_t 144 ecore_vf_pf_txq_start(struct ecore_hwfn *p_hwfn, 145 struct ecore_queue_cid *p_cid, 146 dma_addr_t pbl_addr, u16 pbl_size, 147 void OSAL_IOMEM **pp_doorbell); 148 149 /** 150 * @brief VF - stop the RX queue by sending a message to the PF 151 * 152 * @param p_hwfn 153 * @param p_cid 154 * @param cqe_completion 155 * 156 * @return enum _ecore_status_t 157 */ 158 enum _ecore_status_t ecore_vf_pf_rxq_stop(struct ecore_hwfn *p_hwfn, 159 struct ecore_queue_cid *p_cid, 160 bool cqe_completion); 161 162 /** 163 * @brief VF - stop the TX queue by sending a message to the PF 164 * 165 * @param p_hwfn 166 * @param p_cid 167 * 168 * @return enum _ecore_status_t 169 */ 170 enum _ecore_status_t ecore_vf_pf_txq_stop(struct ecore_hwfn *p_hwfn, 171 struct ecore_queue_cid *p_cid); 172 173 /* TODO - fix all the !SRIOV prototypes */ 174 175 #ifndef LINUX_REMOVE 176 /** 177 * @brief VF - update the RX queue by sending a message to the 178 * PF 179 * 180 * @param p_hwfn 181 * @param pp_cid - list of queue-cids which we want to update 182 * @param num_rxqs 183 * @param comp_cqe_flg 184 * @param comp_event_flg 185 * 186 * @return enum _ecore_status_t 187 */ 188 enum _ecore_status_t ecore_vf_pf_rxqs_update(struct ecore_hwfn *p_hwfn, 189 struct ecore_queue_cid **pp_cid, 190 u8 num_rxqs, 191 u8 comp_cqe_flg, 192 u8 comp_event_flg); 193 #endif 194 195 /** 196 * @brief VF - send a vport update command 197 * 198 * @param p_hwfn 199 * @param params 200 * 201 * @return enum _ecore_status_t 202 */ 203 enum _ecore_status_t 204 ecore_vf_pf_vport_update(struct ecore_hwfn *p_hwfn, 205 struct ecore_sp_vport_update_params *p_params); 206 207 /** 208 * @brief VF - send a close message to PF 209 * 210 * @param p_hwfn 211 * 212 * @return enum _ecore_status 213 */ 214 enum _ecore_status_t ecore_vf_pf_reset(struct ecore_hwfn *p_hwfn); 215 216 /** 217 * @brief VF - free vf`s memories 218 * 219 * @param p_hwfn 220 * 221 * @return enum _ecore_status 222 */ 223 enum _ecore_status_t ecore_vf_pf_release(struct ecore_hwfn *p_hwfn); 224 225 /** 226 * @brief ecore_vf_get_igu_sb_id - Get the IGU SB ID for a given 227 * sb_id. For VFs igu sbs don't have to be contiguous 228 * 229 * @param p_hwfn 230 * @param sb_id 231 * 232 * @return INLINE u16 233 */ 234 u16 ecore_vf_get_igu_sb_id(struct ecore_hwfn *p_hwfn, 235 u16 sb_id); 236 237 /** 238 * @brief Stores [or removes] a configured sb_info. 239 * 240 * @param p_hwfn 241 * @param sb_id - zero-based SB index [for fastpath] 242 * @param sb_info - may be OSAL_NULL [during removal]. 243 */ 244 void ecore_vf_set_sb_info(struct ecore_hwfn *p_hwfn, 245 u16 sb_id, struct ecore_sb_info *p_sb); 246 247 /** 248 * @brief ecore_vf_pf_vport_start - perform vport start for VF. 249 * 250 * @param p_hwfn 251 * @param vport_id 252 * @param mtu 253 * @param inner_vlan_removal 254 * @param tpa_mode 255 * @param max_buffers_per_cqe, 256 * @param only_untagged - default behavior regarding vlan acceptance 257 * 258 * @return enum _ecore_status 259 */ 260 enum _ecore_status_t ecore_vf_pf_vport_start( 261 struct ecore_hwfn *p_hwfn, 262 u8 vport_id, 263 u16 mtu, 264 u8 inner_vlan_removal, 265 enum ecore_tpa_mode tpa_mode, 266 u8 max_buffers_per_cqe, 267 u8 only_untagged); 268 269 /** 270 * @brief ecore_vf_pf_vport_stop - stop the VF's vport 271 * 272 * @param p_hwfn 273 * 274 * @return enum _ecore_status 275 */ 276 enum _ecore_status_t ecore_vf_pf_vport_stop(struct ecore_hwfn *p_hwfn); 277 278 enum _ecore_status_t ecore_vf_pf_filter_ucast( 279 struct ecore_hwfn *p_hwfn, 280 struct ecore_filter_ucast *p_param); 281 282 void ecore_vf_pf_filter_mcast(struct ecore_hwfn *p_hwfn, 283 struct ecore_filter_mcast *p_filter_cmd); 284 285 /** 286 * @brief ecore_vf_pf_int_cleanup - clean the SB of the VF 287 * 288 * @param p_hwfn 289 * 290 * @return enum _ecore_status 291 */ 292 enum _ecore_status_t ecore_vf_pf_int_cleanup(struct ecore_hwfn *p_hwfn); 293 294 /** 295 * @brief - return the link params in a given bulletin board 296 * 297 * @param p_params - pointer to a struct to fill with link params 298 * @param p_bulletin 299 */ 300 void __ecore_vf_get_link_params(struct ecore_mcp_link_params *p_params, 301 struct ecore_bulletin_content *p_bulletin); 302 303 /** 304 * @brief - return the link state in a given bulletin board 305 * 306 * @param p_link - pointer to a struct to fill with link state 307 * @param p_bulletin 308 */ 309 void __ecore_vf_get_link_state(struct ecore_mcp_link_state *p_link, 310 struct ecore_bulletin_content *p_bulletin); 311 312 /** 313 * @brief - return the link capabilities in a given bulletin board 314 * 315 * @param p_link - pointer to a struct to fill with link capabilities 316 * @param p_bulletin 317 */ 318 void __ecore_vf_get_link_caps(struct ecore_mcp_link_capabilities *p_link_caps, 319 struct ecore_bulletin_content *p_bulletin); 320 321 enum _ecore_status_t 322 ecore_vf_pf_tunnel_param_update(struct ecore_hwfn *p_hwfn, 323 struct ecore_tunnel_info *p_tunn); 324 325 void ecore_vf_set_vf_start_tunn_update_param(struct ecore_tunnel_info *p_tun); 326 327 u32 ecore_vf_hw_bar_size(struct ecore_hwfn *p_hwfn, 328 enum BAR_ID bar_id); 329 330 /** 331 * @brief - ecore_vf_pf_update_mtu Update MTU for VF. 332 * 333 * @param p_hwfn 334 * @param - mtu 335 */ 336 enum _ecore_status_t 337 ecore_vf_pf_update_mtu(struct ecore_hwfn *p_hwfn, u16 mtu); 338 #endif 339 #endif /* __ECORE_VF_H__ */ 340