xref: /nrf52832-nimble/rt-thread/components/drivers/usb/usbdevice/class/hid.c (revision 104654410c56c573564690304ae786df310c91fc)
1*10465441SEvalZero /*
2*10465441SEvalZero  * File      : hid.c
3*10465441SEvalZero  * COPYRIGHT (C) 2008 - 2018, RT-Thread Development Team
4*10465441SEvalZero  *
5*10465441SEvalZero  * SPDX-License-Identifier: Apache-2.0
6*10465441SEvalZero  *
7*10465441SEvalZero  * Change Logs:
8*10465441SEvalZero  * Date           Author       Notes
9*10465441SEvalZero  * 2017-03-13     Urey         the first version
10*10465441SEvalZero  * 2017-11-16     ZYH          Update to common hid
11*10465441SEvalZero  */
12*10465441SEvalZero 
13*10465441SEvalZero #include <rthw.h>
14*10465441SEvalZero #include <rtthread.h>
15*10465441SEvalZero #include <rtservice.h>
16*10465441SEvalZero #include <rtdevice.h>
17*10465441SEvalZero 
18*10465441SEvalZero #include "drivers/usb_common.h"
19*10465441SEvalZero #include "drivers/usb_device.h"
20*10465441SEvalZero 
21*10465441SEvalZero #include "hid.h"
22*10465441SEvalZero 
23*10465441SEvalZero #ifdef RT_USB_DEVICE_HID
24*10465441SEvalZero 
25*10465441SEvalZero struct hid_s
26*10465441SEvalZero {
27*10465441SEvalZero     struct rt_device parent;
28*10465441SEvalZero     struct ufunction *func;
29*10465441SEvalZero     uep_t ep_in;
30*10465441SEvalZero     uep_t ep_out;
31*10465441SEvalZero     int status;
32*10465441SEvalZero     rt_uint16_t protocol;
33*10465441SEvalZero     rt_uint8_t report_buf[MAX_REPORT_SIZE];
34*10465441SEvalZero     struct rt_messagequeue hid_mq;
35*10465441SEvalZero };
36*10465441SEvalZero 
37*10465441SEvalZero /* CustomHID_ConfigDescriptor */
38*10465441SEvalZero ALIGN(4)
39*10465441SEvalZero const rt_uint8_t _report_desc[]=
40*10465441SEvalZero {
41*10465441SEvalZero #ifdef RT_USB_DEVICE_HID_KEYBOARD
42*10465441SEvalZero     USAGE_PAGE(1),      0x01,
43*10465441SEvalZero     USAGE(1),           0x06,
44*10465441SEvalZero     COLLECTION(1),      0x01,
45*10465441SEvalZero     REPORT_ID(1),       HID_REPORT_ID_KEYBOARD1,
46*10465441SEvalZero 
47*10465441SEvalZero     USAGE_PAGE(1),      0x07,
48*10465441SEvalZero     USAGE_MINIMUM(1),   0xE0,
49*10465441SEvalZero     USAGE_MAXIMUM(1),   0xE7,
50*10465441SEvalZero     LOGICAL_MINIMUM(1), 0x00,
51*10465441SEvalZero     LOGICAL_MAXIMUM(1), 0x01,
52*10465441SEvalZero     REPORT_SIZE(1),     0x01,
53*10465441SEvalZero     REPORT_COUNT(1),    0x08,
54*10465441SEvalZero     INPUT(1),           0x02,
55*10465441SEvalZero     REPORT_COUNT(1),    0x01,
56*10465441SEvalZero     REPORT_SIZE(1),     0x08,
57*10465441SEvalZero     INPUT(1),           0x01,
58*10465441SEvalZero 
59*10465441SEvalZero 
60*10465441SEvalZero     REPORT_COUNT(1),    0x05,
61*10465441SEvalZero     REPORT_SIZE(1),     0x01,
62*10465441SEvalZero     USAGE_PAGE(1),      0x08,
63*10465441SEvalZero     USAGE_MINIMUM(1),   0x01,
64*10465441SEvalZero     USAGE_MAXIMUM(1),   0x05,
65*10465441SEvalZero     OUTPUT(1),          0x02,
66*10465441SEvalZero     REPORT_COUNT(1),    0x01,
67*10465441SEvalZero     REPORT_SIZE(1),     0x03,
68*10465441SEvalZero     OUTPUT(1),          0x01,
69*10465441SEvalZero 
70*10465441SEvalZero 
71*10465441SEvalZero     REPORT_COUNT(1),    0x06,
72*10465441SEvalZero     REPORT_SIZE(1),     0x08,
73*10465441SEvalZero     LOGICAL_MINIMUM(1), 0x00,
74*10465441SEvalZero     LOGICAL_MAXIMUM(1), 0x65,
75*10465441SEvalZero     USAGE_PAGE(1),      0x07,
76*10465441SEvalZero     USAGE_MINIMUM(1),   0x00,
77*10465441SEvalZero     USAGE_MAXIMUM(1),   0x65,
78*10465441SEvalZero     INPUT(1),           0x00,
79*10465441SEvalZero     END_COLLECTION(0),
80*10465441SEvalZero #if RT_USB_DEVICE_HID_KEYBOARD_NUMBER>1
81*10465441SEvalZero     /****keyboard2*****/
82*10465441SEvalZero     USAGE_PAGE(1),      0x01,
83*10465441SEvalZero     USAGE(1),           0x06,
84*10465441SEvalZero     COLLECTION(1),      0x01,
85*10465441SEvalZero     REPORT_ID(1),       HID_REPORT_ID_KEYBOARD2,
86*10465441SEvalZero 
87*10465441SEvalZero     USAGE_PAGE(1),      0x07,
88*10465441SEvalZero     USAGE_MINIMUM(1),   0xE0,
89*10465441SEvalZero     USAGE_MAXIMUM(1),   0xE7,
90*10465441SEvalZero     LOGICAL_MINIMUM(1), 0x00,
91*10465441SEvalZero     LOGICAL_MAXIMUM(1), 0x01,
92*10465441SEvalZero     REPORT_SIZE(1),     0x01,
93*10465441SEvalZero     REPORT_COUNT(1),    0x08,
94*10465441SEvalZero     INPUT(1),           0x02,
95*10465441SEvalZero     REPORT_COUNT(1),    0x01,
96*10465441SEvalZero     REPORT_SIZE(1),     0x08,
97*10465441SEvalZero     INPUT(1),           0x01,
98*10465441SEvalZero 
99*10465441SEvalZero     REPORT_COUNT(1),    0x06,
100*10465441SEvalZero     REPORT_SIZE(1),     0x08,
101*10465441SEvalZero     LOGICAL_MINIMUM(1), 0x00,
102*10465441SEvalZero     LOGICAL_MAXIMUM(1), 0x65,
103*10465441SEvalZero     USAGE_PAGE(1),      0x07,
104*10465441SEvalZero     USAGE_MINIMUM(1),   0x00,
105*10465441SEvalZero     USAGE_MAXIMUM(1),   0x65,
106*10465441SEvalZero     INPUT(1),           0x00,
107*10465441SEvalZero     END_COLLECTION(0),
108*10465441SEvalZero #if RT_USB_DEVICE_HID_KEYBOARD_NUMBER>2
109*10465441SEvalZero     USAGE_PAGE(1),      0x01,
110*10465441SEvalZero     USAGE(1),           0x06,
111*10465441SEvalZero     COLLECTION(1),      0x01,
112*10465441SEvalZero     REPORT_ID(1),       HID_REPORT_ID_KEYBOARD3,
113*10465441SEvalZero 
114*10465441SEvalZero     USAGE_PAGE(1),      0x07,
115*10465441SEvalZero     USAGE_MINIMUM(1),   0xE0,
116*10465441SEvalZero     USAGE_MAXIMUM(1),   0xE7,
117*10465441SEvalZero     LOGICAL_MINIMUM(1), 0x00,
118*10465441SEvalZero     LOGICAL_MAXIMUM(1), 0x01,
119*10465441SEvalZero     REPORT_SIZE(1),     0x01,
120*10465441SEvalZero     REPORT_COUNT(1),    0x08,
121*10465441SEvalZero     INPUT(1),           0x02,
122*10465441SEvalZero     REPORT_COUNT(1),    0x01,
123*10465441SEvalZero     REPORT_SIZE(1),     0x08,
124*10465441SEvalZero     INPUT(1),           0x01,
125*10465441SEvalZero 
126*10465441SEvalZero     REPORT_COUNT(1),    0x06,
127*10465441SEvalZero     REPORT_SIZE(1),     0x08,
128*10465441SEvalZero     LOGICAL_MINIMUM(1), 0x00,
129*10465441SEvalZero     LOGICAL_MAXIMUM(1), 0x65,
130*10465441SEvalZero     USAGE_PAGE(1),      0x07,
131*10465441SEvalZero     USAGE_MINIMUM(1),   0x00,
132*10465441SEvalZero     USAGE_MAXIMUM(1),   0x65,
133*10465441SEvalZero     INPUT(1),           0x00,
134*10465441SEvalZero     END_COLLECTION(0),
135*10465441SEvalZero #if RT_USB_DEVICE_HID_KEYBOARD_NUMBER>3
136*10465441SEvalZero     USAGE_PAGE(1),      0x01,
137*10465441SEvalZero     USAGE(1),           0x06,
138*10465441SEvalZero     COLLECTION(1),      0x01,
139*10465441SEvalZero     REPORT_ID(1),       HID_REPORT_ID_KEYBOARD4,
140*10465441SEvalZero 
141*10465441SEvalZero     USAGE_PAGE(1),      0x07,
142*10465441SEvalZero     USAGE_MINIMUM(1),   0xE0,
143*10465441SEvalZero     USAGE_MAXIMUM(1),   0xE7,
144*10465441SEvalZero     LOGICAL_MINIMUM(1), 0x00,
145*10465441SEvalZero     LOGICAL_MAXIMUM(1), 0x01,
146*10465441SEvalZero     REPORT_SIZE(1),     0x01,
147*10465441SEvalZero     REPORT_COUNT(1),    0x08,
148*10465441SEvalZero     INPUT(1),           0x02,
149*10465441SEvalZero     REPORT_COUNT(1),    0x01,
150*10465441SEvalZero     REPORT_SIZE(1),     0x08,
151*10465441SEvalZero     INPUT(1),           0x01,
152*10465441SEvalZero 
153*10465441SEvalZero     REPORT_COUNT(1),    0x06,
154*10465441SEvalZero     REPORT_SIZE(1),     0x08,
155*10465441SEvalZero     LOGICAL_MINIMUM(1), 0x00,
156*10465441SEvalZero     LOGICAL_MAXIMUM(1), 0x65,
157*10465441SEvalZero     USAGE_PAGE(1),      0x07,
158*10465441SEvalZero     USAGE_MINIMUM(1),   0x00,
159*10465441SEvalZero     USAGE_MAXIMUM(1),   0x65,
160*10465441SEvalZero     INPUT(1),           0x00,
161*10465441SEvalZero     END_COLLECTION(0),
162*10465441SEvalZero #endif
163*10465441SEvalZero #endif
164*10465441SEvalZero #endif
165*10465441SEvalZero #endif
166*10465441SEvalZero     // Media Control
167*10465441SEvalZero #ifdef RT_USB_DEVICE_HID_MEDIA
168*10465441SEvalZero     USAGE_PAGE(1),      0x0C,
169*10465441SEvalZero     USAGE(1),           0x01,
170*10465441SEvalZero     COLLECTION(1),      0x01,
171*10465441SEvalZero     REPORT_ID(1),       HID_REPORT_ID_MEDIA,
172*10465441SEvalZero     USAGE_PAGE(1),      0x0C,
173*10465441SEvalZero     LOGICAL_MINIMUM(1), 0x00,
174*10465441SEvalZero     LOGICAL_MAXIMUM(1), 0x01,
175*10465441SEvalZero     REPORT_SIZE(1),     0x01,
176*10465441SEvalZero     REPORT_COUNT(1),    0x07,
177*10465441SEvalZero     USAGE(1),           0xB5,             // Next Track
178*10465441SEvalZero     USAGE(1),           0xB6,             // Previous Track
179*10465441SEvalZero     USAGE(1),           0xB7,             // Stop
180*10465441SEvalZero     USAGE(1),           0xCD,             // Play / Pause
181*10465441SEvalZero     USAGE(1),           0xE2,             // Mute
182*10465441SEvalZero     USAGE(1),           0xE9,             // Volume Up
183*10465441SEvalZero     USAGE(1),           0xEA,             // Volume Down
184*10465441SEvalZero     INPUT(1),           0x02,             // Input (Data, Variable, Absolute)
185*10465441SEvalZero     REPORT_COUNT(1),    0x01,
186*10465441SEvalZero     INPUT(1),           0x01,
187*10465441SEvalZero     END_COLLECTION(0),
188*10465441SEvalZero #endif
189*10465441SEvalZero 
190*10465441SEvalZero #ifdef RT_USB_DEVICE_HID_GENERAL
191*10465441SEvalZero     USAGE_PAGE(1),      0x8c,
192*10465441SEvalZero     USAGE(1),           0x01,
193*10465441SEvalZero     COLLECTION(1),      0x01,
194*10465441SEvalZero     REPORT_ID(1),       HID_REPORT_ID_GENERAL,
195*10465441SEvalZero 
196*10465441SEvalZero     REPORT_COUNT(1),    RT_USB_DEVICE_HID_GENERAL_IN_REPORT_LENGTH,
197*10465441SEvalZero     USAGE(1),           0x03,
198*10465441SEvalZero     REPORT_SIZE(1),     0x08,
199*10465441SEvalZero     LOGICAL_MINIMUM(1), 0x00,
200*10465441SEvalZero     LOGICAL_MAXIMUM(1), 0xFF,
201*10465441SEvalZero     INPUT(1),           0x02,
202*10465441SEvalZero 
203*10465441SEvalZero     REPORT_COUNT(1),    RT_USB_DEVICE_HID_GENERAL_OUT_REPORT_LENGTH,
204*10465441SEvalZero     USAGE(1),           0x04,
205*10465441SEvalZero     REPORT_SIZE(1),     0x08,
206*10465441SEvalZero     LOGICAL_MINIMUM(1), 0x00,
207*10465441SEvalZero     LOGICAL_MAXIMUM(1), 0xFF,
208*10465441SEvalZero     OUTPUT(1),          0x02,
209*10465441SEvalZero     END_COLLECTION(0),
210*10465441SEvalZero #endif
211*10465441SEvalZero #ifdef RT_USB_DEVICE_HID_MOUSE
212*10465441SEvalZero     USAGE_PAGE(1),      0x01,           // Generic Desktop
213*10465441SEvalZero     USAGE(1),           0x02,           // Mouse
214*10465441SEvalZero     COLLECTION(1),      0x01,           // Application
215*10465441SEvalZero     USAGE(1),           0x01,           // Pointer
216*10465441SEvalZero     COLLECTION(1),      0x00,           // Physical
217*10465441SEvalZero     REPORT_ID(1),       HID_REPORT_ID_MOUSE,
218*10465441SEvalZero     REPORT_COUNT(1),    0x03,
219*10465441SEvalZero     REPORT_SIZE(1),     0x01,
220*10465441SEvalZero     USAGE_PAGE(1),      0x09,           // Buttons
221*10465441SEvalZero     USAGE_MINIMUM(1),   0x1,
222*10465441SEvalZero     USAGE_MAXIMUM(1),   0x3,
223*10465441SEvalZero     LOGICAL_MINIMUM(1), 0x00,
224*10465441SEvalZero     LOGICAL_MAXIMUM(1), 0x01,
225*10465441SEvalZero     INPUT(1),           0x02,
226*10465441SEvalZero     REPORT_COUNT(1),    0x01,
227*10465441SEvalZero     REPORT_SIZE(1),     0x05,
228*10465441SEvalZero     INPUT(1),           0x01,
229*10465441SEvalZero     REPORT_COUNT(1),    0x03,
230*10465441SEvalZero     REPORT_SIZE(1),     0x08,
231*10465441SEvalZero     USAGE_PAGE(1),      0x01,
232*10465441SEvalZero     USAGE(1),           0x30,           // X
233*10465441SEvalZero     USAGE(1),           0x31,           // Y
234*10465441SEvalZero     USAGE(1),           0x38,           // scroll
235*10465441SEvalZero     LOGICAL_MINIMUM(1), 0x81,
236*10465441SEvalZero     LOGICAL_MAXIMUM(1), 0x7f,
237*10465441SEvalZero     INPUT(1),           0x06,
238*10465441SEvalZero     END_COLLECTION(0),
239*10465441SEvalZero     END_COLLECTION(0),
240*10465441SEvalZero #endif
241*10465441SEvalZero }; /* CustomHID_ReportDescriptor */
242*10465441SEvalZero 
243*10465441SEvalZero ALIGN(4)
244*10465441SEvalZero static struct udevice_descriptor _dev_desc =
245*10465441SEvalZero {
246*10465441SEvalZero     USB_DESC_LENGTH_DEVICE,     //bLength;
247*10465441SEvalZero     USB_DESC_TYPE_DEVICE,       //type;
248*10465441SEvalZero     USB_BCD_VERSION,            //bcdUSB;
249*10465441SEvalZero     USB_CLASS_HID,              //bDeviceClass;
250*10465441SEvalZero     0x00,                       //bDeviceSubClass;
251*10465441SEvalZero     0x00,                       //bDeviceProtocol;
252*10465441SEvalZero     64,                         //bMaxPacketSize0;
253*10465441SEvalZero     _VENDOR_ID,                 //idVendor;
254*10465441SEvalZero     _PRODUCT_ID,                //idProduct;
255*10465441SEvalZero     USB_BCD_DEVICE,             //bcdDevice;
256*10465441SEvalZero     USB_STRING_MANU_INDEX,      //iManufacturer;
257*10465441SEvalZero     USB_STRING_PRODUCT_INDEX,   //iProduct;
258*10465441SEvalZero     USB_STRING_SERIAL_INDEX,    //iSerialNumber;
259*10465441SEvalZero     USB_DYNAMIC,                //bNumConfigurations;
260*10465441SEvalZero };
261*10465441SEvalZero 
262*10465441SEvalZero //FS and HS needed
263*10465441SEvalZero ALIGN(4)
264*10465441SEvalZero static struct usb_qualifier_descriptor dev_qualifier =
265*10465441SEvalZero {
266*10465441SEvalZero     sizeof(dev_qualifier),          //bLength
267*10465441SEvalZero     USB_DESC_TYPE_DEVICEQUALIFIER,  //bDescriptorType
268*10465441SEvalZero     0x0200,                         //bcdUSB
269*10465441SEvalZero     USB_CLASS_MASS_STORAGE,         //bDeviceClass
270*10465441SEvalZero     0x06,                           //bDeviceSubClass
271*10465441SEvalZero     0x50,                           //bDeviceProtocol
272*10465441SEvalZero     64,                             //bMaxPacketSize0
273*10465441SEvalZero     0x01,                           //bNumConfigurations
274*10465441SEvalZero     0,
275*10465441SEvalZero };
276*10465441SEvalZero 
277*10465441SEvalZero 
278*10465441SEvalZero /* hid interface descriptor */
279*10465441SEvalZero ALIGN(4)
280*10465441SEvalZero const static struct uhid_comm_descriptor _hid_comm_desc =
281*10465441SEvalZero {
282*10465441SEvalZero #ifdef RT_USB_DEVICE_COMPOSITE
283*10465441SEvalZero     /* Interface Association Descriptor */
284*10465441SEvalZero     {
285*10465441SEvalZero         USB_DESC_LENGTH_IAD,
286*10465441SEvalZero         USB_DESC_TYPE_IAD,
287*10465441SEvalZero         USB_DYNAMIC,
288*10465441SEvalZero         0x01,
289*10465441SEvalZero         0x03,                       /* bInterfaceClass: HID */
290*10465441SEvalZero #if defined(RT_USB_DEVICE_HID_KEYBOARD)||defined(RT_USB_DEVICE_HID_MOUSE)
291*10465441SEvalZero         USB_HID_SUBCLASS_BOOT,    /* bInterfaceSubClass : 1=BOOT, 0=no boot */
292*10465441SEvalZero #else
293*10465441SEvalZero         USB_HID_SUBCLASS_NOBOOT,    /* bInterfaceSubClass : 1=BOOT, 0=no boot */
294*10465441SEvalZero #endif
295*10465441SEvalZero #if !defined(RT_USB_DEVICE_HID_KEYBOARD)||!defined(RT_USB_DEVICE_HID_MOUSE)||!defined(RT_USB_DEVICE_HID_MEDIA)
296*10465441SEvalZero         USB_HID_PROTOCOL_NONE,      /* nInterfaceProtocol : 0=none, 1=keyboard, 2=mouse */
297*10465441SEvalZero #elif !defined(RT_USB_DEVICE_HID_MOUSE)
298*10465441SEvalZero         USB_HID_PROTOCOL_KEYBOARD,  /* nInterfaceProtocol : 0=none, 1=keyboard, 2=mouse */
299*10465441SEvalZero #else
300*10465441SEvalZero         USB_HID_PROTOCOL_MOUSE,     /* nInterfaceProtocol : 0=none, 1=keyboard, 2=mouse */
301*10465441SEvalZero #endif
302*10465441SEvalZero         0x00,
303*10465441SEvalZero     },
304*10465441SEvalZero #endif
305*10465441SEvalZero     /* Interface Descriptor */
306*10465441SEvalZero     {
307*10465441SEvalZero         USB_DESC_LENGTH_INTERFACE,
308*10465441SEvalZero         USB_DESC_TYPE_INTERFACE,
309*10465441SEvalZero         USB_DYNAMIC,                /* bInterfaceNumber: Number of Interface */
310*10465441SEvalZero         0x00,                       /* bAlternateSetting: Alternate setting */
311*10465441SEvalZero         0x02,                       /* bNumEndpoints */
312*10465441SEvalZero         0x03,                       /* bInterfaceClass: HID */
313*10465441SEvalZero #if defined(RT_USB_DEVICE_HID_KEYBOARD)||defined(RT_USB_DEVICE_HID_MOUSE)
314*10465441SEvalZero         USB_HID_SUBCLASS_BOOT,    /* bInterfaceSubClass : 1=BOOT, 0=no boot */
315*10465441SEvalZero #else
316*10465441SEvalZero         USB_HID_SUBCLASS_NOBOOT,    /* bInterfaceSubClass : 1=BOOT, 0=no boot */
317*10465441SEvalZero #endif
318*10465441SEvalZero #if !defined(RT_USB_DEVICE_HID_KEYBOARD)||!defined(RT_USB_DEVICE_HID_MOUSE)||!defined(RT_USB_DEVICE_HID_MEDIA)
319*10465441SEvalZero         USB_HID_PROTOCOL_NONE,      /* nInterfaceProtocol : 0=none, 1=keyboard, 2=mouse */
320*10465441SEvalZero #elif !defined(RT_USB_DEVICE_HID_MOUSE)
321*10465441SEvalZero         USB_HID_PROTOCOL_KEYBOARD,  /* nInterfaceProtocol : 0=none, 1=keyboard, 2=mouse */
322*10465441SEvalZero #else
323*10465441SEvalZero         USB_HID_PROTOCOL_MOUSE,     /* nInterfaceProtocol : 0=none, 1=keyboard, 2=mouse */
324*10465441SEvalZero #endif
325*10465441SEvalZero         0,                          /* iInterface: Index of string descriptor */
326*10465441SEvalZero     },
327*10465441SEvalZero 
328*10465441SEvalZero     /* HID Descriptor */
329*10465441SEvalZero     {
330*10465441SEvalZero         HID_DESCRIPTOR_SIZE,        /* bLength: HID Descriptor size */
331*10465441SEvalZero         HID_DESCRIPTOR_TYPE,        /* bDescriptorType: HID */
332*10465441SEvalZero         0x0110,                     /* bcdHID: HID Class Spec release number */
333*10465441SEvalZero         0x00,                       /* bCountryCode: Hardware target country */
334*10465441SEvalZero         0x01,                       /* bNumDescriptors: Number of HID class descriptors to follow */
335*10465441SEvalZero         {
336*10465441SEvalZero             {
337*10465441SEvalZero                 0x22,                       /* bDescriptorType */
338*10465441SEvalZero                 sizeof(_report_desc),       /* wItemLength: Total length of Report descriptor */
339*10465441SEvalZero             },
340*10465441SEvalZero         },
341*10465441SEvalZero     },
342*10465441SEvalZero 
343*10465441SEvalZero     /* Endpoint Descriptor IN */
344*10465441SEvalZero     {
345*10465441SEvalZero         USB_DESC_LENGTH_ENDPOINT,
346*10465441SEvalZero         USB_DESC_TYPE_ENDPOINT,
347*10465441SEvalZero         USB_DYNAMIC | USB_DIR_IN,
348*10465441SEvalZero         USB_EP_ATTR_INT,
349*10465441SEvalZero         0x40,
350*10465441SEvalZero         0x01,
351*10465441SEvalZero     },
352*10465441SEvalZero 
353*10465441SEvalZero     /* Endpoint Descriptor OUT */
354*10465441SEvalZero     {
355*10465441SEvalZero         USB_DESC_LENGTH_ENDPOINT,
356*10465441SEvalZero         USB_DESC_TYPE_ENDPOINT,
357*10465441SEvalZero         USB_DYNAMIC | USB_DIR_OUT,
358*10465441SEvalZero         USB_EP_ATTR_INT,
359*10465441SEvalZero         0x40,
360*10465441SEvalZero         0x01,
361*10465441SEvalZero     },
362*10465441SEvalZero };
363*10465441SEvalZero 
364*10465441SEvalZero ALIGN(4)
365*10465441SEvalZero const static char* _ustring[] =
366*10465441SEvalZero {
367*10465441SEvalZero     "Language",
368*10465441SEvalZero     "RT-Thread Team.",
369*10465441SEvalZero     "RTT HID-Device",
370*10465441SEvalZero     "32021919830108",
371*10465441SEvalZero     "Configuration",
372*10465441SEvalZero     "Interface",
373*10465441SEvalZero };
374*10465441SEvalZero 
dump_data(uint8_t * data,rt_size_t size)375*10465441SEvalZero static void dump_data(uint8_t *data, rt_size_t size)
376*10465441SEvalZero {
377*10465441SEvalZero     rt_size_t i;
378*10465441SEvalZero     for (i = 0; i < size; i++)
379*10465441SEvalZero     {
380*10465441SEvalZero         rt_kprintf("%02x ", *data++);
381*10465441SEvalZero         if ((i + 1) % 8 == 0)
382*10465441SEvalZero         {
383*10465441SEvalZero             rt_kprintf("\n");
384*10465441SEvalZero         }else if ((i + 1) % 4 == 0){
385*10465441SEvalZero             rt_kprintf(" ");
386*10465441SEvalZero         }
387*10465441SEvalZero     }
388*10465441SEvalZero }
dump_report(struct hid_report * report)389*10465441SEvalZero static void dump_report(struct hid_report * report)
390*10465441SEvalZero {
391*10465441SEvalZero     rt_kprintf("\nHID Recived:");
392*10465441SEvalZero     rt_kprintf("\nReport ID %02x \n", report->report_id);
393*10465441SEvalZero     dump_data(report->report,report->size);
394*10465441SEvalZero }
395*10465441SEvalZero 
_ep_out_handler(ufunction_t func,rt_size_t size)396*10465441SEvalZero static rt_err_t _ep_out_handler(ufunction_t func, rt_size_t size)
397*10465441SEvalZero {
398*10465441SEvalZero     struct hid_s *data;
399*10465441SEvalZero     struct hid_report report;
400*10465441SEvalZero     RT_ASSERT(func != RT_NULL);
401*10465441SEvalZero     RT_ASSERT(func->device != RT_NULL);
402*10465441SEvalZero     data = (struct hid_s *) func->user_data;
403*10465441SEvalZero 
404*10465441SEvalZero     if(size != 0)
405*10465441SEvalZero     {
406*10465441SEvalZero         rt_memcpy((void *)&report,(void*)data->ep_out->buffer,size);
407*10465441SEvalZero         report.size = size-1;
408*10465441SEvalZero         rt_mq_send(&data->hid_mq,(void *)&report,sizeof(report));
409*10465441SEvalZero     }
410*10465441SEvalZero 
411*10465441SEvalZero     data->ep_out->request.buffer = data->ep_out->buffer;
412*10465441SEvalZero     data->ep_out->request.size = EP_MAXPACKET(data->ep_out);
413*10465441SEvalZero     data->ep_out->request.req_type = UIO_REQUEST_READ_BEST;
414*10465441SEvalZero     rt_usbd_io_request(func->device, data->ep_out, &data->ep_out->request);
415*10465441SEvalZero     return RT_EOK;
416*10465441SEvalZero }
417*10465441SEvalZero 
_ep_in_handler(ufunction_t func,rt_size_t size)418*10465441SEvalZero static rt_err_t _ep_in_handler(ufunction_t func, rt_size_t size)
419*10465441SEvalZero {
420*10465441SEvalZero     struct hid_s *data;
421*10465441SEvalZero     RT_ASSERT(func != RT_NULL);
422*10465441SEvalZero     RT_ASSERT(func->device != RT_NULL);
423*10465441SEvalZero 
424*10465441SEvalZero     data = (struct hid_s *) func->user_data;
425*10465441SEvalZero     if(data->parent.tx_complete != RT_NULL)
426*10465441SEvalZero     {
427*10465441SEvalZero         data->parent.tx_complete(&data->parent,RT_NULL);
428*10465441SEvalZero     }
429*10465441SEvalZero     return RT_EOK;
430*10465441SEvalZero }
431*10465441SEvalZero 
_hid_set_report_callback(udevice_t device,rt_size_t size)432*10465441SEvalZero static rt_err_t _hid_set_report_callback(udevice_t device, rt_size_t size)
433*10465441SEvalZero {
434*10465441SEvalZero     RT_DEBUG_LOG(RT_DEBUG_USB, ("_hid_set_report_callback\n"));
435*10465441SEvalZero 
436*10465441SEvalZero     if(size != 0)
437*10465441SEvalZero     {
438*10465441SEvalZero     }
439*10465441SEvalZero 
440*10465441SEvalZero     dcd_ep0_send_status(device->dcd);
441*10465441SEvalZero 
442*10465441SEvalZero     return RT_EOK;
443*10465441SEvalZero }
444*10465441SEvalZero 
445*10465441SEvalZero /**
446*10465441SEvalZero  * This function will handle hid interface bRequest.
447*10465441SEvalZero  *
448*10465441SEvalZero  * @param device the usb device object.
449*10465441SEvalZero  * @param setup the setup bRequest.
450*10465441SEvalZero  *
451*10465441SEvalZero  * @return RT_EOK on successful.
452*10465441SEvalZero  */
_interface_handler(ufunction_t func,ureq_t setup)453*10465441SEvalZero static rt_err_t _interface_handler(ufunction_t func, ureq_t setup)
454*10465441SEvalZero {
455*10465441SEvalZero     RT_ASSERT(func != RT_NULL);
456*10465441SEvalZero     RT_ASSERT(func->device != RT_NULL);
457*10465441SEvalZero     RT_ASSERT(setup != RT_NULL);
458*10465441SEvalZero 
459*10465441SEvalZero     struct hid_s *data = (struct hid_s *) func->user_data;
460*10465441SEvalZero 
461*10465441SEvalZero     if(setup->wIndex != 0)
462*10465441SEvalZero         return -RT_EIO;
463*10465441SEvalZero 
464*10465441SEvalZero     switch (setup->bRequest)
465*10465441SEvalZero     {
466*10465441SEvalZero     case USB_REQ_GET_DESCRIPTOR:
467*10465441SEvalZero         if((setup->wValue >> 8) == USB_DESC_TYPE_REPORT)
468*10465441SEvalZero         {
469*10465441SEvalZero             rt_usbd_ep0_write(func->device, (void *)(&_report_desc[0]), sizeof(_report_desc));
470*10465441SEvalZero         }
471*10465441SEvalZero         else if((setup->wValue >> 8) == USB_DESC_TYPE_HID)
472*10465441SEvalZero         {
473*10465441SEvalZero 
474*10465441SEvalZero             rt_usbd_ep0_write(func->device, (void *)(&_hid_comm_desc.hid_desc), sizeof(struct uhid_descriptor));
475*10465441SEvalZero         }
476*10465441SEvalZero         break;
477*10465441SEvalZero     case USB_HID_REQ_GET_REPORT:
478*10465441SEvalZero         if(setup->wLength == 0)
479*10465441SEvalZero         {
480*10465441SEvalZero             rt_usbd_ep0_set_stall(func->device);
481*10465441SEvalZero             break;
482*10465441SEvalZero         }
483*10465441SEvalZero         if((setup->wLength == 0) || (setup->wLength > MAX_REPORT_SIZE))
484*10465441SEvalZero             setup->wLength = MAX_REPORT_SIZE;
485*10465441SEvalZero         rt_usbd_ep0_write(func->device, data->report_buf,setup->wLength);
486*10465441SEvalZero         break;
487*10465441SEvalZero     case USB_HID_REQ_GET_IDLE:
488*10465441SEvalZero 
489*10465441SEvalZero         dcd_ep0_send_status(func->device->dcd);
490*10465441SEvalZero         break;
491*10465441SEvalZero     case USB_HID_REQ_GET_PROTOCOL:
492*10465441SEvalZero         rt_usbd_ep0_write(func->device, &data->protocol,2);
493*10465441SEvalZero         break;
494*10465441SEvalZero     case USB_HID_REQ_SET_REPORT:
495*10465441SEvalZero 
496*10465441SEvalZero         if((setup->wLength == 0) || (setup->wLength > MAX_REPORT_SIZE))
497*10465441SEvalZero             rt_usbd_ep0_set_stall(func->device);
498*10465441SEvalZero 
499*10465441SEvalZero         rt_usbd_ep0_read(func->device, data->report_buf, setup->wLength, _hid_set_report_callback);
500*10465441SEvalZero         break;
501*10465441SEvalZero     case USB_HID_REQ_SET_IDLE:
502*10465441SEvalZero         dcd_ep0_send_status(func->device->dcd);
503*10465441SEvalZero         break;
504*10465441SEvalZero     case USB_HID_REQ_SET_PROTOCOL:
505*10465441SEvalZero         data->protocol = setup->wValue;
506*10465441SEvalZero 
507*10465441SEvalZero         dcd_ep0_send_status(func->device->dcd);
508*10465441SEvalZero         break;
509*10465441SEvalZero     }
510*10465441SEvalZero 
511*10465441SEvalZero     return RT_EOK;
512*10465441SEvalZero }
513*10465441SEvalZero 
514*10465441SEvalZero 
515*10465441SEvalZero /**
516*10465441SEvalZero  * This function will run cdc function, it will be called on handle set configuration bRequest.
517*10465441SEvalZero  *
518*10465441SEvalZero  * @param func the usb function object.
519*10465441SEvalZero  *
520*10465441SEvalZero  * @return RT_EOK on successful.
521*10465441SEvalZero  */
_function_enable(ufunction_t func)522*10465441SEvalZero static rt_err_t _function_enable(ufunction_t func)
523*10465441SEvalZero {
524*10465441SEvalZero     struct hid_s *data;
525*10465441SEvalZero 
526*10465441SEvalZero     RT_ASSERT(func != RT_NULL);
527*10465441SEvalZero     RT_ASSERT(func->device != RT_NULL);
528*10465441SEvalZero     data = (struct hid_s *) func->user_data;
529*10465441SEvalZero 
530*10465441SEvalZero     RT_DEBUG_LOG(RT_DEBUG_USB, ("hid function enable\n"));
531*10465441SEvalZero //
532*10465441SEvalZero //    _vcom_reset_state(func);
533*10465441SEvalZero //
534*10465441SEvalZero     if(data->ep_out->buffer == RT_NULL)
535*10465441SEvalZero     {
536*10465441SEvalZero         data->ep_out->buffer        = rt_malloc(HID_RX_BUFSIZE);
537*10465441SEvalZero     }
538*10465441SEvalZero     data->ep_out->request.buffer    = data->ep_out->buffer;
539*10465441SEvalZero     data->ep_out->request.size      = EP_MAXPACKET(data->ep_out);
540*10465441SEvalZero     data->ep_out->request.req_type  = UIO_REQUEST_READ_BEST;
541*10465441SEvalZero 
542*10465441SEvalZero     rt_usbd_io_request(func->device, data->ep_out, &data->ep_out->request);
543*10465441SEvalZero 
544*10465441SEvalZero     return RT_EOK;
545*10465441SEvalZero }
546*10465441SEvalZero 
547*10465441SEvalZero /**
548*10465441SEvalZero  * This function will stop cdc function, it will be called on handle set configuration bRequest.
549*10465441SEvalZero  *
550*10465441SEvalZero  * @param func the usb function object.
551*10465441SEvalZero  *
552*10465441SEvalZero  * @return RT_EOK on successful.
553*10465441SEvalZero  */
_function_disable(ufunction_t func)554*10465441SEvalZero static rt_err_t _function_disable(ufunction_t func)
555*10465441SEvalZero {
556*10465441SEvalZero     struct hid_s *data;
557*10465441SEvalZero 
558*10465441SEvalZero     RT_ASSERT(func != RT_NULL);
559*10465441SEvalZero     RT_ASSERT(func->device != RT_NULL);
560*10465441SEvalZero     data = (struct hid_s *) func->user_data;
561*10465441SEvalZero 
562*10465441SEvalZero     RT_DEBUG_LOG(RT_DEBUG_USB, ("hid function disable\n"));
563*10465441SEvalZero 
564*10465441SEvalZero     if(data->ep_out->buffer != RT_NULL)
565*10465441SEvalZero     {
566*10465441SEvalZero         rt_free(data->ep_out->buffer);
567*10465441SEvalZero         data->ep_out->buffer = RT_NULL;
568*10465441SEvalZero     }
569*10465441SEvalZero 
570*10465441SEvalZero     return RT_EOK;
571*10465441SEvalZero }
572*10465441SEvalZero 
573*10465441SEvalZero static struct ufunction_ops ops =
574*10465441SEvalZero {
575*10465441SEvalZero     _function_enable,
576*10465441SEvalZero     _function_disable,
577*10465441SEvalZero     RT_NULL,
578*10465441SEvalZero };
579*10465441SEvalZero 
580*10465441SEvalZero 
581*10465441SEvalZero 
582*10465441SEvalZero 
583*10465441SEvalZero /**
584*10465441SEvalZero  * This function will configure hid descriptor.
585*10465441SEvalZero  *
586*10465441SEvalZero  * @param comm the communication interface number.
587*10465441SEvalZero  * @param data the data interface number.
588*10465441SEvalZero  *
589*10465441SEvalZero  * @return RT_EOK on successful.
590*10465441SEvalZero  */
_hid_descriptor_config(uhid_comm_desc_t hid,rt_uint8_t cintf_nr)591*10465441SEvalZero static rt_err_t _hid_descriptor_config(uhid_comm_desc_t hid, rt_uint8_t cintf_nr)
592*10465441SEvalZero {
593*10465441SEvalZero #ifdef RT_USB_DEVICE_COMPOSITE
594*10465441SEvalZero     hid->iad_desc.bFirstInterface = cintf_nr;
595*10465441SEvalZero #endif
596*10465441SEvalZero 
597*10465441SEvalZero     return RT_EOK;
598*10465441SEvalZero }
_hid_write(rt_device_t dev,rt_off_t pos,const void * buffer,rt_size_t size)599*10465441SEvalZero static rt_size_t _hid_write(rt_device_t dev, rt_off_t pos, const void *buffer, rt_size_t size)
600*10465441SEvalZero {
601*10465441SEvalZero     struct hid_s *hiddev = (struct hid_s *)dev;
602*10465441SEvalZero     struct hid_report report;
603*10465441SEvalZero     if (hiddev->func->device->state == USB_STATE_CONFIGURED)
604*10465441SEvalZero     {
605*10465441SEvalZero         report.report_id = pos;
606*10465441SEvalZero         rt_memcpy((void *)report.report,(void *)buffer,size);
607*10465441SEvalZero         report.size = size;
608*10465441SEvalZero         hiddev->ep_in->request.buffer = (void *)&report;
609*10465441SEvalZero         hiddev->ep_in->request.size = (size+1) > 64 ? 64 : size+1;
610*10465441SEvalZero         hiddev->ep_in->request.req_type = UIO_REQUEST_WRITE;
611*10465441SEvalZero         rt_usbd_io_request(hiddev->func->device, hiddev->ep_in, &hiddev->ep_in->request);
612*10465441SEvalZero         return size;
613*10465441SEvalZero     }
614*10465441SEvalZero 
615*10465441SEvalZero     return 0;
616*10465441SEvalZero }
HID_Report_Received(hid_report_t report)617*10465441SEvalZero RT_WEAK void HID_Report_Received(hid_report_t report)
618*10465441SEvalZero {
619*10465441SEvalZero     dump_report(report);
620*10465441SEvalZero }
621*10465441SEvalZero ALIGN(RT_ALIGN_SIZE)
622*10465441SEvalZero static rt_uint8_t hid_thread_stack[512];
623*10465441SEvalZero static struct rt_thread hid_thread;
624*10465441SEvalZero 
hid_thread_entry(void * parameter)625*10465441SEvalZero static void hid_thread_entry(void* parameter)
626*10465441SEvalZero {
627*10465441SEvalZero     struct hid_report report;
628*10465441SEvalZero     struct hid_s *hiddev;
629*10465441SEvalZero     hiddev = (struct hid_s *)parameter;
630*10465441SEvalZero 	while(1)
631*10465441SEvalZero 	{
632*10465441SEvalZero 		if(rt_mq_recv(&hiddev->hid_mq, &report, sizeof(report),RT_WAITING_FOREVER) != RT_EOK )
633*10465441SEvalZero             continue;
634*10465441SEvalZero 		HID_Report_Received(&report);
635*10465441SEvalZero 	}
636*10465441SEvalZero }
637*10465441SEvalZero 
638*10465441SEvalZero #ifdef RT_USING_DEVICE_OPS
639*10465441SEvalZero const static struct rt_device_ops hid_device_ops =
640*10465441SEvalZero {
641*10465441SEvalZero     RT_NULL,
642*10465441SEvalZero     RT_NULL,
643*10465441SEvalZero     RT_NULL,
644*10465441SEvalZero     RT_NULL,
645*10465441SEvalZero     _hid_write,
646*10465441SEvalZero     RT_NULL,
647*10465441SEvalZero };
648*10465441SEvalZero #endif
649*10465441SEvalZero 
650*10465441SEvalZero static rt_uint8_t hid_mq_pool[(sizeof(struct hid_report)+sizeof(void*))*8];
rt_usb_hid_init(struct ufunction * func)651*10465441SEvalZero static void rt_usb_hid_init(struct ufunction *func)
652*10465441SEvalZero {
653*10465441SEvalZero     struct hid_s *hiddev;
654*10465441SEvalZero     hiddev = (struct hid_s *)func->user_data;
655*10465441SEvalZero     rt_memset(&hiddev->parent, 0, sizeof(hiddev->parent));
656*10465441SEvalZero 
657*10465441SEvalZero #ifdef RT_USING_DEVICE_OPS
658*10465441SEvalZero     hiddev->parent.ops   = &hid_device_ops;
659*10465441SEvalZero #else
660*10465441SEvalZero     hiddev->parent.write = _hid_write;
661*10465441SEvalZero #endif
662*10465441SEvalZero     hiddev->func = func;
663*10465441SEvalZero 
664*10465441SEvalZero     rt_device_register(&hiddev->parent, "hidd", RT_DEVICE_FLAG_RDWR);
665*10465441SEvalZero     rt_mq_init(&hiddev->hid_mq, "hiddmq", hid_mq_pool, sizeof(struct hid_report),
666*10465441SEvalZero                             sizeof(hid_mq_pool), RT_IPC_FLAG_FIFO);
667*10465441SEvalZero 
668*10465441SEvalZero     rt_thread_init(&hid_thread, "hidd", hid_thread_entry, hiddev,
669*10465441SEvalZero             hid_thread_stack, sizeof(hid_thread_stack), RT_USBD_THREAD_PRIO, 20);
670*10465441SEvalZero     rt_thread_startup(&hid_thread);
671*10465441SEvalZero }
672*10465441SEvalZero 
673*10465441SEvalZero 
674*10465441SEvalZero /**
675*10465441SEvalZero  * This function will create a hid function instance.
676*10465441SEvalZero  *
677*10465441SEvalZero  * @param device the usb device object.
678*10465441SEvalZero  *
679*10465441SEvalZero  * @return RT_EOK on successful.
680*10465441SEvalZero  */
rt_usbd_function_hid_create(udevice_t device)681*10465441SEvalZero ufunction_t rt_usbd_function_hid_create(udevice_t device)
682*10465441SEvalZero {
683*10465441SEvalZero     ufunction_t     func;
684*10465441SEvalZero     struct hid_s   *data;
685*10465441SEvalZero 
686*10465441SEvalZero     uintf_t         hid_intf;
687*10465441SEvalZero     ualtsetting_t   hid_setting;
688*10465441SEvalZero     uhid_comm_desc_t hid_desc;
689*10465441SEvalZero 
690*10465441SEvalZero     /* parameter check */
691*10465441SEvalZero     RT_ASSERT(device != RT_NULL);
692*10465441SEvalZero 
693*10465441SEvalZero     /* set usb device string description */
694*10465441SEvalZero     rt_usbd_device_set_string(device, _ustring);
695*10465441SEvalZero 
696*10465441SEvalZero     /* create a cdc function */
697*10465441SEvalZero     func = rt_usbd_function_new(device, &_dev_desc, &ops);
698*10465441SEvalZero     //not support hs
699*10465441SEvalZero     //rt_usbd_device_set_qualifier(device, &_dev_qualifier);
700*10465441SEvalZero 
701*10465441SEvalZero     /* allocate memory for cdc vcom data */
702*10465441SEvalZero     data = (struct hid_s*)rt_malloc(sizeof(struct hid_s));
703*10465441SEvalZero     rt_memset(data, 0, sizeof(struct hid_s));
704*10465441SEvalZero     func->user_data = (void*)data;
705*10465441SEvalZero 
706*10465441SEvalZero     /* create an interface object */
707*10465441SEvalZero     hid_intf = rt_usbd_interface_new(device, _interface_handler);
708*10465441SEvalZero 
709*10465441SEvalZero     /* create an alternate setting object */
710*10465441SEvalZero     hid_setting = rt_usbd_altsetting_new(sizeof(struct uhid_comm_descriptor));
711*10465441SEvalZero 
712*10465441SEvalZero     /* config desc in alternate setting */
713*10465441SEvalZero     rt_usbd_altsetting_config_descriptor(hid_setting, &_hid_comm_desc, (rt_off_t)&((uhid_comm_desc_t)0)->intf_desc);
714*10465441SEvalZero 
715*10465441SEvalZero     /* configure the hid interface descriptor */
716*10465441SEvalZero     _hid_descriptor_config(hid_setting->desc, hid_intf->intf_num);
717*10465441SEvalZero 
718*10465441SEvalZero     /* create endpoint */
719*10465441SEvalZero     hid_desc = (uhid_comm_desc_t)hid_setting->desc;
720*10465441SEvalZero     data->ep_out = rt_usbd_endpoint_new(&hid_desc->ep_out_desc, _ep_out_handler);
721*10465441SEvalZero     data->ep_in  = rt_usbd_endpoint_new(&hid_desc->ep_in_desc, _ep_in_handler);
722*10465441SEvalZero 
723*10465441SEvalZero     /* add the int out and int in endpoint to the alternate setting */
724*10465441SEvalZero     rt_usbd_altsetting_add_endpoint(hid_setting, data->ep_out);
725*10465441SEvalZero     rt_usbd_altsetting_add_endpoint(hid_setting, data->ep_in);
726*10465441SEvalZero 
727*10465441SEvalZero     /* add the alternate setting to the interface, then set default setting */
728*10465441SEvalZero     rt_usbd_interface_add_altsetting(hid_intf, hid_setting);
729*10465441SEvalZero     rt_usbd_set_altsetting(hid_intf, 0);
730*10465441SEvalZero 
731*10465441SEvalZero     /* add the interface to the mass storage function */
732*10465441SEvalZero     rt_usbd_function_add_interface(func, hid_intf);
733*10465441SEvalZero 
734*10465441SEvalZero     /* initilize hid */
735*10465441SEvalZero     rt_usb_hid_init(func);
736*10465441SEvalZero     return func;
737*10465441SEvalZero }
738*10465441SEvalZero struct udclass hid_class =
739*10465441SEvalZero {
740*10465441SEvalZero     .rt_usbd_function_create = rt_usbd_function_hid_create
741*10465441SEvalZero };
742*10465441SEvalZero 
rt_usbd_hid_class_register(void)743*10465441SEvalZero int rt_usbd_hid_class_register(void)
744*10465441SEvalZero {
745*10465441SEvalZero     rt_usbd_class_register(&hid_class);
746*10465441SEvalZero     return 0;
747*10465441SEvalZero }
748*10465441SEvalZero INIT_PREV_EXPORT(rt_usbd_hid_class_register);
749*10465441SEvalZero #endif /* RT_USB_DEVICE_HID */
750