3      Copyright (C) Dean Camera, 2009. 
   5   dean [at] fourwalledcubicle [dot] com 
   6       www.fourwalledcubicle.com 
  10   Copyright 2009  Dean Camera (dean [at] fourwalledcubicle [dot] com) 
  12   Permission to use, copy, modify, and distribute this software 
  13   and its documentation for any purpose and without fee is hereby 
  14   granted, provided that the above copyright notice appear in all 
  15   copies and that both that the copyright notice and this 
  16   permission notice and warranty disclaimer appear in supporting 
  17   documentation, and that the name of the author not be used in 
  18   advertising or publicity pertaining to distribution of the 
  19   software without specific, written prior permission. 
  21   The author disclaim all warranties with regard to this 
  22   software, including all implied warranties of merchantability 
  23   and fitness.  In no event shall the author be liable for any 
  24   special, indirect or consequential damages or any damages 
  25   whatsoever resulting from loss of use, data or profits, whether 
  26   in an action of contract, negligence or other tortious action, 
  27   arising out of or in connection with the use or performance of 
  31 #include "../../HighLevel/USBMode.h" 
  32 #if defined(USB_CAN_BE_HOST) 
  34 #define INCLUDE_FROM_PRINTER_CLASS_HOST_C 
  37 uint8_t PRNT_Host_ConfigurePipes(USB_ClassInfo_PRNT_Host_t
* const PRNTInterfaceInfo
, uint16_t ConfigDescriptorSize
, 
  38                                                              void* DeviceConfigDescriptor
) 
  40         uint8_t FoundEndpoints 
= 0; 
  42         memset(&PRNTInterfaceInfo
->State
, 0x00, sizeof(PRNTInterfaceInfo
->State
)); 
  44         if (DESCRIPTOR_TYPE(DeviceConfigDescriptor
) != DTYPE_Configuration
) 
  45           return PRNT_ENUMERROR_InvalidConfigDescriptor
; 
  47         if (USB_GetNextDescriptorComp(&ConfigDescriptorSize
, &DeviceConfigDescriptor
, 
  48                                       DComp_NextPRNTInterface
) != DESCRIPTOR_SEARCH_COMP_Found
) 
  50                 return PRNT_ENUMERROR_NoPrinterInterfaceFound
; 
  53         USB_Descriptor_Interface_t
* PrinterInterface 
= DESCRIPTOR_PCAST(DeviceConfigDescriptor
, USB_Descriptor_Interface_t
); 
  55         PRNTInterfaceInfo
->State
.InterfaceNumber  
= PrinterInterface
->InterfaceNumber
; 
  56         PRNTInterfaceInfo
->State
.AlternateSetting 
= PrinterInterface
->AlternateSetting
; 
  58         while (FoundEndpoints 
!= (PRNT_FOUND_DATAPIPE_IN 
| PRNT_FOUND_DATAPIPE_OUT
)) 
  60                 if (USB_GetNextDescriptorComp(&ConfigDescriptorSize
, &DeviceConfigDescriptor
, 
  61                                               DComp_NextPRNTInterfaceEndpoint
) != DESCRIPTOR_SEARCH_COMP_Found
) 
  63                         return PRNT_ENUMERROR_EndpointsNotFound
; 
  66                 USB_Descriptor_Endpoint_t
* EndpointData 
= DESCRIPTOR_PCAST(DeviceConfigDescriptor
, USB_Descriptor_Endpoint_t
); 
  68                 if (EndpointData
->EndpointAddress 
& ENDPOINT_DESCRIPTOR_DIR_IN
) 
  70                         Pipe_ConfigurePipe(PRNTInterfaceInfo
->Config
.DataINPipeNumber
, EP_TYPE_BULK
, PIPE_TOKEN_IN
, 
  71                                            EndpointData
->EndpointAddress
, EndpointData
->EndpointSize
, 
  72                                            PRNTInterfaceInfo
->Config
.DataINPipeDoubleBank ? PIPE_BANK_DOUBLE 
: PIPE_BANK_SINGLE
); 
  73                         PRNTInterfaceInfo
->State
.DataINPipeSize 
= EndpointData
->EndpointSize
; 
  75                         FoundEndpoints 
|= PRNT_FOUND_DATAPIPE_IN
; 
  79                         Pipe_ConfigurePipe(PRNTInterfaceInfo
->Config
.DataOUTPipeNumber
, EP_TYPE_BULK
, PIPE_TOKEN_OUT
, 
  80                                            EndpointData
->EndpointAddress
, EndpointData
->EndpointSize
, 
  81                                            PRNTInterfaceInfo
->Config
.DataOUTPipeDoubleBank ? PIPE_BANK_DOUBLE 
: PIPE_BANK_SINGLE
); 
  82                         PRNTInterfaceInfo
->State
.DataOUTPipeSize 
= EndpointData
->EndpointSize
; 
  84                         FoundEndpoints 
|= PRNT_FOUND_DATAPIPE_OUT
; 
  88         PRNTInterfaceInfo
->State
.IsActive 
= true; 
  89         return PRNT_ENUMERROR_NoError
; 
  92 static uint8_t DComp_NextPRNTInterface(void* CurrentDescriptor
) 
  94         if (DESCRIPTOR_TYPE(CurrentDescriptor
) == DTYPE_Interface
) 
  96                 if ((DESCRIPTOR_CAST(CurrentDescriptor
, USB_Descriptor_Interface_t
).Class    
== PRINTER_CLASS
)    && 
  97                     (DESCRIPTOR_CAST(CurrentDescriptor
, USB_Descriptor_Interface_t
).SubClass 
== PRINTER_SUBCLASS
) && 
  98                         (DESCRIPTOR_CAST(CurrentDescriptor
, USB_Descriptor_Interface_t
).Protocol 
== PRINTER_PROTOCOL
)) 
 100                         return DESCRIPTOR_SEARCH_Found
; 
 104         return DESCRIPTOR_SEARCH_NotFound
; 
 107 static uint8_t DComp_NextPRNTInterfaceEndpoint(void* CurrentDescriptor
) 
 109         if (DESCRIPTOR_TYPE(CurrentDescriptor
) == DTYPE_Endpoint
) 
 111                 uint8_t EndpointType 
= (DESCRIPTOR_CAST(CurrentDescriptor
, 
 112                                                         USB_Descriptor_Endpoint_t
).Attributes 
& EP_TYPE_MASK
); 
 114                 if (EndpointType 
== EP_TYPE_BULK
) 
 115                   return DESCRIPTOR_SEARCH_Found
; 
 117         else if (DESCRIPTOR_TYPE(CurrentDescriptor
) == DTYPE_Interface
) 
 119                 return DESCRIPTOR_SEARCH_Fail
; 
 122         return DESCRIPTOR_SEARCH_NotFound
; 
 125 void PRNT_Host_USBTask(USB_ClassInfo_PRNT_Host_t
* const PRNTInterfaceInfo
) 
 130 uint8_t PRNT_Host_SetBidirectionalMode(USB_ClassInfo_PRNT_Host_t
* const PRNTInterfaceInfo
) 
 132         if (PRNTInterfaceInfo
->State
.AlternateSetting
) 
 136                 USB_ControlRequest 
= (USB_Request_Header_t
) 
 138                                 bmRequestType
: (REQDIR_HOSTTODEVICE 
| REQTYPE_STANDARD 
| REQREC_INTERFACE
), 
 139                                 bRequest
:      REQ_SetInterface
, 
 140                                 wValue
:        PRNTInterfaceInfo
->State
.AlternateSetting
, 
 141                                 wIndex
:        PRNTInterfaceInfo
->State
.InterfaceNumber
, 
 145                 Pipe_SelectPipe(PIPE_CONTROLPIPE
); 
 147                 if ((ErrorCode 
= USB_Host_SendControlRequest(NULL
)) != HOST_SENDCONTROL_Successful
) 
 151         return HOST_SENDCONTROL_Successful
; 
 154 uint8_t PRNT_Host_GetPortStatus(USB_ClassInfo_PRNT_Host_t
* const PRNTInterfaceInfo
, uint8_t* const PortStatus
) 
 156         USB_ControlRequest 
= (USB_Request_Header_t
) 
 158                         bmRequestType
: (REQDIR_DEVICETOHOST 
| REQTYPE_CLASS 
| REQREC_INTERFACE
), 
 159                         bRequest
:      REQ_GetPortStatus
, 
 161                         wIndex
:        PRNTInterfaceInfo
->State
.InterfaceNumber
, 
 162                         wLength
:       sizeof(uint8_t), 
 165         Pipe_SelectPipe(PIPE_CONTROLPIPE
); 
 167         return USB_Host_SendControlRequest(PortStatus
); 
 170 uint8_t PRNT_Host_SoftReset(USB_ClassInfo_PRNT_Host_t
* const PRNTInterfaceInfo
) 
 172         USB_ControlRequest 
= (USB_Request_Header_t
) 
 174                         bmRequestType
: (REQDIR_HOSTTODEVICE 
| REQTYPE_CLASS 
| REQREC_INTERFACE
), 
 175                         bRequest
:      REQ_SoftReset
, 
 177                         wIndex
:        PRNTInterfaceInfo
->State
.InterfaceNumber
, 
 181         Pipe_SelectPipe(PIPE_CONTROLPIPE
); 
 183         return USB_Host_SendControlRequest(NULL
); 
 186 uint8_t PRNT_Host_SendData(USB_ClassInfo_PRNT_Host_t
* const PRNTInterfaceInfo
, void* PrinterCommands
, uint16_t CommandSize
) 
 190         Pipe_SelectPipe(PRNTInterfaceInfo
->Config
.DataOUTPipeNumber
); 
 193         if ((ErrorCode 
= Pipe_Write_Stream_LE(PrinterCommands
, CommandSize
, NO_STREAM_CALLBACK
)) != PIPE_RWSTREAM_NoError
) 
 197         while (!(Pipe_IsOUTReady())) 
 199                 if (USB_HostState 
== HOST_STATE_Unattached
) 
 200                   return PIPE_RWSTREAM_DeviceDisconnected
; 
 205         return PIPE_RWSTREAM_NoError
; 
 208 uint8_t PRNT_Host_GetDeviceID(USB_ClassInfo_PRNT_Host_t
* const PRNTInterfaceInfo
, char* DeviceIDString
, uint16_t BufferSize
) 
 210         uint8_t  ErrorCode 
= HOST_SENDCONTROL_Successful
; 
 211         uint16_t DeviceIDStringLength 
= 0; 
 213         USB_ControlRequest 
= (USB_Request_Header_t
) 
 215                         bmRequestType
: (REQDIR_DEVICETOHOST 
| REQTYPE_CLASS 
| REQREC_INTERFACE
), 
 216                         bRequest
:      REQ_GetDeviceID
, 
 218                         wIndex
:        PRNTInterfaceInfo
->State
.InterfaceNumber
, 
 219                         wLength
:       sizeof(DeviceIDStringLength
), 
 222         Pipe_SelectPipe(PIPE_CONTROLPIPE
); 
 224         if ((ErrorCode 
= USB_Host_SendControlRequest(&DeviceIDStringLength
)) != HOST_SENDCONTROL_Successful
) 
 227         if (!(DeviceIDStringLength
)) 
 229                 DeviceIDString
[0] = 0x00; 
 230                 return HOST_SENDCONTROL_Successful
; 
 233         DeviceIDStringLength 
= SwapEndian_16(DeviceIDStringLength
); 
 235         if (DeviceIDStringLength 
> BufferSize
) 
 236           DeviceIDStringLength 
= BufferSize
; 
 238         USB_ControlRequest
.wLength 
= DeviceIDStringLength
; 
 240         if ((ErrorCode 
= USB_Host_SendControlRequest(DeviceIDString
)) != HOST_SENDCONTROL_Successful
) 
 243         memmove(&DeviceIDString
[0], &DeviceIDString
[2], DeviceIDStringLength 
- 2); 
 245         DeviceIDString
[DeviceIDStringLength 
- 2] = 0x00; 
 247         return HOST_SENDCONTROL_Successful
;