xref: /openbsd/sys/dev/usb/if_axereg.h (revision 7ebc5b51)
1 /*	$OpenBSD: if_axereg.h,v 1.26 2015/06/12 15:47:31 mpi Exp $	*/
2 
3 /*
4  * Copyright (c) 1997, 1998, 1999, 2000-2003
5  *	Bill Paul <wpaul@windriver.com>.  All rights reserved.
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  * 1. Redistributions of source code must retain the above copyright
11  *    notice, this list of conditions and the following disclaimer.
12  * 2. Redistributions in binary form must reproduce the above copyright
13  *    notice, this list of conditions and the following disclaimer in the
14  *    documentation and/or other materials provided with the distribution.
15  * 3. All advertising materials mentioning features or use of this software
16  *    must display the following acknowledgement:
17  *	This product includes software developed by Bill Paul.
18  * 4. Neither the name of the author nor the names of any co-contributors
19  *    may be used to endorse or promote products derived from this software
20  *    without specific prior written permission.
21  *
22  * THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND
23  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25  * ARE DISCLAIMED.  IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD
26  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
27  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
28  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
29  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
30  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
31  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
32  * THE POSSIBILITY OF SUCH DAMAGE.
33  *
34  * $FreeBSD: src/sys/dev/usb/if_axereg.h,v 1.2 2003/06/15 21:45:43 wpaul Exp $
35  */
36 
37 /*
38  * Definitions for the ASIX Electronics AX88172 to ethernet controller.
39  */
40 
41 
42 /*
43  * Vendor specific commands
44  * ASIX conveniently doesn't document the 'set NODEID' command in their
45  * datasheet (thanks a lot guys).
46  * To make handling these commands easier, I added some extra data
47  * which is decided by the axe_cmd() routine. Commands are encoded
48  * in 16 bites, with the format: LDCC. L and D are both nibbles in
49  * the high byte. L represents the data length (0 to 15) and D
50  * represents the direction (0 for vendor read, 1 for vendor write).
51  * CC is the command byte, as specified in the manual.
52  */
53 
54 #define AXE_CMD_LEN(x)	(((x) & 0xF000) >> 12)
55 #define AXE_CMD_DIR(x)	(((x) & 0x0F00) >> 8)
56 #define AXE_CMD_CMD(x)	 ((x) & 0x00FF)
57 
58 #define AXE_172_CMD_READ_RXTX_SRAM		0x2002
59 #define AXE_182_CMD_READ_RXTX_SRAM		0x8002
60 #define AXE_172_CMD_WRITE_RX_SRAM		0x0103
61 #define AXE_172_CMD_WRITE_TX_SRAM		0x0104
62 #define AXE_182_CMD_WRITE_RXTX_SRAM		0x8103
63 #define AXE_CMD_MII_OPMODE_SW			0x0106
64 #define AXE_CMD_MII_READ_REG			0x2007
65 #define AXE_CMD_MII_WRITE_REG			0x2108
66 #define AXE_CMD_MII_READ_OPMODE			0x1009
67 #define AXE_CMD_MII_OPMODE_HW			0x010A
68 #define AXE_CMD_SROM_READ			0x200B
69 #define AXE_CMD_SROM_WRITE			0x010C
70 #define AXE_CMD_SROM_WR_ENABLE			0x010D
71 #define AXE_CMD_SROM_WR_DISABLE			0x010E
72 #define AXE_CMD_RXCTL_READ			0x200F
73 #define AXE_CMD_RXCTL_WRITE			0x0110
74 #define AXE_CMD_READ_IPG012			0x3011
75 #define AXE_172_CMD_WRITE_IPG0			0x0112
76 #define AXE_172_CMD_WRITE_IPG1			0x0113
77 #define AXE_172_CMD_WRITE_IPG2			0x0114
78 #define AXE_178_CMD_WRITE_IPG012		0x0112
79 #define AXE_CMD_READ_MCAST			0x8015
80 #define AXE_CMD_WRITE_MCAST			0x8116
81 #define AXE_172_CMD_READ_NODEID			0x6017
82 #define AXE_172_CMD_WRITE_NODEID		0x6118
83 #define AXE_178_CMD_READ_NODEID			0x6013
84 #define AXE_178_CMD_WRITE_NODEID		0x6114
85 #define AXE_CMD_READ_PHYID			0x2019
86 #define AXE_172_CMD_READ_MEDIA			0x101A
87 #define AXE_178_CMD_READ_MEDIA			0x201A
88 #define AXE_CMD_WRITE_MEDIA			0x011B
89 #define AXE_CMD_READ_MONITOR_MODE		0x101C
90 #define AXE_CMD_WRITE_MONITOR_MODE		0x011D
91 #define AXE_CMD_READ_GPIO			0x101E
92 #define AXE_CMD_WRITE_GPIO			0x011F
93 #define AXE_CMD_SW_RESET_REG			0x0120
94 #define AXE_CMD_SW_PHY_STATUS			0x0021
95 #define AXE_CMD_SW_PHY_SELECT			0x0122
96 
97 #define AXE_SW_RESET_CLEAR			0x00
98 #define AXE_SW_RESET_RR				0x01
99 #define AXE_SW_RESET_RT				0x02
100 #define AXE_SW_RESET_PRTE			0x04
101 #define AXE_SW_RESET_PRL			0x08
102 #define AXE_SW_RESET_BZ				0x10
103 #define AXE_SW_RESET_IPRL			0x20
104 #define AXE_SW_RESET_IPPD			0x40
105 
106 /* AX88178 documentation says to always write this bit... */
107 #define AXE_178_RESET_MAGIC			0x40
108 
109 #define AXE_178_MEDIA_GMII			0x0001
110 #define AXE_MEDIA_FULL_DUPLEX			0x0002
111 #define AXE_172_MEDIA_TX_ABORT_ALLOW		0x0004
112 /* AX88178 documentation says to always write 1 to reserved bit... */
113 #define AXE_178_MEDIA_MAGIC			0x0004
114 #define AXE_178_MEDIA_ENCK			0x0008
115 #define AXE_172_MEDIA_FLOW_CONTROL_EN		0x0010
116 #define AXE_178_MEDIA_RXFLOW_CONTROL_EN		0x0010
117 #define AXE_178_MEDIA_TXFLOW_CONTROL_EN		0x0020
118 #define AXE_178_MEDIA_JUMBO_EN			0x0040
119 #define AXE_178_MEDIA_LTPF_ONLY			0x0080
120 #define AXE_178_MEDIA_RX_EN			0x0100
121 #define AXE_178_MEDIA_100TX			0x0200
122 #define AXE_178_MEDIA_SBP			0x0800
123 #define AXE_178_MEDIA_SUPERMAC			0x1000
124 
125 #define AXE_RXCMD_PROMISC			0x0001
126 #define AXE_RXCMD_ALLMULTI			0x0002
127 #define AXE_172_RXCMD_UNICAST			0x0004
128 #define AXE_178_RXCMD_KEEP_INVALID_CRC		0x0004
129 #define AXE_RXCMD_BROADCAST			0x0008
130 #define AXE_RXCMD_MULTICAST			0x0010
131 #define AXE_RXCMD_ENABLE			0x0080
132 #define AXE_178_RXCMD_MFB			0x0300
133 
134 #define        AXE_PHY_SEL_PRI         1
135 #define        AXE_PHY_SEL_SEC         0
136 #define        AXE_PHY_TYPE_MASK       0xE0
137 #define        AXE_PHY_TYPE_SHIFT      5
138 #define        AXE_PHY_TYPE(x)         \
139        (((x) & AXE_PHY_TYPE_MASK) >> AXE_PHY_TYPE_SHIFT)
140 
141 #define        PHY_TYPE_100_HOME       0       /* 10/100 or 1M HOME PHY */
142 #define        PHY_TYPE_GIG            1       /* Gigabit PHY */
143 #define        PHY_TYPE_SPECIAL        4       /* Special case */
144 #define        PHY_TYPE_RSVD           5       /* Reserved */
145 #define        PHY_TYPE_NON_SUP        7       /* Non-supported PHY */
146 
147 #define        AXE_PHY_NO_MASK         0x1F
148 #define        AXE_PHY_NO(x)           ((x) & AXE_PHY_NO_MASK)
149 
150 #define        AXE_PHY_NO_AX772_EPHY   0x10    /* Embedded 10/100 PHY of AX88772 */
151 
152 #define AXE_GPIO0_EN		0x01
153 #define AXE_GPIO0		0x02
154 #define AXE_GPIO1_EN		0x04
155 #define AXE_GPIO1		0x08
156 #define AXE_GPIO2_EN		0x10
157 #define AXE_GPIO2		0x20
158 #define AXE_GPIO_RELOAD_EEPROM	0x80
159 
160 #define AXE_PHY_MODE_MARVELL		0x00
161 #define AXE_PHY_MODE_CICADA		0x01
162 #define AXE_PHY_MODE_AGERE		0x02
163 #define AXE_PHY_MODE_CICADA_V2		0x05
164 #define AXE_PHY_MODE_CICADA_V2_ASIX	0x09
165 #define AXE_PHY_MODE_REALTEK_8211CL	0x0c
166 #define AXE_PHY_MODE_REALTEK_8211BN	0x0d
167 #define AXE_PHY_MODE_REALTEK_8251CL	0x0e
168 #define AXE_PHY_MODE_ATTANSIC		0x40
169 
170 #define AXE_772B_RXCMD_RH1M	0x0100
171 #define AXE_772B_RXCMD_RH2M	0x0200
172 #define AXE_772B_RXCMD_RH3M	0x0400
173 
174 #define AXE_RH1M_RXLEN_MASK	0x07ff
175 
176 #define AXE_TIMEOUT		1000
177 #define AXE_172_BUFSZ		1536
178 #define AXE_178_MIN_BUFSZ	2048
179 #define AXE_178_MAX_BUFSZ	16384
180 
181 #define AXE_RX_LIST_CNT		1
182 #define AXE_TX_LIST_CNT		1
183 
184 #define AXE_CTL_READ		0x01
185 #define AXE_CTL_WRITE		0x02
186 
187 /* EEPROM Map */
188 #define	AXE_EEPROM_772B_NODEID		0x04
189 
190 /*
191  * The interrupt endpoint is currently unused
192  * by the ASIX part.
193  */
194 #define AXE_ENDPT_RX		0x0
195 #define AXE_ENDPT_TX		0x1
196 #define AXE_ENDPT_INTR		0x2
197 #define AXE_ENDPT_MAX		0x3
198 
199 struct axe_type {
200 	struct usb_devno	axe_dev;
201 	u_int16_t		axe_flags;
202 #define AX178	0x0001		/* AX88178 */
203 #define AX772	0x0002		/* AX88772 */
204 #define AX772B	0x0004		/* AX88772B */
205 };
206 
207 struct axe_softc;
208 
209 struct axe_chain {
210 	struct axe_softc	*axe_sc;
211 	struct usbd_xfer	*axe_xfer;
212 	char			*axe_buf;
213 	struct mbuf		*axe_mbuf;
214 	int			axe_accum;
215 	int			axe_idx;
216 };
217 
218 struct axe_cdata {
219 	struct axe_chain	axe_tx_chain[AXE_TX_LIST_CNT];
220 	struct axe_chain	axe_rx_chain[AXE_RX_LIST_CNT];
221 	int			axe_tx_prod;
222 	int			axe_tx_cons;
223 	int			axe_tx_cnt;
224 	int			axe_rx_prod;
225 };
226 
227 struct axe_sframe_hdr {
228 	u_int16_t		len;
229 	u_int16_t		ilen;
230 } __packed;
231 
232 struct axe_softc {
233 	struct device		axe_dev;
234 #define GET_MII(sc) (&(sc)->axe_mii)
235 	struct arpcom		arpcom;
236 #define GET_IFP(sc) (&(sc)->arpcom.ac_if)
237 	struct mii_data		axe_mii;
238 	struct usbd_device	*axe_udev;
239 	struct usbd_interface	*axe_iface;
240 
241 	u_int16_t		axe_vendor;
242 	u_int16_t		axe_product;
243 
244 	u_int16_t		axe_flags;
245 
246 	int			axe_ed[AXE_ENDPT_MAX];
247 	struct usbd_pipe	*axe_ep[AXE_ENDPT_MAX];
248 	int			axe_unit;
249 	struct axe_cdata	axe_cdata;
250 	struct timeout		axe_stat_ch;
251 
252 	int			axe_refcnt;
253 
254 	struct usb_task		axe_tick_task;
255 	struct usb_task		axe_stop_task;
256 
257 	struct rwlock		axe_mii_lock;
258 
259 	int			axe_link;
260 	unsigned char		axe_ipgs[3];
261 	unsigned char 		axe_phyaddrs[2];
262 	int			axe_phyno;
263 	struct timeval		axe_rx_notice;
264 	u_int			axe_bufsz;
265 };
266