1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
|
/*-
* Copyright (c) 2019 Vladimir Kondratyev <wulf@FreeBSD.org>
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
*/
#ifndef _HID_HIDBUS_H_
#define _HID_HIDBUS_H_
enum {
HIDBUS_IVAR_USAGE,
HIDBUS_IVAR_INDEX,
HIDBUS_IVAR_FLAGS,
#define HIDBUS_FLAG_AUTOCHILD (0<<1) /* Child is autodiscovered */
#define HIDBUS_FLAG_CAN_POLL (1<<1) /* Child can work during panic */
HIDBUS_IVAR_DRIVER_INFO,
HIDBUS_IVAR_LOCK,
};
#define HIDBUS_ACCESSOR(A, B, T) \
__BUS_ACCESSOR(hidbus, A, HIDBUS, B, T)
HIDBUS_ACCESSOR(usage, USAGE, int32_t)
HIDBUS_ACCESSOR(index, INDEX, uint8_t)
HIDBUS_ACCESSOR(flags, FLAGS, uint32_t)
HIDBUS_ACCESSOR(driver_info, DRIVER_INFO, uintptr_t)
HIDBUS_ACCESSOR(lock, LOCK, struct mtx *)
/*
* The following structure is used when looking up an HID driver for
* an HID device. It is inspired by the structure called "usb_device_id".
* which is originated in Linux and ported to FreeBSD.
*/
struct hid_device_id {
/* Select which fields to match against */
#if BYTE_ORDER == LITTLE_ENDIAN
uint16_t
match_flag_page:1,
match_flag_usage:1,
match_flag_bus:1,
match_flag_vendor:1,
match_flag_product:1,
match_flag_ver_lo:1,
match_flag_ver_hi:1,
match_flag_pnp:1,
match_flag_unused:8;
#else
uint16_t
match_flag_unused:8,
match_flag_pnp:1,
match_flag_ver_hi:1,
match_flag_ver_lo:1,
match_flag_product:1,
match_flag_vendor:1,
match_flag_bus:1,
match_flag_usage:1,
match_flag_page:1;
#endif
/* Used for top level collection usage matches */
uint16_t page;
uint16_t usage;
/* Used for product specific matches; the Version range is inclusive */
uint8_t idBus;
uint16_t idVendor;
uint16_t idProduct;
uint16_t idVersion_lo;
uint16_t idVersion_hi;
char *idPnP;
/* Hook for driver specific information */
uintptr_t driver_info;
};
#define HID_STD_PNP_INFO \
"M16:mask;U16:page;U16:usage;U8:bus;U16:vendor;U16:product;" \
"L16:version;G16:version;Z:_HID"
#define HID_PNP_INFO(table) \
MODULE_PNP_INFO(HID_STD_PNP_INFO, hidbus, table, table, nitems(table))
#define HID_TLC(pg,usg) \
.match_flag_page = 1, .match_flag_usage = 1, .page = (pg), .usage = (usg)
#define HID_BUS(bus) \
.match_flag_bus = 1, .idBus = (bus)
#define HID_VENDOR(vend) \
.match_flag_vendor = 1, .idVendor = (vend)
#define HID_PRODUCT(prod) \
.match_flag_product = 1, .idProduct = (prod)
#define HID_VP(vend,prod) \
HID_VENDOR(vend), HID_PRODUCT(prod)
#define HID_BVP(bus,vend,prod) \
HID_BUS(bus), HID_VENDOR(vend), HID_PRODUCT(prod)
#define HID_BVPI(bus,vend,prod,info) \
HID_BUS(bus), HID_VENDOR(vend), HID_PRODUCT(prod), HID_DRIVER_INFO(info)
#define HID_VERSION_GTEQ(lo) /* greater than or equal */ \
.match_flag_ver_lo = 1, .idVersion_lo = (lo)
#define HID_VERSION_LTEQ(hi) /* less than or equal */ \
.match_flag_ver_hi = 1, .idVersion_hi = (hi)
#define HID_PNP(pnp) \
.match_flag_pnp = 1, .idPnP = (pnp)
#define HID_DRIVER_INFO(n) \
.driver_info = (n)
#define HID_GET_DRIVER_INFO(did) \
(did)->driver_info
#define HIDBUS_LOOKUP_ID(d, h) hidbus_lookup_id((d), (h), nitems(h))
#define HIDBUS_LOOKUP_DRIVER_INFO(d, h) \
hidbus_lookup_driver_info((d), (h), nitems(h))
/*
* Walk through all HID items hi belonging Top Level Collection #tlc_index
*/
#define HIDBUS_FOREACH_ITEM(hd, hi, tlc_index) \
for (uint8_t _iter = 0; \
_iter <= (tlc_index) && hid_get_item((hd), (hi)); \
_iter += (hi)->kind == hid_endcollection && (hi)->collevel == 0) \
if (_iter == (tlc_index))
int hidbus_locate(const void *desc, hid_size_t size, int32_t u,
enum hid_kind k, uint8_t tlc_index, uint8_t index,
struct hid_location *loc, uint32_t *flags, uint8_t *id,
struct hid_absinfo *ai);
const struct hid_device_id *hidbus_lookup_id(device_t,
const struct hid_device_id *, int);
struct hid_rdesc_info *hidbus_get_rdesc_info(device_t);
int hidbus_lookup_driver_info(device_t,
const struct hid_device_id *, int);
void hidbus_set_intr(device_t, hid_intr_t*, void *);
int hidbus_intr_start(device_t);
int hidbus_intr_stop(device_t);
void hidbus_intr_poll(device_t);
void hidbus_set_desc(device_t, const char *);
device_t hidbus_find_child(device_t, int32_t);
/* hidbus HID interface */
int hid_get_report_descr(device_t, void **, hid_size_t *);
int hid_set_report_descr(device_t, const void *, hid_size_t);
const struct hid_device_info *hid_get_device_info(device_t);
extern devclass_t hidbus_devclass;
#endif /* _HID_HIDBUS_H_ */
|