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