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