xref: /freebsd/lib/libusbhid/descr.c (revision 39beb93c)
1 /*	$NetBSD: descr.c,v 1.9 2000/09/24 02:13:24 augustss Exp $	*/
2 
3 /*
4  * Copyright (c) 1999 Lennart Augustsson <augustss@netbsd.org>
5  * All rights reserved.
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  * 1. Redistributions of source code must retain the above copyright
11  *    notice, this list of conditions and the following disclaimer.
12  * 2. Redistributions in binary form must reproduce the above copyright
13  *    notice, this list of conditions and the following disclaimer in the
14  *    documentation and/or other materials provided with the distribution.
15  *
16  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26  * SUCH DAMAGE.
27  */
28 
29 #include <sys/cdefs.h>
30 __FBSDID("$FreeBSD$");
31 
32 #include <sys/types.h>
33 
34 #include <assert.h>
35 #include <errno.h>
36 #include <stdlib.h>
37 #include <string.h>
38 #include <unistd.h>
39 #include <sys/time.h>
40 #include <sys/ioctl.h>
41 
42 #include <dev/usb/usb_ioctl.h>
43 
44 #include "usbhid.h"
45 #include "usbvar.h"
46 
47 int
48 hid_set_immed(int fd, int enable)
49 {
50 	int ret;
51 	ret = ioctl(fd, USB_SET_IMMED, &enable);
52 #ifdef HID_COMPAT7
53 	if (ret < 0)
54 		ret = hid_set_immed_compat7(fd, enable);
55 #endif
56 	return (ret);
57 }
58 
59 int
60 hid_get_report_id(int fd)
61 {
62 	int temp = -1;
63 	int ret;
64 
65 	ret = ioctl(fd, USB_GET_REPORT_ID, &temp);
66 #ifdef HID_COMPAT7
67 	if (ret < 0)
68 		ret = hid_get_report_id_compat7(fd);
69 	else
70 #endif
71 		ret = temp;
72 
73 	return (ret);
74 }
75 
76 report_desc_t
77 hid_get_report_desc(int fd)
78 {
79 	struct usb2_gen_descriptor ugd;
80 	report_desc_t rep;
81 	void *data;
82 
83 	memset(&ugd, 0, sizeof(ugd));
84 
85 	/* get actual length first */
86 	ugd.ugd_data = NULL;
87 	ugd.ugd_maxlen = 65535;
88 	if (ioctl(fd, USB_GET_REPORT_DESC, &ugd) < 0) {
89 #ifdef HID_COMPAT7
90 		/* could not read descriptor */
91 		/* try FreeBSD 7 compat code */
92 		return (hid_get_report_desc_compat7(fd));
93 #else
94 		return (NULL);
95 #endif
96 	}
97 
98 	/*
99 	 * NOTE: The kernel will return a failure if
100 	 * "ugd_actlen" is zero.
101 	 */
102 	data = malloc(ugd.ugd_actlen);
103 	if (data == NULL)
104 		return (NULL);
105 
106 	/* fetch actual descriptor */
107 	ugd.ugd_data = data;
108 	ugd.ugd_maxlen = ugd.ugd_actlen;
109 	if (ioctl(fd, USB_GET_REPORT_DESC, &ugd) < 0) {
110 		/* could not read descriptor */
111 		free(data);
112 		return (NULL);
113 	}
114 
115 	/* check END_COLLECTION */
116 	if (((unsigned char *)ugd.ugd_data)[ugd.ugd_actlen -1] != 0xC0) {
117 		/* invalid end byte */
118 		free(data);
119 		return (NULL);
120 	}
121 
122 	rep = hid_use_report_desc(data, ugd.ugd_actlen);
123 
124 	free(data);
125 
126 	return (rep);
127 }
128 
129 report_desc_t
130 hid_use_report_desc(unsigned char *data, unsigned int size)
131 {
132 	report_desc_t r;
133 
134 	r = malloc(sizeof(*r) + size);
135 	if (r == 0) {
136 		errno = ENOMEM;
137 		return (NULL);
138 	}
139 	r->size = size;
140 	memcpy(r->data, data, size);
141 	return (r);
142 }
143 
144 void
145 hid_dispose_report_desc(report_desc_t r)
146 {
147 
148 	free(r);
149 }
150