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