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