xref: /openbmc/linux/drivers/net/ethernet/intel/ixgbe/ixgbe_mbx.h (revision e33bbe69149b802c0c77bfb822685772f85388ca)
1 /* SPDX-License-Identifier: GPL-2.0 */
2 /*******************************************************************************
3 
4   Intel 10 Gigabit PCI Express Linux driver
5   Copyright(c) 1999 - 2016 Intel Corporation.
6 
7   This program is free software; you can redistribute it and/or modify it
8   under the terms and conditions of the GNU General Public License,
9   version 2, as published by the Free Software Foundation.
10 
11   This program is distributed in the hope it will be useful, but WITHOUT
12   ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13   FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
14   more details.
15 
16   You should have received a copy of the GNU General Public License along with
17   this program; if not, write to the Free Software Foundation, Inc.,
18   51 Franklin St - Fifth Floor, Boston, MA 02110-1301 USA.
19 
20   The full GNU General Public License is included in this distribution in
21   the file called "COPYING".
22 
23   Contact Information:
24   Linux NICS <linux.nics@intel.com>
25   e1000-devel Mailing List <e1000-devel@lists.sourceforge.net>
26   Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
27 
28 *******************************************************************************/
29 
30 #ifndef _IXGBE_MBX_H_
31 #define _IXGBE_MBX_H_
32 
33 #include "ixgbe_type.h"
34 
35 #define IXGBE_VFMAILBOX_SIZE        16 /* 16 32 bit words - 64 bytes */
36 #define IXGBE_ERR_MBX               -100
37 
38 #define IXGBE_VFMAILBOX             0x002FC
39 #define IXGBE_VFMBMEM               0x00200
40 
41 #define IXGBE_PFMAILBOX_STS   0x00000001 /* Initiate message send to VF */
42 #define IXGBE_PFMAILBOX_ACK   0x00000002 /* Ack message recv'd from VF */
43 #define IXGBE_PFMAILBOX_VFU   0x00000004 /* VF owns the mailbox buffer */
44 #define IXGBE_PFMAILBOX_PFU   0x00000008 /* PF owns the mailbox buffer */
45 #define IXGBE_PFMAILBOX_RVFU  0x00000010 /* Reset VFU - used when VF stuck */
46 
47 #define IXGBE_MBVFICR_VFREQ_MASK 0x0000FFFF /* bits for VF messages */
48 #define IXGBE_MBVFICR_VFREQ_VF1  0x00000001 /* bit for VF 1 message */
49 #define IXGBE_MBVFICR_VFACK_MASK 0xFFFF0000 /* bits for VF acks */
50 #define IXGBE_MBVFICR_VFACK_VF1  0x00010000 /* bit for VF 1 ack */
51 
52 
53 /* If it's a IXGBE_VF_* msg then it originates in the VF and is sent to the
54  * PF.  The reverse is true if it is IXGBE_PF_*.
55  * Message ACK's are the value or'd with 0xF0000000
56  */
57 #define IXGBE_VT_MSGTYPE_ACK      0x80000000  /* Messages below or'd with
58 					       * this are the ACK */
59 #define IXGBE_VT_MSGTYPE_NACK     0x40000000  /* Messages below or'd with
60 					       * this are the NACK */
61 #define IXGBE_VT_MSGTYPE_CTS      0x20000000  /* Indicates that VF is still
62 						 clear to send requests */
63 #define IXGBE_VT_MSGINFO_SHIFT    16
64 /* bits 23:16 are used for exra info for certain messages */
65 #define IXGBE_VT_MSGINFO_MASK     (0xFF << IXGBE_VT_MSGINFO_SHIFT)
66 
67 /* definitions to support mailbox API version negotiation */
68 
69 /*
70  * Each element denotes a version of the API; existing numbers may not
71  * change; any additions must go at the end
72  */
73 enum ixgbe_pfvf_api_rev {
74 	ixgbe_mbox_api_10,	/* API version 1.0, linux/freebsd VF driver */
75 	ixgbe_mbox_api_20,	/* API version 2.0, solaris Phase1 VF driver */
76 	ixgbe_mbox_api_11,	/* API version 1.1, linux/freebsd VF driver */
77 	ixgbe_mbox_api_12,	/* API version 1.2, linux/freebsd VF driver */
78 	ixgbe_mbox_api_13,	/* API version 1.3, linux/freebsd VF driver */
79 	/* This value should always be last */
80 	ixgbe_mbox_api_unknown,	/* indicates that API version is not known */
81 };
82 
83 /* mailbox API, legacy requests */
84 #define IXGBE_VF_RESET            0x01 /* VF requests reset */
85 #define IXGBE_VF_SET_MAC_ADDR     0x02 /* VF requests PF to set MAC addr */
86 #define IXGBE_VF_SET_MULTICAST    0x03 /* VF requests PF to set MC addr */
87 #define IXGBE_VF_SET_VLAN         0x04 /* VF requests PF to set VLAN */
88 
89 /* mailbox API, version 1.0 VF requests */
90 #define IXGBE_VF_SET_LPE	0x05 /* VF requests PF to set VMOLR.LPE */
91 #define IXGBE_VF_SET_MACVLAN	0x06 /* VF requests PF for unicast filter */
92 #define IXGBE_VF_API_NEGOTIATE	0x08 /* negotiate API version */
93 
94 /* mailbox API, version 1.1 VF requests */
95 #define IXGBE_VF_GET_QUEUES	0x09 /* get queue configuration */
96 
97 /* GET_QUEUES return data indices within the mailbox */
98 #define IXGBE_VF_TX_QUEUES	1	/* number of Tx queues supported */
99 #define IXGBE_VF_RX_QUEUES	2	/* number of Rx queues supported */
100 #define IXGBE_VF_TRANS_VLAN	3	/* Indication of port vlan */
101 #define IXGBE_VF_DEF_QUEUE	4	/* Default queue offset */
102 
103 /* mailbox API, version 1.2 VF requests */
104 #define IXGBE_VF_GET_RETA	0x0a	/* VF request for RETA */
105 #define IXGBE_VF_GET_RSS_KEY	0x0b	/* get RSS key */
106 
107 #define IXGBE_VF_UPDATE_XCAST_MODE	0x0c
108 
109 /* length of permanent address message returned from PF */
110 #define IXGBE_VF_PERMADDR_MSG_LEN 4
111 /* word in permanent address message with the current multicast type */
112 #define IXGBE_VF_MC_TYPE_WORD     3
113 
114 #define IXGBE_PF_CONTROL_MSG      0x0100 /* PF control message */
115 
116 #define IXGBE_VF_MBX_INIT_TIMEOUT 2000 /* number of retries on mailbox */
117 #define IXGBE_VF_MBX_INIT_DELAY   500  /* microseconds between retries */
118 
119 s32 ixgbe_read_mbx(struct ixgbe_hw *, u32 *, u16, u16);
120 s32 ixgbe_write_mbx(struct ixgbe_hw *, u32 *, u16, u16);
121 s32 ixgbe_check_for_msg(struct ixgbe_hw *, u16);
122 s32 ixgbe_check_for_ack(struct ixgbe_hw *, u16);
123 s32 ixgbe_check_for_rst(struct ixgbe_hw *, u16);
124 #ifdef CONFIG_PCI_IOV
125 void ixgbe_init_mbx_params_pf(struct ixgbe_hw *);
126 #endif /* CONFIG_PCI_IOV */
127 
128 extern const struct ixgbe_mbx_operations mbx_ops_generic;
129 
130 #endif /* _IXGBE_MBX_H_ */
131