xref: /netbsd-src/sys/dev/pci/if_rtw_pci.c (revision 2b3d1ee8a773e028429b331332895d44f445d720)
1 /* $NetBSD: if_rtw_pci.c,v 1.21 2012/09/23 01:12:51 chs Exp $ */
2 
3 /*-
4  * Copyright (c) 2004, 2005, 2010 David Young.  All rights reserved.
5  *
6  * Adapted for the RTL8180 by David Young.
7  *
8  * Redistribution and use in source and binary forms, with or without
9  * modification, are permitted provided that the following conditions
10  * are met:
11  * 1. Redistributions of source code must retain the above copyright
12  *    notice, this list of conditions and the following disclaimer.
13  * 2. Redistributions in binary form must reproduce the above copyright
14  *    notice, this list of conditions and the following disclaimer in the
15  *    documentation and/or other materials provided with the distribution.
16  *
17  * THIS SOFTWARE IS PROVIDED BY David Young ``AS IS'' AND ANY
18  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
19  * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
20  * PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL David
21  * Young BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
22  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
23  * TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
24  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
25  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
26  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
28  * OF SUCH DAMAGE.
29  */
30 /*-
31  * Copyright (c) 1998, 1999, 2000, 2002 The NetBSD Foundation, Inc.
32  * All rights reserved.
33  *
34  * This code is derived from software contributed to The NetBSD Foundation
35  * by Jason R. Thorpe of the Numerical Aerospace Simulation Facility,
36  * NASA Ames Research Center; Charles M. Hannum; and David Young.
37  *
38  * Redistribution and use in source and binary forms, with or without
39  * modification, are permitted provided that the following conditions
40  * are met:
41  * 1. Redistributions of source code must retain the above copyright
42  *    notice, this list of conditions and the following disclaimer.
43  * 2. Redistributions in binary form must reproduce the above copyright
44  *    notice, this list of conditions and the following disclaimer in the
45  *    documentation and/or other materials provided with the distribution.
46  *
47  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
48  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
49  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
50  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
51  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
52  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
53  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
54  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
55  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
56  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
57  * POSSIBILITY OF SUCH DAMAGE.
58  */
59 
60 /*
61  * PCI bus front-end for the Realtek RTL8180 802.11 MAC/BBP chip.
62  *
63  * Derived from the ADMtek ADM8211 PCI bus front-end.
64  *
65  * Derived from the ``Tulip'' PCI bus front-end.
66  */
67 
68 #include <sys/cdefs.h>
69 __KERNEL_RCSID(0, "$NetBSD: if_rtw_pci.c,v 1.21 2012/09/23 01:12:51 chs Exp $");
70 
71 #include <sys/param.h>
72 #include <sys/systm.h>
73 #include <sys/mbuf.h>
74 #include <sys/malloc.h>
75 #include <sys/kernel.h>
76 #include <sys/socket.h>
77 #include <sys/ioctl.h>
78 #include <sys/errno.h>
79 #include <sys/device.h>
80 
81 #include <machine/endian.h>
82 
83 #include <net/if.h>
84 #include <net/if_dl.h>
85 #include <net/if_media.h>
86 #include <net/if_ether.h>
87 
88 #include <net80211/ieee80211_netbsd.h>
89 #include <net80211/ieee80211_radiotap.h>
90 #include <net80211/ieee80211_var.h>
91 
92 #include <sys/bus.h>
93 #include <sys/intr.h>
94 
95 #include <dev/ic/rtwreg.h>
96 #include <dev/ic/rtwvar.h>
97 
98 #include <dev/pci/pcivar.h>
99 #include <dev/pci/pcireg.h>
100 #include <dev/pci/pcidevs.h>
101 
102 /*
103  * PCI configuration space registers used by the RTL8180.
104  */
105 #define RTW_PCI_IOBA PCI_BAR(0)	/* i/o mapped base */
106 #define RTW_PCI_MMBA PCI_BAR(1)	/* memory mapped base */
107 
108 struct rtw_pci_softc {
109 	struct rtw_softc	psc_rtw;
110 
111 	pcireg_t		psc_csr;
112 	void			*psc_ih;
113 	pci_chipset_tag_t	psc_pc;
114 	pci_intr_handle_t	psc_pih;
115 	pcitag_t		psc_tag;
116 };
117 
118 static void	rtw_pci_attach(device_t, device_t, void *);
119 static int	rtw_pci_detach(device_t, int);
120 #if 0
121 static void	rtw_pci_funcregen(struct rtw_regs *, int);
122 #endif
123 static const struct rtw_pci_product *
124 		rtw_pci_lookup(const struct pci_attach_args *);
125 static int	rtw_pci_match(device_t, cfdata_t, void *);
126 static bool	rtw_pci_resume(device_t, const pmf_qual_t *);
127 static int	rtw_pci_setup(struct rtw_pci_softc *);
128 static bool	rtw_pci_suspend(device_t, const pmf_qual_t *);
129 
130 CFATTACH_DECL3_NEW(rtw_pci, sizeof(struct rtw_pci_softc),
131     rtw_pci_match, rtw_pci_attach, rtw_pci_detach, NULL, NULL, NULL,
132     DVF_DETACH_SHUTDOWN);
133 
134 static const struct rtw_pci_product {
135 	u_int32_t	rpp_vendor;	/* PCI vendor ID */
136 	u_int32_t	rpp_product;	/* PCI product ID */
137 	const char	*rpp_product_name;
138 } rtw_pci_products[] = {
139 	{ PCI_VENDOR_REALTEK,		PCI_PRODUCT_REALTEK_RT8180,
140 	  "Realtek RTL8180 802.11 MAC/BBP" },
141 #ifdef RTW_DEBUG
142 	{ PCI_VENDOR_REALTEK,		PCI_PRODUCT_REALTEK_RT8185,
143 	  "Realtek RTL8185 802.11 MAC/BBP" },
144 	{ PCI_VENDOR_BELKIN2,		PCI_PRODUCT_BELKIN2_F5D7010,
145 	  "Belkin F5D7010" },
146 #endif
147 	{ PCI_VENDOR_BELKIN,		PCI_PRODUCT_BELKIN_F5D6001,
148 	  "Belkin F5D6001" },
149 	{ PCI_VENDOR_BELKIN,		PCI_PRODUCT_BELKIN_F5D6020V3,
150 	  "Belkin F5D6020v3" },
151 	{PCI_VENDOR_DLINK,		PCI_PRODUCT_DLINK_DWL610,
152 	  "DWL-610 D-Link Air 802.11b (RTL8180 MAC/BBP)"},
153 	{ 0,				0,				NULL },
154 };
155 
156 static const struct rtw_pci_product *
157 rtw_pci_lookup(const struct pci_attach_args *pa)
158 {
159 	const struct rtw_pci_product *rpp;
160 
161 	for (rpp = rtw_pci_products; rpp->rpp_product_name != NULL; rpp++) {
162 		if (PCI_VENDOR(pa->pa_id) == rpp->rpp_vendor &&
163 		    PCI_PRODUCT(pa->pa_id) == rpp->rpp_product)
164 			return rpp;
165 	}
166 	return NULL;
167 }
168 
169 static int
170 rtw_pci_match(device_t parent, cfdata_t match, void *aux)
171 {
172 	struct pci_attach_args *pa = aux;
173 
174 	if (rtw_pci_lookup(pa) != NULL)
175 		return 1;
176 
177 	return 0;
178 }
179 
180 static void
181 rtw_pci_attach(device_t parent, device_t self, void *aux)
182 {
183 	struct rtw_pci_softc *psc = device_private(self);
184 	struct rtw_softc *sc = &psc->psc_rtw;
185 	struct rtw_regs *regs = &sc->sc_regs;
186 	struct pci_attach_args *pa = aux;
187 	const char *intrstr = NULL;
188 	const struct rtw_pci_product *rpp;
189 
190 	sc->sc_dev = self;
191 	sc->sc_dmat = pa->pa_dmat;
192 	psc->psc_pc = pa->pa_pc;
193 	psc->psc_tag = pa->pa_tag;
194 
195 	rpp = rtw_pci_lookup(pa);
196 	if (rpp == NULL) {
197 		printf("\n");
198 		panic("rtw_pci_attach: impossible");
199 	}
200 
201 	/*
202 	 * Get revision info, and set some chip-specific variables.
203 	 */
204 	sc->sc_rev = PCI_REVISION(pa->pa_class);
205 	aprint_normal(": %s, revision %d.%d signature %08x\n",
206 	    rpp->rpp_product_name,
207 	    (sc->sc_rev >> 4) & 0xf, sc->sc_rev & 0xf,
208 	    pci_conf_read(psc->psc_pc, psc->psc_tag, 0x80));
209 
210 	/*
211 	 * Map the device.
212 	 */
213 	psc->psc_csr = PCI_COMMAND_MASTER_ENABLE |
214 	              PCI_COMMAND_PARITY_ENABLE |
215 		      PCI_COMMAND_SERR_ENABLE;
216 	if (pci_mapreg_map(pa, RTW_PCI_MMBA, PCI_MAPREG_TYPE_MEM, 0,
217 	    &regs->r_bt, &regs->r_bh, NULL, &regs->r_sz) == 0) {
218 		RTW_DPRINTF(RTW_DEBUG_ATTACH,
219 		    ("%s: %s mapped %" PRIuMAX " bytes mem space\n",
220 		     device_xname(self), __func__, (uintmax_t)regs->r_sz));
221 		psc->psc_csr |= PCI_COMMAND_MEM_ENABLE;
222 	} else if (pci_mapreg_map(pa, RTW_PCI_IOBA, PCI_MAPREG_TYPE_IO, 0,
223 	    &regs->r_bt, &regs->r_bh, NULL, &regs->r_sz) == 0) {
224 		RTW_DPRINTF(RTW_DEBUG_ATTACH,
225 		    ("%s: %s mapped %" PRIuMAX " bytes I/O space\n",
226 		     device_xname(self), __func__, (uintmax_t)regs->r_sz));
227 		psc->psc_csr |= PCI_COMMAND_IO_ENABLE;
228 	} else {
229 		aprint_error_dev(self, "unable to map device registers\n");
230 		return;
231 	}
232 
233 	/*
234 	 * Bring the chip out of powersave mode and initialize the
235 	 * configuration registers.
236 	 */
237 	if (rtw_pci_setup(psc) != 0)
238 		return;
239 
240 	/*
241 	 * Map and establish our interrupt.
242 	 */
243 	if (pci_intr_map(pa, &psc->psc_pih)) {
244 		aprint_error_dev(self, "unable to map interrupt\n");
245 		return;
246 	}
247 	intrstr = pci_intr_string(psc->psc_pc, psc->psc_pih);
248 	psc->psc_ih = pci_intr_establish(psc->psc_pc, psc->psc_pih, IPL_NET,
249 	    rtw_intr, sc);
250 	if (psc->psc_ih == NULL) {
251 		aprint_error_dev(self, "unable to establish interrupt");
252 		if (intrstr != NULL)
253 			aprint_error(" at %s", intrstr);
254 		aprint_error("\n");
255 		return;
256 	}
257 
258 	aprint_normal_dev(self, "interrupting at %s\n", intrstr);
259 
260 	/*
261 	 * Finish off the attach.
262 	 */
263 	rtw_attach(sc);
264 
265 	if (pmf_device_register(self, rtw_pci_suspend, rtw_pci_resume)) {
266 		pmf_class_network_register(self, &sc->sc_if);
267 		/*
268 		 * Power down the socket.
269 		 */
270 		pmf_device_suspend(self, &sc->sc_qual);
271 	} else
272 		aprint_error_dev(self, "couldn't establish power handler\n");
273 }
274 
275 static int
276 rtw_pci_detach(device_t self, int flags)
277 {
278 	struct rtw_pci_softc *psc = device_private(self);
279 	struct rtw_softc *sc = &psc->psc_rtw;
280 	struct rtw_regs *regs = &sc->sc_regs;
281 	int rc;
282 
283 	if ((rc = rtw_detach(sc)) != 0)
284 		return rc;
285 	if (psc->psc_ih != NULL)
286 		pci_intr_disestablish(psc->psc_pc, psc->psc_ih);
287 	bus_space_unmap(regs->r_bt, regs->r_bh, regs->r_sz);
288 
289 	return 0;
290 }
291 
292 static bool
293 rtw_pci_resume(device_t self, const pmf_qual_t *qual)
294 {
295 	struct rtw_pci_softc *psc = device_private(self);
296 	struct rtw_softc *sc = &psc->psc_rtw;
297 
298 	/* Establish the interrupt. */
299 	psc->psc_ih = pci_intr_establish(psc->psc_pc, psc->psc_pih, IPL_NET,
300 	    rtw_intr, sc);
301 	if (psc->psc_ih == NULL) {
302 		aprint_error_dev(sc->sc_dev, "unable to establish interrupt\n");
303 		return false;
304 	}
305 
306 	return rtw_resume(self, qual);
307 }
308 
309 static bool
310 rtw_pci_suspend(device_t self, const pmf_qual_t *qual)
311 {
312 	struct rtw_pci_softc *psc = device_private(self);
313 
314 	if (!rtw_suspend(self, qual))
315 		return false;
316 
317 	/* Unhook the interrupt handler. */
318 	pci_intr_disestablish(psc->psc_pc, psc->psc_ih);
319 	psc->psc_ih = NULL;
320 	return true;
321 }
322 
323 static int
324 rtw_pci_setup(struct rtw_pci_softc *psc)
325 {
326 	pcitag_t tag = psc->psc_tag;
327 	pcireg_t bhlc, csr, lattimer;
328 	device_t self = psc->psc_rtw.sc_dev;
329 	int rc;
330 
331 	/* power up chip */
332 	rc = pci_activate(psc->psc_pc, psc->psc_tag, self, NULL);
333 
334 	if (rc != 0 && rc != EOPNOTSUPP) {
335 		aprint_error_dev(self, "cannot activate (%d)\n", rc);
336 		return rc;
337 	}
338 
339 	/* I believe the datasheet tries to warn us that the RTL8180
340 	 * wants for 16 (0x10) to divide the latency timer.
341 	 */
342 	bhlc = pci_conf_read(psc->psc_pc, tag, PCI_BHLC_REG);
343 	lattimer = rounddown(PCI_LATTIMER(bhlc), 0x10);
344 	if (PCI_LATTIMER(bhlc) != lattimer) {
345 		bhlc &= ~(PCI_LATTIMER_MASK << PCI_LATTIMER_SHIFT);
346 		bhlc |= (lattimer << PCI_LATTIMER_SHIFT);
347 		pci_conf_write(psc->psc_pc, tag, PCI_BHLC_REG, bhlc);
348 	}
349 
350 	/* Enable the appropriate bits in the PCI CSR. */
351 	csr = pci_conf_read(psc->psc_pc, tag, PCI_COMMAND_STATUS_REG);
352 	csr &= ~(PCI_COMMAND_IO_ENABLE|PCI_COMMAND_MEM_ENABLE);
353 	csr |= psc->psc_csr;
354 	pci_conf_write(psc->psc_pc, tag, PCI_COMMAND_STATUS_REG, csr);
355 
356 	return 0;
357 }
358