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
|
#ifndef _IPXE_USBHID_H
#define _IPXE_USBHID_H
/** @file
*
* USB human interface devices (HID)
*
*/
FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL );
#include <ipxe/usb.h>
/** Class code for human interface devices */
#define USB_CLASS_HID 3
/** Subclass code for boot devices */
#define USB_SUBCLASS_HID_BOOT 1
/** Set protocol */
#define USBHID_SET_PROTOCOL \
( USB_DIR_OUT | USB_TYPE_CLASS | USB_RECIP_INTERFACE | \
USB_REQUEST_TYPE ( 0x0b ) )
/** Boot protocol */
#define USBHID_PROTOCOL_BOOT 0
/** Report protocol */
#define USBHID_PROTOCOL_REPORT 1
/** Set idle time */
#define USBHID_SET_IDLE \
( USB_DIR_OUT | USB_TYPE_CLASS | USB_RECIP_INTERFACE | \
USB_REQUEST_TYPE ( 0x0a ) )
/** A USB human interface device */
struct usb_hid {
/** USB function */
struct usb_function *func;
/** Interrupt IN endpoint */
struct usb_endpoint in;
/** Interrupt OUT endpoint (optional) */
struct usb_endpoint out;
};
/**
* Initialise USB human interface device
*
* @v hid USB human interface device
* @v func USB function
* @v in Interrupt IN endpoint operations
* @v out Interrupt OUT endpoint operations (or NULL)
*/
static inline __attribute__ (( always_inline )) void
usbhid_init ( struct usb_hid *hid, struct usb_function *func,
struct usb_endpoint_driver_operations *in,
struct usb_endpoint_driver_operations *out ) {
struct usb_device *usb = func->usb;
hid->func = func;
usb_endpoint_init ( &hid->in, usb, in );
if ( out )
usb_endpoint_init ( &hid->out, usb, out );
}
/**
* Set protocol
*
* @v usb USB device
* @v interface Interface number
* @v protocol HID protocol
* @ret rc Return status code
*/
static inline __attribute__ (( always_inline )) int
usbhid_set_protocol ( struct usb_device *usb, unsigned int interface,
unsigned int protocol ) {
return usb_control ( usb, USBHID_SET_PROTOCOL, protocol, interface,
NULL, 0 );
}
/**
* Set idle time
*
* @v usb USB device
* @v interface Interface number
* @v report Report ID
* @v duration Duration (in 4ms units)
* @ret rc Return status code
*/
static inline __attribute__ (( always_inline )) int
usbhid_set_idle ( struct usb_device *usb, unsigned int interface,
unsigned int report, unsigned int duration ) {
return usb_control ( usb, USBHID_SET_IDLE,
( ( duration << 8 ) | report ),
interface, NULL, 0 );
}
extern int usbhid_open ( struct usb_hid *hid );
extern void usbhid_close ( struct usb_hid *hid );
extern int usbhid_refill ( struct usb_hid *hid );
extern int usbhid_describe ( struct usb_hid *hid,
struct usb_configuration_descriptor *config );
#endif /* _IPXE_USBHID_H */
|
