xref: /freebsd/sys/dev/usb/serial/uvisor.c (revision e17f5b1d)
1 /*	$NetBSD: uvisor.c,v 1.9 2001/01/23 14:04:14 augustss Exp $	*/
2 /*      $FreeBSD$ */
3 
4 /* Also already merged from NetBSD:
5  *	$NetBSD: uvisor.c,v 1.12 2001/11/13 06:24:57 lukem Exp $
6  *	$NetBSD: uvisor.c,v 1.13 2002/02/11 15:11:49 augustss Exp $
7  *	$NetBSD: uvisor.c,v 1.14 2002/02/27 23:00:03 augustss Exp $
8  *	$NetBSD: uvisor.c,v 1.15 2002/06/16 15:01:31 augustss Exp $
9  *	$NetBSD: uvisor.c,v 1.16 2002/07/11 21:14:36 augustss Exp $
10  *	$NetBSD: uvisor.c,v 1.17 2002/08/13 11:38:15 augustss Exp $
11  *	$NetBSD: uvisor.c,v 1.18 2003/02/05 00:50:14 augustss Exp $
12  *	$NetBSD: uvisor.c,v 1.19 2003/02/07 18:12:37 augustss Exp $
13  *	$NetBSD: uvisor.c,v 1.20 2003/04/11 01:30:10 simonb Exp $
14  */
15 
16 /*-
17  * SPDX-License-Identifier: BSD-2-Clause-NetBSD
18  *
19  * Copyright (c) 2000 The NetBSD Foundation, Inc.
20  * All rights reserved.
21  *
22  * This code is derived from software contributed to The NetBSD Foundation
23  * by Lennart Augustsson (lennart@augustsson.net) at
24  * Carlstedt Research & Technology.
25  *
26  * Redistribution and use in source and binary forms, with or without
27  * modification, are permitted provided that the following conditions
28  * are met:
29  * 1. Redistributions of source code must retain the above copyright
30  *    notice, this list of conditions and the following disclaimer.
31  * 2. Redistributions in binary form must reproduce the above copyright
32  *    notice, this list of conditions and the following disclaimer in the
33  *    documentation and/or other materials provided with the distribution.
34  *
35  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
36  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
37  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
38  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
39  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
40  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
41  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
42  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
43  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
44  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
45  * POSSIBILITY OF SUCH DAMAGE.
46  */
47 
48 /*
49  * Handspring Visor (Palmpilot compatible PDA) driver
50  */
51 
52 #include <sys/stdint.h>
53 #include <sys/stddef.h>
54 #include <sys/param.h>
55 #include <sys/queue.h>
56 #include <sys/types.h>
57 #include <sys/systm.h>
58 #include <sys/kernel.h>
59 #include <sys/bus.h>
60 #include <sys/module.h>
61 #include <sys/lock.h>
62 #include <sys/mutex.h>
63 #include <sys/condvar.h>
64 #include <sys/sysctl.h>
65 #include <sys/sx.h>
66 #include <sys/unistd.h>
67 #include <sys/callout.h>
68 #include <sys/malloc.h>
69 #include <sys/priv.h>
70 
71 #include <dev/usb/usb.h>
72 #include <dev/usb/usbdi.h>
73 #include <dev/usb/usbdi_util.h>
74 #include "usbdevs.h"
75 
76 #define	USB_DEBUG_VAR uvisor_debug
77 #include <dev/usb/usb_debug.h>
78 #include <dev/usb/usb_process.h>
79 
80 #include <dev/usb/serial/usb_serial.h>
81 
82 #ifdef USB_DEBUG
83 static int uvisor_debug = 0;
84 
85 static SYSCTL_NODE(_hw_usb, OID_AUTO, uvisor, CTLFLAG_RW | CTLFLAG_MPSAFE, 0,
86     "USB uvisor");
87 SYSCTL_INT(_hw_usb_uvisor, OID_AUTO, debug, CTLFLAG_RWTUN,
88     &uvisor_debug, 0, "Debug level");
89 #endif
90 
91 #define	UVISOR_CONFIG_INDEX	0
92 #define	UVISOR_IFACE_INDEX	0
93 
94 /*
95  * The following buffer sizes are hardcoded due to the way the Palm
96  * firmware works. It looks like the device is not short terminating
97  * the data transferred.
98  */
99 #define	UVISORIBUFSIZE	       0	/* Use wMaxPacketSize */
100 #define	UVISOROBUFSIZE	       32	/* bytes */
101 #define	UVISOROFRAMES	       32	/* units */
102 
103 /* From the Linux driver */
104 /*
105  * UVISOR_REQUEST_BYTES_AVAILABLE asks the visor for the number of bytes that
106  * are available to be transferred to the host for the specified endpoint.
107  * Currently this is not used, and always returns 0x0001
108  */
109 #define	UVISOR_REQUEST_BYTES_AVAILABLE		0x01
110 
111 /*
112  * UVISOR_CLOSE_NOTIFICATION is set to the device to notify it that the host
113  * is now closing the pipe. An empty packet is sent in response.
114  */
115 #define	UVISOR_CLOSE_NOTIFICATION		0x02
116 
117 /*
118  * UVISOR_GET_CONNECTION_INFORMATION is sent by the host during enumeration to
119  * get the endpoints used by the connection.
120  */
121 #define	UVISOR_GET_CONNECTION_INFORMATION	0x03
122 
123 /*
124  * UVISOR_GET_CONNECTION_INFORMATION returns data in the following format
125  */
126 #define	UVISOR_MAX_CONN 8
127 struct uvisor_connection_info {
128 	uWord	num_ports;
129 	struct {
130 		uByte	port_function_id;
131 		uByte	port;
132 	} __packed connections[UVISOR_MAX_CONN];
133 } __packed;
134 
135 #define	UVISOR_CONNECTION_INFO_SIZE 18
136 
137 /* struct uvisor_connection_info.connection[x].port defines: */
138 #define	UVISOR_ENDPOINT_1		0x01
139 #define	UVISOR_ENDPOINT_2		0x02
140 
141 /* struct uvisor_connection_info.connection[x].port_function_id defines: */
142 #define	UVISOR_FUNCTION_GENERIC		0x00
143 #define	UVISOR_FUNCTION_DEBUGGER	0x01
144 #define	UVISOR_FUNCTION_HOTSYNC		0x02
145 #define	UVISOR_FUNCTION_CONSOLE		0x03
146 #define	UVISOR_FUNCTION_REMOTE_FILE_SYS	0x04
147 
148 /*
149  * Unknown PalmOS stuff.
150  */
151 #define	UVISOR_GET_PALM_INFORMATION		0x04
152 #define	UVISOR_GET_PALM_INFORMATION_LEN		0x44
153 
154 struct uvisor_palm_connection_info {
155 	uByte	num_ports;
156 	uByte	endpoint_numbers_different;
157 	uWord	reserved1;
158 	struct {
159 		uDWord	port_function_id;
160 		uByte	port;
161 		uByte	end_point_info;
162 		uWord	reserved;
163 	} __packed connections[UVISOR_MAX_CONN];
164 } __packed;
165 
166 enum {
167 	UVISOR_BULK_DT_WR,
168 	UVISOR_BULK_DT_RD,
169 	UVISOR_N_TRANSFER,
170 };
171 
172 struct uvisor_softc {
173 	struct ucom_super_softc sc_super_ucom;
174 	struct ucom_softc sc_ucom;
175 
176 	struct usb_xfer *sc_xfer[UVISOR_N_TRANSFER];
177 	struct usb_device *sc_udev;
178 	struct mtx sc_mtx;
179 
180 	uint16_t sc_flag;
181 #define	UVISOR_FLAG_PALM4       0x0001
182 #define	UVISOR_FLAG_VISOR       0x0002
183 #define	UVISOR_FLAG_PALM35      0x0004
184 #define	UVISOR_FLAG_SEND_NOTIFY 0x0008
185 
186 	uint8_t	sc_iface_no;
187 	uint8_t	sc_iface_index;
188 };
189 
190 /* prototypes */
191 
192 static device_probe_t uvisor_probe;
193 static device_attach_t uvisor_attach;
194 static device_detach_t uvisor_detach;
195 static void uvisor_free_softc(struct uvisor_softc *);
196 
197 static usb_callback_t uvisor_write_callback;
198 static usb_callback_t uvisor_read_callback;
199 
200 static usb_error_t uvisor_init(struct uvisor_softc *, struct usb_device *,
201 		    struct usb_config *);
202 static void	uvisor_free(struct ucom_softc *);
203 static void	uvisor_cfg_open(struct ucom_softc *);
204 static void	uvisor_cfg_close(struct ucom_softc *);
205 static void	uvisor_start_read(struct ucom_softc *);
206 static void	uvisor_stop_read(struct ucom_softc *);
207 static void	uvisor_start_write(struct ucom_softc *);
208 static void	uvisor_stop_write(struct ucom_softc *);
209 
210 static const struct usb_config uvisor_config[UVISOR_N_TRANSFER] = {
211 
212 	[UVISOR_BULK_DT_WR] = {
213 		.type = UE_BULK,
214 		.endpoint = UE_ADDR_ANY,
215 		.direction = UE_DIR_OUT,
216 		.bufsize = UVISOROBUFSIZE * UVISOROFRAMES,
217 		.frames = UVISOROFRAMES,
218 		.flags = {.pipe_bof = 1,.force_short_xfer = 1,},
219 		.callback = &uvisor_write_callback,
220 	},
221 
222 	[UVISOR_BULK_DT_RD] = {
223 		.type = UE_BULK,
224 		.endpoint = UE_ADDR_ANY,
225 		.direction = UE_DIR_IN,
226 		.bufsize = UVISORIBUFSIZE,
227 		.flags = {.pipe_bof = 1,.short_xfer_ok = 1,},
228 		.callback = &uvisor_read_callback,
229 	},
230 };
231 
232 static const struct ucom_callback uvisor_callback = {
233 	.ucom_cfg_open = &uvisor_cfg_open,
234 	.ucom_cfg_close = &uvisor_cfg_close,
235 	.ucom_start_read = &uvisor_start_read,
236 	.ucom_stop_read = &uvisor_stop_read,
237 	.ucom_start_write = &uvisor_start_write,
238 	.ucom_stop_write = &uvisor_stop_write,
239 	.ucom_free = &uvisor_free,
240 };
241 
242 static device_method_t uvisor_methods[] = {
243 	DEVMETHOD(device_probe, uvisor_probe),
244 	DEVMETHOD(device_attach, uvisor_attach),
245 	DEVMETHOD(device_detach, uvisor_detach),
246 	DEVMETHOD_END
247 };
248 
249 static devclass_t uvisor_devclass;
250 
251 static driver_t uvisor_driver = {
252 	.name = "uvisor",
253 	.methods = uvisor_methods,
254 	.size = sizeof(struct uvisor_softc),
255 };
256 
257 static const STRUCT_USB_HOST_ID uvisor_devs[] = {
258 #define	UVISOR_DEV(v,p,i) { USB_VPI(USB_VENDOR_##v, USB_PRODUCT_##v##_##p, i) }
259 	UVISOR_DEV(ACEECA, MEZ1000, UVISOR_FLAG_PALM4),
260 	UVISOR_DEV(ALPHASMART, DANA_SYNC, UVISOR_FLAG_PALM4),
261 	UVISOR_DEV(GARMIN, IQUE_3600, UVISOR_FLAG_PALM4),
262 	UVISOR_DEV(FOSSIL, WRISTPDA, UVISOR_FLAG_PALM4),
263 	UVISOR_DEV(HANDSPRING, VISOR, UVISOR_FLAG_VISOR),
264 	UVISOR_DEV(HANDSPRING, TREO, UVISOR_FLAG_PALM4),
265 	UVISOR_DEV(HANDSPRING, TREO600, UVISOR_FLAG_PALM4),
266 	UVISOR_DEV(PALM, M500, UVISOR_FLAG_PALM4),
267 	UVISOR_DEV(PALM, M505, UVISOR_FLAG_PALM4),
268 	UVISOR_DEV(PALM, M515, UVISOR_FLAG_PALM4),
269 	UVISOR_DEV(PALM, I705, UVISOR_FLAG_PALM4),
270 	UVISOR_DEV(PALM, M125, UVISOR_FLAG_PALM4),
271 	UVISOR_DEV(PALM, M130, UVISOR_FLAG_PALM4),
272 	UVISOR_DEV(PALM, TUNGSTEN_Z, UVISOR_FLAG_PALM4),
273 	UVISOR_DEV(PALM, TUNGSTEN_T, UVISOR_FLAG_PALM4),
274 	UVISOR_DEV(PALM, ZIRE, UVISOR_FLAG_PALM4),
275 	UVISOR_DEV(PALM, ZIRE31, UVISOR_FLAG_PALM4),
276 	UVISOR_DEV(SAMSUNG, I500, UVISOR_FLAG_PALM4),
277 	UVISOR_DEV(SONY, CLIE_40, 0),
278 	UVISOR_DEV(SONY, CLIE_41, 0),
279 	UVISOR_DEV(SONY, CLIE_S360, UVISOR_FLAG_PALM4),
280 	UVISOR_DEV(SONY, CLIE_NX60, UVISOR_FLAG_PALM4),
281 	UVISOR_DEV(SONY, CLIE_35, UVISOR_FLAG_PALM35),
282 /*  UVISOR_DEV(SONY, CLIE_25, UVISOR_FLAG_PALM4 ), */
283 	UVISOR_DEV(SONY, CLIE_TJ37, UVISOR_FLAG_PALM4),
284 /*  UVISOR_DEV(SONY, CLIE_TH55, UVISOR_FLAG_PALM4 ), See PR 80935 */
285 	UVISOR_DEV(TAPWAVE, ZODIAC, UVISOR_FLAG_PALM4),
286 #undef UVISOR_DEV
287 };
288 
289 DRIVER_MODULE(uvisor, uhub, uvisor_driver, uvisor_devclass, NULL, 0);
290 MODULE_DEPEND(uvisor, ucom, 1, 1, 1);
291 MODULE_DEPEND(uvisor, usb, 1, 1, 1);
292 MODULE_VERSION(uvisor, 1);
293 USB_PNP_HOST_INFO(uvisor_devs);
294 
295 static int
296 uvisor_probe(device_t dev)
297 {
298 	struct usb_attach_arg *uaa = device_get_ivars(dev);
299 
300 	if (uaa->usb_mode != USB_MODE_HOST) {
301 		return (ENXIO);
302 	}
303 	if (uaa->info.bConfigIndex != UVISOR_CONFIG_INDEX) {
304 		return (ENXIO);
305 	}
306 	if (uaa->info.bIfaceIndex != UVISOR_IFACE_INDEX) {
307 		return (ENXIO);
308 	}
309 	return (usbd_lookup_id_by_uaa(uvisor_devs, sizeof(uvisor_devs), uaa));
310 }
311 
312 static int
313 uvisor_attach(device_t dev)
314 {
315 	struct usb_attach_arg *uaa = device_get_ivars(dev);
316 	struct uvisor_softc *sc = device_get_softc(dev);
317 	struct usb_config uvisor_config_copy[UVISOR_N_TRANSFER];
318 	int error;
319 
320 	DPRINTF("sc=%p\n", sc);
321 	memcpy(uvisor_config_copy, uvisor_config,
322 	    sizeof(uvisor_config_copy));
323 
324 	device_set_usb_desc(dev);
325 
326 	mtx_init(&sc->sc_mtx, "uvisor", NULL, MTX_DEF);
327 	ucom_ref(&sc->sc_super_ucom);
328 
329 	sc->sc_udev = uaa->device;
330 
331 	/* configure the device */
332 
333 	sc->sc_flag = USB_GET_DRIVER_INFO(uaa);
334 	sc->sc_iface_no = uaa->info.bIfaceNum;
335 	sc->sc_iface_index = UVISOR_IFACE_INDEX;
336 
337 	error = uvisor_init(sc, uaa->device, uvisor_config_copy);
338 
339 	if (error) {
340 		DPRINTF("init failed, error=%s\n",
341 		    usbd_errstr(error));
342 		goto detach;
343 	}
344 	error = usbd_transfer_setup(uaa->device, &sc->sc_iface_index,
345 	    sc->sc_xfer, uvisor_config_copy, UVISOR_N_TRANSFER,
346 	    sc, &sc->sc_mtx);
347 	if (error) {
348 		DPRINTF("could not allocate all pipes\n");
349 		goto detach;
350 	}
351 
352 	error = ucom_attach(&sc->sc_super_ucom, &sc->sc_ucom, 1, sc,
353 	    &uvisor_callback, &sc->sc_mtx);
354 	if (error) {
355 		DPRINTF("ucom_attach failed\n");
356 		goto detach;
357 	}
358 	ucom_set_pnpinfo_usb(&sc->sc_super_ucom, dev);
359 
360 	return (0);
361 
362 detach:
363 	uvisor_detach(dev);
364 	return (ENXIO);
365 }
366 
367 static int
368 uvisor_detach(device_t dev)
369 {
370 	struct uvisor_softc *sc = device_get_softc(dev);
371 
372 	DPRINTF("sc=%p\n", sc);
373 
374 	ucom_detach(&sc->sc_super_ucom, &sc->sc_ucom);
375 	usbd_transfer_unsetup(sc->sc_xfer, UVISOR_N_TRANSFER);
376 
377 	device_claim_softc(dev);
378 
379 	uvisor_free_softc(sc);
380 
381 	return (0);
382 }
383 
384 UCOM_UNLOAD_DRAIN(uvisor);
385 
386 static void
387 uvisor_free_softc(struct uvisor_softc *sc)
388 {
389 	if (ucom_unref(&sc->sc_super_ucom)) {
390 		mtx_destroy(&sc->sc_mtx);
391 		device_free_softc(sc);
392 	}
393 }
394 
395 static void
396 uvisor_free(struct ucom_softc *ucom)
397 {
398 	uvisor_free_softc(ucom->sc_parent);
399 }
400 
401 static usb_error_t
402 uvisor_init(struct uvisor_softc *sc, struct usb_device *udev, struct usb_config *config)
403 {
404 	usb_error_t err = 0;
405 	struct usb_device_request req;
406 	struct uvisor_connection_info coninfo;
407 	struct uvisor_palm_connection_info pconinfo;
408 	uint16_t actlen;
409 	uint8_t buffer[256];
410 
411 	if (sc->sc_flag & UVISOR_FLAG_VISOR) {
412 		DPRINTF("getting connection info\n");
413 		req.bmRequestType = UT_READ_VENDOR_ENDPOINT;
414 		req.bRequest = UVISOR_GET_CONNECTION_INFORMATION;
415 		USETW(req.wValue, 0);
416 		USETW(req.wIndex, 0);
417 		USETW(req.wLength, UVISOR_CONNECTION_INFO_SIZE);
418 		err = usbd_do_request_flags(udev, NULL,
419 		    &req, &coninfo, USB_SHORT_XFER_OK,
420 		    &actlen, USB_DEFAULT_TIMEOUT);
421 
422 		if (err) {
423 			goto done;
424 		}
425 	}
426 #ifdef USB_DEBUG
427 	if (sc->sc_flag & UVISOR_FLAG_VISOR) {
428 		uint16_t i, np;
429 		const char *desc;
430 
431 		np = UGETW(coninfo.num_ports);
432 		if (np > UVISOR_MAX_CONN) {
433 			np = UVISOR_MAX_CONN;
434 		}
435 		DPRINTF("Number of ports: %d\n", np);
436 
437 		for (i = 0; i < np; ++i) {
438 			switch (coninfo.connections[i].port_function_id) {
439 			case UVISOR_FUNCTION_GENERIC:
440 				desc = "Generic";
441 				break;
442 			case UVISOR_FUNCTION_DEBUGGER:
443 				desc = "Debugger";
444 				break;
445 			case UVISOR_FUNCTION_HOTSYNC:
446 				desc = "HotSync";
447 				break;
448 			case UVISOR_FUNCTION_REMOTE_FILE_SYS:
449 				desc = "Remote File System";
450 				break;
451 			default:
452 				desc = "unknown";
453 				break;
454 			}
455 			DPRINTF("Port %d is for %s\n",
456 			    coninfo.connections[i].port, desc);
457 		}
458 	}
459 #endif
460 
461 	if (sc->sc_flag & UVISOR_FLAG_PALM4) {
462 		uint8_t port;
463 
464 		/* Palm OS 4.0 Hack */
465 		req.bmRequestType = UT_READ_VENDOR_ENDPOINT;
466 		req.bRequest = UVISOR_GET_PALM_INFORMATION;
467 		USETW(req.wValue, 0);
468 		USETW(req.wIndex, 0);
469 		USETW(req.wLength, UVISOR_GET_PALM_INFORMATION_LEN);
470 
471 		err = usbd_do_request_flags
472 		    (udev, NULL, &req, &pconinfo, USB_SHORT_XFER_OK,
473 		    &actlen, USB_DEFAULT_TIMEOUT);
474 
475 		if (err) {
476 			goto done;
477 		}
478 		if (actlen < 12) {
479 			DPRINTF("too little data\n");
480 			err = USB_ERR_INVAL;
481 			goto done;
482 		}
483 		if (pconinfo.endpoint_numbers_different) {
484 			port = pconinfo.connections[0].end_point_info;
485 			config[0].endpoint = (port & 0xF);	/* output */
486 			config[1].endpoint = (port >> 4);	/* input */
487 		} else {
488 			port = pconinfo.connections[0].port;
489 			config[0].endpoint = (port & 0xF);	/* output */
490 			config[1].endpoint = (port & 0xF);	/* input */
491 		}
492 #if 0
493 		req.bmRequestType = UT_READ_VENDOR_ENDPOINT;
494 		req.bRequest = UVISOR_GET_PALM_INFORMATION;
495 		USETW(req.wValue, 0);
496 		USETW(req.wIndex, 0);
497 		USETW(req.wLength, UVISOR_GET_PALM_INFORMATION_LEN);
498 		err = usbd_do_request(udev, &req, buffer);
499 		if (err) {
500 			goto done;
501 		}
502 #endif
503 	}
504 	if (sc->sc_flag & UVISOR_FLAG_PALM35) {
505 		/* get the config number */
506 		DPRINTF("getting config info\n");
507 		req.bmRequestType = UT_READ;
508 		req.bRequest = UR_GET_CONFIG;
509 		USETW(req.wValue, 0);
510 		USETW(req.wIndex, 0);
511 		USETW(req.wLength, 1);
512 
513 		err = usbd_do_request(udev, NULL, &req, buffer);
514 		if (err) {
515 			goto done;
516 		}
517 		/* get the interface number */
518 		DPRINTF("get the interface number\n");
519 		req.bmRequestType = UT_READ_DEVICE;
520 		req.bRequest = UR_GET_INTERFACE;
521 		USETW(req.wValue, 0);
522 		USETW(req.wIndex, 0);
523 		USETW(req.wLength, 1);
524 		err = usbd_do_request(udev, NULL, &req, buffer);
525 		if (err) {
526 			goto done;
527 		}
528 	}
529 #if 0
530 	uWord wAvail;
531 
532 	DPRINTF("getting available bytes\n");
533 	req.bmRequestType = UT_READ_VENDOR_ENDPOINT;
534 	req.bRequest = UVISOR_REQUEST_BYTES_AVAILABLE;
535 	USETW(req.wValue, 0);
536 	USETW(req.wIndex, 5);
537 	USETW(req.wLength, sizeof(wAvail));
538 	err = usbd_do_request(udev, NULL, &req, &wAvail);
539 	if (err) {
540 		goto done;
541 	}
542 	DPRINTF("avail=%d\n", UGETW(wAvail));
543 #endif
544 
545 	DPRINTF("done\n");
546 done:
547 	return (err);
548 }
549 
550 static void
551 uvisor_cfg_open(struct ucom_softc *ucom)
552 {
553 	return;
554 }
555 
556 static void
557 uvisor_cfg_close(struct ucom_softc *ucom)
558 {
559 	struct uvisor_softc *sc = ucom->sc_parent;
560 	uint8_t buffer[UVISOR_CONNECTION_INFO_SIZE];
561 	struct usb_device_request req;
562 	usb_error_t err;
563 
564 	req.bmRequestType = UT_READ_VENDOR_ENDPOINT;	/* XXX read? */
565 	req.bRequest = UVISOR_CLOSE_NOTIFICATION;
566 	USETW(req.wValue, 0);
567 	USETW(req.wIndex, 0);
568 	USETW(req.wLength, UVISOR_CONNECTION_INFO_SIZE);
569 
570 	err = ucom_cfg_do_request(sc->sc_udev, &sc->sc_ucom,
571 	    &req, buffer, 0, 1000);
572 	if (err) {
573 		DPRINTFN(0, "close notification failed, error=%s\n",
574 		    usbd_errstr(err));
575 	}
576 }
577 
578 static void
579 uvisor_start_read(struct ucom_softc *ucom)
580 {
581 	struct uvisor_softc *sc = ucom->sc_parent;
582 
583 	usbd_transfer_start(sc->sc_xfer[UVISOR_BULK_DT_RD]);
584 }
585 
586 static void
587 uvisor_stop_read(struct ucom_softc *ucom)
588 {
589 	struct uvisor_softc *sc = ucom->sc_parent;
590 
591 	usbd_transfer_stop(sc->sc_xfer[UVISOR_BULK_DT_RD]);
592 }
593 
594 static void
595 uvisor_start_write(struct ucom_softc *ucom)
596 {
597 	struct uvisor_softc *sc = ucom->sc_parent;
598 
599 	usbd_transfer_start(sc->sc_xfer[UVISOR_BULK_DT_WR]);
600 }
601 
602 static void
603 uvisor_stop_write(struct ucom_softc *ucom)
604 {
605 	struct uvisor_softc *sc = ucom->sc_parent;
606 
607 	usbd_transfer_stop(sc->sc_xfer[UVISOR_BULK_DT_WR]);
608 }
609 
610 static void
611 uvisor_write_callback(struct usb_xfer *xfer, usb_error_t error)
612 {
613 	struct uvisor_softc *sc = usbd_xfer_softc(xfer);
614 	struct usb_page_cache *pc;
615 	uint32_t actlen;
616 	uint8_t x;
617 
618 	switch (USB_GET_STATE(xfer)) {
619 	case USB_ST_SETUP:
620 	case USB_ST_TRANSFERRED:
621 tr_setup:
622 		for (x = 0; x != UVISOROFRAMES; x++) {
623 
624 			usbd_xfer_set_frame_offset(xfer,
625 			    x * UVISOROBUFSIZE, x);
626 
627 			pc = usbd_xfer_get_frame(xfer, x);
628 			if (ucom_get_data(&sc->sc_ucom, pc, 0,
629 			    UVISOROBUFSIZE, &actlen)) {
630 				usbd_xfer_set_frame_len(xfer, x, actlen);
631 			} else {
632 				break;
633 			}
634 		}
635 		/* check for data */
636 		if (x != 0) {
637 			usbd_xfer_set_frames(xfer, x);
638 			usbd_transfer_submit(xfer);
639 		}
640 		break;
641 
642 	default:			/* Error */
643 		if (error != USB_ERR_CANCELLED) {
644 			/* try to clear stall first */
645 			usbd_xfer_set_stall(xfer);
646 			goto tr_setup;
647 		}
648 		break;
649 	}
650 }
651 
652 static void
653 uvisor_read_callback(struct usb_xfer *xfer, usb_error_t error)
654 {
655 	struct uvisor_softc *sc = usbd_xfer_softc(xfer);
656 	struct usb_page_cache *pc;
657 	int actlen;
658 
659 	usbd_xfer_status(xfer, &actlen, NULL, NULL, NULL);
660 
661 	switch (USB_GET_STATE(xfer)) {
662 	case USB_ST_TRANSFERRED:
663 		pc = usbd_xfer_get_frame(xfer, 0);
664 		ucom_put_data(&sc->sc_ucom, pc, 0, actlen);
665 
666 	case USB_ST_SETUP:
667 tr_setup:
668 		usbd_xfer_set_frame_len(xfer, 0, usbd_xfer_max_len(xfer));
669 		usbd_transfer_submit(xfer);
670 		return;
671 
672 	default:			/* Error */
673 		if (error != USB_ERR_CANCELLED) {
674 			/* try to clear stall first */
675 			usbd_xfer_set_stall(xfer);
676 			goto tr_setup;
677 		}
678 		return;
679 	}
680 }
681