putUSBUSART Function

Microchip USB Device Library

USB Device Library Help
putUSBUSART Function
C
void putUSBUSART(
    char * data, 
    BYTE Length
);
Description

putUSBUSART writes an array of data to the USB. Use this version, is capable of transfering 0x00 (what is typically a NULL character in any of the string transfer functions). 

Typical Usage:

    if(USBUSARTIsTxTrfReady())
    {
        char data[] = {0x00, 0x01, 0x02, 0x03, 0x04};
        putUSBUSART(data,5);
    }

 

The transfer mechanism for device-to-host(put) is more flexible than host-to-device(get). It can handle a string of data larger than the maximum size of bulk IN endpoint. A state machine is used to transfer a long string of data over multiple USB transactions. CDCTxService() must be called periodically to keep sending blocks of data to the host.

Preconditions

USBUSARTIsTxTrfReady() must return TRUE. This indicates that the last transfer is complete and is ready to receive a new block of data. The string of characters pointed to by 'data' must equal to or smaller than 255 BYTEs.

Parameters
Parameters 
Description 
char *data 
pointer to a RAM array of data to be transfered to the host 
BYTE length 
the number of bytes to be transfered (must be less than 255). 
Microchip MCHPFSUSB v2.3 - Sept 20, 2008
Copyright © 2008 Microchip Technology, Inc.  All rights reserved.