/******************************************************************************
USB Host Communication Device Class(CDC) Interface file
This file provides all the interface functions to the CDC host client driver.
This file should be used in a project with usb_host_cdc.c to provide access
to CDC host.
Acronyms/abbreviations used by this class:
* CDC - Communication Device Class
* ACM - Abstract Control Module
This file provides interface functions for USB CDC host to the application.
These interface function can be used to set up transfers with the device attached
on the bus. Interface function USBHostCDC_Api_Get_IN_Data can be used to set up
transfer request to receive data from the device.Interface function
USBHostCDC_Api_Send_OUT_Data can be used to set up transfer request to send
data to the device. If USB_ENABLE_TRANSFER_EVENT is defined application will receive
an event on completion of transfer request otherwise application can poll the status
of transfer using function USBHostCDC_ApiTransferIsComplete. This file also provides
interface routine for ACM class specific requests in function USBHostCDC_Api_ACM_Request.
FileName: usb_host_cdc_interface.c
Dependencies: None
Processor: PIC24/dsPIC30/dsPIC33/PIC32MX
Compiler: C30 v2.01/C32 v0.00.18
Company: Microchip Technology, Inc.
Software License Agreement
The software supplied herewith by Microchip Technology Incorporated
(the Company) for its PICmicro® Microcontroller is intended and
supplied to you, the Companys customer, for use solely and
exclusively on Microchip PICmicro Microcontroller products. The
software is owned by the Company and/or its supplier, and is
protected under applicable copyright laws. All rights are reserved.
Any use in violation of the foregoing restrictions may subject the
user to criminal sanctions under applicable laws, as well as to
civil liability for the breach of the terms and conditions of this
license.
THIS SOFTWARE IS PROVIDED IN AN AS IS CONDITION. NO WARRANTIES,
WHETHER EXPRESS, IMPLIED OR STATUTORY, INCLUDING, BUT NOT LIMITED
TO, IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE APPLY TO THIS SOFTWARE. THE COMPANY SHALL NOT,
IN ANY CIRCUMSTANCES, BE LIABLE FOR SPECIAL, INCIDENTAL OR
CONSEQUENTIAL DAMAGES, FOR ANY REASON WHATSOEVER.
Change History:
Rev Description
----- -----------
v2.6a No change
2.7 Modified the code to allow connection of USB-RS232 dongles that do
not fully comply with CDC specifications
Modified API USBHostCDC_Api_Send_OUT_Data to allow data transfers
more than 256 bytes
2.7a No change
********************************************************************************/
#include <stdlib.h>
#include <string.h>
#include "GenericTypeDefs.h"
#include "HardwareProfile.h"
#include "usb_config.h"
#include "USB\usb.h"
#include "USB\usb_host_cdc.h"
#include "USB\usb_host_cdc_interface.h"
// *****************************************************************************
// *****************************************************************************
// Constants
// *****************************************************************************
// *****************************************************************************
// *****************************************************************************
// State Machine Constants
// *****************************************************************************
//******************************************************************************
//******************************************************************************
// Data Structures
//******************************************************************************
//******************************************************************************
//******************************************************************************
//******************************************************************************
// Section: Local Prototypes
//******************************************************************************
//******************************************************************************
//******************************************************************************
//******************************************************************************
// Macros
//******************************************************************************
//******************************************************************************
//******************************************************************************
//******************************************************************************
// Section: CDC Host Global Variables
//******************************************************************************
//******************************************************************************
//******************************************************************************
//******************************************************************************
// Section: CDC Host External Variables
//******************************************************************************
//******************************************************************************
extern USB_CDC_DEVICE_INFO deviceInfoCDC[] __attribute__ ((aligned));
extern BYTE CDCdeviceAddress ;
//******************************************************************************
//******************************************************************************
// Section: CDC Host Global Variables
//******************************************************************************
//******************************************************************************
/****************************************************************************
Function:
BOOL USBHostCDC_Api_Get_IN_Data(BYTE no_of_bytes, BYTE* data)
Description:
This function is called by application to receive Input data over DATA
interface. This function setsup the request to receive data from the device.
Precondition:
None
Parameters:
BYTE no_of_bytes - No. of Bytes expected from the device.
BYTE* data - Pointer to application receive data buffer.
Return Values:
TRUE - Transfer request is placed successfully.
FALSE - Transfer request failed.
Remarks:
None
***************************************************************************/
BOOL USBHostCDC_Api_Get_IN_Data(BYTE no_of_bytes, BYTE* data)
{
BYTE i;
for (i=0; (i<USB_MAX_CDC_DEVICES) && (deviceInfoCDC[i].deviceAddress != CDCdeviceAddress); i++);
if(!USBHostCDCRead_DATA(CDCdeviceAddress, deviceInfoCDC[i].dataInterface.interfaceNum,
no_of_bytes,data,deviceInfoCDC[i].dataInterface.endpointIN))
{
return TRUE;
}
return FALSE;
}
/****************************************************************************
Function:
BOOL USBHostCDC_Api_Send_OUT_Data(BYTE no_of_bytes, BYTE* data)
Description:
This function is called by application to transmit out data over DATA
interface. This function setsup the request to transmit data to the
device.
Precondition:
None
Parameters:
BYTE no_of_bytes - No. of Bytes expected from the device.
BYTE* data - Pointer to application transmit data buffer.
Return Values:
TRUE - Transfer request is placed successfully.
FALSE - Transfer request failed.
Remarks:
None
***************************************************************************/
BOOL USBHostCDC_Api_Send_OUT_Data(WORD no_of_bytes, BYTE* data)
{
BYTE i;
for (i=0; (i<USB_MAX_CDC_DEVICES) && (deviceInfoCDC[i].deviceAddress != CDCdeviceAddress); i++);
if(!USBHostCDCSend_DATA(CDCdeviceAddress, deviceInfoCDC[i].dataInterface.interfaceNum,
no_of_bytes,data,deviceInfoCDC[i].dataInterface.endpointOUT))
{
return TRUE;
}
return FALSE;
}
/****************************************************************************
Function:
BOOL USBHostCDC_ApiTransferIsComplete(BYTE* errorCodeDriver,BYTE* byteCount)
Description:
This function is called by application to poll for transfer status. This
function returns true in the transfer is over. To check whether the transfer
was successfull or not , application must check the error code returned by
reference.
Precondition:
None
Parameters:
BYTE *errorCodeDriver - returns.
BYTE *byteCount - No. of bytes transferred.
Return Values:
TRUE - Transfer is has completed.
FALSE - Transfer is pending.
Remarks:
None
***************************************************************************/
BOOL USBHostCDC_ApiTransferIsComplete(BYTE* errorCodeDriver, BYTE* byteCount )
{
return(USBHostCDCTransferIsComplete(CDCdeviceAddress,errorCodeDriver,byteCount));
}
/*******************************************************************************
Function:
BOOL USBHostCDC_ApiDeviceDetect( void )
Description:
This function determines if a CDC device is attached
and ready to use.
Precondition:
None
Parameters:
None
Return Values:
TRUE - CDC present and ready
FALSE - CDC not present or not ready
Remarks:
Since this will often be called in a loop while waiting for
a device, we'll make sure the tasks are executed.
*******************************************************************************/
BOOL USBHostCDC_ApiDeviceDetect( void )
{
USBHostTasks();
USBHostCDCTasks();
if ((USBHostCDCDeviceStatus(CDCdeviceAddress) == USB_CDC_NORMAL_RUNNING) &&
(CDCdeviceAddress != 0))
{
return TRUE;
}
return FALSE;
}
/*******************************************************************************
Function:
BYTE USBHostCDC_Api_ACM_Request(BYTE requestType, BYTE size, BYTE* data)
Description:
This function can be used by application code to dynamically access ACM specific
requests. This function should be used only if apllication intends to modify for
example the Baudrate from previouly configured rate. Data transmitted/received
to/from device is a array of bytes. Application must take extra care of understanding
the data format before using this function.
Precondition:
Device must be enumerated and attached successfully.
Parameters:
BYTE requestType - USB_CDC_SEND_ENCAPSULATED_COMMAND
- USB_CDC_GET_ENCAPSULATED_REQUEST
- USB_CDC_SET_LINE_CODING
- USB_CDC_SET_CONTROL_LINE_STATE
- USB_CDC_SET_CONTROL_LINE_STATE
These are the mandatory CDC request supported by the
CDC host stack.
BYTE size - No of bytes to be transferred.
BYTE *data - Pointer to data being transferred.
Return Values:
USB_SUCCESS - Request started successfully
USB_CDC_DEVICE_NOT_FOUND - No device with specified address
USB_CDC_DEVICE_BUSY - Device not in proper state for
performing a transfer
USB_CDC_COMMAND_FAILED - Request is not supported.
USB_CDC_ILLEGAL_REQUEST - Requested ID is invalid.
Remarks:
None
*******************************************************************************/
BYTE USBHostCDC_Api_ACM_Request(BYTE requestType, BYTE size, BYTE* data)
{
BYTE i;
BYTE return_val = USB_CDC_COMMAND_FAILED;
// Find the correct device.
for (i=0; (i<USB_MAX_CDC_DEVICES) && (deviceInfoCDC[i].deviceAddress != CDCdeviceAddress); i++);
if (i == USB_MAX_CDC_DEVICES)
{
return USB_CDC_DEVICE_NOT_FOUND;
}
switch(requestType)
{
case USB_CDC_SEND_ENCAPSULATED_COMMAND :
return_val = USBHostCDCTransfer(CDCdeviceAddress, USB_CDC_SEND_ENCAPSULATED_COMMAND,0,
deviceInfoCDC[i].commInterface.interfaceNum,size,data,
0);
break;
case USB_CDC_GET_ENCAPSULATED_REQUEST :
return_val = USBHostCDCTransfer(CDCdeviceAddress, USB_CDC_GET_ENCAPSULATED_REQUEST,1,
deviceInfoCDC[i].commInterface.interfaceNum,size,data,
0);
break;
case USB_CDC_SET_COMM_FEATURE :
break;
case USB_CDC_GET_COMM_FEATURE :
break;
case USB_CDC_SET_LINE_CODING :
return_val = USBHostCDCTransfer(CDCdeviceAddress, USB_CDC_SET_LINE_CODING,0,
deviceInfoCDC[i].commInterface.interfaceNum,size,data,
0);
break;
case USB_CDC_GET_LINE_CODING :
return_val = USBHostCDCTransfer(CDCdeviceAddress, USB_CDC_GET_LINE_CODING,1,
deviceInfoCDC[i].commInterface.interfaceNum,size,data,
0);
break;
case USB_CDC_SET_CONTROL_LINE_STATE :
return_val = USBHostCDCTransfer(CDCdeviceAddress, USB_CDC_SET_CONTROL_LINE_STATE,0,
deviceInfoCDC[i].commInterface.interfaceNum,size,data,
0);
break;
case USB_CDC_SEND_BREAK :
break;
default:
return USB_CDC_ILLEGAL_REQUEST;
break;
}
return return_val;
}
|