Update copyrights for 2014.
[pub/lufa.git] / LUFA / Drivers / USB / Core / UC3 / PipeStream_UC3.h
index cd12b75..4dd79c9 100644 (file)
@@ -1,21 +1,21 @@
 /*
              LUFA Library
-     Copyright (C) Dean Camera, 2013.
-              
+     Copyright (C) Dean Camera, 2014.
+
   dean [at] fourwalledcubicle [dot] com
            www.lufa-lib.org
 */
 
 /*
-  Copyright 2013  Dean Camera (dean [at] fourwalledcubicle [dot] com)
+  Copyright 2014  Dean Camera (dean [at] fourwalledcubicle [dot] com)
 
-  Permission to use, copy, modify, distribute, and sell this 
+  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 
+  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 
+  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 disclaims all warranties with regard to this
@@ -27,7 +27,7 @@
   arising out of or in connection with the use or performance of
   this software.
 */
+
 /** \file
  *  \brief Pipe data stream transmission and reception management for the AVR32 UC3 microcontrollers.
  *  \copydetails Group_PipeStreamRW_UC3
@@ -53,7 +53,7 @@
                #include "../../../../Common/Common.h"
                #include "../USBMode.h"
                #include "../USBTask.h"
-               
+
        /* Enable C linkage for C++ Compilers: */
                #if defined(__cplusplus)
                        extern "C" {
@@ -63,7 +63,7 @@
                #if !defined(__INCLUDE_FROM_USB_DRIVER)
                        #error Do not include this file directly. Include LUFA/Drivers/USB/USB.h instead.
                #endif
-               
+
        /* Public Interface - May be used in end-application: */
                /* Function Prototypes: */
                        /** \name Stream functions for null data */
                         *  <b>Single Stream Transfer Example:</b>
                         *  \code
                         *  uint8_t ErrorCode;
-                        *  
+                        *
                         *  if ((ErrorCode = Pipe_Discard_Stream(512, NULL)) != PIPE_RWSTREAM_NoError)
                         *  {
                         *       // Stream failed to complete - check ErrorCode here
                         *  }
                         *  \endcode
-                        *  
+                        *
                         *  <b>Partial Stream Transfers Example:</b>
                         *  \code
                         *  uint8_t  ErrorCode;
                         *  uint16_t BytesProcessed;
-                        *  
+                        *
                         *  BytesProcessed = 0;
                         *  while ((ErrorCode = Pipe_Discard_Stream(512, &BytesProcessed)) == PIPE_RWSTREAM_IncompleteTransfer)
                         *  {
                         *      // Stream not yet complete - do other actions here, abort if required
                         *  }
-                        *  
+                        *
                         *  if (ErrorCode != PIPE_RWSTREAM_NoError)
                         *  {
                         *      // Stream failed to complete - check ErrorCode here
                         *  <b>Single Stream Transfer Example:</b>
                         *  \code
                         *  uint8_t ErrorCode;
-                        *  
+                        *
                         *  if ((ErrorCode = Pipe_Null_Stream(512, NULL)) != PIPE_RWSTREAM_NoError)
                         *  {
                         *       // Stream failed to complete - check ErrorCode here
                         *  \code
                         *  uint8_t  ErrorCode;
                         *  uint16_t BytesProcessed;
-                        *  
+                        *
                         *  BytesProcessed = 0;
                         *  while ((ErrorCode = Pipe_Null_Stream(512, &BytesProcessed)) == PIPE_RWSTREAM_IncompleteTransfer)
                         *  {
                         *      // Stream not yet complete - do other actions here, abort if required
                         *  }
-                        *  
+                        *
                         *  if (ErrorCode != PIPE_RWSTREAM_NoError)
                         *  {
                         *      // Stream failed to complete - check ErrorCode here
 
                        /** \name Stream functions for RAM source/destination data */
                        //@{
-                       
+
                        /** Writes the given number of bytes to the pipe from the given buffer in little endian,
                         *  sending full packets to the device as needed. The last packet filled is not automatically sent;
                         *  the user is responsible for manually sending the last written packet to the host via the
                         *  \code
                         *  uint8_t DataStream[512];
                         *  uint8_t ErrorCode;
-                        *  
+                        *
                         *  if ((ErrorCode = Pipe_Write_Stream_LE(DataStream, sizeof(DataStream),
                         *                                        NULL)) != PIPE_RWSTREAM_NoError)
                         *  {
                         *  uint8_t  DataStream[512];
                         *  uint8_t  ErrorCode;
                         *  uint16_t BytesProcessed;
-                        *  
+                        *
                         *  BytesProcessed = 0;
                         *  while ((ErrorCode = Pipe_Write_Stream_LE(DataStream, sizeof(DataStream),
                         *                                           &BytesProcessed)) == PIPE_RWSTREAM_IncompleteTransfer)
                         *  {
                         *      // Stream not yet complete - do other actions here, abort if required
                         *  }
-                        *  
+                        *
                         *  if (ErrorCode != PIPE_RWSTREAM_NoError)
                         *  {
                         *      // Stream failed to complete - check ErrorCode here
                         *  \code
                         *  uint8_t DataStream[512];
                         *  uint8_t ErrorCode;
-                        *  
+                        *
                         *  if ((ErrorCode = Pipe_Read_Stream_LE(DataStream, sizeof(DataStream),
                         *                                       NULL)) != PIPE_RWSTREAM_NoError)
                         *  {
                         *  uint8_t  DataStream[512];
                         *  uint8_t  ErrorCode;
                         *  uint16_t BytesProcessed;
-                        *  
+                        *
                         *  BytesProcessed = 0;
                         *  while ((ErrorCode = Pipe_Read_Stream_LE(DataStream, sizeof(DataStream),
                         *                                          &BytesProcessed)) == PIPE_RWSTREAM_IncompleteTransfer)
                         *  {
                         *      // Stream not yet complete - do other actions here, abort if required
                         *  }
-                        *  
+                        *
                         *  if (ErrorCode != PIPE_RWSTREAM_NoError)
                         *  {
                         *      // Stream failed to complete - check ErrorCode here
                #if defined(__cplusplus)
                        }
                #endif
-       
+
 #endif
 
 /** @} */