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