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
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
|
/* hidapi_parser $
*
* Copyright (C) 2013, Marije Baalman <nescivi _at_ gmail.com>
* This work was funded by a crowd-funding initiative for SuperCollider's [1] HID implementation
* including a substantial donation from BEK, Bergen Center for Electronic Arts, Norway
*
* [1] http://supercollider.sourceforge.net
* [2] http://www.bek.no
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
*/
#ifndef HIDAPI_PARSER_H__
#define HIDAPI_PARSER_H__
#define HIDAPI_MAX_DESCRIPTOR_SIZE 4096
#ifdef __cplusplus /* If this is a C++ compiler, use C linkage */
extern "C" {
#endif
#include "hidapi.h"
struct hid_device_element;
struct hid_device_collection;
// struct hid_device_descriptor;
struct hid_dev_desc;
typedef void (*hid_element_callback) ( struct hid_device_element *element, void *user_data);
// typedef void (*hid_descriptor_callback) ( struct hid_device_descriptor *descriptor, void *user_data);
typedef void (*hid_descriptor_callback) ( struct hid_dev_desc *descriptor, void *user_data);
typedef void (*hid_device_readerror_callback) ( struct hid_dev_desc *descriptor, void *user_data);
struct hid_dev_desc {
int index;
hid_device *device;
// struct hid_device_descriptor *descriptor;
struct hid_device_collection *device_collection;
struct hid_device_info *info;
int number_of_reports;
int * report_lengths;
int * report_ids;
/** pointers to callback function */
hid_element_callback _element_callback;
void *_element_data;
hid_descriptor_callback _descriptor_callback;
void *_descriptor_data;
hid_device_readerror_callback _readerror_callback;
void *_readerror_data;
};
struct hid_device_element {
int index;
int io_type; // input(1), output(2), feature(3)
int type; // flags from the input/output report
// int vartype; // abs/relative
int usage_page; // usage page
int usage; // some kind of index (as from descriptor)
int usage_min;
int usage_max;
int isvariable;
int isarray;
int isrelative;
int logical_min;
int logical_max;
int phys_min;
int phys_max;
int unit_exponent;
int unit;
int report_size;
int report_id;
int report_index; // index into the report
int rawvalue;
int value;
int array_value;
int repeat;
/** Pointer to the next element */
struct hid_device_element *next;
/** Pointer to the parent collection */
struct hid_device_collection *parent_collection;
#ifdef APPLE
IOHIDElementRef appleIOHIDElementRef;
#endif
};
struct hid_device_collection {
int index;
int type;
int usage_page; // usage page
int usage_index; // some kind of index (as from descriptor)
int usage_min;
int usage_max;
int num_elements;
int num_collections;
/** Pointer to the parent collection */
struct hid_device_collection *parent_collection;
/** Pointer to the next collection */
struct hid_device_collection *next_collection;
/** Pointer to the first subcollection */
struct hid_device_collection *first_collection;
/** Pointer to the first element */
struct hid_device_element *first_element;
};
// higher level functions:
struct hid_dev_desc * hid_read_descriptor( hid_device *devd );
struct hid_dev_desc * hid_open_device_path( const char *path, unsigned short vendor, unsigned short product );
struct hid_dev_desc * hid_open_device( unsigned short vendor, unsigned short product, const wchar_t *serial_number );
extern void hid_close_device( struct hid_dev_desc * devdesc );
struct hid_device_collection * hid_new_collection();
void hid_free_collection( struct hid_device_collection * coll );
struct hid_device_element * hid_new_element();
void hid_free_element( struct hid_device_element * ele);
void hid_throw_readerror( struct hid_dev_desc * devd );
void hid_set_descriptor_callback( struct hid_dev_desc * devd, hid_descriptor_callback cb, void *user_data );
void hid_set_readerror_callback( struct hid_dev_desc * devd, hid_device_readerror_callback cb, void *user_data );
void hid_set_element_callback( struct hid_dev_desc * devd, hid_element_callback cb, void *user_data );
int hid_parse_report_descriptor( unsigned char* descr_buf, int size, struct hid_dev_desc * device_desc );
struct hid_device_element * hid_get_next_input_element( struct hid_device_element * curel );
struct hid_device_element * hid_get_next_input_element_with_reportid( struct hid_device_element * curel, int reportid );
struct hid_device_element * hid_get_next_output_element( struct hid_device_element * curel );
struct hid_device_element * hid_get_next_output_element_with_reportid( struct hid_device_element * curel, int reportid );
struct hid_device_element * hid_get_next_feature_element( struct hid_device_element * curel );
int hid_parse_input_report( unsigned char* buf, int size, struct hid_dev_desc * devdesc );
float hid_element_resolution( struct hid_device_element * element );
float hid_element_map_logical( struct hid_device_element * element );
float hid_element_map_physical( struct hid_device_element * element );
void hid_element_set_value_from_input( struct hid_device_element * element, int value );
void hid_element_set_rawvalue( struct hid_device_element * element, int value );
void hid_element_set_logicalvalue( struct hid_device_element * element, float value );
void hid_element_set_output_value( struct hid_dev_desc * devdesc, struct hid_device_element * element, int value );
int hid_send_output_report( struct hid_dev_desc * devd, int reportid );
int hid_send_output_report_old( struct hid_dev_desc * devd, int reportid );
// int hid_parse_feature_report( char* buf, int size, hid_device_descriptor * descriptor );
#ifdef APPLE
int hid_send_element_output( struct hid_dev_desc * devdesc, struct hid_device_element * element );
int hid_parse_input_elements_values( unsigned char* buf, struct hid_dev_desc * devdesc );
void hid_parse_element_info( struct hid_dev_desc * devdesc );
#endif
#ifdef WIN32
int hid_send_element_output( struct hid_dev_desc * devdesc, struct hid_device_element * element );
int hid_parse_input_elements_values( unsigned char* buf, int size, struct hid_dev_desc * devdesc );
void hid_parse_element_info( struct hid_dev_desc * devdesc );
#endif
#ifdef __cplusplus /* If this is a C++ compiler, end C linkage */
}
#endif
#endif
|
