Add svn:eol-style property to source files, so that the line endings are correctly...
[pub/USBasp.git] / LUFA / Drivers / USB / Class / Host / HID.c
index 24dcceb..f7292d7 100644 (file)
-/*\r
-             LUFA Library\r
-     Copyright (C) Dean Camera, 2010.\r
-              \r
-  dean [at] fourwalledcubicle [dot] com\r
-      www.fourwalledcubicle.com\r
-*/\r
-\r
-/*\r
-  Copyright 2010  Dean Camera (dean [at] fourwalledcubicle [dot] com)\r
-\r
-  Permission to use, copy, modify, distribute, and sell this \r
-  software and its documentation for any purpose is hereby granted\r
-  without fee, provided that the above copyright notice appear in \r
-  all copies and that both that the copyright notice and this\r
-  permission notice and warranty disclaimer appear in supporting \r
-  documentation, and that the name of the author not be used in \r
-  advertising or publicity pertaining to distribution of the \r
-  software without specific, written prior permission.\r
-\r
-  The author disclaim all warranties with regard to this\r
-  software, including all implied warranties of merchantability\r
-  and fitness.  In no event shall the author be liable for any\r
-  special, indirect or consequential damages or any damages\r
-  whatsoever resulting from loss of use, data or profits, whether\r
-  in an action of contract, negligence or other tortious action,\r
-  arising out of or in connection with the use or performance of\r
-  this software.\r
-*/\r
-\r
-#define  __INCLUDE_FROM_USB_DRIVER\r
-#include "../../HighLevel/USBMode.h"\r
-#if defined(USB_CAN_BE_HOST)\r
-\r
-#define  __INCLUDE_FROM_HID_CLASS_HOST_C\r
-#define  __INCLUDE_FROM_HID_DRIVER\r
-#include "HID.h"\r
-\r
-uint8_t HID_Host_ConfigurePipes(USB_ClassInfo_HID_Host_t* const HIDInterfaceInfo, uint16_t ConfigDescriptorSize,\r
-                                void* ConfigDescriptorData)\r
-{\r
-       uint8_t FoundEndpoints = 0;\r
-\r
-       memset(&HIDInterfaceInfo->State, 0x00, sizeof(HIDInterfaceInfo->State));\r
-\r
-       if (DESCRIPTOR_TYPE(ConfigDescriptorData) != DTYPE_Configuration)\r
-         return HID_ENUMERROR_InvalidConfigDescriptor;\r
-       \r
-       USB_Descriptor_Interface_t* CurrentHIDInterface;\r
-       \r
-       do\r
-       {\r
-               if (USB_GetNextDescriptorComp(&ConfigDescriptorSize, &ConfigDescriptorData,\r
-                                                                         DComp_HID_Host_NextHIDInterface) != DESCRIPTOR_SEARCH_COMP_Found)\r
-               {\r
-                       return HID_ENUMERROR_NoHIDInterfaceFound;\r
-               }\r
-               \r
-               CurrentHIDInterface = DESCRIPTOR_PCAST(ConfigDescriptorData, USB_Descriptor_Interface_t);\r
-       } while (HIDInterfaceInfo->Config.HIDInterfaceProtocol &&\r
-                (CurrentHIDInterface->Protocol != HIDInterfaceInfo->Config.HIDInterfaceProtocol));\r
-\r
-       HIDInterfaceInfo->State.InterfaceNumber      = CurrentHIDInterface->InterfaceNumber;\r
-       HIDInterfaceInfo->State.SupportsBootProtocol = (CurrentHIDInterface->SubClass != HID_NON_BOOT_PROTOCOL);\r
-\r
-       if (USB_GetNextDescriptorComp(&ConfigDescriptorSize, &ConfigDescriptorData, DComp_NextHID) != DESCRIPTOR_SEARCH_COMP_Found)\r
-       {\r
-               return HID_ENUMERROR_NoHIDDescriptorFound;\r
-       }\r
-\r
-       HIDInterfaceInfo->State.HIDReportSize = DESCRIPTOR_CAST(ConfigDescriptorData, USB_HID_Descriptor_t).HIDReportLength;\r
-\r
-       while (FoundEndpoints != (HID_FOUND_DATAPIPE_IN | HID_FOUND_DATAPIPE_OUT))\r
-       {\r
-               if (USB_GetNextDescriptorComp(&ConfigDescriptorSize, &ConfigDescriptorData,\r
-                                             DComp_HID_Host_NextHIDInterfaceEndpoint) != DESCRIPTOR_SEARCH_COMP_Found)\r
-               {\r
-                       if (FoundEndpoints & HID_FOUND_DATAPIPE_IN)\r
-                         break;\r
-                               \r
-                       return HID_ENUMERROR_EndpointsNotFound;\r
-               }\r
-               \r
-               USB_Descriptor_Endpoint_t* EndpointData = DESCRIPTOR_PCAST(ConfigDescriptorData, USB_Descriptor_Endpoint_t);\r
-\r
-               if (EndpointData->EndpointAddress & ENDPOINT_DESCRIPTOR_DIR_IN)\r
-               {\r
-                       Pipe_ConfigurePipe(HIDInterfaceInfo->Config.DataINPipeNumber, EP_TYPE_INTERRUPT, PIPE_TOKEN_IN,\r
-                                                          EndpointData->EndpointAddress, EndpointData->EndpointSize,\r
-                                                          HIDInterfaceInfo->Config.DataINPipeDoubleBank ? PIPE_BANK_DOUBLE : PIPE_BANK_SINGLE);\r
-                       HIDInterfaceInfo->State.DataINPipeSize = EndpointData->EndpointSize;\r
-                       \r
-                       FoundEndpoints |= HID_FOUND_DATAPIPE_IN;\r
-               }\r
-               else\r
-               {\r
-                       Pipe_ConfigurePipe(HIDInterfaceInfo->Config.DataOUTPipeNumber, EP_TYPE_INTERRUPT, PIPE_TOKEN_OUT,\r
-                                                          EndpointData->EndpointAddress, EndpointData->EndpointSize,\r
-                                                          HIDInterfaceInfo->Config.DataOUTPipeDoubleBank ? PIPE_BANK_DOUBLE : PIPE_BANK_SINGLE);\r
-                       HIDInterfaceInfo->State.DataOUTPipeSize = EndpointData->EndpointSize;\r
-                       \r
-                       HIDInterfaceInfo->State.DeviceUsesOUTPipe = true;\r
-                       \r
-                       FoundEndpoints |= HID_FOUND_DATAPIPE_OUT;               \r
-               }\r
-       }\r
-\r
-       HIDInterfaceInfo->State.LargestReportSize = 8;\r
-       HIDInterfaceInfo->State.IsActive = true;\r
-       return HID_ENUMERROR_NoError;\r
-}\r
-\r
-static uint8_t DComp_HID_Host_NextHIDInterface(void* const CurrentDescriptor)\r
-{\r
-       if (DESCRIPTOR_TYPE(CurrentDescriptor) == DTYPE_Interface)\r
-       {\r
-               USB_Descriptor_Interface_t* CurrentInterface = DESCRIPTOR_PCAST(CurrentDescriptor,\r
-                                                                               USB_Descriptor_Interface_t);\r
-       \r
-               if (CurrentInterface->Class == HID_INTERFACE_CLASS)\r
-                 return DESCRIPTOR_SEARCH_Found;\r
-       }\r
-       \r
-       return DESCRIPTOR_SEARCH_NotFound;\r
-}\r
-\r
-static uint8_t DComp_NextHID(void* const CurrentDescriptor)\r
-{\r
-       if (DESCRIPTOR_TYPE(CurrentDescriptor) == DTYPE_HID)\r
-         return DESCRIPTOR_SEARCH_Found;\r
-       else if (DESCRIPTOR_TYPE(CurrentDescriptor) == DTYPE_Interface)\r
-         return DESCRIPTOR_SEARCH_Fail;\r
-       else\r
-         return DESCRIPTOR_SEARCH_NotFound;      \r
-}\r
-\r
-static uint8_t DComp_HID_Host_NextHIDInterfaceEndpoint(void* const CurrentDescriptor)\r
-{\r
-       if (DESCRIPTOR_TYPE(CurrentDescriptor) == DTYPE_Endpoint)\r
-       {\r
-               USB_Descriptor_Endpoint_t* CurrentEndpoint = DESCRIPTOR_PCAST(CurrentDescriptor,\r
-                                                                             USB_Descriptor_Endpoint_t);       \r
-\r
-               if (!(Pipe_IsEndpointBound(CurrentEndpoint->EndpointAddress)))\r
-                 return DESCRIPTOR_SEARCH_Found;\r
-       }\r
-       else if (DESCRIPTOR_TYPE(CurrentDescriptor) == DTYPE_Interface)\r
-       {\r
-               return DESCRIPTOR_SEARCH_Fail;\r
-       }\r
-\r
-       return DESCRIPTOR_SEARCH_NotFound;\r
-}\r
-\r
-#if !defined(HID_HOST_BOOT_PROTOCOL_ONLY)\r
-uint8_t HID_Host_ReceiveReportByID(USB_ClassInfo_HID_Host_t* const HIDInterfaceInfo, const uint8_t ReportID, void* Buffer)\r
-{\r
-       USB_ControlRequest = (USB_Request_Header_t)\r
-       {\r
-               .bmRequestType = (REQDIR_HOSTTODEVICE | REQTYPE_CLASS | REQREC_INTERFACE),\r
-               .bRequest      = REQ_SetReport,\r
-               .wValue        = ((REPORT_ITEM_TYPE_In + 1) << 8) | ReportID,\r
-               .wIndex        = HIDInterfaceInfo->State.InterfaceNumber,\r
-               .wLength       = USB_GetHIDReportSize(HIDInterfaceInfo->Config.HIDParserData, ReportID, REPORT_ITEM_TYPE_In),\r
-       };\r
-\r
-       Pipe_SelectPipe(PIPE_CONTROLPIPE);\r
-       \r
-       return USB_Host_SendControlRequest(Buffer);\r
-}                                                                                         \r
-#endif\r
-                                                                                  \r
-uint8_t HID_Host_ReceiveReport(USB_ClassInfo_HID_Host_t* const HIDInterfaceInfo, void* Buffer)\r
-{\r
-       if ((USB_HostState != HOST_STATE_Configured) || !(HIDInterfaceInfo->State.IsActive))\r
-         return PIPE_READYWAIT_DeviceDisconnected;\r
-\r
-       uint8_t ErrorCode;\r
-\r
-       Pipe_SelectPipe(HIDInterfaceInfo->Config.DataINPipeNumber);\r
-       Pipe_Unfreeze();\r
-       \r
-       uint16_t ReportSize;\r
-       uint8_t* BufferPos = Buffer;\r
-\r
-#if !defined(HID_HOST_BOOT_PROTOCOL_ONLY)\r
-       if (!(HIDInterfaceInfo->State.UsingBootProtocol))\r
-       {\r
-               uint8_t ReportID = 0;\r
-       \r
-               if (HIDInterfaceInfo->Config.HIDParserData->UsingReportIDs)\r
-               {\r
-                       ReportID = Pipe_Read_Byte();\r
-                       *(BufferPos++) = ReportID;\r
-               }\r
-               \r
-               ReportSize = USB_GetHIDReportSize(HIDInterfaceInfo->Config.HIDParserData, ReportID, REPORT_ITEM_TYPE_In);\r
-       }\r
-       else\r
-#endif\r
-       {\r
-               ReportSize = Pipe_BytesInPipe();\r
-       }\r
-\r
-       if ((ErrorCode = Pipe_Read_Stream_LE(BufferPos, ReportSize, NO_STREAM_CALLBACK)) != PIPE_RWSTREAM_NoError)\r
-         return ErrorCode;\r
-        \r
-       Pipe_ClearIN();         \r
-       Pipe_Freeze();\r
-       \r
-       return PIPE_RWSTREAM_NoError;\r
-}\r
-\r
-uint8_t HID_Host_SendReportByID(USB_ClassInfo_HID_Host_t* const HIDInterfaceInfo,\r
-#if !defined(HID_HOST_BOOT_PROTOCOL_ONLY)\r
-                                const uint8_t ReportID,\r
-#endif\r
-                                void* Buffer, const uint16_t ReportSize)\r
-{\r
-#if !defined(HID_HOST_BOOT_PROTOCOL_ONLY)\r
-       if ((USB_HostState != HOST_STATE_Configured) || !(HIDInterfaceInfo->State.IsActive))\r
-         return false;\r
-\r
-       if (HIDInterfaceInfo->State.DeviceUsesOUTPipe)\r
-       {\r
-               uint8_t ErrorCode;\r
-       \r
-               Pipe_SelectPipe(HIDInterfaceInfo->Config.DataOUTPipeNumber);\r
-               Pipe_Unfreeze();\r
-               \r
-               if (ReportID)\r
-                 Pipe_Write_Stream_LE(&ReportID, sizeof(ReportID), NO_STREAM_CALLBACK);\r
-               \r
-               if ((ErrorCode = Pipe_Write_Stream_LE(Buffer, ReportSize, NO_STREAM_CALLBACK)) != PIPE_RWSTREAM_NoError)\r
-                 return ErrorCode;\r
-               \r
-               Pipe_ClearOUT();\r
-               Pipe_Freeze();\r
-               \r
-               return PIPE_RWSTREAM_NoError;\r
-       }\r
-       else\r
-#endif\r
-       {\r
-               USB_ControlRequest = (USB_Request_Header_t)\r
-               {\r
-                       .bmRequestType = (REQDIR_HOSTTODEVICE | REQTYPE_CLASS | REQREC_INTERFACE),\r
-                       .bRequest      = REQ_SetReport,\r
-#if !defined(HID_HOST_BOOT_PROTOCOL_ONLY)\r
-                       .wValue        = ((REPORT_ITEM_TYPE_Out + 1) << 8) | ReportID,\r
-#else\r
-                       .wValue        = ((REPORT_ITEM_TYPE_Out + 1) << 8),\r
-#endif\r
-                       .wIndex        = HIDInterfaceInfo->State.InterfaceNumber,\r
-                       .wLength       = ReportSize,\r
-               };\r
-\r
-               Pipe_SelectPipe(PIPE_CONTROLPIPE);\r
-               \r
-               return USB_Host_SendControlRequest(Buffer);\r
-       }\r
-}\r
-\r
-bool HID_Host_IsReportReceived(USB_ClassInfo_HID_Host_t* const HIDInterfaceInfo)\r
-{\r
-       if ((USB_HostState != HOST_STATE_Configured) || !(HIDInterfaceInfo->State.IsActive))\r
-         return false;\r
-\r
-       bool ReportReceived;\r
-\r
-       Pipe_SelectPipe(HIDInterfaceInfo->Config.DataINPipeNumber);\r
-       Pipe_Unfreeze();\r
-       \r
-       ReportReceived = Pipe_IsINReceived();\r
-       \r
-       Pipe_Freeze();\r
-       \r
-       return ReportReceived;\r
-}\r
-\r
-uint8_t HID_Host_SetBootProtocol(USB_ClassInfo_HID_Host_t* const HIDInterfaceInfo)\r
-{\r
-       uint8_t ErrorCode;\r
-\r
-       USB_ControlRequest = (USB_Request_Header_t)\r
-               {\r
-                       .bmRequestType = (REQDIR_HOSTTODEVICE | REQTYPE_CLASS | REQREC_INTERFACE),\r
-                       .bRequest      = REQ_SetProtocol,\r
-                       .wValue        = 0,\r
-                       .wIndex        = HIDInterfaceInfo->State.InterfaceNumber,\r
-                       .wLength       = 0,\r
-               };\r
-\r
-       Pipe_SelectPipe(PIPE_CONTROLPIPE);\r
-       \r
-       if (!(HIDInterfaceInfo->State.SupportsBootProtocol))\r
-         return HID_ERROR_LOGICAL;\r
-\r
-       if ((ErrorCode = USB_Host_SendControlRequest(NULL)) != HOST_SENDCONTROL_Successful)\r
-         return ErrorCode;\r
-\r
-       HIDInterfaceInfo->State.LargestReportSize = 8;\r
-       HIDInterfaceInfo->State.UsingBootProtocol = true;\r
-       \r
-       return HOST_SENDCONTROL_Successful;\r
-}\r
-\r
-#if !defined(HID_HOST_BOOT_PROTOCOL_ONLY)\r
-uint8_t HID_Host_SetReportProtocol(USB_ClassInfo_HID_Host_t* const HIDInterfaceInfo)\r
-{\r
-       uint8_t ErrorCode;\r
-\r
-       uint8_t HIDReportData[HIDInterfaceInfo->State.HIDReportSize];\r
-       \r
-       USB_ControlRequest = (USB_Request_Header_t)\r
-               {\r
-                       .bmRequestType = (REQDIR_DEVICETOHOST | REQTYPE_STANDARD | REQREC_INTERFACE),\r
-                       .bRequest      = REQ_GetDescriptor,\r
-                       .wValue        = (DTYPE_Report << 8),\r
-                       .wIndex        = HIDInterfaceInfo->State.InterfaceNumber,\r
-                       .wLength       = HIDInterfaceInfo->State.HIDReportSize,\r
-               };\r
-\r
-       Pipe_SelectPipe(PIPE_CONTROLPIPE);\r
-\r
-       if ((ErrorCode = USB_Host_SendControlRequest(HIDReportData)) != HOST_SENDCONTROL_Successful)\r
-         return ErrorCode;\r
-         \r
-       if (HIDInterfaceInfo->State.UsingBootProtocol)\r
-       {\r
-               USB_ControlRequest = (USB_Request_Header_t)\r
-                       {\r
-                               .bmRequestType = (REQDIR_HOSTTODEVICE | REQTYPE_CLASS | REQREC_INTERFACE),\r
-                               .bRequest      = REQ_SetProtocol,\r
-                               .wValue        = 1,\r
-                               .wIndex        = HIDInterfaceInfo->State.InterfaceNumber,\r
-                               .wLength       = 0,\r
-                       };\r
-\r
-               if ((ErrorCode = USB_Host_SendControlRequest(NULL)) != HOST_SENDCONTROL_Successful)\r
-                 return ErrorCode;\r
-\r
-               HIDInterfaceInfo->State.UsingBootProtocol = false;\r
-       }\r
-       \r
-       if (HIDInterfaceInfo->Config.HIDParserData == NULL)\r
-         return HID_ERROR_LOGICAL;\r
-               \r
-       if ((ErrorCode = USB_ProcessHIDReport(HIDReportData, HIDInterfaceInfo->State.HIDReportSize,\r
-                                             HIDInterfaceInfo->Config.HIDParserData)) != HID_PARSE_Successful)\r
-       {\r
-               return HID_ERROR_LOGICAL | ErrorCode;\r
-       }\r
-\r
-       uint8_t LargestReportSizeBits = HIDInterfaceInfo->Config.HIDParserData->LargestReportSizeBits;\r
-       HIDInterfaceInfo->State.LargestReportSize = (LargestReportSizeBits >> 3) + ((LargestReportSizeBits & 0x07) != 0);\r
-\r
-       return 0;\r
-}\r
-#endif\r
-\r
-#endif\r
+/*
+             LUFA Library
+     Copyright (C) Dean Camera, 2010.
+              
+  dean [at] fourwalledcubicle [dot] com
+      www.fourwalledcubicle.com
+*/
+
+/*
+  Copyright 2010  Dean Camera (dean [at] fourwalledcubicle [dot] com)
+
+  Permission to use, copy, modify, distribute, and sell this 
+  software and its documentation for any purpose is hereby granted
+  without fee, provided that the above copyright notice appear in 
+  all copies and that both that the copyright notice and this
+  permission notice and warranty disclaimer appear in supporting 
+  documentation, and that the name of the author not be used in 
+  advertising or publicity pertaining to distribution of the 
+  software without specific, written prior permission.
+
+  The author disclaim all warranties with regard to this
+  software, including all implied warranties of merchantability
+  and fitness.  In no event shall the author be liable for any
+  special, indirect or consequential damages or any damages
+  whatsoever resulting from loss of use, data or profits, whether
+  in an action of contract, negligence or other tortious action,
+  arising out of or in connection with the use or performance of
+  this software.
+*/
+
+#define  __INCLUDE_FROM_USB_DRIVER
+#include "../../HighLevel/USBMode.h"
+#if defined(USB_CAN_BE_HOST)
+
+#define  __INCLUDE_FROM_HID_CLASS_HOST_C
+#define  __INCLUDE_FROM_HID_DRIVER
+#include "HID.h"
+
+uint8_t HID_Host_ConfigurePipes(USB_ClassInfo_HID_Host_t* const HIDInterfaceInfo, uint16_t ConfigDescriptorSize,
+                                void* ConfigDescriptorData)
+{
+       uint8_t FoundEndpoints = 0;
+
+       memset(&HIDInterfaceInfo->State, 0x00, sizeof(HIDInterfaceInfo->State));
+
+       if (DESCRIPTOR_TYPE(ConfigDescriptorData) != DTYPE_Configuration)
+         return HID_ENUMERROR_InvalidConfigDescriptor;
+       
+       USB_Descriptor_Interface_t* CurrentHIDInterface;
+       
+       do
+       {
+               if (USB_GetNextDescriptorComp(&ConfigDescriptorSize, &ConfigDescriptorData,
+                                                                         DComp_HID_Host_NextHIDInterface) != DESCRIPTOR_SEARCH_COMP_Found)
+               {
+                       return HID_ENUMERROR_NoHIDInterfaceFound;
+               }
+               
+               CurrentHIDInterface = DESCRIPTOR_PCAST(ConfigDescriptorData, USB_Descriptor_Interface_t);
+       } while (HIDInterfaceInfo->Config.HIDInterfaceProtocol &&
+                (CurrentHIDInterface->Protocol != HIDInterfaceInfo->Config.HIDInterfaceProtocol));
+
+       HIDInterfaceInfo->State.InterfaceNumber      = CurrentHIDInterface->InterfaceNumber;
+       HIDInterfaceInfo->State.SupportsBootProtocol = (CurrentHIDInterface->SubClass != HID_NON_BOOT_PROTOCOL);
+
+       if (USB_GetNextDescriptorComp(&ConfigDescriptorSize, &ConfigDescriptorData, DComp_NextHID) != DESCRIPTOR_SEARCH_COMP_Found)
+       {
+               return HID_ENUMERROR_NoHIDDescriptorFound;
+       }
+
+       HIDInterfaceInfo->State.HIDReportSize = DESCRIPTOR_CAST(ConfigDescriptorData, USB_HID_Descriptor_t).HIDReportLength;
+
+       while (FoundEndpoints != (HID_FOUND_DATAPIPE_IN | HID_FOUND_DATAPIPE_OUT))
+       {
+               if (USB_GetNextDescriptorComp(&ConfigDescriptorSize, &ConfigDescriptorData,
+                                             DComp_HID_Host_NextHIDInterfaceEndpoint) != DESCRIPTOR_SEARCH_COMP_Found)
+               {
+                       if (FoundEndpoints & HID_FOUND_DATAPIPE_IN)
+                         break;
+                               
+                       return HID_ENUMERROR_EndpointsNotFound;
+               }
+               
+               USB_Descriptor_Endpoint_t* EndpointData = DESCRIPTOR_PCAST(ConfigDescriptorData, USB_Descriptor_Endpoint_t);
+
+               if (EndpointData->EndpointAddress & ENDPOINT_DESCRIPTOR_DIR_IN)
+               {
+                       Pipe_ConfigurePipe(HIDInterfaceInfo->Config.DataINPipeNumber, EP_TYPE_INTERRUPT, PIPE_TOKEN_IN,
+                                                          EndpointData->EndpointAddress, EndpointData->EndpointSize,
+                                                          HIDInterfaceInfo->Config.DataINPipeDoubleBank ? PIPE_BANK_DOUBLE : PIPE_BANK_SINGLE);
+                       HIDInterfaceInfo->State.DataINPipeSize = EndpointData->EndpointSize;
+                       
+                       FoundEndpoints |= HID_FOUND_DATAPIPE_IN;
+               }
+               else
+               {
+                       Pipe_ConfigurePipe(HIDInterfaceInfo->Config.DataOUTPipeNumber, EP_TYPE_INTERRUPT, PIPE_TOKEN_OUT,
+                                                          EndpointData->EndpointAddress, EndpointData->EndpointSize,
+                                                          HIDInterfaceInfo->Config.DataOUTPipeDoubleBank ? PIPE_BANK_DOUBLE : PIPE_BANK_SINGLE);
+                       HIDInterfaceInfo->State.DataOUTPipeSize = EndpointData->EndpointSize;
+                       
+                       HIDInterfaceInfo->State.DeviceUsesOUTPipe = true;
+                       
+                       FoundEndpoints |= HID_FOUND_DATAPIPE_OUT;               
+               }
+       }
+
+       HIDInterfaceInfo->State.LargestReportSize = 8;
+       HIDInterfaceInfo->State.IsActive = true;
+       return HID_ENUMERROR_NoError;
+}
+
+static uint8_t DComp_HID_Host_NextHIDInterface(void* const CurrentDescriptor)
+{
+       if (DESCRIPTOR_TYPE(CurrentDescriptor) == DTYPE_Interface)
+       {
+               USB_Descriptor_Interface_t* CurrentInterface = DESCRIPTOR_PCAST(CurrentDescriptor,
+                                                                               USB_Descriptor_Interface_t);
+       
+               if (CurrentInterface->Class == HID_INTERFACE_CLASS)
+                 return DESCRIPTOR_SEARCH_Found;
+       }
+       
+       return DESCRIPTOR_SEARCH_NotFound;
+}
+
+static uint8_t DComp_NextHID(void* const CurrentDescriptor)
+{
+       if (DESCRIPTOR_TYPE(CurrentDescriptor) == DTYPE_HID)
+         return DESCRIPTOR_SEARCH_Found;
+       else if (DESCRIPTOR_TYPE(CurrentDescriptor) == DTYPE_Interface)
+         return DESCRIPTOR_SEARCH_Fail;
+       else
+         return DESCRIPTOR_SEARCH_NotFound;      
+}
+
+static uint8_t DComp_HID_Host_NextHIDInterfaceEndpoint(void* const CurrentDescriptor)
+{
+       if (DESCRIPTOR_TYPE(CurrentDescriptor) == DTYPE_Endpoint)
+       {
+               USB_Descriptor_Endpoint_t* CurrentEndpoint = DESCRIPTOR_PCAST(CurrentDescriptor,
+                                                                             USB_Descriptor_Endpoint_t);       
+
+               if (!(Pipe_IsEndpointBound(CurrentEndpoint->EndpointAddress)))
+                 return DESCRIPTOR_SEARCH_Found;
+       }
+       else if (DESCRIPTOR_TYPE(CurrentDescriptor) == DTYPE_Interface)
+       {
+               return DESCRIPTOR_SEARCH_Fail;
+       }
+
+       return DESCRIPTOR_SEARCH_NotFound;
+}
+
+#if !defined(HID_HOST_BOOT_PROTOCOL_ONLY)
+uint8_t HID_Host_ReceiveReportByID(USB_ClassInfo_HID_Host_t* const HIDInterfaceInfo, const uint8_t ReportID, void* Buffer)
+{
+       USB_ControlRequest = (USB_Request_Header_t)
+       {
+               .bmRequestType = (REQDIR_HOSTTODEVICE | REQTYPE_CLASS | REQREC_INTERFACE),
+               .bRequest      = REQ_SetReport,
+               .wValue        = ((REPORT_ITEM_TYPE_In + 1) << 8) | ReportID,
+               .wIndex        = HIDInterfaceInfo->State.InterfaceNumber,
+               .wLength       = USB_GetHIDReportSize(HIDInterfaceInfo->Config.HIDParserData, ReportID, REPORT_ITEM_TYPE_In),
+       };
+
+       Pipe_SelectPipe(PIPE_CONTROLPIPE);
+       
+       return USB_Host_SendControlRequest(Buffer);
+}                                                                                         
+#endif
+                                                                                  
+uint8_t HID_Host_ReceiveReport(USB_ClassInfo_HID_Host_t* const HIDInterfaceInfo, void* Buffer)
+{
+       if ((USB_HostState != HOST_STATE_Configured) || !(HIDInterfaceInfo->State.IsActive))
+         return PIPE_READYWAIT_DeviceDisconnected;
+
+       uint8_t ErrorCode;
+
+       Pipe_SelectPipe(HIDInterfaceInfo->Config.DataINPipeNumber);
+       Pipe_Unfreeze();
+       
+       uint16_t ReportSize;
+       uint8_t* BufferPos = Buffer;
+
+#if !defined(HID_HOST_BOOT_PROTOCOL_ONLY)
+       if (!(HIDInterfaceInfo->State.UsingBootProtocol))
+       {
+               uint8_t ReportID = 0;
+       
+               if (HIDInterfaceInfo->Config.HIDParserData->UsingReportIDs)
+               {
+                       ReportID = Pipe_Read_Byte();
+                       *(BufferPos++) = ReportID;
+               }
+               
+               ReportSize = USB_GetHIDReportSize(HIDInterfaceInfo->Config.HIDParserData, ReportID, REPORT_ITEM_TYPE_In);
+       }
+       else
+#endif
+       {
+               ReportSize = Pipe_BytesInPipe();
+       }
+
+       if ((ErrorCode = Pipe_Read_Stream_LE(BufferPos, ReportSize, NO_STREAM_CALLBACK)) != PIPE_RWSTREAM_NoError)
+         return ErrorCode;
+        
+       Pipe_ClearIN();         
+       Pipe_Freeze();
+       
+       return PIPE_RWSTREAM_NoError;
+}
+
+uint8_t HID_Host_SendReportByID(USB_ClassInfo_HID_Host_t* const HIDInterfaceInfo,
+#if !defined(HID_HOST_BOOT_PROTOCOL_ONLY)
+                                const uint8_t ReportID,
+#endif
+                                void* Buffer, const uint16_t ReportSize)
+{
+#if !defined(HID_HOST_BOOT_PROTOCOL_ONLY)
+       if ((USB_HostState != HOST_STATE_Configured) || !(HIDInterfaceInfo->State.IsActive))
+         return false;
+
+       if (HIDInterfaceInfo->State.DeviceUsesOUTPipe)
+       {
+               uint8_t ErrorCode;
+       
+               Pipe_SelectPipe(HIDInterfaceInfo->Config.DataOUTPipeNumber);
+               Pipe_Unfreeze();
+               
+               if (ReportID)
+                 Pipe_Write_Stream_LE(&ReportID, sizeof(ReportID), NO_STREAM_CALLBACK);
+               
+               if ((ErrorCode = Pipe_Write_Stream_LE(Buffer, ReportSize, NO_STREAM_CALLBACK)) != PIPE_RWSTREAM_NoError)
+                 return ErrorCode;
+               
+               Pipe_ClearOUT();
+               Pipe_Freeze();
+               
+               return PIPE_RWSTREAM_NoError;
+       }
+       else
+#endif
+       {
+               USB_ControlRequest = (USB_Request_Header_t)
+               {
+                       .bmRequestType = (REQDIR_HOSTTODEVICE | REQTYPE_CLASS | REQREC_INTERFACE),
+                       .bRequest      = REQ_SetReport,
+#if !defined(HID_HOST_BOOT_PROTOCOL_ONLY)
+                       .wValue        = ((REPORT_ITEM_TYPE_Out + 1) << 8) | ReportID,
+#else
+                       .wValue        = ((REPORT_ITEM_TYPE_Out + 1) << 8),
+#endif
+                       .wIndex        = HIDInterfaceInfo->State.InterfaceNumber,
+                       .wLength       = ReportSize,
+               };
+
+               Pipe_SelectPipe(PIPE_CONTROLPIPE);
+               
+               return USB_Host_SendControlRequest(Buffer);
+       }
+}
+
+bool HID_Host_IsReportReceived(USB_ClassInfo_HID_Host_t* const HIDInterfaceInfo)
+{
+       if ((USB_HostState != HOST_STATE_Configured) || !(HIDInterfaceInfo->State.IsActive))
+         return false;
+
+       bool ReportReceived;
+
+       Pipe_SelectPipe(HIDInterfaceInfo->Config.DataINPipeNumber);
+       Pipe_Unfreeze();
+       
+       ReportReceived = Pipe_IsINReceived();
+       
+       Pipe_Freeze();
+       
+       return ReportReceived;
+}
+
+uint8_t HID_Host_SetBootProtocol(USB_ClassInfo_HID_Host_t* const HIDInterfaceInfo)
+{
+       uint8_t ErrorCode;
+
+       USB_ControlRequest = (USB_Request_Header_t)
+               {
+                       .bmRequestType = (REQDIR_HOSTTODEVICE | REQTYPE_CLASS | REQREC_INTERFACE),
+                       .bRequest      = REQ_SetProtocol,
+                       .wValue        = 0,
+                       .wIndex        = HIDInterfaceInfo->State.InterfaceNumber,
+                       .wLength       = 0,
+               };
+
+       Pipe_SelectPipe(PIPE_CONTROLPIPE);
+       
+       if (!(HIDInterfaceInfo->State.SupportsBootProtocol))
+         return HID_ERROR_LOGICAL;
+
+       if ((ErrorCode = USB_Host_SendControlRequest(NULL)) != HOST_SENDCONTROL_Successful)
+         return ErrorCode;
+
+       HIDInterfaceInfo->State.LargestReportSize = 8;
+       HIDInterfaceInfo->State.UsingBootProtocol = true;
+       
+       return HOST_SENDCONTROL_Successful;
+}
+
+#if !defined(HID_HOST_BOOT_PROTOCOL_ONLY)
+uint8_t HID_Host_SetReportProtocol(USB_ClassInfo_HID_Host_t* const HIDInterfaceInfo)
+{
+       uint8_t ErrorCode;
+
+       uint8_t HIDReportData[HIDInterfaceInfo->State.HIDReportSize];
+       
+       USB_ControlRequest = (USB_Request_Header_t)
+               {
+                       .bmRequestType = (REQDIR_DEVICETOHOST | REQTYPE_STANDARD | REQREC_INTERFACE),
+                       .bRequest      = REQ_GetDescriptor,
+                       .wValue        = (DTYPE_Report << 8),
+                       .wIndex        = HIDInterfaceInfo->State.InterfaceNumber,
+                       .wLength       = HIDInterfaceInfo->State.HIDReportSize,
+               };
+
+       Pipe_SelectPipe(PIPE_CONTROLPIPE);
+
+       if ((ErrorCode = USB_Host_SendControlRequest(HIDReportData)) != HOST_SENDCONTROL_Successful)
+         return ErrorCode;
+         
+       if (HIDInterfaceInfo->State.UsingBootProtocol)
+       {
+               USB_ControlRequest = (USB_Request_Header_t)
+                       {
+                               .bmRequestType = (REQDIR_HOSTTODEVICE | REQTYPE_CLASS | REQREC_INTERFACE),
+                               .bRequest      = REQ_SetProtocol,
+                               .wValue        = 1,
+                               .wIndex        = HIDInterfaceInfo->State.InterfaceNumber,
+                               .wLength       = 0,
+                       };
+
+               if ((ErrorCode = USB_Host_SendControlRequest(NULL)) != HOST_SENDCONTROL_Successful)
+                 return ErrorCode;
+
+               HIDInterfaceInfo->State.UsingBootProtocol = false;
+       }
+       
+       if (HIDInterfaceInfo->Config.HIDParserData == NULL)
+         return HID_ERROR_LOGICAL;
+               
+       if ((ErrorCode = USB_ProcessHIDReport(HIDReportData, HIDInterfaceInfo->State.HIDReportSize,
+                                             HIDInterfaceInfo->Config.HIDParserData)) != HID_PARSE_Successful)
+       {
+               return HID_ERROR_LOGICAL | ErrorCode;
+       }
+
+       uint8_t LargestReportSizeBits = HIDInterfaceInfo->Config.HIDParserData->LargestReportSizeBits;
+       HIDInterfaceInfo->State.LargestReportSize = (LargestReportSizeBits >> 3) + ((LargestReportSizeBits & 0x07) != 0);
+
+       return 0;
+}
+#endif
+
+#endif