2 * Copyright (c) 2002, Alexander Kabaev <kan.FreeBSD.org>.
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
14 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28 * Copyright (c) 2001 The NetBSD Foundation, Inc.
29 * All rights reserved.
31 * This code is derived from software contributed to The NetBSD Foundation
32 * by Ichiro FUKUHARA (ichiro@ichiro.org).
34 * Redistribution and use in source and binary forms, with or without
35 * modification, are permitted provided that the following conditions
37 * 1. Redistributions of source code must retain the above copyright
38 * notice, this list of conditions and the following disclaimer.
39 * 2. Redistributions in binary form must reproduce the above copyright
40 * notice, this list of conditions and the following disclaimer in the
41 * documentation and/or other materials provided with the distribution.
42 * 3. All advertising materials mentioning features or use of this software
43 * must display the following acknowledgement:
44 * This product includes software developed by the NetBSD
45 * Foundation, Inc. and its contributors.
46 * 4. Neither the name of The NetBSD Foundation nor the names of its
47 * contributors may be used to endorse or promote products derived
48 * from this software without specific prior written permission.
50 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
51 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
52 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
53 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
54 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
55 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
56 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
57 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
58 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
59 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
60 * POSSIBILITY OF SUCH DAMAGE.
62 * $FreeBSD: src/sys/dev/usb/ubsa.c,v 1.11 2003/11/16 12:13:39 akiyama Exp $
63 * $DragonFly: src/sys/dev/usbmisc/ubsa/ubsa.c,v 1.19 2007/11/06 07:37:01 hasso Exp $
66 #include <sys/param.h>
67 #include <sys/systm.h>
68 #include <sys/kernel.h>
69 #include <sys/malloc.h>
71 #include <sys/fcntl.h>
72 #include <sys/interrupt.h>
76 #include <sys/select.h>
79 #include <sys/sysctl.h>
81 #include <bus/usb/usb.h>
82 #include <bus/usb/usbcdc.h>
84 #include <bus/usb/usbdi.h>
85 #include <bus/usb/usbdi_util.h>
86 #include <bus/usb/usb_quirks.h>
88 #include "../ucom/ucomvar.h"
91 static int ubsadebug = 0;
92 SYSCTL_NODE(_hw_usb, OID_AUTO, ubsa, CTLFLAG_RW, 0, "USB ubsa");
93 SYSCTL_INT(_hw_usb_ubsa, OID_AUTO, debug, CTLFLAG_RW,
94 &ubsadebug, 0, "ubsa debug level");
96 #define DPRINTFN(n, x) do { \
97 if (ubsadebug > (n)) \
101 #define DPRINTFN(n, x)
103 #define DPRINTF(x) DPRINTFN(0, x)
105 #define UBSA_MODVER 1 /* module version */
107 #define UBSA_CONFIG_INDEX 1
108 #define UBSA_IFACE_INDEX 0
110 #define UBSA_INTR_INTERVAL 100 /* ms */
112 #define UBSA_SET_BAUDRATE 0x00
113 #define UBSA_SET_STOP_BITS 0x01
114 #define UBSA_SET_DATA_BITS 0x02
115 #define UBSA_SET_PARITY 0x03
116 #define UBSA_SET_DTR 0x0A
117 #define UBSA_SET_RTS 0x0B
118 #define UBSA_SET_BREAK 0x0C
119 #define UBSA_SET_FLOW_CTRL 0x10
121 #define UBSA_PARITY_NONE 0x00
122 #define UBSA_PARITY_EVEN 0x01
123 #define UBSA_PARITY_ODD 0x02
124 #define UBSA_PARITY_MARK 0x03
125 #define UBSA_PARITY_SPACE 0x04
127 #define UBSA_FLOW_NONE 0x0000
128 #define UBSA_FLOW_OCTS 0x0001
129 #define UBSA_FLOW_ODSR 0x0002
130 #define UBSA_FLOW_IDSR 0x0004
131 #define UBSA_FLOW_IDTR 0x0008
132 #define UBSA_FLOW_IRTS 0x0010
133 #define UBSA_FLOW_ORTS 0x0020
134 #define UBSA_FLOW_UNKNOWN 0x0040
135 #define UBSA_FLOW_OXON 0x0080
136 #define UBSA_FLOW_IXON 0x0100
138 /* line status register */
139 #define UBSA_LSR_TSRE 0x40 /* Transmitter empty: byte sent */
140 #define UBSA_LSR_TXRDY 0x20 /* Transmitter buffer empty */
141 #define UBSA_LSR_BI 0x10 /* Break detected */
142 #define UBSA_LSR_FE 0x08 /* Framing error: bad stop bit */
143 #define UBSA_LSR_PE 0x04 /* Parity error */
144 #define UBSA_LSR_OE 0x02 /* Overrun, lost incoming byte */
145 #define UBSA_LSR_RXRDY 0x01 /* Byte ready in Receive Buffer */
146 #define UBSA_LSR_RCV_MASK 0x1f /* Mask for incoming data or error */
148 /* modem status register */
149 /* All deltas are from the last read of the MSR. */
150 #define UBSA_MSR_DCD 0x80 /* Current Data Carrier Detect */
151 #define UBSA_MSR_RI 0x40 /* Current Ring Indicator */
152 #define UBSA_MSR_DSR 0x20 /* Current Data Set Ready */
153 #define UBSA_MSR_CTS 0x10 /* Current Clear to Send */
154 #define UBSA_MSR_DDCD 0x08 /* DCD has changed state */
155 #define UBSA_MSR_TERI 0x04 /* RI has toggled low to high */
156 #define UBSA_MSR_DDSR 0x02 /* DSR has changed state */
157 #define UBSA_MSR_DCTS 0x01 /* CTS has changed state */
160 struct ucom_softc sc_ucom;
162 int sc_iface_number; /* interface number */
164 usbd_interface_handle sc_intr_iface; /* interrupt interface */
165 int sc_intr_number; /* interrupt number */
166 usbd_pipe_handle sc_intr_pipe; /* interrupt pipe */
167 u_char *sc_intr_buf; /* interrupt buffer */
170 u_char sc_dtr; /* current DTR state */
171 u_char sc_rts; /* current RTS state */
173 u_char sc_lsr; /* Local status register */
174 u_char sc_msr; /* ubsa status register */
177 static void ubsa_intr(usbd_xfer_handle, usbd_private_handle, usbd_status);
178 static void ubsa_notify(void *);
180 static void ubsa_get_status(void *, int, u_char *, u_char *);
181 static void ubsa_set(void *, int, int, int);
182 static int ubsa_param(void *, int, struct termios *);
183 static int ubsa_open(void *, int);
184 static void ubsa_close(void *, int);
186 static int ubsa_request(struct ubsa_softc *, u_int8_t, u_int16_t);
187 static void ubsa_dtr(struct ubsa_softc *, int);
188 static void ubsa_rts(struct ubsa_softc *, int);
189 static void ubsa_baudrate(struct ubsa_softc *, speed_t);
190 static void ubsa_parity(struct ubsa_softc *, tcflag_t);
191 static void ubsa_databits(struct ubsa_softc *, tcflag_t);
192 static void ubsa_stopbits(struct ubsa_softc *, tcflag_t);
193 static void ubsa_flow(struct ubsa_softc *, tcflag_t, tcflag_t);
195 struct ucom_callback ubsa_callback = {
206 static const struct usb_devno ubsa_devs [] = {
207 { USB_DEVICE(0x050d, 0x0103) }, /* Belkin F5U103 serial adapter */
208 { USB_DEVICE(0x050d, 0x1203) }, /* Belkin F5U120-PC hub */
209 { USB_DEVICE(0x0565, 0x0001) }, /* Peracom serial converter */
210 { USB_DEVICE(0x056c, 0x8007) }, /* e-TEK Labs serial port */
211 { USB_DEVICE(0x0921, 0x1001) }, /* GoHubs GoCOM232 serial converter */
212 { USB_DEVICE(0x0921, 0x1200) }, /* HandyTech's Braille displays */
215 static device_probe_t ubsa_match;
216 static device_attach_t ubsa_attach;
217 static device_detach_t ubsa_detach;
219 static device_method_t ubsa_methods[] = {
220 /* Device interface */
221 DEVMETHOD(device_probe, ubsa_match),
222 DEVMETHOD(device_attach, ubsa_attach),
223 DEVMETHOD(device_detach, ubsa_detach),
227 static driver_t ubsa_driver = {
230 sizeof (struct ubsa_softc)
233 DRIVER_MODULE(ubsa, uhub, ubsa_driver, ucom_devclass, usbd_driver_load, 0);
234 MODULE_DEPEND(ubsa, usb, 1, 1, 1);
235 MODULE_DEPEND(ubsa, ucom, UCOM_MINVER, UCOM_PREFVER, UCOM_MAXVER);
236 MODULE_VERSION(ubsa, UBSA_MODVER);
239 ubsa_match(device_t self)
241 struct usb_attach_arg *uaa = device_get_ivars(self);
243 if (uaa->iface != NULL)
244 return (UMATCH_NONE);
246 return (usb_lookup(ubsa_devs, uaa->vendor, uaa->product) != NULL ?
247 UMATCH_VENDOR_PRODUCT : UMATCH_NONE);
251 ubsa_attach(device_t self)
253 struct ubsa_softc *sc = device_get_softc(self);
254 struct usb_attach_arg *uaa = device_get_ivars(self);
255 usbd_device_handle dev;
256 struct ucom_softc *ucom;
257 usb_config_descriptor_t *cdesc;
258 usb_interface_descriptor_t *id;
259 usb_endpoint_descriptor_t *ed;
265 bzero(sc, sizeof (struct ubsa_softc));
268 * initialize rts, dtr variables to something
269 * different from boolean 0, 1
276 ucom->sc_iface = uaa->iface;
278 DPRINTF(("ubsa attach: sc = %p\n", sc));
280 /* initialize endpoints */
281 ucom->sc_bulkin_no = ucom->sc_bulkout_no = -1;
282 sc->sc_intr_number = -1;
283 sc->sc_intr_pipe = NULL;
285 /* Move the device into the configured state. */
286 err = usbd_set_config_index(dev, UBSA_CONFIG_INDEX, 1);
288 device_printf(ucom->sc_dev, "failed to set configuration: %s\n",
294 /* get the config descriptor */
295 cdesc = usbd_get_config_descriptor(ucom->sc_udev);
298 device_printf(ucom->sc_dev, "failed to get configuration "
304 /* get the first interface */
305 err = usbd_device2interface_handle(dev, UBSA_IFACE_INDEX,
308 device_printf(ucom->sc_dev, "failed to get interface: %s\n",
314 /* Find the endpoints */
316 id = usbd_get_interface_descriptor(ucom->sc_iface);
317 sc->sc_iface_number = id->bInterfaceNumber;
319 for (i = 0; i < id->bNumEndpoints; i++) {
320 ed = usbd_interface2endpoint_descriptor(ucom->sc_iface, i);
322 device_printf(ucom->sc_dev, "no endpoint descriptor "
328 if (UE_GET_DIR(ed->bEndpointAddress) == UE_DIR_IN &&
329 UE_GET_XFERTYPE(ed->bmAttributes) == UE_INTERRUPT) {
330 sc->sc_intr_number = ed->bEndpointAddress;
331 sc->sc_isize = UGETW(ed->wMaxPacketSize);
332 } else if (UE_GET_DIR(ed->bEndpointAddress) == UE_DIR_IN &&
333 UE_GET_XFERTYPE(ed->bmAttributes) == UE_BULK) {
334 ucom->sc_bulkin_no = ed->bEndpointAddress;
335 ucom->sc_ibufsize = UGETW(ed->wMaxPacketSize);
336 } else if (UE_GET_DIR(ed->bEndpointAddress) == UE_DIR_OUT &&
337 UE_GET_XFERTYPE(ed->bmAttributes) == UE_BULK) {
338 ucom->sc_bulkout_no = ed->bEndpointAddress;
339 ucom->sc_obufsize = UGETW(ed->wMaxPacketSize);
343 if (sc->sc_intr_number == -1) {
344 device_printf(ucom->sc_dev, "could not find interrupt in\n");
349 /* keep interface for interrupt */
350 sc->sc_intr_iface = ucom->sc_iface;
352 if (ucom->sc_bulkin_no == -1) {
353 device_printf(ucom->sc_dev, "could not find data bulk in\n");
358 if (ucom->sc_bulkout_no == -1) {
359 device_printf(ucom->sc_dev, "could not find data bulk out\n");
364 ucom->sc_parent = sc;
365 ucom->sc_portno = UCOM_UNK_PORTNO;
366 /* bulkin, bulkout set above */
367 ucom->sc_ibufsizepad = ucom->sc_ibufsize;
368 ucom->sc_opkthdrlen = 0;
369 ucom->sc_callback = &ubsa_callback;
371 DPRINTF(("ubsa: in = 0x%x, out = 0x%x, intr = 0x%x\n",
372 ucom->sc_bulkin_no, ucom->sc_bulkout_no, sc->sc_intr_number));
383 ubsa_detach(device_t self)
385 struct ubsa_softc *sc = device_get_softc(self);
389 DPRINTF(("ubsa_detach: sc = %p\n", sc));
391 if (sc->sc_intr_pipe != NULL) {
392 usbd_abort_pipe(sc->sc_intr_pipe);
393 usbd_close_pipe(sc->sc_intr_pipe);
394 kfree(sc->sc_intr_buf, M_USBDEV);
395 sc->sc_intr_pipe = NULL;
398 sc->sc_ucom.sc_dying = 1;
400 rv = ucom_detach(&sc->sc_ucom);
406 ubsa_request(struct ubsa_softc *sc, u_int8_t request, u_int16_t value)
408 usb_device_request_t req;
411 req.bmRequestType = UT_WRITE_VENDOR_DEVICE;
412 req.bRequest = request;
413 USETW(req.wValue, value);
414 USETW(req.wIndex, sc->sc_iface_number);
415 USETW(req.wLength, 0);
417 err = usbd_do_request(sc->sc_ucom.sc_udev, &req, 0);
419 device_printf(sc->sc_ucom.sc_dev, "ubsa_request: %s\n",
425 ubsa_dtr(struct ubsa_softc *sc, int onoff)
428 DPRINTF(("ubsa_dtr: onoff = %d\n", onoff));
430 if (sc->sc_dtr == onoff)
434 ubsa_request(sc, UBSA_SET_DTR, onoff ? 1 : 0);
438 ubsa_rts(struct ubsa_softc *sc, int onoff)
441 DPRINTF(("ubsa_rts: onoff = %d\n", onoff));
443 if (sc->sc_rts == onoff)
447 ubsa_request(sc, UBSA_SET_RTS, onoff ? 1 : 0);
451 ubsa_break(struct ubsa_softc *sc, int onoff)
454 DPRINTF(("ubsa_rts: onoff = %d\n", onoff));
456 ubsa_request(sc, UBSA_SET_BREAK, onoff ? 1 : 0);
460 ubsa_set(void *addr, int portno, int reg, int onoff)
462 struct ubsa_softc *sc;
473 ubsa_break(sc, onoff);
481 ubsa_baudrate(struct ubsa_softc *sc, speed_t speed)
485 DPRINTF(("ubsa_baudrate: speed = %d\n", speed));
501 value = B230400 / speed;
504 device_printf(sc->sc_ucom.sc_dev, "ubsa_param: unsupported "
505 "baudrate, forcing default of 9600\n");
506 value = B230400 / B9600;
515 ubsa_request(sc, UBSA_SET_BAUDRATE, value);
519 ubsa_parity(struct ubsa_softc *sc, tcflag_t cflag)
523 DPRINTF(("ubsa_parity: cflag = 0x%x\n", cflag));
526 value = (cflag & PARODD) ? UBSA_PARITY_ODD : UBSA_PARITY_EVEN;
528 value = UBSA_PARITY_NONE;
530 ubsa_request(sc, UBSA_SET_PARITY, value);
534 ubsa_databits(struct ubsa_softc *sc, tcflag_t cflag)
538 DPRINTF(("ubsa_databits: cflag = 0x%x\n", cflag));
540 switch (cflag & CSIZE) {
541 case CS5: value = 0; break;
542 case CS6: value = 1; break;
543 case CS7: value = 2; break;
544 case CS8: value = 3; break;
546 device_printf(sc->sc_ucom.sc_dev, "ubsa_param: unsupported "
547 "databits requested, forcing default of 8\n");
551 ubsa_request(sc, UBSA_SET_DATA_BITS, value);
555 ubsa_stopbits(struct ubsa_softc *sc, tcflag_t cflag)
559 DPRINTF(("ubsa_stopbits: cflag = 0x%x\n", cflag));
561 value = (cflag & CSTOPB) ? 1 : 0;
563 ubsa_request(sc, UBSA_SET_STOP_BITS, value);
567 ubsa_flow(struct ubsa_softc *sc, tcflag_t cflag, tcflag_t iflag)
571 DPRINTF(("ubsa_flow: cflag = 0x%x, iflag = 0x%x\n", cflag, iflag));
575 value |= UBSA_FLOW_OCTS | UBSA_FLOW_IRTS;
576 if (iflag & (IXON|IXOFF))
577 value |= UBSA_FLOW_OXON | UBSA_FLOW_IXON;
579 ubsa_request(sc, UBSA_SET_FLOW_CTRL, value);
583 ubsa_param(void *addr, int portno, struct termios *ti)
585 struct ubsa_softc *sc;
589 DPRINTF(("ubsa_param: sc = %p\n", sc));
591 ubsa_baudrate(sc, ti->c_ospeed);
592 ubsa_parity(sc, ti->c_cflag);
593 ubsa_databits(sc, ti->c_cflag);
594 ubsa_stopbits(sc, ti->c_cflag);
595 ubsa_flow(sc, ti->c_cflag, ti->c_iflag);
601 ubsa_open(void *addr, int portno)
603 struct ubsa_softc *sc;
607 if (sc->sc_ucom.sc_dying)
610 DPRINTF(("ubsa_open: sc = %p\n", sc));
612 if (sc->sc_intr_number != -1 && sc->sc_intr_pipe == NULL) {
613 sc->sc_intr_buf = kmalloc(sc->sc_isize, M_USBDEV, M_WAITOK);
614 err = usbd_open_pipe_intr(sc->sc_intr_iface,
624 device_printf(sc->sc_ucom.sc_dev, "cannot open "
625 "interrupt pipe (addr %d)\n",
635 ubsa_close(void *addr, int portno)
637 struct ubsa_softc *sc;
641 if (sc->sc_ucom.sc_dying)
644 DPRINTF(("ubsa_close: close\n"));
646 if (sc->sc_intr_pipe != NULL) {
647 err = usbd_abort_pipe(sc->sc_intr_pipe);
649 device_printf(sc->sc_ucom.sc_dev, "abort interrupt "
650 "pipe failed: %s\n", usbd_errstr(err));
651 err = usbd_close_pipe(sc->sc_intr_pipe);
653 device_printf(sc->sc_ucom.sc_dev, "close interrupt "
654 "pipe failed: %s\n", usbd_errstr(err));
655 kfree(sc->sc_intr_buf, M_USBDEV);
656 sc->sc_intr_pipe = NULL;
661 ubsa_intr(usbd_xfer_handle xfer, usbd_private_handle priv, usbd_status status)
663 struct ubsa_softc *sc;
667 buf = sc->sc_intr_buf;
668 if (sc->sc_ucom.sc_dying)
671 if (status != USBD_NORMAL_COMPLETION) {
672 if (status == USBD_NOT_STARTED || status == USBD_CANCELLED)
675 DPRINTF(("%s: ubsa_intr: abnormal status: %s\n",
676 device_get_nameunit(sc->sc_ucom.sc_dev),
677 usbd_errstr(status)));
678 usbd_clear_endpoint_stall_async(sc->sc_intr_pipe);
682 /* incidentally, Belkin adapter status bits match UART 16550 bits */
686 DPRINTF(("%s: ubsa lsr = 0x%02x, msr = 0x%02x\n",
687 device_get_nameunit(sc->sc_ucom.sc_dev), sc->sc_lsr, sc->sc_msr));
692 /* Handle delayed events. */
694 ubsa_notify(void *arg)
696 struct ubsa_softc *sc;
699 ucom_status_change(&sc->sc_ucom);
703 ubsa_get_status(void *addr, int portno, u_char *lsr, u_char *msr)
705 struct ubsa_softc *sc;
707 DPRINTF(("ubsa_get_status\n"));