1 /*******************************************************************************
2  *
3  * Intel Ethernet Controller XL710 Family Linux Driver
4  * Copyright(c) 2013 - 2014 Intel Corporation.
5  *
6  * This program is free software; you can redistribute it and/or modify it
7  * under the terms and conditions of the GNU General Public License,
8  * version 2, as published by the Free Software Foundation.
9  *
10  * This program is distributed in the hope it will be useful, but WITHOUT
11  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
13  * more details.
14  *
15  * You should have received a copy of the GNU General Public License along
16  * with this program.  If not, see <http://www.gnu.org/licenses/>.
17  *
18  * The full GNU General Public License is included in this distribution in
19  * the file called "COPYING".
20  *
21  * Contact Information:
22  * e1000-devel Mailing List <e1000-devel@lists.sourceforge.net>
23  * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
24  *
25  ******************************************************************************/
26 
27 #ifndef _I40E_ADMINQ_H_
28 #define _I40E_ADMINQ_H_
29 
30 #include "i40e_osdep.h"
31 #include "i40e_adminq_cmd.h"
32 
33 #define I40E_ADMINQ_DESC(R, i)   \
34 	(&(((struct i40e_aq_desc *)((R).desc_buf.va))[i]))
35 
36 #define I40E_ADMINQ_DESC_ALIGNMENT 4096
37 
38 struct i40e_adminq_ring {
39 	struct i40e_virt_mem dma_head;	/* space for dma structures */
40 	struct i40e_dma_mem desc_buf;	/* descriptor ring memory */
41 	struct i40e_virt_mem cmd_buf;	/* command buffer memory */
42 
43 	union {
44 		struct i40e_dma_mem *asq_bi;
45 		struct i40e_dma_mem *arq_bi;
46 	} r;
47 
48 	u16 count;		/* Number of descriptors */
49 	u16 rx_buf_len;		/* Admin Receive Queue buffer length */
50 
51 	/* used for interrupt processing */
52 	u16 next_to_use;
53 	u16 next_to_clean;
54 
55 	/* used for queue tracking */
56 	u32 head;
57 	u32 tail;
58 	u32 len;
59 };
60 
61 /* ASQ transaction details */
62 struct i40e_asq_cmd_details {
63 	void *callback; /* cast from type I40E_ADMINQ_CALLBACK */
64 	u64 cookie;
65 	u16 flags_ena;
66 	u16 flags_dis;
67 	bool async;
68 	bool postpone;
69 };
70 
71 #define I40E_ADMINQ_DETAILS(R, i)   \
72 	(&(((struct i40e_asq_cmd_details *)((R).cmd_buf.va))[i]))
73 
74 /* ARQ event information */
75 struct i40e_arq_event_info {
76 	struct i40e_aq_desc desc;
77 	u16 msg_size;
78 	u8 *msg_buf;
79 };
80 
81 /* Admin Queue information */
82 struct i40e_adminq_info {
83 	struct i40e_adminq_ring arq;    /* receive queue */
84 	struct i40e_adminq_ring asq;    /* send queue */
85 	u16 num_arq_entries;            /* receive queue depth */
86 	u16 num_asq_entries;            /* send queue depth */
87 	u16 arq_buf_size;               /* receive queue buffer size */
88 	u16 asq_buf_size;               /* send queue buffer size */
89 	u16 fw_maj_ver;                 /* firmware major version */
90 	u16 fw_min_ver;                 /* firmware minor version */
91 	u16 api_maj_ver;                /* api major version */
92 	u16 api_min_ver;                /* api minor version */
93 
94 	struct mutex asq_mutex; /* Send queue lock */
95 	struct mutex arq_mutex; /* Receive queue lock */
96 
97 	/* last status values on send and receive queues */
98 	enum i40e_admin_queue_err asq_last_status;
99 	enum i40e_admin_queue_err arq_last_status;
100 };
101 
102 /* general information */
103 #define I40E_AQ_LARGE_BUF	512
104 #define I40E_ASQ_CMD_TIMEOUT	100000  /* usecs */
105 
106 void i40e_fill_default_direct_cmd_desc(struct i40e_aq_desc *desc,
107 				       u16 opcode);
108 
109 #endif /* _I40E_ADMINQ_H_ */
110