xref: /freebsd/sys/dev/qlnx/qlnxe/ecore_sp_api.h (revision 81ad6265)
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  * $FreeBSD$
28  *
29  */
30 
31 #ifndef __ECORE_SP_API_H__
32 #define __ECORE_SP_API_H__
33 
34 #include "ecore_status.h"
35 
36 enum spq_mode {
37 	ECORE_SPQ_MODE_BLOCK,   /* Client will poll a designated mem. address */
38 	ECORE_SPQ_MODE_CB,  /* Client supplies a callback */
39 	ECORE_SPQ_MODE_EBLOCK,  /* ECORE should block until completion */
40 };
41 
42 struct ecore_hwfn;
43 union event_ring_data;
44 struct eth_slow_path_rx_cqe;
45 
46 struct ecore_spq_comp_cb {
47 	void	(*function)(struct ecore_hwfn *,
48 			 void *,
49 			 union event_ring_data *,
50 			 u8 fw_return_code);
51 	void	*cookie;
52 };
53 
54 /**
55  * @brief ecore_eth_cqe_completion - handles the completion of a
56  *        ramrod on the cqe ring
57  *
58  * @param p_hwfn
59  * @param cqe
60  *
61  * @return enum _ecore_status_t
62  */
63 enum _ecore_status_t ecore_eth_cqe_completion(struct ecore_hwfn *p_hwfn,
64 					      struct eth_slow_path_rx_cqe *cqe);
65 /**
66  * @brief ecore_sp_pf_update_tunn_cfg - PF Function Tunnel configuration
67  *					update  Ramrod
68  *
69  * This ramrod is sent to update a tunneling configuration
70  * for a physical function (PF).
71  *
72  * @param p_hwfn
73  * @param p_ptt
74  * @param p_tunn - pf update tunneling parameters
75  * @param comp_mode - completion mode
76  * @param p_comp_data - callback function
77  *
78  * @return enum _ecore_status_t
79  */
80 
81 enum _ecore_status_t
82 ecore_sp_pf_update_tunn_cfg(struct ecore_hwfn *p_hwfn,
83 			    struct ecore_ptt *p_ptt,
84 			    struct ecore_tunnel_info *p_tunn,
85 			    enum spq_mode comp_mode,
86 			    struct ecore_spq_comp_cb *p_comp_data);
87 #endif
88