xref: /openbsd/sys/dev/usb/if_cuereg.h (revision d485f761)
1 /*	$OpenBSD: if_cuereg.h,v 1.5 2001/10/31 04:24:44 nate Exp $ */
2 /*	$NetBSD: if_cuereg.h,v 1.14 2001/01/21 22:09:24 augustss Exp $	*/
3 /*
4  * Copyright (c) 1997, 1998, 1999, 2000
5  *	Bill Paul <wpaul@ee.columbia.edu>.  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_cuereg.h,v 1.3 2000/01/16 22:45:06 wpaul Exp $
35  */
36 
37 /*
38  * Definitions for the CATC Netmate II USB to ethernet controller.
39  */
40 
41 
42 /*
43  * Vendor specific control commands.
44  */
45 #define CUE_CMD_READSRAM			0xF1
46 #define CUE_CMD_GET_MACADDR			0xF2
47 #define CUE_CMD_RESET				0xF4
48 #define CUE_CMD_WRITEREG			0xFA
49 #define CUE_CMD_READREG				0xFB
50 #define CUE_CMD_WRITESRAM			0xFC
51 
52 /*
53  * Internal registers
54  */
55 #define CUE_TX_BUFCNT				0x20
56 #define CUE_RX_BUFCNT				0x21
57 #define CUE_ADVANCED_OPMODES			0x22
58 #define CUE_TX_BUFPKTS				0x23
59 #define CUE_RX_BUFPKTS				0x24
60 #define CUE_RX_MAXCHAIN				0x25
61 
62 #define CUE_ETHCTL				0x60
63 #define CUE_ETHSTS				0x61
64 #define CUE_PAR5				0x62
65 #define CUE_PAR4				0x63
66 #define CUE_PAR3				0x64
67 #define CUE_PAR2				0x65
68 #define CUE_PAR1				0x66
69 #define CUE_PAR0				0x67
70 
71 /* Error counters, all 16 bits wide. */
72 #define CUE_TX_SINGLECOLL			0x69
73 #define CUE_TX_MULTICOLL			0x6B
74 #define CUE_TX_EXCESSCOLL			0x6D
75 #define CUE_RX_FRAMEERR				0x6F
76 
77 #define CUE_LEDCTL				0x81
78 
79 /* Advenced operating mode register */
80 #define CUE_AOP_SRAMWAITS			0x03
81 #define CUE_AOP_EMBED_RXLEN			0x08
82 #define CUE_AOP_RXCOMBINE			0x10
83 #define CUE_AOP_TXCOMBINE			0x20
84 #define CUE_AOP_EVEN_PKT_READS			0x40
85 #define CUE_AOP_LOOPBK				0x80
86 
87 /* Ethernet control register */
88 #define CUE_ETHCTL_RX_ON			0x01
89 #define CUE_ETHCTL_LINK_POLARITY		0x02
90 #define CUE_ETHCTL_LINK_FORCE_OK		0x04
91 #define CUE_ETHCTL_MCAST_ON			0x08
92 #define CUE_ETHCTL_PROMISC			0x10
93 
94 /* Ethernet status register */
95 #define CUE_ETHSTS_NO_CARRIER			0x01
96 #define CUE_ETHSTS_LATECOLL			0x02
97 #define CUE_ETHSTS_EXCESSCOLL			0x04
98 #define CUE_ETHSTS_TXBUF_AVAIL			0x08
99 #define CUE_ETHSTS_BAD_POLARITY			0x10
100 #define CUE_ETHSTS_LINK_OK			0x20
101 
102 /* LED control register */
103 #define CUE_LEDCTL_BLINK_1X			0x00
104 #define CUE_LEDCTL_BLINK_2X			0x01
105 #define CUE_LEDCTL_BLINK_QUARTER_ON		0x02
106 #define CUE_LEDCTL_BLINK_QUARTER_OFF		0x03
107 #define CUE_LEDCTL_OFF				0x04
108 #define CUE_LEDCTL_FOLLOW_LINK			0x08
109 
110 /*
111  * Address in ASIC's internal SRAM where the
112  * multicast hash table lives. The table is 64 bytes long,
113  * giving us a 512-bit table. We have to set the bit that
114  * corresponds to the broadcast address in order to enable
115  * reception of broadcast frames.
116  */
117 #define CUE_MCAST_TABLE_ADDR			0xFA80
118 #define CUE_MCAST_TABLE_LEN			64
119 
120 #define CUE_TIMEOUT		1000
121 #define ETHER_ALIGN		2
122 #define CUE_BUFSZ		1536
123 #define CUE_MIN_FRAMELEN	60
124 #define CUE_RX_FRAMES		1
125 #define CUE_TX_FRAMES		1
126 
127 #define CUE_RX_LIST_CNT		1
128 #define CUE_TX_LIST_CNT		1
129 
130 #define CUE_CTL_READ		0x01
131 #define CUE_CTL_WRITE		0x02
132 
133 #define CUE_CONFIG_NO		1
134 #define CUE_IFACE_IDX		0
135 
136 /*
137  * The interrupt endpoint is currently unused by the CATC part.
138  */
139 #define CUE_ENDPT_RX		0x0
140 #define CUE_ENDPT_TX		0x1
141 #define CUE_ENDPT_INTR		0x2
142 #define CUE_ENDPT_MAX		0x3
143 
144 struct cue_type {
145 	u_int16_t		cue_vid;
146 	u_int16_t		cue_did;
147 };
148 
149 struct cue_softc;
150 
151 struct cue_chain {
152 	struct cue_softc	*cue_sc;
153 	usbd_xfer_handle	cue_xfer;
154 	char			*cue_buf;
155 	struct mbuf		*cue_mbuf;
156 	int			cue_idx;
157 };
158 
159 struct cue_cdata {
160 	struct cue_chain	cue_tx_chain[CUE_TX_LIST_CNT];
161 	struct cue_chain	cue_rx_chain[CUE_RX_LIST_CNT];
162 	int			cue_tx_prod;
163 	int			cue_tx_cons;
164 	int			cue_tx_cnt;
165 	int			cue_rx_prod;
166 };
167 
168 struct cue_softc {
169 	USBBASEDEVICE		cue_dev;
170 
171 #if defined(__FreeBSD__) || defined(__OpenBSD__)
172 	struct arpcom		arpcom;
173 #define GET_IFP(sc) (&(sc)->arpcom.ac_if)
174 #elif defined(__NetBSD__)
175 	struct ethercom		cue_ec;
176 #if NRND > 0
177 	rndsource_element_t	rnd_source;
178 #endif
179 #define GET_IFP(sc) (&(sc)->cue_ec.ec_if)
180 #endif
181 
182 	usb_callout_t		cue_stat_ch;
183 
184 	usbd_device_handle	cue_udev;
185 	usbd_interface_handle	cue_iface;
186 	u_int16_t		cue_vendor;
187 	u_int16_t		cue_product;
188 	int			cue_ed[CUE_ENDPT_MAX];
189 	usbd_pipe_handle	cue_ep[CUE_ENDPT_MAX];
190 	u_int8_t		cue_mctab[CUE_MCAST_TABLE_LEN];
191 	int			cue_if_flags;
192 	u_int16_t		cue_rxfilt;
193 	struct cue_cdata	cue_cdata;
194 
195 	char			cue_dying;
196 	char			cue_attached;
197 	u_int			cue_rx_errs;
198 	struct timeval		cue_rx_notice;
199 
200 	struct usb_task		cue_tick_task;
201 	struct usb_task		cue_stop_task;
202 };
203