Home | History | Annotate | Line # | Download | only in usb
uvisor.c revision 1.38.2.1
      1 /*	$NetBSD: uvisor.c,v 1.38.2.1 2008/05/18 12:34:52 yamt Exp $	*/
      2 
      3 /*
      4  * Copyright (c) 2000 The NetBSD Foundation, Inc.
      5  * All rights reserved.
      6  *
      7  * This code is derived from software contributed to The NetBSD Foundation
      8  * by Lennart Augustsson (lennart (at) augustsson.net) at
      9  * Carlstedt Research & Technology.
     10  *
     11  * Redistribution and use in source and binary forms, with or without
     12  * modification, are permitted provided that the following conditions
     13  * are met:
     14  * 1. Redistributions of source code must retain the above copyright
     15  *    notice, this list of conditions and the following disclaimer.
     16  * 2. Redistributions in binary form must reproduce the above copyright
     17  *    notice, this list of conditions and the following disclaimer in the
     18  *    documentation and/or other materials provided with the distribution.
     19  *
     20  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
     21  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
     22  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
     23  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
     24  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
     25  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
     26  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
     27  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
     28  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
     29  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     30  * POSSIBILITY OF SUCH DAMAGE.
     31  */
     32 
     33 /*
     34  * Handspring Visor (Palmpilot compatible PDA) driver
     35  */
     36 
     37 #include <sys/cdefs.h>
     38 __KERNEL_RCSID(0, "$NetBSD: uvisor.c,v 1.38.2.1 2008/05/18 12:34:52 yamt Exp $");
     39 
     40 #include <sys/param.h>
     41 #include <sys/systm.h>
     42 #include <sys/kernel.h>
     43 #include <sys/device.h>
     44 #include <sys/conf.h>
     45 #include <sys/tty.h>
     46 
     47 #include <dev/usb/usb.h>
     48 
     49 #include <dev/usb/usbdi.h>
     50 #include <dev/usb/usbdi_util.h>
     51 #include <dev/usb/usbdevs.h>
     52 
     53 #include <dev/usb/ucomvar.h>
     54 
     55 #ifdef UVISOR_DEBUG
     56 #define DPRINTF(x)	if (uvisordebug) printf x
     57 #define DPRINTFN(n,x)	if (uvisordebug>(n)) printf x
     58 int uvisordebug = 0;
     59 #else
     60 #define DPRINTF(x)
     61 #define DPRINTFN(n,x)
     62 #endif
     63 
     64 #define UVISOR_CONFIG_INDEX	0
     65 #define UVISOR_IFACE_INDEX	0
     66 
     67 /* From the Linux driver */
     68 /*
     69  * UVISOR_REQUEST_BYTES_AVAILABLE asks the visor for the number of bytes that
     70  * are available to be transfered to the host for the specified endpoint.
     71  * Currently this is not used, and always returns 0x0001
     72  */
     73 #define UVISOR_REQUEST_BYTES_AVAILABLE		0x01
     74 
     75 /*
     76  * UVISOR_CLOSE_NOTIFICATION is set to the device to notify it that the host
     77  * is now closing the pipe. An empty packet is sent in response.
     78  */
     79 #define UVISOR_CLOSE_NOTIFICATION		0x02
     80 
     81 /*
     82  * UVISOR_GET_CONNECTION_INFORMATION is sent by the host during enumeration to
     83  * get the endpoints used by the connection.
     84  */
     85 #define UVISOR_GET_CONNECTION_INFORMATION	0x03
     86 
     87 
     88 /*
     89  * UVISOR_GET_CONNECTION_INFORMATION returns data in the following format
     90  */
     91 #define UVISOR_MAX_CONN 8
     92 struct uvisor_connection_info {
     93 	uWord	num_ports;
     94 	struct {
     95 		uByte	port_function_id;
     96 		uByte	port;
     97 	} connections[UVISOR_MAX_CONN];
     98 };
     99 #define UVISOR_CONNECTION_INFO_SIZE 18
    100 
    101 /* struct uvisor_connection_info.connection[x].port_function_id defines: */
    102 #define UVISOR_FUNCTION_GENERIC		0x00
    103 #define UVISOR_FUNCTION_DEBUGGER	0x01
    104 #define UVISOR_FUNCTION_HOTSYNC		0x02
    105 #define UVISOR_FUNCTION_CONSOLE		0x03
    106 #define UVISOR_FUNCTION_REMOTE_FILE_SYS	0x04
    107 
    108 /*
    109  * Unknown PalmOS stuff.
    110  */
    111 #define UVISOR_GET_PALM_INFORMATION		0x04
    112 #define UVISOR_GET_PALM_INFORMATION_LEN		0x44
    113 
    114 struct uvisor_palm_connection_info {
    115 	uByte	num_ports;
    116 	uByte	endpoint_numbers_different;
    117 	uWord	reserved1;
    118 	struct {
    119 		uDWord	port_function_id;
    120 		uByte	port;
    121 		uByte	end_point_info;
    122 		uWord	reserved;
    123 	} connections[UVISOR_MAX_CONN];
    124 };
    125 
    126 
    127 
    128 #define UVISORIBUFSIZE 64
    129 #define UVISOROBUFSIZE 1024
    130 
    131 struct uvisor_softc {
    132 	USBBASEDEVICE		sc_dev;		/* base device */
    133 	usbd_device_handle	sc_udev;	/* device */
    134 	usbd_interface_handle	sc_iface;	/* interface */
    135 
    136 	device_ptr_t		sc_subdevs[UVISOR_MAX_CONN];
    137 	int			sc_numcon;
    138 
    139 	u_int16_t		sc_flags;
    140 
    141 	u_char			sc_dying;
    142 };
    143 
    144 Static usbd_status uvisor_init(struct uvisor_softc *,
    145 			       struct uvisor_connection_info *,
    146 			       struct uvisor_palm_connection_info *);
    147 
    148 Static void uvisor_close(void *, int);
    149 
    150 
    151 struct ucom_methods uvisor_methods = {
    152 	NULL,
    153 	NULL,
    154 	NULL,
    155 	NULL,
    156 	NULL,
    157 	uvisor_close,
    158 	NULL,
    159 	NULL,
    160 };
    161 
    162 struct uvisor_type {
    163 	struct usb_devno	uv_dev;
    164 	u_int16_t		uv_flags;
    165 #define PALM4	0x0001
    166 #define VISOR	0x0002
    167 
    168 };
    169 static const struct uvisor_type uvisor_devs[] = {
    170 	{{ USB_VENDOR_HANDSPRING, USB_PRODUCT_HANDSPRING_VISOR }, VISOR },
    171 	{{ USB_VENDOR_HANDSPRING, USB_PRODUCT_HANDSPRING_TREO }, PALM4 },
    172 	{{ USB_VENDOR_HANDSPRING, USB_PRODUCT_HANDSPRING_TREO600 }, PALM4 },
    173 	{{ USB_VENDOR_PALM, USB_PRODUCT_PALM_M500 }, PALM4 },
    174 	{{ USB_VENDOR_PALM, USB_PRODUCT_PALM_M505 }, PALM4 },
    175 	{{ USB_VENDOR_PALM, USB_PRODUCT_PALM_M515 }, PALM4 },
    176 	{{ USB_VENDOR_PALM, USB_PRODUCT_PALM_I705 }, PALM4 },
    177 	{{ USB_VENDOR_PALM, USB_PRODUCT_PALM_M125 }, PALM4 },
    178 	{{ USB_VENDOR_PALM, USB_PRODUCT_PALM_M130 }, PALM4 },
    179 	{{ USB_VENDOR_PALM, USB_PRODUCT_PALM_TUNGSTEN_Z }, PALM4 },
    180 	{{ USB_VENDOR_PALM, USB_PRODUCT_PALM_TUNGSTEN_T }, PALM4 },
    181 	{{ USB_VENDOR_PALM, USB_PRODUCT_PALM_ZIRE31 }, PALM4 },
    182 	{{ USB_VENDOR_PALM, USB_PRODUCT_PALM_ZIRE }, PALM4 },
    183 	{{ USB_VENDOR_SONY, USB_PRODUCT_SONY_CLIE_40 }, PALM4 },
    184 	{{ USB_VENDOR_SONY, USB_PRODUCT_SONY_CLIE_41 }, PALM4 },
    185 	{{ USB_VENDOR_SONY, USB_PRODUCT_SONY_CLIE_S360 }, PALM4 },
    186 	{{ USB_VENDOR_SONY, USB_PRODUCT_SONY_CLIE_NX60 }, PALM4 },
    187 	{{ USB_VENDOR_SONY, USB_PRODUCT_SONY_CLIE_35 }, 0 },
    188 /*	{{ USB_VENDOR_SONY, USB_PRODUCT_SONY_CLIE_25 }, PALM4 },*/
    189 };
    190 #define uvisor_lookup(v, p) ((const struct uvisor_type *)usb_lookup(uvisor_devs, v, p))
    191 
    192 int uvisor_match(device_t, struct cfdata *, void *);
    193 void uvisor_attach(device_t, device_t, void *);
    194 void uvisor_childdet(device_t, device_t);
    195 int uvisor_detach(device_t, int);
    196 int uvisor_activate(device_t, enum devact);
    197 extern struct cfdriver uvisor_cd;
    198 CFATTACH_DECL2(uvisor, sizeof(struct uvisor_softc), uvisor_match,
    199     uvisor_attach, uvisor_detach, uvisor_activate, NULL, uvisor_childdet);
    200 
    201 USB_MATCH(uvisor)
    202 {
    203 	USB_MATCH_START(uvisor, uaa);
    204 
    205 	DPRINTFN(20,("uvisor: vendor=0x%x, product=0x%x\n",
    206 		     uaa->vendor, uaa->product));
    207 
    208 	return (uvisor_lookup(uaa->vendor, uaa->product) != NULL ?
    209 		UMATCH_VENDOR_PRODUCT : UMATCH_NONE);
    210 }
    211 
    212 USB_ATTACH(uvisor)
    213 {
    214 	USB_ATTACH_START(uvisor, sc, uaa);
    215 	usbd_device_handle dev = uaa->device;
    216 	usbd_interface_handle iface;
    217 	usb_interface_descriptor_t *id;
    218 	struct uvisor_connection_info coninfo;
    219 	struct uvisor_palm_connection_info palmconinfo;
    220 	usb_endpoint_descriptor_t *ed;
    221 	char *devinfop;
    222 	const char *devname = USBDEVNAME(sc->sc_dev);
    223 	int i, j, hasin, hasout, port;
    224 	usbd_status err;
    225 	struct ucom_attach_args uca;
    226 
    227 	DPRINTFN(10,("\nuvisor_attach: sc=%p\n", sc));
    228 
    229 	/* Move the device into the configured state. */
    230 	err = usbd_set_config_index(dev, UVISOR_CONFIG_INDEX, 1);
    231 	if (err) {
    232 		printf("\n%s: failed to set configuration, err=%s\n",
    233 		       devname, usbd_errstr(err));
    234 		goto bad;
    235 	}
    236 
    237 	err = usbd_device2interface_handle(dev, UVISOR_IFACE_INDEX, &iface);
    238 	if (err) {
    239 		printf("\n%s: failed to get interface, err=%s\n",
    240 		       devname, usbd_errstr(err));
    241 		goto bad;
    242 	}
    243 
    244 	devinfop = usbd_devinfo_alloc(dev, 0);
    245 	USB_ATTACH_SETUP;
    246 	printf("%s: %s\n", devname, devinfop);
    247 	usbd_devinfo_free(devinfop);
    248 
    249 	sc->sc_flags = uvisor_lookup(uaa->vendor, uaa->product)->uv_flags;
    250 
    251 	if ((sc->sc_flags & (VISOR | PALM4)) == 0) {
    252 		printf("%s: init failed, device type is neither visor nor palm\n",
    253 		    USBDEVNAME(sc->sc_dev));
    254 		goto bad;
    255 	}
    256 
    257 	id = usbd_get_interface_descriptor(iface);
    258 
    259 	sc->sc_udev = dev;
    260 	sc->sc_iface = iface;
    261 
    262 	uca.ibufsize = UVISORIBUFSIZE;
    263 	uca.obufsize = UVISOROBUFSIZE;
    264 	uca.ibufsizepad = UVISORIBUFSIZE;
    265 	uca.opkthdrlen = 0;
    266 	uca.device = dev;
    267 	uca.iface = iface;
    268 	uca.methods = &uvisor_methods;
    269 	uca.arg = sc;
    270 
    271 	err = uvisor_init(sc, &coninfo, &palmconinfo);
    272 	if (err) {
    273 		printf("%s: init failed, %s\n", USBDEVNAME(sc->sc_dev),
    274 		       usbd_errstr(err));
    275 		goto bad;
    276 	}
    277 
    278 	usbd_add_drv_event(USB_EVENT_DRIVER_ATTACH, sc->sc_udev,
    279 			   USBDEV(sc->sc_dev));
    280 
    281 	if (sc->sc_flags & VISOR) {
    282 		sc->sc_numcon = UGETW(coninfo.num_ports);
    283 		if (sc->sc_numcon > UVISOR_MAX_CONN)
    284 			sc->sc_numcon = UVISOR_MAX_CONN;
    285 
    286 		/* Attach a ucom for each connection. */
    287 		for (i = 0; i < sc->sc_numcon; ++i) {
    288 			switch (coninfo.connections[i].port_function_id) {
    289 			case UVISOR_FUNCTION_GENERIC:
    290 				uca.info = "Generic";
    291 				break;
    292 			case UVISOR_FUNCTION_DEBUGGER:
    293 				uca.info = "Debugger";
    294 				break;
    295 			case UVISOR_FUNCTION_HOTSYNC:
    296 				uca.info = "HotSync";
    297 				break;
    298 			case UVISOR_FUNCTION_REMOTE_FILE_SYS:
    299 				uca.info = "Remote File System";
    300 				break;
    301 			default:
    302 				uca.info = "unknown";
    303 				break;
    304 			}
    305 			port = coninfo.connections[i].port;
    306 			uca.portno = port;
    307 			uca.bulkin = port | UE_DIR_IN;
    308 			uca.bulkout = port | UE_DIR_OUT;
    309 			/* Verify that endpoints exist. */
    310 			hasin = 0;
    311 			hasout = 0;
    312 			for (j = 0; j < id->bNumEndpoints; j++) {
    313 				ed = usbd_interface2endpoint_descriptor(iface, j);
    314 				if (ed == NULL)
    315 					break;
    316 				if (UE_GET_ADDR(ed->bEndpointAddress) == port &&
    317 				    (ed->bmAttributes & UE_XFERTYPE) == UE_BULK) {
    318 					if (UE_GET_DIR(ed->bEndpointAddress)
    319 					    == UE_DIR_IN)
    320 						hasin++;
    321 					else
    322 						hasout++;
    323 				}
    324 			}
    325 			if (hasin == 1 && hasout == 1)
    326 				sc->sc_subdevs[i] = config_found_sm_loc(self,
    327 					"ucombus", NULL, &uca,
    328 					ucomprint, ucomsubmatch);
    329 			else
    330 				printf("%s: no proper endpoints for port %d (%d,%d)\n",
    331 				    USBDEVNAME(sc->sc_dev), port, hasin, hasout);
    332 		}
    333 
    334 	} else {
    335 		sc->sc_numcon = palmconinfo.num_ports;
    336 		if (sc->sc_numcon > UVISOR_MAX_CONN)
    337 			sc->sc_numcon = UVISOR_MAX_CONN;
    338 
    339 		/* Attach a ucom for each connection. */
    340 		for (i = 0; i < sc->sc_numcon; ++i) {
    341 			/*
    342 			 * XXX this should copy out 4-char string from the
    343 			 * XXX port_function_id, but where would the string go?
    344 			 * XXX uca.info is a const char *, not an array.
    345 			 */
    346 			uca.info = "sync";
    347 			uca.portno = i;
    348 			if (palmconinfo.endpoint_numbers_different) {
    349 				port = palmconinfo.connections[i].end_point_info;
    350 				uca.bulkin = (port >> 4) | UE_DIR_IN;
    351 				uca.bulkout = (port & 0xf) | UE_DIR_OUT;
    352 			} else {
    353 				port = palmconinfo.connections[i].port;
    354 				uca.bulkin = port | UE_DIR_IN;
    355 				uca.bulkout = port | UE_DIR_OUT;
    356 			}
    357 			sc->sc_subdevs[i] = config_found_sm_loc(self, "ucombus",
    358 				NULL, &uca, ucomprint, ucomsubmatch);
    359 
    360 
    361 		}
    362 	}
    363 
    364 	USB_ATTACH_SUCCESS_RETURN;
    365 
    366 bad:
    367 	DPRINTF(("uvisor_attach: ATTACH ERROR\n"));
    368 	sc->sc_dying = 1;
    369 	USB_ATTACH_ERROR_RETURN;
    370 }
    371 
    372 int
    373 uvisor_activate(device_ptr_t self, enum devact act)
    374 {
    375 	struct uvisor_softc *sc = (struct uvisor_softc *)self;
    376 	int rv = 0;
    377 	int i;
    378 
    379 	switch (act) {
    380 	case DVACT_ACTIVATE:
    381 		return (EOPNOTSUPP);
    382 		break;
    383 
    384 	case DVACT_DEACTIVATE:
    385 		for (i = 0; i < sc->sc_numcon; i++)
    386 			if (sc->sc_subdevs[i] != NULL)
    387 				rv |= config_deactivate(sc->sc_subdevs[i]);
    388 		sc->sc_dying = 1;
    389 		break;
    390 	}
    391 	return (rv);
    392 }
    393 
    394 void
    395 uvisor_childdet(device_t self, device_t child)
    396 {
    397 	int i;
    398 	struct uvisor_softc *sc = device_private(self);
    399 
    400 	for (i = 0; i < sc->sc_numcon; i++) {
    401 		if (sc->sc_subdevs[i] == child)
    402 			break;
    403 	}
    404 	KASSERT(i < sc->sc_numcon);
    405 	sc->sc_subdevs[i] = NULL;
    406 }
    407 
    408 int
    409 uvisor_detach(device_t self, int flags)
    410 {
    411 	struct uvisor_softc *sc = device_private(self);
    412 	int rv = 0;
    413 	int i;
    414 
    415 	DPRINTF(("uvisor_detach: sc=%p flags=%d\n", sc, flags));
    416 	sc->sc_dying = 1;
    417 	for (i = 0; i < sc->sc_numcon; i++) {
    418 		if (sc->sc_subdevs[i] != NULL)
    419 			rv |= config_detach(sc->sc_subdevs[i], flags);
    420 	}
    421 
    422 	if (sc->sc_udev)
    423 		usbd_add_drv_event(USB_EVENT_DRIVER_DETACH, sc->sc_udev,
    424 				   USBDEV(sc->sc_dev));
    425 
    426 
    427 	return (rv);
    428 }
    429 
    430 usbd_status
    431 uvisor_init(struct uvisor_softc *sc, struct uvisor_connection_info *ci,
    432     struct uvisor_palm_connection_info *cpi)
    433 {
    434 	usbd_status err;
    435 	usb_device_request_t req;
    436 	int actlen;
    437 	uWord avail;
    438 
    439 	if (sc->sc_flags & VISOR) {
    440 		DPRINTF(("uvisor_init: getting Visor connection info\n"));
    441 		req.bmRequestType = UT_READ_VENDOR_ENDPOINT;
    442 		req.bRequest = UVISOR_GET_CONNECTION_INFORMATION;
    443 		USETW(req.wValue, 0);
    444 		USETW(req.wIndex, 0);
    445 		USETW(req.wLength, UVISOR_CONNECTION_INFO_SIZE);
    446 		err = usbd_do_request_flags(sc->sc_udev, &req, ci,
    447 		    USBD_SHORT_XFER_OK, &actlen, USBD_DEFAULT_TIMEOUT);
    448 		if (err)
    449 			return (err);
    450 	}
    451 
    452 	if (sc->sc_flags & PALM4) {
    453 		DPRINTF(("uvisor_init: getting Palm connection info\n"));
    454 		req.bmRequestType = UT_READ_VENDOR_ENDPOINT;
    455 		req.bRequest = UVISOR_GET_PALM_INFORMATION;
    456 		USETW(req.wValue, 0);
    457 		USETW(req.wIndex, 0);
    458 		USETW(req.wLength, UVISOR_GET_PALM_INFORMATION_LEN);
    459 		err = usbd_do_request_flags(sc->sc_udev, &req, cpi,
    460 		    USBD_SHORT_XFER_OK, &actlen, USBD_DEFAULT_TIMEOUT);
    461 		if (err)
    462 			return (err);
    463 	}
    464 
    465 	DPRINTF(("uvisor_init: getting available bytes\n"));
    466 	req.bmRequestType = UT_READ_VENDOR_ENDPOINT;
    467 	req.bRequest = UVISOR_REQUEST_BYTES_AVAILABLE;
    468 	USETW(req.wValue, 0);
    469 	USETW(req.wIndex, 5);
    470 	USETW(req.wLength, sizeof avail);
    471 	err = usbd_do_request(sc->sc_udev, &req, &avail);
    472 	if (err)
    473 		return (err);
    474 	DPRINTF(("uvisor_init: avail=%d\n", UGETW(avail)));
    475 
    476 	DPRINTF(("uvisor_init: done\n"));
    477 	return (err);
    478 }
    479 
    480 void
    481 uvisor_close(void *addr, int portno)
    482 {
    483 	struct uvisor_softc *sc = addr;
    484 	usb_device_request_t req;
    485 	struct uvisor_connection_info coninfo; /* XXX ? */
    486 	int actlen;
    487 
    488 	if (sc->sc_dying)
    489 		return;
    490 
    491 	req.bmRequestType = UT_READ_VENDOR_ENDPOINT; /* XXX read? */
    492 	req.bRequest = UVISOR_CLOSE_NOTIFICATION;
    493 	USETW(req.wValue, 0);
    494 	USETW(req.wIndex, 0);
    495 	USETW(req.wLength, UVISOR_CONNECTION_INFO_SIZE);
    496 	(void)usbd_do_request_flags(sc->sc_udev, &req, &coninfo,
    497 		  USBD_SHORT_XFER_OK, &actlen, USBD_DEFAULT_TIMEOUT);
    498 }
    499