xref: /linux/drivers/net/usb/asix.h (revision ca55b2fef3a9373fcfc30f82fd26bc7fccbda732)
1 /*
2  * ASIX AX8817X based USB 2.0 Ethernet Devices
3  * Copyright (C) 2003-2006 David Hollis <dhollis@davehollis.com>
4  * Copyright (C) 2005 Phil Chang <pchang23@sbcglobal.net>
5  * Copyright (C) 2006 James Painter <jamie.painter@iname.com>
6  * Copyright (c) 2002-2003 TiVo Inc.
7  *
8  * This program is free software; you can redistribute it and/or modify
9  * it under the terms of the GNU General Public License as published by
10  * the Free Software Foundation; either version 2 of the License, or
11  * (at your option) any later version.
12  *
13  * This program is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16  * GNU General Public License for more details.
17  *
18  * You should have received a copy of the GNU General Public License
19  * along with this program; if not, see <http://www.gnu.org/licenses/>.
20  */
21 
22 #ifndef _ASIX_H
23 #define _ASIX_H
24 
25 // #define	DEBUG			// error path messages, extra info
26 // #define	VERBOSE			// more; success messages
27 
28 #include <linux/module.h>
29 #include <linux/kmod.h>
30 #include <linux/netdevice.h>
31 #include <linux/etherdevice.h>
32 #include <linux/ethtool.h>
33 #include <linux/workqueue.h>
34 #include <linux/mii.h>
35 #include <linux/usb.h>
36 #include <linux/crc32.h>
37 #include <linux/usb/usbnet.h>
38 #include <linux/slab.h>
39 #include <linux/if_vlan.h>
40 
41 #define DRIVER_VERSION "22-Dec-2011"
42 #define DRIVER_NAME "asix"
43 
44 /* ASIX AX8817X based USB 2.0 Ethernet Devices */
45 
46 #define AX_CMD_SET_SW_MII		0x06
47 #define AX_CMD_READ_MII_REG		0x07
48 #define AX_CMD_WRITE_MII_REG		0x08
49 #define AX_CMD_SET_HW_MII		0x0a
50 #define AX_CMD_READ_EEPROM		0x0b
51 #define AX_CMD_WRITE_EEPROM		0x0c
52 #define AX_CMD_WRITE_ENABLE		0x0d
53 #define AX_CMD_WRITE_DISABLE		0x0e
54 #define AX_CMD_READ_RX_CTL		0x0f
55 #define AX_CMD_WRITE_RX_CTL		0x10
56 #define AX_CMD_READ_IPG012		0x11
57 #define AX_CMD_WRITE_IPG0		0x12
58 #define AX_CMD_WRITE_IPG1		0x13
59 #define AX_CMD_READ_NODE_ID		0x13
60 #define AX_CMD_WRITE_NODE_ID		0x14
61 #define AX_CMD_WRITE_IPG2		0x14
62 #define AX_CMD_WRITE_MULTI_FILTER	0x16
63 #define AX88172_CMD_READ_NODE_ID	0x17
64 #define AX_CMD_READ_PHY_ID		0x19
65 #define AX_CMD_READ_MEDIUM_STATUS	0x1a
66 #define AX_CMD_WRITE_MEDIUM_MODE	0x1b
67 #define AX_CMD_READ_MONITOR_MODE	0x1c
68 #define AX_CMD_WRITE_MONITOR_MODE	0x1d
69 #define AX_CMD_READ_GPIOS		0x1e
70 #define AX_CMD_WRITE_GPIOS		0x1f
71 #define AX_CMD_SW_RESET			0x20
72 #define AX_CMD_SW_PHY_STATUS		0x21
73 #define AX_CMD_SW_PHY_SELECT		0x22
74 
75 #define AX_PHY_SELECT_MASK		(BIT(3) | BIT(2))
76 #define AX_PHY_SELECT_INTERNAL		0
77 #define AX_PHY_SELECT_EXTERNAL		BIT(2)
78 
79 #define AX_MONITOR_MODE			0x01
80 #define AX_MONITOR_LINK			0x02
81 #define AX_MONITOR_MAGIC		0x04
82 #define AX_MONITOR_HSFS			0x10
83 
84 /* AX88172 Medium Status Register values */
85 #define AX88172_MEDIUM_FD		0x02
86 #define AX88172_MEDIUM_TX		0x04
87 #define AX88172_MEDIUM_FC		0x10
88 #define AX88172_MEDIUM_DEFAULT \
89 		( AX88172_MEDIUM_FD | AX88172_MEDIUM_TX | AX88172_MEDIUM_FC )
90 
91 #define AX_MCAST_FILTER_SIZE		8
92 #define AX_MAX_MCAST			64
93 
94 #define AX_SWRESET_CLEAR		0x00
95 #define AX_SWRESET_RR			0x01
96 #define AX_SWRESET_RT			0x02
97 #define AX_SWRESET_PRTE			0x04
98 #define AX_SWRESET_PRL			0x08
99 #define AX_SWRESET_BZ			0x10
100 #define AX_SWRESET_IPRL			0x20
101 #define AX_SWRESET_IPPD			0x40
102 
103 #define AX88772_IPG0_DEFAULT		0x15
104 #define AX88772_IPG1_DEFAULT		0x0c
105 #define AX88772_IPG2_DEFAULT		0x12
106 
107 /* AX88772 & AX88178 Medium Mode Register */
108 #define AX_MEDIUM_PF		0x0080
109 #define AX_MEDIUM_JFE		0x0040
110 #define AX_MEDIUM_TFC		0x0020
111 #define AX_MEDIUM_RFC		0x0010
112 #define AX_MEDIUM_ENCK		0x0008
113 #define AX_MEDIUM_AC		0x0004
114 #define AX_MEDIUM_FD		0x0002
115 #define AX_MEDIUM_GM		0x0001
116 #define AX_MEDIUM_SM		0x1000
117 #define AX_MEDIUM_SBP		0x0800
118 #define AX_MEDIUM_PS		0x0200
119 #define AX_MEDIUM_RE		0x0100
120 
121 #define AX88178_MEDIUM_DEFAULT	\
122 	(AX_MEDIUM_PS | AX_MEDIUM_FD | AX_MEDIUM_AC | \
123 	 AX_MEDIUM_RFC | AX_MEDIUM_TFC | AX_MEDIUM_JFE | \
124 	 AX_MEDIUM_RE)
125 
126 #define AX88772_MEDIUM_DEFAULT	\
127 	(AX_MEDIUM_FD | AX_MEDIUM_RFC | \
128 	 AX_MEDIUM_TFC | AX_MEDIUM_PS | \
129 	 AX_MEDIUM_AC | AX_MEDIUM_RE)
130 
131 /* AX88772 & AX88178 RX_CTL values */
132 #define AX_RX_CTL_SO		0x0080
133 #define AX_RX_CTL_AP		0x0020
134 #define AX_RX_CTL_AM		0x0010
135 #define AX_RX_CTL_AB		0x0008
136 #define AX_RX_CTL_SEP		0x0004
137 #define AX_RX_CTL_AMALL		0x0002
138 #define AX_RX_CTL_PRO		0x0001
139 #define AX_RX_CTL_MFB_2048	0x0000
140 #define AX_RX_CTL_MFB_4096	0x0100
141 #define AX_RX_CTL_MFB_8192	0x0200
142 #define AX_RX_CTL_MFB_16384	0x0300
143 
144 #define AX_DEFAULT_RX_CTL	(AX_RX_CTL_SO | AX_RX_CTL_AB)
145 
146 /* GPIO 0 .. 2 toggles */
147 #define AX_GPIO_GPO0EN		0x01	/* GPIO0 Output enable */
148 #define AX_GPIO_GPO_0		0x02	/* GPIO0 Output value */
149 #define AX_GPIO_GPO1EN		0x04	/* GPIO1 Output enable */
150 #define AX_GPIO_GPO_1		0x08	/* GPIO1 Output value */
151 #define AX_GPIO_GPO2EN		0x10	/* GPIO2 Output enable */
152 #define AX_GPIO_GPO_2		0x20	/* GPIO2 Output value */
153 #define AX_GPIO_RESERVED	0x40	/* Reserved */
154 #define AX_GPIO_RSE		0x80	/* Reload serial EEPROM */
155 
156 #define AX_EEPROM_MAGIC		0xdeadbeef
157 #define AX_EEPROM_LEN		0x200
158 
159 /* This structure cannot exceed sizeof(unsigned long [5]) AKA 20 bytes */
160 struct asix_data {
161 	u8 multi_filter[AX_MCAST_FILTER_SIZE];
162 	u8 mac_addr[ETH_ALEN];
163 	u8 phymode;
164 	u8 ledmode;
165 	u8 res;
166 };
167 
168 struct asix_rx_fixup_info {
169 	struct sk_buff *ax_skb;
170 	u32 header;
171 	u16 size;
172 	bool split_head;
173 };
174 
175 struct asix_common_private {
176 	struct asix_rx_fixup_info rx_fixup_info;
177 };
178 
179 extern const struct driver_info ax88172a_info;
180 
181 /* ASIX specific flags */
182 #define FLAG_EEPROM_MAC		(1UL << 0)  /* init device MAC from eeprom */
183 
184 int asix_read_cmd(struct usbnet *dev, u8 cmd, u16 value, u16 index,
185 		  u16 size, void *data);
186 
187 int asix_write_cmd(struct usbnet *dev, u8 cmd, u16 value, u16 index,
188 		   u16 size, void *data);
189 
190 void asix_write_cmd_async(struct usbnet *dev, u8 cmd, u16 value,
191 			  u16 index, u16 size, void *data);
192 
193 int asix_rx_fixup_internal(struct usbnet *dev, struct sk_buff *skb,
194 			   struct asix_rx_fixup_info *rx);
195 int asix_rx_fixup_common(struct usbnet *dev, struct sk_buff *skb);
196 
197 struct sk_buff *asix_tx_fixup(struct usbnet *dev, struct sk_buff *skb,
198 			      gfp_t flags);
199 
200 int asix_set_sw_mii(struct usbnet *dev);
201 int asix_set_hw_mii(struct usbnet *dev);
202 
203 int asix_read_phy_addr(struct usbnet *dev, int internal);
204 int asix_get_phy_addr(struct usbnet *dev);
205 
206 int asix_sw_reset(struct usbnet *dev, u8 flags);
207 
208 u16 asix_read_rx_ctl(struct usbnet *dev);
209 int asix_write_rx_ctl(struct usbnet *dev, u16 mode);
210 
211 u16 asix_read_medium_status(struct usbnet *dev);
212 int asix_write_medium_mode(struct usbnet *dev, u16 mode);
213 
214 int asix_write_gpio(struct usbnet *dev, u16 value, int sleep);
215 
216 void asix_set_multicast(struct net_device *net);
217 
218 int asix_mdio_read(struct net_device *netdev, int phy_id, int loc);
219 void asix_mdio_write(struct net_device *netdev, int phy_id, int loc, int val);
220 
221 void asix_get_wol(struct net_device *net, struct ethtool_wolinfo *wolinfo);
222 int asix_set_wol(struct net_device *net, struct ethtool_wolinfo *wolinfo);
223 
224 int asix_get_eeprom_len(struct net_device *net);
225 int asix_get_eeprom(struct net_device *net, struct ethtool_eeprom *eeprom,
226 		    u8 *data);
227 int asix_set_eeprom(struct net_device *net, struct ethtool_eeprom *eeprom,
228 		    u8 *data);
229 
230 void asix_get_drvinfo(struct net_device *net, struct ethtool_drvinfo *info);
231 
232 int asix_set_mac_address(struct net_device *net, void *p);
233 
234 #endif /* _ASIX_H */
235